@pipelex/sdk 0.16.0 → 0.18.0

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,46 +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;
     }
-    return callerValue; // scalar (text/number/…) or shape mismatch — pass through
 }
 /**
- * Read the request's closure `files`, guarding the untyped-caller shapes the
- * type system already forbids: a missing closure (`files` is required), and the
- * retired by-id form (`method_id` was a client-side expansion leg, deleted when
- * the tooling routes gained native by-id — expand a stored method with
- * `getMethodClosure` instead).
+ * 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 resolveClosureFiles(request) {
-    if (request["method_id"] !== undefined) {
-        throw new InputPreparationError("Cannot prepare inputs: `method_id` is not a prepareInputs field. Expand the stored method " +
-            "first — prepareInputs({ files: await client.getMethodClosure(methodId), … }).");
+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 (request.files == null) {
-        throw new InputPreparationError("Cannot prepare inputs: supply `files` (the inline MTHDS closure). A stored method's closure " +
-            "comes from client.getMethodClosure(methodId).");
+    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 request.files;
+    if (files !== undefined)
+        return { files };
+    if (methodRef !== undefined)
+        return { method_ref: methodRef };
+    return { method_id: methodId };
+}
+/**
+ * Ask `validate` for the signature, whatever the selector, and hand back the
+ * valid report.
+ *
+ * `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.
+ */
+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"]);
+    }
+    else {
+        result = await client.validate(selector, true, undefined, undefined, ["input_form"]);
+    }
+    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;
+}
+/**
+ * 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.
+ */
+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;
+    }
+    // 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
@@ -180,45 +318,44 @@ function resolveClosureFiles(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 = resolveClosureFiles(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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAQpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AACpD,MAAM,WAAW,GAAG,eAAe,CAAC;AAgEpC,2FAA2F;AAC3F,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAAC;AACrE,CAAC;AAED,+EAA+E;AAC/E,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAa;IAClC,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,CAAC;AACvE,CAAC;AAED,0DAA0D;AAC1D,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,qBAAqB,CAC7B,4CAA4C,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CACpE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,gBAAgB;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,0BAA0B,CAAC;IACvE,gFAAgF;IAChF,kFAAkF;IAClF,iFAAiF;IACjF,IAAI,CAAC;QACH,IAAI,QAAQ,EAAE,CAAC;YACb,0EAA0E;YAC1E,8EAA8E;YAC9E,mFAAmF;YACnF,gFAAgF;YAChF,6DAA6D;YAC7D,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;QACxD,CAAC;QACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IAChE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAC7B,+BAA+B,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,0BAA0B,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EACpH,EAAE,KAAK,EAAE,CACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC;QAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/F,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mGAAmG;AACnG,SAAS,aAAa,CAAC,GAAmB,EAAE,MAAe;IACzD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7C,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,GAAmB,EAAE,MAAe;IACjE,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,MAAM,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,mBAAmB;QACjF,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,CAAC,+BAA+B;QAC5E,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YACpE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO,MAAM,CAAC,GAAG,CAAC;QACpB,CAAC;QACD,iFAAiF;QACjF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC,GAAG,CAAC;IACpB,CAAC;IACD,IAAI,MAAM,YAAY,IAAI,IAAI,MAAM,YAAY,WAAW,IAAI,MAAM,YAAY,UAAU,EAAE,CAAC;QAC5F,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC,GAAG,CAAC;IACpB,CAAC;IACD,kFAAkF;IAClF,oFAAoF;IACpF,gEAAgE;IAChE,MAAM,IAAI,qBAAqB,CAC7B,uGAAuG;QACrG,kFAAkF,OAAO,MAAM,GAAG,CACrG,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,KAAK,UAAU,mBAAmB,CAAC,GAAmB,EAAE,WAAoB;IAC1E,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3D,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACvD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,KAAK,UAAU,WAAW,CACxB,GAAmB,EACnB,IAAmB,EACnB,WAAoB;IAEpB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,mBAAmB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC/C,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC;gBAAE,OAAO,WAAW,CAAC;YACpD,MAAM,MAAM,GAA4B,EAAE,GAAG,WAAW,EAAE,CAAC;YAC3D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBAAE,OAAO,WAAW,CAAC;YACpD,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACzF,CAAC;QACD;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AAKD;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,OAA6B;IACpD,MAAM,GAAG,GAAG,OAA6C,CAAC;IAC1D,MAAM,KAAK,GACT,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;QACpD,CAAC,CAAE,GAAG,CAAC,OAAO,CAAqB;QACnC,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IAElD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACxD,IAAI,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAEtD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,qBAAqB,CAC7B,4FAA4F;YAC1F,0FAA0F;YAC1F,cAAc,CACjB,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,qBAAqB,CAC7B,0BAA0B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,8CAA8C;YACzF,kDAAkD,CACrD,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IAC9D,OAAO,EAAE,SAAS,EAAE,QAAkB,EAAE,CAAC;AAC3C,CAAC;AAED;;;;;;;;;GASG;AACH,KAAK,UAAU,cAAc,CAC3B,MAA4B,EAC5B,QAA0B;IAE1B,IAAI,MAA+B,CAAC;IACpC,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,8EAA8E;QAC9E,mEAAmE;QACnE,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC9E,MAAM,OAAO,GAAG,YAAY;YAC1B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,iBAAiB,KAAK,GAAG,CAAC,QAAQ,CAAC;YACxF,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACrF,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;QACrE,MAAM,IAAI,qBAAqB,CAC7B,iEAAiE,KAAK,EAAE,CACzE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CACpB,MAA+B,EAC/B,SAAoB,EACpB,SAA6B;IAE7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,wCAAwC,CAAC;IAEhG,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,qBAAqB,CAC7B,6FAA6F;gBAC3F,IAAI,SAAS,2BAA2B,UAAU,GAAG,CACxD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,CAAC,SAAS,IAAI,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,qBAAqB,CAC7B,uDAAuD,SAAS,mBAAmB,UAAU,GAAG,CACjG,CAAC;QACJ,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,8EAA8E;IAC9E,4EAA4E;IAC5E,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,IAAI,SAAS;QAAE,OAAO,YAAY,CAAC;IAEjF,4EAA4E;IAC5E,qDAAqD;IACrD,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC3E,IAAI,gBAAgB,KAAK,SAAS,IAAI,gBAAgB,IAAI,SAAS;QAAE,OAAO,gBAAgB,CAAC;IAE7F,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,CAAW,CAAC;IAEhD,MAAM,IAAI,qBAAqB,CAC7B,kGAAkG;QAChG,gBAAgB,UAAU,GAAG,CAChC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,wBAAwB,CAAC,SAAkB;IAClD,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC5C,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC;AACpE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAA4B,EAC5B,OAA6B;IAE7B,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC;IACpC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,6EAA6E;QAC7E,gCAAgC;QAChC,MAAM,IAAI,qBAAqB,CAC7B,gGAAgG;YAC9F,4FAA4F;YAC5F,8CAA8C,CACjD,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnF,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAA4B,CAAC;IAEjE,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CACtD,CAAC;IAEF,MAAM,GAAG,GAAmB,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IACtE,MAAM,SAAS,GAA4B,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS,CAAC,2DAA2D;QACvE,CAAC;QACD,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,2EAA2E;YAC3E,mEAAmE;YACnE,0EAA0E;YAC1E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;YAClE,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;AACrD,CAAC"}

package/dist/runs.d.ts

@@ -1,4 +1,4 @@
-import type { DictPipeOutput } from "./models.js";
+import type { DictPipeOutput, DictWorkingMemory } from "./models.js";
 /**
  * Run-lifecycle types + polling for the hosted polling surface (`/v1/runs/*`).
  *
@@ -131,12 +131,43 @@ export interface RunResults {
      * output to an object) and may be a valid falsy value (empty array, `0`); it is never absent.
      */
     main_stuff: unknown;
-    /** Method graph spec (`graphspec.json`); null if missing mid-write or on the bare-runner path. */
+    /**
+     * The run's working memory — every named stuff of the run (`{ root, aliases }`), the inputs it
+     * was given and the intermediates it produced as well as the main output, each stuff carried as
+     * its concept ref and its content. It reads the same on both paths: the hosted path relays the
+     * `working_memory.json` artifact verbatim, and on the blocking path the SDK lifts it off
+     * `pipe_output`. `main_stuff` is the content of one of its entries, already resolved. Null on the
+     * hosted path when the artifact was not yet written. `DictWorkingMemory` mirrors the MTHDS
+     * standard's `DictWorkingMemory` field for field. A run delivered by a runtime older than
+     * pipelex 0.60.0 carries each `concept` as the concept object instead, and a stored artifact is
+     * relayed as written, never migrated: the type stays the standard's `string`, so read `concept`
+     * as `unknown` when a run may predate that release. See `docs/run-results.md`.
+     */
+    working_memory?: DictWorkingMemory | null;
+    /**
+     * The executed graph — the same document a local run writes as `graphspec.json`: `meta.mode`
+     * `"live"`, one node per pipe with its status, its timings and its own usage. It reaches the client on both
+     * paths: the hosted path relays the `graphspec.json` artifact verbatim, and on the blocking path
+     * the SDK lifts it off `pipe_output`. Null when the runner assembled no graph (see
+     * `graph_assembly_error`) or, on the hosted path, when the artifact was not yet written. Typed
+     * `unknown` on purpose — the canonical declaration is `GraphSpec` in `@pipelex/mthds-ui`, which
+     * carries a React peer dependency this server-side SDK does not take. See `docs/run-results.md`.
+     */
     graph_spec?: unknown;
     /**
-     * Bare runner's native pipe output — the full working memory (`{ root, aliases }`),
-     * blocking-execute path only; null on the hosted path. Supplementary to `main_stuff`,
-     * which is already resolved out of it; kept for consumers that need the whole working memory.
+     * Non-null when the runner's graph assembly failed for the run — the graph's twin of
+     * `usage_assembly_error`, and the only thing that separates "the graph broke" from "this run
+     * produced no graph". Lifted off `pipe_output` on the blocking path; the hosted results body
+     * carries nothing of the kind yet, so on that path the field is absent until the platform writes
+     * and relays it.
+     */
+    graph_assembly_error?: string | null;
+    /**
+     * Bare runner's native pipe output, blocking-execute path only; absent on the hosted path, whose
+     * results body carries no such key, so it reads `undefined` there. Supplementary: `main_stuff`,
+     * `working_memory`, the graph pair and the usage pair are all lifted out of it onto their own
+     * fields, which read the same on both paths. Read `working_memory` for the run's named stuffs;
+     * `pipe_output` is the runner's output as it arrived, extension fields included.
      */
     pipe_output?: DictPipeOutput | null;
     /**

package/dist/runs.js.map

@@ -1 +1 @@
-{"version":3,"file":"runs.js","sourceRoot":"","sources":["../src/runs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../src/runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAwC9D,MAAM,qBAAqB,GAA2B,IAAI,GAAG,CAAY;IACvE,WAAW;IACX,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,WAAW;CACZ,CAAC,CAAC;AAEH,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,OAAO,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,OAAO,MAAM,KAAK,WAAW,CAAC;AAChC,CAAC;AAiMD,uEAAuE;AAEvE,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC,CAAC,0DAA0D;AAQ5G;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAA0B,EAC1B,KAAa,EACb,UAAgC,EAAE;IAElC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,wBAAwB,CAAC;IAClE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,uBAAuB,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,SAAS,CAAC;QACR,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAE/B,8EAA8E;QAC9E,0EAA0E;QAC1E,qDAAqD;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACzC,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,eAAe,CACvB,OAAO,KAAK,0CAA0C,SAAS,KAAK,EACpE,KAAK,EACL,SAAS,CACV,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAEjE,IAAI,KAAK,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC,MAAM,CAAC;QACtB,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,IAAI,CAAC,CAAC;QACb,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAEzC,MAAM,OAAO,GAAG,KAAK,CAAC,mBAAmB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;QAC9E,MAAM,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAAoB;IAC1C,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,UAAU,CAAC,MAAoB;IACtC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IAC9B,IAAI,MAAM,YAAY,KAAK;QAAE,OAAO,MAAM,CAAC;IAC3C,OAAO,IAAI,YAAY,CAAC,2BAA2B,EAAE,YAAY,CAAC,CAAC;AACrE,CAAC;AAED,iFAAiF;AACjF,SAAS,KAAK,CAAC,EAAU,EAAE,MAAoB;IAC7C,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACZ,cAAc,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QACP,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC3B,OAAO;YACT,CAAC;YACD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/usage.d.ts

@@ -0,0 +1,87 @@
+import type { RunResults } from "./runs.js";
+/**
+ * `summarizeUsage` — one run-level reading of a run's usage pair.
+ *
+ * A completed run reports usage as `RunResults.tokens_usages` (one record per inference call)
+ * beside `RunResults.usage_assembly_error`, and the wire carries no run-level aggregate. This
+ * module folds the pair into a single summary under the rules `docs/run-usage.md` states, so
+ * every consumer reads the same totals instead of re-deriving them:
+ *
+ * - a `null` cost is unrated (the model has no rate table), a `0` cost is priced at zero;
+ * - `input` and `output` are the only additive token categories (`input_cached` is a subset of
+ *   `input`, and summing every category double-counts);
+ * - a null list means usage is unavailable, and only `usage_assembly_error` says it broke;
+ * - an empty list is a run that did no inference, which costs `0`, not `null`.
+ *
+ * Pure: no I/O, no client, and the input is never mutated.
+ */
+/**
+ * Which of the three readings of `tokens_usages` the summary describes:
+ * - `records` — a non-empty list: the totals are folded from it.
+ * - `no_inference` — `[]`: usage assembly ran and no inference happened, so the cost is `0`
+ *   and the token totals are zero.
+ * - `unavailable` — the list is null or absent: usage assembly was off, it broke (then
+ *   `assembly_error` is non-null), or on the hosted path the run was delivered before the
+ *   usage artifact existed. Nothing is known, so the cost and the token totals are `null`.
+ */
+export type UsageSummaryState = "records" | "no_inference" | "unavailable";
+/**
+ * The two additive token totals. Each is the sum of that category over the records that
+ * reported it, and `null` when no record reported it at all — which is different from a
+ * reported `0`.
+ */
+export interface UsageTokenTotals {
+    input: number | null;
+    output: number | null;
+}
+/** One pipe's share of a run's usage — the same fold as the run level, over its calls only. */
+export interface PipeUsageSummary {
+    /** The pipe that made the calls; `null` groups the calls the runtime did not attribute. */
+    pipe_code: string | null;
+    /** Sum of the priced calls' costs in USD; `null` when none of this pipe's calls was priced. */
+    total_cost_usd: number | null;
+    /** True when this pipe mixes priced and unrated calls, so `total_cost_usd` is a lower bound. */
+    cost_partial: boolean;
+    tokens: UsageTokenTotals;
+    /** Number of inference calls this pipe made. */
+    calls: number;
+}
+/** A run's usage pair folded into one null-aware reading. */
+export interface UsageSummary {
+    state: UsageSummaryState;
+    /**
+     * Sum of the priced calls' costs in USD. `0` for `no_inference`. `null` for `records` when no
+     * call was priced (unrated), and for `unavailable`, where nothing is known — read `state`
+     * first to tell the two apart.
+     */
+    total_cost_usd: number | null;
+    /**
+     * True when priced and unrated calls are mixed, so `total_cost_usd` covers the priced calls
+     * only and is a lower bound. Never true outside `records`.
+     */
+    cost_partial: boolean;
+    tokens: UsageTokenTotals;
+    /** Number of usage records summarized — one per inference call; `0` outside `records`. */
+    calls: number;
+    /**
+     * `usage_assembly_error` as relayed: non-null when the runner's usage assembly failed, which
+     * is the only thing that separates a broken assembly from an `unavailable` one that was off.
+     */
+    assembly_error: string | null;
+    /**
+     * Per-pipe rollup, most expensive first: priced pipes by cost descending, then unrated pipes,
+     * with ties broken by call count (descending) and then by pipe code. Empty outside `records`.
+     */
+    by_pipe: PipeUsageSummary[];
+}
+/** The part of `RunResults` the summary reads — a whole `RunResults` is accepted as is. */
+export type RunUsagePair = Pick<RunResults, "tokens_usages" | "usage_assembly_error">;
+/**
+ * Fold a run's usage pair into one summary: run totals, the call count, the assembly error and
+ * a per-pipe rollup. See `docs/run-usage.md` for the rules it applies.
+ *
+ * Pre-contract records, relayed verbatim from artifacts written before the usage contract,
+ * carry no `cost` and no `pipe_code`: they count as unrated and unattributed. The legacy
+ * `job_metadata` / `unit_costs` fields are relics and are never read.
+ */
+export declare function summarizeUsage(results: RunUsagePair): UsageSummary;