@herdctl/core 1.3.0 → 2.0.0

package/dist/runner/runtime/__tests__/integration.test.js

@@ -0,0 +1,274 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { execSync } from "node:child_process";
+import { mkdir, rm, realpath } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { RuntimeFactory } from "../factory.js";
+// =============================================================================
+// Environment Detection
+// =============================================================================
+function isCliAvailable() {
+    try {
+        execSync("claude --version", { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isDockerAvailable() {
+    try {
+        execSync("docker info", { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const CLI_AVAILABLE = isCliAvailable();
+const DOCKER_AVAILABLE = isDockerAvailable();
+// =============================================================================
+// Test Helpers
+// =============================================================================
+async function createTempDir() {
+    const baseDir = join(tmpdir(), `herdctl-runtime-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    await mkdir(baseDir, { recursive: true });
+    return await realpath(baseDir);
+}
+function createTestAgent(overrides = {}) {
+    return {
+        name: "test-agent",
+        configPath: "/path/to/agent.yaml",
+        ...overrides,
+    };
+}
+// =============================================================================
+// RuntimeFactory Integration Tests
+// =============================================================================
+describe("RuntimeFactory Integration", () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await createTempDir();
+    });
+    afterEach(async () => {
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    describe("SDK Runtime", () => {
+        it("creates SDK runtime and returns RuntimeInterface", () => {
+            const agent = createTestAgent({ runtime: "sdk" });
+            const runtime = RuntimeFactory.create(agent);
+            expect(runtime).toBeDefined();
+            expect(runtime.execute).toBeDefined();
+            expect(typeof runtime.execute).toBe("function");
+        });
+        it("SDK runtime has correct constructor name", () => {
+            const agent = createTestAgent({ runtime: "sdk" });
+            const runtime = RuntimeFactory.create(agent);
+            // Verify it's actually an SDK runtime (not wrapped)
+            expect(runtime.constructor.name).toBe("SDKRuntime");
+        });
+        it("SDK runtime execute returns AsyncIterable interface", async () => {
+            const agent = createTestAgent({ runtime: "sdk" });
+            const runtime = RuntimeFactory.create(agent);
+            // Verify the method signature is correct
+            // We can't fully test without mocking SDK internals
+            // but we verify the interface is correct
+            expect(runtime.execute).toBeDefined();
+            expect(typeof runtime.execute).toBe("function");
+        });
+        it("defaults to SDK runtime when runtime not specified", () => {
+            const agent = createTestAgent(); // No runtime specified
+            const runtime = RuntimeFactory.create(agent);
+            expect(runtime.constructor.name).toBe("SDKRuntime");
+        });
+    });
+    describe("CLI Runtime", () => {
+        it.skipIf(!CLI_AVAILABLE)("creates CLI runtime with correct interface", () => {
+            const agent = createTestAgent({ runtime: "cli" });
+            const runtime = RuntimeFactory.create(agent);
+            expect(runtime).toBeDefined();
+            expect(runtime.execute).toBeDefined();
+            expect(typeof runtime.execute).toBe("function");
+        });
+        it.skipIf(!CLI_AVAILABLE)("CLI runtime has correct constructor name", () => {
+            const agent = createTestAgent({ runtime: "cli" });
+            const runtime = RuntimeFactory.create(agent);
+            // Note: Full CLI integration would require actual claude execution
+            // which uses API credits. This test verifies setup only.
+            expect(runtime.constructor.name).toBe("CLIRuntime");
+        });
+        it.skipIf(!CLI_AVAILABLE)("CLI runtime accepts workspace parameter", () => {
+            const agent = createTestAgent({ runtime: "cli" });
+            const runtime = RuntimeFactory.create(agent);
+            // Verify runtime can be created with workspace configuration
+            expect(runtime).toBeDefined();
+        });
+    });
+    describe("Docker Runtime", () => {
+        it.skipIf(!DOCKER_AVAILABLE)("wraps SDK with ContainerRunner when docker enabled", () => {
+            const agent = createTestAgent({
+                runtime: "sdk",
+                docker: {
+                    enabled: true,
+                    image: "alpine:latest",
+                },
+            });
+            const runtime = RuntimeFactory.create(agent, { stateDir: tempDir });
+            // Verify it's wrapped (ContainerRunner wraps the base runtime)
+            expect(runtime.constructor.name).toBe("ContainerRunner");
+        });
+        it.skipIf(!DOCKER_AVAILABLE)("wraps CLI with ContainerRunner when docker enabled", () => {
+            const agent = createTestAgent({
+                runtime: "cli",
+                docker: {
+                    enabled: true,
+                    image: "alpine:latest",
+                },
+            });
+            const runtime = RuntimeFactory.create(agent, { stateDir: tempDir });
+            expect(runtime.constructor.name).toBe("ContainerRunner");
+        });
+        it.skipIf(!DOCKER_AVAILABLE)("creates docker-sessions directory in stateDir", async () => {
+            const stateDir = join(tempDir, ".herdctl");
+            await mkdir(stateDir, { recursive: true });
+            const agent = createTestAgent({
+                docker: {
+                    enabled: true,
+                    image: "alpine:latest",
+                },
+            });
+            // Just verify RuntimeFactory accepts stateDir
+            const runtime = RuntimeFactory.create(agent, { stateDir });
+            expect(runtime).toBeDefined();
+        });
+        it.skipIf(!DOCKER_AVAILABLE)("defaults stateDir to .herdctl when not provided", () => {
+            const agent = createTestAgent({
+                docker: {
+                    enabled: true,
+                    image: "alpine:latest",
+                },
+            });
+            // Should not throw even without stateDir (uses default)
+            const runtime = RuntimeFactory.create(agent);
+            expect(runtime).toBeDefined();
+        });
+    });
+});
+// =============================================================================
+// Path Translation Tests
+// =============================================================================
+describe("Path Translation", () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await createTempDir();
+    });
+    afterEach(async () => {
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    it("workspace paths are consistent across runtime types", () => {
+        const workspace = join(tempDir, "workspace");
+        // SDK runtime uses workspace directly
+        const sdkAgent = createTestAgent({ runtime: "sdk" });
+        const sdkRuntime = RuntimeFactory.create(sdkAgent);
+        // CLI runtime also uses workspace directly (but different session storage)
+        const cliAgent = createTestAgent({ runtime: "cli" });
+        const cliRuntime = RuntimeFactory.create(cliAgent);
+        // Both should accept the same workspace path
+        expect(sdkRuntime).toBeDefined();
+        expect(cliRuntime).toBeDefined();
+    });
+    it.skipIf(!DOCKER_AVAILABLE)("Docker sessions stored separately from host sessions", async () => {
+        const stateDir = join(tempDir, ".herdctl");
+        await mkdir(stateDir, { recursive: true });
+        const agent = createTestAgent({
+            docker: {
+                enabled: true,
+                image: "alpine:latest",
+            },
+        });
+        const runtime = RuntimeFactory.create(agent, { stateDir });
+        // Docker sessions should go to docker-sessions/, not sessions/
+        // This is verified by the ContainerRunner implementation
+        expect(runtime).toBeDefined();
+    });
+    it("workspace can be specified as string", () => {
+        const agent = createTestAgent({
+            runtime: "sdk",
+            working_directory: "/path/to/workspace",
+        });
+        const runtime = RuntimeFactory.create(agent);
+        expect(runtime).toBeDefined();
+    });
+    it("workspace can be specified as object with root", () => {
+        const agent = createTestAgent({
+            runtime: "sdk",
+            working_directory: {
+                root: "/path/to/workspace",
+                auto_clone: true,
+                clone_depth: 1,
+                default_branch: "main",
+            },
+        });
+        const runtime = RuntimeFactory.create(agent);
+        expect(runtime).toBeDefined();
+    });
+});
+// =============================================================================
+// Error Handling Tests
+// =============================================================================
+describe("Runtime Error Handling", () => {
+    it("throws for invalid runtime type", () => {
+        const agent = createTestAgent({ runtime: "invalid" });
+        expect(() => RuntimeFactory.create(agent)).toThrow(/Unknown runtime type/);
+    });
+    it("includes helpful message for unknown runtime", () => {
+        const agent = createTestAgent({ runtime: "postgres" });
+        expect(() => RuntimeFactory.create(agent)).toThrow(/Supported types/);
+    });
+    it("error message lists supported runtime types", () => {
+        const agent = createTestAgent({ runtime: "invalid" });
+        try {
+            RuntimeFactory.create(agent);
+            expect.fail("Should have thrown");
+        }
+        catch (error) {
+            const message = error.message;
+            expect(message).toContain("sdk");
+            expect(message).toContain("cli");
+        }
+    });
+});
+// =============================================================================
+// Runtime Interface Compliance Tests
+// =============================================================================
+describe("Runtime Interface Compliance", () => {
+    it("all runtimes expose execute method", () => {
+        const sdkAgent = createTestAgent({ runtime: "sdk" });
+        const sdkRuntime = RuntimeFactory.create(sdkAgent);
+        expect(sdkRuntime.execute).toBeDefined();
+        expect(typeof sdkRuntime.execute).toBe("function");
+        if (CLI_AVAILABLE) {
+            const cliAgent = createTestAgent({ runtime: "cli" });
+            const cliRuntime = RuntimeFactory.create(cliAgent);
+            expect(cliRuntime.execute).toBeDefined();
+            expect(typeof cliRuntime.execute).toBe("function");
+        }
+    });
+    it("ContainerRunner preserves RuntimeInterface", () => {
+        if (!DOCKER_AVAILABLE) {
+            return;
+        }
+        const agent = createTestAgent({
+            runtime: "sdk",
+            docker: {
+                enabled: true,
+                image: "alpine:latest",
+            },
+        });
+        const runtime = RuntimeFactory.create(agent);
+        // ContainerRunner should still expose execute
+        expect(runtime.execute).toBeDefined();
+        expect(typeof runtime.execute).toBe("function");
+    });
+});
+//# sourceMappingURL=integration.test.js.map

package/dist/runner/runtime/__tests__/integration.test.js.map

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

package/dist/runner/runtime/cli-runtime.d.ts

@@ -0,0 +1,107 @@
+/**
+ * CLI Runtime implementation
+ *
+ * Executes Claude agents via the Claude CLI instead of the SDK, enabling Max plan
+ * pricing for agent execution. This runtime spawns the `claude` CLI command and
+ * watches the session file for messages (since claude only outputs to TTY).
+ *
+ * Requirements:
+ * - Claude CLI must be installed (`brew install claude-ai/tap/claude`)
+ * - CLI must be authenticated (`claude login`)
+ * - Uses Max plan pricing when available
+ *
+ * The CLIRuntime provides identical streaming interface to SDKRuntime, allowing
+ * seamless runtime switching via agent configuration.
+ */
+import { type Subprocess } from "execa";
+import type { RuntimeInterface, RuntimeExecuteOptions } from "./interface.js";
+import type { SDKMessage } from "../types.js";
+/**
+ * Process spawner function type
+ *
+ * Spawns a claude CLI process and returns a subprocess handle.
+ * Used to allow custom process spawning (e.g., inside Docker containers).
+ *
+ * Returns Subprocess directly (not wrapped in Promise) - execa returns
+ * a special promise-like object (Subprocess) that has extra properties.
+ *
+ * @param args - CLI arguments (without prompt)
+ * @param cwd - Working directory
+ * @param prompt - Prompt text to provide via stdin (required for -p mode)
+ * @param signal - AbortSignal for cancellation
+ */
+export type ProcessSpawner = (args: string[], cwd: string, prompt: string, signal?: AbortSignal) => Subprocess;
+/**
+ * CLI runtime configuration options
+ */
+export interface CLIRuntimeOptions {
+    /**
+     * Custom process spawner for claude CLI execution
+     *
+     * Defaults to local execa spawning. Provide custom spawner for Docker execution.
+     */
+    processSpawner?: ProcessSpawner;
+    /**
+     * Custom session directory override
+     *
+     * For Docker execution, this should be the host-side mount point where
+     * container session files are visible (e.g., .herdctl/docker-sessions).
+     */
+    sessionDirOverride?: string;
+}
+/**
+ * CLI runtime implementation
+ *
+ * This runtime uses the Claude CLI to execute agents, providing an alternative
+ * backend to the SDK runtime. It spawns `claude` CLI and watches the session file
+ * for new messages (since claude only outputs stream-json to TTY).
+ *
+ * The CLI runtime enables:
+ * - Max plan pricing (cost savings vs SDK/API pricing)
+ * - Full Claude Code capabilities (identical to manual CLI usage)
+ * - AbortController support for process cancellation
+ *
+ * Supports both local and Docker execution via configurable process spawning.
+ *
+ * @example
+ * ```typescript
+ * // Local execution
+ * const runtime = new CLIRuntime();
+ *
+ * // Docker execution
+ * const runtime = new CLIRuntime({
+ *   processSpawner: async (args, cwd, signal) => {
+ *     return execa("docker", ["exec", containerId, "sh", "-c",
+ *                             `cd /workspace && claude ${args.join(" ")}`],
+ *                  { cancelSignal: signal });
+ *   },
+ *   sessionDirOverride: "/path/to/.herdctl/docker-sessions"
+ * });
+ * ```
+ */
+export declare class CLIRuntime implements RuntimeInterface {
+    private processSpawner;
+    private sessionDirOverride?;
+    constructor(options?: CLIRuntimeOptions);
+    /**
+     * Execute an agent using the Claude CLI
+     *
+     * Spawns `claude` CLI and watches the session file for messages. The session
+     * file approach is used because claude only outputs stream-json to TTY, not
+     * to pipes.
+     *
+     * Process flow:
+     * 1. Build CLI arguments from execution options
+     * 2. Spawn claude subprocess (output is ignored)
+     * 3. Find the CLI session directory for the workspace
+     * 4. Wait briefly for session file to be created
+     * 5. Find the newest .jsonl file (the one just created)
+     * 6. Watch that file and stream messages as they're appended
+     * 7. Handle process completion and exit codes
+     *
+     * @param options - Execution options including prompt, agent, and session info
+     * @returns AsyncIterable of SDK messages
+     */
+    execute(options: RuntimeExecuteOptions): AsyncIterable<SDKMessage>;
+}
+//# sourceMappingURL=cli-runtime.d.ts.map

package/dist/runner/runtime/cli-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runtime.d.ts","sourceRoot":"","sources":["../../../src/runner/runtime/cli-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAS9C;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,KACjB,UAAU,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,UAAW,YAAW,gBAAgB;IACjD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,kBAAkB,CAAC,CAAS;gBAExB,OAAO,CAAC,EAAE,iBAAiB;IAYvC;;;;;;;;;;;;;;;;;;OAkBG;IACI,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAAC,UAAU,CAAC;CAoT1E"}