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.

feature/Pin-mthds-standard-400 · L-261009-ee1e4f (#1389)

Louis Choquel750045ae9073
diff --git a/.badges/tests.json b/.badges/tests.json
index 0732f89f3..185219e40 100644
--- a/.badges/tests.json
+++ b/.badges/tests.json
@@ -1,7 +1,7 @@
{
"schemaVersion": 1,
"label": "tests",
- "message": "16581",
+ "message": "16644",
"color": "blue",
"cacheSeconds": 300
}
diff --git a/.drift/acks/cli-docs.toml b/.drift/acks/cli-docs.toml
index 02e8f4c59..7b4540750 100644
--- a/.drift/acks/cli-docs.toml
+++ b/.drift/acks/cli-docs.toml
@@ -1,8 +1,8 @@
contract = "cli-docs"
-digest = "sha256:eb78038e1f2fe78d06f60a6af4327c2fcba3d92292d5b856d88f21e893b79b96"
+digest = "sha256:13211c0b5189edf723da8779be456ddd41d0a13eb5f352b6d08f0b91bb314e9b"
reviewed_by = "Claude (Opus 5.5)"
-reviewed_at = "2026-10-09T11:47:00Z"
-rationale = "real-catch: the trigger changes are this branch's help and next-step text: the run help of both CLIs (catalog ids, local method directories, TOML or inline inputs), the pipelex-agent --help description, the login closing line, the agent boot-failure hint, the FormerReleaseConfigError hint moving from the agent lookup dict to the class's user_action, and the doctor's credentials row offering the hosted Pipelex API. Reviewing docs/tools/cli against them caught one stale target: doctor.md did not say the Backend Credentials row now names the hosted Pipelex API, which it now does. run.md already lists inline JSON and the new options, agent-cli.md and migrate.md describe the FormerReleaseConfigError loop the new user_action carries, and the agent CLI CLAUDE.md now says --graph and --costs are ignored on a hosted run; none of the docs quote the changed help strings."
+reviewed_at = "2026-10-09T18:08:28Z"
+rationale = "clean-pass: the trigger change makes the hosted refusal envelope read error_domain and retryable off the problem document through sent_verdict, because pipelex-sdk 0.36+ fills unsent members from its own table and would otherwise mark an unlabelled 503 retryable; the envelope's output is unchanged. docs/tools/cli/agent-cli.md still says what it does (domain, category and retryable are the runner's own, a 429 is inferred retryable, a 503 only when the answer says so, ApiUnreachableError only before the run request left, HostedRunOutcomeUnknownError after), so no docs change; the agent CLI CLAUDE.md got a clause naming sent_verdict, written with the change rather than caught by this review."
[trigger_files]
"pipelex/cli/__init__.py" = "blob:8b137891791fe96927ad78e64b0aad7bded08bdc"
@@ -11,7 +11,7 @@ rationale = "real-catch: the trigger changes are this branch's help and next-ste
"pipelex/cli/agent_cli/_agent_cli.py" = "blob:690be5b3b3f0fbe69ed3e7baddd24538f590de01"
"pipelex/cli/agent_cli/commands/__init__.py" = "blob:e69de29bb2d1d6434b8b29ae775ad8c2e48c5391"
"pipelex/cli/agent_cli/commands/agent_cli_factory.py" = "blob:050ca1344abc4c1ca22d431923e1577681552fe6"
-"pipelex/cli/agent_cli/commands/agent_output.py" = "blob:a3651bb1023350e358d7865c3e9d401b3408b5c7"
+"pipelex/cli/agent_cli/commands/agent_output.py" = "blob:53812c4c3c6664255f9df52c69bf5948258330c8"
"pipelex/cli/agent_cli/commands/bundle_path_resolver.py" = "blob:a1904517c731afb72af7d49adf6d217dc50b2660"
"pipelex/cli/agent_cli/commands/check_model_cmd.py" = "blob:3a9c93daecadf266b3eba466904b3d005d448d40"
"pipelex/cli/agent_cli/commands/codegen/__init__.py" = "blob:e69de29bb2d1d6434b8b29ae775ad8c2e48c5391"
diff --git a/.test_durations b/.test_durations
index a287cd80c..8045982c7 100644
--- a/.test_durations
+++ b/.test_durations
@@ -1153,6 +1153,7 @@
"tests/integration/pipelex/pipes/controller/pipe_sequence/test_binding_nested_writes.py::TestBindingNestedWrites::test_the_three_analyses_agree_on_what_a_nested_shape_stores[a-parallel-adding-a-maybe-absent-branch-result]": 0.0723,
"tests/integration/pipelex/pipes/controller/pipe_sequence/test_binding_nested_writes.py::TestBindingNestedWrites::test_the_three_analyses_agree_on_what_a_nested_shape_stores[a-parallel-adding-each-output]": 0.0459,
"tests/integration/pipelex/pipes/controller/pipe_sequence/test_binding_refusal_remedy.py::TestBindingRefusalRemedy::test_a_missing_root_that_is_not_a_plain_name_is_never_asked_for_as_an_input": 0.0077,
+ "tests/integration/pipelex/pipes/controller/pipe_sequence/test_binding_refusal_remedy.py::TestBindingRefusalRemedy::test_a_pipe_step_storing_under_a_name_that_is_not_plain_is_refused": 0.189,
"tests/integration/pipelex/pipes/controller/pipe_sequence/test_binding_refusal_remedy.py::TestBindingRefusalRemedy::test_a_root_that_is_not_a_plain_name_reads_an_earlier_steps_result": 0.0146,
"tests/integration/pipelex/pipes/controller/pipe_sequence/test_binding_refusal_remedy.py::TestBindingRefusalRemedy::test_the_binding_step_a_refusal_prints_parses_validates_and_runs": 0.1144,
"tests/integration/pipelex/pipes/controller/pipe_sequence/test_binding_typed_flow.py::TestBindingTypedFlow::test_a_batched_step_stores_a_list_whatever_count_it_asks_for[a-batch-asking-for-multiple-outputs]": 0.0234,
@@ -1700,8 +1701,13 @@
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_inadequate_output_concept]": 1.3292,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_inadequate_output_multiplicity]": 0.0757,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_inadequate_output_multiplicity_binding]": 0.0438,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_name_batch_item_name_not_plain]": 0.1716,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_name_branch_batch_as_reserved]": 0.0837,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_name_branch_result_not_plain]": 0.2207,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_name_lone_dotted]": 0.0292,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_name_redundant_dotted]": 0.0427,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_name_step_batch_as_dotted]": 0.1612,
+ "tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_name_step_result_not_plain]": 0.3106,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_stuff_spec_mismatch]": 0.2841,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_stuff_spec_mismatch_binding]": 0.0393,
"tests/integration/pipelex/test_extras/test_mthds_corpus_entries.py::TestMthdsCorpusEntries::test_invalid_entry_fails_with_exactly_its_declared_error[invalid_input_stuff_spec_mismatch_dotted_batch_over]": 0.0367,
@@ -5057,9 +5063,14 @@
"tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_comprehensive_env_placeholder_vars_only": 0.0003,
"tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_comprehensive_non_env_provider[generic_mock]": 0.0838,
"tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_comprehensive_non_env_provider[none]": 0.0005,
+ "tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_comprehensive_offers_hosted_runs_only_when_asked[False]": 0.1673,
+ "tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_comprehensive_offers_hosted_runs_only_when_asked[True]": 0.1851,
"tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_credentials_validation_report_round_trip": 0.0004,
+ "tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_hosted_runs_hint_holds_no_square_bracket": 0.1904,
"tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_one_variable_missing_env_provider": 0.0012,
"tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_one_variable_missing_generic_provider": 0.002,
+ "tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_one_variable_missing_offers_hosted_runs_only_when_asked[False]": 0.1822,
+ "tests/unit/pipelex/cogt/model_backends/test_backend_credentials.py::TestBackendCredentials::test_one_variable_missing_offers_hosted_runs_only_when_asked[True]": 0.167,
"tests/unit/pipelex/cogt/model_backends/test_backend_file_handle_key.py::TestTheHandleKey::test_a_duplicate_pair_is_refused_naming_both_tables": 0.0051,
"tests/unit/pipelex/cogt/model_backends/test_backend_file_handle_key.py::TestTheHandleKey::test_a_placeholder_may_not_stand_in_for_a_handle": 0.0031,
"tests/unit/pipelex/cogt/model_backends/test_backend_file_handle_key.py::TestTheHandleKey::test_a_twin_declared_through_handle_loads_both_specs": 0.1086,
@@ -8453,6 +8464,10 @@
"tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_local_file_for_a_method_with_an_address_dependency_points_at_a_url": 0.0006,
"tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_lost_run_is_not_reported_as_a_network_failure": 0.0002,
"tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_method_that_does_not_load_carries_its_labelled_items": 0.0005,
+ "tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_refusal_carries_only_the_verdict_the_hosted_api_sent[401-{\"type\":\"https://docs.pipelex.com/latest/errors/unauthorized/\",\"title\":\"Unauthorized\",\"status\":401,\"detail\":\"Invalid or expired API key.\",\"instance\":\"/v1/start\",\"code\":\"unauthorized\"}-None-None]": 0.1829,
+ "tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_refusal_carries_only_the_verdict_the_hosted_api_sent[422-{\"type\":\"https://docs.pipelex.com/latest/errors/validate-bundle-error/\",\"title\":\"Validate bundle\",\"status\":422,\"detail\":\"Pipe 'draft_pitch' (PipeLLM), field 'model': Model handle 'gpt-5.1' was not found in the model deck\",\"instance\":\"/v1/start\",\"request_id\":\"req_a3dd6900-7909-48d3-b551-0140e73ac7fc\",\"error_domain\":\"input\",\"retryable\":false,\"error_type\":\"ValidateBundleError\",\"user_action\":{\"kind\":\"change_input\",\"detail\":\"Edit the bundle as each validation error says\"}}-input-False]": 0.203,
+ "tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_refusal_carries_only_the_verdict_the_hosted_api_sent[500-{\"title\":\"Internal Server Error\",\"status\":500,\"detail\":\"Unexpected failure.\",\"request_id\":\"req_42\"}-None-None]": 0.1605,
+ "tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_refusal_carries_only_the_verdict_the_hosted_api_sent[503-{\"title\":\"Internal Server Error\",\"status\":500,\"detail\":\"Unexpected failure.\",\"request_id\":\"req_42\"}-None-None]": 0.1954,
"tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_refusal_with_a_next_step_keeps_the_runner_reason_and_its_advice": 0.0862,
"tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_refused_key_points_at_the_pipelex_api_key": 0.0043,
"tests/unit/pipelex/hosted/test_hosted_error_rendering.py::TestHostedErrorRendering::test_a_refused_upload_points_at_the_key": 0.0002,
@@ -8525,7 +8540,9 @@
"tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_a_transport_failure_after_the_run_request_was_sent_is_an_unknown_outcome[True-transport_error4]": 0.0284,
"tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_a_transport_failure_before_the_start_is_sent_is_an_unreachable_api[transport_error0-ConnectError]": 0.0363,
"tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_a_transport_failure_before_the_start_is_sent_is_an_unreachable_api[transport_error1-ABORT_TIMEOUT]": 0.0221,
+ "tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_a_transport_failure_before_the_start_is_sent_is_an_unreachable_api[transport_error1-ConnectTimeout]": 0.2525,
"tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_a_transport_failure_before_the_start_is_sent_is_an_unreachable_api[transport_error2-ABORT_TIMEOUT]": 0.0371,
+ "tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_a_transport_failure_before_the_start_is_sent_is_an_unreachable_api[transport_error2-PoolTimeout]": 0.2446,
"tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_a_transport_failure_before_the_start_is_sent_is_an_unreachable_api[transport_error3-UnsupportedProtocol]": 0.1184,
"tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_a_transport_failure_before_the_start_is_sent_is_an_unreachable_api[transport_error4-ProxyError]": 0.0401,
"tests/unit/pipelex/hosted/test_hosted_run.py::TestHostedRun::test_an_acknowledged_start_is_announced_before_the_run_is_followed": 0.142,
@@ -8804,6 +8821,29 @@
"tests/unit/pipelex/language/test_mthds_factory.py::TestMthdsFactoryUnit::test_make_table_obj_for_pipe": 0.7024,
"tests/unit/pipelex/language/test_mthds_factory.py::TestMthdsFactoryUnit::test_pipe_compose_construct_fixed_and_template_serialization": 0.6595,
"tests/unit/pipelex/language/test_mthds_factory.py::TestMthdsFactoryUnit::test_pipe_compose_construct_serialization_format": 0.5015,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-a-digit-after-the-first-letter]": 0.002,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-a-plain-name]": 0.112,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-digit-led]": 0.0018,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-dotted]": 0.1222,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-pascal-case]": 0.0017,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-the-prefix-without-its-underscore]": 0.2601,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-the-reserved-prefix-alone]": 0.0016,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-the-reserved-prefix]": 0.2826,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[batch_as-underscore-led]": 0.0043,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-a-digit-after-the-first-letter]": 0.0164,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-a-plain-name]": 0.0056,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-digit-led]": 0.0017,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-dotted]": 0.2689,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-pascal-case]": 0.175,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-the-prefix-without-its-underscore]": 0.1227,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-the-reserved-prefix-alone]": 0.1291,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-the-reserved-prefix]": 0.1396,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_hold_their_stored_names_to_the_plain_name_grammar[result-underscore-led]": 0.0022,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_keep_a_plain_batch_over_off_the_reserved_prefix[a-plain-name]": 0.0018,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_keep_a_plain_batch_over_off_the_reserved_prefix[another-underscore-led-name]": 0.1209,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_keep_a_plain_batch_over_off_the_reserved_prefix[the-prefix-without-its-underscore]": 0.0019,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_keep_a_plain_batch_over_off_the_reserved_prefix[the-reserved-prefix-alone]": 0.2739,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_keep_a_plain_batch_over_off_the_reserved_prefix[the-reserved-prefix]": 0.0023,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_refuse_the_reserved_prefix[batch_as-a-plain-name]": 0.0032,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_refuse_the_reserved_prefix[batch_as-another-underscore-led-name]": 0.0014,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_refuse_the_reserved_prefix[batch_as-the-prefix-without-its-underscore]": 0.0021,
@@ -8820,6 +8860,12 @@
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_refuse_the_reserved_prefix[result-the-reserved-prefix-alone]": 0.0027,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_a_step_and_a_branch_refuse_the_reserved_prefix[result-the-reserved-prefix]": 0.0031,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_all_pipe_types_present": 0.0005,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_follows_the_plain_name_grammar[a-digit-after-the-first-letter]": 0.0022,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_follows_the_plain_name_grammar[a-plain-name]": 0.0009,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_follows_the_plain_name_grammar[dotted]": 0.0014,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_follows_the_plain_name_grammar[pascal-case]": 0.0021,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_follows_the_plain_name_grammar[the-reserved-prefix]": 0.2691,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_follows_the_plain_name_grammar[underscore-led]": 0.0032,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_refuses_the_reserved_prefix[a-plain-name]": 0.0008,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_refuses_the_reserved_prefix[another-underscore-led-name]": 0.0008,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_input_item_name_refuses_the_reserved_prefix[the-reserved-prefix]": 0.0011,
@@ -8830,6 +8876,7 @@
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_over_is_a_path_on_a_sequence_step_and_a_plain_name_on_a_parallel_branch[a-dotted-path]": 0.0014,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_over_is_a_path_on_a_sequence_step_and_a_plain_name_on_a_parallel_branch[a-leading-dot]": 0.0029,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_over_is_a_path_on_a_sequence_step_and_a_plain_name_on_a_parallel_branch[a-name-a-pipe-step-may-store-under]": 0.002,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_over_is_a_path_on_a_sequence_step_and_a_plain_name_on_a_parallel_branch[a-name-that-is-not-snake-case]": 0.1126,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_over_is_a_path_on_a_sequence_step_and_a_plain_name_on_a_parallel_branch[a-plain-name]": 0.0019,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_over_is_a_path_on_a_sequence_step_and_a_plain_name_on_a_parallel_branch[a-subscript]": 0.0048,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_batch_over_is_a_path_on_a_sequence_step_and_a_plain_name_on_a_parallel_branch[an-empty-segment]": 0.0023,
@@ -8837,6 +8884,12 @@
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_construct_alias_used": 0.0012,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_construct_field_schema_has_all_methods": 0.0008,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_construct_schema_matches_mthds_format": 0.0008,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_every_stored_name_carries_the_input_name_pattern[batch-input-item-name]": 0.0014,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_every_stored_name_carries_the_input_name_pattern[binding-step-result]": 0.2546,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_every_stored_name_carries_the_input_name_pattern[branch-batch-as]": 0.0003,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_every_stored_name_carries_the_input_name_pattern[branch-result]": 0.0006,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_every_stored_name_carries_the_input_name_pattern[step-batch-as]": 0.0012,
+ "tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_every_stored_name_carries_the_input_name_pattern[step-result]": 0.0004,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_exclusive_minimum_is_draft4_boolean": 0.0372,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_explicit_signature_tag_is_rejected": 0.0026,
"tests/unit/pipelex/language/test_mthds_schema.py::TestMthdsSchemaGeneration::test_input_names_follow_the_plain_name_grammar[dotted-None]": 0.0011,
@@ -10346,9 +10399,18 @@
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_blueprint.py::TestPipeBatchBlueprint::test_pipe_dependencies_correct": 0.837,
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_input.py::TestPipeBatchValidateInputs::test_validate_inputs_valid_cases[valid_multiple_inputs-blueprint1]": 0.2244,
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_input.py::TestPipeBatchValidateInputs::test_validate_inputs_valid_cases[valid_simple_batch-blueprint0]": 0.8001,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_accepts_a_plain_input_item_name[a-digit-after-the-first-letter]": 0.0013,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_accepts_a_plain_input_item_name[a-plain-name]": 0.2149,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_accepts_a_plain_input_item_name[the-prefix-without-its-underscore]": 0.0007,
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_accepts_valid_batch_config": 0.8182,
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_a_name_taking_the_reserved_prefix[input-item-name]": 0.0634,
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_a_name_taking_the_reserved_prefix[input-list-name]": 0.0006,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_an_input_item_name_that_is_not_a_plain_input_name[digit-led]": 0.0014,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_an_input_item_name_that_is_not_a_plain_input_name[dotted]": 0.0007,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_an_input_item_name_that_is_not_a_plain_input_name[pascal-case]": 0.0904,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_an_input_item_name_that_is_not_a_plain_input_name[the-reserved-prefix]": 0.1261,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_an_input_item_name_that_is_not_a_plain_input_name[underscore-led]": 0.0771,
+ "tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_an_input_list_name_taking_the_reserved_prefix": 0.0009,
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_empty_input_item_name": 0.0898,
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_input_item_name_in_inputs": 0.0009,
"tests/unit/pipelex/pipe_controllers/batch/test_pipe_batch_validation.py::TestPipeBatchValidation::test_rejects_input_item_name_same_as_input_list_name": 0.0004,
@@ -10618,9 +10680,25 @@
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_step_carrying_from_parses_as_a_binding_step": 0.0689,
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_step_spelling_its_path_from_path_is_refused[from-path-alone]": 0.0006,
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_step_spelling_its_path_from_path_is_refused[from-path-beside-from]": 0.0015,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[parallel-batch-as-dotted]": 0.0008,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[parallel-batch-as-pascal-case]": 0.0022,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[parallel-batch-as-reserved-prefix]": 0.0018,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[parallel-plain-batch-over-reserved-prefix]": 0.0042,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[parallel-result-dotted]": 0.2356,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[parallel-result-pascal-case]": 0.0026,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[parallel-result-reserved-prefix]": 0.0026,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[sequence-batch-as-dotted]": 0.002,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[sequence-batch-as-pascal-case]": 0.0016,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[sequence-batch-as-reserved-prefix]": 0.0009,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[sequence-plain-batch-over-reserved-prefix]": 0.0009,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[sequence-result-dotted]": 0.0011,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[sequence-result-pascal-case]": 0.0871,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_a_stored_name_that_is_not_plain_or_a_reserved_batch_over_is_refused_on_a_step_and_a_branch[sequence-result-reserved-prefix]": 0.2193,
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_branches_that_are_not_a_list_are_refused_as_a_list_type[a-number]": 0.0008,
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_branches_that_are_not_a_list_are_refused_as_a_list_type[null]": 0.003,
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_i10_a_binding_step_in_a_parallel_branch_is_refused": 0.0006,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_plain_stored_names_parse_on_a_step_and_a_branch[parallel]": 0.0019,
+ "tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_plain_stored_names_parse_on_a_step_and_a_branch[sequence]": 0.2115,
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_steps_that_are_not_a_list_are_refused_as_a_list_type[a-number]": 0.0012,
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_steps_that_are_not_a_list_are_refused_as_a_list_type[a-string]": 0.0004,
"tests/unit/pipelex/pipe_controllers/sequence/test_sequence_step_union.py::TestSequenceStepUnion::test_steps_that_are_not_a_list_are_refused_as_a_list_type[null]": 0.1671,
@@ -10630,7 +10708,35 @@
"tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_name_taking_the_reserved_prefix_is_refused_as_invalid_input_name[batch-as]": 0.0004,
"tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_name_taking_the_reserved_prefix_is_refused_as_invalid_input_name[plain-batch-over]": 0.0008,
"tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_name_taking_the_reserved_prefix_is_refused_as_invalid_input_name[result]": 0.0692,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_plain_batch_over_is_held_only_to_the_reserved_prefix[pascal-case]": 0.0008,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_plain_batch_over_is_held_only_to_the_reserved_prefix[underscore-led-outside-the-reserved-prefix]": 0.0015,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_plain_batch_over_taking_the_reserved_prefix_is_refused_as_invalid_input_name": 0.0006,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_plain_stored_name_is_accepted[a-digit-after-the-first-letter]": 0.0006,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_plain_stored_name_is_accepted[a-plain-name]": 0.2021,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_plain_stored_name_is_accepted[the-prefix-inside-the-name]": 0.0015,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_plain_stored_name_is_accepted[the-prefix-without-its-underscore]": 0.0008,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[batch_as-digit-led]": 0.0021,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[batch_as-dots-only]": 0.0012,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[batch_as-dotted]": 0.0004,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[batch_as-hyphenated]": 0.002,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[batch_as-pascal-case]": 0.0012,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[batch_as-the-reserved-prefix]": 0.0006,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[batch_as-underscore-led]": 0.2048,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[result-digit-led]": 0.2042,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[result-dots-only]": 0.0008,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[result-dotted]": 0.0013,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[result-hyphenated]": 0.0039,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[result-pascal-case]": 0.0889,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[result-the-reserved-prefix]": 0.1772,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_a_stored_name_that_is_not_a_plain_input_name_is_refused_as_invalid_input_name[result-underscore-led]": 0.1268,
"tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_rejects_batch_over_same_as_batch_as": 0.1171,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_the_refusal_explains_the_form_and_suggests_a_plain_name[a-longer-pascal-case-name]": 0.0015,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_the_refusal_explains_the_form_and_suggests_a_plain_name[dotted]": 0.2256,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_the_refusal_explains_the_form_and_suggests_a_plain_name[hyphenated]": 0.0012,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_the_refusal_explains_the_form_and_suggests_a_plain_name[no-suggestion]": 0.0009,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_the_refusal_explains_the_form_and_suggests_a_plain_name[pascal-case]": 0.0011,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_the_refusal_explains_the_form_and_suggests_a_plain_name[the-reserved-prefix-suggestion]": 0.0025,
+ "tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_the_refusal_explains_the_form_and_suggests_a_plain_name[the-reserved-prefix]": 0.0013,
"tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_the_refusal_suggests_the_name_without_the_prefix": 0.0003,
"tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_validate_batch_params_correct": 0.0003,
"tests/unit/pipelex/pipe_controllers/test_sub_pipe_blueprint.py::TestSubPipeBlueprint::test_validate_batch_params_incorrect": 0.0006,
@@ -13461,6 +13567,14 @@
"tests/unit/pipelex/system/test_config_resolution.py::TestConfigResolution::test_project_config_dir_when_exists": 0.002,
"tests/unit/pipelex/system/test_config_resolution.py::TestConfigResolution::test_project_root_returns_none_without_markers": 0.0006,
"tests/unit/pipelex/system/test_config_resolution.py::TestConfigResolution::test_project_root_returns_str_when_found": 0.0015,
+ "tests/unit/pipelex/system/test_integration_mode.py::TestIntegrationMode::test_every_other_integration_is_not_the_pipelex_command_line[ci]": 0.1991,
+ "tests/unit/pipelex/system/test_integration_mode.py::TestIntegrationMode::test_every_other_integration_is_not_the_pipelex_command_line[docker]": 0.1977,
+ "tests/unit/pipelex/system/test_integration_mode.py::TestIntegrationMode::test_every_other_integration_is_not_the_pipelex_command_line[fastapi]": 0.0011,
+ "tests/unit/pipelex/system/test_integration_mode.py::TestIntegrationMode::test_every_other_integration_is_not_the_pipelex_command_line[mcp]": 0.1717,
+ "tests/unit/pipelex/system/test_integration_mode.py::TestIntegrationMode::test_every_other_integration_is_not_the_pipelex_command_line[n8n]": 0.0024,
+ "tests/unit/pipelex/system/test_integration_mode.py::TestIntegrationMode::test_every_other_integration_is_not_the_pipelex_command_line[pytest]": 0.2002,
+ "tests/unit/pipelex/system/test_integration_mode.py::TestIntegrationMode::test_every_other_integration_is_not_the_pipelex_command_line[python]": 0.0005,
+ "tests/unit/pipelex/system/test_integration_mode.py::TestIntegrationMode::test_only_the_cli_is_the_pipelex_command_line": 0.2321,
"tests/unit/pipelex/system/test_job_metadata_log_context.py::TestJobMetadataLogContext::test_an_absent_identifier_inherits_the_outer_binding": 0.2596,
"tests/unit/pipelex/system/test_job_metadata_log_context.py::TestJobMetadataLogContext::test_binds_the_run_identifiers_and_the_step_identifier": 0.0779,
"tests/unit/pipelex/system/test_job_metadata_log_context.py::TestJobMetadataLogContext::test_the_previous_binding_comes_back_on_return_and_on_raise": 0.0006,
diff --git a/CHANGELOG.md b/CHANGELOG.md
index b6734a67d..84bff2f9e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,7 @@
### Changed
+- **MTHDS standard 4.0.0 (Breaking)**: pipelex now requires `mthds==0.20.0` and `pipelex-sdk==0.37.0`, the releases that report MTHDS standard `4.0.0`, the language this runtime has implemented since v0.75.0, so everyone downstream inherits those exact versions and a project that pins either package itself has to move with them. `pipelex --version` prints `mthds-standard 4.0.0`, every crate pipelex normalizes is stamped with `mthds_version` `4.0.0` while crate fingerprints stay the same, and a package whose `METHODS.toml` constrains `mthds_version` to `^3.0.0`, `~3.0.0` or exactly `3.0.0` now logs a warning when it loads, which `>=3.0.0` or `^4.0.0` does not.
- **Stored names are plain input names (Breaking)**: every name under which a step stores a value in working memory, a `PipeSequence` step's or a `PipeParallel` branch's `result`, the `batch_as` of either, and a `PipeBatch`'s `input_item_name`, must now be a plain input name matching `[a-z][a-z0-9_]*`, as a binding step's `result` already had to, and a name in any other form, such as `Pages`, `doc.pages` or `_pages`, is refused as `invalid_input_name` wherever a bundle loads, and by the MTHDS JSON Schema, which now carries the input-name pattern on these fields. Rename such a name to a plain one, such as `pages`, along with every input, binding path and `batch_over` that reads it; a plain `batch_over` is still refused only when it starts with the reserved `_bound_`.
- **Hosted-run guidance in messages and help**: the next step of a refused Pipelex API key names `pipelex login` and the working directory's `.env` rather than a shell export, which a `.env` file setting the key overrides, and `pipelex login` names `[run] execution = "hosted"` rather than `pipelex init` to make hosted runs the default. A CLI run missing a provider key, and the `pipelex doctor` report, offer the hosted Pipelex API as a way out; a failed `pipelex-agent` boot points at `pipelex-agent migrate` and `pipelex-agent init` rather than the interactive `pipelex init config`; and `FormerReleaseConfigError` carries its remedy, `pipelex migrate`, as its `user_action`. The `run` help of both CLIs names hosted runs, catalog ids, local method directories and TOML or inline inputs, and `pipelex-agent --help` describes the program rather than printing an internal note.
diff --git a/docs/api-server/openapi/pipelex-api.openapi.yaml b/docs/api-server/openapi/pipelex-api.openapi.yaml
index 30414fd6f..014e6d5c7 100644
--- a/docs/api-server/openapi/pipelex-api.openapi.yaml
+++ b/docs/api-server/openapi/pipelex-api.openapi.yaml
@@ -5114,7 +5114,7 @@ components:
content.
- Keyed in `PipeIOContract.inputs` by the authored input name, dotted names included.
+ Keyed in `PipeIOContract.inputs` by the authored input name, a plain name.
Every member is required: `item_count` is always on the wire, `null` off the fixed arm.
diff --git a/docs/building-methods/pipes/running-on-the-hosted-api.md b/docs/building-methods/pipes/running-on-the-hosted-api.md
index 066317c43..5f3cffa53 100644
--- a/docs/building-methods/pipes/running-on-the-hosted-api.md
+++ b/docs/building-methods/pipes/running-on-the-hosted-api.md
@@ -75,14 +75,37 @@ Two cases where `pipelex run --hosted` goes further than `prepare_inputs`:
## Errors
-A failure is one of the SDK's typed errors, from `pipelex_sdk.errors`, all subclasses of the protocol's `PipelineRequestError`, with one exception: `start` and `execute`, which the client inherits from the MTHDS protocol client, let httpx's transport errors through. A `ConnectError` or a `ConnectTimeout` means the request never left your machine. A `ReadError`, a `RemoteProtocolError` or a `ReadTimeout` can come after the hosted API received it, so a run may exist with no id returned: check the run history on app.pipelex.com before starting it again.
+A failure is one of the SDK's typed errors, from `pipelex_sdk.errors`, all subclasses of the protocol's `PipelineRequestError`:
- `ApiResponseError` is a refusal the hosted API answered: `status`, the reason in `server_message`, the next step in `user_action.detail` when the server advised one, and `validation_errors` locating the faults of a bundle it refused to load.
- `RunFailedError` is a run that started and failed; `error` holds its stored report, with the runner's `error_type`, `message`, `error_domain` and `user_action`.
- `RunTimeoutError` is a run that outlived the wait; it keeps running, and `run_id` reads its result later with `wait_for_result`.
-- `ApiUnreachableError` is a hosted API that could not be reached at all, on the routes the SDK owns: the signature read, the uploads, and the polling of a started run.
+- `ApiUnreachableError` is a request that got no answer, on every route, `start` and `execute` included. Its `__cause__` is httpx's exception, and its `code` names the failure: `ABORT_TIMEOUT` for a read or a write that timed out, otherwise httpx's class name, such as `ConnectError`, `ConnectTimeout`, `ReadError` or `RemoteProtocolError`.
- `InputPreparationError` and its subclasses are a local file that could not be read or uploaded.
+### A Start That Got No Answer
+
+An `ApiUnreachableError` raised by `start` does not say by itself whether the run was created, but its cause does. A `ConnectError`, `ConnectTimeout`, `PoolTimeout`, `UnsupportedProtocol` or `ProxyError` means the request never left your machine, so no run exists and starting again is safe. Any other cause, such as a `ReadError`, a `WriteError`, a `RemoteProtocolError` or a timeout coded `ABORT_TIMEOUT`, can come after the hosted API received the request, so a run may exist with no id returned: check the run history on app.pipelex.com before starting it again.
+
+```python
+import httpx
+from pipelex_sdk.errors import ApiUnreachableError
+
+NEVER_SENT = (httpx.ConnectError, httpx.ConnectTimeout, httpx.PoolTimeout, httpx.UnsupportedProtocol, httpx.ProxyError)
+
+try:
+ started = await client.start(method_ref="github.com/Pipelex/methods/[email protected]", inputs={"text": "Hello world."})
+except ApiUnreachableError as exc:
+ if isinstance(exc.__cause__, NEVER_SENT):
+ ... # No run was created: check the network and the origin, then start again.
+ else:
+ ... # A run may exist: look it up in the run history before starting again.
+```
+
+`start_and_wait` sends more than the start, so tell its requests apart with its two callbacks. `on_starting` is called right before each request that may create a run is sent, and `on_started` with the acknowledgement once the run exists. A failure before `on_starting` was called started nothing, a failure after `on_started` concerns a run whose id you hold, which `wait_for_result` follows, and only a failure in between needs its cause read as above.
+
+`pipelex run --hosted` and `pipelex-agent run --runner hosted` draw the same line, and report the second case as pipelex's own [`HostedRunOutcomeUnknownError`](../../errors/hosted-run-outcome-unknown-error.md). `PipelexAPIClient` never raises that error, so a program that calls the client directly reads the cause itself.
+
## Related Documentation
- [Running on the Hosted API](../../tools/cli/run.md#running-on-the-hosted-api) — The same runs from `pipelex run --hosted`
diff --git a/pipelex/cli/agent_cli/CLAUDE.md b/pipelex/cli/agent_cli/CLAUDE.md
index 335adb978..c2af16d8f 100644
--- a/pipelex/cli/agent_cli/CLAUDE.md
+++ b/pipelex/cli/agent_cli/CLAUDE.md
@@ -106,6 +106,6 @@ commands/
- **Validate refusals are verdicts**: the `validate` commands run their library load inside `translate_to_validate_bundle_error` (`pipelex/pipeline/validate_bundle_translation.py`), so every input-domained refusal raised while loading a bundle, the unknown model (`PipeOperatorModelChoiceError`, an `unknown_model` item) included, reaches the command as a `ValidateBundleError` and leaves with the invalid-verdict envelope and exit 1. No `validate` command keeps an arm of its own for a model-choice error; exit 2 stays for a failure of the tool or its environment (config, runtime, security).
- **Run refusals are verdicts too**: a run loads its bundle inside the same translation (`acquire_library`), so an invalid bundle leaves `run pipe` / `run bundle` / `run method` as a `ValidateBundleError` with exit 1, through the generic `agent_error` arm, and `_assemble_error_payload` copies the report's `validation_errors` into the envelope for any cause that carries them. `run_pipeline_core` sets `library_dirs_are_callers=True`, so a refusal in a `-L` directory (or the bundle's own directory) is the same verdict; `run bundle`'s own parse of a bundle without `--pipe` goes through the translation too. So no `run` command keeps an arm of its own for a model-choice error either: an unknown model reaches it as the verdict's `unknown_model` item.
- **Hosted runs**: every `run` subcommand takes `--runner local|hosted`, `--hosted/--local` and `--base-url`; `resolve_agent_run_execution()` (`run/_run_hosted.py`) settles them through `pipelex.hosted.execution.resolve_run_execution` (the flag, then `[run] execution`, then local), refusing a `--runner` that contradicts the flag pair and a `--base-url` on a local run; a `PipelexConfigError` there carries `AGENT_INIT_FAILURE_HINT`, the hint a failed boot gives (`agent_cli_factory.py`). A hosted run boots nothing: it builds a `HostedRunRequest` from what `pipelex/cli/commands/run/_hosted_sources.py` resolves (the bundle and its library's `.mthds` files, a pipe's library, or a method's files; an address or a catalog id as `method_ref` / `method_id`, never fetched) and `run_hosted_for_agent()` runs it through `pipelex.hosted.hosted_run.run_hosted`, which reads the signature and uploads local input files (only when some input string names an existing local file, so a method with an address-based dependency runs with any other inputs), then drives the lifecycle `start_and_wait` drives step by step (the `/v1/version` handshake, `start`, `wait_for_result`, and the blocking `execute` on a server with no run store), so a failure while following an acknowledged run is a `HostedRunPollingError` naming the run, and a transport failure after the run request was sent is a `HostedRunOutcomeUnknownError` rather than an `ApiUnreachableError`. `run_hosted`'s `on_started` callback records the acknowledged run's id, so Ctrl-C (`KeyboardInterrupt`, or the `CancelledError` of a cancelled task) leaves as a `HostedRunInterruptedError` envelope carrying `pipeline_run_id`, with exit code 130. `run bundle` on a file with no `-L` sends `PIPELEXPATH`'s files (`hosted_library_dirs`), and an installed method named like a catalog id is that method. An exception no hosted arm names leaves through the command-boundary catch-all as the envelope. Its success envelope is `build_run_output()`'s, with the main output's content as `json`, an empty `markdown`, the working memory dump and `pipeline_run_id`; nothing is written to disk. `--dry-run` / `--mock-inputs` are refused on it, while `--graph` and `--costs` are accepted and ignored. There is no global `--runner` any more, and no `ctx.obj`.
-- **Hosted refusals**: `agent_error_hosted()` routes pipelex-sdk's `ApiResponseError` (every `PipelexAPIClient` route raises it on a non-2xx answer) to `agent_error_api_response()`. `api_response_error_payload()` builds the envelope from the problem document alone: `error_type` is the runner's class (`ValidateBundleError` at load, as a local run reports it, or the root fault of a failed run, which a local run reports as `cause_type` under `PipelineExecutionError`; this path has no `cause_type`), `message` is the error's own `API POST /v1/start failed (<status>): <reason>` without the next step it appends, `hint` is `user_action.detail`, and `error_domain` / `error_category` / `retryable` / `validation_errors` / `pipe_code` / `pipe_stack` / `request_id` are the runner's, plus `error_code` (the problem's `code`), `retry_after_seconds` (the `Retry-After` header) and `http_status`. It deliberately bypasses `agent_error()`'s lookups: the dict hints keyed on a class name local commands (`doctor`, `check-model`) that cannot fix a remote refusal, and the domain is only the runner's to say, so one with no `error_domain` carries none. A refusal with no `user_action` — the hosted plane's own answers in front of the runner: the gateway's 403 for a bad key, the rate limiter's 429, the unreachable runner's 503 — gets its status's next step from `pipelex.hosted.error_rendering` (`HOSTED_REFUSAL_NEXT_STEPS_BY_STATUS`, the table the human CLI reads too; 401 and 403 point at `PIPELEX_API_KEY` and `pipelex login`, 404 at the method and the origin), else `HOSTED_REFUSAL_CALLER_NEXT_STEP` for any other 4xx and `HOSTED_SERVER_FAULT_NEXT_STEP` for the rest. Only a 429 that did not say otherwise is inferred `retryable`: the platform can answer a 503 after the run completed, when it failed to record the result, so its hint warns that a retry can repeat a paid run. Every other failure, the SDK's and pipelex's own `HostedRunError` subclasses alike, goes through `agent_error()` with what `describe_hosted_error()` reads off it, the view the human CLI prints too: the class, message, next step, domain and `retryable`, the `pipeline_run_id` of any failure met once the run was acknowledged (`RunFailedError`, `RunTimeoutError`, `MissingMainStuffError`, `HostedRunPollingError`, `HostedRunInterruptedError`), a `retryable` passed whenever the hosted API gave a verdict, `false` included, so `RETRYABLE_ERROR_TYPES` keyed on the runner's class never overrides it, and the `validation_errors` of a failed run or of a `HostedMethodInvalidError` (pipe-io's verdict on a method that does not load, whose items name the faulty file in `source`); a `RunFailedError` adds `run_status` and its report's category, model and provider. The markdown renderer keeps a runner item this pipelex's `ValidationErrorItem` cannot type (a newer `error_type`, an unknown field) as JSON under Details instead of failing.
+- **Hosted refusals**: `agent_error_hosted()` routes pipelex-sdk's `ApiResponseError` (every `PipelexAPIClient` route raises it on a non-2xx answer) to `agent_error_api_response()`. `api_response_error_payload()` builds the envelope from the problem document alone: `error_type` is the runner's class (`ValidateBundleError` at load, as a local run reports it, or the root fault of a failed run, which a local run reports as `cause_type` under `PipelineExecutionError`; this path has no `cause_type`), `message` is the error's own `API POST /v1/start failed (<status>): <reason>` without the next step it appends, `hint` is `user_action.detail`, and `error_domain` / `error_category` / `retryable` / `validation_errors` / `pipe_code` / `pipe_stack` / `request_id` are the runner's, plus `error_code` (the problem's `code`), `retry_after_seconds` (the `Retry-After` header) and `http_status`. It deliberately bypasses `agent_error()`'s lookups: the dict hints keyed on a class name local commands (`doctor`, `check-model`) that cannot fix a remote refusal, and the domain is only the runner's to say, so one with no `error_domain` carries none. Both `error_domain` and `retryable` come from `pipelex.hosted.error_rendering.sent_verdict()`, the members the problem document carried, never from the verdict pipelex-sdk decides for every `ApiResponseError`, which fills an unsent member from its own status table and reads every 5xx, a 503 included, as retryable. A refusal with no `user_action` — the hosted plane's own answers in front of the runner: the gateway's 403 for a bad key, the rate limiter's 429, the unreachable runner's 503 — gets its status's next step from `pipelex.hosted.error_rendering` (`HOSTED_REFUSAL_NEXT_STEPS_BY_STATUS`, the table the human CLI reads too; 401 and 403 point at `PIPELEX_API_KEY` and `pipelex login`, 404 at the method and the origin), else `HOSTED_REFUSAL_CALLER_NEXT_STEP` for any other 4xx and `HOSTED_SERVER_FAULT_NEXT_STEP` for the rest. Only a 429 that did not say otherwise is inferred `retryable`: the platform can answer a 503 after the run completed, when it failed to record the result, so its hint warns that a retry can repeat a paid run. Every other failure, the SDK's and pipelex's own `HostedRunError` subclasses alike, goes through `agent_error()` with what `describe_hosted_error()` reads off it, the view the human CLI prints too: the class, message, next step, domain and `retryable`, the `pipeline_run_id` of any failure met once the run was acknowledged (`RunFailedError`, `RunTimeoutError`, `MissingMainStuffError`, `HostedRunPollingError`, `HostedRunInterruptedError`), a `retryable` passed whenever the hosted API gave a verdict, `false` included, so `RETRYABLE_ERROR_TYPES` keyed on the runner's class never overrides it, and the `validation_errors` of a failed run or of a `HostedMethodInvalidError` (pipe-io's verdict on a method that does not load, whose items name the faulty file in `source`); a `RunFailedError` adds `run_status` and its report's category, model and provider. The markdown renderer keeps a runner item this pipelex's `ValidationErrorItem` cannot type (a newer `error_type`, an unknown field) as JSON under Details instead of failing.
- **Method-reference failures**: the `run`/`validate`/`inputs` method commands call `resolve_method_target(..., raise_ref_errors=True)` and shape the typed `MethodRefError` subclasses into `agent_error(...)` themselves (validate uses `exit_code=2`, its no-verdict convention) — the human CLI's red-text rendering stays in `resolve_method_target`'s default arm.
- **TOML handling**: Uses `tomlkit` (not `tomllib`) to preserve formatting and inline tables.
diff --git a/pipelex/cli/agent_cli/commands/agent_output.py b/pipelex/cli/agent_cli/commands/agent_output.py
index a3651bb10..53812c4c3 100644
--- a/pipelex/cli/agent_cli/commands/agent_output.py
+++ b/pipelex/cli/agent_cli/commands/agent_output.py
@@ -30,7 +30,7 @@ from pipelex_sdk.errors import ApiResponseError
from pydantic import ValidationError
from pipelex.base_exceptions import PipelexError, ValidationErrorItem, iter_cause_chain
-from pipelex.hosted.error_rendering import hosted_refusal_message, hosted_refusal_next_step
+from pipelex.hosted.error_rendering import hosted_refusal_message, hosted_refusal_next_step, sent_verdict
from pipelex.pipe_run.located_failure import find_root_fault
from pipelex.pipeline.exceptions import PipelineExecutionError, ValidateBundleError
from pipelex.pipeline.validation_render import build_fix_command, count_applicable_fixes, format_validation_error_items_markdown
@@ -503,7 +503,8 @@ def api_response_error_payload(*, error: ApiResponseError) -> dict[str, Any]:
status class (a 4xx asks for a change to the request, anything else for a report); never the hint keyed on the
runner's class, which names a local command that cannot fix a remote refusal.
- ``retryable`` (only when true, as on every envelope), ``error_domain`` and ``error_category`` are the answer's,
- with no local fallback, since only the runner knows whether the caller or its operator has to act. The one
+ with no local fallback, since only the runner knows whether the caller or its operator has to act; the verdict
+ pipelex-sdk decides for every refusal is not read, since it fills an unsent member from its own table. The one
exception is ``retryable`` on a 429 that did not say, a refusal sent before anything ran. A 503 is never
inferred retryable: a hosted plane can answer it after the run completed.
- ``validation_errors`` are the runner's items, each whole, as it sent them.
@@ -520,10 +521,11 @@ def api_response_error_payload(*, error: ApiResponseError) -> dict[str, Any]:
"message": hosted_refusal_message(error=error),
"hint": hosted_refusal_next_step(error=error),
}
- if error.retryable or (error.retryable is None and error.status in _API_RETRYABLE_STATUSES):
+ sent = sent_verdict(error=error)
+ if sent.retryable or (sent.retryable is None and error.status in _API_RETRYABLE_STATUSES):
payload["retryable"] = True
- if error.error_domain:
- payload["error_domain"] = error.error_domain
+ if sent.error_domain:
+ payload["error_domain"] = sent.error_domain
if error_category := _non_empty_string(value=problem.get("error_category")):
payload["error_category"] = error_category
if error.validation_errors:
diff --git a/pipelex/hosted/error_rendering.py b/pipelex/hosted/error_rendering.py
index c226f2845..b9bf625a0 100644
--- a/pipelex/hosted/error_rendering.py
+++ b/pipelex/hosted/error_rendering.py
@@ -80,6 +80,30 @@ HOSTED_SERVER_FAULT_NEXT_STEP = (
HOSTED_UNREACHABLE_NEXT_STEP = f"Check the network connection. {HOSTED_BASE_URL_NEXT_STEP}"
+class SentVerdict(NamedTuple):
+ """The `error_domain` and `retryable` a hosted API's problem document carried, each `None` when it sent none."""
+
+ error_domain: str | None
+ retryable: bool | None
+
+
+def sent_verdict(*, error: ApiResponseError) -> SentVerdict:
+ """The verdict the hosted API sent with a refusal, read off the problem document it answered.
+
+ pipelex-sdk gives every `ApiResponseError` a decided `error_domain` and `retryable`, filling a member the server
+ did not send from its own table by status, which reads every unlabelled 5xx, a 503 included, as retryable. A 503
+ does not say whether the run happened (see `_UNAVAILABLE_NEXT_STEP`), and who has to act is only the runner's to
+ say, so both CLIs report what the server sent and nothing the SDK inferred. `problem` keeps the server's members.
+ """
+ problem = error.problem or {}
+ sent_domain = problem.get("error_domain")
+ sent_retryable = problem.get("retryable")
+ return SentVerdict(
+ error_domain=sent_domain if isinstance(sent_domain, str) and sent_domain else None,
+ retryable=sent_retryable if isinstance(sent_retryable, bool) else None,
+ )
+
+
class HostedErrorView(NamedTuple):
"""A hosted run's failure, as both CLIs tell it: the class to branch on, what happened, and what to do next.
@@ -151,8 +175,7 @@ def describe_hosted_error(*, error: PipelineRequestError | HostedRunError) -> Ho
error_type = error.error_type or error_type
message = hosted_refusal_message(error=error)
next_step = hosted_refusal_next_step(error=error)
- error_domain = error.error_domain
- retryable = error.retryable
+ error_domain, retryable = sent_verdict(error=error)
validation_errors = tuple(error.validation_errors or ())
case RunFailedError():
report = error.error
diff --git a/pipelex/hosted/exceptions.py b/pipelex/hosted/exceptions.py
index c54591137..8aef77401 100644
--- a/pipelex/hosted/exceptions.py
+++ b/pipelex/hosted/exceptions.py
@@ -88,7 +88,8 @@ class HostedRunOutcomeUnknownError(HostedRunError):
The hosted API may have created the run before the connection failed, with no way to tell from here: its id never
arrived. Running the command again could start a second paid run, so the next step is the run history first. The
- cause is the transport failure, a read, a write or a protocol failure met after the request left this machine.
+ cause is pipelex-sdk's `ApiUnreachableError`, whose own cause is the transport failure: a read, a write, a protocol
+ failure or a body that could not be decoded, met after the request left this machine.
"""
error_domain = ErrorDomain.RUNTIME
diff --git a/pipelex/hosted/hosted_run.py b/pipelex/hosted/hosted_run.py
index 3d560e0c7..6334e92fc 100644
--- a/pipelex/hosted/hosted_run.py
+++ b/pipelex/hosted/hosted_run.py
@@ -146,23 +146,19 @@ async def _start_or_execute(*, client: PipelexAPIClient, request: HostedRunReque
A start the server refuses for a missing run store created no run, so running the blocking route next cannot run
the method twice.
- The SDK maps a transport failure to `ApiUnreachableError` on the routes it owns, but `start` and `execute`, which
- it inherits from mthds, let httpx's error through, and only some of them mean the hosted API was not reached. A
- failure before the request left this machine is mapped as the SDK maps it. Any later one, a connection lost after
- the request was sent, is a `HostedRunOutcomeUnknownError`: the hosted API may have created the run, and its id
- never arrived.
+ The SDK raises `ApiUnreachableError` for every transport failure, chained from httpx's error, and only some of
+ them mean the hosted API was not reached. A failure before the request left this machine stays the SDK's error.
+ Any later one, a connection lost or a read timed out after the request was sent, is a
+ `HostedRunOutcomeUnknownError`: the hosted API may have created the run, and its id never arrived.
"""
try:
return await _start_or_execute_unmapped(client=client, request=request, inputs=inputs)
- except _PRE_SEND_TRANSPORT_ERRORS as exc:
- if isinstance(exc, httpx.TimeoutException):
- msg = f"Could not reach Pipelex API at {client.base_url} (timeout)"
- raise ApiUnreachableError(msg, api_url=client.base_url, code="ABORT_TIMEOUT") from exc
- code = type(exc).__name__
- msg = f"Could not reach Pipelex API at {client.base_url} ({code})"
- raise ApiUnreachableError(msg, api_url=client.base_url, code=code) from exc
- except httpx.TransportError as exc:
- msg = f"The connection to the hosted API at {client.base_url} failed after the run request was sent ({type(exc).__name__}: {exc})"
+ except ApiUnreachableError as exc:
+ transport_error = exc.__cause__
+ if isinstance(transport_error, _PRE_SEND_TRANSPORT_ERRORS):
+ raise
+ failure = f"{type(transport_error).__name__}: {transport_error}" if transport_error is not None else str(exc)
+ msg = f"The connection to the hosted API at {client.base_url} failed after the run request was sent ({failure})"
raise HostedRunOutcomeUnknownError(msg) from exc
@@ -178,8 +174,9 @@ async def _follow(*, client: PipelexAPIClient, run_id: str) -> RunResults:
except (RunFailedError, RunTimeoutError, MissingMainStuffError):
raise
except (PipelineRequestError, httpx.HTTPError, ValueError) as exc:
- # `ValueError` covers an answer that is not what the results route promises: a body that is not JSON
- # (`json.JSONDecodeError`) or one that drifted from the SDK's model (pydantic's `ValidationError`).
+ # The SDK raises a `PipelineRequestError` for the network and for an answer it cannot read; httpx's errors and
+ # `ValueError` (a body that is not JSON, one that drifted from the SDK's model) are caught too, so that no
+ # failure met after the start was acknowledged loses the id of a run that may still be going.
msg = f"The run {run_id} started on the hosted API, but following it to its result failed: {exc}"
raise HostedRunPollingError(msg, pipeline_run_id=run_id) from exc
diff --git a/pyproject.toml b/pyproject.toml
index b32ee99ff..fe8f38d6a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -31,7 +31,7 @@ dependencies = [
"json2html>=1.3.0",
"kajson==0.7.1",
"markdown-it-py[linkify]>=3.0.0", # the Markdown concept, the `markdown` filter and the built-in PDF engine
- "mthds==0.19.0",
+ "mthds==0.20.0",
"networkx>=3.4.2",
"openai>=2.0.0",
"opentelemetry-api>=1.39.0",
@@ -43,7 +43,7 @@ dependencies = [
# The client for the hosted Pipelex API, behind hosted runs (pipelex/hosted/). Pinned exactly, like
# mthds: each pipelex-sdk release pins mthds exactly too, so the release chosen here must pin the
# same mthds as this file, and the two pins move together (the bump-mthds skill says so).
- "pipelex-sdk==0.31.0",
+ "pipelex-sdk==0.37.0",
"polyfactory>=2.21.0",
"portkey-ai>=2.1.0",
"posthog>=6.7.0",
diff --git a/tests/unit/pipelex/hosted/test_hosted_error_rendering.py b/tests/unit/pipelex/hosted/test_hosted_error_rendering.py
index 4b7a52a8a..7201946ff 100644
--- a/tests/unit/pipelex/hosted/test_hosted_error_rendering.py
+++ b/tests/unit/pipelex/hosted/test_hosted_error_rendering.py
@@ -97,6 +97,26 @@ class TestHostedErrorRendering:
error = _refusal(status=status, body=HostedRefusals.SERVER_FAULT)
assert hosted_refusal_next_step(error=error) == expected_next_step
+ @pytest.mark.parametrize(
+ ("status", "body", "expected_domain", "expected_retryable"),
+ [
+ (422, HostedRefusals.INVALID_BUNDLE, "input", False),
+ (401, HostedRefusals.UNAUTHORIZED, None, None),
+ (500, HostedRefusals.SERVER_FAULT, None, None),
+ (503, HostedRefusals.SERVER_FAULT, None, None),
+ ],
+ )
+ def test_a_refusal_carries_only_the_verdict_the_hosted_api_sent(
+ self, status: int, body: str, expected_domain: str | None, expected_retryable: bool | None
+ ) -> None:
+ """pipelex-sdk fills an unsent member from its own table, which reads a 503 as retryable; the view reports what the server said."""
+ error = _refusal(status=status, body=body)
+
+ view = describe_hosted_error(error=error)
+
+ assert view.error_domain == expected_domain
+ assert view.retryable == expected_retryable
+
def test_an_unreachable_api_names_the_base_url_settings(self) -> None:
error = ApiUnreachableError("Could not reach Pipelex API at https://api.test (ConnectError)", api_url=API_URL, code="ConnectError")
diff --git a/tests/unit/pipelex/hosted/test_hosted_run.py b/tests/unit/pipelex/hosted/test_hosted_run.py
index 077921993..386cec14c 100644
--- a/tests/unit/pipelex/hosted/test_hosted_run.py
+++ b/tests/unit/pipelex/hosted/test_hosted_run.py
@@ -76,6 +76,23 @@ def _mocked_client(
return client
+async def _sdk_transport_failure(*, transport_error: httpx.TransportError) -> ApiUnreachableError:
+ """The error the real client raises when its transport fails this way while sending `POST /v1/start`."""
+
+ def _fail(_request: httpx.Request) -> httpx.Response:
+ raise transport_error
+
+ sdk_client = PipelexAPIClient(api_key="plx_sk_test_not_a_secret", base_url="https://hosted.test")
+ sdk_client.client = httpx.AsyncClient(transport=httpx.MockTransport(_fail))
+ try:
+ with pytest.raises(ApiUnreachableError) as exc_info:
+ await sdk_client.start(pipe_code="entry", mthds_contents=[BUNDLE_FILE.content])
+ finally:
+ await sdk_client.close()
+ assert exc_info.value.__cause__ is transport_error
+ return exc_info.value
+
+
class TestHostedRun:
@pytest.mark.asyncio
async def test_an_inline_bundle_without_inputs_starts_and_waits_on_its_contents(self, mocker: MockerFixture) -> None:
@@ -376,8 +393,8 @@ class TestHostedRun:
("transport_error", "expected_code"),
[
(httpx.ConnectError("connection refused"), "ConnectError"),
- (httpx.ConnectTimeout("connect timed out"), "ABORT_TIMEOUT"),
- (httpx.PoolTimeout("no free connection"), "ABORT_TIMEOUT"),
+ (httpx.ConnectTimeout("connect timed out"), "ConnectTimeout"),
+ (httpx.PoolTimeout("no free connection"), "PoolTimeout"),
(httpx.UnsupportedProtocol("unknown scheme"), "UnsupportedProtocol"),
(httpx.ProxyError("proxy refused"), "ProxyError"),
],
@@ -386,12 +403,14 @@ class TestHostedRun:
self, mocker: MockerFixture, transport_error: httpx.TransportError, expected_code: str
) -> None:
"""No byte of the start left this machine, so no run exists: checking the network is the right advice."""
+ sdk_error = await _sdk_transport_failure(transport_error=transport_error)
client = _mocked_client(mocker)
- client.start.side_effect = transport_error
+ client.start.side_effect = sdk_error
with pytest.raises(ApiUnreachableError) as exc_info:
await run_hosted(client=client, request=HostedRunRequest(mthds_files=[BUNDLE_FILE]))
+ assert exc_info.value is sdk_error
assert exc_info.value.api_url == "https://hosted.test"
assert exc_info.value.code == expected_code
assert str(exc_info.value).startswith("Could not reach Pipelex API at https://hosted.test")
@@ -412,16 +431,17 @@ class TestHostedRun:
self, mocker: MockerFixture, transport_error: httpx.TransportError, bare_runner: bool
) -> None:
"""The hosted API may have created the run before the connection failed, so "check the network" would lead to a second paid run."""
+ sdk_error = await _sdk_transport_failure(transport_error=transport_error)
bare_version = '{"protocol_version":"0.1.0","implementation":"pipelex-api","implementation_version":"0.76.0"}'
client = _mocked_client(mocker, version=bare_version) if bare_runner else _mocked_client(mocker)
- client.start.side_effect = transport_error
- client.execute.side_effect = transport_error
+ client.start.side_effect = sdk_error
+ client.execute.side_effect = sdk_error
with pytest.raises(HostedRunOutcomeUnknownError) as exc_info:
await run_hosted(client=client, request=HostedRunRequest(mthds_files=[BUNDLE_FILE]))
error = exc_info.value
- assert error.__cause__ is transport_error
+ assert error.__cause__ is sdk_error
assert type(transport_error).__name__ in error.message
assert error.user_action is not None
assert "run history" in error.user_action.detail
diff --git a/uv.lock b/uv.lock
index cd53efb0c..155e691d3 100644
--- a/uv.lock
+++ b/uv.lock
@@ -2738,7 +2738,7 @@ wheels = [
[[package]]
name = "mthds"
-version = "0.19.0"
+version = "0.20.0"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "httpx" },
@@ -2747,9 +2747,9 @@ dependencies = [
{ name = "tomlkit" },
{ name = "typing-extensions" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/e7/dc/b793c0e03a1a7599bd35d876f46cb801dfe7d83f8f1685beb48672eb6a47/mthds-0.19.0.tar.gz", hash = "sha256:bf49afce9ae9302c524929b00ba4697959a3ffc8bc059d89d6de1e42ec60106a", size = 281433, upload-time = "2026-10-03T22:58:58.201Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/df/31/179dfe444a09ed83c6ab441f7b4f64a12a4559409337160b87da9493a378/mthds-0.20.0.tar.gz", hash = "sha256:85684266c2a17129c0b6098af6853d882e2183541c35cf556eaef37775a5bdf7", size = 281680, upload-time = "2026-10-09T16:46:49.554Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/61/f6/332fc128ea66f91996bdd0de9cf1aa779604ec423a29c4bca9285cc89732/mthds-0.19.0-py3-none-any.whl", hash = "sha256:42e0894c063bf2f47b4695e63a4f80429beefe388f20e3d88ffc9d4485c60e0e", size = 111462, upload-time = "2026-10-03T22:58:56.838Z" },
+ { url = "https://files.pythonhosted.org/packages/86/33/c3a05657f3f4b40a2f7eeb86b2ec0bacd3ced55f5b4fa2a0e4b6e8468381/mthds-0.20.0-py3-none-any.whl", hash = "sha256:6fa0fa2f0e7e098afd18e6a96a6b10b2a005f22239fd471dadb880004ad94dca", size = 111489, upload-time = "2026-10-09T16:46:47.94Z" },
]
[[package]]
@@ -3708,7 +3708,7 @@ requires-dist = [
{ name = "mkdocs-meta-manager", marker = "extra == 'docs'", specifier = ">=1.1.0" },
{ name = "mkdocs-redirects", marker = "extra == 'docs'", specifier = "==1.2.2" },
{ name = "moto", extras = ["dynamodb", "s3"], marker = "extra == 'dev'", specifier = ">=5.0.0" },
- { name = "mthds", specifier = "==0.19.0" },
+ { name = "mthds", specifier = "==0.20.0" },
{ name = "mypy", marker = "extra == 'dev'", specifier = "==1.19.1" },
{ name = "networkx", specifier = ">=3.4.2" },
{ name = "openai", specifier = ">=2.0.0" },
@@ -3717,7 +3717,7 @@ requires-dist = [
{ name = "opentelemetry-sdk", specifier = ">=1.39.0" },
{ name = "opentelemetry-semantic-conventions", specifier = ">=0.59b0" },
{ name = "pillow", specifier = ">=12.1.1" },
- { name = "pipelex-sdk", specifier = "==0.31.0" },
+ { name = "pipelex-sdk", specifier = "==0.37.0" },
{ name = "pipelex-tools", marker = "extra == 'dev'", specifier = ">=0.7.2" },
{ name = "pipelex-tools-py", specifier = ">=0.1.3" },
{ name = "polyfactory", specifier = ">=2.21.0" },
@@ -3829,7 +3829,7 @@ provides-extras = ["dev"]
[[package]]
name = "pipelex-sdk"
-version = "0.31.0"
+version = "0.37.0"
source = { registry = "https://pypi.org/simple" }
dependencies = [
{ name = "httpx" },
@@ -3837,9 +3837,9 @@ dependencies = [
{ name = "pydantic" },
{ name = "typing-extensions" },
]
-sdist = { url = "https://files.pythonhosted.org/packages/95/36/c2e3d1e4783cc8371cf0ca76357198992100f57d6ff96434dcd28bfd35e4/pipelex_sdk-0.31.0.tar.gz", hash = "sha256:caca6d52b07a4672eb0f75a97f919c864df63a88eaae4ed739c151d95edd5587", size = 368507, upload-time = "2026-10-05T00:18:32.979Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/ed/82/1795a4fc8828b68eff9bedbe8ebc490ee264f5b1363f24fd5b85d6ce2f94/pipelex_sdk-0.37.0.tar.gz", hash = "sha256:92415c4c9cb1aa3280be1f4fed0afe2ed631353452ec7d44fbd4109bdfe1fe5e", size = 533442, upload-time = "2026-10-09T17:53:39.353Z" }
wheels = [
- { url = "https://files.pythonhosted.org/packages/a3/4a/45d96ab1643d1f8c8d7a40dea0e5754fc10915ba2738a3cc4a0d826071a9/pipelex_sdk-0.31.0-py3-none-any.whl", hash = "sha256:d48f24364a9d1123466640a86ce3a7e2800f45a9fa553ae316d7f152ef1b9ad0", size = 138964, upload-time = "2026-10-05T00:18:31.291Z" },
+ { url = "https://files.pythonhosted.org/packages/4b/c6/6a919f8a05719e07119638f4b3762429356b0ac1d1ecfb1a8ef9966b990d/pipelex_sdk-0.37.0-py3-none-any.whl", hash = "sha256:164d2e5633366b84b18ddd4e053b490e7d595d67ebf17f32c7a7f5367acbb8b8", size = 213971, upload-time = "2026-10-09T17:53:37.271Z" },
]
[[package]]