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.jsonindex 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.tomlindex 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_durationsindex 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.mdindex 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.yamlindex 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.mdindex 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.mdindex 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.pyindex 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 ApiResponseErrorfrom pydantic import ValidationErrorfrom 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_verdictfrom pipelex.pipe_run.located_failure import find_root_faultfrom pipelex.pipeline.exceptions import PipelineExecutionError, ValidateBundleErrorfrom 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 therunner'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 oneexception is ``retryable`` on a 429 that did not say, a refusal sent before anything ran. A 503 is neverinferred 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_domainif error_category := _non_empty_string(value=problem.get("error_category")):payload["error_category"] = error_categoryif error.validation_errors:diff --git a/pipelex/hosted/error_rendering.py b/pipelex/hosted/error_rendering.pyindex 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) -> Hoerror_type = error.error_type or error_typemessage = 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.errordiff --git a/pipelex/hosted/exceptions.py b/pipelex/hosted/exceptions.pyindex 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 neverarrived. 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.RUNTIMEdiff --git a/pipelex/hosted/hosted_run.py b/pipelex/hosted/hosted_run.pyindex 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: HostedRunRequeA start the server refuses for a missing run store created no run, so running the blocking route next cannot runthe 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):raiseexcept (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 excdiff --git a/pyproject.toml b/pyproject.tomlindex 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.pyindex 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.pyindex 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.asyncioasync 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_errorwith pytest.raises(ApiUnreachableError) as exc_info:await run_hosted(client=client, request=HostedRunRequest(mthds_files=[BUNDLE_FILE]))+ assert exc_info.value is sdk_errorassert exc_info.value.api_url == "https://hosted.test"assert exc_info.value.code == expected_codeassert 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_errorwith 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_errorassert type(transport_error).__name__ in error.messageassert error.user_action is not Noneassert "run history" in error.user_action.detaildiff --git a/uv.lock b/uv.lockindex 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]]