@aexol/spectral 0.9.231 → 0.9.240

package/README.md

@@ -53,6 +53,11 @@ Requires Node.js **20 or newer**.
    can create projects, open sessions, and chat with the agent on that machine
    from any tab.
 
+   Steps 2 and 3 are one command: `spectral desktop`. It starts `serve` as a
+   background daemon (survives closing the terminal), waits until the relay is
+   genuinely connected, then opens the UI in your default browser — see
+   [`spectral desktop`](#spectral-desktop).
+
 You can also run Spectral as a plain local TUI without the relay — just invoke
 `spectral` (no subcommand) and it acts as a normal pi terminal session with the
 Aexol MCP extension auto-loaded.
@@ -65,6 +70,7 @@ Aexol MCP extension auto-loaded.
 | `spectral login`     | Interactive auth. Verifies the key against the MCP backend and stores it.   |
 | `spectral logout`    | Removes `~/.spectral/config.json`. Idempotent.                              |
 | `spectral serve`     | Connect this machine to the Aexol relay. Stays up; survives reconnects.     |
+| `spectral desktop`   | Start `serve` as a daemon, wait for it, open the UI. `status` / `stop` too. |
 | `spectral --version` | Print version.                                                              |
 | `spectral --help`    | Print Spectral header, then pi's full help.                                 |
 
@@ -74,6 +80,39 @@ Aexol MCP extension auto-loaded.
 | ----------------------- | ----------------------------------------------------- |
 | `--machine-name <name>` | Override the display name (default: `os.hostname()`). |
 
+### `spectral desktop`
+
+The headless replacement for the removed Electron app: same lifecycle, no
+bundled browser, and the UI is your own browser at
+`https://aexol.ai/agent` (override with `SPECTRAL_LANDING_URL`).
+
+| Command                 | Description                                                            |
+| ----------------------- | ---------------------------------------------------------------------- |
+| `spectral desktop`      | Start the agent, or reuse the one already running, then open the UI.    |
+| `spectral desktop status` | Report pid / version / readiness signal. Exit `3` when not running.   |
+| `spectral desktop stop` | SIGTERM, then SIGKILL after 10s. Removes the pid / ready files.         |
+
+Mechanics worth knowing:
+
+- Single instance via `~/.spectral/serve.pid`, claimed atomically (`O_EXCL`)
+  *before* the daemon is spawned — two simultaneous `spectral desktop` runs
+  start exactly one daemon. A dead pid is detected and pruned, so a crashed
+  daemon never blocks the next start, and a pid file held by a process this
+  command did not launch is never overwritten or deleted.
+- If `~/.spectral/config.json` has no Studio token, `desktop` runs the
+  interactive `spectral login` flow first (and refuses to prompt when there is
+  no terminal, telling you to run `spectral login` yourself).
+- Readiness is a real signal, not a timeout: the daemon prints
+  `SPECTRAL_SERVE_READY` once the relay WebSocket opens and writes
+  `serve-ready.json`. Opening the UI only after that avoids the
+  `machine_disconnected` flash you get if the page subscribes before the socket
+  exists.
+- `~/.spectral/serve.log` is created `0600` and rotated to `serve.log.old` at
+  start once it passes 10 MB (`SPECTRAL_DESKTOP_LOG_MAX_BYTES`).
+- The daemon is spawned detached with an augmented `PATH` (`/etc/paths`,
+  `getconf PATH`, Homebrew/nvm/Node dirs), so MCP servers declared as
+  `npx -y <pkg>` work even when Spectral was launched from a GUI context.
+
 Anything that isn't a Spectral subcommand is forwarded verbatim to pi, so any pi
 flag you know works. Example: `spectral -p "summarize this repo"`.
 
@@ -139,10 +178,18 @@ behaves like a vanilla pi install.
 | `~/.spectral/config.json`  | Aexol MCP URL + team API key. Created by `spectral login`. Mode `0600`. |
 | `~/.spectral/machine.json` | Machine identity + relay JWT. Created on first `spectral serve`.        |
 | `~/.spectral/sessions.db`  | Local SQLite for projects, sessions, messages.                          |
+| `~/.spectral/serve.pid`    | Relay daemon pid (single-instance lock). Pruned when stale.             |
+| `~/.spectral/serve-ready.json` | `{pid, ts, version}` written when the relay socket opens.            |
+| `~/.spectral/serve.log`    | Daemon stdout/stderr, written by `spectral desktop`.                    |
 | `SPECTRAL_CONFIG_DIR`      | Override the directory above.                                           |
 | `SPECTRAL_MCP_URL`         | Override the MCP URL at login time.                                     |
 | `SPECTRAL_BACKEND_URL`     | Override the backend HTTP base for `spectral serve`.                    |
 | `SPECTRAL_RELAY_URL`       | Override the derived relay WebSocket URL.                               |
+| `SPECTRAL_LANDING_URL`     | UI that `spectral desktop` opens (default `https://aexol.ai/agent`).    |
+| `SPECTRAL_SERVE_LOG_PATH`  | Daemon log path for `spectral desktop`.                                 |
+| `SPECTRAL_DESKTOP_READY_TIMEOUT_MS` | Readiness wait before `desktop` gives up (default 15000).      |
+| `SPECTRAL_DESKTOP_STOP_TIMEOUT_MS`  | SIGTERM grace before SIGKILL in `desktop stop` (default 10000). |
+| `SPECTRAL_DESKTOP_LOG_MAX_BYTES`    | Serve-log size that triggers rotation at start (default 10485760). |
 
 Pi's own auth state for the local TUI path (Codex subscription) lives in
 `~/.pi/agent/auth.json` on the same machine. Spectral never reads it and never

package/dist/agent/index.d.ts

@@ -24,14 +24,16 @@
  *   - Signal propagation (abort passthrough)
  *   - Access to observational memory via the `recall` and
  *     `write_project_observation` tools, which run against a parent-session
- *     point-in-time snapshot (branch + session id); other observation tools
- *     (`share_project_observation`, `receive_agent_observations`,
- *     `compact_context`, `subagent`) remain excluded
+ *     point-in-time snapshot (branch + session id). `receive_agent_observations`
+ *     also runs inside subagents but polls with a DISTINCT derived
+ *     observation session id (never the bare parent id); `share_project_observation`,
+ *     `compact_context`, and `subagent` remain excluded
  */
-import type { AgentTool } from "../sdk/agent-core/index.js";
+import type { AgentEvent, AgentTool } from "../sdk/agent-core/index.js";
 import { type ExtensionAPI, type ExtensionContext } from "../sdk/coding-agent/index.js";
 import { type AgentConfig } from "./agents.js";
 import type { ServerEvent } from "../server/wire.ts";
+import { type TpsUsageFields } from "../server/agent-bridge/tps-metrics.ts";
 import type { ReadonlySessionManager } from "../sdk/coding-agent/core/session-manager.js";
 /**
  * Build the system prompt for a subagent session.
@@ -49,7 +51,32 @@ export declare function buildSubagentSystemPrompt(baseSystemPrompt: string | und
  * SessionManager. Each getBranch call returns fresh clones of the snapshot.
  */
 export declare function createSubagentSessionManagerSnapshot(sessionManager: ExtensionContext["sessionManager"]): Pick<ReadonlySessionManager, "getBranch" | "getSessionId">;
-export declare function resolveSubagentTools(cwd: string, ext: ExtensionAPI, ctx: ExtensionContext): AgentTool[];
+export declare function resolveSubagentTools(cwd: string, ext: ExtensionAPI, ctx: ExtensionContext, agentName?: string): AgentTool[];
+/**
+ * Runs a child agent with an independent per-subagent timeout.
+ *
+ * Combines the parent's abort signal with a fresh timeout AbortController so
+ * that no single subagent can exhaust the parent prompt's full timeout budget.
+ * The budget covers the WHOLE child run including any resume retries (see
+ * `runSingleAgent`), so wall time stays bounded by SUBAGENT_TIMEOUT_MS.
+ * On timeout, returns a clear error result instead of throwing so the parent
+ * agent can continue (e.g. stop a chain, or surface the error as the tool
+ * result for parallel/single modes).
+ */
+/**
+ * LIVE TPS snapshot emitted by the subagent runner after each LLM round that
+ * produced tokens (subagent_progress contract). Carried through
+ * `onInternalEvent` alongside real `AgentEvent`s; the subagent extension maps
+ * it to the `subagent_tps` wire event for the bridge, which folds it into the
+ * throttled `subagent_progress` frames keyed by the parent tool call id.
+ */
+export interface SubagentTpsSnapshotEvent {
+    type: "subagent_tps_snapshot";
+    /** Token-weighted TPS fields so far (omitted fields = no sound data yet). */
+    tps: TpsUsageFields;
+}
+/** Internal events the subagent runner forwards through `onInternalEvent`. */
+export type SubagentInternalEvent = AgentEvent | SubagentTpsSnapshotEvent;
 /** Test hook: replace the run-level retry sleep (e.g. with an instant/collecting stub). */
 export declare function setSubagentRetrySleepForTesting(fn?: (ms: number, signal?: AbortSignal) => Promise<void>): void;
 /**

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

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

package/dist/agent/index.js

@@ -24,9 +24,10 @@
  *   - Signal propagation (abort passthrough)
  *   - Access to observational memory via the `recall` and
  *     `write_project_observation` tools, which run against a parent-session
- *     point-in-time snapshot (branch + session id); other observation tools
- *     (`share_project_observation`, `receive_agent_observations`,
- *     `compact_context`, `subagent`) remain excluded
+ *     point-in-time snapshot (branch + session id). `receive_agent_observations`
+ *     also runs inside subagents but polls with a DISTINCT derived
+ *     observation session id (never the bare parent id); `share_project_observation`,
+ *     `compact_context`, and `subagent` remain excluded
  */
 import { agentLoop, agentLoopContinue, } from "../sdk/agent-core/index.js";
 import { buildIsolatedRequestTimePrunedMessagesResult, COMPACT_CONTEXT_TOOL_NAME, } from "../memory/tools/compact-context.js";
@@ -37,6 +38,8 @@ import { sleep } from "../sdk/coding-agent/utils/sleep.js";
 import { Type } from "typebox";
 import { discoverAgents, agentMetadataBlock, } from "./agents.js";
 import { loadAgentSettings } from "../server/handlers/agent-settings.js";
+import { buildTpsUsageFields, computeTpsMetrics, } from "../server/agent-bridge/tps-metrics.js";
+import { randomUUID } from "node:crypto";
 // ---------------------------------------------------------------------------
 // Built-in tool resolution (no spawn needed — tools are registered in-process)
 // ---------------------------------------------------------------------------
@@ -53,6 +56,8 @@ import { compressSubagentToolResult } from "../memory/tool-output-compressor.js"
 // ---------------------------------------------------------------------------
 const MAX_PARALLEL_TASKS = 8;
 const MAX_CONCURRENCY = 4;
+/** Max steps in a chain call, mirroring the parallel batch cap. */
+const MAX_CHAIN_STEPS = 8;
 /**
  * Per-subagent timeout. Each subagent invocation (single, parallel, chain)
  * gets its own independent deadline so that no single subagent can
@@ -197,6 +202,40 @@ function truncateOutput(text, limit) {
     }
     return text;
 }
+/** Levenshtein edit distance between two strings (dependency-free). */
+function levenshtein(a, b) {
+    const dp = [];
+    for (let i = 0; i <= a.length; i++)
+        dp[i] = [i];
+    for (let j = 0; j <= b.length; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[a.length][b.length];
+}
+/**
+ * Suggests the closest known agent name for an unknown one.
+ * Case-insensitive prefix/substring match first, then Levenshtein ≤ 2.
+ */
+function suggestAgentName(unknownName, agents) {
+    const target = unknownName.toLowerCase();
+    let best;
+    for (const agent of agents) {
+        const name = agent.name.toLowerCase();
+        if (name.startsWith(target) || name.includes(target) || target.includes(name)) {
+            return agent.name;
+        }
+        const distance = levenshtein(target, name);
+        if (distance <= 2 && (!best || distance < best.distance)) {
+            best = { name: agent.name, distance };
+        }
+    }
+    return best?.name;
+}
 // ---------------------------------------------------------------------------
 // Helpers — model resolution
 // ---------------------------------------------------------------------------
@@ -258,14 +297,16 @@ export function createSubagentSessionManagerSnapshot(sessionManager) {
  * - `compact_context`: depends on parent session/UI state (sessionManager,
  *   settingsManager, ui, compaction actions) that is unavailable inside the
  *   isolated `{ cwd, getSystemPrompt }` subagent context.
- * - `receive_agent_observations` / `share_project_observation`: require the
- *   parent session id and branch, which are not exposed to the isolated
- *   subagent context.
+ * - `share_project_observation`: requires the parent session identity to
+ *   attribute shared observations; exposing it to subagents would let them
+ *   misattribute messages and create share/receive feedback loops.
+ * - `receive_agent_observations` is NOT excluded: it runs with a derived
+ *   `observationSessionId` (see `resolveSubagentTools`) so a subagent polls
+ *   its own inbox instead of consuming the parent session's.
  */
 const SUBAGENT_EXCLUDED_TOOL_NAMES = new Set([
     "subagent",
     COMPACT_CONTEXT_TOOL_NAME,
-    RECEIVE_AGENT_OBSERVATIONS_TOOL_NAME,
     SHARE_PROJECT_OBSERVATION_TOOL_NAME,
 ]);
 /**
@@ -275,8 +316,9 @@ const SUBAGENT_EXCLUDED_TOOL_NAMES = new Set([
 const SUBAGENT_SESSION_SNAPSHOT_TOOL_NAMES = new Set([
     RECALL_OBSERVATION_TOOL_NAME,
     WRITE_PROJECT_OBSERVATION_TOOL_NAME,
+    RECEIVE_AGENT_OBSERVATIONS_TOOL_NAME,
 ]);
-export function resolveSubagentTools(cwd, ext, ctx) {
+export function resolveSubagentTools(cwd, ext, ctx, agentName) {
     // Subagents receive every tool registered on the primary agent. Built-in
     // tools are created fresh with the subagent's isolated cwd/jobs, and
     // extension-registered tools are wrapped with a `SubagentToolContext`:
@@ -289,6 +331,16 @@ export function resolveSubagentTools(cwd, ext, ctx) {
     // One shared snapshot per invocation so all snapshot-routed tools observe
     // the same parent-session epoch (branch + session id).
     const sharedSnapshot = createSubagentSessionManagerSnapshot(ctx.sessionManager);
+    // Distinct observation identity for inter-agent tools. Derived from the
+    // parent session id so the inbox stays project/session-scoped, but never
+    // equal to it: per-recipient delivery means a subagent polling with the
+    // bare parent id would consume (and mark delivered) the parent's
+    // broadcast observations. The suffix is per-invocation, so parallel and
+    // retried subagent runs each get their own inbox view.
+    const parentSessionId = ctx.sessionManager?.getSessionId?.();
+    const observationSessionId = parentSessionId
+        ? `${parentSessionId}#sub:${(agentName ?? "agent").replace(/^@/, "")}:${randomUUID().slice(0, 8)}`
+        : undefined;
     for (const toolInfo of ext.getAllTools()) {
         const name = toolInfo.name;
         if (SUBAGENT_EXCLUDED_TOOL_NAMES.has(name))
@@ -309,8 +361,8 @@ export function resolveSubagentTools(cwd, ext, ctx) {
         if (!toolDef)
             continue;
         const isolatedContext = SUBAGENT_SESSION_SNAPSHOT_TOOL_NAMES.has(name)
-            ? { cwd, sessionManager: sharedSnapshot, getSystemPrompt: ctx.getSystemPrompt }
-            : { cwd, getSystemPrompt: ctx.getSystemPrompt };
+            ? { cwd, sessionManager: sharedSnapshot, getSystemPrompt: ctx.getSystemPrompt, observationSessionId }
+            : { cwd, getSystemPrompt: ctx.getSystemPrompt, observationSessionId };
         tools.push(wrapToolDefinition(toolDef, () => isolatedContext));
     }
     return tools;
@@ -335,17 +387,6 @@ async function mapWithConcurrencyLimit(items, concurrency, fn) {
     await Promise.all(workers);
     return results;
 }
-/**
- * Runs a child agent with an independent per-subagent timeout.
- *
- * Combines the parent's abort signal with a fresh timeout AbortController so
- * that no single subagent can exhaust the parent prompt's full timeout budget.
- * The budget covers the WHOLE child run including any resume retries (see
- * `runSingleAgent`), so wall time stays bounded by SUBAGENT_TIMEOUT_MS.
- * On timeout, returns a clear error result instead of throwing so the parent
- * agent can continue (e.g. stop a chain, or surface the error as the tool
- * result for parallel/single modes).
- */
 async function runSingleAgentWithTimeout(defaultCwd, agents, agentName, task, cwd, step, signal, onUpdate, makeDetails, parentToolCallId, onInternalEvent, ext, ctx, maxRetries) {
     const timeoutMs = SUBAGENT_TIMEOUT_MS;
     const timeoutSeconds = timeoutMs / 1000;
@@ -441,14 +482,15 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
     const normalizedAgentName = agentName.replace(/^@/, "");
     const agent = agents.find((a) => a.name === normalizedAgentName);
     if (!agent) {
-        const available = agents.map((a) => `"${a.name}"`).join(", ") || "none";
+        const available = agents.map((a) => `${a.name} (${a.source})`).join(", ") || "none";
+        const suggestion = suggestAgentName(normalizedAgentName, agents);
         return {
             agent: agentName,
             agentSource: "unknown",
             task,
             exitCode: 1,
             messages: [],
-            stderr: `Unknown agent: "${agentName}". Available agents: ${available}.`,
+            stderr: `Unknown agent: "${agentName}". Available agents: ${available}.${suggestion ? ` Did you mean "${suggestion}"?` : ""}`,
             usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0, contextTokens: 0, turns: 0 },
             step,
         };
@@ -508,7 +550,7 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
     // per-agent tool filtering). Built-ins (read, bash, apply_patch) plus
     // observational-memory tools (recall, read-project-observations) are
     // always available so subagents can actually do work.
-    const tools = resolveSubagentTools(effectiveCwd, ext, ctx);
+    const tools = resolveSubagentTools(effectiveCwd, ext, ctx, agentName);
     const currentResult = {
         agent: agentName,
         agentSource: agent.source,
@@ -534,6 +576,18 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
     // Responses API reasoning metadata that lets the UI classify accumulated
     // subagent thinking as activity (mirrors the main-session thinking metadata).
     let thinkingMetadata;
+    // Per-invocation TPS accumulation (subagent_end contract). Declared before
+    // the try block so both the settled and thrown return paths can attach it;
+    // survives the run-level resume retry so retried rounds count like their
+    // usage does.
+    const tpsAccumulator = {
+        durationMsSum: 0,
+        outputTokens: 0,
+        outputDurationMs: 0,
+        ttftMsSum: 0,
+        ttftRounds: 0,
+        lastRoundTps: null,
+    };
     const emitUpdate = () => {
         if (onUpdate) {
             const liveResult = {
@@ -616,6 +670,11 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
         const collectedMessages = [];
         let hadError = false;
         let segments = 0;
+        // Per-LLM-round timing stamps (TPS contract), mirroring the bridge's
+        // main-session `pending` stamps: message_start opens the round, the
+        // first text/thinking delta ends the TTFT window, message_end closes it.
+        let roundStartAt;
+        let roundFirstDeltaAt;
         // One child run may span several segments: the first one starts the
         // loop, any later one resumes it. Tool results already recorded in
         // `collectedMessages` are part of the resumed context, so tools are
@@ -627,15 +686,25 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
                     break;
                 }
                 onInternalEvent?.(event, parentToolCallId);
+                if (event.type === "message_start" && event.message?.role === "assistant") {
+                    // New LLM round begins. Reset the delta stamp so a stale
+                    // first-delta timestamp from a previous round cannot poison TTFT.
+                    roundStartAt = Date.now();
+                    roundFirstDeltaAt = undefined;
+                }
                 if (event.type === "message_update" && event.message?.role === "assistant") {
                     // Forward streaming text/thinking deltas so the UI can show the
                     // subagent process as it's generated, not just the final result.
                     const inner = event.assistantMessageEvent;
                     if (inner?.type === "text_delta" && inner.delta) {
+                        if (roundFirstDeltaAt === undefined)
+                            roundFirstDeltaAt = Date.now();
                         streamingText += inner.delta;
                         emitUpdate();
                     }
                     else if (inner?.type === "thinking_delta" && inner.delta) {
+                        if (roundFirstDeltaAt === undefined)
+                            roundFirstDeltaAt = Date.now();
                         thinkingText += inner.delta;
                         if (inner.metadata) {
                             thinkingMetadata = { ...(thinkingMetadata ?? {}), ...inner.metadata };
@@ -645,6 +714,9 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
                     continue;
                 }
                 if (event.type === "message_end" && event.message) {
+                    // Stamp at handler entry so the round metrics below measure the
+                    // whole stream (same source as the bridge's main-session path).
+                    const roundEndAt = Date.now();
                     const msg = event.message;
                     collectedMessages.push(msg);
                     if (msg.role === "assistant") {
@@ -666,6 +738,36 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
                             currentResult.stopReason = msg.stopReason;
                         if (msg.errorMessage)
                             currentResult.errorMessage = msg.errorMessage;
+                        // Per-round TPS metrics (mirrors the main-session token_usage
+                        // stamping): message_start → first delta → message_end with this
+                        // round's output tokens. Zero-token rounds contribute timing but
+                        // are skipped in the TPS numerator/denominator.
+                        const roundMetrics = computeTpsMetrics(roundStartAt, roundFirstDeltaAt, roundEndAt, usage?.output ?? 0);
+                        if (roundMetrics.durationMs != null) {
+                            tpsAccumulator.durationMsSum += roundMetrics.durationMs;
+                        }
+                        if (roundMetrics.tokensPerSecond != null &&
+                            roundMetrics.durationMs != null) {
+                            tpsAccumulator.outputTokens += usage?.output ?? 0;
+                            tpsAccumulator.outputDurationMs += roundMetrics.durationMs;
+                            tpsAccumulator.lastRoundTps = roundMetrics.tokensPerSecond;
+                        }
+                        if (roundMetrics.ttftMs != null) {
+                            tpsAccumulator.ttftMsSum += roundMetrics.ttftMs;
+                            tpsAccumulator.ttftRounds += 1;
+                        }
+                        // LIVE TPS snapshot (subagent_progress contract): after each LLM
+                        // round that produced tokens, push the token-weighted
+                        // accumulator snapshot through onInternalEvent so the bridge can
+                        // fold it into the throttled subagent_progress frames keyed by
+                        // the parent tool call id. Omitted until the first round with
+                        // tokens; unsound fields are omitted by buildTpsUsageFields.
+                        if (roundMetrics.tokensPerSecond != null) {
+                            onInternalEvent?.({
+                                type: "subagent_tps_snapshot",
+                                tps: buildTpsUsageFields(tpsAccumulator),
+                            }, parentToolCallId);
+                        }
                         if (msg.stopReason === "error" || msg.stopReason === "aborted") {
                             hadError = true;
                         }
@@ -693,6 +795,10 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
             // shows the resumed segment's reasoning, not stale text.
             thinkingText = "";
             thinkingMetadata = undefined;
+            // Drop round stamps from the previous segment so a resumed segment's
+            // first assistant round measures from its own message_start onward.
+            roundStartAt = undefined;
+            roundFirstDeltaAt = undefined;
             currentResult.stopReason = undefined;
             currentResult.errorMessage = undefined;
             currentResult.stderr = "";
@@ -773,6 +879,15 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
                 currentResult.errorMessage = `${currentResult.errorMessage} (failed after ${segments} attempts)`;
             }
         }
+        if (tpsAccumulator.durationMsSum > 0 || tpsAccumulator.ttftRounds > 0) {
+            currentResult.tps = {
+                ...buildTpsUsageFields(tpsAccumulator),
+                outputTokens: tpsAccumulator.outputTokens,
+                outputDurationMs: tpsAccumulator.outputDurationMs,
+                ttftMsSum: tpsAccumulator.ttftMsSum,
+                ttftRounds: tpsAccumulator.ttftRounds,
+            };
+        }
         return currentResult;
     }
     catch (err) {
@@ -781,6 +896,15 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
         currentResult.stopReason = "error";
         currentResult.errorMessage = errorMsg;
         currentResult.stderr = errorMsg;
+        if (tpsAccumulator.durationMsSum > 0 || tpsAccumulator.ttftRounds > 0) {
+            currentResult.tps = {
+                ...buildTpsUsageFields(tpsAccumulator),
+                outputTokens: tpsAccumulator.outputTokens,
+                outputDurationMs: tpsAccumulator.outputDurationMs,
+                ttftMsSum: tpsAccumulator.ttftMsSum,
+                ttftRounds: tpsAccumulator.ttftRounds,
+            };
+        }
         return currentResult;
     }
 }
@@ -788,14 +912,20 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
 // Tool parameter schemas
 // ---------------------------------------------------------------------------
 const TaskItem = Type.Object({
-    agent: Type.String({ description: "Name of the agent to invoke" }),
-    task: Type.String({ description: "Task to delegate to the agent" }),
+    agent: Type.String({
+        description: "Known agent name to invoke (use names from the available agents list)",
+    }),
+    task: Type.String({
+        description: "Full self-contained prompt text for the agent (plain string; subagents share no context with the caller)",
+    }),
     cwd: Type.Optional(Type.String({ description: "Working directory for the agent process" })),
 });
 const ChainItem = Type.Object({
-    agent: Type.String({ description: "Name of the agent to invoke" }),
+    agent: Type.String({
+        description: "Known agent name to invoke (use names from the available agents list)",
+    }),
     task: Type.String({
-        description: "Task with optional {previous} placeholder for prior output",
+        description: "Full self-contained prompt text with an optional {previous} placeholder, substituted with the previous step's output",
     }),
     cwd: Type.Optional(Type.String({ description: "Working directory for the agent process" })),
 });
@@ -804,13 +934,19 @@ const AgentScopeSchema = StringEnum(["user", "project", "both"], {
     default: "both",
 });
 const SubagentParams = Type.Object({
-    agent: Type.Optional(Type.String({ description: "Name of the agent to invoke (for single mode)" })),
-    task: Type.Optional(Type.String({ description: "Task to delegate (for single mode)" })),
+    agent: Type.Optional(Type.String({
+        description: "Known agent name to invoke (single mode; use names from the available agents list)",
+    })),
+    task: Type.Optional(Type.String({
+        description: "Full self-contained prompt text to delegate (single mode; plain string, subagents share no context with the caller)",
+    })),
     tasks: Type.Optional(Type.Array(TaskItem, {
-        description: "Array of {agent, task} for parallel execution",
+        description: "Parallel batch of {agent, task} items for independent tasks (max 8, 4 run concurrently)",
+        minItems: 1,
     })),
     chain: Type.Optional(Type.Array(ChainItem, {
-        description: "Array of {agent, task} for sequential execution",
+        description: "Sequential steps of {agent, task}; {previous} substitutes the previous step's output (max 8 steps)",
+        minItems: 1,
     })),
     agentScope: Type.Optional(AgentScopeSchema),
     confirmProjectAgents: Type.Optional(Type.Boolean({
@@ -837,11 +973,19 @@ export default function subagentExtension(ext, opts) {
             "Delegate tasks to specialized subagents with isolated context.",
             "Modes: single (agent + task), parallel (tasks array), chain (sequential with {previous} placeholder).",
             'Default agent scope is "both" (user agents from ~/.spectral/agent/agents + project agents from .spectral/agents).',
-            'Set agentScope: "user" or "project" to limit scope.'
+            'Set agentScope: "user" or "project" to limit scope.',
+            "Exactly one mode per call.",
+            'Single (one task): {"agent":"researcher","task":"<full self-contained task text>"}',
+            'Parallel (independent tasks; max 8, 4 run concurrently): {"tasks":[{"agent":"researcher","task":"..."},{"agent":"executor","task":"..."}]}',
+            'Chain (dependent tasks; sequential): {"chain":[{"agent":"researcher","task":"..."},{"agent":"executor","task":"Implement {previous}"}]}',
+            "NEVER mix agent/task with tasks or chain in one call; never pass a single task via tasks (use single mode); task must be a plain string; use known agent names only.",
+            "Task texts must be fully self-contained prompts (subagents share no context with the caller).",
         ].join(" "),
         promptSnippet: "Run a subagent to investigate, plan, review, or implement code changes",
         promptGuidelines: [
             "When the subagent tool is available, use it for non-trivial work where specialized delegation improves quality or speed, including bounded implementation, research, planning, review, and verification slices. Each subagent runs in an isolated context window.",
+            "Pick exactly one mode per call: one task → single {agent, task}; independent tasks → parallel {tasks: [...]} (max 8, 4 concurrent); dependent tasks → chain {chain: [...]} with {previous} substituting the prior step's output.",
+            "Task texts must be fully self-contained prompts (subagents share no context with the caller); never mix modes' fields (agent/task vs tasks/chain) in one call.",
         ],
         parameters: SubagentParams,
         async execute(_toolCallId, params, signal, onUpdate, ctx) {
@@ -943,6 +1087,17 @@ export default function subagentExtension(ext, opts) {
                             finishedAt,
                         });
                     }
+                    else if (event.type === "subagent_tps_snapshot") {
+                        // LIVE TPS snapshot from the runner (subagent_progress
+                        // contract): forward as the internal `subagent_tps` wire
+                        // event; the bridge folds it into the throttled
+                        // subagent_progress frames for this tool call.
+                        emitSubagentEvent({
+                            type: "subagent_tps",
+                            toolCallId: parentToolCallId,
+                            ...event.tps,
+                        });
+                    }
                 }
                 : undefined;
             if (modeCount !== 1) {
@@ -951,7 +1106,7 @@ export default function subagentExtension(ext, opts) {
                     content: [
                         {
                             type: "text",
-                            text: `Invalid parameters. Provide exactly one mode.\nAvailable agents: ${available}`,
+                            text: `Invalid parameters. Provide exactly one mode.\nAvailable agents: ${available}\n\nExamples:\nSingle: {"agent":"researcher","task":"<full self-contained task text>"}\nParallel: {"tasks":[{"agent":"researcher","task":"..."},{"agent":"executor","task":"..."}]}\nChain: {"chain":[{"agent":"researcher","task":"..."},{"agent":"executor","task":"Implement {previous}"}]}\nRetry with exactly one of: agent+task | tasks | chain`,
                         },
                     ],
                     details: makeDetails("single")([]),
@@ -990,6 +1145,16 @@ export default function subagentExtension(ext, opts) {
             }
             // ── Chain mode ──────────────────────────────────────────────
             if (params.chain && params.chain.length > 0) {
+                if (params.chain.length > MAX_CHAIN_STEPS)
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Too many chain steps (${params.chain.length}). Max is ${MAX_CHAIN_STEPS}.`,
+                            },
+                        ],
+                        details: makeDetails("chain")([]),
+                    };
                 const results = [];
                 let previousOutput = "";
                 for (let i = 0; i < params.chain.length; i++) {
@@ -1101,8 +1266,15 @@ export default function subagentExtension(ext, opts) {
                 });
                 const successCount = results.filter((r) => r.exitCode === 0).length;
                 const summaries = results.map((r) => {
-                    const output = truncateOutput(getFinalOutput(r.messages), SUBAGENT_OUTPUT_LIMIT);
-                    const status = r.exitCode === 0
+                    const completed = r.exitCode === 0;
+                    const finalOutput = getFinalOutput(r.messages);
+                    // Failed tasks with no transcript surface their error message /
+                    // stderr instead of a bare "(no output)" so the caller can see
+                    // why the task failed (e.g. unknown agent names).
+                    const output = truncateOutput(completed || finalOutput.trim()
+                        ? finalOutput
+                        : r.errorMessage || r.stderr, SUBAGENT_OUTPUT_LIMIT);
+                    const status = completed
                         ? "completed"
                         : r.attempts && r.attempts > 1
                             ? `failed (after ${r.attempts} attempts)`
@@ -1117,6 +1289,7 @@ export default function subagentExtension(ext, opts) {
                         },
                     ],
                     details: persistDetails(makeDetails("parallel")(results)),
+                    ...(results.length > 0 && successCount === 0 ? { isError: true } : {}),
                 };
             }
             // ── Single mode ─────────────────────────────────────────────

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

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

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

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

package/dist/cli.d.ts

@@ -8,6 +8,8 @@
  *  - `spectral login`  → interactive auth flow (writes ~/.spectral/config.json)
  *  - `spectral logout` → deletes ~/.spectral/config.json
  *  - `spectral serve`  → start the Aexol relay WebSocket server (headless)
+ *  - `spectral desktop`→ start `serve` detached + open the Studio UI in the
+ *                        browser (the thin replacement for the old desktop app)
  *  - `spectral bind`   → link directory to an Aexol Studio project
  *  - `spectral unbind` → remove Aexol Studio project binding
  *  - `spectral --version` / `--help` → branded short-circuits, no auth needed.

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;GAeG"}