@pipelex/sdk 0.15.0 → 0.17.0

package/dist/prepare-inputs.d.ts

@@ -1,50 +1,71 @@
 /**
  * `prepareInputs` — signature-driven input preparation. Resolves the target
- * pipe's declared inputs via the explicit inputs template, interprets the
- * caller's inputs top-down against it, uploads the file-bearing values, and
- * returns rewritten inputs (canonical content carrying `pipelex-storage://` in
- * `url`) plus one upload record per prepared asset.
+ * pipe's declared inputs from the **input-form descriptor** on the validate
+ * report, interprets the caller's inputs top-down against it, uploads the
+ * file-bearing values, and returns rewritten inputs (canonical content carrying
+ * `pipelex-storage://` in `url`) plus one upload record per prepared asset.
+ *
+ * The method is named the same three ways every other method-taking operation
+ * takes it — inline `files`, a `method_ref` address, or a stored `method_id` —
+ * exactly one per call. All three are pass-throughs to `POST /v1/validate`,
+ * which resolves an address on the runner and an id on the platform, so nothing
+ * is expanded client-side.
  *
  * Per input, the caller may submit EITHER the **compact** value (a bare source /
- * canonical `{url}` content) OR the explicit `{ concept, content }` envelope that
- * `buildInputs({ explicit: true })` hands back — its `content` is interpreted
- * exactly as the compact value would be, and the envelope is preserved on output
- * (the `concept` annotation rides through; the runtime accepts it — see
- * `pipelex`'s `input_shaper.py` `_is_explicit` / `input_normalizer.py`).
+ * canonical `{url}` content) OR the explicit `{ concept, content }` envelope —
+ * its `content` is interpreted exactly as the compact value would be, and the
+ * envelope is preserved on output (the `concept` annotation rides through; the
+ * runtime accepts it — see `pipelex`'s `input_shaper.py` `_is_explicit` /
+ * `input_normalizer.py`).
  *
- * The classification mirrors the runtime: `pipelex`'s `input_normalizer` walks
- * Image/Document contents (recognized by their `url`-bearing shape, incl. nested
- * in structured content) and `resolve_uri` decides upload vs pass-through. The
- * declared signature comes from the explicit template (`buildInputs`,
- * `explicit: true`), whose canonical content shape is the classifier — the file
- * signal is a value that is a dict containing a `url` key. See the shared
- * behavior matrix (`wip/upload/behavior-matrix.md`) and `docs/input-preparation.md`.
+ * **The descriptor is the classifier, never the value's shape.** `input_form`
+ * (the MTHDS standard's artifact, opted into with `views: ["input_form"]`)
+ * states the kind at every depth — `document` / `image` mark a file position,
+ * `object` recurses through `fields`, `list` through `item`, everything else
+ * passes through. That is what makes an OPTIONAL nested file field prepare like
+ * a required one, and a `text` field merely *named* `url` stay untouched: both
+ * were misread while the signature came from the rendered inputs template, whose
+ * file signal was a `url`-bearing dict. See `docs/input-preparation.md` and the
+ * shared behavior matrix (`wip/upload/behavior-matrix.md`).
  */
-import type { BuildInputsResponse, MthdsFileItem } from "./models.js";
+import type { MthdsFileItem, PipelexValidationResult, ValidateMethodSelector } from "./models.js";
 import type { UploadCapableClient, UploadRecord } from "./upload.js";
-/** The pipe selector + caller inputs shared by both closure-source shapes. */
-interface PrepareInputsBase {
-    /** The pipe to prepare inputs for, as a qualified `domain.pipe_code`; omit to default to the closure's `main_pipe`. */
+/** The shared half of the request: the target pipe and the caller's inputs. */
+export interface PrepareInputsBase {
+    /**
+     * The pipe to prepare inputs for, as a QUALIFIED `domain.pipe_code` ref. Omit
+     * it to default — see "Pipe selection" in `docs/input-preparation.md`. A bare
+     * `pipe_code` is refused: the descriptor is keyed by qualified refs, and search
+     * is a run-route affordance this helper deliberately does not grow. So is an
+     * `alias->domain.pipe_code` ref: the alias names a dependency package's pipe,
+     * which the descriptor does not describe (it covers the method's own pipes).
+     */
     pipe_ref?: string;
-    /** The caller's compact inputs (variable name → value). */
+    /** The caller's inputs (variable name → value), compact or explicit-envelope per input. */
     inputs: Record<string, unknown>;
 }
 /**
- * What `prepareInputs` takes: the method closure, the target pipe, and the
- * caller's compact inputs. Supply the closure EITHER as inline `files` OR as a
- * stored `method_id` — never both. `method_id` is a client-side convenience:
- * it is resolved to `files` via `getMethodClosure` before anything hits the
- * wire (it never travels as a wire field), and requires an API key.
+ * How the method is named — exactly one of the three selectors, each pinning the
+ * other two to `never` so a second one is a compile error (the same XOR
+ * `ValidateMethodSelector` states for the tooling routes). All three reach the
+ * server as-is: `files` inline, `method_ref` resolved by the runner, `method_id`
+ * resolved by the platform.
  */
-export type PrepareInputsRequest = (PrepareInputsBase & {
-    /** The method closure — inline MTHDS files. This is the signature source. */
+export type PrepareInputsClosure = {
     files: MthdsFileItem[];
+    method_ref?: never;
+    method_id?: never;
+} | {
+    method_ref: string;
+    files?: never;
     method_id?: never;
-}) | (PrepareInputsBase & {
-    /** A stored method's id — resolved client-side to its closure before the build call. */
+} | {
     method_id: string;
     files?: never;
-});
+    method_ref?: never;
+};
+/** What `prepareInputs` takes: one method selector, the target pipe, the caller's inputs. */
+export type PrepareInputsRequest = PrepareInputsBase & PrepareInputsClosure;
 /** The result of `prepareInputs`: rewritten inputs (copy-on-write) plus upload records. */
 export interface PreparedInputs {
     /** A copy of `inputs` with each file-bearing value rewritten to canonical content carrying `pipelex-storage://` in `url`. */
@@ -53,44 +74,28 @@ export interface PreparedInputs {
     uploads: UploadRecord[];
 }
 /**
- * The client surface `prepareInputs` needs: raw `upload`, the `buildInputs`
- * signature source, and `getMethodClosure` to resolve a by-id request's closure.
+ * The client surface `prepareInputs` needs: raw `upload`, and `validate` as the
+ * signature source. Typed as the client's own `validate` signature so
+ * `PipelexApiClient` satisfies it structurally.
  */
 export interface PrepareCapableClient extends UploadCapableClient {
-    buildInputs(request: {
-        files: MthdsFileItem[];
-        pipe_ref?: string;
-        format?: "json";
-        explicit?: boolean;
-    }): Promise<BuildInputsResponse>;
-    /** Resolve a stored method's id into its runnable closure — the by-id signature source. */
-    getMethodClosure(methodId: string): Promise<MthdsFileItem[]>;
+    validate(source: string[] | ValidateMethodSelector, allowSignatures?: boolean, mthdsSources?: string[], render?: string[], views?: string[], options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<PipelexValidationResult>;
 }
-/**
- * Resolve a `files` / `method_id` closure pair to inline files: reject an
- * over-specified `{ files, method_id }` (both given) before any resolution
- * runs, then either return the inline `files` unchanged or fetch-and-parse the
- * stored method behind `method_id` via `getMethodClosure`. Returns `undefined`
- * when NEITHER is given — the caller decides what that means for its own
- * request shape, since `buildInputs` (client.ts) also accepts a third source,
- * the reserved `method_ref`, that `prepareInputs` does not.
- *
- * Shared between `PipelexApiClient.buildInputs` and `resolveClosureFiles`
- * (below) so the files/method_id invariant is defined in exactly one place —
- * a duplicated copy of this exact check is what let a `buildInputs`-only
- * revision briefly reject a legitimate `method_ref`-only request.
- */
-export declare function resolveFilesOrMethodId(files: MthdsFileItem[] | undefined, methodId: string | undefined, getMethodClosure: (methodId: string) => Promise<MthdsFileItem[]>, makeError: (message: string) => Error): Promise<MthdsFileItem[] | undefined>;
 /**
  * Prepare a pipe's inputs: upload local/byte/data-URL assets at the signature's
  * file-bearing positions and return copy-on-write rewritten inputs plus upload
  * records. HTTP(S) URLs and existing `pipelex-storage://` URIs pass through
  * unchanged. All failures are raised before any run is created.
  *
- * The declared signature is resolved from the closure; a closure that does not
- * resolve throws {@link InputPreparationError}. No-verdict conditions from the
- * signature route (unknown `pipe_ref`, auth, server fault) surface as the build
- * route's `ApiResponseError`.
+ * The signature comes from one `POST /v1/validate` with `views: ["input_form"]`,
+ * whatever the selector — inline `files`, a `method_ref` the runner resolves, or
+ * a `method_id` the platform resolves. A closure that does not load, an unknown
+ * `pipe_ref`, no default pipe, or a report with no descriptor throw
+ * {@link InputPreparationError}; a no-verdict condition from the route (a
+ * malformed selector, an unknown or foreign-org id, no package at the address,
+ * auth, a server fault) surfaces as `ApiResponseError`, unchanged.
  */
 export declare function prepareInputs(client: PrepareCapableClient, request: PrepareInputsRequest): Promise<PreparedInputs>;
-export {};

package/dist/prepare-inputs.js

@@ -1,24 +1,32 @@
 /**
  * `prepareInputs` — signature-driven input preparation. Resolves the target
- * pipe's declared inputs via the explicit inputs template, interprets the
- * caller's inputs top-down against it, uploads the file-bearing values, and
- * returns rewritten inputs (canonical content carrying `pipelex-storage://` in
- * `url`) plus one upload record per prepared asset.
+ * pipe's declared inputs from the **input-form descriptor** on the validate
+ * report, interprets the caller's inputs top-down against it, uploads the
+ * file-bearing values, and returns rewritten inputs (canonical content carrying
+ * `pipelex-storage://` in `url`) plus one upload record per prepared asset.
+ *
+ * The method is named the same three ways every other method-taking operation
+ * takes it — inline `files`, a `method_ref` address, or a stored `method_id` —
+ * exactly one per call. All three are pass-throughs to `POST /v1/validate`,
+ * which resolves an address on the runner and an id on the platform, so nothing
+ * is expanded client-side.
  *
  * Per input, the caller may submit EITHER the **compact** value (a bare source /
- * canonical `{url}` content) OR the explicit `{ concept, content }` envelope that
- * `buildInputs({ explicit: true })` hands back — its `content` is interpreted
- * exactly as the compact value would be, and the envelope is preserved on output
- * (the `concept` annotation rides through; the runtime accepts it — see
- * `pipelex`'s `input_shaper.py` `_is_explicit` / `input_normalizer.py`).
+ * canonical `{url}` content) OR the explicit `{ concept, content }` envelope —
+ * its `content` is interpreted exactly as the compact value would be, and the
+ * envelope is preserved on output (the `concept` annotation rides through; the
+ * runtime accepts it — see `pipelex`'s `input_shaper.py` `_is_explicit` /
+ * `input_normalizer.py`).
  *
- * The classification mirrors the runtime: `pipelex`'s `input_normalizer` walks
- * Image/Document contents (recognized by their `url`-bearing shape, incl. nested
- * in structured content) and `resolve_uri` decides upload vs pass-through. The
- * declared signature comes from the explicit template (`buildInputs`,
- * `explicit: true`), whose canonical content shape is the classifier — the file
- * signal is a value that is a dict containing a `url` key. See the shared
- * behavior matrix (`wip/upload/behavior-matrix.md`) and `docs/input-preparation.md`.
+ * **The descriptor is the classifier, never the value's shape.** `input_form`
+ * (the MTHDS standard's artifact, opted into with `views: ["input_form"]`)
+ * states the kind at every depth — `document` / `image` mark a file position,
+ * `object` recurses through `fields`, `list` through `item`, everything else
+ * passes through. That is what makes an OPTIONAL nested file field prepare like
+ * a required one, and a `text` field merely *named* `url` stay untouched: both
+ * were misread while the signature came from the rendered inputs template, whose
+ * file signal was a `url`-bearing dict. See `docs/input-preparation.md` and the
+ * shared behavior matrix (`wip/upload/behavior-matrix.md`).
  */
 import { InputPreparationError } from "./errors.js";
 import { uploadFile } from "./upload.js";
@@ -28,16 +36,26 @@ const HTTP_URL_RE = /^https?:\/\//i;
 function isPlainObject(value) {
     return Object.prototype.toString.call(value) === "[object Object]";
 }
-/** A canonical Image/Document content is a plain object carrying a `url` key. */
+/** A trimmed non-empty string, or `undefined` — the "empty is absent" rule. */
+function nonEmptyString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/**
+ * A canonical Image/Document content is a plain object carrying a `url` key.
+ * A VALUE-shape helper only: it is consulted at a position the descriptor has
+ * already declared a file, never as the signal that one is there.
+ */
 function isFileContent(node) {
     return isPlainObject(node) && "url" in node;
 }
 /**
- * The explicit-template envelope: a plain object whose keys are EXACTLY `concept`
- * and `content` — the shape `buildInputs({ explicit: true })` returns per input.
- * Matches the runtime's `_is_explicit` (`pipelex`'s `input_shaper.py`): exact
- * keys, not a superset, so a structured-content input that merely happens to carry
- * both fields is not misread as an envelope.
+ * The explicit envelope: a plain object whose keys are EXACTLY `concept` and
+ * `content`. Matches the runtime's `_is_explicit` (`pipelex`'s
+ * `input_shaper.py`): exact keys, not a superset, so a structured-content input
+ * that merely happens to carry both fields is not misread as an envelope.
  */
 function isExplicitEnvelope(value) {
     if (!isPlainObject(value))
@@ -133,66 +151,166 @@ async function resolveFilePosition(ctx, callerValue) {
     const resolved = await resolveSource(ctx, callerValue);
     return { url: resolved };
 }
-/** Template-guided walk: a template node that is canonical file content marks a file position. */
-async function resolveNode(ctx, templateNode, callerValue) {
-    if (isFileContent(templateNode)) {
-        return resolveFilePosition(ctx, callerValue);
-    }
-    if (Array.isArray(templateNode) && templateNode.length > 0) {
-        const elementTemplate = templateNode[0];
-        if (Array.isArray(callerValue)) {
-            return Promise.all(callerValue.map((item) => resolveNode(ctx, elementTemplate, item)));
-        }
-        return callerValue; // shape mismatch — leave it for the run to reject
-    }
-    if (isPlainObject(templateNode) && isPlainObject(callerValue)) {
-        const result = { ...callerValue };
-        for (const key of Object.keys(templateNode)) {
-            if (key in callerValue) {
-                result[key] = await resolveNode(ctx, templateNode[key], callerValue[key]);
+/**
+ * Descriptor-guided walk, discriminated on the node's `kind`:
+ *
+ * - `document` / `image` — a file position, whatever the value's shape;
+ * - `object` — walk the declared `fields` by name; keys the descriptor does not
+ *   name are copied through untouched;
+ * - `list` — walk `item` against each element;
+ * - every other kind (`text`, `prose`, `date`, `number`, `boolean`, `enum`,
+ *   `unknown`) — pass through at any depth. `unknown` is the standard's escape
+ *   hatch for a `Dynamic` / `Composite` input, and it is NOT interpreted: the
+ *   signature declares no file there, and uploading by value shape is the defect
+ *   this walk removes. A caller with such an input uploads with `uploadFile`
+ *   first and passes the storage URI.
+ *
+ * A caller value whose shape disagrees with the node (a scalar at an `object`, a
+ * non-array at a `list`) passes through for the run to reject — preparation never
+ * second-guesses the signature.
+ */
+async function resolveNode(ctx, node, callerValue) {
+    switch (node.kind) {
+        case "document":
+        case "image":
+            return resolveFilePosition(ctx, callerValue);
+        case "object": {
+            if (!isPlainObject(callerValue))
+                return callerValue;
+            const result = { ...callerValue };
+            for (const field of node.fields) {
+                if (Object.hasOwn(callerValue, field.name)) {
+                    result[field.name] = await resolveNode(ctx, field, callerValue[field.name]);
+                }
             }
+            return result;
+        }
+        case "list": {
+            if (!Array.isArray(callerValue))
+                return callerValue;
+            return Promise.all(callerValue.map((element) => resolveNode(ctx, node.item, element)));
         }
-        return result;
+        default:
+            return callerValue;
+    }
+}
+/**
+ * Normalize and check the three selectors. Empty is absent (`files: []`,
+ * `method_ref: ""`, `method_id: "  "`), mirroring the run options' rule and the
+ * Python `CrateRequestBase` normalisers, and exactly one must remain — the check
+ * lives here because this helper is the one that composes the `validate` call.
+ * The illegal shapes are compile errors for typed callers; this backs them up for
+ * untyped (JS) ones with a typed `InputPreparationError`.
+ */
+function resolveSelector(request) {
+    const raw = request;
+    const files = Array.isArray(raw["files"]) && raw["files"].length > 0
+        ? raw["files"]
+        : undefined;
+    const methodRef = nonEmptyString(raw["method_ref"]);
+    const methodId = nonEmptyString(raw["method_id"]);
+    const given = [];
+    if (files !== undefined)
+        given.push("`files`");
+    if (methodRef !== undefined)
+        given.push("`method_ref`");
+    if (methodId !== undefined)
+        given.push("`method_id`");
+    if (given.length === 0) {
+        throw new InputPreparationError("Cannot prepare inputs: no method selector. Supply exactly one of `files` (an inline MTHDS " +
+            "closure), `method_ref` (a published method's address) or `method_id` (a stored method's " +
+            "catalog id).");
+    }
+    if (given.length > 1) {
+        throw new InputPreparationError(`Cannot prepare inputs: ${given.join(" and ")} were both given. Supply exactly one method ` +
+            "selector — `files`, `method_ref` or `method_id`.");
     }
-    return callerValue; // scalar (text/number/…) or shape mismatch — pass through
+    if (files !== undefined)
+        return { files };
+    if (methodRef !== undefined)
+        return { method_ref: methodRef };
+    return { method_id: methodId };
 }
 /**
- * Resolve a `files` / `method_id` closure pair to inline files: reject an
- * over-specified `{ files, method_id }` (both given) before any resolution
- * runs, then either return the inline `files` unchanged or fetch-and-parse the
- * stored method behind `method_id` via `getMethodClosure`. Returns `undefined`
- * when NEITHER is given — the caller decides what that means for its own
- * request shape, since `buildInputs` (client.ts) also accepts a third source,
- * the reserved `method_ref`, that `prepareInputs` does not.
+ * Ask `validate` for the signature, whatever the selector, and hand back the
+ * valid report.
  *
- * Shared between `PipelexApiClient.buildInputs` and `resolveClosureFiles`
- * (below) so the files/method_id invariant is defined in exactly one place —
- * a duplicated copy of this exact check is what let a `buildInputs`-only
- * revision briefly reject a legitimate `method_ref`-only request.
+ * `allowSignatures: true` on purpose: preparation needs a pipe's DECLARED inputs,
+ * and a bundle mid-authoring with an unresolved signature elsewhere must not be
+ * refused inputs for a pipe whose inputs are declared. Whether the bundle runs is
+ * the run's verdict, not preparation's. The `is_valid: false` arm still means the
+ * closure does not load, which is a preparation failure.
  */
-export async function resolveFilesOrMethodId(files, methodId, getMethodClosure, makeError) {
-    if (methodId !== undefined && files !== undefined) {
-        throw makeError("supply the closure as either `files` or `method_id`, never both.");
+async function fetchSignature(client, selector) {
+    let result;
+    if ("files" in selector) {
+        const contents = selector.files.map((file) => file.content);
+        // `validateFiles`' rule: label every content once any file names a source, so
+        // the server never sees a length-mismatched `mthds_sources` array.
+        const hasAnySource = selector.files.some((file) => file.source !== undefined);
+        const sources = hasAnySource
+            ? selector.files.map((file, index) => file.source ?? `inline://file-${index + 1}.mthds`)
+            : undefined;
+        result = await client.validate(contents, true, sources, undefined, ["input_form"]);
     }
-    if (methodId !== undefined) {
-        return getMethodClosure(methodId);
+    else {
+        result = await client.validate(selector, true, undefined, undefined, ["input_form"]);
     }
-    return files;
+    if (!result.is_valid) {
+        const first = result.validation_errors[0]?.message ?? result.message;
+        throw new InputPreparationError(`Cannot prepare inputs: the method signature did not resolve — ${first}`);
+    }
+    return result;
 }
 /**
- * Resolve the request's closure to inline `files`: fetch and parse a stored
- * method when `method_id` is given, else use the inline `files`. The either/or
- * is a type invariant (the discriminated union); {@link resolveFilesOrMethodId}
- * backs the over-specified "both given" case at runtime for non-typed callers,
- * and the "neither given" case is rejected here (prepareInputs has no third
- * closure source, unlike `buildInputs`).
+ * Pick the pipe whose descriptor guides the walk, in the order `docs/input-preparation.md`
+ * documents: an explicit qualified `pipe_ref`, then the report's typed resolved
+ * default, then the bundle's declared `main_pipe`, then the single pipe — else an
+ * error naming the candidates.
  */
-async function resolveClosureFiles(client, request) {
-    const files = await resolveFilesOrMethodId(request.files, request.method_id, (methodId) => client.getMethodClosure(methodId), (message) => new InputPreparationError(`Cannot prepare inputs: ${message}`));
-    if (files === undefined) {
-        throw new InputPreparationError("Cannot prepare inputs: supply either `files` (an inline MTHDS closure) or `method_id` (a stored method).");
+function selectPipeRef(report, inputForm, requested) {
+    const refs = Object.keys(inputForm);
+    const candidates = refs.length > 0 ? refs.join(", ") : "(none — the closure declares no pipes)";
+    if (requested !== undefined) {
+        if (!requested.includes(".")) {
+            throw new InputPreparationError(`Cannot prepare inputs: \`pipe_ref\` must be qualified (\`domain.pipe_code\`), got the bare ` +
+                `"${requested}". The method declares: ${candidates}.`);
+        }
+        if (!(requested in inputForm)) {
+            throw new InputPreparationError(`Cannot prepare inputs: the method declares no pipe "${requested}". It declares: ${candidates}.`);
+        }
+        return requested;
     }
-    return files;
+    // The typed resolved default, when the runner serves it (manifest-aware for a
+    // `method_ref` package, which is why it outranks the blueprint read below).
+    const typedDefault = nonEmptyString(report.default_pipe_ref);
+    if (typedDefault !== undefined && typedDefault in inputForm)
+        return typedDefault;
+    // `bundle_blueprint` is opaque transport in this SDK on purpose, so read it
+    // defensively and fall through rather than trust it.
+    const blueprintDefault = readBlueprintMainPipeRef(report.bundle_blueprint);
+    if (blueprintDefault !== undefined && blueprintDefault in inputForm)
+        return blueprintDefault;
+    if (refs.length === 1)
+        return refs[0];
+    throw new InputPreparationError(`Cannot prepare inputs: the method declares no single default pipe, so \`pipe_ref\` is required. ` +
+        `It declares: ${candidates}.`);
+}
+/**
+ * The bundle blueprint's declared `main_pipe`, qualified by its `domain` when it
+ * is authored bare. Every read is defensive: the blueprint is typed
+ * `Record<string, unknown>` because its schema is the runtime's, not this SDK's.
+ */
+function readBlueprintMainPipeRef(blueprint) {
+    if (!isPlainObject(blueprint))
+        return undefined;
+    const mainPipe = nonEmptyString(blueprint["main_pipe"]);
+    if (mainPipe === undefined)
+        return undefined;
+    if (mainPipe.includes("."))
+        return mainPipe;
+    const domain = nonEmptyString(blueprint["domain"]);
+    return domain === undefined ? undefined : `${domain}.${mainPipe}`;
 }
 /**
  * Prepare a pipe's inputs: upload local/byte/data-URL assets at the signature's
@@ -200,45 +318,44 @@ async function resolveClosureFiles(client, request) {
  * records. HTTP(S) URLs and existing `pipelex-storage://` URIs pass through
  * unchanged. All failures are raised before any run is created.
  *
- * The declared signature is resolved from the closure; a closure that does not
- * resolve throws {@link InputPreparationError}. No-verdict conditions from the
- * signature route (unknown `pipe_ref`, auth, server fault) surface as the build
- * route's `ApiResponseError`.
+ * The signature comes from one `POST /v1/validate` with `views: ["input_form"]`,
+ * whatever the selector — inline `files`, a `method_ref` the runner resolves, or
+ * a `method_id` the platform resolves. A closure that does not load, an unknown
+ * `pipe_ref`, no default pipe, or a report with no descriptor throw
+ * {@link InputPreparationError}; a no-verdict condition from the route (a
+ * malformed selector, an unknown or foreign-org id, no package at the address,
+ * auth, a server fault) surfaces as `ApiResponseError`, unchanged.
  */
 export async function prepareInputs(client, request) {
-    const files = await resolveClosureFiles(client, request);
-    const report = await client.buildInputs({
-        files,
-        ...(request.pipe_ref === undefined ? {} : { pipe_ref: request.pipe_ref }),
-        format: "json",
-        explicit: true,
-    });
-    if (!report.is_valid) {
-        const first = report.validation_errors[0]?.message ?? report.message;
-        throw new InputPreparationError(`Cannot prepare inputs: the method signature did not resolve — ${first}`);
-    }
-    // We requested `format: "json"`, so the valid arm carries the envelope in `inputs`.
-    if (report.format !== "json") {
-        throw new InputPreparationError(`Cannot prepare inputs: expected a JSON inputs template, got "${report.format}".`);
+    const selector = resolveSelector(request);
+    const report = await fetchSignature(client, selector);
+    const inputForm = report.input_form;
+    if (inputForm === undefined) {
+        // Never a silent degrade to "no uploads": without the descriptor there is no
+        // signature to prepare against.
+        throw new InputPreparationError("Cannot prepare inputs: the validate report carries no `input_form` descriptor — the signature " +
+            'preparation reads. The descriptor rides `views: ["input_form"]` on pipelex-api >= 0.18.0; ' +
+            "point the client at a runner that serves it.");
     }
-    const template = report.inputs;
+    const pipeRef = selectPipeRef(report, inputForm, nonEmptyString(request.pipe_ref));
+    const descriptor = inputForm[pipeRef];
+    const declared = new Map(descriptor.fields.map((field) => [field.name, field]));
     const ctx = { client, uploads: [], dedup: new Map() };
     const rewritten = { ...request.inputs };
     for (const [name, callerValue] of Object.entries(request.inputs)) {
-        const entry = template[name];
-        if (!isPlainObject(entry) || !("content" in entry)) {
-            // Not a declared input (or an unexpected envelope) — pass through untouched.
-            continue;
+        const field = declared.get(name);
+        if (field === undefined) {
+            continue; // Not a declared input — pass through untouched, as today.
         }
         if (isExplicitEnvelope(callerValue)) {
-            // The caller filled the explicit `{ concept, content }` template: walk the
-            // inner content against the compact signature, then re-wrap so the concept
+            // The caller filled the explicit `{ concept, content }` envelope: walk the
+            // inner content against the same node, then re-wrap so the concept
             // annotation rides through to the run (the runtime accepts the envelope).
-            const walked = await resolveNode(ctx, entry.content, callerValue.content);
+            const walked = await resolveNode(ctx, field, callerValue.content);
             rewritten[name] = { ...callerValue, content: walked };
         }
         else {
-            rewritten[name] = await resolveNode(ctx, entry.content, callerValue);
+            rewritten[name] = await resolveNode(ctx, field, callerValue);
         }
     }
     return { inputs: rewritten, uploads: ctx.uploads };

package/dist/prepare-inputs.js.map

@@ -1 +1 @@
-{"version":3,"file":"prepare-inputs.js","sourceRoot":"","sources":["../src/prepare-inputs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prepare-inputs.js","sourceRoot":"","sources":["../src/prepare-inputs.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipelex/sdk",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "TypeScript SDK for the Pipelex hosted API — execute methods, manage runs, and call the product surface.",
   "license": "MIT",
   "repository": {
@@ -59,7 +59,7 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "mthds": "^0.24.0",
+    "mthds": "^0.25.0",
     "smol-toml": "^1.6.0"
   }
 }