feature/Pipe-io-client · L-260830-f5b65e

[lchoquel]

Adds pipe_io(), the typed wrapper for POST /v1/pipe-io, which returns a method's pipe I/O contracts, input form and output form with no dry run, with the selector XOR enforced at request construction as the rest of the crate family does. prepare_inputs now reads its signature from that route and lets the server select the pipe, so the client-side default chain and the bundle-blueprint read are deleted; a bare pipe_ref is still refused before any request, and a 422 whose error_type is the runner's entry-lookup error becomes an InputPreparationError carrying the server's reason. It must not merge or release before the hosted API serves the route, since a published prepare_inputs on /v1/pipe-io fails against any API that lacks it.

Closes L-260830-f5b65e
Closes L-260921-e61f30

🤖 Generated with Claude Code

https://claude.ai/code/session_01EWwzmAGtZvzvQqeC1SvzJ1

---

Summary by cubic

Adds pipe_io(), the typed wrapper for POST /v1/pipe-io, and moves prepare_inputs onto that route so the server selects the pipe.

• pipe_io() returns a method's pipe I/O contracts, input form and output form with no dry run, typed from mthds.protocol, with the selector XOR enforced at request construction.
• prepare_inputs drops the client-side default chain and the bundle-blueprint read; a bare pipe_ref and an alias→domain.pipe_code ref naming a dependency package's pipe are each refused before any request, and a 422 whose error_type is the runner's entry-lookup error becomes an InputPreparationError whose message is the server's detail alone.
• The artifacts e2e bundle now reads its declared document input (via an empty {% if doc %} block) because pipelex refuses a bundle whose template never reads a declared input.

Migration

• prepare_inputs needs a runner serving /v1/pipe-io (pipelex-api v0.33.1 or later) and raises ApiResponseError against one that does not. Do not merge or release before the hosted API serves the route.

^{Written for commit e5b69f0. Summary will update on new commits.}