@aexol/spectral 0.9.20 → 0.9.24

package/dist/agent/agents.d.ts

@@ -6,6 +6,7 @@
  *   ---
  *   name: my-agent
  *   description: What this agent does
+ *   mode: subagent          # or "primary" to inject into the main system prompt
  *   tools: read, grep, find, ls
  *   model: claude-haiku-4-5
  *   ---
@@ -16,9 +17,11 @@
  *   .spectral/agents/*.md             — Project-level (opt-in via agentScope)
  */
 export type AgentScope = "user" | "project" | "both";
+export type AgentMode = "primary" | "subagent";
 export interface AgentConfig {
     name: string;
     description: string;
+    mode: AgentMode;
     tools?: string[];
     model?: string;
     systemPrompt: string;
@@ -29,7 +32,20 @@ export interface AgentDiscoveryResult {
     agents: AgentConfig[];
     projectAgentsDir: string | null;
 }
-export declare function discoverAgents(cwd: string, scope: AgentScope): AgentDiscoveryResult;
+export declare function discoverAgents(cwd: string, scope: AgentScope, agentDir?: string): AgentDiscoveryResult;
+export declare function discoverPrimaryAgent(cwd: string, scope?: AgentScope, agentDir?: string): AgentConfig | null;
+/**
+ * Prepend the primary agent's system prompt above the base system prompt.
+ *
+ * Used by the per-turn `before_agent_start` hook so the primary-agent
+ * toggle takes effect mid-session (on the next user message) rather than
+ * only at session start.
+ *
+ * - Returns the base unchanged when no primary agent is provided.
+ * - Idempotent: if the base already starts with the primary agent header,
+ *   the base is returned unchanged (guards against double-injection).
+ */
+export declare function injectPrimaryAgentPrompt(base: string | undefined, primaryAgent: Pick<AgentConfig, "name" | "description" | "systemPrompt"> | null): string | undefined;
 export declare function formatAgentList(agents: AgentConfig[], maxItems: number): {
     text: string;
     remaining: number;

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

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/agent/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAyED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAoBnF;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EAAE,EACrB,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAQrC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/agent/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AACrD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AA2ED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,UAAU,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,oBAAoB,CAoBtB;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,UAAmB,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,WAAW,GAAG,IAAI,CAgBpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,CAAC,GAAG,IAAI,GAC9E,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EAAE,EACrB,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAQrC"}

package/dist/agent/agents.js

@@ -6,6 +6,7 @@
  *   ---
  *   name: my-agent
  *   description: What this agent does
+ *   mode: subagent          # or "primary" to inject into the main system prompt
  *   tools: read, grep, find, ls
  *   model: claude-haiku-4-5
  *   ---
@@ -17,6 +18,7 @@
  */
 import * as fs from "node:fs";
 import * as path from "node:path";
+import chalk from "chalk";
 import { getAgentDir, parseFrontmatter } from "../sdk/coding-agent/index.js";
 function loadAgentsFromDir(dir, source) {
     const agents = [];
@@ -51,9 +53,11 @@ function loadAgentsFromDir(dir, source) {
             ?.split(",")
             .map((t) => t.trim())
             .filter(Boolean);
+        const mode = frontmatter.mode === "primary" ? "primary" : "subagent";
         agents.push({
             name: frontmatter.name,
             description: frontmatter.description,
+            mode,
             tools: tools && tools.length > 0 ? tools : undefined,
             model: frontmatter.model,
             systemPrompt: body,
@@ -83,8 +87,8 @@ function findNearestProjectAgentsDir(cwd) {
         currentDir = parentDir;
     }
 }
-export function discoverAgents(cwd, scope) {
-    const userDir = path.join(getAgentDir(), "agents");
+export function discoverAgents(cwd, scope, agentDir) {
+    const userDir = path.join(agentDir ?? getAgentDir(), "agents");
     const projectAgentsDir = findNearestProjectAgentsDir(cwd);
     const userAgents = scope === "project" ? [] : loadAgentsFromDir(userDir, "user");
     const projectAgents = scope === "user" || !projectAgentsDir ? [] : loadAgentsFromDir(projectAgentsDir, "project");
@@ -105,6 +109,42 @@ export function discoverAgents(cwd, scope) {
     }
     return { agents: Array.from(agentMap.values()), projectAgentsDir };
 }
+export function discoverPrimaryAgent(cwd, scope = "both", agentDir) {
+    const { agents } = discoverAgents(cwd, scope, agentDir);
+    const primaries = agents.filter((a) => a.mode === "primary");
+    if (primaries.length === 0)
+        return null;
+    if (primaries.length > 1) {
+        // User-level primary wins over project-level primary; otherwise first wins.
+        const userPrimary = primaries.find((a) => a.source === "user");
+        const chosen = userPrimary ?? primaries[0];
+        console.warn(chalk.yellow(`Multiple primary agents found (${primaries.map((a) => a.name).join(", ")}). Using "${chosen.name}".`));
+        return chosen;
+    }
+    return primaries[0];
+}
+/**
+ * Prepend the primary agent's system prompt above the base system prompt.
+ *
+ * Used by the per-turn `before_agent_start` hook so the primary-agent
+ * toggle takes effect mid-session (on the next user message) rather than
+ * only at session start.
+ *
+ * - Returns the base unchanged when no primary agent is provided.
+ * - Idempotent: if the base already starts with the primary agent header,
+ *   the base is returned unchanged (guards against double-injection).
+ */
+export function injectPrimaryAgentPrompt(base, primaryAgent) {
+    if (!primaryAgent)
+        return base;
+    const header = `# Primary Agent: ${primaryAgent.name}\n\n${primaryAgent.description}`;
+    const block = `${header}\n\n${primaryAgent.systemPrompt}`;
+    if (!base)
+        return block;
+    if (base.startsWith(header))
+        return base;
+    return `${block}\n\n---\n\n${base}`;
+}
 export function formatAgentList(agents, maxItems) {
     if (agents.length === 0)
         return { text: "none", remaining: 0 };

package/dist/agent/index.d.ts

@@ -25,5 +25,7 @@
  *   - Access to observational memory via the recall tool
  */
 import { type ExtensionAPI } from "../sdk/coding-agent/index.js";
-export default function subagentExtension(ext: ExtensionAPI): void;
+export default function subagentExtension(ext: ExtensionAPI, opts?: {
+    disabledAgents?: string[];
+}): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAWH,OAAO,EACN,KAAK,YAAY,EAEjB,MAAM,8BAA8B,CAAC;AAqetC,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAqTjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAWH,OAAO,EACN,KAAK,YAAY,EAEjB,MAAM,8BAA8B,CAAC;AAuetC,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CA+UvG"}

package/dist/agent/index.js

@@ -28,6 +28,7 @@ import { agentLoop } from "../sdk/agent-core/index.js";
 import { StringEnum } from "../sdk/ai/index.js";
 import { Type } from "typebox";
 import { discoverAgents } from "./agents.js";
+import { loadAgentSettings } from "../server/handlers/agent-settings.js";
 // ---------------------------------------------------------------------------
 // Built-in tool resolution (no spawn needed — tools are registered in-process)
 // ---------------------------------------------------------------------------
@@ -175,7 +176,8 @@ async function mapWithConcurrencyLimit(items, concurrency, fn) {
 // Core — run a single subagent in-process via agentLoop
 // ---------------------------------------------------------------------------
 async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, signal, onUpdate, makeDetails, ext, ctx) {
-    const agent = agents.find((a) => a.name === agentName);
+    const normalizedAgentName = agentName.replace(/^@/, "");
+    const agent = agents.find((a) => a.name === normalizedAgentName);
     if (!agent) {
         const available = agents.map((a) => `"${a.name}"`).join(", ") || "none";
         return {
@@ -355,8 +357,8 @@ const ChainItem = Type.Object({
     cwd: Type.Optional(Type.String({ description: "Working directory for the agent process" })),
 });
 const AgentScopeSchema = StringEnum(["user", "project", "both"], {
-    description: 'Which agent directories to use. Default: "user". Use "both" to include project-local agents.',
-    default: "user",
+    description: 'Which agent directories to use. Default: "both" (user + project agents).',
+    default: "both",
 });
 const SubagentParams = Type.Object({
     agent: Type.Optional(Type.String({ description: "Name of the agent to invoke (for single mode)" })),
@@ -379,15 +381,15 @@ const SubagentParams = Type.Object({
 // ---------------------------------------------------------------------------
 // Extension entry point
 // ---------------------------------------------------------------------------
-export default function subagentExtension(ext) {
+export default function subagentExtension(ext, opts) {
     ext.registerTool({
         name: "subagent",
         label: "Subagent",
         description: [
             "Delegate tasks to specialized subagents with isolated context.",
             "Modes: single (agent + task), parallel (tasks array), chain (sequential with {previous} placeholder).",
-            'Default agent scope is "user" (from ~/.spectral/agent/agents).',
-            'To enable project-local agents in .spectral/agents, set agentScope: "both" (or "project").',
+            'Default agent scope is "both" (user agents from ~/.spectral/agent/agents + project agents from .spectral/agents).',
+            'Set agentScope: "user" or "project" to limit scope.'
         ].join(" "),
         promptSnippet: "Run a subagent to investigate, plan, review, or implement code changes",
         promptGuidelines: [
@@ -395,10 +397,36 @@ export default function subagentExtension(ext) {
         ],
         parameters: SubagentParams,
         async execute(_toolCallId, params, signal, onUpdate, ctx) {
-            const agentScope = params.agentScope ?? "user";
+            // Re-load agent settings from disk on every call so that UI toggles
+            // (subagentsEnabled / disabledSubagents) take effect immediately on
+            // running sessions, not just on the next session start.
+            const liveSettings = loadAgentSettings(ctx.cwd);
+            if (!liveSettings.subagentsEnabled) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "Subagents are disabled in agent settings. Enable subagents via the agent settings panel to delegate tasks.",
+                        },
+                    ],
+                    details: {
+                        mode: "single",
+                        agentScope: (params.agentScope ?? "both"),
+                        projectAgentsDir: null,
+                        results: [],
+                    },
+                };
+            }
+            const agentScope = params.agentScope ?? "both";
             const discovery = discoverAgents(ctx.cwd, agentScope);
-            const agents = discovery.agents;
-            const confirmProjectAgents = params.confirmProjectAgents ?? true;
+            // Merge registration-time disabled list (from session start) with the
+            // live disabled list (just read from disk) so both are honored.
+            const disabledSet = new Set([
+                ...(opts?.disabledAgents ?? []),
+                ...(liveSettings.disabledSubagents ?? []),
+            ]);
+            const agents = discovery.agents.filter((a) => !disabledSet.has(a.name));
+            const confirmProjectAgents = params.confirmProjectAgents ?? false;
             const hasChain = (params.chain?.length ?? 0) > 0;
             const hasTasks = (params.tasks?.length ?? 0) > 0;
             const hasSingle = Boolean(params.agent && params.task);
@@ -430,12 +458,12 @@ export default function subagentExtension(ext) {
                 const requestedAgentNames = new Set();
                 if (params.chain)
                     for (const step of params.chain)
-                        requestedAgentNames.add(step.agent);
+                        requestedAgentNames.add(step.agent.replace(/^@/, ""));
                 if (params.tasks)
                     for (const t of params.tasks)
-                        requestedAgentNames.add(t.agent);
+                        requestedAgentNames.add(t.agent.replace(/^@/, ""));
                 if (params.agent)
-                    requestedAgentNames.add(params.agent);
+                    requestedAgentNames.add(params.agent.replace(/^@/, ""));
                 const projectAgentsRequested = Array.from(requestedAgentNames)
                     .map((name) => agents.find((a) => a.name === name))
                     .filter((a) => a?.source === "project");

package/dist/cli.js

@@ -18,9 +18,15 @@ import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 // ---- Read our own version ----------------------------------------------------
-const pkgPath = resolve(__dirname, "..", "package.json");
-const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-const VERSION = pkg.version;
+let VERSION = process.env.npm_package_version ?? "0.0.0";
+try {
+    const pkgPath = resolve(__dirname, "..", "package.json");
+    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+    VERSION = pkg.version;
+}
+catch {
+    // Standalone Bun binaries do not carry the source package.json.
+}
 const TAGLINE = "Coding agent that never sleeps";
 // ---- Branded helpers ---------------------------------------------------------
 function printVersion() {

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;AAsBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AASlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAerE;;;;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,CAqWlF;AAiED;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAsBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AASlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAsBrE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAazD;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA6B9D;AAED,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;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,CAsWlF;AAiED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAa5E"}

package/dist/commands/serve.js

@@ -28,7 +28,7 @@
  * in-process fake backend.
  */
 import { readFileSync } from "node:fs";
-import { homedir, hostname } from "node:os";
+import { hostname } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { getConfigDir } from "../config.js";
@@ -49,9 +49,17 @@ const DEFAULT_BACKEND_URL = "https://api.aexol.ai";
 function readPackageVersion() {
     // dist/commands/serve.js  →  ../../package.json
     // src/commands/serve.ts → ../../package.json (tsx / vitest)
-    const pkgPath = resolve(__dirname, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-    return pkg.version;
+    // In a Bun standalone binary the source tree is not present, so the
+    // package.json lookup below fails. Return a fallback version instead of
+    // crashing the serve process.
+    try {
+        const pkgPath = resolve(__dirname, "..", "..", "package.json");
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        return pkg.version;
+    }
+    catch {
+        return process.env.npm_package_version ?? "0.0.0";
+    }
 }
 /**
  * Translate a backend HTTP(S) base URL to the relay WS(S) URL.
@@ -118,7 +126,7 @@ export function parseServeArgs(args) {
 }
 export async function runServe(opts = {}) {
     const cfg = await requireLogin();
-    const cwd = opts.cwd ?? homedir();
+    const cwd = opts.cwd ?? process.cwd();
     const version = readPackageVersion();
     const installSignalHandlers = opts.installSignalHandlers ?? true;
     const silent = opts.silent ?? false;
@@ -227,6 +235,7 @@ export async function runServe(opts = {}) {
                     store,
                     manager,
                     cwd,
+                    agentDir: getAgentDir(),
                     publishMetaEvent: deferredPublishMetaEvent,
                     mcpState: getLiveMcpState() ?? undefined,
                 }).then((response) => {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAcjE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAmB5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAejE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAoB5D"}

package/dist/memory/index.js

@@ -5,6 +5,7 @@ import { registerCompactionTrigger } from "./hooks/compaction-trigger.js";
 import { registerInterAgentReceiver } from "./hooks/inter-agent-receiver.js";
 import { registerObserverTrigger } from "./hooks/observer-trigger.js";
 import { Runtime } from "./runtime.js";
+import { registerToolOutputCompressor } from "./tool-output-compressor.js";
 import { registerRecallTool } from "./tools/recall-observation.js";
 import { registerReadProjectObservationsTool } from "./tools/read-project-observations.js";
 import { registerReceiveAgentObservationsTool } from "./tools/receive-agent-observations.js";
@@ -17,6 +18,7 @@ export default function observationalMemory(ext) {
     registerObserverTrigger(ext, runtime);
     registerCompactionTrigger(ext, runtime);
     registerCompactionHook(ext, runtime);
+    registerToolOutputCompressor(ext, runtime);
     registerStatusCommand(ext, runtime);
     registerViewCommand(ext, runtime);
     registerRecallTool(ext);

package/dist/memory/tool-output-compressor.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Tool Output Compressor — RTK-inspired pre-processing that intercepts
+ * tool results and compresses raw output before it enters the LLM context.
+ *
+ * This is complementary to the conversation-level compaction pipeline:
+ * - Compressor: compresses raw tool output (pre-context)
+ * - Compaction: summarizes + prunes conversation history (post-context)
+ * - Unified compaction: narrative summary + observation extraction (at compaction boundary)
+ *
+ * Strategies (mirroring RTK's four-pronged approach):
+ *
+ * 1. SMART FILTERING — strip noise from structured outputs
+ *    - Code: remove comments, collapse whitespace, skip blank lines
+ *    - Git: strip progress meters, hints, verbose enumerations
+ *    - Shell: remove ANSI escape codes, carriage returns
+ *
+ * 2. GROUPING — aggregate similar items
+ *    - ls/find: group files by directory
+ *    - grep/rg: group matches by file, collapse repeated patterns
+ *    - Lint errors: group by rule + file
+ *
+ * 3. TRUNCATION — keep relevant context, cut redundancy
+ *    - Read: keep N lines with line-number markers
+ *    - Bash: keep first + last N lines of long output
+ *    - Test runners: keep only failures + summary
+ *
+ * 4. DEDUPLICATION — collapse repeated lines with counts
+ *    - Log output: deduplicate repeated lines
+ *    - Docker/build output: collapse progress lines
+ */
+import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+import type { Runtime } from "./runtime.js";
+export interface CompressorConfig {
+    /** Enable compression (default: true) */
+    enabled: boolean;
+    /** Maximum characters for any single tool result before truncation */
+    maxResultChars: number;
+    /** Maximum lines for read results before truncation */
+    maxReadLines: number;
+    /** Maximum lines for directory listings */
+    maxLsLines: number;
+    /** Maximum lines for grep/find results before grouping */
+    maxSearchLines: number;
+    /** Enable ANSI escape code stripping */
+    stripAnsi: boolean;
+    /** Enable comment stripping for code files */
+    stripComments: boolean;
+    /** Enable test-runner failure-only filtering */
+    testFailuresOnly: boolean;
+    /** Enable git output compacting */
+    compactGit: boolean;
+}
+export declare const DEFAULT_COMPRESSOR_CONFIG: CompressorConfig;
+export interface CompressionStats {
+    originalChars: number;
+    compressedChars: number;
+    savingsPercent: number;
+    toolName: string;
+}
+export declare function registerToolOutputCompressor(ext: ExtensionAPI, runtime: Runtime): void;
+//# sourceMappingURL=tool-output-compressor.d.ts.map

package/dist/memory/tool-output-compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/tool-output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAUjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,WAAW,gBAAgB;IAChC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,aAAa,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAUvC,CAAC;AAghBF,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,OAAO,GACd,IAAI,CA4HN"}