@nodetool-ai/execution 0.8.1

package/dist/sketch-debug/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Sketch debug vocabulary.
+ *
+ * One report shape for "is this image document sound, and what did a scripted
+ * edit session leave behind" — shared by the CLI `sketch validate` /
+ * `sketch debug` commands and any future server surface, the same way
+ * `../timeline-debug/types.ts` is shared by the timeline surfaces.
+ */
+import type { DebugVerdict } from "../debug/types.js";
+/** One finding against an image document. */
+export interface SketchDebugIssue {
+    severity: "error" | "warning";
+    /** Stable machine code, e.g. `field_stripped`, `binding_layer_missing`. */
+    code: string;
+    message: string;
+    layerId?: string;
+    /** JSON path of the offending field, for schema/round-trip findings. */
+    path?: string;
+}
+export interface SketchValidation {
+    /** True when there are no errors. Warnings do not clear `ok`. */
+    ok: boolean;
+    errors: SketchDebugIssue[];
+    warnings: SketchDebugIssue[];
+}
+/** One executed step of a `--interact` script. */
+export interface SketchInteractionRecord {
+    /** Tool name as invoked (canonical `ui_sketch_*` form). */
+    tool: string;
+    input: unknown;
+    ok: boolean;
+    result?: unknown;
+    error?: string;
+}
+export interface SketchDebugTarget {
+    kind: "file" | "id";
+    ref: string;
+    name?: string;
+}
+export interface SketchDocumentMeta {
+    width: number;
+    height: number;
+    backgroundColor: string;
+    layerCount: number;
+    bindingCount: number;
+}
+export interface SketchDebugReport {
+    target: SketchDebugTarget;
+    meta: SketchDocumentMeta;
+    /** Static validation of the input document. */
+    validation: SketchValidation;
+    /** Scripted edit session, when one ran. */
+    interactions: SketchInteractionRecord[];
+    /** Bridge snapshot after the script (SketchBridgeFinalState shape). */
+    finalState?: unknown;
+    /** Validation of the document reconstructed from the final state. */
+    finalValidation?: SketchValidation;
+    /** What a headless run cannot answer (pixels, rendering, assets …). */
+    notSimulated: string[];
+    verdict: DebugVerdict;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sketch-debug/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sketch-debug/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACtC,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,kBAAkB,CAAC;IACzB,+CAA+C;IAC/C,UAAU,EAAE,gBAAgB,CAAC;IAC7B,2CAA2C;IAC3C,YAAY,EAAE,uBAAuB,EAAE,CAAC;IACxC,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,uEAAuE;IACvE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;CACvB"}

package/dist/sketch-debug/types.js

@@ -0,0 +1,10 @@
+/**
+ * Sketch debug vocabulary.
+ *
+ * One report shape for "is this image document sound, and what did a scripted
+ * edit session leave behind" — shared by the CLI `sketch validate` /
+ * `sketch debug` commands and any future server surface, the same way
+ * `../timeline-debug/types.ts` is shared by the timeline surfaces.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sketch-debug/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sketch-debug/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/sketch-debug/validate.d.ts

@@ -0,0 +1,14 @@
+import type { SketchValidation } from "./types.js";
+/** Canvas settings the row carries beside the document. */
+export interface SketchValidationMeta {
+    width?: number;
+    height?: number;
+    backgroundColor?: string;
+}
+/**
+ * Validate a parsed-JSON image document (`{sketch, layerBindings}`). `raw` is
+ * untrusted: a document that is not an object, or has no `sketch`, is reported
+ * and the rest of the pass is skipped, since there is nothing left to read.
+ */
+export declare function validateSketchDocument(raw: unknown, meta?: SketchValidationMeta): SketchValidation;
+//# sourceMappingURL=validate.d.ts.map

package/dist/sketch-debug/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/sketch-debug/validate.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAErE,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAkiBD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,IAAI,CAAC,EAAE,oBAAoB,GAC1B,gBAAgB,CAkDlB"}

package/dist/sketch-debug/validate.js

@@ -0,0 +1,478 @@
+/**
+ * Static validation of a sketch (image document).
+ *
+ * Pure and structural: everything here is decidable from the document alone —
+ * no database, no assets, no canvas. Layer bitmaps stay opaque: a layer's
+ * `data` is a serialized raster payload or a data URL, and nothing offline
+ * decides whether it still decodes, so pixel decode is out of scope.
+ *
+ * Unlike the timeline validator, a schema failure does not stop the structural
+ * pass. `imageDocumentData` leaves layers as `z.array(z.unknown())`, so almost
+ * everything checked here is read by this module anyway; a document that fails
+ * on one binding field should still report the layer stack around it.
+ */
+import { BLEND_MODE_TUPLE } from "@nodetool-ai/gpu";
+import { imageDocumentData, sketchLayerLike } from "@nodetool-ai/protocol/api-schemas/sketch.js";
+import { isFiniteNumber, isNonBlankString, isNonEmptyString, isPositiveFiniteNumber, isString } from "../predicates.js";
+const BLEND_MODES = new Set(BLEND_MODE_TUPLE);
+const BINDING_KINDS = new Set([
+    "workflow",
+    "text-to-image",
+    "image-to-image",
+    "inpaint"
+]);
+const BINDING_STATUSES = new Set([
+    "draft",
+    "queued",
+    "generating",
+    "generated",
+    "stale",
+    "failed",
+    "locked",
+    "missing"
+]);
+const VERSION_STATUSES = new Set(["success", "failed", "cancelled"]);
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const asArray = (value) => Array.isArray(value) ? value : [];
+/**
+ * A binding issue, with `layerId` left out when the binding names no layer.
+ * Kept in one place so every binding finding carries the same field order.
+ */
+function bindingIssue(severity, code, message, layerId, path) {
+    const issue = { severity, code, message };
+    if (layerId) {
+        issue.layerId = layerId;
+    }
+    issue.path = path;
+    return issue;
+}
+/** Collect every leaf/branch path the parse output dropped from the input. */
+function collectStrippedPaths(input, output, path, found) {
+    if (Array.isArray(input)) {
+        if (!Array.isArray(output))
+            return;
+        input.forEach((item, index) => {
+            collectStrippedPaths(item, output[index], `${path}[*]`, found);
+        });
+        return;
+    }
+    if (!isRecord(input) || !isRecord(output))
+        return;
+    for (const [key, value] of Object.entries(input)) {
+        // An explicit `undefined` carries nothing, so its absence loses nothing.
+        if (value === undefined)
+            continue;
+        const childPath = path ? `${path}.${key}` : key;
+        if (!(key in output) || output[key] === undefined) {
+            found.add(childPath);
+            continue;
+        }
+        collectStrippedPaths(value, output[key], childPath, found);
+    }
+}
+/**
+ * Fields the schema silently drops. A stripped field survives in memory and
+ * disappears on the next autosave round trip, so it never fails loudly — the
+ * only way to see it is to diff the input against what Zod handed back.
+ *
+ * The document schema keeps layers as `unknown`, so nothing inside a layer is
+ * ever reported here; layer fields are checked directly instead.
+ */
+function checkFieldStripping(raw, parsed) {
+    const paths = new Set();
+    collectStrippedPaths(raw, parsed, "", paths);
+    return [...paths].sort().map((path) => ({
+        severity: "warning",
+        code: "field_stripped",
+        path,
+        message: `\`${path}\` is present in the document but absent after schema parse — the schema strips it, so it is lost on the next save.`
+    }));
+}
+function checkSchema(raw) {
+    const result = imageDocumentData.safeParse(raw);
+    if (result.success) {
+        return {
+            issues: checkFieldStripping(raw, result.data),
+            parsed: result.data
+        };
+    }
+    const issues = result.error.issues
+        .slice(0, 25)
+        .map((issue) => {
+        const path = issue.path.map((part) => String(part)).join(".");
+        const schemaIssue = {
+            severity: "error",
+            code: "schema_invalid",
+            message: `${path || "(root)"}: ${issue.message}`
+        };
+        if (path) {
+            schemaIssue.path = path;
+        }
+        return schemaIssue;
+    });
+    if (issues.length === 0) {
+        issues.push({
+            severity: "error",
+            code: "schema_invalid",
+            message: "Document does not match the image-document schema."
+        });
+    }
+    return { issues, parsed: undefined };
+}
+function checkCanvas(sketch, meta) {
+    const issues = [];
+    const canvas = isRecord(sketch.canvas) ? sketch.canvas : undefined;
+    if (!canvas) {
+        issues.push({
+            severity: "error",
+            code: "canvas_missing",
+            message: "The sketch has no `canvas` — nothing declares the artboard size.",
+            path: "sketch.canvas"
+        });
+        return issues;
+    }
+    for (const axis of ["width", "height"]) {
+        if (!isPositiveFiniteNumber(canvas[axis])) {
+            issues.push({
+                severity: "error",
+                code: "canvas_invalid",
+                message: `Canvas ${axis} is ${JSON.stringify(canvas[axis])} — the artboard must have a positive ${axis}.`,
+                path: `sketch.canvas.${axis}`
+            });
+        }
+    }
+    if (canvas.backgroundColor !== undefined &&
+        !isString(canvas.backgroundColor)) {
+        issues.push({
+            severity: "error",
+            code: "canvas_invalid",
+            message: `Canvas backgroundColor is ${JSON.stringify(canvas.backgroundColor)} — expected a color string.`,
+            path: "sketch.canvas.backgroundColor"
+        });
+    }
+    // The row's width/height are what the editor opens and what thumbnails are
+    // cut at; a document that disagrees renders at one size and is stored at
+    // another.
+    for (const axis of ["width", "height"]) {
+        const outer = meta?.[axis];
+        if (isPositiveFiniteNumber(outer) &&
+            isPositiveFiniteNumber(canvas[axis]) &&
+            outer !== canvas[axis]) {
+            issues.push({
+                severity: "warning",
+                code: "canvas_size_mismatch",
+                message: `Canvas ${axis} is ${String(canvas[axis])} but the image document records ${String(outer)}.`,
+                path: `sketch.canvas.${axis}`
+            });
+        }
+    }
+    return issues;
+}
+function readLayers(sketch) {
+    const issues = [];
+    const layers = [];
+    const seen = new Set();
+    asArray(sketch.layers).forEach((entry, index) => {
+        const path = `sketch.layers[${index}]`;
+        if (!isRecord(entry)) {
+            issues.push({
+                severity: "error",
+                code: "layer_invalid",
+                message: `Layer at index ${index} is ${JSON.stringify(entry)} — expected an object.`,
+                path
+            });
+            return;
+        }
+        const parsed = sketchLayerLike.safeParse(entry);
+        if (!parsed.success) {
+            for (const issue of parsed.error.issues.slice(0, 5)) {
+                const field = issue.path.map((part) => String(part)).join(".");
+                const layerIssue = {
+                    severity: "error",
+                    code: "layer_invalid",
+                    message: `Layer at index ${index}: ${field || "(root)"}: ${issue.message}`,
+                    path: field ? `${path}.${field}` : path
+                };
+                if (isString(entry.id)) {
+                    layerIssue.layerId = entry.id;
+                }
+                issues.push(layerIssue);
+            }
+            if (!isNonEmptyString(entry.id))
+                return;
+        }
+        const id = String(entry.id);
+        const label = isNonEmptyString(entry.name) ? entry.name : id;
+        if (seen.has(id)) {
+            issues.push({
+                severity: "error",
+                code: "duplicate_layer_id",
+                message: `Duplicate layer id "${id}" — every reference to it is ambiguous.`,
+                layerId: id,
+                path
+            });
+        }
+        seen.add(id);
+        layers.push({
+            id,
+            label,
+            type: isString(entry.type) ? entry.type : "raster",
+            record: entry
+        });
+    });
+    return { layers, issues };
+}
+function checkLayer(layer, ids) {
+    const issues = [];
+    const { record, id, label } = layer;
+    const { opacity } = record;
+    if (opacity !== undefined) {
+        if (!isFiniteNumber(opacity) ||
+            opacity < 0 ||
+            opacity > 1) {
+            issues.push({
+                severity: "error",
+                code: "layer_opacity_invalid",
+                message: `Layer "${label}" has opacity ${JSON.stringify(opacity)} — compositing expects a number in [0, 1].`,
+                layerId: id,
+                path: "opacity"
+            });
+        }
+    }
+    const { blendMode } = record;
+    if (blendMode !== undefined && !BLEND_MODES.has(String(blendMode))) {
+        issues.push({
+            severity: "error",
+            code: "unknown_blend_mode",
+            message: `Layer "${label}" blends with "${String(blendMode)}", which no NodeTool compositor ships.`,
+            layerId: id,
+            path: "blendMode"
+        });
+    }
+    const bounds = record.contentBounds;
+    if (bounds !== undefined) {
+        if (!isRecord(bounds)) {
+            issues.push({
+                severity: "error",
+                code: "content_bounds_invalid",
+                message: `Layer "${label}" has contentBounds ${JSON.stringify(bounds)} — expected an object.`,
+                layerId: id,
+                path: "contentBounds"
+            });
+        }
+        else {
+            for (const axis of ["width", "height"]) {
+                const value = bounds[axis];
+                if (!isFiniteNumber(value) || value < 0) {
+                    issues.push({
+                        severity: "error",
+                        code: "content_bounds_invalid",
+                        message: `Layer "${label}" has contentBounds.${axis} ${JSON.stringify(value)} — a backing raster cannot be smaller than nothing.`,
+                        layerId: id,
+                        path: `contentBounds.${axis}`
+                    });
+                }
+            }
+        }
+    }
+    const { parentId } = record;
+    if (isNonEmptyString(parentId) && !ids.has(parentId)) {
+        issues.push({
+            severity: "warning",
+            code: "layer_parent_missing",
+            message: `Layer "${label}" names parent "${parentId}", which the document does not contain — it renders at the root.`,
+            layerId: id,
+            path: "parentId"
+        });
+    }
+    return issues;
+}
+function checkSelection(sketch, layers, ids) {
+    const issues = [];
+    if (layers.length === 0) {
+        issues.push({
+            severity: "warning",
+            code: "document_empty",
+            message: "The sketch has no layers — nothing composites onto the canvas.",
+            path: "sketch.layers"
+        });
+    }
+    const active = sketch.activeLayerId;
+    if (layers.length > 0) {
+        if (!isNonEmptyString(active)) {
+            issues.push({
+                severity: "error",
+                code: "active_layer_missing",
+                message: `activeLayerId is ${JSON.stringify(active)} — edits have no layer to land on.`,
+                path: "sketch.activeLayerId"
+            });
+        }
+        else if (!ids.has(active)) {
+            issues.push({
+                severity: "error",
+                code: "active_layer_missing",
+                message: `activeLayerId "${active}" names a layer the document does not contain.`,
+                layerId: active,
+                path: "sketch.activeLayerId"
+            });
+        }
+    }
+    const mask = sketch.maskLayerId;
+    if (isNonEmptyString(mask) && !ids.has(mask)) {
+        issues.push({
+            severity: "warning",
+            code: "mask_layer_missing",
+            message: `maskLayerId "${mask}" names a layer the document does not contain — masked edits fall back to the whole canvas.`,
+            layerId: mask,
+            path: "sketch.maskLayerId"
+        });
+    }
+    return issues;
+}
+function checkBindings(document, ids) {
+    const issues = [];
+    const raw = document.layerBindings;
+    if (raw === undefined || !Array.isArray(raw)) {
+        issues.push({
+            severity: "error",
+            code: "bindings_missing",
+            message: "`layerBindings` is missing or not an array — the document does not declare how any layer generates.",
+            path: "layerBindings"
+        });
+        return issues;
+    }
+    const bound = new Set();
+    raw.forEach((entry, index) => {
+        const path = `layerBindings[${index}]`;
+        if (!isRecord(entry)) {
+            issues.push({
+                severity: "error",
+                code: "binding_invalid",
+                message: `Binding at index ${index} is ${JSON.stringify(entry)} — expected an object.`,
+                path
+            });
+            return;
+        }
+        const layerId = isString(entry.layerId) ? entry.layerId : "";
+        if (layerId === "") {
+            issues.push({
+                severity: "error",
+                code: "binding_invalid",
+                message: `Binding at index ${index} has no \`layerId\` — nothing says which layer it generates.`,
+                path: `${path}.layerId`
+            });
+        }
+        else if (!ids.has(layerId)) {
+            issues.push({
+                severity: "error",
+                code: "binding_layer_missing",
+                message: `Binding at index ${index} generates layer "${layerId}", which the document does not contain.`,
+                layerId,
+                path: `${path}.layerId`
+            });
+        }
+        else if (bound.has(layerId)) {
+            issues.push({
+                severity: "error",
+                code: "duplicate_binding",
+                message: `Layer "${layerId}" carries more than one binding — which one generates it is undefined.`,
+                layerId,
+                path: `${path}.layerId`
+            });
+        }
+        if (layerId !== "")
+            bound.add(layerId);
+        // Absent `kind` is legacy data, which the editor reads as "workflow".
+        const kind = entry.kind === undefined ? "workflow" : String(entry.kind);
+        if (!BINDING_KINDS.has(kind)) {
+            issues.push(bindingIssue("error", "binding_kind_invalid", `Binding for "${layerId}" has kind "${kind}" — expected one of ${[...BINDING_KINDS].join(", ")}.`, layerId, `${path}.kind`));
+        }
+        if (kind === "workflow") {
+            const workflowId = entry.workflowId;
+            if (!isNonEmptyString(workflowId)) {
+                issues.push(bindingIssue("error", "binding_workflow_missing", `Workflow binding for "${layerId}" names no workflowId — nothing can produce its pixels.`, layerId, `${path}.workflowId`));
+            }
+        }
+        else {
+            const prompt = entry.prompt;
+            if (!isNonBlankString(prompt)) {
+                issues.push(bindingIssue("warning", "binding_incomplete", `${kind} binding for "${layerId}" carries no prompt — a generation would run on nothing.`, layerId, `${path}.prompt`));
+            }
+            const source = entry.sourceLayerId;
+            if ((kind === "image-to-image" || kind === "inpaint") &&
+                isNonEmptyString(source) &&
+                !ids.has(source)) {
+                issues.push(bindingIssue("warning", "binding_source_layer_missing", `${kind} binding for "${layerId}" reads source layer "${source}", which the document does not contain.`, layerId, `${path}.sourceLayerId`));
+            }
+        }
+        const status = entry.status;
+        if (!isString(status) || !BINDING_STATUSES.has(status)) {
+            issues.push(bindingIssue("error", "binding_status_invalid", `Binding for "${layerId}" has status ${JSON.stringify(status)} — expected one of ${[...BINDING_STATUSES].join(", ")}.`, layerId, `${path}.status`));
+        }
+        const versions = entry.versions;
+        if (versions !== undefined && !Array.isArray(versions)) {
+            issues.push(bindingIssue("error", "binding_invalid", `Binding for "${layerId}" has \`versions\` ${JSON.stringify(versions)} — expected an array.`, layerId, `${path}.versions`));
+        }
+        asArray(versions).forEach((version, versionIndex) => {
+            if (!isRecord(version))
+                return;
+            const versionStatus = version.status;
+            if (!isString(versionStatus) ||
+                !VERSION_STATUSES.has(versionStatus)) {
+                issues.push(bindingIssue("error", "version_status_invalid", `Version ${versionIndex} of the binding for "${layerId}" has status ${JSON.stringify(versionStatus)} — expected one of ${[...VERSION_STATUSES].join(", ")}.`, layerId, `${path}.versions[${versionIndex}].status`));
+            }
+        });
+    });
+    return issues;
+}
+/**
+ * Validate a parsed-JSON image document (`{sketch, layerBindings}`). `raw` is
+ * untrusted: a document that is not an object, or has no `sketch`, is reported
+ * and the rest of the pass is skipped, since there is nothing left to read.
+ */
+export function validateSketchDocument(raw, meta) {
+    if (!isRecord(raw)) {
+        return {
+            ok: false,
+            errors: [
+                {
+                    severity: "error",
+                    code: "document_invalid",
+                    message: `Document is ${JSON.stringify(raw)} — expected an object carrying \`sketch\` and \`layerBindings\`.`
+                }
+            ],
+            warnings: []
+        };
+    }
+    const { issues: schemaIssues } = checkSchema(raw);
+    if (!isRecord(raw.sketch)) {
+        return {
+            ok: false,
+            errors: [
+                ...schemaIssues.filter((issue) => issue.severity === "error"),
+                {
+                    severity: "error",
+                    code: "sketch_missing",
+                    message: "Document has no `sketch` object — there is no layer stack to check.",
+                    path: "sketch"
+                }
+            ],
+            warnings: schemaIssues.filter((issue) => issue.severity === "warning")
+        };
+    }
+    const sketch = raw.sketch;
+    const { layers, issues: layerIssues } = readLayers(sketch);
+    const ids = new Set(layers.map((layer) => layer.id));
+    const issues = [
+        ...schemaIssues,
+        ...checkCanvas(sketch, meta),
+        ...layerIssues,
+        ...layers.flatMap((layer) => checkLayer(layer, ids)),
+        ...checkSelection(sketch, layers, ids),
+        ...checkBindings(raw, ids)
+    ];
+    const errors = issues.filter((issue) => issue.severity === "error");
+    const warnings = issues.filter((issue) => issue.severity === "warning");
+    return { ok: errors.length === 0, errors, warnings };
+}
+//# sourceMappingURL=validate.js.map

package/dist/sketch-debug/validate.js.map

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

package/dist/supervisor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Reporting for supervised runs: one vocabulary for "what did the supervisor
+ * do", shared by every surface that prints or serializes it.
+ *
+ * The record itself is `Intervention` from `@nodetool-ai/protocol` — minted by
+ * the kernel, carried on `RunResult.interventions` and on every
+ * `supervisor_decision` message. Nothing here reshapes it; these are the
+ * rollup and the two lines a surface prints.
+ *
+ * See docs/workflow-supervisor-design.md §4 and §7.
+ */
+import type { DecidedBy, Intervention, VerdictAction } from "@nodetool-ai/protocol";
+/** The shield that marks a supervised line. */
+export declare const INTERVENTION_MARK = "\u26E8";
+/** Per-run rollup of what supervision decided and what it cost. */
+export interface SupervisedRunSummary {
+    /** Interventions recorded, whoever decided them. */
+    decisions: number;
+    /** Decisions that actually reached the model — the ones that cost money. */
+    agentDecisions: number;
+    byAction: Record<VerdictAction, number>;
+    byDecider: Record<DecidedBy, number>;
+    /** Supervisor spend for the run, in USD. */
+    costUsd: number;
+}
+export declare function summarizeInterventions(interventions: readonly Intervention[]): SupervisedRunSummary;
+/**
+ * One inline line per intervention, e.g.
+ * `⛨ fetch-item [3] skipped — HTTP 404 (agent, $0.0041)`.
+ */
+export declare function formatInterventionLine(intervention: Intervention): string;
+/**
+ * The run's closing supervised line, e.g.
+ * `⛨ supervised: 3 decisions, 2 skipped, 1 retried, +$0.0200`.
+ *
+ * Item counts (`198/200 items`) are a fan-out property no run-level record
+ * carries — the kernel counts invocations, not the batch a user thinks in —
+ * so a caller that knows its item total passes it in; otherwise the line
+ * reports decisions.
+ */
+export declare function formatSupervisedSummary(summary: SupervisedRunSummary, items?: {
+    total: number;
+    produced: number;
+}): string;
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../src/supervisor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEpF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB,WAAM,CAAC;AAErC,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACrC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,SAAS,YAAY,EAAE,GACrC,oBAAoB,CAgBtB;AAuBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAYzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,KAAK,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1C,MAAM,CAmBR"}