@aexol/spectral 0.9.221 → 0.9.223

package/dist/server/agent-bridge.js

@@ -62,26 +62,23 @@ import codeOrderExtension from "../extensions/code-order/index.js";
 import { BrowserService } from "../extensions/browser/browser-service.js";
 import subagentExt from "../agent/index.js";
 import designerExtension from "../designer/index.js";
+import logicTraceExtension from "../extensions/logic-trace.js";
 import observationalMemory from "../memory/index.js";
 import { OBSERVATIONAL_MEMORY_CONTEXT_CUSTOM_TYPE, OBSERVATIONAL_MEMORY_SNAPSHOT_CUSTOM_TYPE, } from "../memory/types.js";
 import { fetchAllowedModels as defaultFetchAllowedModels, } from "../relay/models-fetch.js";
 import { humanizeProviderError } from "./error-humanizer.js";
-import { createBridgeConfirm, createStdinConfirmIO, } from "./ui/terminal-confirm.js";
 import { readStudioBinding, getBindingFilePath } from "../studio-binding.js";
-/**
- * Synthetic provider names registered with spectral's `ModelRegistry`. They route
- * 100% of inference traffic through the backend (`${backendUrl}/v1`), which
- * authenticates with the machine JWT and forwards to the upstream provider
- * with centrally-managed API keys.
- *
- * Two providers (rather than one): `spectral-proxy-openai` for upstream catalog
- * models (OpenRouter, DeepSeek, OpenAI, etc.), and
- * `spectral-proxy-user-model` for team-registered built-in UserModel entries.
- * Both use the OpenAI-compatible `/chat/completions` request shape.
- */
-const SPECTRAL_PROXY_OPENAI = "spectral-proxy-openai";
-const SPECTRAL_PROXY_USER_MODEL = "spectral-proxy-user-model";
-const KIMI_K2_7_CODE_CONTEXT_WINDOW = 262_144;
+// Facade imports: cohesive helpers extracted verbatim to `./agent-bridge/` modules.
+import { calculateCredits, getModelCost, resolveCreditRatesForModel, } from "./agent-bridge/pricing.js";
+import { SPECTRAL_PROXY_OPENAI, SPECTRAL_PROXY_USER_MODEL, inferSyntheticContextWindow, inferSyntheticOpenAICompat, inferSyntheticThinkingLevelMap, } from "./agent-bridge/synthetic-model.js";
+import { parseWireToolEvents, sanitizeRehydratedBlock, toRestoredMemorySnapshot, } from "./agent-bridge/rehydrate.js";
+import { createHeadlessUIContext } from "./agent-bridge/headless-ui.js";
+// Facade re-exports: moved helpers remain importable from this module so
+// existing (and future) importers of `agent-bridge.js` are unaffected.
+export { bareModelId, calculateCredits, getModelCost, lookupPricing, } from "./agent-bridge/pricing.js";
+export { SPECTRAL_PROXY_OPENAI, SPECTRAL_PROXY_USER_MODEL, inferSyntheticContextWindow, inferSyntheticOpenAICompat, inferSyntheticThinkingLevelMap, } from "./agent-bridge/synthetic-model.js";
+export { parseWireToolEvents, sanitizeRehydratedBlock, toRestoredMemorySnapshot, } from "./agent-bridge/rehydrate.js";
+export { createHeadlessUIContext } from "./agent-bridge/headless-ui.js";
 /**
  * Walk ancestor directories from `cwd` up to the filesystem root, collecting
  * any existing skill directories at the given relative paths (e.g.
@@ -133,280 +130,7 @@ function extractTextFromContent(content) {
     }
     return out;
 }
-/**
- * Token pricing per model (USD per 1M tokens). Matches provider list
- * prices as of May 2026. Used to compute token cost server-side when
- * spectral's own cost field is unavailable (synthetic proxy models are
- * registered with zero cost to avoid agent-side billing).
- *
- * Keys are matched as prefix substrings against modelId, so
- * `"gpt-5"` covers both `gpt-5` and any
- * future point-release.
- */
-const MODEL_PRICING = [
-    // OpenAI models
-    {
-        prefix: "gpt-5.5",
-        input: 1.75,
-        output: 14,
-        cacheWrite: 14,
-        cacheRead: 0.35,
-    },
-    {
-        prefix: "gpt-5.4",
-        input: 1.75,
-        output: 14,
-        cacheWrite: 14,
-        cacheRead: 0.35,
-    },
-    {
-        prefix: "gpt-5.3",
-        input: 1.75,
-        output: 14,
-        cacheWrite: 14,
-        cacheRead: 0.35,
-    },
-    {
-        prefix: "gpt-5.2",
-        input: 1.75,
-        output: 14,
-        cacheWrite: 14,
-        cacheRead: 0.35,
-    },
-    { prefix: "gpt-5.1", input: 2, output: 8, cacheWrite: 8, cacheRead: 0.5 },
-    { prefix: "gpt-5", input: 1.25, output: 10, cacheWrite: 10, cacheRead: 0.25 },
-    { prefix: "gpt-4.1", input: 2, output: 8, cacheWrite: 8, cacheRead: 0.5 },
-    { prefix: "gpt-4o", input: 2.5, output: 10, cacheWrite: 10, cacheRead: 1.25 },
-    { prefix: "gpt-4-turbo", input: 10, output: 30, cacheWrite: 0, cacheRead: 0 },
-    { prefix: "gpt-4", input: 30, output: 60, cacheWrite: 0, cacheRead: 0 },
-    {
-        prefix: "gpt-3.5-turbo",
-        input: 0.5,
-        output: 1.5,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-    { prefix: "o1", input: 15, output: 60, cacheWrite: 0, cacheRead: 0 },
-    { prefix: "o3-mini", input: 1.1, output: 4.4, cacheWrite: 0, cacheRead: 0 },
-    { prefix: "o4-mini", input: 1.1, output: 4.4, cacheWrite: 0, cacheRead: 0 },
-    // Google Gemini models
-    {
-        prefix: "gemini-2.5-pro",
-        input: 1.25,
-        output: 10,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-    {
-        prefix: "gemini-2.5-flash",
-        input: 0.15,
-        output: 0.6,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-    // DeepSeek models
-    {
-        prefix: "deepseek-v3",
-        input: 0.27,
-        output: 1.1,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-    {
-        prefix: "deepseek-r1",
-        input: 0.55,
-        output: 2.19,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-    {
-        prefix: "deepseek/deepseek-v3",
-        input: 0.27,
-        output: 1.1,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-    {
-        prefix: "deepseek/deepseek-r1",
-        input: 0.55,
-        output: 2.19,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-    // Meta Llama models (common via OpenRouter-compatible endpoints)
-    {
-        prefix: "meta-llama/llama-4",
-        input: 0.2,
-        output: 0.8,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-    {
-        prefix: "meta-llama/llama-3.3",
-        input: 0.2,
-        output: 0.5,
-        cacheWrite: 0,
-        cacheRead: 0,
-    },
-];
-/**
- * Strip vendor prefix to extract the bare model name.
- * e.g. "openai/gpt-5.3-codex" → "gpt-5.3-codex".
- * Returns the original string when no separator is present.
- */
-function bareModelId(modelId) {
-    const idx = modelId.lastIndexOf("/");
-    return idx === -1 ? modelId : modelId.slice(idx + 1);
-}
-function inferSyntheticContextWindow(model) {
-    if (typeof model.contextWindow === "number" &&
-        Number.isFinite(model.contextWindow)) {
-        return model.contextWindow;
-    }
-    const modelId = model.modelId.toLowerCase();
-    const bare = bareModelId(modelId);
-    if (modelId === "moonshotai/kimi-k2.7-code" ||
-        bare === "kimi-k2.7-code" ||
-        bare === "local-openrouter-kimi") {
-        return KIMI_K2_7_CODE_CONTEXT_WINDOW;
-    }
-    return 0;
-}
 /** Get model cost from backend credit rates, falling back to hardcoded pricing table. */
-function getModelCost(m) {
-    // Prefer backend credit rates when configured
-    const hasCredits = m.creditInputPer1M != null ||
-        m.creditOutputPer1M != null ||
-        m.creditCacheReadPer1M != null ||
-        m.creditCacheWritePer1M != null;
-    if (hasCredits) {
-        return {
-            input: m.creditInputPer1M ?? 0,
-            output: m.creditOutputPer1M ?? 0,
-            cacheRead: m.creditCacheReadPer1M ?? 0,
-            cacheWrite: m.creditCacheWritePer1M ?? 0,
-        };
-    }
-    // Fall back to hardcoded pricing table when credits aren't configured
-    const pricing = lookupPricing(m.modelId);
-    return pricing
-        ? {
-            input: pricing.input,
-            output: pricing.output,
-            cacheRead: pricing.cacheRead,
-            cacheWrite: pricing.cacheWrite,
-        }
-        : { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
-}
-/** Look up pricing for a modelId. Returns null when unknown. */
-function lookupPricing(modelId) {
-    const bare = bareModelId(modelId);
-    for (const entry of MODEL_PRICING) {
-        if (modelId.startsWith(entry.prefix) || bare.startsWith(entry.prefix)) {
-            return {
-                input: entry.input,
-                output: entry.output,
-                cacheWrite: entry.cacheWrite,
-                cacheRead: entry.cacheRead,
-            };
-        }
-    }
-    return null;
-}
-function inferSyntheticThinkingLevelMap(model) {
-    if (!model.supportsReasoning)
-        return undefined;
-    const modelId = model.modelId.toLowerCase();
-    const bare = bareModelId(modelId);
-    if (model.provider === "built-in" &&
-        (modelId.includes("gpt-5") || bare.includes("gpt-5"))) {
-        return {
-            off: "none",
-            minimal: "minimal",
-            low: "low",
-            medium: "medium",
-            high: "high",
-            xhigh: "xhigh",
-        };
-    }
-    return undefined;
-}
-function inferSyntheticOpenAICompat(model) {
-    const bare = bareModelId(model.modelId);
-    const isDeepSeek = model.provider === "deepseek" ||
-        model.modelId.startsWith("deepseek/") ||
-        bare.startsWith("deepseek");
-    if (isDeepSeek) {
-        return {
-            thinkingFormat: "deepseek",
-            requiresReasoningContentOnAssistantMessages: true,
-            supportsDeveloperRole: false,
-        };
-    }
-    if (model.provider === "built-in") {
-        const compat = {
-            // Built-in models are proxied through the backend, which forwards a
-            // session-affinity key to OpenRouter for prompt-cache sticky routing.
-            // Sending the real per-session id from the CLI lets the backend use it
-            // instead of a coarser machine/team fallback, maximizing cache hits on
-            // large multi-turn agentic prompts.
-            sendSessionAffinityHeaders: true,
-        };
-        if (model.modelId.toLowerCase().includes("gpt-5") ||
-            bare.toLowerCase().includes("gpt-5")) {
-            compat.thinkingFormat = "openai";
-            compat.supportsReasoningEffort = true;
-            compat.supportsStore = false;
-        }
-        return compat;
-    }
-    if (model.provider === "openrouter") {
-        const compat = {
-            thinkingFormat: "openrouter",
-        };
-        return compat;
-    }
-    return undefined;
-}
-/**
- * Calculate credits from token usage using per-model credit rates.
- *
- * NOTE: We intentionally keep higher precision here (no 2-decimal rounding)
- * so small turns don't collapse to 0.00 in live UI aggregation. Rendering
- * layers decide final display precision.
- */
-function calculateCredits(inputTokens, outputTokens, cacheReadTokens = 0, cacheWriteTokens = 0, creditInputPer1M, creditOutputPer1M, creditCachedInputPer1M, creditCacheReadPer1M, creditCacheWritePer1M) {
-    const inputRate = creditInputPer1M ?? 0;
-    const outputRate = creditOutputPer1M ?? 0;
-    const cachedInputRate = creditCachedInputPer1M ?? 0;
-    const cacheReadRate = creditCacheReadPer1M ?? 0;
-    const cacheWriteRate = creditCacheWritePer1M ?? 0;
-    const credits = (inputTokens / 1_000_000) * inputRate +
-        (outputTokens / 1_000_000) * outputRate +
-        (cacheReadTokens / 1_000_000) * cacheReadRate +
-        (cacheWriteTokens / 1_000_000) * cacheWriteRate;
-    if (inputRate === 0 &&
-        outputRate === 0 &&
-        cacheReadRate === 0 &&
-        cacheWriteRate === 0) {
-        if (cachedInputRate > 0) {
-            return (((inputTokens + cacheReadTokens + cacheWriteTokens) / 1_000_000) *
-                cachedInputRate);
-        }
-        return 0;
-    }
-    return credits;
-}
-/**
- * Parse the newline-delimited JSON of wire events persisted alongside an
- * assistant message and extract all tool_call / tool_result events.
- *
- * These are used during session rehydration to reconstruct the full tool
- * interaction history (call → result) so the LLM context is complete —
- * without this, reconnected sessions would see only the assistant text
- * and never the tool results, causing the model to get confused about
- * the conversation state.
- */
 /**
  * Map a wire `ImageAttachment` onto a spectral `ImageContent` block.
  *
@@ -434,115 +158,6 @@ function toImageContent(image) {
     }
     return null;
 }
-function parseWireToolEvents(eventsJsonl) {
-    const toolCalls = [];
-    const toolResults = [];
-    if (!eventsJsonl)
-        return { toolCalls, toolResults };
-    for (const line of eventsJsonl.split("\n")) {
-        const trimmed = line.trim();
-        if (!trimmed)
-            continue;
-        try {
-            const ev = JSON.parse(trimmed);
-            if (ev.type === "tool_call") {
-                toolCalls.push({
-                    id: ev.id,
-                    name: ev.name,
-                    arguments: ev.args,
-                });
-            }
-            else if (ev.type === "tool_result") {
-                toolResults.push({
-                    id: ev.id,
-                    result: ev.result,
-                    isError: ev.isError ?? false,
-                });
-            }
-        }
-        catch {
-            // Skip malformed JSON lines — they won't be meaningful for
-            // rehydration and we'd rather keep the session alive than fail.
-        }
-    }
-    return { toolCalls, toolResults };
-}
-/**
- * Safety clean-up for content blocks rehydrated from persisted wire events.
- *
- * Rehydrated tool-result content is bounded for the model-facing context,
- * while the original wire event remains available to the UI for rendering
- * images and other rich results.
- */
-const MAX_REHYDRATED_TEXT = 100_000;
-/**
- * Ceiling for blocks that already carry an offload footer (`Full output:`).
- * These blocks are a bounded preview + a re-readable path, so cutting them
- * with the generic limit would destroy the footer. Keep them whole up to
- * this size; larger ones lose their middle but keep head + footer.
- */
-const MAX_REHYDRATED_OFFLOAD_TEXT = 200_000;
-function sanitizeRehydratedBlock(block) {
-    // Tool-result image blocks are not accepted by every provider; the raw
-    // result remains in events_jsonl for the UI, while the model gets a compact reference.
-    if (block.type === "image") {
-        // Hosted images carry a url instead of inline bytes — print that rather
-        // than a meaningless "0 bytes base64".
-        const hostedUrl = typeof block.url === "string" && block.url ? block.url : undefined;
-        const descriptor = hostedUrl
-            ? `[Image: ${block.mimeType ?? "image/png"}, url: ${hostedUrl}]`
-            : `[Image: ${block.mimeType ?? "image/png"}, ${(typeof block.data === "string" ? block.data.length : 0).toLocaleString()} bytes base64]`;
-        return {
-            type: "text",
-            text: descriptor +
-                `\n(Image data is available in the raw MCP result.)`,
-        };
-    }
-    // Truncate oversized text blocks to prevent context overflow.
-    if (block.type !== "text")
-        return block;
-    if (block.text.includes("Full output:")) {
-        if (block.text.length <= MAX_REHYDRATED_OFFLOAD_TEXT)
-            return block;
-        // Keep the head (preview) and the tail (offload footer), drop the middle.
-        const keepHead = Math.floor(MAX_REHYDRATED_OFFLOAD_TEXT * 0.7);
-        const keepTail = MAX_REHYDRATED_OFFLOAD_TEXT - keepHead;
-        const omitted = block.text.length - keepHead - keepTail;
-        return {
-            ...block,
-            text: block.text.slice(0, keepHead) +
-                `\n\n[... ${omitted.toLocaleString()} bytes omitted from rehydrated offload preview ...]\n\n` +
-                block.text.slice(block.text.length - keepTail),
-        };
-    }
-    if (block.text.length <= MAX_REHYDRATED_TEXT)
-        return block;
-    const omitted = block.text.length - MAX_REHYDRATED_TEXT;
-    return {
-        ...block,
-        text: block.text.slice(0, MAX_REHYDRATED_TEXT) +
-            `\n\n[truncated — ${omitted.toLocaleString()} bytes omitted]`,
-    };
-}
-function normalizeSnapshotDetails(details) {
-    if (details.version === 4)
-        return details;
-    return {
-        type: "observational-memory",
-        version: 4,
-        observations: details.observations,
-        reflections: details.reflections,
-    };
-}
-function toRestoredMemorySnapshot(snapshot) {
-    return {
-        type: "observational-memory-snapshot",
-        version: 1,
-        coveredSourceCount: snapshot.coveredSourceCount,
-        summary: snapshot.summary,
-        details: normalizeSnapshotDetails(snapshot.details),
-    };
-}
 /**
  * Inactivity-based prompt hang watchdog. Unlike a fixed wall-clock deadline,
  * this only fires when the agent session has emitted NO *meaningful* progress
@@ -655,9 +270,24 @@ export class AgentBridge {
      * timer flushes it once the minimum interval has elapsed.
      */
     subagentProgressThrottle = new Map();
+    /**
+     * toolCallId → startedAt captured at `tool_execution_start` so the
+     * terminal `tool_result` can carry the real start time (durations
+     * end-to-end). Entries with no end event are bounded: more than 2000
+     * orphans means ids are never resolving, so the oldest are cleared.
+     */
+    toolStartedAt = new Map();
     constructor(opts) {
         this.opts = opts;
     }
+    /**
+     * Resolve credit rates for a subagent result. Subagents may run a
+     * different model than the parent — see pricing.resolveCreditRatesForModel
+     * for the model-matching rule.
+     */
+    resolveSubagentCreditRates(modelId) {
+        return resolveCreditRatesForModel(modelId, this.allowedModels, this.activeCreditRates);
+    }
     /**
      * Create the spectral session, wire up subscription, and return.
      * Throws on creation failure (caller should surface to client).
@@ -708,6 +338,14 @@ export class AgentBridge {
             async (ext) => {
                 designerExtension(ext);
             },
+            // Logic trace: keeps the ONE logic.aexol file in the bound Studio
+            // project refreshed the same way observations are (turn_end +
+            // threshold + singleton + passive). Registered BEFORE
+            // observationalMemory so its forced session_before_compact flush runs
+            // before the memory compaction hook produces the summary.
+            async (ext) => {
+                logicTraceExtension(ext);
+            },
             async (ext) => {
                 observationalMemory(ext);
             },
@@ -1930,6 +1568,10 @@ export class AgentBridge {
                 if (ev.toolName !== "subagent") {
                     this.startToolExecutionTimer();
                 }
+                // pi agent events carry no timestamps; Date.now() at emit time is
+                // the same source the subagent tool-progress path uses. Computed once
+                // per execution start so subagent_start and tool_call share the stamp.
+                const startedAt = Date.now();
                 // Emit subagent_start for subagent tool invocations (Option B frontend panels).
                 if (ev.toolName === "subagent") {
                     // The parent prompt is now waiting on the child agent. Pause the
@@ -1945,6 +1587,7 @@ export class AgentBridge {
                     const se = {
                         type: "subagent_start",
                         toolCallId: ev.toolCallId,
+                        startedAt,
                         mode,
                         agent: typeof args?.agent === "string" ? args.agent : undefined,
                         task: typeof args?.task === "string" ? args.task : undefined,
@@ -1963,7 +1606,16 @@ export class AgentBridge {
                     id: ev.toolCallId,
                     name: ev.toolName,
                     args: ev.args,
+                    startedAt,
                 });
+                // Persist the same start stamp so the terminal `tool_result` below
+                // can echo it (the wire schema declares `tool_result.startedAt`).
+                this.toolStartedAt.set(ev.toolCallId, startedAt);
+                if (this.toolStartedAt.size > 2000) {
+                    const oldest = this.toolStartedAt.keys().next().value;
+                    if (oldest !== undefined)
+                        this.toolStartedAt.delete(oldest);
+                }
                 return;
             }
             case "tool_execution_update": {
@@ -2075,27 +1727,37 @@ export class AgentBridge {
                             }
                             return "(no output)";
                         };
-                        const results = details.results.map((r) => ({
-                            agent: r.agent,
-                            agentSource: r.agentSource ?? "unknown",
-                            task: r.task,
-                            exitCode: r.exitCode,
-                            output: getOutput(r.messages),
-                            model: r.model,
-                            errorMessage: r.errorMessage,
-                            stopReason: r.stopReason,
-                            step: r.step,
-                            systemPrompt: r.systemPrompt,
-                            firstMessage: r.firstMessage,
-                            usage: {
+                        const results = details.results.map((r) => {
+                            const usage = {
                                 inputTokens: r.usage?.input ?? 0,
                                 outputTokens: r.usage?.output ?? 0,
                                 cacheReadTokens: r.usage?.cacheRead ?? 0,
                                 cacheWriteTokens: r.usage?.cacheWrite ?? 0,
                                 cost: r.usage?.cost ?? 0,
                                 turns: r.usage?.turns ?? 0,
-                            },
-                        }));
+                            };
+                            // Credits use per-subagent-model rates when the model is known
+                            // (subagents may run a different model than the parent);
+                            // otherwise the parent's active rates apply.
+                            const rates = this.resolveSubagentCreditRates(r.model);
+                            const creditsUsed = calculateCredits(usage.inputTokens, usage.outputTokens, usage.cacheReadTokens, usage.cacheWriteTokens, rates?.creditInputPer1M, rates?.creditOutputPer1M, rates?.creditCachedInputPer1M, rates?.creditCacheReadPer1M, rates?.creditCacheWritePer1M);
+                            return {
+                                agent: r.agent,
+                                agentSource: r.agentSource ??
+                                    "unknown",
+                                task: r.task,
+                                exitCode: r.exitCode,
+                                output: getOutput(r.messages),
+                                model: r.model,
+                                errorMessage: r.errorMessage,
+                                stopReason: r.stopReason,
+                                step: r.step,
+                                systemPrompt: r.systemPrompt,
+                                firstMessage: r.firstMessage,
+                                attempts: r.attempts,
+                                usage: { ...usage, creditsUsed },
+                            };
+                        });
                         const totalUsage = results.reduce((acc, r) => ({
                             inputTokens: acc.inputTokens + r.usage.inputTokens,
                             outputTokens: acc.outputTokens + r.usage.outputTokens,
@@ -2103,6 +1765,7 @@ export class AgentBridge {
                             cacheWriteTokens: acc.cacheWriteTokens + r.usage.cacheWriteTokens,
                             cost: acc.cost + r.usage.cost,
                             turns: acc.turns + r.usage.turns,
+                            creditsUsed: acc.creditsUsed + (r.usage.creditsUsed ?? 0),
                         }), {
                             inputTokens: 0,
                             outputTokens: 0,
@@ -2110,10 +1773,13 @@ export class AgentBridge {
                             cacheWriteTokens: 0,
                             cost: 0,
                             turns: 0,
+                            creditsUsed: 0,
                         });
                         const se = {
                             type: "subagent_end",
                             toolCallId: ev.toolCallId,
+                            startedAt: this.toolStartedAt.get(ev.toolCallId),
+                            finishedAt: Date.now(),
                             mode,
                             results,
                             totalUsage,
@@ -2127,7 +1793,10 @@ export class AgentBridge {
                     id: ev.toolCallId,
                     result: ev.result,
                     isError: ev.isError,
+                    startedAt: this.toolStartedAt.get(ev.toolCallId) ?? Date.now(),
+                    finishedAt: Date.now(),
                 });
+                this.toolStartedAt.delete(ev.toolCallId);
                 return;
             }
             case "message_end": {
@@ -2327,87 +1996,3 @@ export class AgentBridge {
         }
     }
 }
-// ---------------------------------------------------------------------------
-// Headless UI context
-// ---------------------------------------------------------------------------
-/**
- * Detect the memory subsystem from a notification message text.
- * The memory extension prefixes all messages with "Observational memory:".
- */
-function detectMemorySystem(message) {
-    if (!message.startsWith("Observational memory:"))
-        return undefined;
-    const lower = message.toLowerCase();
-    if (lower.includes("observer"))
-        return "memory_observer";
-    if (lower.includes("compaction") || lower.includes("compact"))
-        return "memory_compaction";
-    if (lower.includes("reflection") || lower.includes("reflect"))
-        return "memory_reflection";
-    if (lower.includes("pruner") || lower.includes("prune"))
-        return "memory_pruner";
-    // Keep generic observational-memory messages visible in the landing badge.
-    return "memory_observer";
-}
-/**
- * Detect subsystem from notification messages by known prefix.
- * Returns undefined for generic extension messages without a matching prefix.
- */
-function detectNotifSystem(message) {
-    if (message.startsWith("[spectral-vision]"))
-        return "vision";
-    return detectMemorySystem(message);
-}
-/**
- * Create a minimal ExtensionUIContext that forwards `notify()` calls as
- * `agent_notification` wire events, and renders `confirm()` as a terminal-
- * native permission prompt on serve's stdout (the terminal `spectral serve`
- * runs in) so extensions like desktop-control can request real user approval
- * while the user chats via the web UI. A prompt also emits an
- * `agent_notification` ("Approval required in terminal: …") so web users know
- * to look at the terminal. Confirmations are serialized across sessions and
- * auto-deny on timeout (SPECTRAL_CONFIRM_TIMEOUT_MS, default 5 min) or when
- * stdin is not a TTY. All other interactive UI methods (select/input/custom/
- * editor) remain no-ops resolving `undefined`.
- */
-function createHeadlessUIContext(emit) {
-    const terminalIO = createStdinConfirmIO();
-    // Defer to a Proxy so we don't need to stub every method.
-    // `notify` and `confirm` are the methods called by extensions in serve mode
-    // (observational memory, MCP status bar updates, spectral-vision,
-    // desktop-control).
-    const handler = {
-        get(_target, prop) {
-            if (prop === "notify") {
-                return (message, type, metadata) => {
-                    const level = type ?? "info";
-                    const system = detectNotifSystem(message);
-                    if (system?.startsWith("memory_")) {
-                        console.info(`[AgentBridge][memory][${level}] ${message}`);
-                    }
-                    else if (system === "vision") {
-                        console.info(`[AgentBridge][vision][${level}] ${message}`);
-                    }
-                    emit({
-                        type: "agent_notification",
-                        message,
-                        level,
-                        system,
-                        dcpLiteTelemetry: metadata?.dcpLiteTelemetry,
-                    });
-                };
-            }
-            // All other methods: return a no-op function or undefined.
-            // Methods that return Promises (select, confirm, input, custom, editor)
-            if (prop === "confirm") {
-                return createBridgeConfirm(emit, terminalIO);
-            }
-            // resolve to `undefined`. `confirm` above is the one interactive method
-            // with a real terminal-native implementation.
-            // Methods that set state (setStatus, setWorkingMessage, setWidget, etc.)
-            // are safe to no-op.
-            return () => undefined;
-        },
-    };
-    return new Proxy({}, handler);
-}