@aexol/spectral 0.9.199 → 0.9.200

package/dist/commands/serve.d.ts

@@ -19,6 +19,8 @@
  *
  * Flag surface:
  *  - `--machine-name <name>` — display name used at registration time.
+ *  - `SPECTRAL_MACHINE_NAME` — fallback display name used when the flag is
+ *    not supplied. The flag takes precedence over the environment variable.
  *  - `--port <n>` / `-p <n>` / `SPECTRAL_PORT` — accepted but warned-and-ignored
  *    so users updating from the pre-relay version don't get a hard error.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAwBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAWlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAYrE;;;;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,CAiiBlF;AA+DD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAa5E"}
+{"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;AAYrE;;;;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,CAwiBlF;AA+DD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAc5E"}

package/dist/commands/serve.js

@@ -19,6 +19,8 @@
  *
  * Flag surface:
  *  - `--machine-name <name>` — display name used at registration time.
+ *  - `SPECTRAL_MACHINE_NAME` — fallback display name used when the flag is
+ *    not supplied. The flag takes precedence over the environment variable.
  *  - `--port <n>` / `-p <n>` / `SPECTRAL_PORT` — accepted but warned-and-ignored
  *    so users updating from the pre-relay version don't get a hard error.
  *
@@ -37,6 +39,7 @@ import { getAgentDir } from "../sdk/coding-agent/config.js";
 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 { ensureMachineRegistered } from "../relay/registration.js";
 import { saveMachine } from "../relay/machine-store.js";
@@ -240,6 +243,12 @@ export async function runServe(opts = {}) {
         onCloudAgentsAuthRejected: (reason) => forceReRegister(reason),
     });
     managerRef.current = manager;
+    // Fanout worker sessions are created directly in the store, outside the
+    // REST dispatcher, so nothing would notify connected tabs — they only
+    // appeared after a manual refresh. Publish `session_created` through the
+    // same deferred wrapper the dispatcher uses (no-ops until the relay is
+    // up, then fans out to every subscribed client).
+    getFanoutManager()?.setMetaEventPublisher(deferredPublishMetaEvent);
     if (!silent) {
         const action = registration.reused ? "Reusing" : "Registered";
         process.stdout.write(`${action} machine "${registration.record.machineName}" (${registration.record.machineId})\n`);
@@ -670,11 +679,12 @@ async function handleConfigPatch(frame, deps) {
  */
 export async function runServeCli(rawArgs) {
     const parsed = parseServeArgs(rawArgs);
+    const machineName = parsed.machineName ?? process.env.SPECTRAL_MACHINE_NAME;
     if (parsed.deprecatedPort || process.env.SPECTRAL_PORT) {
         process.stderr.write(`warning: --port / SPECTRAL_PORT are no longer used. ` +
             `spectral serve now connects outbound to the Aexol relay; there is no local port to bind.\n`);
     }
     return runServe({
-        machineName: parsed.machineName,
+        machineName,
     });
 }

package/dist/extensions/session-fanout/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Session Fanout — native spectral extension.
+ *
+ * Registers a single tool, `session_fanout`, that spawns multiple parallel
+ * worker sessions in the current project — one real session per task, each
+ * running the given prompt autonomously. Sessions appear immediately in the
+ * Studio session list; each worker's final message is its report.
+ *
+ * Fire-and-forget by design: no progress API, no result collection. The
+ * orchestrating agent only reports which sessions were created.
+ *
+ * Guardrails live in FanoutManager (src/server/fanout/fanout-manager.ts):
+ * recursion block, 20-task hard cap, concurrency semaphore, one active run
+ * per project, prompt dedupe/length limits.
+ */
+import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
+export declare const SESSION_FANOUT_TOOL_NAME = "session_fanout";
+export default function sessionFanoutExtension(ext: ExtensionAPI): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/extensions/session-fanout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/extensions/session-fanout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAEX,YAAY,EAEZ,MAAM,iCAAiC,CAAC;AASzC,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAuCzD,wBAA8B,sBAAsB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA+GrF"}

package/dist/extensions/session-fanout/index.js

@@ -0,0 +1,139 @@
+/**
+ * Session Fanout — native spectral extension.
+ *
+ * Registers a single tool, `session_fanout`, that spawns multiple parallel
+ * worker sessions in the current project — one real session per task, each
+ * running the given prompt autonomously. Sessions appear immediately in the
+ * Studio session list; each worker's final message is its report.
+ *
+ * Fire-and-forget by design: no progress API, no result collection. The
+ * orchestrating agent only reports which sessions were created.
+ *
+ * Guardrails live in FanoutManager (src/server/fanout/fanout-manager.ts):
+ * recursion block, 20-task hard cap, concurrency semaphore, one active run
+ * per project, prompt dedupe/length limits.
+ */
+import { getFanoutManager, MAX_TASKS_PER_FANOUT, FanoutError, } from "../../server/fanout/fanout-manager.js";
+export const SESSION_FANOUT_TOOL_NAME = "session_fanout";
+function fail(message) {
+    return {
+        content: [{ type: "text", text: `❌ session_fanout: ${message}` }],
+        details: { status: "error" },
+    };
+}
+function renderResult(result) {
+    const lines = [
+        `✅ Fanout ${result.runLabel} started: ${result.sessions.length} worker session(s) created ` +
+            `(max ${result.maxConcurrent} running at once).`,
+        "",
+    ];
+    for (const session of result.sessions) {
+        lines.push(`- ${session.key} → ${session.sessionId} "${session.title}"`);
+    }
+    if (result.skipped.length > 0) {
+        lines.push("", "Skipped tasks:");
+        for (const s of result.skipped) {
+            lines.push(`- ${s.key}: ${s.reason}`);
+        }
+    }
+    lines.push("", "The worker sessions are now visible in the session list. Each worker writes its report " +
+        "as the final message of its own session. Do not wait for them and do not poll — " +
+        "just tell the user the fanout is running and where to look.");
+    return lines.join("\n");
+}
+export default async function sessionFanoutExtension(ext) {
+    const tool = {
+        name: SESSION_FANOUT_TOOL_NAME,
+        label: "Session Fanout",
+        description: "Spawn multiple parallel worker sessions in the current project — one real session per task, " +
+            "each executing its own prompt autonomously. Sessions appear in the session list immediately. " +
+            `Use for batches of INDEPENDENT research/analysis tasks (e.g. gap analysis of up to ` +
+            `${MAX_TASKS_PER_FANOUT} well-described tasks against the codebase). Fire-and-forget: there is no ` +
+            "result collection — the user reads each worker's report in its own session, so each task prompt " +
+            "must be fully self-contained. Limits: max 20 tasks per call, 4 concurrent by default (hard cap 8), " +
+            "one active fanout per project, worker sessions cannot spawn further fanouts. " +
+            "Do NOT use for fewer than 2 tasks, and do NOT use it to run code edits in parallel.",
+        promptSnippet: "`session_fanout` — spawn parallel worker sessions for a batch of independent tasks (fire-and-forget; use sparingly)",
+        promptGuidelines: [
+            "Not a default tool: prefer doing the work in the current session, or the subagent tool when you need results returned to you; reach for session_fanout only for large batches (roughly 5 or more) of genuinely independent tasks, or when the user explicitly asks for parallel sessions.",
+            "Never for a single task, and never for quick lookups you can do yourself with grep/read — each spawned session is a real agent run that costs tokens and clutters the user's session list.",
+            "Never for code edits in parallel — worker sessions run in the same project without coordination.",
+            "Each task prompt must be self-contained — worker sessions share no context with you.",
+            "After spawning, report the created session ids/titles to the user and stop; results are read in the worker sessions themselves.",
+        ],
+        parameters: {
+            type: "object",
+            properties: {
+                tasks: {
+                    type: "array",
+                    description: `1-${MAX_TASKS_PER_FANOUT} tasks; one worker session is created per task.`,
+                    items: {
+                        type: "object",
+                        properties: {
+                            key: {
+                                type: "string",
+                                description: "Short stable identifier of the task, e.g. 'task-3'.",
+                            },
+                            title: {
+                                type: "string",
+                                description: "Human-readable session title (shown in the session list).",
+                            },
+                            prompt: {
+                                type: "string",
+                                description: "Full, self-contained prompt for the worker session (goal, scope, what the final report must contain).",
+                            },
+                        },
+                        required: ["key", "title", "prompt"],
+                    },
+                },
+                maxConcurrent: {
+                    type: "number",
+                    description: "Max worker prompts running at the same time (1-8, default 4).",
+                },
+            },
+            required: ["tasks"],
+        },
+        async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+            const fanout = getFanoutManager();
+            if (!fanout) {
+                return fail("session_fanout needs the server-side session manager, which only exists in sessions " +
+                    "hosted by a `spectral serve` process. Standalone CLI sessions have no session store, " +
+                    "so there is nothing to spawn worker sessions into.");
+            }
+            const sessionId = ctx?.sessionManager?.getSessionId?.() ?? "";
+            if (!sessionId) {
+                return fail("no session context.");
+            }
+            if (fanout.isFanoutChild(sessionId)) {
+                return fail("worker sessions cannot spawn further fanouts (recursion blocked).");
+            }
+            const cwd = ctx?.cwd ?? process.cwd();
+            const projectId = fanout.resolveProjectId(cwd);
+            if (!projectId) {
+                return fail(`no project is registered for working directory ${cwd}.`);
+            }
+            const rawTasks = params.tasks;
+            if (!Array.isArray(rawTasks)) {
+                return fail("`tasks` must be an array of {key, title, prompt}.");
+            }
+            const tasks = rawTasks.map((t) => ({
+                key: typeof t?.key === "string" ? t.key : "",
+                title: typeof t?.title === "string" ? t.title : "",
+                prompt: typeof t?.prompt === "string" ? t.prompt : "",
+            }));
+            const maxConcurrent = typeof params.maxConcurrent === "number" ? params.maxConcurrent : undefined;
+            try {
+                const result = fanout.start({ parentSessionId: sessionId, projectId, tasks, maxConcurrent });
+                return {
+                    content: [{ type: "text", text: renderResult(result) }],
+                    details: { status: "started", ...result },
+                };
+            }
+            catch (err) {
+                const msg = err instanceof FanoutError ? err.message : err instanceof Error ? err.message : String(err);
+                return fail(msg);
+            }
+        },
+    };
+    ext.registerTool(tool);
+}

package/dist/sdk/coding-agent/core/extensions/native-extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-extensions.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/coding-agent/core/extensions/native-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC;IAChD;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,cAAc,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,uBAAuB,EAuItD,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAElF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAI1G;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;IAClG,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC,CAUD"}
+{"version":3,"file":"native-extensions.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/coding-agent/core/extensions/native-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,CAAC;IAChD;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,cAAc,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,uBAAuB,EAkJtD,CAAC;AAEF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAElF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAI1G;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;IAClG,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC,CAUD"}

package/dist/sdk/coding-agent/core/extensions/native-extensions.js

@@ -141,6 +141,16 @@ export const NATIVE_EXTENSIONS = [
         defaultEnabled: true,
         tags: ["ports", "devops", "services", "collision", "docker", "network"],
     },
+    {
+        id: "session-fanout",
+        label: "Session Fanout",
+        description: "Spawns parallel worker sessions for batches of independent tasks (e.g. research or gap analysis). " +
+            "One real session per task, fire-and-forget; reports are read in each worker session.",
+        category: "automation",
+        entryPath: "src/extensions/session-fanout/index.ts",
+        defaultEnabled: true,
+        tags: ["sessions", "parallel", "fanout", "orchestration"],
+    },
 ];
 /**
  * Look up a native extension by id. Returns undefined for unknown ids.

package/dist/sdk/coding-agent/core/system-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../../../src/sdk/coding-agent/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CA2L3E"}
+{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../../../../src/sdk/coding-agent/core/system-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAyB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAEhE,MAAM,WAAW,wBAAwB;IACxC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6FAA6F;IAC7F,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,yBAAyB;IACzB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CA4L3E"}

package/dist/sdk/coding-agent/core/system-prompt.js

@@ -95,7 +95,8 @@ export function buildSystemPrompt(options) {
     const head = customPrompt
         ? customPrompt
         : `You are an expert coding agent operating inside spectral, a coding agent harness. ${delegationIntro} When discussing effort, frame each enhancement around a ~20-hour coding scope tied to a concrete feature boundary, avoiding calendar-day or week-based estimates.
-Prefer taking action over over-analyzing. If you have a reasonable next step, take it; don't loop on planning or re-reading the same files. Rely on error feedback from commands/tests to correct course rather than trying to predict every failure in advance.
+Be direct, helpful, and knowledgeable, and prioritize being genuinely useful over being verbose.
+Be targeted and efficient in your exploration and investigation: search first, read only the files you need to act, and don't loop on planning or re-reading the same files. Prefer taking action over over-analyzing — if you have a reasonable next step, take it, and rely on error feedback from commands/tests to correct course rather than trying to predict every failure in advance.
 
 ## Recommended workflow
 Work in short, verifiable steps and iterate:

package/dist/server/fanout/fanout-manager.d.ts

@@ -0,0 +1,126 @@
+/**
+ * FanoutManager — spawns parallel "worker" sessions for a batch of tasks.
+ *
+ * The main agent calls the `session_fanout` tool with a list of independent
+ * tasks (e.g. gap analysis of 20 well-described tasks against the codebase).
+ * Each task becomes a REAL session in the current project: a record is
+ * created in SQLite up front (so it appears in the Studio session list
+ * immediately) and the task prompt is sent through the existing
+ * SessionStreamManager, subject to a concurrency semaphore.
+ *
+ * Fire-and-forget: the manager does not collect results — the user reads
+ * each worker's final message directly in its session. State is process-
+ * local (no new tables); after a restart of `spectral serve` pending worker
+ * turns simply finish like any other session, and the in-memory recursion
+ * guard resets (recursion stays blocked at the tool-registration level
+ * because spawned sessions never outlive the manager's knowledge of them —
+ * see the session-fanout extension).
+ *
+ * Wiring: `configureFanout()` is called once from the SessionStreamManager
+ * constructor (next to `setInterAgentBroker`), which is the single place
+ * where both the manager and the SessionStore are available.
+ */
+import type { MetaEvent } from "@aexol/relay-protocol";
+import type { SessionStore } from "../storage.js";
+import type { SessionStreamManager } from "../session-stream.js";
+/** Hard cap on tasks accepted per `start()` call. */
+export declare const MAX_TASKS_PER_FANOUT = 20;
+/** Default number of worker prompts running at the same time. */
+export declare const DEFAULT_MAX_CONCURRENT = 4;
+/** Hard cap on the per-run concurrency requested by the caller. */
+export declare const HARD_CAP_CONCURRENT = 8;
+/** Maximum length of a single task prompt. Longer tasks are skipped. */
+export declare const MAX_PROMPT_LENGTH = 12000;
+/** Maximum length of a task title. */
+export declare const MAX_TITLE_LENGTH = 120;
+/** Maximum length of a task key. */
+export declare const MAX_KEY_LENGTH = 80;
+export interface FanoutTask {
+    key: string;
+    title: string;
+    prompt: string;
+}
+export interface FanoutStartInput {
+    parentSessionId: string;
+    projectId: string;
+    tasks: FanoutTask[];
+    maxConcurrent?: number;
+}
+export interface FanoutSessionRef {
+    key: string;
+    sessionId: string;
+    title: string;
+}
+export interface FanoutStartResult {
+    runId: string;
+    runLabel: string;
+    /** Concurrency actually applied after clamping. */
+    maxConcurrent: number;
+    sessions: FanoutSessionRef[];
+    /** Tasks rejected during validation, with a human-readable reason. */
+    skipped: Array<{
+        key: string;
+        reason: string;
+    }>;
+}
+/** Minimal surface of SessionStreamManager used by the fanout. */
+export interface FanoutManagerDeps {
+    manager: Pick<SessionStreamManager, "attach" | "prompt">;
+    store: Pick<SessionStore, "createSession" | "getProjectByCwd" | "appendMessage">;
+    /**
+     * Optional meta-event publisher — the same channel the REST dispatcher
+     * uses. Publishing `session_created` after each store.createSession is
+     * what makes fanout-spawned sessions appear live in connected UIs;
+     * without it they only show up after a manual refresh.
+     */
+    publishMetaEvent?: (event: MetaEvent) => void;
+}
+/** Error carrying a user-readable reason (surfaced verbatim in the tool result). */
+export declare class FanoutError extends Error {
+}
+export declare class FanoutManager {
+    private deps;
+    private readonly runs;
+    private readonly activeRunsByProject;
+    /** Every session ever spawned by a fanout in this process (recursion guard). */
+    private readonly spawnedSessionIds;
+    private runCounter;
+    /** Global concurrency cap across all runs (protects multi-project usage). */
+    private readonly globalSemaphore;
+    private readonly logger;
+    constructor(logger?: {
+        error: (...args: unknown[]) => void;
+    });
+    configure(deps: FanoutManagerDeps): void;
+    /**
+     * Wire the meta-event publisher (serve.ts, after the manager exists —
+     * the deferred wrapper no-ops until the relay is up, so ordering is
+     * safe). Without a publisher the tool still works; clients just don't
+     * get live session-list updates.
+     */
+    setMetaEventPublisher(publish: NonNullable<FanoutManagerDeps["publishMetaEvent"]>): void;
+    /** Resolve the project id for a working directory, or null. */
+    resolveProjectId(cwd: string): string | null;
+    /** True if the session was ever spawned as a fanout worker in this process. */
+    isFanoutChild(sessionId: string): boolean;
+    /**
+     * Validate input, create one session per accepted task (immediately
+     * visible in the session list) and kick off prompt dispatch in the
+     * background. Returns as soon as records exist — never awaits turns.
+     */
+    start(input: FanoutStartInput): FanoutStartResult;
+    private createWorkerSessions;
+    /**
+     * Publish `session_created` over the relay meta channel so every
+     * subscribed tab refreshes its session list immediately. Mirrors the
+     * dispatcher's safePublish: failures are logged, never propagated —
+     * the session record already exists.
+     */
+    private publishSessionCreated;
+    private executeRun;
+}
+export declare function configureFanout(deps: FanoutManagerDeps): FanoutManager;
+export declare function getFanoutManager(): FanoutManager | null;
+/** Test-only: drop the configured singleton. */
+export declare function resetFanoutManager(): void;
+//# sourceMappingURL=fanout-manager.d.ts.map

package/dist/server/fanout/fanout-manager.d.ts.map

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

package/dist/server/fanout/fanout-manager.js

@@ -0,0 +1,344 @@
+/**
+ * FanoutManager — spawns parallel "worker" sessions for a batch of tasks.
+ *
+ * The main agent calls the `session_fanout` tool with a list of independent
+ * tasks (e.g. gap analysis of 20 well-described tasks against the codebase).
+ * Each task becomes a REAL session in the current project: a record is
+ * created in SQLite up front (so it appears in the Studio session list
+ * immediately) and the task prompt is sent through the existing
+ * SessionStreamManager, subject to a concurrency semaphore.
+ *
+ * Fire-and-forget: the manager does not collect results — the user reads
+ * each worker's final message directly in its session. State is process-
+ * local (no new tables); after a restart of `spectral serve` pending worker
+ * turns simply finish like any other session, and the in-memory recursion
+ * guard resets (recursion stays blocked at the tool-registration level
+ * because spawned sessions never outlive the manager's knowledge of them —
+ * see the session-fanout extension).
+ *
+ * Wiring: `configureFanout()` is called once from the SessionStreamManager
+ * constructor (next to `setInterAgentBroker`), which is the single place
+ * where both the manager and the SessionStore are available.
+ */
+// ---------------------------------------------------------------------------
+// Guardrail constants
+// ---------------------------------------------------------------------------
+/** Hard cap on tasks accepted per `start()` call. */
+export const MAX_TASKS_PER_FANOUT = 20;
+/** Default number of worker prompts running at the same time. */
+export const DEFAULT_MAX_CONCURRENT = 4;
+/** Hard cap on the per-run concurrency requested by the caller. */
+export const HARD_CAP_CONCURRENT = 8;
+/** Maximum length of a single task prompt. Longer tasks are skipped. */
+export const MAX_PROMPT_LENGTH = 12_000;
+/** Maximum length of a task title. */
+export const MAX_TITLE_LENGTH = 120;
+/** Maximum length of a task key. */
+export const MAX_KEY_LENGTH = 80;
+/** Error carrying a user-readable reason (surfaced verbatim in the tool result). */
+export class FanoutError extends Error {
+}
+// ---------------------------------------------------------------------------
+// Semaphore
+// ---------------------------------------------------------------------------
+class Semaphore {
+    capacity;
+    active = 0;
+    waiters = [];
+    constructor(capacity) {
+        this.capacity = capacity;
+    }
+    /** Resolves with the release function once a slot is available. */
+    async acquire() {
+        if (this.active < this.capacity) {
+            this.active++;
+            return () => this.release();
+        }
+        return new Promise((resolve) => {
+            this.waiters.push(() => {
+                this.active++;
+                resolve(() => this.release());
+            });
+        });
+    }
+    release() {
+        this.active--;
+        const next = this.waiters.shift();
+        if (next)
+            next();
+    }
+}
+// ---------------------------------------------------------------------------
+// Manager
+// ---------------------------------------------------------------------------
+const noopSubscriber = {
+    send: () => { },
+    isOpen: () => false,
+};
+export class FanoutManager {
+    deps = null;
+    runs = new Map();
+    activeRunsByProject = new Map();
+    /** Every session ever spawned by a fanout in this process (recursion guard). */
+    spawnedSessionIds = new Set();
+    runCounter = 0;
+    /** Global concurrency cap across all runs (protects multi-project usage). */
+    globalSemaphore = new Semaphore(HARD_CAP_CONCURRENT);
+    logger;
+    constructor(logger) {
+        this.logger = logger ?? console;
+    }
+    configure(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Wire the meta-event publisher (serve.ts, after the manager exists —
+     * the deferred wrapper no-ops until the relay is up, so ordering is
+     * safe). Without a publisher the tool still works; clients just don't
+     * get live session-list updates.
+     */
+    setMetaEventPublisher(publish) {
+        if (!this.deps)
+            return; // not configured yet — nothing would receive it
+        this.deps.publishMetaEvent = publish;
+    }
+    /** Resolve the project id for a working directory, or null. */
+    resolveProjectId(cwd) {
+        return this.deps?.store.getProjectByCwd(cwd) ?? null;
+    }
+    /** True if the session was ever spawned as a fanout worker in this process. */
+    isFanoutChild(sessionId) {
+        return this.spawnedSessionIds.has(sessionId);
+    }
+    /**
+     * Validate input, create one session per accepted task (immediately
+     * visible in the session list) and kick off prompt dispatch in the
+     * background. Returns as soon as records exist — never awaits turns.
+     */
+    start(input) {
+        if (!this.deps) {
+            throw new FanoutError("session_fanout is only available while `spectral serve` is running.");
+        }
+        if (typeof input.parentSessionId !== "string" || input.parentSessionId.length === 0) {
+            throw new FanoutError("parentSessionId is required.");
+        }
+        if (typeof input.projectId !== "string" || input.projectId.length === 0) {
+            throw new FanoutError("projectId is required.");
+        }
+        if (this.isFanoutChild(input.parentSessionId)) {
+            throw new FanoutError("Recursion blocked: fanout worker sessions cannot spawn further fanouts.");
+        }
+        const activeRunId = this.activeRunsByProject.get(input.projectId);
+        if (activeRunId) {
+            throw new FanoutError(`A fanout run is already active in this project (${activeRunId}). ` +
+                "Wait for its workers to finish before starting another one.");
+        }
+        if (!Array.isArray(input.tasks) || input.tasks.length === 0) {
+            throw new FanoutError("`tasks` must be a non-empty array of {key, title, prompt}.");
+        }
+        if (input.tasks.length > MAX_TASKS_PER_FANOUT) {
+            throw new FanoutError(`Too many tasks: ${input.tasks.length} (hard cap ${MAX_TASKS_PER_FANOUT}). ` +
+                "Split the work into multiple smaller fanouts over several turns.");
+        }
+        this.runCounter++;
+        const runLabel = `F${this.runCounter}`;
+        const { sessions, skipped } = this.createWorkerSessions(input.tasks, input.projectId, runLabel);
+        if (sessions.length === 0) {
+            this.runCounter--;
+            throw new FanoutError("No valid tasks: " + (skipped.map((s) => `${s.key}: ${s.reason}`).join("; ") || "empty input."));
+        }
+        const maxConcurrent = clampConcurrency(input.maxConcurrent);
+        const runId = `fanout_${Date.now()}_${this.runCounter}`;
+        const run = {
+            runId,
+            runLabel,
+            projectId: input.projectId,
+            parentSessionId: input.parentSessionId,
+            childSessionIds: new Set(sessions.map((s) => s.sessionId)),
+            finished: false,
+        };
+        for (const session of sessions) {
+            this.spawnedSessionIds.add(session.sessionId);
+        }
+        this.runs.set(runId, run);
+        this.activeRunsByProject.set(input.projectId, runId);
+        // Background dispatch — never awaited by the tool (fire-and-forget).
+        void this.executeRun(run, input.tasks, sessions, maxConcurrent);
+        return { runId, runLabel, maxConcurrent, sessions, skipped };
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    createWorkerSessions(tasks, projectId, runLabel) {
+        const store = this.deps?.store;
+        if (!store)
+            throw new FanoutError("FanoutManager is not configured.");
+        const seenPrompts = new Set();
+        const seenKeys = new Set();
+        const sessions = [];
+        const skipped = [];
+        for (const task of tasks) {
+            const key = typeof task?.key === "string" ? task.key.trim() : "";
+            const title = typeof task?.title === "string" ? task.title.trim() : "";
+            const prompt = typeof task?.prompt === "string" ? task.prompt.trim() : "";
+            if (!key) {
+                skipped.push({ key: "(missing)", reason: "missing key" });
+                continue;
+            }
+            if (!title || !prompt) {
+                skipped.push({ key, reason: "missing title or prompt" });
+                continue;
+            }
+            if (key.length > MAX_KEY_LENGTH) {
+                skipped.push({ key, reason: `key longer than ${MAX_KEY_LENGTH} chars` });
+                continue;
+            }
+            if (title.length > MAX_TITLE_LENGTH) {
+                skipped.push({ key, reason: `title longer than ${MAX_TITLE_LENGTH} chars` });
+                continue;
+            }
+            if (prompt.length > MAX_PROMPT_LENGTH) {
+                skipped.push({ key, reason: `prompt longer than ${MAX_PROMPT_LENGTH} chars` });
+                continue;
+            }
+            if (seenPrompts.has(prompt)) {
+                skipped.push({ key, reason: "duplicate prompt" });
+                continue;
+            }
+            if (seenKeys.has(key)) {
+                skipped.push({ key, reason: "duplicate key" });
+                continue;
+            }
+            seenPrompts.add(prompt);
+            seenKeys.add(key);
+            try {
+                const summary = store.createSession({
+                    projectId,
+                    title: `[${runLabel}] ${title}`,
+                });
+                sessions.push({ key, sessionId: summary.id, title: summary.title });
+                this.publishSessionCreated(projectId, summary.id);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                skipped.push({ key, reason: `session creation failed: ${msg}` });
+            }
+        }
+        return { sessions, skipped };
+    }
+    /**
+     * Publish `session_created` over the relay meta channel so every
+     * subscribed tab refreshes its session list immediately. Mirrors the
+     * dispatcher's safePublish: failures are logged, never propagated —
+     * the session record already exists.
+     */
+    publishSessionCreated(projectId, sessionId) {
+        const publish = this.deps?.publishMetaEvent;
+        if (!publish)
+            return;
+        try {
+            publish({ type: "session_created", projectId, sessionId });
+        }
+        catch (err) {
+            this.logger.error("[fanout] publishMetaEvent(session_created) failed:", err);
+        }
+    }
+    async executeRun(run, tasks, sessions, maxConcurrent) {
+        const deps = this.deps;
+        if (!deps)
+            return;
+        // Prompt lookup: sessions[] is parallel to the accepted (non-skipped) tasks.
+        const accepted = new Map();
+        for (const ref of sessions)
+            accepted.set(ref.key, ref);
+        const runSemaphore = new Semaphore(maxConcurrent);
+        await Promise.all(sessions.map(async (ref) => {
+            const task = tasks.find((t) => t.key === ref.key);
+            if (!task)
+                return;
+            const releaseRun = await runSemaphore.acquire();
+            const releaseGlobal = await this.globalSemaphore.acquire();
+            try {
+                await deps.manager.attach(ref.sessionId, noopSubscriber);
+                const content = buildWorkerPrompt(run.runLabel, ref.key, task.prompt, sessions.length);
+                // Persist the task message here, not inside prompt(): prompt()
+                // waits for the agent bridge to become ready first (bootstrap
+                // can take minutes when creation is queued) and only then
+                // writes the user message — until that moment the worker
+                // session shows an empty message list in Studio even though
+                // it is already in the session list. The prompt below then
+                // runs with skipPersistence (auto-research pattern) so the
+                // message is not written twice.
+                let persisted = false;
+                try {
+                    deps.store.appendMessage(ref.sessionId, { role: "user", content });
+                    persisted = true;
+                }
+                catch (err) {
+                    this.logger.error(`[fanout:${run.runId}] worker ${ref.key}: pre-persisting the task message failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                await deps.manager.prompt(ref.sessionId, content, undefined, undefined, undefined, persisted ? { skipPersistence: true } : undefined);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                this.logger.error(`[fanout:${run.runId}] worker ${ref.key} (${ref.sessionId}) failed: ${msg}`);
+            }
+            finally {
+                releaseGlobal();
+                releaseRun();
+            }
+        }));
+        run.finished = true;
+        if (this.activeRunsByProject.get(run.projectId) === run.runId) {
+            this.activeRunsByProject.delete(run.projectId);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Prompt building
+// ---------------------------------------------------------------------------
+function buildWorkerPrompt(runLabel, key, prompt, total) {
+    return [
+        `You are a focused worker session spawned by \`session_fanout\` (run ${runLabel}, task ${key}, 1 of ${total}).`,
+        "",
+        "Work autonomously on the task below. Do not ask questions — make reasonable assumptions and state them.",
+        "Your final message is the report the user will read in this session, so make it self-contained.",
+        "",
+        "--- TASK ---",
+        prompt,
+    ].join("\n");
+}
+function clampConcurrency(raw) {
+    const n = typeof raw === "number" ? Math.floor(raw) : DEFAULT_MAX_CONCURRENT;
+    if (!Number.isFinite(n))
+        return DEFAULT_MAX_CONCURRENT;
+    return Math.max(1, Math.min(HARD_CAP_CONCURRENT, n));
+}
+// ---------------------------------------------------------------------------
+// Singleton (wired from SessionStreamManager's constructor)
+//
+// Stored on globalThis under a registered symbol instead of a module-level
+// variable. In the repo/dev layout the session-fanout extension is loaded
+// from src/ via jiti while the server runs from dist/, so this module exists
+// as TWO instances in one process. A module-level singleton would be set in
+// the dist instance but read as null in the jiti instance; a globalThis slot
+// is shared by both.
+// ---------------------------------------------------------------------------
+const FANOUT_SINGLETON_KEY = Symbol.for("aexol.sessionFanoutManager");
+function holder() {
+    return globalThis;
+}
+export function configureFanout(deps) {
+    const h = holder();
+    if (!h[FANOUT_SINGLETON_KEY])
+        h[FANOUT_SINGLETON_KEY] = new FanoutManager();
+    h[FANOUT_SINGLETON_KEY].configure(deps);
+    return h[FANOUT_SINGLETON_KEY];
+}
+export function getFanoutManager() {
+    return holder()[FANOUT_SINGLETON_KEY] ?? null;
+}
+/** Test-only: drop the configured singleton. */
+export function resetFanoutManager() {
+    delete holder()[FANOUT_SINGLETON_KEY];
+}

package/dist/server/session-stream.d.ts.map

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

package/dist/server/session-stream.js

@@ -41,6 +41,7 @@ import { AgentBridge } from "./agent-bridge.js";
 import { SettingsManager, } from "../sdk/coding-agent/index.js";
 import { InterAgentBroker } from "./inter-agent-broker.js";
 import { setInterAgentBroker } from "../memory/inter-agent-broker-singleton.js";
+import { configureFanout } from "./fanout/fanout-manager.js";
 import { CONTEXT_LIMIT_RATIO, DEFAULT_COMPACTION_POLICY, getAutoOlderHistoryContextThresholdTokens, } from "../sdk/coding-agent/core/compaction/policy.js";
 import { getMemoryState, isSourceEntry, rawTokensSinceLastBound, rawTokensSinceLastCompaction, } from "../memory/branch.js";
 import { observationPoolTokens, renderSummary } from "../memory/compaction.js";
@@ -541,6 +542,9 @@ export class SessionStreamManager {
         // Wire the inter-agent broker singleton so the memory extension can send
         // and receive live observation messages between active sessions.
         setInterAgentBroker(this.broker);
+        // Wire the fanout manager singleton so the session-fanout extension can
+        // spawn parallel worker sessions through this manager.
+        configureFanout({ manager: this, store: this.store });
     }
     /**
      * Update the machine JWT used by all future AgentBridge instances.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.199",
+  "version": "0.9.200",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,