Skip to content

feature/Starter-sdk-0140-typed · L-260927-23e105 - #4

Merged
lchoquel merged 2 commits into
devfrom
feature/Starter-sdk-0140-typed
Sep 27, 2026
Merged

lchoquel merged 2 commits into
devfrom
feature/Starter-sdk-0140-typed

Conversation

@lchoquel

@lchoquel lchoquel commented Sep 27, 2026 •

Copy link
Copy Markdown
Member

The starter moves onto pipelex-sdk 0.14.0 and mthds 0.17.0, where every route raises the typed ApiResponseError on a non-2xx answer, so the raw httpx.HTTPStatusError branch is gone and httpx leaves the runtime dependencies. A refused run now prints its reason, the pipe or concept each validation error names, the server's next step and the retry advice, in every mode, with the StartRequiresAsyncOrchestration hint moved onto the typed branch; make codegen and make add-method also stop reading a 404 the route answered as a missing route.

Closes L-260927-23e105

🤖 Generated with Claude Code

https://claude.ai/code/session_01Xcr1G5gkEa4Aeoo1a7ATyh


Summary by cubic

Moves the starter onto pipelex-sdk 0.14.0 and mthds 0.17.0, where every route raises the typed ApiResponseError on a non-2xx answer. The raw httpx.HTTPStatusError branch is gone from all three modes, and httpx leaves the runtime dependencies (it stays dev-only for the test transport fakes).

Refused requests now say why, where, and what to do

  • A method the API refuses to run prints the reason, the pipe or concept each validation error names, the server's next step, and the retry advice — the same shape a failed run's report uses, in every mode.
  • Multi-line reasons hang their continuation lines under the label.
  • 401/403 failures keep the API-key hint and also read out their reason; the StartRequiresAsyncOrchestration hint now rides on the typed error.

Codegen scripts stop misreading 404s

  • explain sends you to PIPELEX_BASE_URL only for a bare 404; a 404 carrying the runner's error class (e.g. a missing method_ref package) prints the server's reason instead.
  • Non-404 refusals now include the server's next step under the reason.

Closes L-260927-23e105.

Written for commit 89c05f6. Summary will update on new commits.

Review in cubic

lchoquel and others added 2 commits September 27, 2026 17:50
… error

pipelex-sdk 0.14.0 raises the typed ApiResponseError on every route, the
protocol ones included, so the raw httpx.HTTPStatusError branch is gone:
each mode's _run() catches PipelineRequestError alone, and httpx is no
longer a runtime dependency. A refused request is read out by
problem_lines the way a failed run's report is: the reason, the pipe or
concept each validation item names, the next step and the retry advice,
with a multi-line reason hanging under its label.

The codegen explain helper drops its httpx arm too, prints the server's
next step, and no longer reads a 404 carrying the runner's error class
as a missing route.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Xcr1G5gkEa4Aeoo1a7ATyh
… or start

The `_run()` docstrings, the architecture doc, the error module's docstring, the
changelog and the pyproject comment said or implied that every error the SDK raises
descends from `PipelineRequestError`. A connection that fails on `execute` or `start`
does not: pipelex-sdk 0.14.0 sends those routes through the base client's unwrapped
transport, so a mistyped PIPELEX_BASE_URL still crashes with httpx's own ConnectError,
as it did on 0.13.0. The sentences now say so; the fix belongs in the SDK.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Xcr1G5gkEa4Aeoo1a7ATyh
@lchoquel
lchoquel merged commit 11d24af into dev Sep 27, 2026
15 checks passed
@lchoquel
lchoquel deleted the feature/Starter-sdk-0140-typed branch September 27, 2026 16:11
@github-actions github-actions Bot locked and limited conversation to collaborators Sep 27, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant