studiograph 1.3.48-next.26 → 1.3.48-next.261

package/dist/agent/tools/artifact-tools.js

@@ -0,0 +1,407 @@
+/**
+ * Artifact tools let the agent hand a renderable bundle to the web canvas.
+ * The active transport decides whether that bundle updates the currently
+ * scoped artifact entry or creates a new persisted artifact entry.
+ */
+import { createHash } from 'crypto';
+import { Type as T } from 'typebox';
+import { validateArtifactBundle } from '../../core/artifact-frame-model.js';
+import { applyArtifactPatch, ArtifactPatchError } from '../../core/artifact-patch.js';
+import { buildArtifactManifest } from '../../core/artifact-manifest.js';
+import { summarizeArtifactWrite } from '../../core/artifact-warnings.js';
+import { ArtifactRenderExportUnavailableError, inspectArtifactRender, inspectionToModelPayload, } from '../../services/artifact-render-export.js';
+import { wrapToolResult } from './graph-tools.js';
+/** Stable content hash of an artifact's stored body STRING (not the parsed
+ *  bundle), so `read_artifact` and the write-time guard hash the exact same
+ *  serialization — no canonicalization, no false mismatches from key reordering. */
+export function hashArtifactBody(body) {
+    return createHash('sha256').update(body, 'utf8').digest('hex').slice(0, 16);
+}
+/** Tool names whose results carry a truncation warning when the assistant turn
+ *  that emitted them stopped on the model's output-token cap. A whole bundle is
+ *  one streamed tool-call argument, so a capped turn cuts the JSON mid-content —
+ *  yet a partial bundle can still close validly and pass validation, so the
+ *  write "succeeds" silently. The agent must be told to verify + append. */
+export const ARTIFACT_WRITE_TOOL_NAMES = new Set(['create_artifact', 'patch_artifact']);
+/** The note appended to an artifact write's tool result when its turn was
+ *  output-capped. Exported for the orchestrator's afterToolCall wiring + tests. */
+export function artifactOutputTruncationNote(toolName) {
+    const verb = toolName === 'patch_artifact' ? 'patch' : 'write';
+    return ('\n\n⚠️ OUTPUT TRUNCATED: this response hit the model\'s output-token limit ' +
+        '(stopReason "length"), so the artifact ' + verb + ' above was very likely cut off ' +
+        'mid-content — a partial bundle can still close validly and save, so the saved ' +
+        'artifact may be missing frames or end mid-sentence. Do NOT assume it is complete. ' +
+        'Verify the rendered result with inspect_artifact, then APPEND the missing content ' +
+        'with patch_artifact, adding ONE frame or section per call. Do not re-emit the whole ' +
+        'large bundle in a single create_artifact — it will truncate again. For large ' +
+        'artifacts, author a skeleton first, then grow it with successive patch_artifact calls.');
+}
+/** Pure adapter for the afterToolCall hook: given the just-finished assistant
+ *  turn's stopReason, the tool name, and the tool result's content blocks, return
+ *  a replacement `{ content }` carrying the truncation note — or undefined when
+ *  the turn was not an output-capped artifact write (the common case, a no-op).
+ *  The note is folded into the last existing text block so the result stays a
+ *  single well-formed block; if there is none, it is added as a new block. */
+export function artifactTruncationToolResult(args) {
+    if (args.stopReason !== 'length')
+        return undefined;
+    if (!args.toolName || !ARTIFACT_WRITE_TOOL_NAMES.has(args.toolName))
+        return undefined;
+    const note = artifactOutputTruncationNote(args.toolName);
+    const blocks = Array.isArray(args.content) ? [...args.content] : [];
+    for (let i = blocks.length - 1; i >= 0; i--) {
+        if (blocks[i]?.type === 'text') {
+            blocks[i] = { ...blocks[i], text: `${blocks[i].text ?? ''}${note}` };
+            return { content: blocks };
+        }
+    }
+    blocks.push({ type: 'text', text: note.trimStart() });
+    return { content: blocks };
+}
+export function createArtifactTools(onArtifact, options = {}) {
+    const inspectArtifact = options.inspectArtifact ?? inspectArtifactRender;
+    return [
+        {
+            name: 'create_artifact',
+            label: 'Create Artifact',
+            description: 'Create or update a persisted sandboxed canvas artifact from an ordered list of frames (each a fragment of HTML/CSS/JS). Use this for DESIGNED, laid-out, visual outputs: slide decks, social graphics, prototypes, diagrams, whiteboards, and documents the user wants DESIGNED on letterhead / as a formatted PDF. A plain prose draft of a proposal, contract, memo, or report is a "document" ENTRY (create_entity), NOT an artifact — build a document artifact only when the user signals a designed/print output (on letterhead, a formatted PDF, "design a…"); when ambiguous, prefer the document entry or ask. Match the artifact TYPE to its frame structure: a slide DECK is N "slides" frames, one per slide (e.g. 1280×720); a designed DOCUMENT — a letter, contract, proposal, or report laid out on letterhead — is ONE "pages" frame whose content is the WHOLE document body at a fixed page size (US-Letter 816×1056; also Legal 816×1344, Tabloid 1056×1632, A4 794×1123, A3 1123×1587, A5 559×794): the platform flows the text across as many pages as needed, numbers them, and exports a real multi-page PDF — so do NOT set a document\'s height to "auto", do NOT split it into one frame per page, and do NOT build a page grid inside an "app"/"artboard" frame. Style the document as rich HTML/CSS; for repeating letterhead/headers/footers use standard CSS Paged Media in a shared CSS file (`@page` margin boxes + `position: running()` — a full-bleed branded band runs edge-to-edge if you set the side page margins to 0 and pad the body), which overrides the platform defaults. (The "furniture" + "pageMargins" frame fields are an optional shortcut for a plain inset header/footer.) A GRAPHIC, poster, or diagram is "artboard" frame(s) at a fixed size; an APP or prototype is a single "app" frame with fill geometry; a WHITEBOARD is a single "whiteboard" frame. Never hand-roll a stepper, filmstrip, pagination, or page grid inside one frame — emit the right frames and let the platform arrange, step, and paginate. When chat is scoped to an artifact entry, this updates that canvas. If the user references another EXISTING artifact entry, pass target.entityId and target.repo when known. To create a SEPARATE new artifact while the chat is scoped to one, pass createNew: true (optionally with target.repo to pick the destination folder) — the scoped canvas is left untouched. Otherwise this creates a new artifact entry. To EDIT an existing artifact, first call read_artifact to get the current source and its hash, modify the full bundle, and pass that hash as baseHash so a concurrent change is detected instead of silently overwritten. The result reports the resolved frame structure (manifest) and any warnings — check the frame count and per-frame layouts against what the user asked for (a deck is N "slides" frames, not one "app" frame) and fix it before responding.',
+            parameters: T.Object({
+                bundle: T.Object({}, {
+                    description: 'ArtifactBundle object with artifactId, title, and frames: an ordered, non-empty array of { id, title?, layout (slides|pages|artboard|app|whiteboard), geometry ({ width, height }), content (the frame\'s HTML fragment), background? (neutral|transparent|a safe CSS color or gradient — set it to the design\'s real surface so a dark/colored frame does not render white) }. A "pages" (document) frame also accepts furniture ({ header?: {first?,middle?,last?}, footer?: {first?,middle?,last?} } — per-page running header/footer for letterhead) and pageMargins ({ top?, right?, bottom?, left? } in px). Optional bundle-level: shared ({ files, head }) for code shared across frames, tokens (CSS design variables), libraries (three, d3, motion).',
+                    additionalProperties: true,
+                }),
+                target: T.Optional(T.Object({
+                    repo: T.Optional(T.String({ description: 'Folder/repo containing the artifact entry to update.' })),
+                    entityId: T.Optional(T.String({ description: 'Existing artifact entity id to update.' })),
+                }, {
+                    description: 'Optional existing artifact entry to update when the user references one outside the current canvas context.',
+                })),
+                baseHash: T.Optional(T.String({
+                    description: 'The hash returned by read_artifact for the version you edited. Required when updating an existing artifact — the update is rejected if the artifact changed since that read.',
+                })),
+                replace: T.Optional(T.Boolean({
+                    description: 'Set true to intentionally blank or wholesale-replace an existing artifact (bypasses the guard that blocks accidentally dropping its content).',
+                })),
+                createNew: T.Optional(T.Boolean({
+                    description: 'Set true to create a NEW artifact entry even when the chat is scoped to an existing artifact canvas (which is otherwise updated in place). Cannot be combined with target.entityId or baseHash. Combine with target.repo to pick the destination folder.',
+                })),
+            }),
+            execute: async (_toolCallId, params) => {
+                const result = validateArtifactBundle(params.bundle);
+                if (!result.ok || !result.bundle) {
+                    return wrapToolResult({
+                        success: false,
+                        error: 'Invalid artifact bundle',
+                        errors: result.errors,
+                        byteSize: result.byteSize,
+                    });
+                }
+                if (!onArtifact) {
+                    return wrapToolResult({
+                        success: false,
+                        error: 'No artifact canvas is available in this context',
+                    });
+                }
+                let location;
+                try {
+                    location = await onArtifact(result.bundle, params.target, { baseHash: params.baseHash, replace: params.replace, createNew: params.createNew });
+                }
+                catch (err) {
+                    // Surface stale-write / destructive-shrink rejections as a tool error
+                    // the agent can recover from (re-read, retry) rather than a thrown turn.
+                    return wrapToolResult({
+                        success: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+                if (!location) {
+                    return wrapToolResult({
+                        success: false,
+                        error: 'No artifact canvas is available in this context',
+                    });
+                }
+                // Return-rich (P4.3): attach the structural manifest + warnings so the
+                // agent can self-verify what it produced in this turn — e.g. notice that
+                // a "5-slide deck" came back as one `app` frame — without a Playwright
+                // render. Structure-only (no per-frame source), so it persists safely.
+                return wrapToolResult({
+                    success: true,
+                    location,
+                    // Summarize the bundle the store persisted (location.bundle) when the
+                    // callback provides it; fall back to the validated submission otherwise.
+                    ...summarizeArtifactWrite(location.bundle ?? result.bundle),
+                    message: `Created artifact: ${result.bundle.title}`,
+                });
+            },
+        },
+        {
+            name: 'inspect_artifact',
+            label: 'Inspect Artifact',
+            description: 'Use Playwright to visually inspect an ArtifactBundle or a persisted artifact target. Returns a page screenshot, per-frame metadata (id, layout, geometry, text, measured rendered height), optional individual frame screenshots, console messages, page errors, and failed requests. Crucially it reports framesOverflowing — frames whose content is taller than their declared height and is therefore CROPPED from view (something a structural read of the source cannot detect); fix those by setting the frame geometry.height to "auto" or splitting the content. (A "pages" document frame is never in this list — it flows/paginates instead of cropping, so do NOT set a document to height "auto".) Use this after creating or revising an artifact — especially a large or content-driven one — to verify layout, catch cropped/overflowing frames, and check individual frames/pages before responding. If the browser runtime is unavailable, it degrades to a browser-free structural summary from the frame model (which cannot measure rendered height or detect cropping).',
+            parameters: T.Object({
+                bundle: T.Optional(T.Object({}, {
+                    description: 'ArtifactBundle object to inspect before saving. If omitted, pass target or rely on the currently scoped artifact canvas.',
+                    additionalProperties: true,
+                })),
+                target: T.Optional(T.Object({
+                    repo: T.Optional(T.String({ description: 'Folder/repo containing the persisted artifact entry.' })),
+                    entityId: T.Optional(T.String({ description: 'Persisted artifact entity id to inspect.' })),
+                }, {
+                    description: 'Persisted artifact entry to inspect. If omitted while chat is scoped to an artifact, the current artifact is used.',
+                })),
+                context: T.Optional(T.Union([T.Literal('editor'), T.Literal('present')], {
+                    description: '"editor" lays every frame out in the canvas grid (all frames visible — the default); "present" renders the present stage (the first frame full-bleed).',
+                })),
+                frameIndexes: T.Optional(T.Array(T.Number(), {
+                    description: 'Specific zero-based frame/page indexes to screenshot.',
+                })),
+                maxFrames: T.Optional(T.Number({
+                    description: 'Maximum number of individual frames/pages to screenshot. Defaults to 6, max 24.',
+                })),
+                includePageScreenshot: T.Optional(T.Boolean({
+                    description: 'Whether to include a screenshot of the whole rendered page. Defaults to true.',
+                })),
+                includeFrameScreenshots: T.Optional(T.Boolean({
+                    description: 'Whether to include screenshots for selected frames/pages. Defaults to true.',
+                })),
+                screenshotFormat: T.Optional(T.Union([T.Literal('jpeg'), T.Literal('png')], {
+                    description: 'Screenshot encoding. Defaults to jpeg to keep tool results compact.',
+                })),
+            }),
+            execute: async (_toolCallId, params) => {
+                let bundle;
+                if (params.bundle !== undefined) {
+                    const result = validateArtifactBundle(params.bundle);
+                    if (!result.ok || !result.bundle) {
+                        return wrapToolResult({
+                            success: false,
+                            error: 'Invalid artifact bundle',
+                            errors: result.errors,
+                            byteSize: result.byteSize,
+                        });
+                    }
+                    bundle = result.bundle;
+                }
+                else if (options.readArtifact) {
+                    try {
+                        bundle = (await options.readArtifact(params.target)).bundle;
+                    }
+                    catch (err) {
+                        return wrapToolResult({
+                            success: false,
+                            error: err instanceof Error ? err.message : String(err),
+                        });
+                    }
+                }
+                else {
+                    return wrapToolResult({
+                        success: false,
+                        error: 'No artifact bundle or readable artifact target was provided',
+                    });
+                }
+                try {
+                    // Resolve headless-render asset access so workspace `/api/assets/...`
+                    // images load instead of rendering as broken-image placeholders (the
+                    // false "asset no longer available"). Best-effort: null degrades to the
+                    // prior no-asset render.
+                    const assetAccess = options.resolveInspectAssets?.(params.target, bundle) ?? null;
+                    const inspection = await inspectArtifact(bundle, {
+                        context: params.context,
+                        frameIndexes: params.frameIndexes,
+                        maxFrames: params.maxFrames,
+                        includePageScreenshot: params.includePageScreenshot,
+                        includeFrameScreenshots: params.includeFrameScreenshots,
+                        screenshotFormat: params.screenshotFormat,
+                        ...(assetAccess ? { baseUrl: assetAccess.baseUrl, assetToken: assetAccess.assetToken } : {}),
+                    });
+                    // Return screenshots as real IMAGE content blocks (vision) instead of
+                    // base64 embedded in text: the model actually SEES the frames, for
+                    // ~1.6k tokens/image instead of ~300k. The text block carries only the
+                    // compact metadata (dims, rects, console, errors) — no base64.
+                    const { metadata, images } = inspectionToModelPayload(inspection);
+                    const result = { success: true, inspection: metadata };
+                    return {
+                        content: [
+                            { type: 'text', text: JSON.stringify(result, null, 2) },
+                            ...images.map((img) => ({ type: 'image', data: img.data, mimeType: img.mimeType })),
+                        ],
+                        details: result,
+                    };
+                }
+                catch (err) {
+                    if (err instanceof ArtifactRenderExportUnavailableError) {
+                        // Browser unavailable (installing on a fresh deploy, or not
+                        // installed): the frame model already carries the structure, so
+                        // degrade to a browser-free summary. `degraded` carries why.
+                        const result = {
+                            success: true,
+                            degraded: true,
+                            inspection: buildArtifactManifest(bundle),
+                            note: `VISUAL INSPECTION UNAVAILABLE — the browser render runtime could not run (${err.message}). This is a STRUCTURAL-ONLY summary from the frame model: it CANNOT measure rendered height, detect cropped/overflowing frames, or verify visual layout. You are effectively blind to how this renders — do NOT report the artifact as visually verified or claim its layout/pagination is correct.`,
+                        };
+                        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], details: result };
+                    }
+                    return wrapToolResult({
+                        success: false,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            },
+        },
+        {
+            name: 'read_artifact',
+            label: 'Read Artifact',
+            description: 'Return the current source of a persisted artifact: its full ArtifactBundle plus a `hash` you MUST pass back to create_artifact as `baseHash` when saving an edit (so a concurrent change is detected rather than silently overwritten). When chat is scoped to an artifact, omit target to read the current canvas; otherwise pass target.repo and target.entityId. Call this before editing an existing artifact — its source is not kept in the conversation, so read it fresh each time you need to modify it.',
+            parameters: T.Object({
+                target: T.Optional(T.Object({
+                    repo: T.Optional(T.String({ description: 'Folder/repo containing the persisted artifact entry.' })),
+                    entityId: T.Optional(T.String({ description: 'Persisted artifact entity id to read.' })),
+                }, {
+                    description: 'Persisted artifact entry to read. If omitted while chat is scoped to an artifact, the current artifact is used.',
+                })),
+            }),
+            execute: async (_toolCallId, params) => {
+                if (!options.readArtifact) {
+                    return wrapToolResult({ success: false, error: 'No readable artifact is available in this context' });
+                }
+                try {
+                    const { bundle, hash, updatedAt } = await options.readArtifact(params.target);
+                    return wrapToolResult({ success: true, hash, updatedAt, bundle });
+                }
+                catch (err) {
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : String(err) });
+                }
+            },
+        },
+        {
+            name: 'patch_artifact',
+            label: 'Patch Artifact',
+            description: 'Edit ONE frame (or a shared file / the token map) of an existing artifact WITHOUT re-emitting the whole bundle — the efficient way to revise a large artifact. To find which frame to edit cheaply, call get_artifact_manifest (it returns frame ids + a keyText snippet + the hash without the full source). Then pass that hash as baseHash so a concurrent change is detected instead of overwritten, and an ordered list of ops. (For find/replace ops, read the frame content first — via read_artifact or get_artifact_manifest with frameId.) Ops apply in order to the current bundle, then the result is validated and saved as one revision. Ops: '
+                + 'set_frame_content { frameId, content } — replace a frame\'s HTML; '
+                + 'patch_frame_content { frameId, find, replace, expectedCount? } — replace every occurrence of an exact substring within ONE frame (cannot touch other frames); '
+                + 'set_frame_meta { frameId, title?, layout?, geometry?, background? } — change a frame\'s metadata (empty title/background clears it); '
+                + 'add_frame { frame, atIndex? } — insert a new frame ({ id, layout, geometry, content, ... }); '
+                + 'remove_frame { frameId }; '
+                + 'reorder_frames { order } — order is a permutation of all current frame ids; '
+                + 'set_shared_file { path, content } / remove_shared_file { path }; '
+                + 'set_tokens { tokens } — replace the design-variable map. '
+                + 'Any frame you add_frame must follow the same per-type structure as create_artifact (a document is ONE "pages" frame the platform flows across pages — never one frame per page, never a page grid inside an "app"/"artboard" frame). '
+                + 'For a whole-bundle rewrite or to create a new artifact, use create_artifact instead. '
+                + 'The result reports the resolved frame structure (manifest) and any warnings — check them against the user\'s intent and fix before responding.',
+            parameters: T.Object({
+                target: T.Optional(T.Object({
+                    repo: T.Optional(T.String({ description: 'Folder/repo containing the artifact entry to patch.' })),
+                    entityId: T.Optional(T.String({ description: 'Existing artifact entity id to patch.' })),
+                }, {
+                    description: 'Persisted artifact entry to patch. If omitted while chat is scoped to an artifact, the current canvas is patched.',
+                })),
+                baseHash: T.String({
+                    description: 'REQUIRED: the hash returned by read_artifact for the version your ops target. The patch is rejected (re-read and retry) if the artifact changed since that read.',
+                }),
+                ops: T.Array(T.Object({}, { additionalProperties: true }), {
+                    description: 'Ordered, non-empty list of patch operations. Each is an object with an `op` field: set_frame_content | patch_frame_content | set_frame_meta | add_frame | remove_frame | reorder_frames | set_shared_file | remove_shared_file | set_tokens.',
+                }),
+            }),
+            execute: async (_toolCallId, params) => {
+                if (!onArtifact || !options.readArtifact) {
+                    return wrapToolResult({ success: false, error: 'No artifact canvas is available in this context' });
+                }
+                if (!params.baseHash) {
+                    return wrapToolResult({ success: false, error: 'patch_artifact requires baseHash — call read_artifact first and pass the hash it returns.' });
+                }
+                // Load the CURRENT source (live editor body preferred — same as
+                // read_artifact) and verify the agent's ops were computed against it.
+                // The find/replace ops must run on the exact version the agent read, or
+                // they could match the wrong text — so reject early on drift; the store's
+                // OCC + the in-lock disk check then close the remaining race.
+                let current;
+                try {
+                    current = await options.readArtifact(params.target);
+                }
+                catch (err) {
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : String(err) });
+                }
+                if (params.baseHash !== current.hash) {
+                    return wrapToolResult({
+                        success: false,
+                        error: 'Artifact changed since you read it (baseHash mismatch). Call read_artifact again, recompute your ops against the current source, then retry.',
+                    });
+                }
+                let applied;
+                try {
+                    applied = applyArtifactPatch(current.bundle, params.ops);
+                }
+                catch (err) {
+                    if (err instanceof ArtifactPatchError) {
+                        return wrapToolResult({ success: false, error: err.message });
+                    }
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : String(err) });
+                }
+                let location;
+                try {
+                    location = await onArtifact(applied.bundle, params.target, { baseHash: params.baseHash });
+                }
+                catch (err) {
+                    // Stale-write / validation rejections come back as recoverable tool
+                    // errors (re-read, retry), mirroring create_artifact.
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : String(err) });
+                }
+                if (!location) {
+                    return wrapToolResult({ success: false, error: 'No artifact canvas is available in this context' });
+                }
+                // Return-rich (P4.3): the change summary PLUS the full resolved structure
+                // (manifest) + warnings, so the agent verifies the patched result matches
+                // intent in the same turn. `manifest.frameCount` replaces the standalone
+                // field. Structure-only (no per-frame source) → persists safely.
+                return wrapToolResult({
+                    success: true,
+                    location,
+                    changedFrameIds: applied.changedFrameIds,
+                    removedFrameIds: applied.removedFrameIds,
+                    reordered: applied.reordered,
+                    // Persisted bundle (location.bundle) over the pre-validation patch result,
+                    // so the manifest reflects normalized geometry — matching the MCP surface.
+                    ...summarizeArtifactWrite(location.bundle ?? applied.bundle),
+                    message: `Patched artifact: ${applied.changedFrameIds.length} frame(s) changed${applied.removedFrameIds.length ? `, ${applied.removedFrameIds.length} removed` : ''}.`,
+                });
+            },
+        },
+        {
+            name: 'get_artifact_manifest',
+            label: 'Get Artifact Manifest',
+            description: 'Read an artifact\'s STRUCTURE cheaply, without pulling its full source — the fast way to find which frame to edit before patch_artifact. Returns each frame\'s index, id, title, layout, geometry, a short keyText snippet (so you can recognize the frame), contentChars, plus the artifact `hash` (pass it to patch_artifact as baseHash). No browser, always available. Pass a `frameId` to also get that ONE frame\'s full content (the targeted read before a patch_frame_content). For the WHOLE bundle use read_artifact; for a visual render use inspect_artifact.',
+            parameters: T.Object({
+                target: T.Optional(T.Object({
+                    repo: T.Optional(T.String({ description: 'Folder/repo containing the artifact entry.' })),
+                    entityId: T.Optional(T.String({ description: 'Persisted artifact entity id.' })),
+                }, {
+                    description: 'Persisted artifact entry to read. If omitted while chat is scoped to an artifact, the current canvas is used.',
+                })),
+                frameId: T.Optional(T.String({
+                    description: 'If set, include this one frame\'s full HTML content in its manifest entry (for a targeted patch_frame_content). Errors if no frame has this id.',
+                })),
+            }),
+            execute: async (_toolCallId, params) => {
+                if (!options.readArtifact) {
+                    return wrapToolResult({ success: false, error: 'No readable artifact is available in this context' });
+                }
+                let read;
+                try {
+                    read = await options.readArtifact(params.target);
+                }
+                catch (err) {
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : String(err) });
+                }
+                try {
+                    const manifest = buildArtifactManifest(read.bundle, { frameId: params.frameId });
+                    return wrapToolResult({ success: true, hash: read.hash, updatedAt: read.updatedAt, ...manifest });
+                }
+                catch (err) {
+                    // Unknown frameId → recoverable tool error (lists existing ids).
+                    return wrapToolResult({ success: false, error: err instanceof Error ? err.message : String(err) });
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=artifact-tools.js.map

package/dist/agent/tools/artifact-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-tools.js","sourceRoot":"","sources":["../../../src/agent/tools/artifact-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAuB,MAAM,oCAAoC,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACL,oCAAoC,EACpC,qBAAqB,EACrB,wBAAwB,GAGzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAwDlD;;oFAEoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED;;;;4EAI4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAExF;mFACmF;AACnF,MAAM,UAAU,4BAA4B,CAAC,QAAgB;IAC3D,MAAM,IAAI,GAAG,QAAQ,KAAK,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC/D,OAAO,CACL,6EAA6E;QAC7E,yCAAyC,GAAG,IAAI,GAAG,iCAAiC;QACpF,gFAAgF;QAChF,oFAAoF;QACpF,oFAAoF;QACpF,sFAAsF;QACtF,+EAA+E;QAC/E,wFAAwF,CACzF,CAAC;AACJ,CAAC;AAID;;;;;8EAK8E;AAC9E,MAAM,UAAU,4BAA4B,CAAC,IAI5C;IACC,IAAI,IAAI,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IACtF,MAAM,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,MAAM,GAAsB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAI,IAAI,CAAC,OAA6B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9G,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACtD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAmBD,MAAM,UAAU,mBAAmB,CAAC,UAAoC,EAAE,UAA+B,EAAE;IACzG,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,qBAAqB,CAAC;IACzE,OAAO;QACL;YACE,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,iBAAiB;YACxB,WAAW,EACT,2yFAA2yF;YAC7yF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE;oBACnB,WAAW,EAAE,kuBAAkuB;oBAC/uB,oBAAoB,EAAE,IAAI;iBAC3B,CAAC;gBACF,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC,CAAC;oBACnG,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC,CAAC;iBAC1F,EAAE;oBACD,WAAW,EAAE,6GAA6G;iBAC3H,CAAC,CAAC;gBACH,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC5B,WAAW,EAAE,8KAA8K;iBAC5L,CAAC,CAAC;gBACH,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;oBAC5B,WAAW,EAAE,+IAA+I;iBAC7J,CAAC,CAAC;gBACH,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;oBAC9B,WAAW,EAAE,0PAA0P;iBACxQ,CAAC,CAAC;aACJ,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAoH,EAAE,EAAE;gBAC3J,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBACjC,OAAO,cAAc,CAAC;wBACpB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,yBAAyB;wBAChC,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO,cAAc,CAAC;wBACpB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,iDAAiD;qBACzD,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,QAAQ,CAAC;gBACb,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBACjJ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,sEAAsE;oBACtE,yEAAyE;oBACzE,OAAO,cAAc,CAAC;wBACpB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACxD,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO,cAAc,CAAC;wBACpB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,iDAAiD;qBACzD,CAAC,CAAC;gBACL,CAAC;gBACD,uEAAuE;gBACvE,yEAAyE;gBACzE,uEAAuE;gBACvE,uEAAuE;gBACvE,OAAO,cAAc,CAAC;oBACpB,OAAO,EAAE,IAAI;oBACb,QAAQ;oBACR,sEAAsE;oBACtE,yEAAyE;oBACzE,GAAG,sBAAsB,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;oBAC3D,OAAO,EAAE,qBAAqB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;iBACpD,CAAC,CAAC;YACL,CAAC;SACF;QACD;YACE,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,kBAAkB;YACzB,WAAW,EACT,+hCAA+hC;YACjiC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE;oBAC9B,WAAW,EAAE,0HAA0H;oBACvI,oBAAoB,EAAE,IAAI;iBAC3B,CAAC,CAAC;gBACH,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC,CAAC;oBACnG,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC,CAAC;iBAC5F,EAAE;oBACD,WAAW,EAAE,oHAAoH;iBAClI,CAAC,CAAC;gBACH,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE;oBACvE,WAAW,EAAE,wJAAwJ;iBACtK,CAAC,CAAC;gBACH,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE;oBAC3C,WAAW,EAAE,uDAAuD;iBACrE,CAAC,CAAC;gBACH,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC7B,WAAW,EAAE,iFAAiF;iBAC/F,CAAC,CAAC;gBACH,qBAAqB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;oBAC1C,WAAW,EAAE,+EAA+E;iBAC7F,CAAC,CAAC;gBACH,uBAAuB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;oBAC5C,WAAW,EAAE,6EAA6E;iBAC3F,CAAC,CAAC;gBACH,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE;oBAC1E,WAAW,EAAE,qEAAqE;iBACnF,CAAC,CAAC;aACJ,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MASpC,EAAE,EAAE;gBACH,IAAI,MAAsB,CAAC;gBAC3B,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAChC,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACrD,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;wBACjC,OAAO,cAAc,CAAC;4BACpB,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,yBAAyB;4BAChC,MAAM,EAAE,MAAM,CAAC,MAAM;4BACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;yBAC1B,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gBACzB,CAAC;qBAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;oBAChC,IAAI,CAAC;wBACH,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC9D,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,cAAc,CAAC;4BACpB,OAAO,EAAE,KAAK;4BACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,OAAO,cAAc,CAAC;wBACpB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,6DAA6D;qBACrE,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,CAAC;oBACH,sEAAsE;oBACtE,qEAAqE;oBACrE,wEAAwE;oBACxE,yBAAyB;oBACzB,MAAM,WAAW,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;oBAClF,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE;wBAC/C,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,YAAY,EAAE,MAAM,CAAC,YAAY;wBACjC,SAAS,EAAE,MAAM,CAAC,SAAS;wBAC3B,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;wBACnD,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;wBACvD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;wBACzC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC7F,CAAC,CAAC;oBACH,sEAAsE;oBACtE,mEAAmE;oBACnE,uEAAuE;oBACvE,+DAA+D;oBAC/D,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;oBAClE,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,IAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;oBAChE,OAAO;wBACL,OAAO,EAAE;4BACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;4BAChE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;yBAC7F;wBACD,OAAO,EAAE,MAAM;qBAChB,CAAC;gBACJ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,GAAG,YAAY,oCAAoC,EAAE,CAAC;wBACxD,4DAA4D;wBAC5D,gEAAgE;wBAChE,6DAA6D;wBAC7D,MAAM,MAAM,GAAG;4BACb,OAAO,EAAE,IAAa;4BACtB,QAAQ,EAAE,IAAa;4BACvB,UAAU,EAAE,qBAAqB,CAAC,MAAM,CAAC;4BACzC,IAAI,EAAE,6EAA6E,GAAG,CAAC,OAAO,sSAAsS;yBACrY,CAAC;wBACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;oBAC1G,CAAC;oBACD,OAAO,cAAc,CAAC;wBACpB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF;QACD;YACE,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,eAAe;YACtB,WAAW,EACT,mfAAmf;YACrf,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sDAAsD,EAAE,CAAC,CAAC;oBACnG,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC,CAAC;iBACzF,EAAE;oBACD,WAAW,EAAE,iHAAiH;iBAC/H,CAAC,CAAC;aACJ,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAuC,EAAE,EAAE;gBAC9E,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;oBAC1B,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC,CAAC;gBACxG,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC9E,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;gBACpE,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;YACH,CAAC;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,gBAAgB;YACvB,WAAW,EACT,8nBAA8nB;kBAC5nB,oEAAoE;kBACpE,gKAAgK;kBAChK,uIAAuI;kBACvI,+FAA+F;kBAC/F,4BAA4B;kBAC5B,8EAA8E;kBAC9E,mEAAmE;kBACnE,2DAA2D;kBAC3D,uOAAuO;kBACvO,uFAAuF;kBACvF,gJAAgJ;YACpJ,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC,CAAC;oBAClG,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC,CAAC;iBACzF,EAAE;oBACD,WAAW,EAAE,mHAAmH;iBACjI,CAAC,CAAC;gBACH,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;oBACjB,WAAW,EAAE,kKAAkK;iBAChL,CAAC;gBACF,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,EAAE;oBACzD,WAAW,EAAE,8OAA8O;iBAC5P,CAAC;aACH,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAyE,EAAE,EAAE;gBAChH,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;oBACzC,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC,CAAC;gBACtG,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACrB,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,2FAA2F,EAAE,CAAC,CAAC;gBAChJ,CAAC;gBAED,gEAAgE;gBAChE,sEAAsE;gBACtE,wEAAwE;gBACxE,0EAA0E;gBAC1E,8DAA8D;gBAC9D,IAAI,OAAO,CAAC;gBACZ,IAAI,CAAC;oBACH,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACtD,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;gBACD,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrC,OAAO,cAAc,CAAC;wBACpB,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,8IAA8I;qBACtJ,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,OAAO,CAAC;gBACZ,IAAI,CAAC;oBACH,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3D,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,GAAG,YAAY,kBAAkB,EAAE,CAAC;wBACtC,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;oBAChE,CAAC;oBACD,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;gBAED,IAAI,QAAQ,CAAC;gBACb,IAAI,CAAC;oBACH,QAAQ,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC5F,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,oEAAoE;oBACpE,sDAAsD;oBACtD,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;gBACD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,iDAAiD,EAAE,CAAC,CAAC;gBACtG,CAAC;gBACD,0EAA0E;gBAC1E,0EAA0E;gBAC1E,yEAAyE;gBACzE,iEAAiE;gBACjE,OAAO,cAAc,CAAC;oBACpB,OAAO,EAAE,IAAI;oBACb,QAAQ;oBACR,eAAe,EAAE,OAAO,CAAC,eAAe;oBACxC,eAAe,EAAE,OAAO,CAAC,eAAe;oBACxC,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,2EAA2E;oBAC3E,2EAA2E;oBAC3E,GAAG,sBAAsB,CAAC,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;oBAC5D,OAAO,EAAE,qBAAqB,OAAO,CAAC,eAAe,CAAC,MAAM,oBAAoB,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,MAAM,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG;iBACvK,CAAC,CAAC;YACL,CAAC;SACF;QACD;YACE,IAAI,EAAE,uBAAuB;YAC7B,KAAK,EAAE,uBAAuB;YAC9B,WAAW,EACT,4iBAA4iB;YAC9iB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC1B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC,CAAC;oBACzF,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC,CAAC;iBACjF,EAAE;oBACD,WAAW,EAAE,+GAA+G;iBAC7H,CAAC,CAAC;gBACH,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;oBAC3B,WAAW,EAAE,iJAAiJ;iBAC/J,CAAC,CAAC;aACJ,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAyD,EAAE,EAAE;gBAChG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;oBAC1B,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,mDAAmD,EAAE,CAAC,CAAC;gBACxG,CAAC;gBACD,IAAI,IAAI,CAAC;gBACT,IAAI,CAAC;oBACH,IAAI,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACnD,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;oBACjF,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;gBACpG,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,iEAAiE;oBACjE,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,CAAC;YACH,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/agent/tools/capture-tools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Capture-flow Tools for Studiograph Agent
+ *
+ * Single tool used by the quick-capture surface (POST /api/capture[/stream]).
+ * When the agent decides nothing in the user's input is worth saving as an
+ * entity, it calls `nothing_to_capture(reason)` and stops. The server
+ * captures the structured reason and surfaces it in the toast — no freeform
+ * assistant prose, no followup-suggestion marker leaking through.
+ *
+ * The tool is registered globally on every agent (so the Anthropic tool
+ * schema is consistent across sessions), but it's only meaningful when the
+ * capture flow has wired up `onNothingToCapture` in the AgentContext. In
+ * other contexts the callback is absent and the tool is effectively a
+ * no-op confirming back to the agent.
+ */
+import { Type as T } from 'typebox';
+export declare function createCaptureTools(onNothingToCapture: () => ((reason: string) => void) | null | undefined): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: T.TObject<{
+        reason: T.TString;
+    }>;
+    execute: (_toolCallId: string, params: any) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: any;
+    }>;
+}[];

package/dist/agent/tools/capture-tools.js

@@ -0,0 +1,40 @@
+/**
+ * Capture-flow Tools for Studiograph Agent
+ *
+ * Single tool used by the quick-capture surface (POST /api/capture[/stream]).
+ * When the agent decides nothing in the user's input is worth saving as an
+ * entity, it calls `nothing_to_capture(reason)` and stops. The server
+ * captures the structured reason and surfaces it in the toast — no freeform
+ * assistant prose, no followup-suggestion marker leaking through.
+ *
+ * The tool is registered globally on every agent (so the Anthropic tool
+ * schema is consistent across sessions), but it's only meaningful when the
+ * capture flow has wired up `onNothingToCapture` in the AgentContext. In
+ * other contexts the callback is absent and the tool is effectively a
+ * no-op confirming back to the agent.
+ */
+import { Type as T } from 'typebox';
+import { wrapToolResult } from './graph-tools.js';
+export function createCaptureTools(onNothingToCapture) {
+    return [
+        {
+            name: 'nothing_to_capture',
+            label: 'Nothing to Capture',
+            description: 'Use ONLY in the quick-capture flow when the user\'s input contains no substantive content worth saving as an entity (e.g. an error page, an empty URL fetch, a redirect-only page, or pure noise). Call this with a brief one-line reason and STOP — do not produce any assistant text after, do not emit followups. Do not use this when the input is a normal note or article you should save: in that case call create_entity instead.',
+            parameters: T.Object({
+                reason: T.String({ description: 'One short sentence explaining why nothing is worth capturing. Shown to the user verbatim.' }),
+            }),
+            execute: async (_toolCallId, params) => {
+                const reason = String(params?.reason ?? '').trim();
+                if (!reason) {
+                    return wrapToolResult({ success: false, error: 'reason is required' });
+                }
+                const cb = onNothingToCapture();
+                if (cb)
+                    cb(reason);
+                return wrapToolResult({ success: true, recorded: true });
+            },
+        },
+    ];
+}
+//# sourceMappingURL=capture-tools.js.map

package/dist/agent/tools/capture-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-tools.js","sourceRoot":"","sources":["../../../src/agent/tools/capture-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,kBAAkB,CAChC,kBAAuE;IAEvE,OAAO;QACL;YACE,IAAI,EAAE,oBAAoB;YAC1B,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EAAE,2aAA2a;YACxb,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2FAA2F,EAAE,CAAC;aAC/H,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAW,EAAE,EAAE;gBAClD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACnD,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;gBACzE,CAAC;gBACD,MAAM,EAAE,GAAG,kBAAkB,EAAE,CAAC;gBAChC,IAAI,EAAE;oBAAE,EAAE,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/agent/tools/folder-tools.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Folder Management Tools for the Studiograph Agent
+ *
+ * Five tools that let the agent operate on the folder layout within a repo:
+ *   - list_folders     — read the folder tree of a repo
+ *   - create_subfolder — create a new subfolder inside an existing repo
+ *                        (distinct from graph-tools' `create_folder`, which
+ *                        creates a brand-new top-level repo)
+ *   - rename_folder    — rename / move within the same repo
+ *   - move_entity      — relocate an entry to a different folder within the
+ *                        same repo (distinct from graph-tools'
+ *                        `transfer_entity`, which moves across repos)
+ *   - delete_folder    — remove a SUBFOLDER (recursive opt-in, blast-radius reported)
+ *   - archive_repo     — reversibly hide an ENTIRE top-level folder (lossless,
+ *                        flag-based; agents never permanently delete a repo)
+ *   - unarchive_repo   — restore an archived folder
+ *
+ * The system prompt restraint rule applies to all of these:
+ * never reorganize/rename/delete/archive without explicit user request.
+ */
+import { Type as T } from 'typebox';
+import { WorkspaceManager } from '../../core/workspace-manager.js';
+import { type AuthUser, type AuthService } from '../../services/auth-service.js';
+import type { MutationEvent } from './graph-tools.js';
+export declare function createFolderTools(workspaceManager: WorkspaceManager, gitUser: {
+    id: string;
+    name: string;
+    email: string;
+}, onMutation?: (m: MutationEvent) => void, getCurrentUser?: () => AuthUser | null, authService?: AuthService | null, 
+/**
+ * Same activity hook as createGraphTools. Currently accepted but not wrapped
+ * around individual folder ops — folder mutations are rare relative to entity
+ * mutations, and the chip wouldn't have time to render before completing.
+ * Param exists so the orchestrator can pass a single callback symmetrically.
+ */
+_onAgentActivity?: (action: 'enter' | 'leave' | 'heartbeat', repo: string) => void): {
+    name: string;
+    label: string;
+    description: string;
+    parameters: T.TObject<{
+        repo: T.TString;
+    }>;
+    execute: (_toolCallId: string, params: any) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: any;
+    }>;
+}[];