@nodetool-ai/cli 0.7.0-rc.22 → 0.8.1

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

@@ -0,0 +1,87 @@
+import type { SketchDebugReport, SketchInteractionRecord, SketchValidation } from "@nodetool-ai/execution/sketch-debug";
+import type { SketchInteractionStep } from "./interactions.js";
+import { type ResolvedSketchTarget, type SketchCanvasSettings, type SketchTargetDeps } from "./target.js";
+/** The pieces of the shared core this host calls. */
+export interface SketchDebugCore {
+    validateSketchDocument: (raw: unknown, meta?: SketchCanvasSettings) => SketchValidation | Promise<SketchValidation>;
+    buildSketchDebugReport: (input: {
+        target: SketchDebugReport["target"];
+        document: unknown;
+        meta?: SketchCanvasSettings;
+        interactions?: SketchInteractionRecord[];
+        finalState?: unknown;
+        finalDocument?: unknown;
+    }) => SketchDebugReport | Promise<SketchDebugReport>;
+    renderSketchReportMarkdown: (report: SketchDebugReport) => string;
+}
+/** The bridge surface this host drives — one tool per `ui_sketch_*` name. */
+export interface SketchBridgeTool {
+    name: string;
+    /**
+     * HOLDOUT (anti-slop/no-unknown-returns): a `ui_sketch_*` tool answers in
+     * the open tool-result domain, and the bridge that implements this lives in
+     * `@nodetool-ai/agents`.
+     */
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+}
+/** One layer of the bridge's snapshot. */
+export interface SketchBridgeLayer {
+    id: string;
+    name: string;
+    type: "raster" | "mask" | "group";
+    visible: boolean;
+    opacity: number;
+    blendMode: string;
+    hasBinding?: boolean;
+}
+/** The bridge's snapshot after a session (`SketchBridgeFinalState`). */
+export interface SketchBridgeSnapshot {
+    width?: number;
+    height?: number;
+    backgroundColor?: string;
+    activeLayerId?: string | null;
+    layers?: SketchBridgeLayer[];
+}
+export interface SketchBridge {
+    tools: SketchBridgeTool[];
+    finalState: () => SketchBridgeSnapshot;
+}
+export type CreateSketchBridge = (initial: {
+    name?: string;
+    width?: number;
+    height?: number;
+    layers?: {
+        name: string;
+        type?: "raster" | "mask";
+    }[];
+}) => SketchBridge;
+export interface SketchDebugDeps extends SketchTargetDeps {
+    /** Defaults to `@nodetool-ai/execution/sketch-debug`. */
+    core?: SketchDebugCore;
+    /** Defaults to `createSketchToolBridge` from `@nodetool-ai/agents`. */
+    createBridge?: CreateSketchBridge;
+    onLog?: (line: string) => void;
+}
+export interface SketchDebugOptions {
+    interact?: SketchInteractionStep[];
+    outDir?: string;
+}
+export interface SketchValidateResult {
+    target: ResolvedSketchTarget["target"];
+    validation: SketchValidation;
+}
+export interface SketchDebugResult {
+    report: SketchDebugReport;
+    bundleDir: string;
+}
+/** Load a sketch and validate it — no bridge, no bundle. */
+export declare function runSketchValidate(ref: string, deps: SketchDebugDeps): Promise<SketchValidateResult>;
+/**
+ * Replay `--interact` against the headless bridge and write the bundle.
+ *
+ * A failing step is recorded and the script continues: a run that stops at the
+ * first error hides every problem behind it, and the report is what the caller
+ * came for.
+ */
+export declare function runSketchDebug(ref: string, options: SketchDebugOptions, deps: SketchDebugDeps): Promise<SketchDebugResult>;
+//# sourceMappingURL=harness.d.ts.map

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

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

package/dist/sketch-debug/harness.js

@@ -0,0 +1,178 @@
+/**
+ * The sketch debug harness: the CLI host around the shared validator.
+ *
+ * `runSketchValidate` is the cheap pre-flight — load an image document, check
+ * it, report. `runSketchDebug` additionally replays a scripted edit session
+ * against the headless `ui_sketch_*` bridge (the one the tool-loop eval
+ * drives), validates the document the session left behind, and writes a
+ * self-contained bundle.
+ *
+ * Everything that could pull in a heavy package is injected with a lazy
+ * default: the validator core (`@nodetool-ai/execution/sketch-debug`) and the
+ * bridge factory (`@nodetool-ai/agents`). Tests supply their own and load
+ * neither.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { resolveSketchTarget } from "./target.js";
+async function loadCore() {
+    const core = await import("@nodetool-ai/execution/sketch-debug");
+    return {
+        validateSketchDocument: (raw, meta) => core.validateSketchDocument(raw, meta),
+        buildSketchDebugReport: (input) => core.buildSketchDebugReport(input),
+        renderSketchReportMarkdown: (report) => core.renderSketchReportMarkdown(report)
+    };
+}
+async function loadBridgeFactory() {
+    const { createSketchToolBridge } = await import("@nodetool-ai/agents");
+    return (initial) => 
+    // SAFETY: the eval-surface bridge in @nodetool-ai/agents implements this
+    // exact tool list and snapshot — it is the bridge this type describes. The
+    // two packages declare the sketch document types independently, and that
+    // duplication is the only reason the structures do not line up.
+    createSketchToolBridge(initial);
+}
+function defaultOutDir(ref) {
+    const slug = ref
+        .replace(/[^a-zA-Z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40) || "sketch";
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    return resolve(`nodetool-debug/sketch-${slug}-${stamp}`);
+}
+/** Load a sketch and validate it — no bridge, no bundle. */
+export async function runSketchValidate(ref, deps) {
+    const resolved = await resolveSketchTarget(ref, deps);
+    const core = deps.core ?? (await loadCore());
+    const validation = await core.validateSketchDocument(resolved.raw, resolved.meta);
+    return { target: resolved.target, validation };
+}
+function reconstructDocument(snapshot, resolved) {
+    const layers = (snapshot.layers ?? []).map((layer) => ({
+        id: layer.id,
+        name: layer.name,
+        type: layer.type,
+        visible: layer.visible,
+        locked: false,
+        opacity: layer.opacity,
+        blendMode: layer.blendMode,
+        data: null
+    }));
+    const activeLayerId = snapshot.activeLayerId ?? "";
+    const background = snapshot.backgroundColor ??
+        resolved.document.canvas.backgroundColor ??
+        resolved.meta.backgroundColor;
+    const canvas = {
+        width: snapshot.width ?? resolved.document.canvas.width ?? 0,
+        height: snapshot.height ?? resolved.document.canvas.height ?? 0
+    };
+    if (background !== undefined) {
+        canvas.backgroundColor = background;
+    }
+    return {
+        sketch: {
+            version: resolved.document.version,
+            canvas,
+            layers,
+            activeLayerId,
+            maskLayerId: null
+        },
+        layerBindings: []
+    };
+}
+/**
+ * Replay `--interact` against the headless bridge and write the bundle.
+ *
+ * A failing step is recorded and the script continues: a run that stops at the
+ * first error hides every problem behind it, and the report is what the caller
+ * came for.
+ */
+export async function runSketchDebug(ref, options, deps) {
+    const resolved = await resolveSketchTarget(ref, deps);
+    const core = deps.core ?? (await loadCore());
+    const steps = options.interact ?? [];
+    const interactions = [];
+    let snapshot;
+    if (steps.length > 0) {
+        const createBridge = deps.createBridge ?? (await loadBridgeFactory());
+        const bridgeInit = {
+            // The bridge seeds names and types only; a group layer has no headless
+            // equivalent, so it enters the stack as a raster.
+            layers: resolved.document.layers.map((layer) => ({
+                name: layer.name,
+                type: layer.type === "mask" ? "mask" : "raster"
+            }))
+        };
+        if (resolved.target.name) {
+            bridgeInit.name = resolved.target.name;
+        }
+        if (resolved.document.canvas.width !== undefined) {
+            bridgeInit.width = resolved.document.canvas.width;
+        }
+        if (resolved.document.canvas.height !== undefined) {
+            bridgeInit.height = resolved.document.canvas.height;
+        }
+        const bridge = createBridge(bridgeInit);
+        const byName = new Map(bridge.tools.map((t) => [t.name, t]));
+        for (const step of steps) {
+            const tool = byName.get(step.tool);
+            if (!tool) {
+                const known = [...byName.keys()].sort().join(", ");
+                interactions.push({
+                    tool: step.tool,
+                    input: step.input,
+                    ok: false,
+                    error: `No sketch tool named "${step.tool}". Available: ${known}.`
+                });
+                deps.onLog?.(`✗ ${step.tool}: unknown tool`);
+                continue;
+            }
+            try {
+                const result = await tool.execute(step.input);
+                interactions.push({
+                    tool: step.tool,
+                    input: step.input,
+                    ok: true,
+                    result
+                });
+                deps.onLog?.(`✓ ${step.tool}`);
+            }
+            catch (e) {
+                const error = e instanceof Error ? e.message : String(e);
+                interactions.push({
+                    tool: step.tool,
+                    input: step.input,
+                    ok: false,
+                    error
+                });
+                deps.onLog?.(`✗ ${step.tool}: ${error}`);
+            }
+        }
+        snapshot = bridge.finalState();
+    }
+    const finalDocument = snapshot
+        ? reconstructDocument(snapshot, resolved)
+        : undefined;
+    const reportInput = {
+        target: resolved.target,
+        document: resolved.raw,
+        meta: resolved.meta,
+        interactions
+    };
+    if (snapshot) {
+        reportInput.finalState = snapshot;
+    }
+    if (finalDocument) {
+        reportInput.finalDocument = finalDocument;
+    }
+    const report = await core.buildSketchDebugReport(reportInput);
+    const bundleDir = options.outDir
+        ? resolve(options.outDir)
+        : defaultOutDir(ref);
+    await mkdir(bundleDir, { recursive: true });
+    await writeFile(join(bundleDir, "sketch.json"), JSON.stringify(resolved.raw, null, 2), "utf8");
+    await writeFile(join(bundleDir, "report.json"), JSON.stringify(report, null, 2), "utf8");
+    await writeFile(join(bundleDir, "report.md"), core.renderSketchReportMarkdown(report), "utf8");
+    return { report, bundleDir };
+}
+//# sourceMappingURL=harness.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * The CLI host for the sketch debug harness: target resolution, the
+ * `--interact` script, and the bundle writer. The rules themselves live in
+ * `@nodetool-ai/execution/sketch-debug`.
+ */
+export { runSketchDebug, runSketchValidate, type CreateSketchBridge, type SketchBridge, type SketchBridgeLayer, type SketchBridgeSnapshot, type SketchBridgeTool, type SketchDebugCore, type SketchDebugDeps, type SketchDebugOptions, type SketchDebugResult, type SketchValidateResult } from "./harness.js";
+export { normalizeToolName, parseInteractionScript, type SketchInteractionStep } from "./interactions.js";
+export { resolveSketchTarget, type ImageDocumentRecord, type ResolvedSketchTarget, type SketchCanvasSettings, type SketchDocumentView, type SketchLayerView, type SketchTargetDeps } from "./target.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sketch-debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC"}

package/dist/sketch-debug/index.js

@@ -0,0 +1,9 @@
+/**
+ * The CLI host for the sketch debug harness: target resolution, the
+ * `--interact` script, and the bundle writer. The rules themselves live in
+ * `@nodetool-ai/execution/sketch-debug`.
+ */
+export { runSketchDebug, runSketchValidate } from "./harness.js";
+export { normalizeToolName, parseInteractionScript } from "./interactions.js";
+export { resolveSketchTarget } from "./target.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sketch-debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,cAAc,EACd,iBAAiB,EAWlB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EAEvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EAOpB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * The `--interact` script for `nodetool sketch debug`.
+ *
+ * A step names one sketch tool and the input to call it with:
+ *
+ * ```json
+ * [{"tool": "add_layer", "input": {"name": "Glow", "type": "raster"}},
+ *  {"tool": "ui_sketch_set_layer_props",
+ *   "input": {"target": "Glow", "opacity": 0.5, "blendMode": "multiply"}}]
+ * ```
+ *
+ * Both spellings resolve to the same tool: the `ui_sketch_` prefix is what the
+ * bridge and the browser call it, and typing it for every step is noise.
+ */
+import { type InteractionStep } from "../interaction-script.js";
+/** One parsed step, with the tool name in its canonical `ui_sketch_*` form. */
+export type SketchInteractionStep = InteractionStep;
+export declare const normalizeToolName: (name: string) => string, parseInteractionScript: (json: string) => InteractionStep[];
+//# sourceMappingURL=interactions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../src/sketch-debug/interactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAElC,+EAA+E;AAC/E,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAEpD,eAAO,MAAQ,iBAAiB,4BAAE,sBAAsB,qCAIrD,CAAC"}

package/dist/sketch-debug/interactions.js

@@ -0,0 +1,17 @@
+/**
+ * The `--interact` script for `nodetool sketch debug`.
+ *
+ * A step names one sketch tool and the input to call it with:
+ *
+ * ```json
+ * [{"tool": "add_layer", "input": {"name": "Glow", "type": "raster"}},
+ *  {"tool": "ui_sketch_set_layer_props",
+ *   "input": {"target": "Glow", "opacity": 0.5, "blendMode": "multiply"}}]
+ * ```
+ *
+ * Both spellings resolve to the same tool: the `ui_sketch_` prefix is what the
+ * bridge and the browser call it, and typing it for every step is noise.
+ */
+import { createInteractionScript } from "../interaction-script.js";
+export const { normalizeToolName, parseInteractionScript } = createInteractionScript("ui_sketch_", '{"tool":"add_layer","input":{"name":"Glow"}}');
+//# sourceMappingURL=interactions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../src/sketch-debug/interactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAKlC,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,GACxD,uBAAuB,CACrB,YAAY,EACZ,8CAA8C,CAC/C,CAAC"}

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

@@ -0,0 +1,48 @@
+import type { SketchDebugTarget } from "@nodetool-ai/execution/sketch-debug";
+/** An `image_documents` row as the harness needs it. */
+export interface ImageDocumentRecord {
+    id: string;
+    name?: string | null;
+    width?: number;
+    height?: number;
+    /** camelCase on the API response, snake_case on the row. */
+    backgroundColor?: string;
+    background_color?: string;
+    /** The stored document — a JSON string or an already-parsed object. */
+    document: unknown;
+}
+export interface SketchTargetDeps {
+    /** Load an image document by DB id. */
+    loadDocument: (id: string) => Promise<ImageDocumentRecord | null>;
+}
+/** The canvas settings the row carries beside the document. */
+export interface SketchCanvasSettings {
+    width?: number;
+    height?: number;
+    backgroundColor?: string;
+}
+/** The layer stack, read down to what the headless bridge can be seeded with. */
+export interface SketchLayerView {
+    id: string;
+    name: string;
+    type: "raster" | "mask" | "group";
+}
+/** The document read as a canvas plus a layer stack. */
+export interface SketchDocumentView {
+    version: number;
+    canvas: SketchCanvasSettings;
+    layers: SketchLayerView[];
+    activeLayerId: string;
+    maskLayerId: string | null;
+}
+export interface ResolvedSketchTarget {
+    target: SketchDebugTarget;
+    /** The document exactly as loaded — validation's input, unrepaired. */
+    raw: unknown;
+    /** The same document, read as a canvas + layer stack. */
+    document: SketchDocumentView;
+    meta: SketchCanvasSettings;
+}
+/** Resolve a sketch target: a JSON file path or an image document row id. */
+export declare function resolveSketchTarget(ref: string, deps: SketchTargetDeps): Promise<ResolvedSketchTarget>;
+//# sourceMappingURL=target.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/sketch-debug/target.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAgB7E,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CACnE;AAED,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,uEAAuE;IACvE,GAAG,EAAE,OAAO,CAAC;IACb,yDAAyD;IACzD,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,oBAAoB,CAAC;CAC5B;AA8ED,6EAA6E;AAC7E,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAiD/B"}

package/dist/sketch-debug/target.js

@@ -0,0 +1,138 @@
+/**
+ * Resolves a sketch debug target into an image document plus its canvas
+ * settings.
+ *
+ * A sketch is named two ways, and both end up in the same shape:
+ *
+ * - a **JSON file** — either a bare `ImageDocumentData` (`sketch` +
+ *   `layerBindings`) or a wrapper carrying one under `document`, as the
+ *   `image_documents` row and the `sketch.get` response do;
+ * - an **image_documents row id**, read through an injected loader so this
+ *   module needs no database.
+ *
+ * A path that exists on disk wins over an id, so a file named like an id is
+ * still readable.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { isFiniteNumber, isRecord, isString } from "../predicates.js";
+const numberOr = (value) => isFiniteNumber(value) ? value : undefined;
+/** Read width/height/background off whatever wrapper carried the document. */
+function settingsOf(raw) {
+    if (!isRecord(raw))
+        return {};
+    const settings = {};
+    const width = numberOr(raw.width);
+    const height = numberOr(raw.height);
+    const background = isString(raw.backgroundColor)
+        ? raw.backgroundColor
+        : isString(raw.background_color)
+            ? raw.background_color
+            : undefined;
+    if (width !== undefined)
+        settings.width = width;
+    if (height !== undefined)
+        settings.height = height;
+    if (background !== undefined)
+        settings.backgroundColor = background;
+    return settings;
+}
+/** A document is anything with a `sketch` object and a `layerBindings` array. */
+const looksLikeDocument = (value) => isRecord(value) &&
+    isRecord(value.sketch) &&
+    Array.isArray(value.layerBindings);
+/**
+ * The document a target carries, unwrapping a `document` field (string or
+ * object) when there is one. Never throws — an unreadable document is a
+ * validation finding, not a crash.
+ */
+function documentOf(raw) {
+    // SAFETY: a target is read from a JSON file or a json column, so every
+    // branch below carries decoded JSON.
+    if (!isRecord(raw))
+        return raw;
+    const inner = raw.document;
+    if (isString(inner)) {
+        try {
+            return JSON.parse(inner);
+        }
+        catch {
+            return inner;
+        }
+    }
+    // SAFETY: same JSON provenance as the branch above.
+    if (inner !== undefined)
+        return inner;
+    return raw;
+}
+const layerType = (value) => value === "mask" || value === "group" ? value : "raster";
+/** Read a document as a canvas + layer stack, defaulting what is missing. */
+function asDocument(raw) {
+    const record = isRecord(raw) ? raw : {};
+    const sketch = isRecord(record.sketch) ? record.sketch : {};
+    const layers = [];
+    for (const entry of Array.isArray(sketch.layers) ? sketch.layers : []) {
+        if (!isRecord(entry) || !isString(entry.id))
+            continue;
+        layers.push({
+            id: entry.id,
+            name: isString(entry.name) ? entry.name : entry.id,
+            type: layerType(entry.type)
+        });
+    }
+    return {
+        version: numberOr(sketch.version) ?? 1,
+        canvas: settingsOf(sketch.canvas),
+        layers,
+        activeLayerId: isString(sketch.activeLayerId) ? sketch.activeLayerId : "",
+        maskLayerId: isString(sketch.maskLayerId) ? sketch.maskLayerId : null
+    };
+}
+/** Resolve a sketch target: a JSON file path or an image document row id. */
+export async function resolveSketchTarget(ref, deps) {
+    if (existsSync(ref)) {
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(ref, "utf8"));
+        }
+        catch (e) {
+            throw new Error(`${ref} is not valid JSON: ${e.message}`);
+        }
+        const raw = documentOf(parsed);
+        if (!looksLikeDocument(raw)) {
+            throw new Error(`${ref} is not an image document (no \`sketch\`/\`layerBindings\`, and no \`document\` field carrying them).`);
+        }
+        const name = isRecord(parsed) && isString(parsed.name)
+            ? parsed.name
+            : undefined;
+        const document = asDocument(raw);
+        const target = { kind: "file", ref };
+        if (name) {
+            target.name = name;
+        }
+        return {
+            target,
+            raw,
+            document,
+            // The wrapper's own width/height, never the canvas's: the validator
+            // compares the two, so folding one into the other hides the mismatch.
+            meta: settingsOf(parsed)
+        };
+    }
+    const record = await deps.loadDocument(ref);
+    if (!record) {
+        throw new Error(`Image document not found: ${ref}`);
+    }
+    const raw = documentOf(record);
+    const document = asDocument(raw);
+    const target = { kind: "id", ref };
+    if (record.name) {
+        target.name = record.name;
+    }
+    return {
+        target,
+        raw,
+        document,
+        meta: settingsOf(record)
+    };
+}
+//# sourceMappingURL=target.js.map

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

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

package/dist/stdin.d.ts

@@ -12,37 +12,36 @@
  *   /run <workflow_id> [json_params]  — run a workflow
  *   /stop                             — stop in-progress generation
  *   /reconnect <job_id>               — reconnect to a running job
- *   /resume <job_id>                  — resume a paused job
  *   /cancel <job_id>                  — cancel a running job
  *   /status [job_id]                  — get job/all-jobs status
+ *   /new                              — start a new chat session
+ *   /compact [instructions]           — summarize conversation into retained context
  *   /help                             — show available commands
  */
 import type { BaseProvider } from "@nodetool-ai/runtime";
-import type { Tool } from "@nodetool-ai/agents/tool";
+import { type PermissionMode } from "@nodetool-ai/agents";
 import type { NodeRegistry } from "@nodetool-ai/node-sdk";
-export interface StdinModeOptions {
+interface StdinModeOptions {
     provider: string;
     model: string;
     workspaceDir: string;
-    agentMode?: boolean;
-    /**
-     * Which planner to use when `agentMode` is true:
-     * - `"graph"` — GraphPlanner builds a workflow DAG (default when registry available).
-     * - `"multi"` — TaskPlanner builds a parallel task DAG of LLM steps.
-     */
-    agentPlanner?: "multi" | "graph";
     wsUrl?: string;
-    /** Pre-built tools (e.g. from --sandbox) appended to the Agent's tool list. */
-    extraTools?: Tool[];
-    /**
-     * NodeRegistry for graph-native agent mode. When supplied AND the planner
-     * is "graph", agent mode uses MultiModeAgent + GraphPlanner so the agent
-     * can build workflows with the curated `nodetool.*` core nodes and the
-     * `find_model` tool.
-     */
+    /** NodeRegistry — currently unused by the unified loop, kept for parity. */
     registry?: NodeRegistry;
-    /** Configured BaseProvider instances by id, exposed via `find_model`. */
+    /** Configured BaseProvider instances by id (passed through to subtasks). */
     agentProviders?: Record<string, BaseProvider>;
+    /**
+     * Expose the read-only `run_search` fan-out primitive alongside
+     * `run_subtask`. On by default; set `false` to remove it.
+     */
+    enableReadOnlySearch?: boolean;
+    /** `--permission-mode`. Unset runs `auto`: stdin is the input, not a user. */
+    permissionMode?: PermissionMode;
+    /** `--cost-cap <usd>`; `0` lifts the cap. Bounds each turn, as chat's does. */
+    costCap?: string;
+    /** `--timeout <s>`; `0` leaves the turn no time at all. */
+    timeout?: string;
 }
 export declare function runStdinMode(opts: StdinModeOptions): Promise<void>;
+export {};
 //# sourceMappingURL=stdin.d.ts.map

package/dist/stdin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../src/stdin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,sBAAsB,CAAC;AAIlE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAK1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAC/C;AA2JD,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2MxE"}
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../src/stdin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,sBAAsB,CAAC;AAW7E,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAW1D,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuJD,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6NxE"}