Skip to content

Build AI methods with your coding agent, then run them anywhere: as an MCP for chatbots, as a webapp for people, or via API for your software.

refactor: concept_code → concept_ref in pipe_io_contracts; main_pipe_code → main_pipe_ref (#990)

Louis Choquel7de55e098237
diff --git a/pipelex/builder/operations/inputs_ops.py b/pipelex/builder/operations/inputs_ops.py
index f280b4a97..cfa65b540 100644
--- a/pipelex/builder/operations/inputs_ops.py
+++ b/pipelex/builder/operations/inputs_ops.py
@@ -52,11 +52,11 @@ async def build_inputs_for_pipe(
blueprints = validate_bundle_result.blueprints
if not pipe_code:
# Domain-qualified main pipe of the primary blueprint — the one shared selection rule.
- main_pipe_code = select_primary_blueprint(blueprints).main_pipe_ref
- if not main_pipe_code:
+ main_pipe_ref = select_primary_blueprint(blueprints).main_pipe_ref
+ if not main_pipe_ref:
msg = "Bundle does not declare a main_pipe. Specify a pipe code."
raise ValueError(msg)
- pipe_code = main_pipe_code
+ pipe_code = main_pipe_ref
elif bundle_path:
# allow_signatures=True: see the mthds_contents branch — rendering inputs tolerates placeholders.
validate_bundle_result = await validate_bundle(mthds_file_path=bundle_path, library_dirs=library_dirs, allow_signatures=True)
diff --git a/pipelex/pipeline/dry_run_pipeline.py b/pipelex/pipeline/dry_run_pipeline.py
index 908808acb..6d13989d0 100644
--- a/pipelex/pipeline/dry_run_pipeline.py
+++ b/pipelex/pipeline/dry_run_pipeline.py
@@ -42,7 +42,7 @@ async def dry_run_pipeline(
library_dirs: Optional library directories for pipe resolution.
Returns:
- Tuple of (GraphSpec, pipe_code).
+ Tuple of (GraphSpec, domain-qualified main-pipe ref).
Raises:
PipelexInterpreterError: If content parsing fails or main_pipe is missing.
@@ -53,18 +53,18 @@ async def dry_run_pipeline(
msg = "mthds_contents must be provided"
raise ValueError(msg)
- # Pre-parse contents to extract main_pipe_code via the one shared selection rule.
- # Note: pipeline_run_setup will re-parse these contents. The double-parse is
- # accepted because the runner interface requires pipe_code upfront and does not
- # expose the internally-resolved pipe code in its response.
+ # Pre-parse contents to extract the main pipe's domain-qualified ref via the one shared
+ # selection rule. Note: pipeline_run_setup will re-parse these contents. The double-parse
+ # is accepted because the runner interface requires the pipe ref upfront and does not
+ # expose the internally-resolved pipe ref in its response.
blueprints = [PipelexInterpreter.make_pipelex_bundle_blueprint(mthds_content=content) for content in mthds_contents]
- main_pipe_code = select_primary_blueprint(blueprints).main_pipe_ref
+ main_pipe_ref = select_primary_blueprint(blueprints).main_pipe_ref
- if not main_pipe_code:
+ if not main_pipe_ref:
msg = "Bundle does not declare a main_pipe, cannot generate graph"
raise PipelexInterpreterError(msg)
- pipe_code: str = main_pipe_code
+ pipe_ref: str = main_pipe_ref
execution_config = get_config().pipelex.pipeline_execution_config.with_execution_overrides(
generate_graph=True,
@@ -84,7 +84,7 @@ async def dry_run_pipeline(
# with a configured backend doesn't get trace files written as a side effect of validation.
with scoped_event_log(InMemoryEventLog()):
response = await runner.execute(
- pipe_code=pipe_code,
+ pipe_code=pipe_ref,
mthds_contents=mthds_contents,
)
pipe_output = response.pipe_output
@@ -93,4 +93,4 @@ async def dry_run_pipeline(
msg = "Pipeline execution did not produce a graph spec"
raise DryRunGraphNotProducedError(msg)
- return pipe_output.graph_spec, pipe_code
+ return pipe_output.graph_spec, pipe_ref
diff --git a/pipelex/pipeline/pipe_io_contracts.py b/pipelex/pipeline/pipe_io_contracts.py
index 5bc104b41..1e2b2c625 100644
--- a/pipelex/pipeline/pipe_io_contracts.py
+++ b/pipelex/pipeline/pipe_io_contracts.py
@@ -42,14 +42,14 @@ class IOMultiplicity(StrEnum):
class PipeInputContract(BaseModel):
"""One declared input: the concept it expects and the JSON Schema of its content."""
- concept_code: str
+ concept_ref: str
json_schema: dict[str, Any] = Field(default_factory=dict)
class PipeOutputContract(BaseModel):
"""The pipe's output: the concept it produces and whether it is one item or a list."""
- concept_code: str
+ concept_ref: str
multiplicity: IOMultiplicity
@@ -106,11 +106,11 @@ def build_pipe_io_contracts(pipes: Sequence[PipeAbstract]) -> dict[str, PipeIOCo
raise PipeIOContractError(message=msg) from exc
schema_memo[memo_key] = json_schema
pipe_inputs[var_name] = PipeInputContract(
- concept_code=stuff_spec.concept.concept_ref,
+ concept_ref=stuff_spec.concept.concept_ref,
json_schema=json_schema,
)
pipe_output = PipeOutputContract(
- concept_code=pipe.output.concept.concept_ref,
+ concept_ref=pipe.output.concept.concept_ref,
multiplicity=IOMultiplicity.VARIABLE if pipe.output.is_multiple() else IOMultiplicity.SINGLE,
)
io_contracts[pipe.pipe_ref] = PipeIOContract(inputs=pipe_inputs, output=pipe_output)
diff --git a/tests/integration/pipelex/pipeline/test_pipe_io_contracts.py b/tests/integration/pipelex/pipeline/test_pipe_io_contracts.py
index e6f6e8b1f..fd2e826cc 100644
--- a/tests/integration/pipelex/pipeline/test_pipe_io_contracts.py
+++ b/tests/integration/pipelex/pipeline/test_pipe_io_contracts.py
@@ -80,13 +80,13 @@ class TestBuildPipeIOContracts:
assert set(io_contracts) == {"structures_test.make_one", "structures_test.make_many"}
make_one = io_contracts["structures_test.make_one"]
- assert make_one.output.concept_code == "structures_test.Item"
+ assert make_one.output.concept_ref == "structures_test.Item"
assert make_one.output.multiplicity == IOMultiplicity.SINGLE
- assert make_one.inputs["doc"].concept_code == "native.Text"
+ assert make_one.inputs["doc"].concept_ref == "native.Text"
assert make_one.inputs["doc"].json_schema
make_many = io_contracts["structures_test.make_many"]
- assert make_many.output.concept_code == "structures_test.Item"
+ assert make_many.output.concept_ref == "structures_test.Item"
assert make_many.output.multiplicity == IOMultiplicity.VARIABLE
# A list-typed input renders an array JSON Schema.
assert make_many.inputs["docs"].json_schema.get("type") == "array"
@@ -127,9 +127,9 @@ class TestBuildPipeIOContracts:
# The signature (forward declaration) and the controller referencing it both report contracts.
signature_contract = io_contracts["research.find_key_findings"]
- assert signature_contract.output.concept_code == "research.KeyFinding"
+ assert signature_contract.output.concept_ref == "research.KeyFinding"
assert signature_contract.output.multiplicity == IOMultiplicity.SINGLE
- assert signature_contract.inputs["doc"].concept_code == "native.Text"
+ assert signature_contract.inputs["doc"].concept_ref == "native.Text"
controller_contract = io_contracts["research.research_brief"]
- assert controller_contract.output.concept_code == "research.KeyFinding"
+ assert controller_contract.output.concept_ref == "research.KeyFinding"
diff --git a/tests/integration/pipelex/pipeline/test_protocol_validate.py b/tests/integration/pipelex/pipeline/test_protocol_validate.py
index bc936c320..d0818797a 100644
--- a/tests/integration/pipelex/pipeline/test_protocol_validate.py
+++ b/tests/integration/pipelex/pipeline/test_protocol_validate.py
@@ -101,7 +101,7 @@ class TestProtocolValidate:
assert report.is_runnable is True
assert report.bundle_blueprint.domain == "protocol_validate"
# `pipe_io_contracts` and `validated_pipes` are keyed/identified by namespaced pipe_ref.
- assert report.pipe_io_contracts["protocol_validate.summarize"].output.concept_code == "protocol_validate.Summary"
+ assert report.pipe_io_contracts["protocol_validate.summarize"].output.concept_ref == "protocol_validate.Summary"
assert {(entry["pipe_ref"], entry["status"]) for entry in report.validated_pipes} == {
("protocol_validate.summarize", DryRunStatus.SUCCESS)
}
diff --git a/tests/integration/pipelex/temporal/test_dry_validate_activity_in_memory.py b/tests/integration/pipelex/temporal/test_dry_validate_activity_in_memory.py
index 13b4d06f4..ddddd73cd 100644
--- a/tests/integration/pipelex/temporal/test_dry_validate_activity_in_memory.py
+++ b/tests/integration/pipelex/temporal/test_dry_validate_activity_in_memory.py
@@ -224,8 +224,8 @@ class TestDryValidateActivityInMemory:
"dry_validate_alpha.alpha_second",
}
sequence_contract = result.pipe_io_contracts["dry_validate_alpha.alpha_sequence"]
- assert sequence_contract.inputs["subject"].concept_code == "native.Text"
- assert sequence_contract.output.concept_code == "native.Text"
+ assert sequence_contract.inputs["subject"].concept_ref == "native.Text"
+ assert sequence_contract.output.concept_ref == "native.Text"
async def test_graph_failure_is_best_effort(self, temporal_client: TemporalClient, mocker: MockerFixture) -> None:
"""D5: an expected dry-run failure in the graph arm yields graph_spec=None, validation still OK."""
@@ -279,7 +279,7 @@ class TestDryValidateActivityInMemory:
assert result.graph_spec is not None
assert result.pending_signatures == ["dry_validate_sig.unimplemented_sig"]
assert "dry_validate_sig.unimplemented_sig" in result.pipe_io_contracts
- assert result.pipe_io_contracts["dry_validate_sig.unimplemented_sig"].output.concept_code == "native.Text"
+ assert result.pipe_io_contracts["dry_validate_sig.unimplemented_sig"].output.concept_ref == "native.Text"
async def test_validation_failure_does_not_retry_activity(self, temporal_client: TemporalClient, mocker: MockerFixture) -> None:
"""D-C5 regression: a deterministic validation failure must run the activity exactly once.
diff --git a/tests/unit/pipelex/pipeline/test_validation_report.py b/tests/unit/pipelex/pipeline/test_validation_report.py
index fb1ec02ce..bdabb355a 100644
--- a/tests/unit/pipelex/pipeline/test_validation_report.py
+++ b/tests/unit/pipelex/pipeline/test_validation_report.py
@@ -45,7 +45,7 @@ class TestBuildValidationReport:
pipe_io_contracts = {
"beta.do_it": PipeIOContract(
inputs={},
- output=PipeOutputContract(concept_code="native.Text", multiplicity=IOMultiplicity.SINGLE),
+ output=PipeOutputContract(concept_ref="native.Text", multiplicity=IOMultiplicity.SINGLE),
),
}
dry_run_result: dict[str, DryRunOutput] = {