@agentmeshhq/agent 0.4.10 → 0.4.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 therajushahi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/registry.register.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unit tests for registerAgent() — verifies team_id is correctly
+ * included/excluded in the registration payload sent to the hub.
+ *
+ * This guards against the hub/CLI contract drift where team_id was
+ * required by the hub for worker agents but never sent by the CLI.
+ */
+export {};

package/dist/__tests__/registry.register.test.js

@@ -0,0 +1,109 @@
+/**
+ * Unit tests for registerAgent() — verifies team_id is correctly
+ * included/excluded in the registration payload sent to the hub.
+ *
+ * This guards against the hub/CLI contract drift where team_id was
+ * required by the hub for worker agents but never sent by the CLI.
+ */
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { registerAgent } from "../core/registry.js";
+const BASE_OPTIONS = {
+    url: "https://agentmeshhq.dev",
+    apiKey: "test-secret",
+    workspace: "agentmesh",
+    agentName: "test-agent",
+    model: "claude-sonnet-4-5",
+};
+function mockFetch(overrides = {}) {
+    const mock = vi.fn().mockResolvedValue({
+        ok: overrides.ok ?? true,
+        json: async () => ({
+            token: "eyJhbGciOiJIUzI1NiJ9.test.token",
+            agent_id: "agt_test123",
+            status: "registered",
+            ...(overrides.body ?? {}),
+        }),
+        text: async () => JSON.stringify(overrides.body ?? {}),
+    });
+    vi.stubGlobal("fetch", mock);
+    return mock;
+}
+describe("registerAgent — team_id contract", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+    });
+    it("includes team_id in payload when provided", async () => {
+        const fetchMock = mockFetch();
+        await registerAgent({ ...BASE_OPTIONS, teamId: "team_abc123" });
+        expect(fetchMock).toHaveBeenCalledOnce();
+        const [, init] = fetchMock.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body.team_id).toBe("team_abc123");
+    });
+    it("omits team_id from payload when not provided", async () => {
+        const fetchMock = mockFetch();
+        await registerAgent({ ...BASE_OPTIONS });
+        const [, init] = fetchMock.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body).not.toHaveProperty("team_id");
+    });
+    it("omits team_id when explicitly undefined", async () => {
+        const fetchMock = mockFetch();
+        await registerAgent({ ...BASE_OPTIONS, teamId: undefined });
+        const [, init] = fetchMock.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body).not.toHaveProperty("team_id");
+    });
+    it("sends correct agent_type for worker agents", async () => {
+        const fetchMock = mockFetch();
+        await registerAgent({ ...BASE_OPTIONS, agentType: "worker", teamId: "team_abc123" });
+        const [, init] = fetchMock.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body.agent_type).toBe("worker");
+        expect(body.team_id).toBe("team_abc123");
+    });
+    it("does NOT send team_id for system agents even if teamId is set", async () => {
+        const fetchMock = mockFetch();
+        await registerAgent({ ...BASE_OPTIONS, agentType: "system", teamId: "team_abc123" });
+        const [, init] = fetchMock.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body.agent_type).toBe("system");
+        expect(body).not.toHaveProperty("team_id");
+    });
+    it("does NOT send team_id for autonomous agents even if teamId is set", async () => {
+        const fetchMock = mockFetch();
+        await registerAgent({ ...BASE_OPTIONS, agentType: "autonomous", teamId: "team_abc123" });
+        const [, init] = fetchMock.mock.calls[0];
+        const body = JSON.parse(init.body);
+        expect(body.agent_type).toBe("autonomous");
+        expect(body).not.toHaveProperty("team_id");
+    });
+    it("hits the correct endpoint", async () => {
+        const fetchMock = mockFetch();
+        await registerAgent({ ...BASE_OPTIONS, teamId: "team_abc123" });
+        const [url] = fetchMock.mock.calls[0];
+        expect(url).toBe("https://agentmeshhq.dev/api/v1/agents/register");
+    });
+    it("uses x-agentmesh-secret header for auth", async () => {
+        const fetchMock = mockFetch();
+        await registerAgent({ ...BASE_OPTIONS, apiKey: "my-secret-key", teamId: "team_abc123" });
+        const [, init] = fetchMock.mock.calls[0];
+        expect(init.headers["x-agentmesh-secret"]).toBe("my-secret-key");
+    });
+    it("throws when hub returns non-ok response", async () => {
+        vi.stubGlobal("fetch", vi.fn().mockResolvedValue({
+            ok: false,
+            text: async () => JSON.stringify({ error: "team_id is required for worker agent registration" }),
+        }));
+        await expect(registerAgent({ ...BASE_OPTIONS })).rejects.toThrow("Failed to register agent");
+    });
+    it("returns agentId and token from response", async () => {
+        mockFetch({ body: { token: "tok_abc", agent_id: "agt_xyz", status: "registered" } });
+        const result = await registerAgent({ ...BASE_OPTIONS, teamId: "team_abc123" });
+        expect(result.token).toBe("tok_abc");
+        expect(result.agentId).toBeDefined();
+        expect(result.status).toBe("registered");
+    });
+});
+//# sourceMappingURL=registry.register.test.js.map

package/dist/__tests__/registry.register.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.register.test.js","sourceRoot":"","sources":["../../src/__tests__/registry.register.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/start-team-id.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tests for --team-id CLI option wiring:
+ * 1. CLI help exposes --team-id flag
+ * 2. buildSpawnArgs() includes/excludes --team-id correctly (pure, no spawn mocking needed)
+ * 3. Config persistence via upsertAgentConfig
+ * 4. Client-side validation: --worker without --team-id exits 1
+ * 5. system/autonomous agents do NOT get team_id in registration payload
+ */
+export {};

package/dist/__tests__/start-team-id.test.js

@@ -0,0 +1,160 @@
+/**
+ * Tests for --team-id CLI option wiring:
+ * 1. CLI help exposes --team-id flag
+ * 2. buildSpawnArgs() includes/excludes --team-id correctly (pure, no spawn mocking needed)
+ * 3. Config persistence via upsertAgentConfig
+ * 4. Client-side validation: --worker without --team-id exits 1
+ * 5. system/autonomous agents do NOT get team_id in registration payload
+ */
+import { execSync } from "node:child_process";
+import { resolve } from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { buildSpawnArgs } from "../cli/start.js";
+const DIST_CLI = resolve(__dirname, "../../dist/cli/index.js");
+// ---------------------------------------------------------------------------
+// Spawn arg building — pure function, no mocking needed
+// ---------------------------------------------------------------------------
+describe("buildSpawnArgs — --team-id forwarding", () => {
+    it("includes --team-id when resolvedTeamId is provided", () => {
+        const args = buildSpawnArgs({ name: "forge-dev-1", worker: true }, { resolvedTeamId: "team_fd7i8ii2zjm2" });
+        expect(args).toContain("--team-id");
+        expect(args).toContain("team_fd7i8ii2zjm2");
+        const idx = args.indexOf("--team-id");
+        expect(args[idx + 1]).toBe("team_fd7i8ii2zjm2");
+    });
+    it("omits --team-id when resolvedTeamId is absent", () => {
+        const args = buildSpawnArgs({ name: "forge-dev-1", worker: true }, {});
+        expect(args).not.toContain("--team-id");
+    });
+    it("omits --team-id when resolvedTeamId is empty string", () => {
+        const args = buildSpawnArgs({ name: "forge-dev-1" }, { resolvedTeamId: "" });
+        expect(args).not.toContain("--team-id");
+    });
+    it("always includes --foreground and --name in spawn args", () => {
+        const args = buildSpawnArgs({ name: "my-agent" }, { resolvedTeamId: "team_abc" });
+        expect(args).toContain("start");
+        expect(args).toContain("--foreground");
+        expect(args).toContain("--name");
+        expect(args).toContain("my-agent");
+    });
+    it("includes --worker in spawn args when worker=true", () => {
+        const args = buildSpawnArgs({ name: "my-agent", worker: true }, { resolvedTeamId: "team_abc" });
+        expect(args).toContain("--worker");
+    });
+    it("preserves other options alongside --team-id", () => {
+        const args = buildSpawnArgs({ name: "my-agent", worker: true, autonomous: true, project: "PROJ" }, { resolvedTeamId: "team_abc", resolvedModel: "claude-sonnet-4-6" });
+        expect(args).toContain("--team-id");
+        expect(args).toContain("--autonomous");
+        expect(args).toContain("--project");
+        expect(args).toContain("--model");
+    });
+});
+// ---------------------------------------------------------------------------
+// CLI binary — help text and client-side validation
+// ---------------------------------------------------------------------------
+describe("CLI binary — --team-id option", () => {
+    it("start --help exposes --team-id flag", () => {
+        let output = "";
+        try {
+            output = execSync(`node "${DIST_CLI}" start --help`, { encoding: "utf-8" });
+        }
+        catch (err) {
+            output = err.stdout ?? "";
+        }
+        expect(output).toMatch(/--team-id/);
+    });
+    it("start --worker without --team-id exits with code 1", () => {
+        // Provide a minimal config via env so the CLI can load it
+        // The validation should fire before any network call
+        let exitCode = 0;
+        try {
+            execSync(`node "${DIST_CLI}" start --name ci-test-agent --worker --foreground`, {
+                encoding: "utf-8",
+                env: {
+                    ...process.env,
+                    HOME: "/tmp/agentmesh-test-no-config",
+                },
+            });
+        }
+        catch (err) {
+            exitCode = err.status ?? 1;
+        }
+        // Should exit non-zero (either 1 from our validation or from missing config)
+        expect(exitCode).toBeGreaterThan(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Config persistence
+// ---------------------------------------------------------------------------
+describe("start() — teamId config persistence", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+        vi.resetModules();
+    });
+    it("persists teamId to agent config when provided", async () => {
+        const loader = await import("../config/loader.js");
+        const tmux = await import("../core/tmux.js");
+        vi.spyOn(loader, "loadConfig").mockReturnValue({
+            apiKey: "key",
+            workspace: "agentmesh",
+            hubUrl: "https://agentmeshhq.dev",
+            defaults: { command: "opencode", model: "claude-sonnet-4-5" },
+            agents: [],
+        });
+        vi.spyOn(loader, "getAgentState").mockReturnValue(undefined);
+        vi.spyOn(loader, "upsertAgentConfig").mockImplementation(() => { });
+        vi.spyOn(tmux, "getSessionName").mockReturnValue("agentmesh-test-agent");
+        vi.spyOn(tmux, "sessionExists").mockReturnValue(false);
+        const upsertSpy = vi.spyOn(loader, "upsertAgentConfig");
+        const { start } = await import("../cli/start.js");
+        await start({ name: "test-agent", worker: true, teamId: "team_fd7i8ii2zjm2" }).catch(() => { });
+        expect(upsertSpy).toHaveBeenCalledWith(expect.objectContaining({ teamId: "team_fd7i8ii2zjm2" }));
+    });
+    it("does not persist teamId when not provided and not in config", async () => {
+        vi.resetModules();
+        const loader = await import("../config/loader.js");
+        const tmux = await import("../core/tmux.js");
+        vi.spyOn(loader, "loadConfig").mockReturnValue({
+            apiKey: "key",
+            workspace: "agentmesh",
+            hubUrl: "https://agentmeshhq.dev",
+            defaults: { command: "opencode", model: "claude-sonnet-4-5" },
+            agents: [],
+        });
+        vi.spyOn(loader, "getAgentState").mockReturnValue(undefined);
+        vi.spyOn(loader, "upsertAgentConfig").mockImplementation(() => { });
+        vi.spyOn(tmux, "getSessionName").mockReturnValue("agentmesh-test-agent");
+        vi.spyOn(tmux, "sessionExists").mockReturnValue(false);
+        const upsertSpy = vi.spyOn(loader, "upsertAgentConfig");
+        const { start } = await import("../cli/start.js");
+        // Worker without team-id will hit client-side validation and exit(1), so catch
+        await start({ name: "test-agent", worker: true }).catch(() => { });
+        const call = upsertSpy.mock.calls[0]?.[0];
+        if (call) {
+            expect(call).not.toHaveProperty("teamId");
+        }
+        // If upsert wasn't called (exited before), that's also valid — validation fired first
+    });
+    it("resolves teamId from persisted config when not on CLI", async () => {
+        vi.resetModules();
+        const loader = await import("../config/loader.js");
+        const tmux = await import("../core/tmux.js");
+        vi.spyOn(loader, "loadConfig").mockReturnValue({
+            apiKey: "key",
+            workspace: "agentmesh",
+            hubUrl: "https://agentmeshhq.dev",
+            defaults: { command: "opencode", model: "claude-sonnet-4-5" },
+            agents: [{ name: "test-agent", command: "opencode", teamId: "team_from_config" }],
+        });
+        vi.spyOn(loader, "getAgentState").mockReturnValue(undefined);
+        vi.spyOn(loader, "upsertAgentConfig").mockImplementation(() => { });
+        vi.spyOn(tmux, "getSessionName").mockReturnValue("agentmesh-test-agent");
+        vi.spyOn(tmux, "sessionExists").mockReturnValue(false);
+        const upsertSpy = vi.spyOn(loader, "upsertAgentConfig");
+        const { start } = await import("../cli/start.js");
+        await start({ name: "test-agent", worker: true }).catch(() => { });
+        expect(upsertSpy).toHaveBeenCalledWith(expect.objectContaining({ teamId: "team_from_config" }));
+    });
+});
+//# sourceMappingURL=start-team-id.test.js.map

package/dist/__tests__/start-team-id.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-team-id.test.js","sourceRoot":"","sources":["../../src/__tests__/start-team-id.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/watcher-runtime.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/watcher-runtime.test.js

@@ -0,0 +1,162 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { PROJECT_WATCHER_RENEWAL_INTERVAL_SECONDS } from "../cli/watcher.js";
+import { startProjectWatcherLoop } from "../core/project-watcher-loop.js";
+describe("project watcher loop — tick timer", () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("fires onTick at the configured interval", async () => {
+        const onTick = vi.fn().mockResolvedValue({
+            total_processed: 1,
+            total_nudged: 0,
+            total_escalated: 0,
+        });
+        const onRenew = vi
+            .fn()
+            .mockResolvedValue({ renewed: true, expires_at: "2026-03-28T00:00:00Z" });
+        const onLog = vi.fn();
+        const onError = vi.fn();
+        const onShutdown = vi.fn().mockResolvedValue(undefined);
+        const handle = startProjectWatcherLoop({
+            intervalSeconds: 60,
+            renewalIntervalSeconds: 180,
+            onTick,
+            onRenew,
+            onLog,
+            onError,
+            onShutdown,
+        });
+        expect(onTick).not.toHaveBeenCalled();
+        // Advance past first tick
+        await vi.advanceTimersByTimeAsync(60_001);
+        expect(onTick).toHaveBeenCalledTimes(1);
+        // Advance past second tick
+        await vi.advanceTimersByTimeAsync(60_001);
+        expect(onTick).toHaveBeenCalledTimes(2);
+        await handle.stop();
+    });
+    it("logs tick result counts after each tick", async () => {
+        const onTick = vi.fn().mockResolvedValue({
+            total_processed: 5,
+            total_nudged: 2,
+            total_escalated: 1,
+        });
+        const onRenew = vi
+            .fn()
+            .mockResolvedValue({ renewed: true, expires_at: "2026-03-28T00:00:00Z" });
+        const onLog = vi.fn();
+        const onError = vi.fn();
+        const onShutdown = vi.fn().mockResolvedValue(undefined);
+        const handle = startProjectWatcherLoop({
+            intervalSeconds: 60,
+            renewalIntervalSeconds: 180,
+            onTick,
+            onRenew,
+            onLog,
+            onError,
+            onShutdown,
+        });
+        await vi.advanceTimersByTimeAsync(60_001);
+        expect(onLog).toHaveBeenCalledWith("[tick] processed=5 nudged=2 escalated=1");
+        await handle.stop();
+    });
+    it("fires onRenew at the renewal interval (not with each tick)", async () => {
+        const onTick = vi.fn().mockResolvedValue({
+            total_processed: 0,
+            total_nudged: 0,
+            total_escalated: 0,
+        });
+        const onRenew = vi
+            .fn()
+            .mockResolvedValue({ renewed: true, expires_at: "2026-03-28T00:00:00Z" });
+        const onLog = vi.fn();
+        const onError = vi.fn();
+        const onShutdown = vi.fn().mockResolvedValue(undefined);
+        const handle = startProjectWatcherLoop({
+            intervalSeconds: 60,
+            renewalIntervalSeconds: 180,
+            onTick,
+            onRenew,
+            onLog,
+            onError,
+            onShutdown,
+        });
+        // 60s: tick fires once, no renewal yet
+        await vi.advanceTimersByTimeAsync(60_001);
+        expect(onTick).toHaveBeenCalledTimes(1);
+        expect(onRenew).toHaveBeenCalledTimes(0);
+        // 120s: second tick, still no renewal
+        await vi.advanceTimersByTimeAsync(60_001);
+        expect(onTick).toHaveBeenCalledTimes(2);
+        expect(onRenew).toHaveBeenCalledTimes(0);
+        // 180s: third tick AND first renewal
+        await vi.advanceTimersByTimeAsync(60_001);
+        expect(onTick).toHaveBeenCalledTimes(3);
+        expect(onRenew).toHaveBeenCalledTimes(1);
+        await handle.stop();
+    });
+    it("calls onShutdown and stops timers when renewal fails", async () => {
+        const onTick = vi.fn().mockResolvedValue({
+            total_processed: 0,
+            total_nudged: 0,
+            total_escalated: 0,
+        });
+        const onRenew = vi.fn().mockRejectedValue(new Error("network error"));
+        const onLog = vi.fn();
+        const onError = vi.fn();
+        const onShutdown = vi.fn().mockResolvedValue(undefined);
+        startProjectWatcherLoop({
+            intervalSeconds: 60,
+            renewalIntervalSeconds: 180,
+            onTick,
+            onRenew,
+            onLog,
+            onError,
+            onShutdown,
+        });
+        // Trigger renewal failure
+        await vi.advanceTimersByTimeAsync(180_001);
+        // Wait for the async renewal handler to complete
+        await vi.runAllTimersAsync();
+        expect(onRenew).toHaveBeenCalledTimes(1);
+        expect(onError).toHaveBeenCalledWith(expect.stringContaining("[renew] Lease renewal failed"));
+        expect(onShutdown).toHaveBeenCalledTimes(1);
+    });
+    it("stop() clears both timers and calls onShutdown once", async () => {
+        const onTick = vi.fn().mockResolvedValue({
+            total_processed: 0,
+            total_nudged: 0,
+            total_escalated: 0,
+        });
+        const onRenew = vi
+            .fn()
+            .mockResolvedValue({ renewed: true, expires_at: "2026-03-28T00:00:00Z" });
+        const onLog = vi.fn();
+        const onError = vi.fn();
+        const onShutdown = vi.fn().mockResolvedValue(undefined);
+        const handle = startProjectWatcherLoop({
+            intervalSeconds: 60,
+            renewalIntervalSeconds: 180,
+            onTick,
+            onRenew,
+            onLog,
+            onError,
+            onShutdown,
+        });
+        await handle.stop();
+        // Advance time well past intervals — no more ticks or renewals should fire
+        await vi.advanceTimersByTimeAsync(400_000);
+        expect(onTick).toHaveBeenCalledTimes(0);
+        expect(onRenew).toHaveBeenCalledTimes(0);
+        expect(onShutdown).toHaveBeenCalledTimes(1);
+    });
+});
+describe("project watcher renewal interval constant", () => {
+    it("renewal interval is 180s (60% of 300s TTL)", () => {
+        expect(PROJECT_WATCHER_RENEWAL_INTERVAL_SECONDS).toBe(180);
+    });
+});
+//# sourceMappingURL=watcher-runtime.test.js.map

package/dist/__tests__/watcher-runtime.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-runtime.test.js","sourceRoot":"","sources":["../../src/__tests__/watcher-runtime.test.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.js

@@ -27,6 +27,7 @@ import { stop } from "./stop.js";
 import { sync } from "./sync.js";
 import { test } from "./test.js";
 import { token } from "./token.js";
+import { pullWatcher, startProjectWatcher, startWatcher, stopWatcher, watcherStatus, } from "./watcher.js";
 import { resolvePO, whoami } from "./whoami.js";
 import { pauseWorkerAutomation, resumeWorkerAutomation } from "./worker.js";
 const require = createRequire(import.meta.url);
@@ -103,6 +104,7 @@ program
     .option("--sandbox-cpu <limit>", "CPU limit for sandbox (default: 1)")
     .option("--sandbox-memory <limit>", "Memory limit for sandbox (default: 2g)")
     .option("--autonomous", "Run agent in fully autonomous mode — skips all runtime permission prompts. Use with --worker for long-lived unattended agents.")
+    .option("--team-id <id>", "Team ID to register this worker agent with (required for --worker)")
     .action(async (options) => {
     try {
         if (options.project && options.workdir) {
@@ -264,6 +266,107 @@ claimsCommand
         process.exit(1);
     }
 });
+const watcherCommand = program.command("watcher").description("Team watcher runtime controls");
+watcherCommand
+    .command("start")
+    .description("Start watcher runtime for a team (--team-id) or project (--project-id)")
+    .option("--team-id <teamId>", "Team ID (team-scoped watcher)")
+    .option("--project-id <projectId>", "Project ID (project-scoped watcher with tick loop)")
+    .option("-n, --name <name>", "Agent name")
+    .option("-f, --foreground", "Run in foreground (blocking)")
+    .option("--interval <seconds>", "Tick interval in seconds for project watcher (default: 60)")
+    .option("--interval-seconds <seconds>", "Snapshot publish interval in seconds (default: 15)")
+    .option("--heartbeat-seconds <seconds>", "Lease renewal interval in seconds (default: 10)")
+    .option("--ttl-seconds <seconds>", "Lease TTL in seconds (default: 30)")
+    .action(async (options) => {
+    try {
+        if (options.projectId) {
+            await startProjectWatcher({
+                projectId: options.projectId,
+                name: options.name,
+                foreground: options.foreground,
+                intervalSeconds: options.interval ? parseInt(options.interval, 10) : undefined,
+            });
+        }
+        else if (options.teamId) {
+            await startWatcher({
+                teamId: options.teamId,
+                name: options.name,
+                foreground: options.foreground,
+                intervalSeconds: options.intervalSeconds
+                    ? parseInt(options.intervalSeconds, 10)
+                    : undefined,
+                heartbeatSeconds: options.heartbeatSeconds
+                    ? parseInt(options.heartbeatSeconds, 10)
+                    : undefined,
+                ttlSeconds: options.ttlSeconds ? parseInt(options.ttlSeconds, 10) : undefined,
+            });
+        }
+        else {
+            console.error(pc.red("Either --team-id or --project-id is required."));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(pc.red(error.message));
+        process.exit(1);
+    }
+});
+watcherCommand
+    .command("stop")
+    .description("Stop local watcher runtime for a team")
+    .requiredOption("--team-id <teamId>", "Team ID")
+    .action(async (options) => {
+    try {
+        await stopWatcher({ teamId: options.teamId });
+    }
+    catch (error) {
+        console.error(pc.red(error.message));
+        process.exit(1);
+    }
+});
+watcherCommand
+    .command("status")
+    .description("Show watcher status for a team")
+    .requiredOption("--team-id <teamId>", "Team ID")
+    .option("-n, --name <name>", "Agent name")
+    .option("--json", "Output JSON")
+    .option("--stale-after-seconds <seconds>", "Override stale threshold seconds")
+    .action(async (options) => {
+    try {
+        await watcherStatus({
+            teamId: options.teamId,
+            name: options.name,
+            json: options.json,
+            staleAfterSeconds: options.staleAfterSeconds
+                ? parseInt(options.staleAfterSeconds, 10)
+                : undefined,
+        });
+    }
+    catch (error) {
+        console.error(pc.red(error.message));
+        process.exit(1);
+    }
+});
+watcherCommand
+    .command("pull")
+    .description("Pull latest watcher snapshot for a team")
+    .requiredOption("--team-id <teamId>", "Team ID")
+    .option("-n, --name <name>", "Agent name")
+    .option("--json", "Output JSON")
+    .action(async (options) => {
+    try {
+        await pullWatcher({
+            teamId: options.teamId,
+            name: options.name,
+            json: options.json,
+        });
+    }
+    catch (error) {
+        console.error(pc.red(error.message));
+        process.exit(1);
+    }
+});
 handoffCommand
     .command("reject")
     .description("Reject a handoff")