@agentmeshhq/agent 0.1.13 → 0.1.14

package/dist/core/websocket.js.map

@@ -1 +1 @@
-{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/core/websocket.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/core/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,IAAI,CAAC;AAgB3B,MAAM,OAAO,cAAc;IACjB,EAAE,GAAqB,IAAI,CAAC;IAC5B,MAAM,CAAkB;IACxB,iBAAiB,GAAG,CAAC,CAAC;IACtB,oBAAoB,GAAG,EAAE,CAAC;IAC1B,cAAc,GAAG,IAAI,CAAC;IACtB,eAAe,GAAG,IAAI,CAAC;IAE/B,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAE9D,IAAI,CAAC,EAAE,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;QAE/B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAmB,CAAC;gBAC5D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC;YAC7B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB;QACvB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC;QAEtE,UAAU,CAAC,GAAG,EAAE;YACd,OAAO,CAAC,GAAG,CACT,4BAA4B,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,oBAAoB,GAAG,CACnF,CAAC;YACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAED,UAAU;QACR,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,EAAE,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,CAAC;IAChD,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
+export * from "./config/loader.js";
+export * from "./config/schema.js";
 export { AgentDaemon } from "./core/daemon.js";
-export { AgentWebSocket } from "./core/websocket.js";
 export { Heartbeat } from "./core/heartbeat.js";
-export * from "./core/tmux.js";
-export * from "./core/registry.js";
 export * from "./core/injector.js";
-export * from "./config/schema.js";
-export * from "./config/loader.js";
+export * from "./core/registry.js";
+export * from "./core/tmux.js";
+export { AgentWebSocket } from "./core/websocket.js";

package/dist/index.js

@@ -1,10 +1,10 @@
 // Re-export core modules for programmatic usage
+export * from "./config/loader.js";
+export * from "./config/schema.js";
 export { AgentDaemon } from "./core/daemon.js";
-export { AgentWebSocket } from "./core/websocket.js";
 export { Heartbeat } from "./core/heartbeat.js";
-export * from "./core/tmux.js";
-export * from "./core/registry.js";
 export * from "./core/injector.js";
-export * from "./config/schema.js";
-export * from "./config/loader.js";
+export * from "./core/registry.js";
+export * from "./core/tmux.js";
+export { AgentWebSocket } from "./core/websocket.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAEhD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmeshhq/agent",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "AgentMesh Agent Wrapper - Turn any AI coding assistant into a dispatchable, nudge-able agent",
   "type": "module",
   "main": "dist/index.js",

package/src/__tests__/loader.test.ts

@@ -1,14 +1,12 @@
 import * as fs from "node:fs";
-import * as path from "node:path";
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vitest";
 import {
   addAgentToState,
   getAgentState,
   loadConfig,
   loadState,
   removeAgentFromState,
-  saveConfig,
-  saveState,
+  resetAgentRestartCount,
   updateAgentInState,
 } from "../config/loader.js";
 import type { AgentState, Config, State } from "../config/schema.js";
@@ -187,5 +185,55 @@ describe("Config Loader", () => {
       // writeFileSync should not be called since agent doesn't exist
       // Actually it will be called but the state will be unchanged
     });
+
+    it("should update restart count and status fields", () => {
+      vi.mocked(fs.existsSync).mockReturnValue(true);
+      vi.mocked(fs.readFileSync).mockReturnValue(JSON.stringify(mockState));
+      vi.mocked(fs.writeFileSync).mockImplementation(() => {});
+
+      updateAgentInState("test-agent", {
+        restartCount: 2,
+        status: "stuck",
+        stuckSince: "2024-01-01T01:00:00Z",
+      });
+
+      const writtenContent = vi.mocked(fs.writeFileSync).mock.calls[0][1] as string;
+      const parsedState = JSON.parse(writtenContent);
+      expect(parsedState.agents[0].restartCount).toBe(2);
+      expect(parsedState.agents[0].status).toBe("stuck");
+      expect(parsedState.agents[0].stuckSince).toBe("2024-01-01T01:00:00Z");
+    });
+  });
+
+  describe("resetAgentRestartCount", () => {
+    it("should reset restart count and clear stuck status", () => {
+      const stuckState: State = {
+        agents: [
+          {
+            name: "test-agent",
+            agentId: "agent-123",
+            pid: 12345,
+            tmuxSession: "agentmesh-test-agent",
+            startedAt: "2024-01-01T00:00:00Z",
+            token: "test-token",
+            restartCount: 3,
+            status: "stuck",
+            stuckSince: "2024-01-01T01:00:00Z",
+          },
+        ],
+      };
+
+      vi.mocked(fs.existsSync).mockReturnValue(true);
+      vi.mocked(fs.readFileSync).mockReturnValue(JSON.stringify(stuckState));
+      vi.mocked(fs.writeFileSync).mockImplementation(() => {});
+
+      resetAgentRestartCount("test-agent");
+
+      const writtenContent = vi.mocked(fs.writeFileSync).mock.calls[0][1] as string;
+      const parsedState = JSON.parse(writtenContent);
+      expect(parsedState.agents[0].restartCount).toBe(0);
+      expect(parsedState.agents[0].status).toBe("running");
+      expect(parsedState.agents[0].stuckSince).toBeUndefined();
+    });
   });
 });

package/src/__tests__/runner.test.ts

@@ -1,9 +1,8 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { describe, expect, it } from "vitest";
 import {
   buildRunnerConfig,
   detectRunner,
   getRunnerDisplayName,
-  type RunnerType,
   resolveModel,
 } from "../core/runner.js";
 

package/src/__tests__/sandbox.test.ts

@@ -1,6 +1,6 @@
 import os from "node:os";
 import path from "node:path";
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { beforeEach, describe, expect, it, vi } from "vitest";
 import { DockerSandbox, type SandboxConfig, type SandboxMountPolicy } from "../core/sandbox.js";
 
 // Mock child_process

package/src/__tests__/watchdog.test.ts

@@ -0,0 +1,368 @@
+import { execSync, spawnSync } from "node:child_process";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import * as tmux from "../core/tmux.js";
+import {
+  checkAgentProgress,
+  cleanupOrphanContainers,
+  detectPermissionPrompt,
+  findOrphanContainers,
+  getLastActivityTime,
+  isProcessRunning,
+  sendNudge,
+  type WatchdogResult,
+} from "../core/watchdog.js";
+
+// Mock child_process
+vi.mock("node:child_process", () => ({
+  execSync: vi.fn(),
+  spawnSync: vi.fn(),
+}));
+
+// Mock tmux module
+vi.mock("../core/tmux.js", () => ({
+  captureSessionOutput: vi.fn(),
+}));
+
+describe("Watchdog Module", () => {
+  beforeEach(() => {
+    vi.resetAllMocks();
+  });
+
+  describe("detectPermissionPrompt", () => {
+    it("should return null when no permission prompt detected", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue(
+        "Normal output without any prompts\nJust some code being written",
+      );
+
+      const result = detectPermissionPrompt("test-agent");
+      expect(result).toBeNull();
+    });
+
+    it("should detect 'Permission required' prompt", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue(
+        "Some output\nPermission required\nAllow once | Allow always | Reject",
+      );
+
+      const result = detectPermissionPrompt("test-agent");
+      expect(result).toBe("Permission prompt detected");
+    });
+
+    it("should detect external directory access prompt", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue(
+        "Access external directory /tmp/some-path\nAllow once | Allow always | Reject",
+      );
+
+      const result = detectPermissionPrompt("test-agent");
+      expect(result).toBe("External directory: /tmp/some-path");
+    });
+
+    it("should detect triangle permission prompt", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue(
+        "Some output\n△ Permission required\nWaiting for approval",
+      );
+
+      const result = detectPermissionPrompt("test-agent");
+      expect(result).toBe("Permission prompt detected");
+    });
+
+    it("should return null when capture fails", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue(null);
+
+      const result = detectPermissionPrompt("test-agent");
+      expect(result).toBeNull();
+    });
+
+    it("should return null when capture throws", () => {
+      vi.mocked(tmux.captureSessionOutput).mockImplementation(() => {
+        throw new Error("Session not found");
+      });
+
+      const result = detectPermissionPrompt("test-agent");
+      expect(result).toBeNull();
+    });
+  });
+
+  describe("getLastActivityTime", () => {
+    it("should parse timestamp from local log file", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: "INFO  2026-02-26T00:14:42 +0ms service=opencode message=test",
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = getLastActivityTime("test-agent");
+      expect(result).toBeInstanceOf(Date);
+      expect(result?.toISOString()).toContain("2026-02-26");
+    });
+
+    it("should parse timestamp from container log file", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: "INFO  2026-02-26T01:30:00 +0ms service=opencode",
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = getLastActivityTime("test-agent", "container-123");
+      expect(result).toBeInstanceOf(Date);
+    });
+
+    it("should return null when command fails", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 1,
+        stdout: "",
+        stderr: "No such file",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = getLastActivityTime("test-agent");
+      expect(result).toBeNull();
+    });
+
+    it("should return null when no timestamp found", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: "Some output without timestamp",
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = getLastActivityTime("test-agent");
+      expect(result).toBeNull();
+    });
+
+    it("should return null on empty output", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: "",
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = getLastActivityTime("test-agent");
+      expect(result).toBeNull();
+    });
+  });
+
+  describe("checkAgentProgress", () => {
+    it("should return permission_blocked when permission prompt detected", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue("Permission required\nAllow once");
+
+      const result = checkAgentProgress("test-agent");
+      expect(result.status).toBe("permission_blocked");
+      expect(result.blockedOn).toBe("Permission prompt detected");
+    });
+
+    it("should return active when recent activity", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue("Normal output");
+
+      // Mock recent timestamp (1 minute ago)
+      const recentTime = new Date(Date.now() - 60 * 1000);
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: `INFO  ${recentTime.toISOString().slice(0, 19)} +0ms service=opencode`,
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = checkAgentProgress("test-agent");
+      expect(result.status).toBe("active");
+    });
+
+    it("should return idle when no activity for 3 minutes", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue("Normal output");
+
+      // Mock timestamp 3 minutes ago
+      const idleTime = new Date(Date.now() - 3 * 60 * 1000);
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: `INFO  ${idleTime.toISOString().slice(0, 19)} +0ms service=opencode`,
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = checkAgentProgress("test-agent");
+      expect(result.status).toBe("idle");
+    });
+
+    it("should return stuck when no activity for 6 minutes", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue("Normal output");
+
+      // Mock timestamp 6 minutes ago
+      const stuckTime = new Date(Date.now() - 6 * 60 * 1000);
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: `INFO  ${stuckTime.toISOString().slice(0, 19)} +0ms service=opencode`,
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = checkAgentProgress("test-agent");
+      expect(result.status).toBe("stuck");
+    });
+
+    it("should return active when activity time cannot be determined", () => {
+      vi.mocked(tmux.captureSessionOutput).mockReturnValue("Normal output");
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 1,
+        stdout: "",
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = checkAgentProgress("test-agent");
+      expect(result.status).toBe("active");
+      expect(result.details).toContain("Unable to determine");
+    });
+  });
+
+  describe("isProcessRunning", () => {
+    it("should return true for running process", () => {
+      // Current process is always running
+      const result = isProcessRunning(process.pid);
+      expect(result).toBe(true);
+    });
+
+    it("should return false for non-existent process", () => {
+      // Use a very high PID that's unlikely to exist
+      const result = isProcessRunning(999999999);
+      expect(result).toBe(false);
+    });
+  });
+
+  describe("findOrphanContainers", () => {
+    it("should return list of container IDs", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: "abc123\ndef456\nghi789",
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = findOrphanContainers("test-agent");
+      expect(result).toEqual(["abc123", "def456", "ghi789"]);
+    });
+
+    it("should return empty array when no containers found", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: "",
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = findOrphanContainers("test-agent");
+      expect(result).toEqual([]);
+    });
+
+    it("should return empty array on command failure", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 1,
+        stdout: "",
+        stderr: "docker not found",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = findOrphanContainers("test-agent");
+      expect(result).toEqual([]);
+    });
+  });
+
+  describe("cleanupOrphanContainers", () => {
+    it("should remove found containers and return count", () => {
+      vi.mocked(spawnSync)
+        .mockReturnValueOnce({
+          // findOrphanContainers call
+          status: 0,
+          stdout: "abc123\ndef456",
+          stderr: "",
+          pid: 123,
+          signal: null,
+          output: [],
+        })
+        .mockReturnValue({
+          // docker rm calls
+          status: 0,
+          stdout: "",
+          stderr: "",
+          pid: 123,
+          signal: null,
+          output: [],
+        });
+
+      const result = cleanupOrphanContainers("test-agent");
+      expect(result).toBe(2);
+    });
+
+    it("should return 0 when no orphan containers", () => {
+      vi.mocked(spawnSync).mockReturnValue({
+        status: 0,
+        stdout: "",
+        stderr: "",
+        pid: 123,
+        signal: null,
+        output: [],
+      });
+
+      const result = cleanupOrphanContainers("test-agent");
+      expect(result).toBe(0);
+    });
+  });
+
+  describe("sendNudge", () => {
+    it("should send nudge message to tmux session", () => {
+      vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+
+      const result = sendNudge("test-agent", "Please continue working");
+      expect(result).toBe(true);
+      expect(execSync).toHaveBeenCalledWith(
+        expect.stringContaining("tmux send-keys"),
+        expect.any(Object),
+      );
+    });
+
+    it("should return false when tmux command fails", () => {
+      vi.mocked(execSync).mockImplementation(() => {
+        throw new Error("tmux session not found");
+      });
+
+      const result = sendNudge("test-agent", "Continue");
+      expect(result).toBe(false);
+    });
+
+    it("should escape quotes in message", () => {
+      vi.mocked(execSync).mockReturnValue(Buffer.from(""));
+
+      sendNudge("test-agent", 'Message with "quotes"');
+      expect(execSync).toHaveBeenCalledWith(
+        expect.stringContaining('\\"quotes\\"'),
+        expect.any(Object),
+      );
+    });
+  });
+});

package/src/cli/attach.ts

@@ -1,5 +1,7 @@
-import { attachSession, sessionExists, getSessionName } from "../core/tmux.js";
+import { execSync } from "node:child_process";
 import pc from "picocolors";
+import { getAgentState } from "../config/loader.js";
+import { attachSession, getSessionName, sessionExists } from "../core/tmux.js";
 
 export function attach(name: string): void {
   if (!name) {
@@ -7,6 +9,25 @@ export function attach(name: string): void {
     process.exit(1);
   }
 
+  // Check if this is a sandbox agent
+  const localAgent = getAgentState(name);
+
+  if (localAgent?.sandboxContainer) {
+    // Sandbox agent - attach via docker exec
+    console.log(`Attaching to sandbox container ${localAgent.sandboxContainer}...`);
+    console.log(pc.dim("Detach with: Ctrl+B, D\n"));
+
+    try {
+      execSync(`docker exec -it ${localAgent.sandboxContainer} agentmesh attach ${name}`, {
+        stdio: "inherit",
+      });
+    } catch {
+      // execSync throws on non-zero exit, but that's expected when detaching
+    }
+    return;
+  }
+
+  // Host agent - attach via tmux
   const sessionName = getSessionName(name);
 
   if (!sessionExists(sessionName)) {

package/src/cli/build.ts

@@ -1,4 +1,4 @@
-import { spawnSync, execSync } from "node:child_process";
+import { execSync, spawnSync } from "node:child_process";
 import path from "node:path";
 import pc from "picocolors";
 
@@ -14,7 +14,9 @@ function findProjectRoot(): string {
       dir = path.dirname(dir);
     }
   }
-  throw new Error("Could not find AgentMesh project root. Make sure you're in the agentmesh repository.");
+  throw new Error(
+    "Could not find AgentMesh project root. Make sure you're in the agentmesh repository.",
+  );
 }
 
 export interface BuildOptions {
@@ -128,8 +130,14 @@ async function buildDocker(projectRoot: string, options: BuildOptions): Promise<
   console.log(pc.bold("Built images:"));
   const listResult = spawnSync(
     "docker",
-    ["images", "--filter", "reference=*agentmesh*", "--format", "{{.Repository}}:{{.Tag}}\t{{.Size}}"],
-    { encoding: "utf-8" }
+    [
+      "images",
+      "--filter",
+      "reference=*agentmesh*",
+      "--format",
+      "{{.Repository}}:{{.Tag}}\t{{.Size}}",
+    ],
+    { encoding: "utf-8" },
   );
   if (listResult.stdout) {
     console.log(pc.dim(listResult.stdout));

package/src/cli/context.ts

@@ -1,6 +1,5 @@
 import pc from "picocolors";
 import { getAgentState, loadState } from "../config/loader.js";
-import { extractHandoffContext, formatHandoffContextSummary } from "../context/handoff.js";
 import {
   CONTEXT_DIR,
   deleteContext,

package/src/cli/deploy.ts

@@ -1,4 +1,4 @@
-import { spawnSync, execSync } from "node:child_process";
+import { execSync, spawnSync } from "node:child_process";
 import path from "node:path";
 import pc from "picocolors";
 
@@ -14,7 +14,9 @@ function findProjectRoot(): string {
       dir = path.dirname(dir);
     }
   }
-  throw new Error("Could not find AgentMesh project root. Make sure you're in the agentmesh repository.");
+  throw new Error(
+    "Could not find AgentMesh project root. Make sure you're in the agentmesh repository.",
+  );
 }
 
 export type DeployEnvironment = "dev" | "staging" | "prod";
@@ -51,10 +53,10 @@ export async function deploy(options: DeployOptions): Promise<void> {
   // Step 1: Build
   if (!options.skipBuild) {
     console.log(pc.bold("Step 1: Building..."));
-    
+
     const buildScript = path.join(projectRoot, "scripts", "build.sh");
     const buildArgs = [buildScript, options.environment];
-    
+
     if (options.dryRun) {
       console.log(pc.dim(`Would run: ${buildArgs.join(" ")}`));
     } else {
@@ -76,7 +78,7 @@ export async function deploy(options: DeployOptions): Promise<void> {
   // Step 2: Push to registry
   if (!options.skipPush) {
     console.log(pc.bold("Step 2: Pushing to registry..."));
-    
+
     // Get the image tag from git commit
     let tag: string;
     try {

package/src/cli/init.ts

@@ -1,7 +1,7 @@
 import * as readline from "node:readline";
-import { loadConfig, saveConfig, createDefaultConfig } from "../config/loader.js";
-import type { Config } from "../config/schema.js";
 import pc from "picocolors";
+import { createDefaultConfig, loadConfig, saveConfig } from "../config/loader.js";
+import type { Config } from "../config/schema.js";
 
 function question(rl: readline.Interface, prompt: string): Promise<string> {
   return new Promise((resolve) => {
@@ -40,7 +40,7 @@ export async function init(): Promise<void> {
   try {
     const apiKey = await question(
       rl,
-      `API Key ${pc.dim("(from agentmeshhq.dev/settings/api-keys)")}: `
+      `API Key ${pc.dim("(from agentmeshhq.dev/settings/api-keys)")}: `,
     );
 
     if (!apiKey) {
@@ -48,25 +48,13 @@ export async function init(): Promise<void> {
       return;
     }
 
-    const workspace = await question(
-      rl,
-      `Workspace ${pc.dim("(default: agentmesh)")}: `
-    );
+    const workspace = await question(rl, `Workspace ${pc.dim("(default: agentmesh)")}: `);
 
-    const command = await question(
-      rl,
-      `Default command ${pc.dim("(default: opencode)")}: `
-    );
+    const command = await question(rl, `Default command ${pc.dim("(default: opencode)")}: `);
 
-    const model = await question(
-      rl,
-      `Default model ${pc.dim("(default: claude-sonnet-4)")}: `
-    );
+    const model = await question(rl, `Default model ${pc.dim("(default: claude-sonnet-4)")}: `);
 
-    const config: Config = createDefaultConfig(
-      apiKey.trim(),
-      workspace.trim() || "agentmesh"
-    );
+    const config: Config = createDefaultConfig(apiKey.trim(), workspace.trim() || "agentmesh");
 
     if (command.trim()) {
       config.defaults.command = command.trim();