@aexol/spectral 0.9.230 → 0.9.234

package/CHANGELOG.md

@@ -5,6 +5,8 @@ All notable changes to `@aexol/spectral` are documented here. Format follows
 
 ## [Unreleased]
 
+## [0.9.231] - 2026-09-23
+
 ### Added
 
 - Added built-in `web_fetch` tool for fetching public web pages as text,

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAIX,SAAS,EAET,MAAM,4BAA4B,CAAC;AAqBpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAKrB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACN,KAAK,WAAW,EAKhB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQrD,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,6CAA6C,CAAC;AAuGxG;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC,GACpF,MAAM,CAYR;AA4JD;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,cAAc,CAAC,CAe5D;AA6BD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,GACnB,SAAS,EAAE,CAwCb;AAqHD,2FAA2F;AAC3F,wBAAgB,+BAA+B,CAC9C,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GACtD,IAAI,CAEN;AAmBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC9D,MAAM,CAiBR;AA8eD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IACN,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,IAAI,CA2aN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAIX,SAAS,EAET,MAAM,4BAA4B,CAAC;AAqBpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAKrB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACN,KAAK,WAAW,EAKhB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQrD,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,6CAA6C,CAAC;AAyGxG;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC,GACpF,MAAM,CAYR;AAiMD;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,cAAc,CAAC,CAe5D;AA6BD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,GACnB,SAAS,EAAE,CAwCb;AAqHD,2FAA2F;AAC3F,wBAAgB,+BAA+B,CAC9C,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GACtD,IAAI,CAEN;AAmBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC9D,MAAM,CAiBR;AAogBD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IACN,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,IAAI,CAqcN"}

package/dist/agent/index.js

@@ -53,6 +53,8 @@ import { compressSubagentToolResult } from "../memory/tool-output-compressor.js"
 // ---------------------------------------------------------------------------
 const MAX_PARALLEL_TASKS = 8;
 const MAX_CONCURRENCY = 4;
+/** Max steps in a chain call, mirroring the parallel batch cap. */
+const MAX_CHAIN_STEPS = 8;
 /**
  * Per-subagent timeout. Each subagent invocation (single, parallel, chain)
  * gets its own independent deadline so that no single subagent can
@@ -197,6 +199,40 @@ function truncateOutput(text, limit) {
     }
     return text;
 }
+/** Levenshtein edit distance between two strings (dependency-free). */
+function levenshtein(a, b) {
+    const dp = [];
+    for (let i = 0; i <= a.length; i++)
+        dp[i] = [i];
+    for (let j = 0; j <= b.length; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[a.length][b.length];
+}
+/**
+ * Suggests the closest known agent name for an unknown one.
+ * Case-insensitive prefix/substring match first, then Levenshtein ≤ 2.
+ */
+function suggestAgentName(unknownName, agents) {
+    const target = unknownName.toLowerCase();
+    let best;
+    for (const agent of agents) {
+        const name = agent.name.toLowerCase();
+        if (name.startsWith(target) || name.includes(target) || target.includes(name)) {
+            return agent.name;
+        }
+        const distance = levenshtein(target, name);
+        if (distance <= 2 && (!best || distance < best.distance)) {
+            best = { name: agent.name, distance };
+        }
+    }
+    return best?.name;
+}
 // ---------------------------------------------------------------------------
 // Helpers — model resolution
 // ---------------------------------------------------------------------------
@@ -441,14 +477,15 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
     const normalizedAgentName = agentName.replace(/^@/, "");
     const agent = agents.find((a) => a.name === normalizedAgentName);
     if (!agent) {
-        const available = agents.map((a) => `"${a.name}"`).join(", ") || "none";
+        const available = agents.map((a) => `${a.name} (${a.source})`).join(", ") || "none";
+        const suggestion = suggestAgentName(normalizedAgentName, agents);
         return {
             agent: agentName,
             agentSource: "unknown",
             task,
             exitCode: 1,
             messages: [],
-            stderr: `Unknown agent: "${agentName}". Available agents: ${available}.`,
+            stderr: `Unknown agent: "${agentName}". Available agents: ${available}.${suggestion ? ` Did you mean "${suggestion}"?` : ""}`,
             usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, contextTokens: 0, turns: 0 },
             step,
         };
@@ -788,14 +825,20 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
 // Tool parameter schemas
 // ---------------------------------------------------------------------------
 const TaskItem = Type.Object({
-    agent: Type.String({ description: "Name of the agent to invoke" }),
-    task: Type.String({ description: "Task to delegate to the agent" }),
+    agent: Type.String({
+        description: "Known agent name to invoke (use names from the available agents list)",
+    }),
+    task: Type.String({
+        description: "Full self-contained prompt text for the agent (plain string; subagents share no context with the caller)",
+    }),
     cwd: Type.Optional(Type.String({ description: "Working directory for the agent process" })),
 });
 const ChainItem = Type.Object({
-    agent: Type.String({ description: "Name of the agent to invoke" }),
+    agent: Type.String({
+        description: "Known agent name to invoke (use names from the available agents list)",
+    }),
     task: Type.String({
-        description: "Task with optional {previous} placeholder for prior output",
+        description: "Full self-contained prompt text with an optional {previous} placeholder, substituted with the previous step's output",
     }),
     cwd: Type.Optional(Type.String({ description: "Working directory for the agent process" })),
 });
@@ -804,13 +847,19 @@ const AgentScopeSchema = StringEnum(["user", "project", "both"], {
     default: "both",
 });
 const SubagentParams = Type.Object({
-    agent: Type.Optional(Type.String({ description: "Name of the agent to invoke (for single mode)" })),
-    task: Type.Optional(Type.String({ description: "Task to delegate (for single mode)" })),
+    agent: Type.Optional(Type.String({
+        description: "Known agent name to invoke (single mode; use names from the available agents list)",
+    })),
+    task: Type.Optional(Type.String({
+        description: "Full self-contained prompt text to delegate (single mode; plain string, subagents share no context with the caller)",
+    })),
     tasks: Type.Optional(Type.Array(TaskItem, {
-        description: "Array of {agent, task} for parallel execution",
+        description: "Parallel batch of {agent, task} items for independent tasks (max 8, 4 run concurrently)",
+        minItems: 1,
     })),
     chain: Type.Optional(Type.Array(ChainItem, {
-        description: "Array of {agent, task} for sequential execution",
+        description: "Sequential steps of {agent, task}; {previous} substitutes the previous step's output (max 8 steps)",
+        minItems: 1,
     })),
     agentScope: Type.Optional(AgentScopeSchema),
     confirmProjectAgents: Type.Optional(Type.Boolean({
@@ -837,11 +886,19 @@ export default function subagentExtension(ext, opts) {
             "Delegate tasks to specialized subagents with isolated context.",
             "Modes: single (agent + task), parallel (tasks array), chain (sequential with {previous} placeholder).",
             'Default agent scope is "both" (user agents from ~/.spectral/agent/agents + project agents from .spectral/agents).',
-            'Set agentScope: "user" or "project" to limit scope.'
+            'Set agentScope: "user" or "project" to limit scope.',
+            "Exactly one mode per call.",
+            'Single (one task): {"agent":"researcher","task":"<full self-contained task text>"}',
+            'Parallel (independent tasks; max 8, 4 run concurrently): {"tasks":[{"agent":"researcher","task":"..."},{"agent":"executor","task":"..."}]}',
+            'Chain (dependent tasks; sequential): {"chain":[{"agent":"researcher","task":"..."},{"agent":"executor","task":"Implement {previous}"}]}',
+            "NEVER mix agent/task with tasks or chain in one call; never pass a single task via tasks (use single mode); task must be a plain string; use known agent names only.",
+            "Task texts must be fully self-contained prompts (subagents share no context with the caller).",
         ].join(" "),
         promptSnippet: "Run a subagent to investigate, plan, review, or implement code changes",
         promptGuidelines: [
             "When the subagent tool is available, use it for non-trivial work where specialized delegation improves quality or speed, including bounded implementation, research, planning, review, and verification slices. Each subagent runs in an isolated context window.",
+            "Pick exactly one mode per call: one task → single {agent, task}; independent tasks → parallel {tasks: [...]} (max 8, 4 concurrent); dependent tasks → chain {chain: [...]} with {previous} substituting the prior step's output.",
+            "Task texts must be fully self-contained prompts (subagents share no context with the caller); never mix modes' fields (agent/task vs tasks/chain) in one call.",
         ],
         parameters: SubagentParams,
         async execute(_toolCallId, params, signal, onUpdate, ctx) {
@@ -951,7 +1008,7 @@ export default function subagentExtension(ext, opts) {
                     content: [
                         {
                             type: "text",
-                            text: `Invalid parameters. Provide exactly one mode.\nAvailable agents: ${available}`,
+                            text: `Invalid parameters. Provide exactly one mode.\nAvailable agents: ${available}\n\nExamples:\nSingle: {"agent":"researcher","task":"<full self-contained task text>"}\nParallel: {"tasks":[{"agent":"researcher","task":"..."},{"agent":"executor","task":"..."}]}\nChain: {"chain":[{"agent":"researcher","task":"..."},{"agent":"executor","task":"Implement {previous}"}]}\nRetry with exactly one of: agent+task | tasks | chain`,
                         },
                     ],
                     details: makeDetails("single")([]),
@@ -990,6 +1047,16 @@ export default function subagentExtension(ext, opts) {
             }
             // ── Chain mode ──────────────────────────────────────────────
             if (params.chain && params.chain.length > 0) {
+                if (params.chain.length > MAX_CHAIN_STEPS)
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Too many chain steps (${params.chain.length}). Max is ${MAX_CHAIN_STEPS}.`,
+                            },
+                        ],
+                        details: makeDetails("chain")([]),
+                    };
                 const results = [];
                 let previousOutput = "";
                 for (let i = 0; i < params.chain.length; i++) {
@@ -1101,8 +1168,15 @@ export default function subagentExtension(ext, opts) {
                 });
                 const successCount = results.filter((r) => r.exitCode === 0).length;
                 const summaries = results.map((r) => {
-                    const output = truncateOutput(getFinalOutput(r.messages), SUBAGENT_OUTPUT_LIMIT);
-                    const status = r.exitCode === 0
+                    const completed = r.exitCode === 0;
+                    const finalOutput = getFinalOutput(r.messages);
+                    // Failed tasks with no transcript surface their error message /
+                    // stderr instead of a bare "(no output)" so the caller can see
+                    // why the task failed (e.g. unknown agent names).
+                    const output = truncateOutput(completed || finalOutput.trim()
+                        ? finalOutput
+                        : r.errorMessage || r.stderr, SUBAGENT_OUTPUT_LIMIT);
+                    const status = completed
                         ? "completed"
                         : r.attempts && r.attempts > 1
                             ? `failed (after ${r.attempts} attempts)`
@@ -1117,6 +1191,7 @@ export default function subagentExtension(ext, opts) {
                         },
                     ],
                     details: persistDetails(makeDetails("parallel")(results)),
+                    ...(results.length > 0 && successCount === 0 ? { isError: true } : {}),
                 };
             }
             // ── Single mode ─────────────────────────────────────────────

package/dist/backend/generated-images.d.ts

@@ -34,7 +34,7 @@
  *
  * @module @spectral/backend/generated-images
  */
-export type GeneratedImageKind = "generated" | "attachment";
+export type GeneratedImageKind = "generated" | "attachment" | "video";
 export type UploadStep = "upload-url" | "put" | "confirm";
 export interface UploadImageOptions {
     /** Backend base url, e.g. `https://api.aexol.ai` (no trailing slash needed). */

package/dist/backend/generated-images.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-images.d.ts","sourceRoot":"","sources":["../../src/backend/generated-images.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,YAAY,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IAClC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,yDAAyD;IACzD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,2FAA2F;IAC3F,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,4BAA4B;IAC5C,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACpC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CAClB;AAqFD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBrE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAW1E;AAoBD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAapF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,4BAA4B,GACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA2EtC;AAED;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAGtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ/E;AA6ED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0HzF"}
+{"version":3,"file":"generated-images.d.ts","sourceRoot":"","sources":["../../src/backend/generated-images.ts"],"names":[],"mappings":"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"}

package/dist/commands/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAYlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAarE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAazD;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA6B9D;AAED,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA+kBlF;AAmFD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAc5E"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAclE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAarE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAazD;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA6B9D;AAED,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA8lBlF;AAmFD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAc5E"}

package/dist/commands/serve.js

@@ -40,7 +40,7 @@ import { refreshCloudAgents as refreshCloudAgentsImpl } from "../agent/agents.js
 import { requireLogin } from "../preflight.js";
 import { RelayClient } from "../relay/client.js";
 import { getFanoutManager } from "../server/fanout/fanout-manager.js";
-import { detachAllSubscribers, handleAutoOptimizeFrame, handleAutoResearchFrame, handleCancelTurn, handleClientMessage, handleRestRequest, handleSubscribe, } from "../relay/dispatcher.js";
+import { detachAllSubscribers, handleAutoOptimizeFrame, handleAutoResearchFrame, handleCancelTurn, handleClientMessage, handleRestRequest, handleStopToolCall, handleSubscribe, } from "../relay/dispatcher.js";
 import { ensureMachineRegistered } from "../relay/registration.js";
 import { saveMachine } from "../relay/machine-store.js";
 import { SessionStreamManager } from "../server/session-stream.js";
@@ -350,6 +350,17 @@ export async function runServe(opts = {}) {
                 handleCancelTurn(frame, { manager });
                 return;
             }
+            if (frame.kind === "stop_tool_call") {
+                // Per-tool-call stop: abort ONE hung tool call, keep the turn alive.
+                // Fire-and-forget with an internal catch — an unresolved settle must
+                // never hang the relay loop (the manager isolates per-call failures).
+                void handleStopToolCall(frame, {
+                    manager,
+                }).catch((err) => {
+                    process.stderr.write(`[serve] stop_tool_call failed: ${err instanceof Error ? err.message : String(err)}\n`);
+                });
+                return;
+            }
             if (frame.kind === "auto_research") {
                 handleAutoResearchFrame(frame, {
                     store,

package/dist/designer/data/skills/blog-post.d.ts

@@ -0,0 +1,3 @@
+import type { DesignSkill } from "./design-skill.js";
+export declare const blogPost: DesignSkill;
+//# sourceMappingURL=blog-post.d.ts.map

package/dist/designer/data/skills/blog-post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-post.d.ts","sourceRoot":"","sources":["../../../../src/designer/data/skills/blog-post.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,QAAQ,EAAE,WAoFpB,CAAC"}

package/dist/designer/data/skills/blog-post.js

@@ -0,0 +1,84 @@
+export const blogPost = {
+    name: "blog-post",
+    scenario: "content",
+    description: "Blog article layout — title, author metadata, featured image, prose body with headings/images/quotes, related posts. Single-page, reading-optimized typography with comfortable measure.",
+    outputKind: "html",
+    workflow: `# Blog Post Skill
+
+Produce a single blog article page with reading-optimized typography.
+
+## Phase 1 — Structure
+
+\`\`\`html
+<article class="blog-post">
+  <header class="post-header">
+    <div class="post-category">Category</div>
+    <h1>Article Title That Is Specific and Engaging</h1>
+    <div class="post-meta">
+      <span class="post-author">Author Name</span>
+      <span class="post-date">Month DD, YYYY</span>
+      <span class="post-read-time">N min read</span>
+    </div>
+  </header>
+  <figure class="post-hero">
+    <img src="..." alt="...">
+    <figcaption>Image caption (optional)</figcaption>
+  </figure>
+  <div class="post-content">
+    <!-- prose -->
+  </div>
+  <footer class="post-footer">
+    <div class="post-tags"><!-- tag pills --></div>
+    <section class="related-posts"><!-- 3 related cards --></section>
+  </footer>
+</article>
+\`\`\`
+
+## Phase 2 — Typography
+
+\`\`\`css
+.blog-post { max-width: 680px; margin: 0 auto; padding: 64px 24px; }
+
+.post-header { margin-bottom: 32px; }
+.post-category { font-size: 13px; font-weight: 600; color: var(--accent); text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 12px; }
+.post-header h1 { font-size: 40px; font-weight: 700; line-height: 1.2; letter-spacing: -0.02em; margin-bottom: 16px; }
+.post-meta { display: flex; gap: 16px; font-size: 14px; color: var(--muted); }
+
+.post-hero { margin: 0 -24px 40px; }
+.post-hero img { width: 100%; height: 400px; object-fit: cover; border-radius: 12px; }
+.post-hero figcaption { font-size: 13px; color: var(--muted); text-align: center; margin-top: 8px; }
+
+/* Prose — comfortable reading measure */
+.post-content { font-size: 18px; line-height: 1.8; color: var(--fg); }
+.post-content p { margin: 24px 0; }
+.post-content h2 { font-size: 28px; font-weight: 600; margin: 48px 0 16px; }
+.post-content h3 { font-size: 22px; font-weight: 600; margin: 36px 0 12px; }
+.post-content blockquote { border-left: 3px solid var(--accent); padding: 8px 20px; margin: 32px 0; font-style: italic; color: var(--muted); }
+.post-content ul, .post-content ol { padding-left: 24px; margin: 16px 0; }
+.post-content li { margin: 8px 0; }
+.post-content img { max-width: 100%; border-radius: 8px; margin: 24px 0; }
+.post-content code { font-family: var(--font-mono); font-size: 0.9em; background: var(--surface); padding: 2px 6px; border-radius: 4px; }
+.post-content pre { background: var(--surface); border: 1px solid var(--border); border-radius: 8px; padding: 20px 24px; overflow-x: auto; font-family: var(--font-mono); font-size: 15px; line-height: 1.6; margin: 24px 0; }
+
+/* Tags */
+.post-tags { display: flex; flex-wrap: wrap; gap: 8px; margin: 48px 0; padding-top: 32px; border-top: 1px solid var(--border); }
+.post-tag { padding: 4px 12px; background: var(--surface); border-radius: 999px; font-size: 13px; color: var(--muted); }
+
+/* Related posts */
+.related-posts { margin-top: 48px; }
+.related-posts h3 { font-size: 20px; font-weight: 600; margin-bottom: 16px; }
+.related-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 16px; }
+.related-card { border: 1px solid var(--border); border-radius: 8px; overflow: hidden; }
+.related-card img { width: 100%; height: 140px; object-fit: cover; }
+.related-card-content { padding: 16px; }
+.related-card-content h4 { font-size: 15px; font-weight: 600; margin-bottom: 4px; }
+.related-card-content time { font-size: 12px; color: var(--muted); }
+\`\`\`
+
+## Phase 3 — Content Rules
+- Article body: 800-2000 words of meaningful content (no lorem ipsum)
+- Every heading is specific and informative
+- Include at least one blockquote and one code block
+- Feature image is a gradient shape if no real image
+- Author bio is not generic — use a plausible name and role`,
+};

package/dist/designer/data/skills/blog-post.ts

@@ -0,0 +1,87 @@
+import type { DesignSkill } from "./design-skill.js";
+
+export const blogPost: DesignSkill = {
+    name: "blog-post",
+    scenario: "content",
+    description:
+      "Blog article layout — title, author metadata, featured image, prose body with headings/images/quotes, related posts. Single-page, reading-optimized typography with comfortable measure.",
+    outputKind: "html",
+    workflow: `# Blog Post Skill
+
+Produce a single blog article page with reading-optimized typography.
+
+## Phase 1 — Structure
+
+\`\`\`html
+<article class="blog-post">
+  <header class="post-header">
+    <div class="post-category">Category</div>
+    <h1>Article Title That Is Specific and Engaging</h1>
+    <div class="post-meta">
+      <span class="post-author">Author Name</span>
+      <span class="post-date">Month DD, YYYY</span>
+      <span class="post-read-time">N min read</span>
+    </div>
+  </header>
+  <figure class="post-hero">
+    <img src="..." alt="...">
+    <figcaption>Image caption (optional)</figcaption>
+  </figure>
+  <div class="post-content">
+    <!-- prose -->
+  </div>
+  <footer class="post-footer">
+    <div class="post-tags"><!-- tag pills --></div>
+    <section class="related-posts"><!-- 3 related cards --></section>
+  </footer>
+</article>
+\`\`\`
+
+## Phase 2 — Typography
+
+\`\`\`css
+.blog-post { max-width: 680px; margin: 0 auto; padding: 64px 24px; }
+
+.post-header { margin-bottom: 32px; }
+.post-category { font-size: 13px; font-weight: 600; color: var(--accent); text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 12px; }
+.post-header h1 { font-size: 40px; font-weight: 700; line-height: 1.2; letter-spacing: -0.02em; margin-bottom: 16px; }
+.post-meta { display: flex; gap: 16px; font-size: 14px; color: var(--muted); }
+
+.post-hero { margin: 0 -24px 40px; }
+.post-hero img { width: 100%; height: 400px; object-fit: cover; border-radius: 12px; }
+.post-hero figcaption { font-size: 13px; color: var(--muted); text-align: center; margin-top: 8px; }
+
+/* Prose — comfortable reading measure */
+.post-content { font-size: 18px; line-height: 1.8; color: var(--fg); }
+.post-content p { margin: 24px 0; }
+.post-content h2 { font-size: 28px; font-weight: 600; margin: 48px 0 16px; }
+.post-content h3 { font-size: 22px; font-weight: 600; margin: 36px 0 12px; }
+.post-content blockquote { border-left: 3px solid var(--accent); padding: 8px 20px; margin: 32px 0; font-style: italic; color: var(--muted); }
+.post-content ul, .post-content ol { padding-left: 24px; margin: 16px 0; }
+.post-content li { margin: 8px 0; }
+.post-content img { max-width: 100%; border-radius: 8px; margin: 24px 0; }
+.post-content code { font-family: var(--font-mono); font-size: 0.9em; background: var(--surface); padding: 2px 6px; border-radius: 4px; }
+.post-content pre { background: var(--surface); border: 1px solid var(--border); border-radius: 8px; padding: 20px 24px; overflow-x: auto; font-family: var(--font-mono); font-size: 15px; line-height: 1.6; margin: 24px 0; }
+
+/* Tags */
+.post-tags { display: flex; flex-wrap: wrap; gap: 8px; margin: 48px 0; padding-top: 32px; border-top: 1px solid var(--border); }
+.post-tag { padding: 4px 12px; background: var(--surface); border-radius: 999px; font-size: 13px; color: var(--muted); }
+
+/* Related posts */
+.related-posts { margin-top: 48px; }
+.related-posts h3 { font-size: 20px; font-weight: 600; margin-bottom: 16px; }
+.related-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 16px; }
+.related-card { border: 1px solid var(--border); border-radius: 8px; overflow: hidden; }
+.related-card img { width: 100%; height: 140px; object-fit: cover; }
+.related-card-content { padding: 16px; }
+.related-card-content h4 { font-size: 15px; font-weight: 600; margin-bottom: 4px; }
+.related-card-content time { font-size: 12px; color: var(--muted); }
+\`\`\`
+
+## Phase 3 — Content Rules
+- Article body: 800-2000 words of meaningful content (no lorem ipsum)
+- Every heading is specific and informative
+- Include at least one blockquote and one code block
+- Feature image is a gradient shape if no real image
+- Author bio is not generic — use a plausible name and role`,
+  };

package/dist/designer/data/skills/critique.d.ts

@@ -0,0 +1,3 @@
+import type { DesignSkill } from "./design-skill.js";
+export declare const critique: DesignSkill;
+//# sourceMappingURL=critique.d.ts.map

package/dist/designer/data/skills/critique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critique.d.ts","sourceRoot":"","sources":["../../../../src/designer/data/skills/critique.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,eAAO,MAAM,QAAQ,EAAE,WA6GpB,CAAC"}

package/dist/designer/data/skills/critique.js

@@ -0,0 +1,109 @@
+export const critique = {
+    name: "critique",
+    scenario: "design",
+    description: "5-dimension expert design review. Scores any HTML artifact on Philosophy Consistency, Visual Hierarchy, Detail Execution, Functionality, and Innovation (each 0-10). Outputs an HTML report with a radar chart, evidence-backed scores, and three action lists: Keep / Fix / Quick-wins.",
+    outputKind: "html",
+    workflow: `# Critique Skill · 5-Dimension Expert Review
+
+Produce a single-file HTML design review report that scores any artifact across 5 dimensions and proposes actionable fixes.
+
+## When to use
+- After generating an artifact (deck, prototype, landing page) and the user asks "what's wrong with this?" or "review this"
+- As a self-check loop before emitting output
+- For comparing two variants of the same design
+
+## The 5 Dimensions
+
+### 1. Philosophy Consistency
+> Does the artifact pick a clear direction and stick to it through every micro-decision?
+
+Look for: one declared design direction vs three styles fighting; chrome/kicker vocabulary in one register; accent/serif/mono used by the same rule throughout.
+0-4: Three styles fighting. 5-6: One direction but elements drift. 7-8: Coherent, occasional drift. 9-10: Every element argues for the same thesis.
+
+### 2. Visual Hierarchy
+> Can a stranger figure out what to read first, second, third — without being told?
+
+Look for: largest type = most important thing; mono/serif/sans roles match information roles; clear primary/secondary/tertiary tiers.
+0-4: Everything shouts. 5-6: Works on hero pages but breaks on body. 7-8: Clear tiers, occasional collision. 9-10: Eye moves with zero friction.
+
+### 3. Detail Execution
+> Alignment, leading, kerning at large sizes, image framing, edge-case spacing.
+
+Look for: big numbers on baseline or floating; left/right column tops aligned; proportions consistent across pages; orphaned <br> causing single-character lines.
+0-4: Visible tape and string. 5-6: Most pages clean, 1-2 ragged. 7-8: Polished, expert eye finds 2-3 misses. 9-10: Magazine-grade polish.
+
+### 4. Functionality
+> Does the artifact work for its intended use?
+
+Look for: keyboard/wheel/touch nav working in decks; CTAs above the fold; phone numbers tappable on mobile; code blocks copyable; critical info readable from 4m away.
+0-4: Visually fine but doesn't accomplish its job. 5-6: Core flow works, edge cases broken. 7-8: Robust through normal use. 9-10: Defensively engineered — handles iframe / fullscreen / paste / print.
+
+### 5. Innovation
+> Does this push past the median? Is there one element that makes people lean in?
+
+Look for: one unexpected layout/motion/typographic move not required; or 100% safe generic output; innovation earned (matches direction) or grafted on.
+0-4: Generic AI-slop median. 5-6: Competent and unmemorable. 7-8: One memorable moment, the rest solid. 9-10: Multiple moves you'd steal — each serving the thesis.
+
+## Scoring Discipline
+- **Always cite evidence** — "scored 4 because hero page mixes Playfair display with Inter sans on the same line" beats "feels inconsistent"
+- **Don't average up** — if Hierarchy is 5 because page 3 is broken, don't bump to 7 because pages 1-2 are fine. The score is the worst sustained band.
+- **Don't grade-inflate** — a 7 means strong, not acceptable. If every score is 7+, you're not reviewing critically.
+- **Innovation is allowed to be low** — 5/10 is fine for production deliverables.
+
+## Workflow
+
+### Step 1 — Acquire the artifact
+1. **Project file** — user said "review the index.html I just made": read it from the project folder.
+2. **Pasted HTML** — user pasted code in chat: read it from the message.
+3. **Self-critique** — you just emitted an artifact and want to self-critique: re-read your own output.
+
+### Step 2 — Read enough to score
+Skim the entire <style>, then read 6-8 representative content blocks. Do not score from intent alone — the score depends on executed design, not declared intent.
+
+### Step 3 — Score with evidence
+For each of the 5 dimensions, write the score and a 30-80 word evidence paragraph naming specific elements. Example:
+\`\`\`
+Dimension: Detail execution
+Score: 6 / 10
+Evidence: Stat-cards on page 3 align cleanly, but on page 8 the right column sits 2vh higher than the left because .callout has 3vh top margin while the figure doesn't. Image captions use mono on page 5 but sans on page 7 — pick one.
+\`\`\`
+
+### Step 4 — Build action lists
+- **Keep** (3-5 bullets) — concrete things working that the user must not break. Cite by class/page/element.
+- **Fix** (3-6 bullets) — must-do, ordered by visual cost saved per minute. Each bullet ≤ 1 sentence.
+- **Quick wins** (3-5 bullets) — 5-15 minutes each, high signal-to-noise.
+
+### Step 5 — Emit the report HTML
+Build a single file with:
+- Header: artifact name + date + reviewer + 1-line verdict
+- Big radar chart (inline SVG, no library)
+- 5 dimension cards in a 1-column or 2-column grid
+- Three action lists at the bottom with checkbox affordance
+
+Use the active design system tokens if one exists; otherwise default to a neutral light theme (white background, near-black text, one accent for radar fill).
+
+## Radar Chart SVG Template
+\`\`\`svg
+<svg viewBox="0 0 400 400" xmlns="http://www.w3.org/2000/svg">
+  <!-- Pentagon grid lines -->
+  <polygon points="200,40 352,152 294,340 106,340 48,152" fill="none" stroke="#e0e0e0" stroke-width="1"/>
+  <polygon points="200,80 314,166 267,306 133,306 86,166" fill="none" stroke="#e0e0e0" stroke-width="1"/>
+  <polygon points="200,120 276,180 240,272 160,272 124,180" fill="none" stroke="#e0e0e0" stroke-width="1"/>
+  <!-- Score polygon (fill with accent at 20% opacity) -->
+  <polygon points="..." fill="var(--accent, #3B82F6)" fill-opacity="0.2" stroke="var(--accent, #3B82F6)" stroke-width="2"/>
+  <!-- Labels at each vertex -->
+  <text x="200" y="30" text-anchor="middle" font-size="11">Philosophy</text>
+  <text x="360" y="155" text-anchor="start" font-size="11">Hierarchy</text>
+  <text x="300" y="355" text-anchor="middle" font-size="11">Detail</text>
+  <text x="100" y="355" text-anchor="middle" font-size="11">Function</text>
+  <text x="40" y="155" text-anchor="end" font-size="11">Innovation</text>
+</svg>
+\`\`\`
+
+## Hard Rules
+- **5 scores, every time** — partial reports are not allowed.
+- **Evidence per score** — no "feels off" / "needs work". If you can't cite an element, the score is not justified.
+- **Don't grade-inflate** — overall mean above 8 is suspicious.
+- **Single-file HTML only** — no external CSS/JS. Inline everything.
+- **Radar chart is mandatory** — gives the report a recognizable silhouette.`,
+};