pulseed 0.1.4 → 0.2.0

package/dist/adapters/agents/a2a-client.js

@@ -0,0 +1,178 @@
+// ─── A2AClient ───
+//
+// HTTP/SSE client for A2A (Agent-to-Agent) Protocol v0.3 JSON-RPC calls.
+// Uses Node.js built-in fetch (Node 18+) to avoid external HTTP dependencies.
+import { randomUUID } from "node:crypto";
+import { A2AAgentCardSchema, A2ATaskSchema, A2AJsonRpcResponseSchema, A2A_TERMINAL_STATES, } from "../../base/types/a2a.js";
+// ─── Client ───
+export class A2AClient {
+    baseUrl;
+    authToken;
+    pollIntervalMs;
+    maxWaitMs;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.authToken = config.authToken;
+        this.pollIntervalMs = config.pollIntervalMs ?? 2_000;
+        this.maxWaitMs = config.maxWaitMs ?? 300_000;
+    }
+    // ─── Agent Card Discovery ───
+    async fetchAgentCard() {
+        const url = `${this.baseUrl}/.well-known/agent.json`;
+        const res = await this.httpGet(url);
+        return A2AAgentCardSchema.parse(res);
+    }
+    // ─── message/send (blocking) ───
+    async sendMessage(message) {
+        const body = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "message/send",
+            params: { message },
+        };
+        const res = await this.jsonRpc(body);
+        return A2ATaskSchema.parse(res);
+    }
+    // ─── tasks/get ───
+    async getTask(taskId) {
+        const body = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "tasks/get",
+            params: { id: taskId },
+        };
+        const res = await this.jsonRpc(body);
+        return A2ATaskSchema.parse(res);
+    }
+    // ─── tasks/cancel ───
+    async cancelTask(taskId) {
+        const body = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "tasks/cancel",
+            params: { id: taskId },
+        };
+        await this.jsonRpc(body);
+    }
+    // ─── Polling loop ───
+    async waitForCompletion(taskId, signal) {
+        const deadline = Date.now() + this.maxWaitMs;
+        while (Date.now() < deadline) {
+            if (signal?.aborted) {
+                throw new Error("A2A task wait aborted");
+            }
+            const task = await this.getTask(taskId);
+            if (A2A_TERMINAL_STATES.has(task.status.state)) {
+                return task;
+            }
+            await sleep(this.pollIntervalMs);
+        }
+        // Attempt cancel on timeout
+        try {
+            await this.cancelTask(taskId);
+        }
+        catch {
+            /* best-effort */
+        }
+        throw new Error(`A2A task ${taskId} did not complete within ${this.maxWaitMs}ms`);
+    }
+    // ─── SSE streaming (message/stream) ───
+    async sendMessageStream(message, onStatus, signal) {
+        const body = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "message/stream",
+            params: { message },
+        };
+        const res = await fetch(`${this.baseUrl}`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify(body),
+            signal,
+        });
+        if (!res.ok) {
+            throw new Error(`A2A stream request failed: ${res.status} ${res.statusText}`);
+        }
+        if (!res.body) {
+            throw new Error("A2A stream response has no body");
+        }
+        // Parse SSE events from the response stream
+        let latestTask = null;
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (line.startsWith("data: ")) {
+                    const data = line.slice(6).trim();
+                    if (!data || data === "[DONE]")
+                        continue;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const kind = parsed.kind;
+                        if (kind === "task" || (!kind && parsed.id && parsed.status)) {
+                            latestTask = A2ATaskSchema.parse(parsed);
+                        }
+                        else if (kind === "status-update" && parsed.status) {
+                            const status = parsed.status;
+                            if (status.state) {
+                                onStatus?.(status.state, status.message);
+                            }
+                        }
+                        // artifact-update events are accumulated in the task object
+                    }
+                    catch {
+                        // Skip malformed SSE data lines
+                    }
+                }
+            }
+        }
+        if (!latestTask) {
+            throw new Error("A2A stream ended without returning a task");
+        }
+        return latestTask;
+    }
+    // ─── Private ───
+    buildHeaders() {
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        if (this.authToken) {
+            headers["Authorization"] = `Bearer ${this.authToken}`;
+        }
+        return headers;
+    }
+    async httpGet(url) {
+        const res = await fetch(url, { headers: this.buildHeaders() });
+        if (!res.ok) {
+            throw new Error(`A2A GET ${url} failed: ${res.status} ${res.statusText}`);
+        }
+        return res.json();
+    }
+    async jsonRpc(body) {
+        const res = await fetch(`${this.baseUrl}`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            throw new Error(`A2A JSON-RPC failed: ${res.status} ${res.statusText}`);
+        }
+        const json = A2AJsonRpcResponseSchema.parse(await res.json());
+        if (json.error) {
+            throw new Error(`A2A JSON-RPC error ${json.error.code}: ${json.error.message}`);
+        }
+        return json.result;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=a2a-client.js.map

package/dist/adapters/agents/a2a-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-client.js","sourceRoot":"","sources":["../../../src/adapters/agents/a2a-client.ts"],"names":[],"mappings":"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"}

package/dist/adapters/agents/agent-profile-loader.d.ts

@@ -0,0 +1,26 @@
+import { type AgentProfileWithPrompt } from "../../base/types/agent-profile.js";
+export declare class AgentProfileLoader {
+    private readonly agentsDir;
+    constructor(agentsDir: string);
+    /** Load all *.md files from agentsDir. Skips invalid files with a warning. */
+    loadAll(): Promise<AgentProfileWithPrompt[]>;
+    /** Load and validate a single agent profile file. Throws on invalid content. */
+    loadOne(filePath: string): Promise<AgentProfileWithPrompt>;
+    /**
+     * Split content on --- delimiters and parse YAML frontmatter.
+     * Expects format:
+     *   ---
+     *   key: value
+     *   ---
+     *   body text
+     */
+    static parseFrontmatter(content: string): {
+        frontmatter: Record<string, unknown>;
+        body: string;
+    };
+    /** Find a profile by exact name. Returns null if not found. */
+    findByName(profiles: AgentProfileWithPrompt[], name: string): AgentProfileWithPrompt | null;
+    /** Find all profiles that include the given capability. */
+    findByCapability(profiles: AgentProfileWithPrompt[], capability: string): AgentProfileWithPrompt[];
+}
+//# sourceMappingURL=agent-profile-loader.d.ts.map

package/dist/adapters/agents/agent-profile-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profile-loader.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/agent-profile-loader.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAIpG,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAE9C,8EAA8E;IACxE,OAAO,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAyBlD,gFAAgF;IAC1E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAOhE;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IA8BhG,+DAA+D;IAC/D,UAAU,CAAC,QAAQ,EAAE,sBAAsB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAI3F,2DAA2D;IAC3D,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,sBAAsB,EAAE;CAGnG"}

package/dist/adapters/agents/agent-profile-loader.js

@@ -0,0 +1,88 @@
+// ─── AgentProfileLoader ───
+//
+// Loads agent definition files from ~/.pulseed/agents/*.md.
+// Each file has YAML frontmatter (AgentProfile fields) + a system prompt body.
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import yaml from "js-yaml";
+import { AgentProfileSchema } from "../../base/types/agent-profile.js";
+// ─── AgentProfileLoader ───
+export class AgentProfileLoader {
+    agentsDir;
+    constructor(agentsDir) {
+        this.agentsDir = agentsDir;
+    }
+    /** Load all *.md files from agentsDir. Skips invalid files with a warning. */
+    async loadAll() {
+        let entries;
+        try {
+            entries = await fsp.readdir(this.agentsDir);
+        }
+        catch {
+            return [];
+        }
+        const mdFiles = entries.filter((e) => e.endsWith(".md"));
+        const results = [];
+        for (const file of mdFiles) {
+            const filePath = path.join(this.agentsDir, file);
+            try {
+                const profile = await this.loadOne(filePath);
+                results.push(profile);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(`[agent-profile-loader] Skipping ${file}: ${msg}`);
+            }
+        }
+        return results;
+    }
+    /** Load and validate a single agent profile file. Throws on invalid content. */
+    async loadOne(filePath) {
+        const content = await fsp.readFile(filePath, "utf-8");
+        const { frontmatter, body } = AgentProfileLoader.parseFrontmatter(content);
+        const parsed = AgentProfileSchema.parse(frontmatter);
+        return { ...parsed, system_prompt: body.trim(), file_path: filePath };
+    }
+    /**
+     * Split content on --- delimiters and parse YAML frontmatter.
+     * Expects format:
+     *   ---
+     *   key: value
+     *   ---
+     *   body text
+     */
+    static parseFrontmatter(content) {
+        const lines = content.split("\n");
+        // Must start with ---
+        if (lines[0]?.trim() !== "---") {
+            return { frontmatter: {}, body: content };
+        }
+        // Find the closing ---
+        const closeIdx = lines.findIndex((line, i) => i > 0 && line.trim() === "---");
+        if (closeIdx === -1) {
+            return { frontmatter: {}, body: content };
+        }
+        const yamlLines = lines.slice(1, closeIdx).join("\n");
+        const bodyLines = lines.slice(closeIdx + 1).join("\n");
+        let frontmatter;
+        try {
+            const parsed = yaml.load(yamlLines);
+            frontmatter = (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed))
+                ? parsed
+                : {};
+        }
+        catch {
+            frontmatter = {};
+        }
+        return { frontmatter, body: bodyLines };
+    }
+    /** Find a profile by exact name. Returns null if not found. */
+    findByName(profiles, name) {
+        return profiles.find((p) => p.name === name) ?? null;
+    }
+    /** Find all profiles that include the given capability. */
+    findByCapability(profiles, capability) {
+        return profiles.filter((p) => p.capabilities.includes(capability));
+    }
+}
+//# sourceMappingURL=agent-profile-loader.js.map

package/dist/adapters/agents/agent-profile-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profile-loader.js","sourceRoot":"","sources":["../../../src/adapters/agents/agent-profile-loader.ts"],"names":[],"mappings":"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"}

package/dist/adapters/agents/browser-use-cli.d.ts

@@ -0,0 +1,19 @@
+import type { IAdapter, AgentTask, AgentResult } from "../../orchestrator/execution/adapter-layer.js";
+export interface BrowserUseCLIAdapterConfig {
+    /** The executable name / path for the browser-use CLI. Default: "browser-use" */
+    cliPath?: string;
+    /** Whether to run the browser in headless mode. Default: true */
+    headless?: boolean;
+    /** Whether to request JSON-formatted output. Default: true */
+    jsonOutput?: boolean;
+}
+export declare class BrowserUseCLIAdapter implements IAdapter {
+    readonly adapterType = "browser_use_cli";
+    readonly capabilities: readonly ["browse_web", "web_scraping", "form_filling", "screenshot"];
+    private readonly cliPath;
+    private readonly headless;
+    private readonly jsonOutput;
+    constructor(config?: BrowserUseCLIAdapterConfig);
+    execute(task: AgentTask): Promise<AgentResult>;
+}
+//# sourceMappingURL=browser-use-cli.d.ts.map

package/dist/adapters/agents/browser-use-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-use-cli.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/browser-use-cli.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAGtG,MAAM,WAAW,0BAA0B;IACzC,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,QAAQ,CAAC,WAAW,qBAAqB;IACzC,QAAQ,CAAC,YAAY,wEAAyE;IAE9F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,MAAM,GAAE,0BAA+B;IAM7C,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CA4DrD"}

package/dist/adapters/agents/browser-use-cli.js

@@ -0,0 +1,74 @@
+// ─── BrowserUseCLIAdapter ───
+//
+// IAdapter implementation that spawns the `browser-use` CLI process.
+// The task prompt is passed via stdin to avoid exposing it in the
+// process argument list (visible via `ps aux`).
+// Uses --headless for non-interactive browser automation and --json
+// for structured output.
+//
+// Invocation pattern:
+//   echo "<prompt>" | browser-use run --headless --json
+//
+// The CLI takes a natural language task, controls a browser with AI,
+// and returns the result (JSON when --json is used).
+import { spawnWithTimeout } from "../spawn-helper.js";
+export class BrowserUseCLIAdapter {
+    adapterType = "browser_use_cli";
+    capabilities = ["browse_web", "web_scraping", "form_filling", "screenshot"];
+    cliPath;
+    headless;
+    jsonOutput;
+    constructor(config = {}) {
+        this.cliPath = config.cliPath ?? "browser-use";
+        this.headless = config.headless !== false;
+        this.jsonOutput = config.jsonOutput !== false;
+    }
+    async execute(task) {
+        const startedAt = Date.now();
+        // Build argument list: run [--headless] [--json]
+        // Prompt is written to stdin to avoid exposure in `ps aux`.
+        const spawnArgs = ["run"];
+        if (this.headless) {
+            spawnArgs.push("--headless");
+        }
+        if (this.jsonOutput) {
+            spawnArgs.push("--json");
+        }
+        const result = await spawnWithTimeout(this.cliPath, spawnArgs, { env: process.env, stdinData: task.system_prompt ? `[System Context]
+${task.system_prompt}
+
+[User Request]
+${task.prompt}` : task.prompt }, task.timeout_ms);
+        const elapsed = Date.now() - startedAt;
+        if (result.timedOut) {
+            return {
+                success: false,
+                output: result.stdout,
+                error: `Timed out after ${task.timeout_ms}ms`,
+                exit_code: result.exitCode,
+                elapsed_ms: elapsed,
+                stopped_reason: "timeout",
+            };
+        }
+        if (result.exitCode === null) {
+            return {
+                success: false,
+                output: result.stdout,
+                error: result.stderr,
+                exit_code: null,
+                elapsed_ms: elapsed,
+                stopped_reason: "error",
+            };
+        }
+        const success = result.exitCode === 0;
+        return {
+            success,
+            output: result.stdout,
+            error: success ? null : result.stderr || `Process exited with code ${result.exitCode}`,
+            exit_code: result.exitCode,
+            elapsed_ms: elapsed,
+            stopped_reason: success ? "completed" : "error",
+        };
+    }
+}
+//# sourceMappingURL=browser-use-cli.js.map

package/dist/adapters/agents/browser-use-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-use-cli.js","sourceRoot":"","sources":["../../../src/adapters/agents/browser-use-cli.ts"],"names":[],"mappings":"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"}

package/dist/adapters/agents/claude-api.d.ts

@@ -0,0 +1,10 @@
+import type { IAdapter, AgentTask, AgentResult } from "../../orchestrator/execution/adapter-layer.js";
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+export declare class ClaudeAPIAdapter implements IAdapter {
+    readonly adapterType = "claude_api";
+    readonly capabilities: readonly ["text_generation", "analysis", "planning"];
+    private readonly llmClient;
+    constructor(llmClient: ILLMClient);
+    execute(task: AgentTask): Promise<AgentResult>;
+}
+//# sourceMappingURL=claude-api.d.ts.map

package/dist/adapters/agents/claude-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-api.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/claude-api.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,WAAW,gBAAgB;IACpC,QAAQ,CAAC,YAAY,uDAAwD;IAE7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;gBAE3B,SAAS,EAAE,UAAU;IAI3B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAsDrD"}

package/dist/adapters/agents/claude-api.js

@@ -0,0 +1,64 @@
+// ─── ClaudeAPIAdapter ───
+//
+// IAdapter implementation that wraps ILLMClient.sendMessage().
+// Intended for tasks where a single LLM call is sufficient.
+// Timeout is handled via Promise.race().
+export class ClaudeAPIAdapter {
+    adapterType = "claude_api";
+    capabilities = ["text_generation", "analysis", "planning"];
+    llmClient;
+    constructor(llmClient) {
+        this.llmClient = llmClient;
+    }
+    async execute(task) {
+        const startedAt = Date.now();
+        // Build a timeout promise that resolves to a timeout AgentResult.
+        let timeoutHandle;
+        const timeoutPromise = new Promise((resolve) => {
+            timeoutHandle = setTimeout(() => {
+                resolve({
+                    success: false,
+                    output: "",
+                    error: `Timed out after ${task.timeout_ms}ms`,
+                    exit_code: null,
+                    elapsed_ms: Date.now() - startedAt,
+                    stopped_reason: "timeout",
+                });
+            }, task.timeout_ms);
+        });
+        // The actual LLM call.
+        const llmPromise = (async () => {
+            try {
+                const systemOpts = task.system_prompt ? { system: task.system_prompt } : undefined;
+                const response = await this.llmClient.sendMessage([
+                    { role: "user", content: task.prompt },
+                ], systemOpts);
+                return {
+                    success: true,
+                    output: response.content,
+                    error: null,
+                    exit_code: null,
+                    elapsed_ms: Date.now() - startedAt,
+                    stopped_reason: "completed",
+                };
+            }
+            catch (err) {
+                return {
+                    success: false,
+                    output: "",
+                    error: err instanceof Error ? err.message : String(err),
+                    exit_code: null,
+                    elapsed_ms: Date.now() - startedAt,
+                    stopped_reason: "error",
+                };
+            }
+        })();
+        const result = await Promise.race([llmPromise, timeoutPromise]);
+        // Clear the timeout once a result is determined.
+        if (timeoutHandle !== undefined) {
+            clearTimeout(timeoutHandle);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=claude-api.js.map

package/dist/adapters/agents/claude-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-api.js","sourceRoot":"","sources":["../../../src/adapters/agents/claude-api.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,+DAA+D;AAC/D,4DAA4D;AAC5D,yCAAyC;AAKzC,MAAM,OAAO,gBAAgB;IAClB,WAAW,GAAG,YAAY,CAAC;IAC3B,YAAY,GAAG,CAAC,iBAAiB,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;IAE5D,SAAS,CAAa;IAEvC,YAAY,SAAqB;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,kEAAkE;QAClE,IAAI,aAAwD,CAAC;QAC7D,MAAM,cAAc,GAAyB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACnE,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,CAAC;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,mBAAmB,IAAI,CAAC,UAAU,IAAI;oBAC7C,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,SAAS;iBAC1B,CAAC,CAAC;YACL,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,UAAU,GAAyB,CAAC,KAAK,IAAI,EAAE;YACnD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;oBAC5C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;iBACvC,EAAE,UAAU,CAAC,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,QAAQ,CAAC,OAAO;oBACxB,KAAK,EAAE,IAAI;oBACX,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,WAAoB;iBACrC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACvD,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,OAAgB;iBACjC,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;QAEhE,iDAAiD;QACjD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/adapters/agents/claude-code-cli.d.ts

@@ -0,0 +1,14 @@
+import type { IAdapter, AgentTask, AgentResult } from "../../orchestrator/execution/adapter-layer.js";
+export declare class ClaudeCodeCLIAdapter implements IAdapter {
+    readonly adapterType = "claude_code_cli";
+    readonly capabilities: readonly ["execute_code", "read_files", "write_files", "run_commands"];
+    /**
+     * The executable name / path for the claude CLI.
+     * Override in tests to point at a different binary (e.g. "echo").
+     */
+    private readonly cliPath;
+    private readonly workDir;
+    constructor(cliPath?: string, workDir?: string);
+    execute(task: AgentTask): Promise<AgentResult>;
+}
+//# sourceMappingURL=claude-code-cli.d.ts.map

package/dist/adapters/agents/claude-code-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-cli.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/claude-code-cli.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAGtG,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,QAAQ,CAAC,WAAW,qBAAqB;IACzC,QAAQ,CAAC,YAAY,yEAA0E;IAE/F;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,GAAE,MAAiB,EAAE,OAAO,CAAC,EAAE,MAAM;IAKlD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CA8BrD"}

package/dist/adapters/agents/claude-code-cli.js

@@ -0,0 +1,49 @@
+// ─── ClaudeCodeCLIAdapter ───
+//
+// IAdapter implementation that spawns the `claude` CLI process.
+// The task prompt is passed via stdin and the --print flag is used
+// for non-interactive (print-mode) execution.
+//
+// Verified flags (claude CLI, 2026-03):
+//   -p / --print  — non-interactive print mode; prints response and exits.
+//                   Workspace trust dialog is skipped in this mode.
+//                   Prompt can be supplied as a positional argument or via stdin.
+//   --dangerously-skip-permissions — bypasses all permission checks (use in sandboxes only)
+// If the CLI signature changes, update the spawnArgs array below.
+import { spawnWithTimeout, spawnResultToAgentResult } from "../spawn-helper.js";
+export class ClaudeCodeCLIAdapter {
+    adapterType = "claude_code_cli";
+    capabilities = ["execute_code", "read_files", "write_files", "run_commands"];
+    /**
+     * The executable name / path for the claude CLI.
+     * Override in tests to point at a different binary (e.g. "echo").
+     */
+    cliPath;
+    workDir;
+    constructor(cliPath = "claude", workDir) {
+        this.cliPath = cliPath;
+        this.workDir = workDir;
+    }
+    async execute(task) {
+        const startedAt = Date.now();
+        // --print (-p): verified non-interactive flag; prints response and exits.
+        // Prompt is written to stdin; the CLI reads it when running in pipe mode.
+        const spawnArgs = ["--print"];
+        // Pass allowed_tools via --allowedTools flag if specified.
+        // This preserves prompt cache integrity by ensuring tool list is immutable
+        // per session (toolset immutability constraint).
+        if (task.allowed_tools && task.allowed_tools.length > 0) {
+            spawnArgs.push("--allowedTools", task.allowed_tools.join(","));
+        }
+        // Per-task cwd override (from workspace_path: constraint) takes priority over constructor workDir.
+        const cwd = task.cwd ?? this.workDir;
+        const result = await spawnWithTimeout(this.cliPath, spawnArgs, { cwd, stdinData: task.system_prompt ? `[System Context]
+${task.system_prompt}
+
+[User Request]
+${task.prompt}` : task.prompt }, task.timeout_ms);
+        const elapsed = Date.now() - startedAt;
+        return spawnResultToAgentResult(result, elapsed, task.timeout_ms);
+    }
+}
+//# sourceMappingURL=claude-code-cli.js.map

package/dist/adapters/agents/claude-code-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-cli.js","sourceRoot":"","sources":["../../../src/adapters/agents/claude-code-cli.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,gEAAgE;AAChE,mEAAmE;AACnE,8CAA8C;AAC9C,EAAE;AACF,wCAAwC;AACxC,2EAA2E;AAC3E,oEAAoE;AACpE,kFAAkF;AAClF,4FAA4F;AAC5F,kEAAkE;AAGlE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,MAAM,OAAO,oBAAoB;IACtB,WAAW,GAAG,iBAAiB,CAAC;IAChC,YAAY,GAAG,CAAC,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,CAAU,CAAC;IAE/F;;;OAGG;IACc,OAAO,CAAS;IAChB,OAAO,CAAqB;IAE7C,YAAY,UAAkB,QAAQ,EAAE,OAAgB;QACtD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,SAAS,GAAa,CAAC,SAAS,CAAC,CAAC;QAExC,2DAA2D;QAC3D,2EAA2E;QAC3E,iDAAiD;QACjD,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,SAAS,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,mGAAmG;QACnG,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,IAAI,CAAC,OAAO,EACZ,SAAS,EACT,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;EAC3C,IAAI,CAAC,aAAa;;;EAGlB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EACzB,IAAI,CAAC,UAAU,CAChB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACvC,OAAO,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/adapters/agents/openai-codex.d.ts

@@ -0,0 +1,28 @@
+import type { IAdapter, AgentTask, AgentResult } from "../../orchestrator/execution/adapter-layer.js";
+import type { Logger } from "../../runtime/logger.js";
+export interface OpenAICodexCLIAdapterConfig {
+    /** The executable name / path for the codex CLI. Default: "codex" */
+    cliPath?: string;
+    /**
+     * Sandbox policy passed via -s flag. Default: "danger-full-access" for
+     * non-interactive execution. Use "workspace-write" for a safer sandbox.
+     * Set to null to omit the flag entirely.
+     */
+    sandboxPolicy?: string | null;
+    /** If set, pass -m <model> to the CLI. */
+    model?: string;
+    /** Repository path passed to Codex for workspace-aware execution. Default: "." */
+    repoPath?: string;
+}
+export declare class OpenAICodexCLIAdapter implements IAdapter {
+    readonly adapterType = "openai_codex_cli";
+    readonly capabilities: readonly ["execute_code", "read_files", "write_files", "run_commands"];
+    private readonly cliPath;
+    private readonly sandboxPolicy;
+    private readonly model;
+    private readonly repoPath;
+    private readonly logger?;
+    constructor(config?: OpenAICodexCLIAdapterConfig, logger?: Logger);
+    execute(task: AgentTask): Promise<AgentResult>;
+}
+//# sourceMappingURL=openai-codex.d.ts.map

package/dist/adapters/agents/openai-codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-codex.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/openai-codex.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AACtG,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAGtD,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAsB,YAAW,QAAQ;IACpD,QAAQ,CAAC,WAAW,sBAAsB;IAC1C,QAAQ,CAAC,YAAY,yEAA0E;IAE/F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,MAAM,GAAE,2BAAgC,EAAE,MAAM,CAAC,EAAE,MAAM;IAS/D,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CA2CrD"}