@aexol/spectral 0.9.270 → 0.9.272

package/dist/agent/index.d.ts

@@ -31,8 +31,9 @@
  *     `compact_context`, and `subagent` remain excluded
  */
 import type { AgentEvent, AgentTool } from "../sdk/agent-core/index.js";
+import { type StreamFn } from "../sdk/agent-core/index.js";
 import type { AgentMessage } from "../sdk/agent-core/index.js";
-import { type ExtensionAPI, type ExtensionContext } from "../sdk/coding-agent/index.js";
+import { type ExtensionAPI, type ExtensionContext } from "../sdk/coding-agent/core/extensions/types.js";
 import { type AgentConfig } from "./agents.js";
 import type { ServerEvent } from "../server/wire.ts";
 import { type TpsUsageFields } from "../server/agent-bridge/tps-metrics.ts";
@@ -129,5 +130,13 @@ export default function subagentExtension(ext: ExtensionAPI, opts?: {
      * to the caller's own subtree. Returns null when no primary applies.
      */
     resolveActivePrimaryName?: () => string | null | undefined;
+    /**
+     * Override the child LLM stream function. Default: `streamSimple`
+     * (direct provider call with the resolved API key). The browser
+     * runtime passes the session's injected streamFn so child calls go
+     * through the backend LLM proxy (billing headers, abort semantics)
+     * instead of touching a provider directly.
+     */
+    streamFnOverride?: StreamFn;
 }): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAEX,UAAU,EAEV,SAAS,EAET,MAAM,4BAA4B,CAAC;AAOpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAwB/D,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAKrB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACN,KAAK,WAAW,EAQhB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAGN,KAAK,cAAc,EACnB,MAAM,uCAAuC,CAAC;AAS/C,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,6CAA6C,CAAC;AA+HxG;;;;;;;;;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,CAeR;AAyND;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,cAAc,CAAC,CAe5D;AAgCD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,EACrB,SAAS,CAAC,EAAE,MAAM,GAChB,SAAS,EAAE,CAkDb;AAyBD;;;;;;;;;;GAUG;AACH;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,6EAA6E;IAC7E,GAAG,EAAE,cAAc,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,wBAAwB,CAAC;AAqF1E,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;AAsBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,YAAY,EAAE,EACxB,aAAa,EAAE,MAAM,GACnB,YAAY,EAAE,GAAG,SAAS,CAyE5B;AASD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,aAAa,EAAE,MAAM,GACnB,YAAY,EAAE,CAchB;AA8tBD,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;IAChB;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC3D,GACC,IAAI,CAwbN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAEX,UAAU,EAEV,SAAS,EAET,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGN,KAAK,QAAQ,EACb,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAwB/D,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAErB,MAAM,8CAA8C,CAAC;AAYtD,OAAO,EACN,KAAK,WAAW,EAQhB,MAAM,aAAa,CAAC;AAMrB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAGN,KAAK,cAAc,EACnB,MAAM,uCAAuC,CAAC;AAS/C,OAAO,KAAK,EAAE,sBAAsB,EAAgB,MAAM,6CAA6C,CAAC;AA+HxG;;;;;;;;;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,CAeR;AAyND;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,sBAAsB,EAAE,WAAW,GAAG,cAAc,CAAC,CAe5D;AAgCD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,EACrB,SAAS,CAAC,EAAE,MAAM,GAChB,SAAS,EAAE,CAkDb;AAyBD;;;;;;;;;;GAUG;AACH;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,6EAA6E;IAC7E,GAAG,EAAE,cAAc,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,wBAAwB,CAAC;AAuF1E,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;AAsBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,YAAY,EAAE,EACxB,aAAa,EAAE,MAAM,GACnB,YAAY,EAAE,GAAG,SAAS,CAyE5B;AASD;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,aAAa,EAAE,MAAM,GACnB,YAAY,EAAE,CAchB;AAmuBD,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;IAChB;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,QAAQ,CAAC;CAC5B,GACC,IAAI,CAmcN"}

package/dist/agent/index.js

@@ -36,12 +36,15 @@ import { compactDcpLite, prepareCompaction, DEFAULT_COMPACTION_SETTINGS, } from
 import { estimateTokens } from "../sdk/coding-agent/core/compaction/tokens.js";
 import { createCompactionSummaryMessage, convertToLlm, } from "../sdk/coding-agent/core/messages.js";
 import { isRateLimitError, isTransientApiError, isContextOverflow, isPaymentRequiredError, streamSimple, } from "../sdk/ai/index.js";
-import { RETRY_DEFAULT_BASE_DELAY_MS, RETRY_DEFAULT_MAX_RETRIES, RETRY_MAX_BACKOFF_DELAY_MS, } from "../sdk/coding-agent/index.js";
+// Leaf import (NOT the coding-agent barrel): the barrel re-exports
+// extensions/loader.ts (jiti + node:fs), which must stay out of the
+// browser bundle (packages/agent-runtime-browser imports this module).
+import { RETRY_DEFAULT_BASE_DELAY_MS, RETRY_DEFAULT_MAX_RETRIES, RETRY_MAX_BACKOFF_DELAY_MS, } from "../sdk/coding-agent/core/settings-manager.js";
 import { mutateSystemPrompt } from "../sdk/coding-agent/core/system-prompt-mutator.js";
 import { sleep } from "../sdk/coding-agent/utils/sleep.js";
 import { Type } from "typebox";
 import { discoverAgents, agentMetadataBlock, resolveAgentByName, reachableAgents, resolveSelectedPrimaryAgent, } from "./agents.js";
-import { loadAgentSettings } from "../server/handlers/agent-settings.js";
+import { AGENT_SETTINGS_DEFAULTS, loadAgentSettings, } from "../server/handlers/agent-settings.js";
 import { buildTpsUsageFields, computeTpsMetrics, } from "../server/agent-bridge/tps-metrics.js";
 import { randomUUID } from "node:crypto";
 // ---------------------------------------------------------------------------
@@ -413,7 +416,7 @@ async function mapWithConcurrencyLimit(items, concurrency, fn) {
     await Promise.all(workers);
     return results;
 }
-async function runSingleAgentWithTimeout(defaultCwd, agents, activePrimary, agentName, task, cwd, step, signal, onUpdate, makeDetails, parentToolCallId, onInternalEvent, ext, ctx, maxRetries) {
+async function runSingleAgentWithTimeout(defaultCwd, agents, activePrimary, agentName, task, cwd, step, signal, onUpdate, makeDetails, parentToolCallId, onInternalEvent, ext, ctx, maxRetries, streamFnOverride) {
     const timeoutMs = SUBAGENT_TIMEOUT_MS;
     const timeoutSeconds = timeoutMs / 1000;
     const controller = new AbortController();
@@ -427,7 +430,7 @@ async function runSingleAgentWithTimeout(defaultCwd, agents, activePrimary, agen
             signal.addEventListener("abort", onParentAbort, { once: true });
     }
     try {
-        const result = await runSingleAgent(defaultCwd, agents, activePrimary, agentName, task, cwd, step, controller.signal, onUpdate, makeDetails, parentToolCallId, onInternalEvent, ext, ctx, maxRetries);
+        const result = await runSingleAgent(defaultCwd, agents, activePrimary, agentName, task, cwd, step, controller.signal, onUpdate, makeDetails, parentToolCallId, onInternalEvent, ext, ctx, maxRetries, streamFnOverride);
         // If the timeout fired (and parent signal did not), surface a clean
         // timeout error result rather than a bare "aborted" result.
         if (controller.signal.aborted &&
@@ -645,7 +648,7 @@ function truncateMessageToSafeCap(message, targetChars) {
 // ---------------------------------------------------------------------------
 // Core — run a single subagent in-process via agentLoop
 // ---------------------------------------------------------------------------
-async function runSingleAgent(defaultCwd, agents, activePrimary, agentName, task, cwd, step, signal, onUpdate, makeDetails, parentToolCallId, onInternalEvent, ext, ctx, maxRetries) {
+async function runSingleAgent(defaultCwd, agents, activePrimary, agentName, task, cwd, step, signal, onUpdate, makeDetails, parentToolCallId, onInternalEvent, ext, ctx, maxRetries, streamFnOverride) {
     const normalizedAgentName = agentName.replace(/^@/, "");
     // Parent-aware resolution: with an active cloud primary, candidates are
     // scoped to its subtree (the primary + its direct children), so
@@ -817,7 +820,11 @@ async function runSingleAgent(defaultCwd, agents, activePrimary, agentName, task
         // Optional call: symmetric with getRetrySettings?.() above — partial
         // settingsManager stubs (extension contexts, tests) must not throw.
         const providerRetrySettings = ctx.settingsManager?.getProviderRetrySettings?.();
-        const subagentStreamFn = (streamModel, streamContext, options) => streamSimple(streamModel, streamContext, {
+        // Browser runtime: the injected streamFn (backend LLM proxy) replaces
+        // the direct provider call; without an override the CLI keeps
+        // streamSimple (byte-identical behaviour to before the opt existed).
+        const childStreamFn = streamFnOverride ?? streamSimple;
+        const subagentStreamFn = (streamModel, streamContext, options) => childStreamFn(streamModel, streamContext, {
             ...options,
             timeoutMs: options?.timeoutMs ?? providerRetrySettings?.timeoutMs,
             maxRetries: options?.maxRetries ?? providerRetrySettings?.maxRetries,
@@ -1241,7 +1248,16 @@ export default function subagentExtension(ext, opts) {
             // Re-load agent settings from disk on every call so that UI toggles
             // (subagentsEnabled / disabledSubagents) take effect immediately on
             // running sessions, not just on the next session start.
-            const liveSettings = loadAgentSettings(ctx.cwd);
+            // Browser-safe: in the browser bundle node:fs is a throwing stub,
+            // so fall back to the same defaults loadAgentSettings returns for
+            // a missing settings file (subagents enabled, no per-agent disables).
+            let liveSettings;
+            try {
+                liveSettings = loadAgentSettings(ctx.cwd);
+            }
+            catch {
+                liveSettings = { ...AGENT_SETTINGS_DEFAULTS };
+            }
             if (!liveSettings.subagentsEnabled) {
                 return {
                     content: [
@@ -1400,7 +1416,7 @@ export default function subagentExtension(ext, opts) {
                             }
                         }
                         : undefined;
-                    const result = await runSingleAgentWithTimeout(ctx.cwd, agents, subtree, step.agent, taskWithContext, step.cwd, i + 1, signal, chainUpdate, makeDetails("chain"), _toolCallId, emitSubagentToolProgress, ext, ctx, params.maxRetries);
+                    const result = await runSingleAgentWithTimeout(ctx.cwd, agents, subtree, step.agent, taskWithContext, step.cwd, i + 1, signal, chainUpdate, makeDetails("chain"), _toolCallId, emitSubagentToolProgress, ext, ctx, params.maxRetries, opts?.streamFnOverride);
                     results.push(result);
                     const isError = result.exitCode !== 0 ||
                         result.stopReason === "error" ||
@@ -1487,7 +1503,7 @@ export default function subagentExtension(ext, opts) {
                             allResults[index] = partial.details.results[0];
                             emitParallelUpdate();
                         }
-                    }, makeDetails("parallel"), _toolCallId, emitSubagentToolProgress, ext, ctx, params.maxRetries);
+                    }, makeDetails("parallel"), _toolCallId, emitSubagentToolProgress, ext, ctx, params.maxRetries, opts?.streamFnOverride);
                     allResults[index] = result;
                     emitParallelUpdate();
                     return result;
@@ -1522,7 +1538,7 @@ export default function subagentExtension(ext, opts) {
             }
             // ── Single mode ─────────────────────────────────────────────
             if (params.agent && params.task) {
-                const result = await runSingleAgentWithTimeout(ctx.cwd, agents, subtree, params.agent, params.task, params.cwd, undefined, signal, onUpdate, makeDetails("single"), _toolCallId, emitSubagentToolProgress, ext, ctx, params.maxRetries);
+                const result = await runSingleAgentWithTimeout(ctx.cwd, agents, subtree, params.agent, params.task, params.cwd, undefined, signal, onUpdate, makeDetails("single"), _toolCallId, emitSubagentToolProgress, ext, ctx, params.maxRetries, opts?.streamFnOverride);
                 const isError = result.exitCode !== 0 ||
                     result.stopReason === "error" ||
                     result.stopReason === "aborted";

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;AAgBlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAsBrE;;;;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;IAC9E;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;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,CAurBlF;AAmFD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAsB5E"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAgBlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA0BrE;;;;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;IAC9E;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;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,CAitBlF;AAmFD;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAsB5E"}

package/dist/commands/serve.js

@@ -51,7 +51,7 @@ import { getLiveMcpState } from "../mcp/state-getter.js";
 import { preflightSqlite, SessionStore } from "../server/storage.js";
 import { DevProcessRegistry } from "../server/dev-process-registry.js";
 import { sweepOffloads } from "../server/offload-gc.js";
-import { SERVE_READY_MARKER, clearServeState, getLiveServePid, ownsServeState, writeServePid, writeServeReady, } from "../utils/serve-state.js";
+import { SERVE_READY_MARKER, clearServeState, getLiveServePid, getServePidFile, isDescendantOf, isSpectralServeProcess, ownsServeState, terminateStaleServe, writeServePid, writeServeReady, } from "../utils/serve-state.js";
 import { applyAugmentedPath } from "../utils/augment-path.js";
 /** Default backend base URL when neither env nor override is set. */
 const DEFAULT_BACKEND_URL = "https://api.aexol.ai";
@@ -155,10 +155,34 @@ export async function runServe(opts = {}) {
         // not a competing daemon — ditto our direct parent.
         const previous = getLiveServePid();
         const launchClaim = Number.parseInt(process.env.SPECTRAL_SERVE_PID_CLAIM ?? "", 10);
-        const expectedHolder = previous === process.ppid || (Number.isInteger(launchClaim) && previous === launchClaim);
-        if (previous !== null && previous !== process.pid && !expectedHolder && !silent) {
-            process.stderr.write(`warning: another spectral serve appears to be running (pid ${previous}); ` +
-                `this process will take over ~/.spectral/serve.pid\n`);
+        // An INDIRECT ancestor counts too: the daemon hosting the very session
+        // that runs `deno task cli:dev` is our grandparent+ — killing it would
+        // take this run down with it, so it stays in the warn-only class.
+        const expectedHolder = previous === process.ppid ||
+            (previous !== null && isDescendantOf(process.pid, previous)) ||
+            (Number.isInteger(launchClaim) && previous === launchClaim);
+        if (previous !== null && previous !== process.pid && !expectedHolder) {
+            if (isSpectralServeProcess(previous)) {
+                // A confirmed `spectral serve` from this same config dir is the
+                // classic stale-daemon case: a terminal left open from an earlier
+                // `spectral serve` / `deno task cli:dev`. The backend would evict one
+                // of the two relays and the evicted CLI would exit(1) with a dead
+                // terminal. Take the old one out BEFORE registering so this instance
+                // wins the registration race.
+                if (terminateStaleServe(previous)) {
+                    process.stderr.write(`↻ Replaced stale dev serve (PID ${previous}) holding ${getServePidFile()}\n`);
+                }
+                else if (!silent) {
+                    process.stderr.write(`warning: could not stop the previous serve (pid ${previous}); ` +
+                        `continuing — the backend may evict one of the two instances\n`);
+                }
+            }
+            else if (!silent) {
+                // Identity unconfirmed — keep the historical behavior: warn and
+                // continue. The backend eviction still applies to true duplicates.
+                process.stderr.write(`warning: another spectral serve appears to be running (pid ${previous}); ` +
+                    `this process will take over ${getServePidFile()}\n`);
+            }
         }
         writeServePid();
     }

package/dist/commands/update.d.ts

@@ -9,8 +9,8 @@
  *
  *   - binary only (every manifest ever published): `url` + `sha256` pin the
  *     single-file binary. Only the binary is replaced — the companion assets an
- *     `install.sh` user has next to it (`data/systems/`, `mcp/`,
- *     `app-bridge.bundle.js`) keep the previous version, which is called out
+ *     `install.sh` user has next to it (`mcp/`, `app-bridge.bundle.js`)
+ *     keep the previous version, which is called out
  *     with a warning telling the user to re-run `curl | sh`.
  *   - release zip (ADDITIVE `zipUrl` + `zipSha256`, emitted by
  *     cli-node/scripts/generate-cli-manifest.sh once scripts/package-standalone.sh

package/dist/commands/update.js

@@ -9,8 +9,8 @@
  *
  *   - binary only (every manifest ever published): `url` + `sha256` pin the
  *     single-file binary. Only the binary is replaced — the companion assets an
- *     `install.sh` user has next to it (`data/systems/`, `mcp/`,
- *     `app-bridge.bundle.js`) keep the previous version, which is called out
+ *     `install.sh` user has next to it (`mcp/`, `app-bridge.bundle.js`)
+ *     keep the previous version, which is called out
  *     with a warning telling the user to re-run `curl | sh`.
  *   - release zip (ADDITIVE `zipUrl` + `zipSha256`, emitted by
  *     cli-node/scripts/generate-cli-manifest.sh once scripts/package-standalone.sh
@@ -250,7 +250,7 @@ export async function swapCompanionAssets(params) {
         await rm(join(installDir, name), { force: true });
     }
     // Copy the new companion contents next to the binary: the compiled binary
-    // resolves data/systems and app-bridge.bundle.js relative to execPath.
+    // resolves app-bridge.bundle.js relative to execPath.
     const replaced = [];
     for (const entry of await readdir(destDataDir, { withFileTypes: true })) {
         await cp(join(destDataDir, entry.name), join(installDir, entry.name), {

package/dist/designer/index.d.ts

@@ -1,25 +1,20 @@
 /**
- * Designer Extension — Built-in Design Tools for the spectral coding agent
+ * Designer Extension — thin tool definitions proxying to the Aexol backend.
  *
- * Brings the Open Design workflow (https://github.com/nexu-io/open-design)
- * into the spectral agent as native tools. The extension provides:
+ * The design DATA and logic (150+ design systems, 13 skill workflows,
+ * guidelines, 20 philosophies) now live in the backend (backend/src/designer/)
+ * and are exposed as `designer_*` tools on the backend `/mcp` server. This
+ * extension registers the 7 tool definitions locally; each execute() is a
+ * thin proxy: createAexolBackendClient() → tools/call → relay text.
  *
- *   • Design system knowledge — curated palettes, typography, spacing from
- *     Apple, Stripe, Linear, Vercel, Notion, Airbnb, and more.
- *   • Design skill workflows — structured guides for web prototypes, SaaS
- *     landings, slide decks, mobile apps, dashboards, and social carousels.
- *   • Design guidelines — anti-AI-slop rules and a 5-dimension critique
- *     framework to keep output polished.
- *   • System prompt injection — when the user asks for design work, the
- *     extension injects designer identity and anti-slop rules into context.
+ * There is no local data and no local prompt injection anymore — the
+ * discovery-flow guidance ("call designer_list_systems before writing design
+ * code") lives in the tool descriptions/promptSnippets here and in the
+ * backend TOOL_DEFINITIONS.
  *
- * Architecture:
- *   The extension registers knowledge-retrieval tools. The LLM reads design
- *   systems and skill workflows, then uses its existing tools (write, bash,
- *   read) to produce design artifact files. This matches how Open Design
- *   works: the daemon composes a system prompt, the agent does the build.
- *
- * No packages to install — everything is embedded in this extension.
+ * Duplicate-registration note: `aexol-mcp.ts` skips the 7 designer_* names
+ * when dynamically registering backend tools, so each name is registered
+ * exactly once (this extension). See the skip list there.
  */
 import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
 export default function designerExtension(ext: ExtensionAPI): void;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/designer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAmGjE,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAkKjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/designer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AA2HjE,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CA8HjE"}