claude-code-controller 0.5.1 → 0.6.0

package/dist/{claude-0cg912ch.d.cts → claude-B7-oBjuE.d.cts}

@@ -102,6 +102,48 @@ interface PlainTextMessage {
     type: "plain_text";
     text: string;
 }
+/** JSON data sent by Claude Code to the statusLine command via stdin. */
+interface StatusLineData {
+    model?: {
+        id?: string;
+        display_name?: string;
+    };
+    session_id?: string;
+    context_window?: {
+        used_percentage?: number;
+        remaining_percentage?: number;
+        total_input_tokens?: number;
+        total_output_tokens?: number;
+        context_window_size?: number;
+        current_usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            cache_creation_input_tokens?: number;
+            cache_read_input_tokens?: number;
+        };
+    };
+    cost?: {
+        total_cost_usd?: number;
+        total_duration_ms?: number;
+        total_api_duration_ms?: number;
+        total_lines_added?: number;
+        total_lines_removed?: number;
+    };
+    workspace?: {
+        current_dir?: string;
+        project_dir?: string;
+    };
+    cwd?: string;
+    agent?: {
+        name?: string;
+    };
+    vim?: {
+        mode?: string;
+    };
+    output_style?: {
+        name?: string;
+    };
+}
 interface TeamConfig {
     name: string;
     description?: string;
@@ -172,6 +214,7 @@ interface ControllerEvents {
     "task:completed": [task: TaskFile];
     "agent:spawned": [agentName: string, pid: number];
     "agent:exited": [agentName: string, code: number | null];
+    "agent:statusline": [agentName: string, data: StatusLineData];
     error: [error: Error];
 }
 type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
@@ -326,6 +369,7 @@ declare class ClaudeCodeController extends EventEmitter<ControllerEvents> implem
     readonly tasks: TaskManager;
     private processes;
     private poller;
+    private statusLineWatcher;
     private log;
     private cwd;
     private claudeBinary;
@@ -427,6 +471,7 @@ declare class ClaudeCodeController extends EventEmitter<ControllerEvents> implem
     /**
      * Ensure the agent's cwd has a .claude/settings.local.json so the
      * CLI skips the interactive workspace trust prompt.
+     * Also injects statusLine capture configuration.
      */
     private ensureWorkspaceTrusted;
     private ensureInitialized;
@@ -562,6 +607,7 @@ interface PlanRequestInfo {
 interface AgentEvents {
     message: [text: string];
     idle: [];
+    statusline: [data: StatusLineData];
     permission: [request: PermissionRequestInfo];
     plan: [request: PlanRequestInfo];
     exit: [code: number | null];
@@ -668,4 +714,4 @@ declare const claude: typeof claudeCall & {
     session: (opts?: SessionOptions) => Promise<Session>;
 };
 
-export { Agent as A, type TaskFile as B, ClaudeCodeController as C, TaskManager as D, type TaskStatus as E, type TeamConfig as F, TeamManager as G, type TeamMember as H, type InboxMessage as I, claude as J, type Logger as L, type PermissionMode as P, type ReceiveOptions as R, type StructuredMessage as S, type TaskAssignmentMessage as T, type LogLevel as a, type AgentEvents as b, AgentHandle as c, type AgentType as d, type AskOptions as e, type ClaudeOptions as f, type ControllerEvents as g, type ControllerOptions as h, type IdleNotificationMessage as i, type PermissionPreset as j, type PermissionRequestInfo as k, type PermissionRequestMessage as l, type PermissionResponseMessage as m, type PlainTextMessage as n, type PlanApprovalRequestMessage as o, type PlanApprovalResponseMessage as p, type PlanRequestInfo as q, type SandboxPermissionRequestMessage as r, type SandboxPermissionResponseMessage as s, Session as t, type SessionAgentOptions as u, type SessionOptions as v, type ShutdownApprovedMessage as w, type ShutdownRequestMessage as x, type SpawnAgentOptions as y, type TaskCompletedMessage as z };
+export { Agent as A, type TaskCompletedMessage as B, ClaudeCodeController as C, type TaskFile as D, TaskManager as E, type TaskStatus as F, type TeamConfig as G, TeamManager as H, type InboxMessage as I, type TeamMember as J, claude as K, type Logger as L, type PermissionMode as P, type ReceiveOptions as R, type StructuredMessage as S, type TaskAssignmentMessage as T, type StatusLineData as a, type LogLevel as b, type AgentEvents as c, AgentHandle as d, type AgentType as e, type AskOptions as f, type ClaudeOptions as g, type ControllerEvents as h, type ControllerOptions as i, type IdleNotificationMessage as j, type PermissionPreset as k, type PermissionRequestInfo as l, type PermissionRequestMessage as m, type PermissionResponseMessage as n, type PlainTextMessage as o, type PlanApprovalRequestMessage as p, type PlanApprovalResponseMessage as q, type PlanRequestInfo as r, type SandboxPermissionRequestMessage as s, type SandboxPermissionResponseMessage as t, Session as u, type SessionAgentOptions as v, type SessionOptions as w, type ShutdownApprovedMessage as x, type ShutdownRequestMessage as y, type SpawnAgentOptions as z };

package/dist/{claude-0cg912ch.d.ts → claude-B7-oBjuE.d.ts}

@@ -102,6 +102,48 @@ interface PlainTextMessage {
     type: "plain_text";
     text: string;
 }
+/** JSON data sent by Claude Code to the statusLine command via stdin. */
+interface StatusLineData {
+    model?: {
+        id?: string;
+        display_name?: string;
+    };
+    session_id?: string;
+    context_window?: {
+        used_percentage?: number;
+        remaining_percentage?: number;
+        total_input_tokens?: number;
+        total_output_tokens?: number;
+        context_window_size?: number;
+        current_usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            cache_creation_input_tokens?: number;
+            cache_read_input_tokens?: number;
+        };
+    };
+    cost?: {
+        total_cost_usd?: number;
+        total_duration_ms?: number;
+        total_api_duration_ms?: number;
+        total_lines_added?: number;
+        total_lines_removed?: number;
+    };
+    workspace?: {
+        current_dir?: string;
+        project_dir?: string;
+    };
+    cwd?: string;
+    agent?: {
+        name?: string;
+    };
+    vim?: {
+        mode?: string;
+    };
+    output_style?: {
+        name?: string;
+    };
+}
 interface TeamConfig {
     name: string;
     description?: string;
@@ -172,6 +214,7 @@ interface ControllerEvents {
     "task:completed": [task: TaskFile];
     "agent:spawned": [agentName: string, pid: number];
     "agent:exited": [agentName: string, code: number | null];
+    "agent:statusline": [agentName: string, data: StatusLineData];
     error: [error: Error];
 }
 type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
@@ -326,6 +369,7 @@ declare class ClaudeCodeController extends EventEmitter<ControllerEvents> implem
     readonly tasks: TaskManager;
     private processes;
     private poller;
+    private statusLineWatcher;
     private log;
     private cwd;
     private claudeBinary;
@@ -427,6 +471,7 @@ declare class ClaudeCodeController extends EventEmitter<ControllerEvents> implem
     /**
      * Ensure the agent's cwd has a .claude/settings.local.json so the
      * CLI skips the interactive workspace trust prompt.
+     * Also injects statusLine capture configuration.
      */
     private ensureWorkspaceTrusted;
     private ensureInitialized;
@@ -562,6 +607,7 @@ interface PlanRequestInfo {
 interface AgentEvents {
     message: [text: string];
     idle: [];
+    statusline: [data: StatusLineData];
     permission: [request: PermissionRequestInfo];
     plan: [request: PlanRequestInfo];
     exit: [code: number | null];
@@ -668,4 +714,4 @@ declare const claude: typeof claudeCall & {
     session: (opts?: SessionOptions) => Promise<Session>;
 };
 
-export { Agent as A, type TaskFile as B, ClaudeCodeController as C, TaskManager as D, type TaskStatus as E, type TeamConfig as F, TeamManager as G, type TeamMember as H, type InboxMessage as I, claude as J, type Logger as L, type PermissionMode as P, type ReceiveOptions as R, type StructuredMessage as S, type TaskAssignmentMessage as T, type LogLevel as a, type AgentEvents as b, AgentHandle as c, type AgentType as d, type AskOptions as e, type ClaudeOptions as f, type ControllerEvents as g, type ControllerOptions as h, type IdleNotificationMessage as i, type PermissionPreset as j, type PermissionRequestInfo as k, type PermissionRequestMessage as l, type PermissionResponseMessage as m, type PlainTextMessage as n, type PlanApprovalRequestMessage as o, type PlanApprovalResponseMessage as p, type PlanRequestInfo as q, type SandboxPermissionRequestMessage as r, type SandboxPermissionResponseMessage as s, Session as t, type SessionAgentOptions as u, type SessionOptions as v, type ShutdownApprovedMessage as w, type ShutdownRequestMessage as x, type SpawnAgentOptions as y, type TaskCompletedMessage as z };
+export { Agent as A, type TaskCompletedMessage as B, ClaudeCodeController as C, type TaskFile as D, TaskManager as E, type TaskStatus as F, type TeamConfig as G, TeamManager as H, type InboxMessage as I, type TeamMember as J, claude as K, type Logger as L, type PermissionMode as P, type ReceiveOptions as R, type StructuredMessage as S, type TaskAssignmentMessage as T, type StatusLineData as a, type LogLevel as b, type AgentEvents as c, AgentHandle as d, type AgentType as e, type AskOptions as f, type ClaudeOptions as g, type ControllerEvents as h, type ControllerOptions as i, type IdleNotificationMessage as j, type PermissionPreset as k, type PermissionRequestInfo as l, type PermissionRequestMessage as m, type PermissionResponseMessage as n, type PlainTextMessage as o, type PlanApprovalRequestMessage as p, type PlanApprovalResponseMessage as q, type PlanRequestInfo as r, type SandboxPermissionRequestMessage as s, type SandboxPermissionResponseMessage as t, Session as u, type SessionAgentOptions as v, type SessionOptions as w, type ShutdownApprovedMessage as x, type ShutdownRequestMessage as y, type SpawnAgentOptions as z };

package/dist/index.cjs

@@ -26,8 +26,11 @@ __export(index_exports, {
   InboxPoller: () => InboxPoller,
   ProcessManager: () => ProcessManager,
   Session: () => Session,
+  StatusLineWatcher: () => StatusLineWatcher,
   TaskManager: () => TaskManager,
   TeamManager: () => TeamManager,
+  buildStatusLineCommand: () => buildStatusLineCommand,
+  buildStatusLineSettings: () => buildStatusLineSettings,
   claude: () => claude,
   createLogger: () => createLogger,
   inboxPath: () => inboxPath,
@@ -36,6 +39,8 @@ __export(index_exports, {
   readInbox: () => readInbox,
   readUnread: () => readUnread,
   silentLogger: () => silentLogger,
+  statusLineDir: () => statusLineDir,
+  statusLineLogPath: () => statusLineLogPath,
   taskPath: () => taskPath,
   tasksBaseDir: () => tasksBaseDir,
   tasksDir: () => tasksDir,
@@ -47,15 +52,15 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/claude.ts
-var import_node_events2 = require("events");
+var import_node_events3 = require("events");
 var import_node_crypto3 = require("crypto");
 
 // src/controller.ts
-var import_node_events = require("events");
+var import_node_events2 = require("events");
 var import_node_child_process3 = require("child_process");
 var import_node_crypto2 = require("crypto");
-var import_node_fs4 = require("fs");
-var import_node_path3 = require("path");
+var import_node_fs5 = require("fs");
+var import_node_path4 = require("path");
 
 // src/team-manager.ts
 var import_promises = require("fs/promises");
@@ -760,6 +765,135 @@ var silentLogger = {
   }
 };
 
+// src/statusline-capture.ts
+var import_node_events = require("events");
+var import_node_fs4 = require("fs");
+var import_node_path3 = require("path");
+function statusLineDir(teamName) {
+  return (0, import_node_path3.join)(teamDir(teamName), "statusline");
+}
+function statusLineLogPath(teamName, agentName) {
+  return (0, import_node_path3.join)(statusLineDir(teamName), `${agentName}.jsonl`);
+}
+function buildStatusLineCommand(logFilePath) {
+  const escapedPath = logFilePath.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
+  return [
+    "python3 -c",
+    `'import sys,json;`,
+    `d=json.load(sys.stdin);`,
+    `open("${escapedPath}","a").write(json.dumps(d)+"\\n");`,
+    `print(d.get("model",{}).get("display_name",""))'`
+  ].join(" ");
+}
+function buildStatusLineSettings(logFilePath) {
+  return {
+    statusLine: {
+      type: "command",
+      command: buildStatusLineCommand(logFilePath)
+    }
+  };
+}
+var StatusLineWatcher = class extends import_node_events.EventEmitter {
+  teamName;
+  log;
+  watchers = /* @__PURE__ */ new Map();
+  fileOffsets = /* @__PURE__ */ new Map();
+  stopped = false;
+  constructor(teamName, logger) {
+    super();
+    this.teamName = teamName;
+    this.log = logger;
+  }
+  /**
+   * Ensure the statusline directory exists.
+   */
+  ensureDir() {
+    const dir = statusLineDir(this.teamName);
+    if (!(0, import_node_fs4.existsSync)(dir)) {
+      (0, import_node_fs4.mkdirSync)(dir, { recursive: true });
+    }
+  }
+  /**
+   * Start watching a specific agent's statusLine log file.
+   */
+  watchAgent(agentName) {
+    if (this.stopped) return;
+    const filePath = statusLineLogPath(this.teamName, agentName);
+    if (!(0, import_node_fs4.existsSync)(filePath)) {
+      (0, import_node_fs4.writeFileSync)(filePath, "");
+    }
+    try {
+      const stats = (0, import_node_fs4.readFileSync)(filePath);
+      this.fileOffsets.set(filePath, stats.length);
+    } catch {
+      this.fileOffsets.set(filePath, 0);
+    }
+    try {
+      const watcher = (0, import_node_fs4.watch)(filePath, (eventType) => {
+        if (eventType === "change") {
+          this.readNewLines(agentName, filePath);
+        }
+      });
+      this.watchers.set(agentName, watcher);
+      this.log.debug(`Watching statusLine for agent "${agentName}" at ${filePath}`);
+    } catch (err) {
+      this.log.error(`Failed to watch statusLine for "${agentName}": ${err}`);
+    }
+  }
+  /**
+   * Stop watching a specific agent.
+   */
+  unwatchAgent(agentName) {
+    const watcher = this.watchers.get(agentName);
+    if (watcher) {
+      watcher.close();
+      this.watchers.delete(agentName);
+    }
+    const filePath = statusLineLogPath(this.teamName, agentName);
+    this.fileOffsets.delete(filePath);
+  }
+  /**
+   * Stop all watchers.
+   */
+  stop() {
+    this.stopped = true;
+    for (const [, watcher] of this.watchers) {
+      watcher.close();
+    }
+    this.watchers.clear();
+    this.fileOffsets.clear();
+  }
+  /**
+   * Read new lines appended to the log file since last read.
+   */
+  readNewLines(agentName, filePath) {
+    try {
+      const content = (0, import_node_fs4.readFileSync)(filePath, "utf-8");
+      const offset = this.fileOffsets.get(filePath) ?? 0;
+      const newContent = content.slice(offset);
+      this.fileOffsets.set(filePath, content.length);
+      if (!newContent.trim()) return;
+      const lines = newContent.trim().split("\n");
+      for (const line of lines) {
+        if (!line.trim()) continue;
+        try {
+          const data = JSON.parse(line);
+          const event = {
+            agentName,
+            data,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          };
+          this.emit("update", event);
+        } catch (parseErr) {
+          this.log.debug(`Failed to parse statusLine JSON: ${line}`);
+        }
+      }
+    } catch (err) {
+      this.log.debug(`Error reading statusLine file: ${err}`);
+    }
+  }
+};
+
 // src/controller.ts
 var PROTOCOL_ONLY_TYPES = /* @__PURE__ */ new Set([
   "shutdown_approved",
@@ -779,12 +913,13 @@ var AGENT_COLORS = [
   "#FF69B4",
   "#7B68EE"
 ];
-var ClaudeCodeController = class extends import_node_events.EventEmitter {
+var ClaudeCodeController = class extends import_node_events2.EventEmitter {
   teamName;
   team;
   tasks;
   processes;
   poller;
+  statusLineWatcher;
   log;
   cwd;
   claudeBinary;
@@ -806,7 +941,11 @@ var ClaudeCodeController = class extends import_node_events.EventEmitter {
       "controller",
       this.log
     );
+    this.statusLineWatcher = new StatusLineWatcher(this.teamName, this.log);
     this.poller.onMessages((events) => this.handlePollEvents(events));
+    this.statusLineWatcher.on("update", (event) => {
+      this.emit("agent:statusline", event.agentName, event.data);
+    });
   }
   // ─── Lifecycle ───────────────────────────────────────────────────────
   /**
@@ -817,6 +956,7 @@ var ClaudeCodeController = class extends import_node_events.EventEmitter {
     if (this.initialized) return this;
     await this.team.create({ cwd: this.cwd });
     await this.tasks.init();
+    this.statusLineWatcher.ensureDir();
     this.poller.start();
     this.initialized = true;
     this.log.info(
@@ -857,6 +997,7 @@ var ClaudeCodeController = class extends import_node_events.EventEmitter {
     }
     await this.processes.killAll();
     this.poller.stop();
+    this.statusLineWatcher.stop();
     await this.team.destroy();
     this.initialized = false;
     this.log.info("Controller shut down");
@@ -885,7 +1026,8 @@ var ClaudeCodeController = class extends import_node_events.EventEmitter {
       subscriptions: []
     };
     await this.team.addMember(member);
-    this.ensureWorkspaceTrusted(cwd);
+    this.ensureWorkspaceTrusted(cwd, opts.name);
+    this.statusLineWatcher.watchAgent(opts.name);
     const env = Object.keys(this.defaultEnv).length > 0 || opts.env ? { ...this.defaultEnv, ...opts.env } : void 0;
     const proc = this.processes.spawn({
       teamName: this.teamName,
@@ -1092,6 +1234,7 @@ var ClaudeCodeController = class extends import_node_events.EventEmitter {
    * Kill a specific agent.
    */
   async killAgent(name) {
+    this.statusLineWatcher.unwatchAgent(name);
     await this.processes.kill(name);
     await this.team.removeMember(name);
   }
@@ -1156,15 +1299,28 @@ var ClaudeCodeController = class extends import_node_events.EventEmitter {
   /**
    * Ensure the agent's cwd has a .claude/settings.local.json so the
    * CLI skips the interactive workspace trust prompt.
+   * Also injects statusLine capture configuration.
    */
-  ensureWorkspaceTrusted(cwd) {
-    const claudeDir = (0, import_node_path3.join)(cwd, ".claude");
-    const settingsPath = (0, import_node_path3.join)(claudeDir, "settings.local.json");
-    if (!(0, import_node_fs4.existsSync)(settingsPath)) {
-      (0, import_node_fs4.mkdirSync)(claudeDir, { recursive: true });
-      (0, import_node_fs4.writeFileSync)(settingsPath, "{}\n");
-      this.log.debug(`Created ${settingsPath} for workspace trust`);
+  ensureWorkspaceTrusted(cwd, agentName) {
+    const claudeDir = (0, import_node_path4.join)(cwd, ".claude");
+    const settingsPath = (0, import_node_path4.join)(claudeDir, "settings.local.json");
+    (0, import_node_fs5.mkdirSync)(claudeDir, { recursive: true });
+    let settings = {};
+    if ((0, import_node_fs5.existsSync)(settingsPath)) {
+      try {
+        settings = JSON.parse((0, import_node_fs5.readFileSync)(settingsPath, "utf-8"));
+      } catch {
+        settings = {};
+      }
     }
+    if (agentName && !settings.statusLine) {
+      const logPath = statusLineLogPath(this.teamName, agentName);
+      const statusLineSettings = buildStatusLineSettings(logPath);
+      settings = { ...settings, ...statusLineSettings };
+      this.log.debug(`Injected statusLine capture for "${agentName}"`);
+    }
+    (0, import_node_fs5.writeFileSync)(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+    this.log.debug(`Updated ${settingsPath}`);
   }
   ensureInitialized() {
     if (!this.initialized) {
@@ -1250,7 +1406,7 @@ function waitForReady(controller, agentName, timeoutMs = 15e3) {
     controller.on("agent:exited", onExit);
   });
 }
-var Agent = class _Agent extends import_node_events2.EventEmitter {
+var Agent = class _Agent extends import_node_events3.EventEmitter {
   controller;
   handle;
   ownsController;
@@ -1450,6 +1606,9 @@ IMPORTANT: You MUST send your complete answer back using the SendMessage tool. D
     const onIdle = (name, _details) => {
       if (name === agentName) this.emit("idle");
     };
+    const onStatusLine = (name, data) => {
+      if (name === agentName) this.emit("statusline", data);
+    };
     const onPermission = (name, parsed) => {
       if (name !== agentName) return;
       let handled = false;
@@ -1498,6 +1657,7 @@ IMPORTANT: You MUST send your complete answer back using the SendMessage tool. D
     };
     this.controller.on("message", onMessage);
     this.controller.on("idle", onIdle);
+    this.controller.on("agent:statusline", onStatusLine);
     this.controller.on("permission:request", onPermission);
     this.controller.on("plan:approval_request", onPlan);
     this.controller.on("agent:exited", onExit);
@@ -1505,6 +1665,7 @@ IMPORTANT: You MUST send your complete answer back using the SendMessage tool. D
     this.boundListeners = [
       { event: "message", fn: onMessage },
       { event: "idle", fn: onIdle },
+      { event: "agent:statusline", fn: onStatusLine },
       { event: "permission:request", fn: onPermission },
       { event: "plan:approval_request", fn: onPlan },
       { event: "agent:exited", fn: onExit },
@@ -1651,8 +1812,11 @@ var claude = Object.assign(claudeCall, {
   InboxPoller,
   ProcessManager,
   Session,
+  StatusLineWatcher,
   TaskManager,
   TeamManager,
+  buildStatusLineCommand,
+  buildStatusLineSettings,
   claude,
   createLogger,
   inboxPath,
@@ -1661,6 +1825,8 @@ var claude = Object.assign(claudeCall, {
   readInbox,
   readUnread,
   silentLogger,
+  statusLineDir,
+  statusLineLogPath,
   taskPath,
   tasksBaseDir,
   tasksDir,