contextos-mcp 0.4.0

package/dist/agents/claude-code.js

@@ -0,0 +1,236 @@
+/**
+ * Claude Code agent backend.
+ *
+ * Runs tasks via `claude -p --output-format json "prompt"` subprocess.
+ * Parses structured JSON output for results, cost, and file changes.
+ */
+import * as os from "node:os";
+import { commandExists } from "../utils/command-exists.js";
+import { RollingBuffer } from "../utils/rolling-buffer.js";
+import { safeSpawn } from "../utils/safe-spawn.js";
+import { registerAgent } from "./provider.js";
+/** Extract JSON result from output (may contain non-JSON lines from debug/stderr bleed). */
+function extractJson(raw) {
+    // Try direct parse first
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        /* mixed output */
+    }
+    // Try last line (claude outputs JSON as final line)
+    const lines = raw.trim().split("\n");
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i].trim();
+        if (line.startsWith("{")) {
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed.type === "result")
+                    return parsed;
+            }
+            catch { }
+        }
+    }
+    // Fallback: find first { to last }
+    const firstBrace = raw.indexOf("{");
+    const lastBrace = raw.lastIndexOf("}");
+    if (firstBrace !== -1 && lastBrace > firstBrace) {
+        try {
+            return JSON.parse(raw.slice(firstBrace, lastBrace + 1));
+        }
+        catch {
+            /* give up */
+        }
+    }
+    return null;
+}
+/** Whitelist of env vars safe to pass to agent subprocess. */
+function buildAgentEnv() {
+    const homeDir = os.homedir();
+    return {
+        PATH: process.env.PATH,
+        HOME: homeDir,
+        USERPROFILE: homeDir,
+        SHELL: process.env.SHELL,
+        TERM: process.env.TERM,
+        LANG: process.env.LANG,
+        // Claude Code uses ANTHROPIC_API_KEY
+        ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,
+        // Git config
+        GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME,
+        GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL,
+        GIT_COMMITTER_NAME: process.env.GIT_COMMITTER_NAME,
+        GIT_COMMITTER_EMAIL: process.env.GIT_COMMITTER_EMAIL,
+        // XDG dirs (claude may use for config)
+        XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
+        XDG_DATA_HOME: process.env.XDG_DATA_HOME,
+        // Windows
+        ...(process.env.SystemRoot ? { SystemRoot: process.env.SystemRoot } : {}),
+        ...(process.env.SYSTEMROOT ? { SYSTEMROOT: process.env.SYSTEMROOT } : {}),
+    };
+}
+/** Map provider/model format to claude model flag. */
+function resolveModel(model) {
+    // Strip provider prefix if present (e.g., "anthropic/claude-sonnet-4-6" → "claude-sonnet-4-6")
+    const modelName = model.includes("/") ? model.split("/").pop() : model;
+    // Claude Code accepts short aliases
+    const aliases = {
+        "claude-sonnet-4-6": "sonnet",
+        "claude-opus-4-6": "opus",
+        "claude-haiku-4-5": "haiku",
+    };
+    return aliases[modelName] || modelName;
+}
+const claudeCodeProvider = {
+    name: "claude-code",
+    async isAvailable() {
+        return commandExists("claude");
+    },
+    async run(options) {
+        const { task, workDir, model, files, signal } = options;
+        const startTime = Date.now();
+        // SECURITY NOTICE & TRUST BOUNDARY:
+        // --dangerously-skip-permissions is REQUIRED for non-interactive/headless Claude Code execution.
+        // Trust model & isolation boundaries:
+        //   1. Git Worktree Isolation: Agent runs in a dedicated git worktree branch, preventing concurrent
+        //      edits or corruption in the user's primary working directory.
+        //   2. Pre-Commit Filtering: Changed files are filtered before commit (isBlockedPath, isPathAllowed).
+        //   3. Environment Sanitization: Child process environment is stripped of sensitive tokens via buildAgentEnv.
+        //   4. OS Sandbox Notice: The child process runs with host OS user privileges and is NOT sandboxed
+        //      at the kernel/syscall level. For untrusted code execution or multi-tenant hosting, ContextOS
+        //      must be wrapped in an OS-level container (Docker, Podman) or OS sandbox (e.g. bubblewrap).
+        const args = ["-p", "--output-format", "json", "--dangerously-skip-permissions", "--no-session-persistence"];
+        if (model) {
+            args.push("--model", resolveModel(model));
+        }
+        // Build the prompt — include file hints if provided
+        let prompt = task;
+        if (files && files.length > 0) {
+            prompt += `\n\nRelevant files to focus on:\n${files.map((f) => `- ${f}`).join("\n")}`;
+        }
+        args.push(prompt);
+        let proc;
+        try {
+            proc = await safeSpawn("claude", args, {
+                cwd: workDir,
+                stdio: ["ignore", "pipe", "pipe"],
+                env: buildAgentEnv(),
+            });
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: "",
+                filesChanged: [],
+                diff: "",
+                error: `Failed to spawn claude: ${err instanceof Error ? err.message : String(err)}`,
+                durationMs: 0,
+            };
+        }
+        return new Promise((resolve) => {
+            const stdoutBuf = new RollingBuffer(2 * 1024 * 1024); // 2MB
+            const stderrBuf = new RollingBuffer(512 * 1024); // 512KB
+            let resolved = false;
+            const doResolve = (result) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                resolve(result);
+            };
+            proc.stdout?.on("data", (chunk) => {
+                const text = chunk.toString();
+                stdoutBuf.append(text);
+                options.onOutput?.(text);
+            });
+            proc.stderr?.on("data", (chunk) => {
+                stderrBuf.append(chunk.toString());
+            });
+            if (signal) {
+                const onAbort = () => {
+                    proc.kill("SIGTERM");
+                    const killTimer = setTimeout(() => {
+                        try {
+                            if (proc.exitCode === null)
+                                proc.kill("SIGKILL");
+                        }
+                        catch {
+                            /* already dead */
+                        }
+                    }, 3000);
+                    proc.on("exit", () => clearTimeout(killTimer));
+                };
+                if (signal.aborted) {
+                    onAbort();
+                }
+                else {
+                    signal.addEventListener("abort", onAbort, { once: true });
+                    proc.on("exit", () => signal.removeEventListener("abort", onAbort));
+                }
+            }
+            proc.on("close", (code) => {
+                const stdout = stdoutBuf.toString();
+                const stderr = stderrBuf.toString();
+                const durationMs = Date.now() - startTime;
+                const parsed = extractJson(stdout);
+                if (parsed) {
+                    // Extract token usage from Claude Code's structured output
+                    let usage;
+                    if (parsed.usage) {
+                        const inputTokens = parsed.usage.input_tokens ?? 0;
+                        const outputTokens = parsed.usage.output_tokens ?? 0;
+                        if (inputTokens > 0 || outputTokens > 0) {
+                            usage = {
+                                inputTokens,
+                                outputTokens,
+                                totalTokens: inputTokens + outputTokens,
+                            };
+                        }
+                    }
+                    if (parsed.is_error) {
+                        doResolve({
+                            success: false,
+                            output: parsed.result || stderr,
+                            filesChanged: [],
+                            diff: "",
+                            durationMs: parsed.duration_ms || durationMs,
+                            error: parsed.result || `Claude Code error: ${parsed.subtype}`,
+                            usage,
+                        });
+                        return;
+                    }
+                    doResolve({
+                        success: true,
+                        output: parsed.result || "",
+                        filesChanged: [], // Diff is captured separately by worktree manager
+                        diff: "",
+                        durationMs: parsed.duration_ms || durationMs,
+                        usage,
+                    });
+                    return;
+                }
+                // Fallback: no JSON parsed — use raw output
+                doResolve({
+                    success: code === 0,
+                    output: stdout || stderr,
+                    filesChanged: [],
+                    diff: "",
+                    durationMs,
+                    error: code !== 0 ? `claude exited with code ${code}${stderr ? `: ${stderr.slice(0, 500)}` : ""}` : undefined,
+                });
+            });
+            proc.on("error", (err) => {
+                doResolve({
+                    success: false,
+                    output: "",
+                    filesChanged: [],
+                    diff: "",
+                    durationMs: Date.now() - startTime,
+                    error: `Failed to spawn claude: ${err.message}`,
+                });
+            });
+        });
+    },
+};
+registerAgent(claudeCodeProvider);
+export default claudeCodeProvider;
+//# sourceMappingURL=claude-code.js.map

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

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

package/dist/agents/codex.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Codex CLI agent backend (OpenAI).
+ *
+ * Runs tasks via `codex exec --json --full-auto "prompt"` subprocess.
+ * Codex CLI is OpenAI's open-source coding agent.
+ *
+ * Output format: JSONL events streamed to stdout, with event types:
+ *   - thread.started, turn.started, turn.completed, turn.failed
+ *   - item.started, item.updated, item.completed
+ * Item types: assistant_message, command_execution, file_change, etc.
+ */
+import type { AgentProvider } from "../core/types.js";
+declare const codexProvider: AgentProvider;
+export default codexProvider;

package/dist/agents/codex.js

@@ -0,0 +1,203 @@
+/**
+ * Codex CLI agent backend (OpenAI).
+ *
+ * Runs tasks via `codex exec --json --full-auto "prompt"` subprocess.
+ * Codex CLI is OpenAI's open-source coding agent.
+ *
+ * Output format: JSONL events streamed to stdout, with event types:
+ *   - thread.started, turn.started, turn.completed, turn.failed
+ *   - item.started, item.updated, item.completed
+ * Item types: assistant_message, command_execution, file_change, etc.
+ */
+import * as os from "node:os";
+import { commandExists } from "../utils/command-exists.js";
+import { RollingBuffer } from "../utils/rolling-buffer.js";
+import { safeSpawn } from "../utils/safe-spawn.js";
+import { registerAgent } from "./provider.js";
+/** Whitelist of env vars safe to pass to agent subprocess. */
+function buildAgentEnv() {
+    const homeDir = os.homedir();
+    return {
+        PATH: process.env.PATH,
+        HOME: homeDir,
+        USERPROFILE: homeDir,
+        SHELL: process.env.SHELL,
+        TERM: process.env.TERM,
+        LANG: process.env.LANG,
+        // Codex uses CODEX_API_KEY or OPENAI_API_KEY
+        CODEX_API_KEY: process.env.CODEX_API_KEY || process.env.OPENAI_API_KEY,
+        OPENAI_API_KEY: process.env.OPENAI_API_KEY,
+        OPENAI_BASE_URL: process.env.OPENAI_BASE_URL,
+        // Codex config home
+        CODEX_HOME: process.env.CODEX_HOME,
+        // Git config
+        GIT_AUTHOR_NAME: process.env.GIT_AUTHOR_NAME,
+        GIT_AUTHOR_EMAIL: process.env.GIT_AUTHOR_EMAIL,
+        GIT_COMMITTER_NAME: process.env.GIT_COMMITTER_NAME,
+        GIT_COMMITTER_EMAIL: process.env.GIT_COMMITTER_EMAIL,
+        // Windows
+        ...(process.env.SystemRoot ? { SystemRoot: process.env.SystemRoot } : {}),
+        ...(process.env.SYSTEMROOT ? { SYSTEMROOT: process.env.SYSTEMROOT } : {}),
+    };
+}
+/** Map provider/model format to codex model flag. */
+function resolveModel(model) {
+    // Strip provider prefix (e.g., "openai/o3" → "o3")
+    return model.includes("/") ? model.split("/").pop() : model;
+}
+/** Parse JSONL output to extract result, file changes, and token usage. */
+function parseCodexJsonl(stdout) {
+    const lines = stdout.trim().split("\n").filter(Boolean);
+    let output = "";
+    const filesChanged = [];
+    let success = true;
+    let error;
+    let totalInput = 0;
+    let totalOutput = 0;
+    for (const line of lines) {
+        try {
+            const event = JSON.parse(line);
+            if (event.type === "turn.failed") {
+                success = false;
+                error = event.error || "Turn failed";
+            }
+            if (event.type === "item.completed") {
+                if (event.item_type === "assistant_message") {
+                    // Capture assistant messages
+                    const content = event.message?.content || event.content || "";
+                    if (content)
+                        output += (output ? "\n" : "") + content;
+                }
+                if (event.item_type === "file_change" && event.file_path) {
+                    filesChanged.push(event.file_path);
+                }
+            }
+            // Accumulate token usage from events
+            if (event.usage) {
+                totalInput += event.usage.input_tokens ?? 0;
+                totalOutput += event.usage.output_tokens ?? 0;
+            }
+        }
+        catch {
+            // Non-JSON line — ignore
+        }
+    }
+    let usage;
+    if (totalInput > 0 || totalOutput > 0) {
+        usage = {
+            inputTokens: totalInput,
+            outputTokens: totalOutput,
+            totalTokens: totalInput + totalOutput,
+        };
+    }
+    return { output, filesChanged: [...new Set(filesChanged)], success, error, usage };
+}
+const codexProvider = {
+    name: "codex",
+    async isAvailable() {
+        return commandExists("codex");
+    },
+    async run(options) {
+        const { task, workDir, model, files, signal } = options;
+        const startTime = Date.now();
+        const args = ["exec", "--json", "--full-auto", "--ephemeral", "--skip-git-repo-check", "--cd", workDir];
+        if (model) {
+            args.push("--model", resolveModel(model));
+        }
+        // Build the prompt — include file hints if provided
+        let prompt = task;
+        if (files && files.length > 0) {
+            prompt += `\n\nRelevant files to focus on:\n${files.map((f) => `- ${f}`).join("\n")}`;
+        }
+        args.push(prompt);
+        let proc;
+        try {
+            proc = await safeSpawn("codex", args, {
+                cwd: workDir,
+                stdio: ["ignore", "pipe", "pipe"],
+                env: buildAgentEnv(),
+            });
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: "",
+                filesChanged: [],
+                diff: "",
+                error: `Failed to spawn codex: ${err instanceof Error ? err.message : String(err)}`,
+                durationMs: 0,
+            };
+        }
+        return new Promise((resolve) => {
+            const stdoutBuf = new RollingBuffer(2 * 1024 * 1024); // 2MB
+            const stderrBuf = new RollingBuffer(512 * 1024); // 512KB
+            let resolved = false;
+            const doResolve = (result) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                resolve(result);
+            };
+            proc.stdout?.on("data", (chunk) => {
+                const text = chunk.toString();
+                stdoutBuf.append(text);
+                options.onOutput?.(text);
+            });
+            proc.stderr?.on("data", (chunk) => {
+                stderrBuf.append(chunk.toString());
+            });
+            if (signal) {
+                const onAbort = () => {
+                    proc.kill("SIGTERM");
+                    const killTimer = setTimeout(() => {
+                        try {
+                            if (proc.exitCode === null)
+                                proc.kill("SIGKILL");
+                        }
+                        catch {
+                            /* already dead */
+                        }
+                    }, 3000);
+                    proc.on("exit", () => clearTimeout(killTimer));
+                };
+                if (signal.aborted) {
+                    onAbort();
+                }
+                else {
+                    signal.addEventListener("abort", onAbort, { once: true });
+                    proc.on("exit", () => signal.removeEventListener("abort", onAbort));
+                }
+            }
+            proc.on("close", (code) => {
+                const stdout = stdoutBuf.toString();
+                const stderr = stderrBuf.toString();
+                const durationMs = Date.now() - startTime;
+                // Parse JSONL events
+                const parsed = parseCodexJsonl(stdout);
+                doResolve({
+                    success: code === 0 && parsed.success,
+                    output: parsed.output || stdout || stderr,
+                    filesChanged: parsed.filesChanged,
+                    diff: "", // Diff is captured separately by worktree manager
+                    durationMs,
+                    error: parsed.error ||
+                        (code !== 0 ? `codex exited with code ${code}${stderr ? `: ${stderr.slice(0, 500)}` : ""}` : undefined),
+                    usage: parsed.usage,
+                });
+            });
+            proc.on("error", (err) => {
+                doResolve({
+                    success: false,
+                    output: "",
+                    filesChanged: [],
+                    diff: "",
+                    durationMs: Date.now() - startTime,
+                    error: `Failed to spawn codex: ${err.message}`,
+                });
+            });
+        });
+    },
+};
+registerAgent(codexProvider);
+export default codexProvider;
+//# sourceMappingURL=codex.js.map

package/dist/agents/codex.js.map

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

package/dist/agents/direct-llm.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ContextOS Direct LLM agent backend.
+ *
+ * Enhanced version of the original direct-llm provider.
+ * Key improvements:
+ *   1. Accepts a ContextOS system prompt (project rules/standards)
+ *   2. Parses code blocks from LLM responses and writes them to the worktree
+ *   3. Builds a coding-oriented prompt that instructs the LLM to produce file edits
+ *   4. Reports files changed based on parsed code blocks
+ *
+ * Uses @mariozechner/pi-ai for unified access to OpenAI, Anthropic, and Gemini.
+ */
+import type { AgentProvider, AgentRunOptions } from "../core/types.js";
+/**
+ * Extended run options that include ContextOS system prompt.
+ */
+export interface ContextosAgentRunOptions extends AgentRunOptions {
+    /** ContextOS system prompt assembled from .agents/ rules and skills. */
+    contextosPrompt?: string;
+}
+declare const contextosDirectLlm: AgentProvider;
+export default contextosDirectLlm;