whale-code 6.5.6 → 6.5.8

package/dist/cli/serve-mode-types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Serve Mode — Types and Supabase client management
+ */
+import type { WebSocket } from "ws";
+import type Anthropic from "@anthropic-ai/sdk";
+import { type SupabaseClient } from "@supabase/supabase-js";
+export interface ServeModeOptions {
+    port: number;
+    host: string;
+    model?: string;
+    permissionMode?: string;
+    effort?: string;
+    allowedTools?: string[];
+    disallowedTools?: string[];
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    fallbackModel?: string;
+    debug?: boolean;
+    verbose?: boolean;
+}
+export interface ClientSession {
+    ws: WebSocket;
+    abortController: AbortController | null;
+    conversationHistory: Anthropic.MessageParam[];
+    conversationId: string | null;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+}
+export declare function getSupabase(): Promise<SupabaseClient | null>;

package/dist/cli/serve-mode-types.js

@@ -0,0 +1,56 @@
+/**
+ * Serve Mode — Types and Supabase client management
+ */
+
+import { createClient } from "@supabase/supabase-js";
+import { resolveConfig } from "./services/config-store.js";
+import { getValidToken, createAuthenticatedClient } from "./services/auth-service.js";
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+// ============================================================================
+// SUPABASE CLIENT (for conversation persistence)
+// ============================================================================
+
+let supabase = null;
+let supabaseCreatedAt = 0;
+const SUPABASE_TTL_MS = 45 * 60 * 1000; // Refresh client every 45 min (JWT expires ~60 min)
+
+export async function getSupabase() {
+  const now = Date.now();
+
+  // Return cached client if still fresh
+  if (supabase && now - supabaseCreatedAt < SUPABASE_TTL_MS) return supabase;
+
+  // Invalidate stale client
+  supabase = null;
+  const config = resolveConfig();
+
+  // Tier 1: Service role key (never expires)
+  if (config.supabaseUrl && config.supabaseKey && process.env.SUPABASE_SERVICE_ROLE_KEY) {
+    supabase = createClient(config.supabaseUrl, config.supabaseKey, {
+      auth: {
+        autoRefreshToken: false,
+        persistSession: false
+      }
+    });
+    supabaseCreatedAt = now;
+    return supabase;
+  }
+
+  // Tier 2: User JWT — always get a fresh token
+  try {
+    const token = await getValidToken();
+    if (token) {
+      supabase = createAuthenticatedClient(token);
+      supabaseCreatedAt = now;
+      return supabase;
+    }
+  } catch {
+    // Fall through
+  }
+  return null;
+}
+//# sourceMappingURL=serve-mode-types.js.map

package/dist/cli/serve-mode-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-mode-types.js","names":["createClient","resolveConfig","getValidToken","createAuthenticatedClient","supabase","supabaseCreatedAt","SUPABASE_TTL_MS","getSupabase","now","Date","config","supabaseUrl","supabaseKey","process","env","SUPABASE_SERVICE_ROLE_KEY","auth","autoRefreshToken","persistSession","token"],"sources":["../../src/cli/serve-mode-types.ts"],"sourcesContent":["/**\n * Serve Mode — Types and Supabase client management\n */\n\nimport type { WebSocket } from \"ws\";\nimport type Anthropic from \"@anthropic-ai/sdk\";\nimport { createClient, type SupabaseClient } from \"@supabase/supabase-js\";\nimport { resolveConfig } from \"./services/config-store.js\";\nimport { getValidToken, createAuthenticatedClient } from \"./services/auth-service.js\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface ServeModeOptions {\n  port: number;\n  host: string;\n  model?: string;\n  permissionMode?: string;\n  effort?: string;\n  allowedTools?: string[];\n  disallowedTools?: string[];\n  maxTurns?: number;\n  maxBudgetUsd?: number;\n  fallbackModel?: string;\n  debug?: boolean;\n  verbose?: boolean;\n}\n\nexport interface ClientSession {\n  ws: WebSocket;\n  abortController: AbortController | null;\n  conversationHistory: Anthropic.MessageParam[];\n  conversationId: string | null;\n  totalInputTokens: number;\n  totalOutputTokens: number;\n}\n\n// ============================================================================\n// SUPABASE CLIENT (for conversation persistence)\n// ============================================================================\n\nlet supabase: SupabaseClient | null = null;\nlet supabaseCreatedAt = 0;\nconst SUPABASE_TTL_MS = 45 * 60 * 1000; // Refresh client every 45 min (JWT expires ~60 min)\n\nexport async function getSupabase(): Promise<SupabaseClient | null> {\n  const now = Date.now();\n\n  // Return cached client if still fresh\n  if (supabase && (now - supabaseCreatedAt) < SUPABASE_TTL_MS) return supabase;\n\n  // Invalidate stale client\n  supabase = null;\n\n  const config = resolveConfig();\n\n  // Tier 1: Service role key (never expires)\n  if (config.supabaseUrl && config.supabaseKey && process.env.SUPABASE_SERVICE_ROLE_KEY) {\n    supabase = createClient(config.supabaseUrl, config.supabaseKey, {\n      auth: { autoRefreshToken: false, persistSession: false },\n    });\n    supabaseCreatedAt = now;\n    return supabase;\n  }\n\n  // Tier 2: User JWT — always get a fresh token\n  try {\n    const token = await getValidToken();\n    if (token) {\n      supabase = createAuthenticatedClient(token);\n      supabaseCreatedAt = now;\n      return supabase;\n    }\n  } catch {\n    // Fall through\n  }\n\n  return null;\n}\n"],"mappings":"AAAA;AACA;AACA;;AAIA,SAASA,YAAY,QAA6B,uBAAuB;AACzE,SAASC,aAAa,QAAQ,4BAA4B;AAC1D,SAASC,aAAa,EAAEC,yBAAyB,QAAQ,4BAA4B;;AAErF;AACA;AACA;;AA0BA;AACA;AACA;;AAEA,IAAIC,QAA+B,GAAG,IAAI;AAC1C,IAAIC,iBAAiB,GAAG,CAAC;AACzB,MAAMC,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;;AAExC,OAAO,eAAeC,WAAWA,CAAA,EAAmC;EAClE,MAAMC,GAAG,GAAGC,IAAI,CAACD,GAAG,CAAC,CAAC;;EAEtB;EACA,IAAIJ,QAAQ,IAAKI,GAAG,GAAGH,iBAAiB,GAAIC,eAAe,EAAE,OAAOF,QAAQ;;EAE5E;EACAA,QAAQ,GAAG,IAAI;EAEf,MAAMM,MAAM,GAAGT,aAAa,CAAC,CAAC;;EAE9B;EACA,IAAIS,MAAM,CAACC,WAAW,IAAID,MAAM,CAACE,WAAW,IAAIC,OAAO,CAACC,GAAG,CAACC,yBAAyB,EAAE;IACrFX,QAAQ,GAAGJ,YAAY,CAACU,MAAM,CAACC,WAAW,EAAED,MAAM,CAACE,WAAW,EAAE;MAC9DI,IAAI,EAAE;QAAEC,gBAAgB,EAAE,KAAK;QAAEC,cAAc,EAAE;MAAM;IACzD,CAAC,CAAC;IACFb,iBAAiB,GAAGG,GAAG;IACvB,OAAOJ,QAAQ;EACjB;;EAEA;EACA,IAAI;IACF,MAAMe,KAAK,GAAG,MAAMjB,aAAa,CAAC,CAAC;IACnC,IAAIiB,KAAK,EAAE;MACTf,QAAQ,GAAGD,yBAAyB,CAACgB,KAAK,CAAC;MAC3Cd,iBAAiB,GAAGG,GAAG;MACvB,OAAOJ,QAAQ;IACjB;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAGF,OAAO,IAAI;AACb","ignoreList":[]}

package/dist/cli/services/__tests__/agent-definitions.test.js

@@ -0,0 +1,153 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { vol } from "memfs";
+
+// ============================================================================
+// Mocks
+// ============================================================================
+
+vi.mock("fs", async () => {
+  const memfs = await import("memfs");
+  return {
+    ...memfs.fs,
+    default: memfs.fs
+  };
+});
+vi.mock("os", () => ({
+  homedir: () => "/home/testuser"
+}));
+import { loadAgentDefinitions, getAgentDefinition } from "../agent-definitions.js";
+
+// ============================================================================
+// Setup
+// ============================================================================
+
+const GLOBAL_DIR = "/home/testuser/.whale/agents";
+beforeEach(() => {
+  vol.reset();
+  // Default cwd
+  vi.spyOn(process, "cwd").mockReturnValue("/tmp/project");
+});
+
+// ============================================================================
+// loadAgentDefinitions
+// ============================================================================
+
+describe("loadAgentDefinitions", () => {
+  it("returns empty array when no agent dirs exist", () => {
+    expect(loadAgentDefinitions()).toEqual([]);
+  });
+  it("loads global agents from ~/.whale/agents/", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/reviewer.md`]: "You are a code reviewer."
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.length).toBe(1);
+    expect(agents[0].name).toBe("reviewer");
+    expect(agents[0].prompt).toBe("You are a code reviewer.");
+    expect(agents[0].source).toBe("global");
+  });
+  it("loads local agents from .whale/agents/", () => {
+    vol.fromJSON({
+      "/tmp/project/.whale/agents/tester.md": "You are a test writer."
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.length).toBe(1);
+    expect(agents[0].name).toBe("tester");
+    expect(agents[0].source).toBe("local");
+  });
+  it("parses frontmatter description and tools", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/security.md`]: `---
+description: Reviews code for security issues
+tools: read_file, glob, grep
+---
+You are a security agent.`
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents[0].description).toBe("Reviews code for security issues");
+    expect(agents[0].tools).toEqual(["read_file", "glob", "grep"]);
+    expect(agents[0].prompt).toBe("You are a security agent.");
+  });
+  it("handles frontmatter without description or tools", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/simple.md`]: `---
+description: Simple agent
+---
+Do things.`
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents[0].description).toBe("Simple agent");
+    expect(agents[0].tools).toBeUndefined();
+  });
+  it("handles files without frontmatter", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/bare.md`]: "Just plain content."
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents[0].prompt).toBe("Just plain content.");
+    expect(agents[0].description).toBeUndefined();
+  });
+  it("local agents override global agents with same name", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/reviewer.md`]: "Global reviewer",
+      "/tmp/project/.whale/agents/reviewer.md": "Local reviewer"
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.length).toBe(1);
+    expect(agents[0].prompt).toBe("Local reviewer");
+    expect(agents[0].source).toBe("local");
+  });
+  it("merges global and local agents and sorts by name", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/zebra.md`]: "Z agent",
+      [`${GLOBAL_DIR}/alpha.md`]: "A agent",
+      "/tmp/project/.whale/agents/middle.md": "M agent"
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.map(a => a.name)).toEqual(["alpha", "middle", "zebra"]);
+  });
+  it("only loads .md files", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/valid.md`]: "Agent",
+      [`${GLOBAL_DIR}/invalid.txt`]: "Not an agent",
+      [`${GLOBAL_DIR}/also-invalid.json`]: "{}"
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.length).toBe(1);
+    expect(agents[0].name).toBe("valid");
+  });
+  it("handles broken frontmatter (no closing ---)", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/broken.md`]: "---\ndescription: Broken\nSome content"
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents[0].prompt).toBe("---\ndescription: Broken\nSome content");
+  });
+});
+
+// ============================================================================
+// getAgentDefinition
+// ============================================================================
+
+describe("getAgentDefinition", () => {
+  it("returns agent by name", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/reviewer.md`]: "Review code"
+    });
+    const agent = getAgentDefinition("reviewer");
+    expect(agent).toBeDefined();
+    expect(agent.name).toBe("reviewer");
+  });
+  it("returns undefined for non-existent agent", () => {
+    expect(getAgentDefinition("nonexistent")).toBeUndefined();
+  });
+  it("prefers local over global when both exist", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/reviewer.md`]: "Global",
+      "/tmp/project/.whale/agents/reviewer.md": "Local"
+    });
+    const agent = getAgentDefinition("reviewer");
+    expect(agent.prompt).toBe("Local");
+    expect(agent.source).toBe("local");
+  });
+});

package/dist/cli/services/__tests__/agent-events-global.test.js

@@ -0,0 +1,39 @@
+import { describe, it, expect, afterEach, vi } from "vitest";
+import { AgentEventEmitter, getGlobalEmitter, setGlobalEmitter, clearGlobalEmitter } from "../agent-events.js";
+
+// ============================================================================
+// Global Emitter Singleton (split from agent-events.test.ts)
+// ============================================================================
+
+describe("Global Emitter", () => {
+  afterEach(() => {
+    clearGlobalEmitter();
+  });
+  it("getGlobalEmitter lazily creates an emitter", () => {
+    const emitter = getGlobalEmitter();
+    expect(emitter).toBeInstanceOf(AgentEventEmitter);
+  });
+  it("getGlobalEmitter returns the same instance", () => {
+    const a = getGlobalEmitter();
+    const b = getGlobalEmitter();
+    expect(a).toBe(b);
+  });
+  it("setGlobalEmitter replaces the global emitter", () => {
+    const custom = new AgentEventEmitter();
+    setGlobalEmitter(custom);
+    expect(getGlobalEmitter()).toBe(custom);
+  });
+  it("clearGlobalEmitter destroys and nulls the emitter", () => {
+    const emitter = getGlobalEmitter();
+    const spy = vi.spyOn(emitter, "destroy");
+    clearGlobalEmitter();
+    expect(spy).toHaveBeenCalled();
+    // Next call creates a new one
+    const next = getGlobalEmitter();
+    expect(next).not.toBe(emitter);
+  });
+  it("clearGlobalEmitter is safe when no emitter exists", () => {
+    clearGlobalEmitter(); // nothing to destroy
+    clearGlobalEmitter(); // still safe
+  });
+});

package/dist/cli/services/__tests__/agent-events.part2.test.js

@@ -0,0 +1,113 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { AgentEventEmitter } from "../agent-events.js";
+
+// ============================================================================
+// AgentEventEmitter — subagent & team events
+// ============================================================================
+
+describe("AgentEventEmitter — subagent & team events", () => {
+  let emitter;
+  let events;
+  beforeEach(() => {
+    emitter = new AgentEventEmitter();
+    events = [];
+    emitter.onEvent(e => events.push(e));
+  });
+  afterEach(() => {
+    emitter.destroy();
+  });
+  it("emitSubagentStart emits subagent_start event", () => {
+    emitter.emitSubagentStart("sa-1", "code", "opus", "Fix a bug");
+    const e = events[0];
+    expect(e.type).toBe("subagent_start");
+    expect(e.id).toBe("sa-1");
+    expect(e.agentType).toBe("code");
+    expect(e.model).toBe("opus");
+    expect(e.description).toBe("Fix a bug");
+  });
+  it("emitSubagentProgress emits subagent_progress event", () => {
+    emitter.emitSubagentProgress("sa-1", "code", "reading file...", 2, "read_file");
+    const e = events[0];
+    expect(e.type).toBe("subagent_progress");
+    expect(e.id).toBe("sa-1");
+    expect(e.message).toBe("reading file...");
+    expect(e.turn).toBe(2);
+    expect(e.toolName).toBe("read_file");
+  });
+  it("emitSubagentDone emits subagent_done event", () => {
+    emitter.emitSubagentDone("sa-1", "code", true, "done", {
+      input: 100,
+      output: 50
+    }, ["read_file"], 5000);
+    const e = events[0];
+    expect(e.type).toBe("subagent_done");
+    expect(e.success).toBe(true);
+    expect(e.output).toBe("done");
+    expect(e.tokens).toEqual({
+      input: 100,
+      output: 50
+    });
+    expect(e.tools).toEqual(["read_file"]);
+    expect(e.durationMs).toBe(5000);
+  });
+  it("emitSubagentToolStart emits subagent_tool_start event", () => {
+    emitter.emitSubagentToolStart("sa-1", "bash", {
+      command: "ls"
+    });
+    const e = events[0];
+    expect(e.type).toBe("subagent_tool_start");
+    expect(e.agentId).toBe("sa-1");
+    expect(e.toolName).toBe("bash");
+    expect(e.toolInput).toEqual({
+      command: "ls"
+    });
+  });
+  it("emitSubagentToolEnd emits subagent_tool_end event", () => {
+    emitter.emitSubagentToolEnd("sa-1", "bash", true, 250);
+    const e = events[0];
+    expect(e.type).toBe("subagent_tool_end");
+    expect(e.agentId).toBe("sa-1");
+    expect(e.success).toBe(true);
+    expect(e.durationMs).toBe(250);
+  });
+  it("emitTeamStart emits team_start event", () => {
+    emitter.emitTeamStart("tm-1", "refactor", 3, 5);
+    const e = events[0];
+    expect(e.type).toBe("team_start");
+    expect(e.teamId).toBe("tm-1");
+    expect(e.name).toBe("refactor");
+    expect(e.teammateCount).toBe(3);
+    expect(e.taskCount).toBe(5);
+  });
+  it("emitTeamProgress emits team_progress event", () => {
+    emitter.emitTeamProgress("tm-1", "mate-1", "Alice", "working on task", "task-1");
+    const e = events[0];
+    expect(e.type).toBe("team_progress");
+    expect(e.teamId).toBe("tm-1");
+    expect(e.teammateId).toBe("mate-1");
+    expect(e.teammateName).toBe("Alice");
+    expect(e.message).toBe("working on task");
+    expect(e.taskId).toBe("task-1");
+  });
+  it("emitTeamTask emits team_task event", () => {
+    emitter.emitTeamTask("tm-1", "mate-1", "task-1", "Fix tests", "completed", "all green");
+    const e = events[0];
+    expect(e.type).toBe("team_task");
+    expect(e.status).toBe("completed");
+    expect(e.result).toBe("all green");
+  });
+  it("emitTeamDone emits team_done event", () => {
+    emitter.emitTeamDone("tm-1", true, "All done", 4, 5, {
+      input: 500,
+      output: 300
+    }, 60000);
+    const e = events[0];
+    expect(e.type).toBe("team_done");
+    expect(e.teamId).toBe("tm-1");
+    expect(e.success).toBe(true);
+    expect(e.summary).toBe("All done");
+    expect(e.tasksCompleted).toBe(4);
+    expect(e.tasksTotal).toBe(5);
+    expect(e.durationMs).toBe(60000);
+  });
+});

package/dist/cli/services/__tests__/agent-events.test.js

@@ -0,0 +1,157 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { AgentEventEmitter } from "../agent-events.js";
+
+// ============================================================================
+// AgentEventEmitter — core events
+// ============================================================================
+
+describe("AgentEventEmitter — core events", () => {
+  let emitter;
+  let events;
+  beforeEach(() => {
+    emitter = new AgentEventEmitter();
+    events = [];
+    emitter.onEvent(e => events.push(e));
+  });
+  afterEach(() => {
+    emitter.destroy();
+  });
+  it("emitText emits a text event", () => {
+    emitter.emitText("hello");
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("text");
+    expect(e.text).toBe("hello");
+    expect(e.accumulated).toBe("");
+  });
+  it("emitText emits multiple text events in sequence", () => {
+    emitter.emitText("a");
+    emitter.emitText("b");
+    emitter.emitText("c");
+    expect(events).toHaveLength(3);
+    expect(events[0].text).toBe("a");
+    expect(events[1].text).toBe("b");
+    expect(events[2].text).toBe("c");
+  });
+  it("emitText handles empty string", () => {
+    emitter.emitText("");
+    expect(events).toHaveLength(1);
+    expect(events[0].text).toBe("");
+  });
+  it("flushText is a no-op", () => {
+    emitter.flushText();
+    expect(events).toHaveLength(0);
+  });
+  it("emitToolStart emits a tool_start event", () => {
+    emitter.emitToolStart("tool-1", "read_file");
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("tool_start");
+    expect(e.id).toBe("tool-1");
+    expect(e.name).toBe("read_file");
+  });
+  it("emitToolEnd emits a tool_end event with all fields", () => {
+    emitter.emitToolEnd("tool-1", "read_file", true, "contents", {
+      path: "/a"
+    }, 120);
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("tool_end");
+    expect(e.id).toBe("tool-1");
+    expect(e.name).toBe("read_file");
+    expect(e.success).toBe(true);
+    expect(e.result).toBe("contents");
+    expect(e.input).toEqual({
+      path: "/a"
+    });
+    expect(e.durationMs).toBe(120);
+  });
+  it("emitToolEnd handles undefined result/input", () => {
+    emitter.emitToolEnd("t", "bash", false, undefined, undefined, 0);
+    const e = events[0];
+    expect(e.result).toBeUndefined();
+    expect(e.input).toBeUndefined();
+  });
+  it("emitUsage emits a usage event", () => {
+    emitter.emitUsage(100, 200, "claude-3", 0.05, 50, 10);
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("usage");
+    expect(e.inputTokens).toBe(100);
+    expect(e.outputTokens).toBe(200);
+    expect(e.model).toBe("claude-3");
+    expect(e.costUsd).toBe(0.05);
+    expect(e.cacheReadTokens).toBe(50);
+    expect(e.cacheCreationTokens).toBe(10);
+  });
+  it("emitUsage handles optional parameters", () => {
+    emitter.emitUsage(10, 20);
+    const e = events[0];
+    expect(e.model).toBeUndefined();
+    expect(e.costUsd).toBeUndefined();
+  });
+  it("emitDone emits a done event", () => {
+    const msgs = [{
+      role: "user",
+      content: "hi"
+    }];
+    emitter.emitDone("final text", msgs);
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("done");
+    expect(e.text).toBe("final text");
+    expect(e.messages).toEqual(msgs);
+  });
+  it("emitError emits an error event", () => {
+    emitter.emitError("something broke");
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("error");
+    expect(e.error).toBe("something broke");
+  });
+  it("emitCompact emits a compact event", () => {
+    emitter.emitCompact(10000, 5000, 5000);
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("compact");
+    expect(e.before).toBe(10000);
+    expect(e.after).toBe(5000);
+    expect(e.tokensSaved).toBe(5000);
+  });
+  it("emitToolOutput emits a tool_output event", () => {
+    emitter.emitToolOutput("bash", "line of output");
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("tool_output");
+    expect(e.toolName).toBe("bash");
+    expect(e.line).toBe("line of output");
+  });
+  it("onEvent returns unsubscribe function", () => {
+    const localEvents = [];
+    const unsub = emitter.onEvent(e => localEvents.push(e));
+    emitter.emitText("first");
+    expect(localEvents).toHaveLength(1);
+    unsub();
+    emitter.emitText("second");
+    expect(localEvents).toHaveLength(1);
+  });
+  it("supports multiple concurrent subscribers", () => {
+    const sub1 = [];
+    const sub2 = [];
+    emitter.onEvent(e => sub1.push(e));
+    emitter.onEvent(e => sub2.push(e));
+    emitter.emitText("test");
+    expect(sub1).toHaveLength(1);
+    expect(sub2).toHaveLength(1);
+  });
+  it("destroy removes all listeners", () => {
+    emitter.destroy();
+    emitter.emitText("after destroy");
+    expect(events).toHaveLength(0);
+  });
+  it("destroy is idempotent", () => {
+    emitter.destroy();
+    emitter.destroy();
+    expect(emitter.listenerCount("event")).toBe(0);
+  });
+});