@loomwork/ui-hydration 0.0.0-stage → 0.1.0

package/dist/esm/provider.js

@@ -0,0 +1,416 @@
+import { tainted } from "@loomwork/classify";
+import { TypedFailure } from "@loomwork/core";
+import { shapeOf } from "@loomwork/plugin-sandbox";
+import { checkKindValue, hasKindContract, stepKind, } from "@loomwork/ui-core";
+import { checkContentRefs, contentRefEnv, finishContentRefArgs, } from "./contentRefs";
+import { DEFAULT_DATA_PROVIDERS, } from "./dataProvider";
+import { pickParams, prepareArguments, providerParams, } from "./params";
+import { terminalSteps, topoWaves } from "./plan";
+import { outputShapeHashOf, reshape, safeStringify, } from "./reshape";
+async function mapLimit(items, limit, fn) {
+    const results = new Array(items.length);
+    let cursor = 0;
+    const worker = async () => {
+        for (;;) {
+            const i = cursor++;
+            if (i >= items.length)
+                return;
+            results[i] = await fn(items[i]);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, worker));
+    return results;
+}
+const err = (code, message) => ({ code, severity: "error", message });
+/** A step's invocation failed for a reason other than an input-schema drift. */
+function stepFailure(node, e, signal) {
+    if (e instanceof TypedFailure)
+        return err(`tool-${e.channel}`, `step "${node.stepId}" (${node.toolName}) failed on channel ${e.channel}: ${safeStringify(e.payload)}`);
+    if (signal?.aborted)
+        return err("aborted", `step "${node.stepId}" aborted`);
+    return err("tool-failed", `step "${node.stepId}" (${node.toolName}) failed: ${e instanceof Error ? e.message : String(e)}`);
+}
+/**
+ * The shapes an output-drift record carries. Neither value has necessarily been proved walkable
+ * (the raw output never went through `shapeHash`): one too deep or too wide simply leaves its
+ * field absent — a drift REPORT must never become a throw.
+ */
+function observedShapes(value, raw) {
+    const out = {};
+    try {
+        out.observedShape = shapeOf(value);
+    }
+    catch {
+        // unwalkable: leave absent
+    }
+    try {
+        out.observedRawShape = shapeOf(raw);
+    }
+    catch {
+        // unwalkable: leave absent
+    }
+    return out;
+}
+/** The raw output's shape alone — a failed reshaping has no reshaped value to walk. */
+function observedRawShape(raw) {
+    try {
+        return { observedRawShape: shapeOf(raw) };
+    }
+    catch {
+        return {};
+    }
+}
+/** The PUBLIC code of a step refused by the content-reference guard (literal, unproven ref, or a param the gate refused). */
+export const CONTENT_REF_REFUSED = "content-ref-refused";
+/**
+ * The step-level refusals a CLIENT can cause. An explicit set, not a `media-arg-` prefix: the family
+ * also holds `media-arg-schema-unknown` (a host/schema defect) and `media-arg-suspect` (a hint), neither
+ * of which is a refused argument.
+ */
+const CONTENT_REF_REFUSAL_CODES = new Set([
+    "media-arg-literal",
+    "media-arg-unproven-ref",
+    "media-arg-param-refused",
+]);
+const isContentRefRefusal = (f) => CONTENT_REF_REFUSAL_CODES.has(f.code);
+/**
+ * The first finding (graph order) when every step that failed ON ITS OWN failed with the same
+ * one of `schema-drift` / `upstream-empty` — the rest were skipped as its dependents
+ * (`dependency-failed`) — or when every one of them was refused by the content-reference guard
+ * (then `content-ref-refused`, whichever `media-arg-*` case it was). `undefined` for anything else.
+ */
+function onlyFailure(steps, failed) {
+    let first;
+    for (const step of steps) {
+        const f = failed.get(step.stepId);
+        if (f === undefined || f.code === "dependency-failed")
+            continue;
+        if (isContentRefRefusal(f)) {
+            if (first !== undefined && first.code !== CONTENT_REF_REFUSED)
+                return undefined;
+            first ??= err(CONTENT_REF_REFUSED, "a content-reference argument was refused: a content address is a capability and only a reference the host vouches for is accepted");
+            continue;
+        }
+        if (f.code !== "schema-drift" && f.code !== "upstream-empty")
+            return undefined;
+        if (first !== undefined && f.code !== first.code)
+            return undefined;
+        first ??= f;
+    }
+    return first;
+}
+/** A published value; carries `drift` only when an input drift was proceeded past. */
+const okOutcome = (value, findings, drift) => drift.length > 0 ? { ok: true, value, findings, drift } : { ok: true, value, findings };
+export async function executeProvider(spec, opts) {
+    const findings = [];
+    const drift = [];
+    const steps = spec.executionGraph;
+    if (steps.length === 0)
+        return {
+            ok: false,
+            finding: err("empty-graph", `provider "${spec.handle}" has no steps`),
+            drift,
+            findings,
+        };
+    const { waves, cycle } = topoWaves(steps);
+    if (cycle.length > 0)
+        return {
+            ok: false,
+            finding: err("graph-cycle", `provider "${spec.handle}" has a dependency cycle through ${cycle.join(", ")}`),
+            drift,
+            findings,
+        };
+    const registry = opts.providers ?? DEFAULT_DATA_PROVIDERS;
+    // Every kind is resolved BEFORE any step runs: an unregistered one must not leave the steps
+    // before it having called their targets for an answer nobody will publish.
+    const unregistered = [...new Set(steps.map(stepKind))].filter((k) => !registry.has(k)).sort();
+    if (unregistered.length > 0)
+        return {
+            ok: false,
+            finding: err("provider-kind-unregistered", `provider "${spec.handle}" has steps of kind ${unregistered.map((k) => `"${k}"`).join(", ")}, which no data provider is registered for`),
+            drift,
+            findings,
+        };
+    const now = opts.now ?? Date.now();
+    const supplied = opts.params ?? {};
+    const names = providerParams(spec);
+    const declared = new Set(names);
+    const undeclared = Object.keys(supplied)
+        .filter((k) => !declared.has(k))
+        .sort();
+    // Only the params some step declares reach a step — and the argument hook. A hook that could
+    // read an undeclared param could make the answer depend on a value no cache key carries.
+    const params = pickParams(supplied, names);
+    if (undeclared.length > 0)
+        findings.push({
+            code: "param-not-overridable",
+            severity: "warn",
+            message: `provider "${spec.handle}" declares no overridable argument named ${undeclared.map((k) => `"${k}"`).join(", ")}; ignored`,
+        });
+    const outputs = new Map();
+    const failed = new Map();
+    const warnings = new Map();
+    const warn = (stepId, f) => {
+        const list = warnings.get(stepId);
+        if (list === undefined)
+            warnings.set(stepId, [f]);
+        else
+            list.push(f);
+    };
+    const invokeOpts = {
+        label: "loom-ui.hydrate",
+        ...(opts.signal && { signal: opts.signal }),
+        ...(opts.principal && { principal: opts.principal }),
+    };
+    const refEnv = opts.contentRefArgs === undefined
+        ? undefined
+        : contentRefEnv(opts.contentRefArgs, spec, opts.acceptContentRefParam, {
+            principalId: opts.principalId,
+            principal: opts.principal,
+        });
+    for (const wave of waves) {
+        await mapLimit(wave, opts.concurrency ?? 4, async (node) => {
+            if (opts.signal?.aborted) {
+                failed.set(node.stepId, err("aborted", `step "${node.stepId}" aborted before it ran`));
+                return;
+            }
+            if (node.dependsOn.some((d) => failed.has(d))) {
+                failed.set(node.stepId, err("dependency-failed", `step "${node.stepId}" skipped: a dependency failed`));
+                return;
+            }
+            const args = prepareArguments(node, outputs, {
+                handle: spec.handle,
+                params,
+                now,
+                ...(opts.argumentHook && { hook: opts.argumentHook }),
+                ...(refEnv !== undefined && {
+                    guard: (n, applied) => checkContentRefs(n, applied, refEnv).finding,
+                    finish: (a) => finishContentRefArgs(node, a, refEnv.table),
+                }),
+            });
+            if (!args.ok) {
+                failed.set(node.stepId, args.finding);
+                return;
+            }
+            for (const f of args.findings)
+                warn(node.stepId, f);
+            const dataProvider = registry.get(stepKind(node));
+            const call = (expectedPin) => dataProvider.invoke({ stepId: node.stepId, target: node.toolName, args: args.args, expectedPin }, opts.invoker, invokeOpts);
+            try {
+                outputs.set(node.stepId, await call(node.toolSchemaHash));
+            }
+            catch (e) {
+                if (!(e instanceof TypedFailure && e.channel === "schemaDrift")) {
+                    failed.set(node.stepId, stepFailure(node, e, opts.signal));
+                    return;
+                }
+                const observed = e.payload?.observedHash;
+                drift.push({
+                    kind: "input",
+                    handle: spec.handle,
+                    stepId: node.stepId,
+                    toolName: node.toolName,
+                    ...(node.kind !== undefined && { providerKind: node.kind }),
+                    expected: node.toolSchemaHash,
+                    observed: observed ?? "",
+                });
+                const proceed = opts.inputDrift === "report-and-proceed" &&
+                    observed !== undefined &&
+                    observed !== "" &&
+                    observed !== node.toolSchemaHash;
+                if (!proceed) {
+                    failed.set(node.stepId, err("schema-drift", `step "${node.stepId}" (${node.toolName}) input schema drifted from ${node.toolSchemaHash} to ${observed ?? "?"}`));
+                    return;
+                }
+                try {
+                    outputs.set(node.stepId, await call(observed));
+                    warn(node.stepId, {
+                        code: "schema-drift-proceeded",
+                        severity: "warn",
+                        message: `step "${node.stepId}" (${node.toolName}) input schema drifted from ${node.toolSchemaHash} to ${observed}; loaded once with the observed pin — the provider still needs its repair`,
+                    });
+                }
+                catch (retry) {
+                    failed.set(node.stepId, stepFailure(node, retry, opts.signal));
+                }
+            }
+        });
+    }
+    // GRAPH order, not completion order: two independent steps that fail (or warn) in a race must
+    // produce the same finding list every run, or the surface's text depends on which tool was slower.
+    for (const step of steps)
+        for (const f of warnings.get(step.stepId) ?? [])
+            findings.push(f);
+    for (const step of steps) {
+        const f = failed.get(step.stepId);
+        if (f)
+            findings.push(f);
+    }
+    if (failed.size > 0) {
+        // A provider that failed ONLY because of input drift (every step that failed on its own
+        // drifted; the rest were skipped as its dependents) answers with the first drift in graph
+        // order, so the surface says "waiting for a repair" rather than a generic failure. The same
+        // rule for an EMPTY upstream (every step that failed on its own found no such row upstream,
+        // `upstream-empty`): the answer is the first one, published `empty` (loom ADR 0100). Any
+        // other failure alongside either — or the two mixed — keeps the generic `provider-failed`.
+        const only = onlyFailure(steps, failed);
+        if (only !== undefined)
+            return { ok: false, finding: only, drift, findings };
+        return {
+            ok: false,
+            finding: err("provider-failed", `provider "${spec.handle}": ${failed.size} of ${steps.length} steps failed`),
+            drift,
+            findings,
+        };
+    }
+    const terminals = terminalSteps(steps);
+    const raw = terminals.length === 1
+        ? outputs.get(terminals[0].stepId)
+        : Object.fromEntries(terminals.map((t) => [t.stepId, outputs.get(t.stepId)]));
+    const shaped = await reshape(spec.reshaping, raw, {
+        invoker: opts.invoker,
+        ...(opts.signal && { signal: opts.signal }),
+        ...(opts.principal && { principal: opts.principal }),
+        ...(opts.reshapers && { reshapers: opts.reshapers }),
+    });
+    if (!shaped.ok) {
+        findings.push(shaped.finding);
+        // Only a failure the OUTPUT demonstrably caused (typed by `reshape`, never read from a
+        // message) is output drift a planner can repair — so, like a failed pin, the record carries
+        // the raw output's shape and (under `captureSample`) its sample. Infrastructure and transient
+        // failures carry no `failureKind`, and stay an error with no drift.
+        if (shaped.failureKind !== undefined && opts.signal?.aborted !== true)
+            drift.push({
+                kind: "output",
+                handle: spec.handle,
+                expected: "reshape",
+                observed: shaped.finding.code,
+                reshapeFailure: shaped.finding.code,
+                reshapeFailureKind: shaped.failureKind,
+                ...(terminals.length === 1 && { stepId: terminals[0].stepId }),
+                ...observedRawShape(raw),
+                // An uncloneable output is not a data observation: no sample, even under captureSample.
+                ...(opts.captureSample === true &&
+                    shaped.failureKind !== "uncloneable-output" && {
+                    observedSample: tainted(raw, `provider:${spec.handle}`),
+                }),
+            });
+        return { ok: false, finding: shaped.finding, drift, findings };
+    }
+    if (spec.outputCheck === "contract")
+        return checkContract(spec, shaped.value, raw, opts, drift, findings, terminals);
+    if (spec.outputShapeHash === "") {
+        findings.push({
+            code: "output-shape-unpinned",
+            severity: "warn",
+            message: `provider "${spec.handle}" declares no outputShapeHash; the value is unchecked`,
+        });
+        return okOutcome(shaped.value, findings, drift);
+    }
+    // The shaped value is tool-authored: `shapeHash` refuses a nest past its depth cap (and any
+    // value it cannot walk). An unhashable value is an UNVERIFIABLE one — reported as a failure,
+    // never published as if the pin had matched, and never as a throw out of this total function.
+    let observed;
+    try {
+        observed = outputShapeHashOf(shaped.value);
+    }
+    catch (e) {
+        const f = err("output-shape-unhashable", `provider "${spec.handle}" output cannot be shape-hashed, so the pinned ${spec.outputShapeHash} cannot be checked: ${e instanceof Error ? e.message : String(e)}`);
+        findings.push(f);
+        return { ok: false, finding: f, drift, findings };
+    }
+    if (observed !== spec.outputShapeHash) {
+        drift.push({
+            kind: "output",
+            handle: spec.handle,
+            expected: spec.outputShapeHash,
+            observed,
+            ...(terminals.length === 1 && { stepId: terminals[0].stepId }),
+            ...observedShapes(shaped.value, raw),
+            ...(opts.captureSample === true && {
+                observedSample: tainted(raw, `provider:${spec.handle}`),
+            }),
+        });
+        const f = err("output-shape-drift", `provider "${spec.handle}" output shape ${observed} differs from the pinned ${spec.outputShapeHash}`);
+        findings.push(f);
+        return { ok: false, finding: f, drift, findings };
+    }
+    return okOutcome(shaped.value, findings, drift);
+}
+/**
+ * `outputCheck: "contract"`: the reshaped value must satisfy the value contract of EVERY kind the
+ * handle feeds (each widget renders the same value); kinds are checked in sorted order and the
+ * first failure is the drift. `undefined` is refused explicitly — `checkKindValue` passes it as
+ * "not hydrated yet", but a load that produced nothing is not a healthy value.
+ */
+function checkContract(spec, value, raw, opts, drift, findings, terminals) {
+    const kinds = [...new Set(opts.kinds ?? [])].sort();
+    if (kinds.length === 0) {
+        const f = err("output-contract-unbound", `provider "${spec.handle}" checks its output by contract, but no bound kinds were supplied; the value cannot be checked`);
+        findings.push(f);
+        return { ok: false, finding: f, drift, findings };
+    }
+    // A contract check over a kind with NO contract passes every value, and a green check nobody
+    // populated reads as coverage. So it is a refusal — and no drift record: reshaping the value
+    // differently cannot repair a missing contract, which is the catalogue's to declare.
+    const uncontracted = kinds.filter((k) => !hasKindContract(k, opts.contracts));
+    if (uncontracted.length > 0) {
+        const f = err("output-contract-missing", `provider "${spec.handle}" checks its output by contract, but kind${uncontracted.length > 1 ? "s" : ""} ${uncontracted.map((k) => `"${k}"`).join(", ")} ${uncontracted.length > 1 ? "have" : "has"} no value contract (declare one in the catalogue's valueContracts); the value cannot be checked`);
+        findings.push(f);
+        return { ok: false, finding: f, drift, findings };
+    }
+    for (const kind of kinds) {
+        const r = value === undefined
+            ? {
+                ok: false,
+                finding: err("value-contract", `value for kind "${kind}" is undefined: the reshaping produced nothing`),
+            }
+            : checkKindValue(kind, value, opts.contracts);
+        if (r.ok)
+            continue;
+        let observed = "unhashable";
+        try {
+            observed = outputShapeHashOf(value);
+        }
+        catch {
+            // Too deep to hash: the contract failure below is still reported.
+        }
+        drift.push({
+            kind: "output",
+            handle: spec.handle,
+            expected: `contract:${kind}`,
+            observed,
+            contractKind: kind,
+            ...(terminals.length === 1 && { stepId: terminals[0].stepId }),
+            ...observedShapes(value, raw),
+            ...(opts.captureSample === true && {
+                observedSample: tainted(raw, `provider:${spec.handle}`),
+            }),
+        });
+        const f = err("output-contract-drift", `provider "${spec.handle}": ${r.finding.message}`);
+        findings.push(f);
+        return { ok: false, finding: f, drift, findings };
+    }
+    return okOutcome(value, findings, drift);
+}
+/**
+ * What an outcome publishes — the ONE mapping both the in-process controller and `serveHandle`
+ * use, so split and in-process hydration cannot disagree: a value is `ready` (carrying the first
+ * warning, e.g. a proceeded drift); an `upstream-empty` failure is `empty` — checked FIRST, and
+ * carrying no value (loom ADR 0100: a producer MUST clear the value beside `empty`); a failure
+ * with drift is `stale` — unless its only drift is a failed reshaping (`reshapeFailure`), which
+ * stays `error` as it always was — and any other failure `error`.
+ */
+export function outcomeResult(outcome) {
+    if (outcome.ok) {
+        const warn = outcome.findings.find((f) => f.severity === "warn");
+        return warn === undefined
+            ? { state: "ready", value: outcome.value }
+            : { state: "ready", value: outcome.value, finding: warn };
+    }
+    if (outcome.finding.code === "upstream-empty")
+        return { state: "empty", finding: outcome.finding };
+    const stale = outcome.drift.some((d) => d.reshapeFailure === undefined);
+    return { state: stale ? "stale" : "error", finding: outcome.finding };
+}
+//# sourceMappingURL=provider.js.map

package/dist/esm/provider.js.map

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

package/dist/esm/repair.js

@@ -0,0 +1,53 @@
+// ── Crossing the determinism boundary ─────────────────────────────────────────
+// Hydration REPORTS drift; it never repairs. The app runs a durable loom execution that applies
+// the operation built here (via core's `apply`, so the artifact's lineage records it), emits
+// SCHEMA_REPAIRED with this payload, and re-seals. Input drift (a tool's input schema moved) is a
+// pin move and can be remapped mechanically; output drift (the reshaped value's shape changed)
+// means the reshaping is wrong for the data and needs the planner — that is a different slice.
+export const SCHEMA_REPAIRED = "SCHEMA_REPAIRED";
+export function remapOperation(spec, drift) {
+    if (drift.length === 0)
+        return {
+            ok: false,
+            finding: { code: "repair-mismatch", severity: "error", message: "no drift to repair" },
+        };
+    if (drift.some((d) => d.kind === "output"))
+        return {
+            ok: false,
+            finding: {
+                code: "repair-needs-planner",
+                severity: "error",
+                message: `provider "${spec.handle}": output shape drifted; remapping a pin cannot fix a reshaping that no longer matches the data`,
+            },
+        };
+    const steps = new Map(spec.executionGraph.map((s) => [s.stepId, s]));
+    for (const d of drift) {
+        if (d.handle !== spec.handle)
+            return {
+                ok: false,
+                finding: {
+                    code: "repair-mismatch",
+                    severity: "error",
+                    message: `drift for "${d.handle}" applied to provider "${spec.handle}"`,
+                },
+            };
+        if (d.stepId === undefined || !steps.has(d.stepId))
+            return {
+                ok: false,
+                finding: {
+                    code: "repair-mismatch",
+                    severity: "error",
+                    message: `drift names step "${d.stepId ?? "?"}", which provider "${spec.handle}" does not have`,
+                },
+            };
+    }
+    const observedByStep = new Map(drift.map((d) => [d.stepId, d.observed]));
+    const executionGraph = spec.executionGraph.map((s) => observedByStep.has(s.stepId)
+        ? { ...s, toolSchemaHash: observedByStep.get(s.stepId) }
+        : s);
+    return {
+        ok: true,
+        op: { type: "remapProvider", handle: spec.handle, spec: { ...spec, executionGraph } },
+    };
+}
+//# sourceMappingURL=repair.js.map

package/dist/esm/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","sourceRoot":"","sources":["../../src/repair.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,gGAAgG;AAChG,6FAA6F;AAC7F,kGAAkG;AAClG,+FAA+F;AAC/F,+FAA+F;AAE/F,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAUjD,MAAM,UAAU,cAAc,CAC5B,IAAkB,EAClB,KAA6B;IAE7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE;SACvF,CAAC;IACJ,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;QACxC,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE;gBACP,IAAI,EAAE,sBAAsB;gBAC5B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,aAAa,IAAI,CAAC,MAAM,iGAAiG;aACnI;SACF,CAAC;IACJ,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAU,CAAC,CAAC,CAAC;IAC9E,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAC1B,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE;oBACP,IAAI,EAAE,iBAAiB;oBACvB,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,cAAc,CAAC,CAAC,MAAM,0BAA0B,IAAI,CAAC,MAAM,GAAG;iBACxE;aACF,CAAC;QACJ,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;YAChD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE;oBACP,IAAI,EAAE,iBAAiB;oBACvB,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,qBAAqB,CAAC,CAAC,MAAM,IAAI,GAAG,sBAAsB,IAAI,CAAC,MAAM,iBAAiB;iBAChG;aACF,CAAC;IACN,CAAC;IACD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACnD,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1B,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAW,EAAE;QAClE,CAAC,CAAC,CAAC,CACN,CAAC;IACF,OAAO;QACL,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,EAAE;KACtF,CAAC;AACJ,CAAC"}

package/dist/esm/reshape.js

@@ -0,0 +1,156 @@
+import { TypedFailure } from "@loomwork/core";
+import { SANDBOX_TOOL_ID } from "@loomwork/plugin-sandbox";
+import { jsonPathSelect } from "./select";
+/**
+ * The channel loom's sandbox completes on when the SCRIPT itself threw on its input (its own
+ * exception, a SyntaxError, a ReferenceError for a global the VM lacks). Recognised by channel
+ * only: its payload (`{ name?, message }`) is script-authored, UNTRUSTED text — it can echo the
+ * raw output — so it is never read, and never copied into a finding message.
+ */
+const SCRIPT_ERROR = "scriptError";
+const LIMIT_EXCEEDED = "limitExceeded";
+/** A sandbox `TypedFailure` → the output-caused kind it proves, if any. Channel + payload only. */
+function sandboxFailureKind(e) {
+    if (e.channel === SCRIPT_ERROR)
+        return "script-error";
+    if (e.channel !== LIMIT_EXCEEDED)
+        return undefined;
+    const kind = e.payload?.kind;
+    if (kind === "cpu")
+        return "limit-cpu";
+    if (kind === "memory")
+        return "limit-memory";
+    if (kind === "output")
+        return "limit-output";
+    return undefined; // wallClock (host-load dependent) or an unknown kind
+}
+/**
+ * A registry over a plain record. Map-backed, so only the record's OWN entries are registered —
+ * `"constructor"` or `"__proto__"` never resolve to something on a prototype.
+ */
+export function defineReshapers(entries) {
+    const byName = new Map(Object.entries(entries));
+    return { get: (name) => byName.get(name) };
+}
+/**
+ * A Named reshaper runs in-process, trusted like host code — but the RAW terminal output is also
+ * read by callers after `reshape` returns (output-shape hashing, drift sampling): a reshaper that
+ * mutates its input in place must never corrupt what those later readers see, so it gets a copy,
+ * never the original reference. A raw value `structuredClone` cannot represent anywhere in its
+ * tree (a function; `structuredClone` throws) is REFUSED rather than handed to the reshaper live
+ * — that would let the reshaper corrupt what later readers see, exactly what the copy exists to
+ * prevent. (A class instance is not this case: `structuredClone` clones it fine, it just drops
+ * the prototype, so the copy is a plain object with the same own properties.) Throws; `runNamed`
+ * turns that into a `reshape-failed` finding before the reshaper ever runs.
+ */
+function cloneForReshaper(raw) {
+    try {
+        return structuredClone(raw);
+    }
+    catch {
+        throw new Error("input is not cloneable");
+    }
+}
+async function runNamed(name, raw, registry) {
+    const fn = registry?.get(name);
+    if (fn === undefined)
+        return {
+            ok: false,
+            finding: {
+                code: "reshape-unregistered",
+                severity: "error",
+                message: registry === undefined
+                    ? `reshaper "${name}" is Named, but no reshaper registry was supplied`
+                    : `no reshaper is registered under "${name}"`,
+            },
+        };
+    let cloned;
+    try {
+        cloned = cloneForReshaper(raw);
+    }
+    catch (err) {
+        // The OUTPUT is the cause: it holds a value that cannot be copied, so the reshaper never runs.
+        return {
+            ok: false,
+            failureKind: "uncloneable-output",
+            finding: {
+                code: "reshape-failed",
+                severity: "error",
+                message: `reshaper "${name}": ${err instanceof Error ? err.message : String(err)}`,
+            },
+        };
+    }
+    try {
+        return { ok: true, value: await fn(cloned) };
+    }
+    catch (err) {
+        // Host code threw: not proven output-caused, so no kind — a plain error, not drift.
+        return {
+            ok: false,
+            finding: {
+                code: "reshape-failed",
+                severity: "error",
+                message: `reshaper "${name}" failed: ${err instanceof Error ? err.message : String(err)}`,
+            },
+        };
+    }
+}
+/**
+ * A finding MESSAGE must never be the thing that throws. A `TypedFailure` payload is authored by
+ * a tool server or a sandbox script — it can be cyclic, or carry a bigint, and `JSON.stringify`
+ * throws on both. Losing the payload text is a far better outcome than losing the finding.
+ * (Not exported from the package index: it exists for this package's message building.)
+ */
+export function safeStringify(v) {
+    try {
+        return JSON.stringify(v) ?? String(v);
+    }
+    catch {
+        return "[unserializable payload]";
+    }
+}
+export async function reshape(reshaping, raw, ctx) {
+    if (reshaping.engine === "JSONPath")
+        return jsonPathSelect(raw, reshaping.scriptRef);
+    if (reshaping.engine === "Named")
+        return runNamed(reshaping.scriptRef, raw, ctx.reshapers);
+    try {
+        const value = await ctx.invoker.invokeTransient(SANDBOX_TOOL_ID, { scriptRef: { __loomContent: reshaping.scriptRef }, input: raw }, {
+            label: "loom-ui.reshape",
+            ...(ctx.signal && { signal: ctx.signal }),
+            ...(ctx.principal && { principal: ctx.principal }),
+        });
+        return { ok: true, value };
+    }
+    catch (err) {
+        if (err instanceof TypedFailure) {
+            const failureKind = sandboxFailureKind(err);
+            return {
+                ok: false,
+                ...(failureKind !== undefined && { failureKind }),
+                finding: {
+                    code: `reshape-${err.channel}`,
+                    severity: "error",
+                    // A `scriptError` payload is script-authored text that can echo the raw output
+                    // (possibly sensitive, untrusted): fixed text only, never its `name` or `message` —
+                    // no finding, handle status or log hook ever carries it. The raw output travels only
+                    // as the tainted drift sample. Other channels' payloads are loom-authored.
+                    message: failureKind === "script-error"
+                        ? `reshape script ${reshaping.scriptRef} failed on the output (script-error)`
+                        : `sandbox ${err.channel}: ${safeStringify(err.payload)}`,
+                },
+            };
+        }
+        return {
+            ok: false,
+            finding: {
+                code: "reshape-failed",
+                severity: "error",
+                message: err instanceof Error ? err.message : String(err),
+            },
+        };
+    }
+}
+export { outputShapeHashOf } from "./shape";
+export { jsonPathSelect } from "./select";
+//# sourceMappingURL=reshape.js.map