conatus 0.1.0

package/dist/adapters/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 "../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/a2a-client.js.map

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

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

@@ -0,0 +1,19 @@
+import type { IAdapter, AgentTask, AgentResult } from "../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/browser-use-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-use-cli.d.ts","sourceRoot":"","sources":["../../src/adapters/browser-use-cli.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEtF,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;CAkGrD"}

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

@@ -0,0 +1,112 @@
+// ─── 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 { spawn } from "node:child_process";
+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();
+        return new Promise((resolve) => {
+            // 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 child = spawn(this.cliPath, spawnArgs, {
+                stdio: ["pipe", "pipe", "pipe"],
+                env: process.env,
+            });
+            let stdout = "";
+            let stderr = "";
+            let timedOut = false;
+            // Guard against double-resolve: Node.js emits both `error` and `close`
+            // on spawn failure (ENOENT). Only the first settle call takes effect.
+            let settled = false;
+            const settle = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeoutHandle);
+                resolve(result);
+            };
+            // Timeout: send SIGTERM, then record timeout result.
+            const timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+            }, task.timeout_ms);
+            // Suppress EPIPE errors on stdin: the spawned process may exit and close
+            // its stdin pipe before we finish writing (race condition in tests).
+            child.stdin.on("error", (err) => {
+                if (err.code !== "EPIPE")
+                    throw err;
+                // EPIPE = process already closed stdin; safe to ignore
+            });
+            // Write the prompt to stdin and close it so the CLI knows input is done.
+            child.stdin.write(task.prompt, "utf8");
+            child.stdin.end();
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk.toString("utf8");
+            });
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk.toString("utf8");
+            });
+            child.on("error", (err) => {
+                settle({
+                    success: false,
+                    output: stdout,
+                    error: err.message,
+                    exit_code: null,
+                    elapsed_ms: Date.now() - startedAt,
+                    stopped_reason: "error",
+                });
+            });
+            child.on("close", (code) => {
+                const elapsed = Date.now() - startedAt;
+                if (timedOut) {
+                    settle({
+                        success: false,
+                        output: stdout,
+                        error: `Timed out after ${task.timeout_ms}ms`,
+                        exit_code: code,
+                        elapsed_ms: elapsed,
+                        stopped_reason: "timeout",
+                    });
+                    return;
+                }
+                const success = code === 0;
+                settle({
+                    success,
+                    output: stdout,
+                    error: success ? null : stderr || `Process exited with code ${code}`,
+                    exit_code: code,
+                    elapsed_ms: elapsed,
+                    stopped_reason: success ? "completed" : "error",
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=browser-use-cli.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { IAdapter, AgentTask, AgentResult } from "../execution/adapter-layer.js";
+import type { ILLMClient } from "../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/claude-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-api.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-api.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,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;CAqDrD"}

package/dist/adapters/claude-api.js

@@ -0,0 +1,63 @@
+// ─── 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 response = await this.llmClient.sendMessage([
+                    { role: "user", content: task.prompt },
+                ]);
+                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/claude-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-api.js","sourceRoot":"","sources":["../../src/adapters/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,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;oBAChD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;iBACvC,CAAC,CAAC;gBACH,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/claude-code-cli.d.ts

@@ -0,0 +1,14 @@
+import type { IAdapter, AgentTask, AgentResult } from "../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/claude-code-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-cli.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-code-cli.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEtF,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;CAkFrD"}

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

@@ -0,0 +1,99 @@
+// ─── 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 { spawn } from "node:child_process";
+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();
+        return new Promise((resolve) => {
+            // --print (-p): verified non-interactive flag; prints response and exits.
+            // Prompt is written to stdin below; the CLI reads it when running in pipe mode.
+            const spawnArgs = ["--print"];
+            const child = spawn(this.cliPath, spawnArgs, {
+                stdio: ["pipe", "pipe", "pipe"],
+                ...(this.workDir ? { cwd: this.workDir } : {}),
+            });
+            let stdout = "";
+            let stderr = "";
+            let timedOut = false;
+            // Timeout: send SIGTERM, then record timeout result.
+            const timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+            }, task.timeout_ms);
+            // Suppress EPIPE errors on stdin: the spawned process may exit and close
+            // its stdin pipe before we finish writing (race condition in tests).
+            child.stdin.on("error", (err) => {
+                if (err.code !== "EPIPE")
+                    throw err;
+                // EPIPE = process already closed stdin; safe to ignore
+            });
+            // Write the prompt to stdin and close it so the CLI knows input is done.
+            child.stdin.write(task.prompt, "utf8");
+            child.stdin.end();
+            child.stdout.on("data", (chunk) => {
+                stdout += chunk.toString("utf8");
+            });
+            child.stderr.on("data", (chunk) => {
+                stderr += chunk.toString("utf8");
+            });
+            child.on("error", (err) => {
+                clearTimeout(timeoutHandle);
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: err.message,
+                    exit_code: null,
+                    elapsed_ms: Date.now() - startedAt,
+                    stopped_reason: "error",
+                });
+            });
+            child.on("close", (code) => {
+                clearTimeout(timeoutHandle);
+                const elapsed = Date.now() - startedAt;
+                if (timedOut) {
+                    resolve({
+                        success: false,
+                        output: stdout,
+                        error: `Timed out after ${task.timeout_ms}ms`,
+                        exit_code: code,
+                        elapsed_ms: elapsed,
+                        stopped_reason: "timeout",
+                    });
+                    return;
+                }
+                const success = code === 0;
+                resolve({
+                    success,
+                    output: stdout,
+                    error: success ? null : stderr || `Process exited with code ${code}`,
+                    exit_code: code,
+                    elapsed_ms: elapsed,
+                    stopped_reason: success ? "completed" : "error",
+                });
+            });
+        });
+    }
+}
+//# sourceMappingURL=claude-code-cli.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-cli.js","sourceRoot":"","sources":["../../src/adapters/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;AAElE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,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,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,EAAE;YAC1C,0EAA0E;YAC1E,gFAAgF;YAChF,MAAM,SAAS,GAAa,CAAC,SAAS,CAAC,CAAC;YAExC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE;gBAC3C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC/B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/C,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,qDAAqD;YACrD,MAAM,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpC,QAAQ,GAAG,IAAI,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAEpB,yEAAyE;YACzE,qEAAqE;YACrE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;gBACrD,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;oBAAE,MAAM,GAAG,CAAC;gBACpC,uDAAuD;YACzD,CAAC,CAAC,CAAC;YAEH,yEAAyE;YACzE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAElB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACxC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;gBAC/B,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,OAAO,CAAC;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,MAAM;oBACd,KAAK,EAAE,GAAG,CAAC,OAAO;oBAClB,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,OAAO;iBACxB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAmB,EAAE,EAAE;gBACxC,YAAY,CAAC,aAAa,CAAC,CAAC;gBAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAEvC,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC;wBACN,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,MAAM;wBACd,KAAK,EAAE,mBAAmB,IAAI,CAAC,UAAU,IAAI;wBAC7C,SAAS,EAAE,IAAI;wBACf,UAAU,EAAE,OAAO;wBACnB,cAAc,EAAE,SAAS;qBAC1B,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC;gBAC3B,OAAO,CAAC;oBACN,OAAO;oBACP,MAAM,EAAE,MAAM;oBACd,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,4BAA4B,IAAI,EAAE;oBACpE,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO;iBAChD,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapters/file-existence-datasource.d.ts

@@ -0,0 +1,16 @@
+import type { IDataSourceAdapter } from "../observation/data-source-adapter.js";
+import type { DataSourceType, DataSourceConfig, DataSourceQuery, DataSourceResult } from "../types/data-source.js";
+export declare class FileExistenceDataSourceAdapter implements IDataSourceAdapter {
+    readonly sourceType: DataSourceType;
+    readonly config: DataSourceConfig;
+    private readonly baseDir;
+    private readonly dimensionMap;
+    constructor(config: DataSourceConfig);
+    get sourceId(): string;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+    getSupportedDimensions(): string[];
+    query(params: DataSourceQuery): Promise<DataSourceResult>;
+}
+//# sourceMappingURL=file-existence-datasource.d.ts.map

package/dist/adapters/file-existence-datasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-existence-datasource.d.ts","sourceRoot":"","sources":["../../src/adapters/file-existence-datasource.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAEjC,qBAAa,8BAA+B,YAAW,kBAAkB;IACvE,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAoB;IACvD,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAE1C,MAAM,EAAE,gBAAgB;IAMpC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC,sBAAsB,IAAI,MAAM,EAAE;IAI5B,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA4BhE"}

package/dist/adapters/file-existence-datasource.js

@@ -0,0 +1,71 @@
+// ─── FileExistenceDataSourceAdapter ───
+//
+// IDataSourceAdapter implementation that checks if files exist in a directory.
+//
+// Supported dimension values:
+//   Any key defined in config.dimension_mapping — maps to a filename relative to baseDir.
+//   Returns 1 if the file exists, 0 if it does not.
+//   Returns null for unknown dimensions (not in dimension_mapping).
+//
+// Config fields used from DataSourceConfig:
+//   connection.path       — base directory to resolve filenames against (defaults to cwd)
+//   dimension_mapping     — map of dimension_name → filename (relative to baseDir)
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+export class FileExistenceDataSourceAdapter {
+    sourceType = "file_existence";
+    config;
+    baseDir;
+    dimensionMap;
+    constructor(config) {
+        this.config = config;
+        this.baseDir = config.connection.path ?? process.cwd();
+        this.dimensionMap = config.dimension_mapping ?? {};
+    }
+    get sourceId() {
+        return this.config.id;
+    }
+    async connect() {
+        // no-op: no persistent connection required
+    }
+    async disconnect() {
+        // no-op
+    }
+    async healthCheck() {
+        return true;
+    }
+    getSupportedDimensions() {
+        return Object.keys(this.dimensionMap);
+    }
+    async query(params) {
+        // ObservationEngine may pass `expression` = the mapped value (e.g. "README.md")
+        // from config.dimension_mapping. In that case, use it directly as the filename.
+        // Otherwise, look up the dimension_name in our local map.
+        const filename = params.expression ?? this.dimensionMap[params.dimension_name];
+        if (filename === undefined) {
+            // Unknown dimension — return null so caller can handle gracefully
+            return {
+                value: null,
+                raw: {},
+                timestamp: new Date().toISOString(),
+                source_id: this.sourceId,
+            };
+        }
+        const fullPath = path.join(this.baseDir, filename);
+        let exists = true;
+        try {
+            await fsp.access(fullPath);
+        }
+        catch {
+            exists = false;
+        }
+        // For "present" threshold: 1 = exists, 0 = missing
+        return {
+            value: exists ? 1 : 0,
+            raw: { path: fullPath, exists },
+            timestamp: new Date().toISOString(),
+            source_id: this.sourceId,
+        };
+    }
+}
+//# sourceMappingURL=file-existence-datasource.js.map

package/dist/adapters/file-existence-datasource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-existence-datasource.js","sourceRoot":"","sources":["../../src/adapters/file-existence-datasource.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,+EAA+E;AAC/E,EAAE;AACF,8BAA8B;AAC9B,0FAA0F;AAC1F,oDAAoD;AACpD,oEAAoE;AACpE,EAAE;AACF,4CAA4C;AAC5C,0FAA0F;AAC1F,mFAAmF;AAEnF,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AASlC,MAAM,OAAO,8BAA8B;IAChC,UAAU,GAAmB,gBAAgB,CAAC;IAC9C,MAAM,CAAmB;IAEjB,OAAO,CAAS;IAChB,YAAY,CAAyB;IAEtD,YAAY,MAAwB;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACvD,IAAI,CAAC,YAAY,GAAI,MAAM,CAAC,iBAA4C,IAAI,EAAE,CAAC;IACjF,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,2CAA2C;IAC7C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,QAAQ;IACV,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sBAAsB;QACpB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAuB;QACjC,gFAAgF;QAChF,gFAAgF;QAChF,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAE/E,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,kEAAkE;YAClE,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,GAAG,EAAE,EAAE;gBACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,IAAI,CAAC,QAAQ;aACzB,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC;YAAC,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,MAAM,GAAG,KAAK,CAAC;QAAC,CAAC;QAE7D,mDAAmD;QACnD,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE;YAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,CAAC,QAAQ;SACzB,CAAC;IACJ,CAAC;CACF"}