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.pyindex 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.blueprintsif 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_refelif 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.pyindex 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_refexecution_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_refdiff --git a/pipelex/pipeline/pipe_io_contracts.py b/pipelex/pipeline/pipe_io_contracts.pyindex 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: strjson_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: strmultiplicity: IOMultiplicity@@ -106,11 +106,11 @@ def build_pipe_io_contracts(pipes: Sequence[PipeAbstract]) -> dict[str, PipeIOCoraise PipeIOContractError(message=msg) from excschema_memo[memo_key] = json_schemapipe_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.pyindex 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_schemamake_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.pyindex 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 Trueassert 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.pyindex 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 Noneassert 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.pyindex 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] = {