@songsid/agend 0.0.1

package/dist/backend/claude-code.js

@@ -0,0 +1,171 @@
+import { join } from "node:path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolveBinary, shellQuote, validateModel } from "./types.js";
+export class ClaudeCodeBackend {
+    instanceDir;
+    binaryName = "claude";
+    instructionsReloadedOnResume = true;
+    binaryPath;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+        this.binaryPath = resolveBinary("claude");
+    }
+    buildCommand(config) {
+        const settingsPath = join(this.instanceDir, "claude-settings.json");
+        const mcpConfigPath = join(this.instanceDir, "mcp-config.json");
+        const envPrefix = ["CMUX_CLAUDE_HOOKS_DISABLED=1", "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1"];
+        if (process.env.ANTHROPIC_BASE_URL)
+            envPrefix.push(`ANTHROPIC_BASE_URL=${shellQuote(process.env.ANTHROPIC_BASE_URL)}`);
+        if (process.env.ANTHROPIC_API_KEY && !this.hasOAuthSession()) {
+            envPrefix.push(`ANTHROPIC_API_KEY=${shellQuote(process.env.ANTHROPIC_API_KEY)}`);
+        }
+        let cmd = `${envPrefix.join(" ")} ${this.binaryPath} --settings ${settingsPath} --mcp-config ${mcpConfigPath}`;
+        if (config.skipPermissions !== false)
+            cmd += " --dangerously-skip-permissions";
+        const sessionIdFile = join(this.instanceDir, "session-id");
+        if (!config.skipResume && existsSync(sessionIdFile)) {
+            const sid = readFileSync(sessionIdFile, "utf-8").trim();
+            if (sid && /^[a-zA-Z0-9_-]+$/.test(sid))
+                cmd += ` --resume ${sid}`;
+        }
+        if (config.model) {
+            cmd += ` --model ${validateModel(config.model)}`;
+        }
+        // Additive system prompt: append fleet instructions without overriding Claude's built-in prompt
+        const instrFile = join(this.instanceDir, "fleet-instructions.md");
+        if (existsSync(instrFile)) {
+            cmd += ` --append-system-prompt-file ${instrFile}`;
+        }
+        return cmd;
+    }
+    writeConfig(config) {
+        // 1. Write mcp-config.json to instance dir (loaded via --mcp-config)
+        const mcpConfigPath = join(this.instanceDir, "mcp-config.json");
+        const mcpConfig = { mcpServers: config.mcpServers };
+        writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2));
+        // 2. Write statusline script
+        const statusLineCommand = this.writeStatusLineScript();
+        // 3. Write claude-settings.json (permissions handled by --dangerously-skip-permissions)
+        const settings = {
+            statusLine: {
+                type: "command",
+                command: statusLineCommand,
+            },
+        };
+        writeFileSync(join(this.instanceDir, "claude-settings.json"), JSON.stringify(settings));
+        // 4. Pre-approve API key to skip interactive prompt on startup
+        this.preApproveApiKey(config);
+        // 5. Write fleet instructions file (loaded via --append-system-prompt-file)
+        if (config.instructions) {
+            try {
+                writeFileSync(join(this.instanceDir, "fleet-instructions.md"), config.instructions);
+            }
+            catch { /* best effort */ }
+        }
+    }
+    getReadyPattern() {
+        return /❯|ok\s*$/m;
+    }
+    getContextUsage() {
+        try {
+            const sf = join(this.instanceDir, "statusline.json");
+            const data = JSON.parse(readFileSync(sf, "utf-8"));
+            return data.context_window?.used_percentage ?? null;
+        }
+        catch (err) {
+            // File may not exist yet during startup — return null to signal unavailable
+            return null;
+        }
+    }
+    getSessionId() {
+        try {
+            const sf = join(this.instanceDir, "statusline.json");
+            const data = JSON.parse(readFileSync(sf, "utf-8"));
+            return data.session_id ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getErrorPatterns() {
+        return [
+            { pattern: /API Error: Rate limit/i, type: "rate_limit", action: "failover", message: "API rate limit reached" },
+            { pattern: /API Error: Authentication/i, type: "auth_error", action: "pause", message: "Authentication error" },
+            { pattern: /API Error: Overloaded/i, type: "rate_limit", action: "notify", message: "API overloaded" },
+            { pattern: /credit balance is too low/i, type: "quota", action: "pause", message: "Insufficient API credits" },
+        ];
+    }
+    getStartupDialogs() {
+        return [
+            // Session resume prompt must be checked BEFORE ready pattern, because ❯ in
+            // "❯ 1. Resume from summary" would falsely match the ready pattern /❯/.
+            { pattern: /Resume from summary \(recommended\)/, keys: ["Enter"], description: "Claude session resume prompt — auto-select 'Resume from summary'" },
+            { pattern: /[❯›]\s*\d+\.\s*No/m, keys: ["Down", "Enter"], description: "Claude 'No, exit' confirmation — navigate to Yes" },
+            { pattern: /I accept|I trust/i, keys: ["Enter"], description: "Claude 'Yes, I accept' trust dialog" },
+            { pattern: /Resume Session/i, keys: ["Escape"], description: "Claude resume session picker — start fresh" },
+        ];
+    }
+    getRuntimeDialogs() {
+        return [
+            {
+                // Claude Code shows a session resume prompt when session is old/large.
+                // Default cursor is on "1. Resume from summary (recommended)" — press Enter.
+                pattern: /Resume from summary \(recommended\)/,
+                keys: ["Enter"],
+                description: "Claude session resume prompt — auto-select 'Resume from summary'",
+            },
+        ];
+    }
+    getQuitCommand() { return "/exit"; }
+    cleanup(_config) {
+        // mcp-config.json is in instance dir, cleaned up when instance is deleted
+    }
+    /** Pre-approve ANTHROPIC_API_KEY in ~/.claude.json to skip the interactive prompt */
+    preApproveApiKey(_config) {
+        const apiKey = process.env.ANTHROPIC_API_KEY;
+        if (!apiKey)
+            return;
+        const fingerprint = apiKey.length > 20 ? apiKey.slice(-20) : apiKey;
+        const claudeJsonPath = join(homedir(), ".claude.json");
+        let claudeCfg = {};
+        try {
+            claudeCfg = JSON.parse(readFileSync(claudeJsonPath, "utf-8"));
+        }
+        catch { /* new file or parse error */ }
+        const existing = claudeCfg.customApiKeyResponses;
+        const approved = existing?.approved ?? [];
+        if (!approved.includes(fingerprint)) {
+            claudeCfg.customApiKeyResponses = {
+                approved: [...approved, fingerprint],
+                rejected: existing?.rejected ?? [],
+            };
+            writeFileSync(claudeJsonPath, JSON.stringify(claudeCfg, null, 2));
+        }
+    }
+    /** Check if user has an active OAuth session in ~/.claude.json */
+    hasOAuthSession() {
+        try {
+            const cfg = JSON.parse(readFileSync(join(homedir(), ".claude.json"), "utf-8"));
+            return !!cfg.oauthAccount?.accountUuid;
+        }
+        catch {
+            return false;
+        }
+    }
+    writeStatusLineScript() {
+        const statusFile = join(this.instanceDir, "statusline.json");
+        // Use a Node.js script instead of bash to avoid shell injection via statusFile path
+        const script = [
+            "#!/usr/bin/env node",
+            "const fs = require('fs');",
+            "let input = '';",
+            "process.stdin.on('data', d => input += d);",
+            `process.stdin.on('end', () => { fs.writeFileSync(${JSON.stringify(statusFile)}, input); console.log('ok'); });`,
+        ].join("\n");
+        const scriptPath = join(this.instanceDir, "statusline.js");
+        writeFileSync(scriptPath, script, { mode: 0o755 });
+        return scriptPath;
+    }
+}
+//# sourceMappingURL=claude-code.js.map

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

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

package/dist/backend/codex.d.ts

@@ -0,0 +1,18 @@
+import { type CliBackend, type CliBackendConfig, type ErrorPattern, type RuntimeDialog, type StartupDialog } from "./types.js";
+export declare class CodexBackend implements CliBackend {
+    private instanceDir;
+    readonly binaryName = "codex";
+    private binaryPath;
+    constructor(instanceDir: string);
+    buildCommand(config: CliBackendConfig): string;
+    writeConfig(config: CliBackendConfig): void;
+    preTrust(workDir: string): void;
+    getReadyPattern(): RegExp;
+    getErrorPatterns(): ErrorPattern[];
+    getStartupDialogs(): StartupDialog[];
+    getRuntimeDialogs(): RuntimeDialog[];
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    getQuitCommand(): string;
+    cleanup(config: CliBackendConfig): void;
+}

package/dist/backend/codex.js

@@ -0,0 +1,160 @@
+import { execFileSync } from "node:child_process";
+import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { resolveBinary, validateModel } from "./types.js";
+import { appendWithMarker, removeMarker } from "./marker-utils.js";
+const CODEX_PROJECT_DOC_MAX_BYTES = 32_768;
+export class CodexBackend {
+    instanceDir;
+    binaryName = "codex";
+    binaryPath;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+        this.binaryPath = resolveBinary("codex");
+    }
+    buildCommand(config) {
+        const approvalFlag = config.skipPermissions !== false
+            ? "--dangerously-bypass-approvals-and-sandbox"
+            : "--full-auto";
+        // `codex resume --last` resumes the most recent session for the current
+        // working directory. Each AgEnD instance has a unique working_directory,
+        // so sessions are per-instance scoped and won't collide.
+        // If no prior session exists (first launch), Codex falls back to a fresh session.
+        let cmd;
+        if (config.skipResume) {
+            cmd = `${this.binaryPath} ${approvalFlag}`;
+        }
+        else {
+            cmd = `${this.binaryPath} resume --last ${approvalFlag}`;
+        }
+        if (config.model)
+            cmd += ` -c model="${validateModel(config.model)}"`;
+        return cmd;
+    }
+    writeConfig(config) {
+        // Codex stores MCP config globally in ~/.codex/config.toml.
+        // Use execFileSync (no shell) to avoid escaping issues with env values
+        // containing JSON (e.g. AGEND_DECISIONS). Use namespaced key to avoid
+        // conflicts when multiple Codex instances run simultaneously.
+        for (const [name, entry] of Object.entries(config.mcpServers)) {
+            const mcpName = `${name}-${config.instanceName}`;
+            const allEnv = { ...entry.env, AGEND_INSTANCE_NAME: config.instanceName };
+            const args = ["mcp", "add", mcpName];
+            for (const [k, v] of Object.entries(allEnv)) {
+                args.push("--env", `${k}=${v}`);
+            }
+            args.push("--", entry.command, ...entry.args);
+            // Remove existing entry first (codex mcp add fails if name exists)
+            try {
+                execFileSync(this.binaryPath, ["mcp", "remove", mcpName], { stdio: "ignore" });
+            }
+            catch { /* may not exist */ }
+            try {
+                execFileSync(this.binaryPath, args, { stdio: "ignore" });
+            }
+            catch { /* best effort */ }
+        }
+        // Clean up old non-namespaced key if present (one-time migration)
+        try {
+            execFileSync(this.binaryPath, ["mcp", "remove", "agend"], { stdio: "ignore" });
+        }
+        catch { /* may not exist */ }
+        // Write fleet instructions into AGENTS.md (additive via marker block)
+        if (config.instructions) {
+            try {
+                const agentsMd = join(config.workingDirectory, "AGENTS.md");
+                appendWithMarker(agentsMd, config.instanceName, config.instructions);
+                // Warn if file exceeds Codex's project_doc_max_bytes limit
+                try {
+                    const size = statSync(agentsMd).size;
+                    if (size > CODEX_PROJECT_DOC_MAX_BYTES) {
+                        console.warn(`[agend] AGENTS.md is ${size} bytes, exceeds Codex limit of ${CODEX_PROJECT_DOC_MAX_BYTES} — instructions may be truncated`);
+                    }
+                }
+                catch { /* stat failed — skip size check */ }
+            }
+            catch { /* best effort */ }
+        }
+    }
+    preTrust(workDir) {
+        const configPath = join(homedir(), ".codex", "config.toml");
+        let content = "";
+        try {
+            content = readFileSync(configPath, "utf-8");
+        }
+        catch { }
+        const section = `[projects."${workDir}"]`;
+        if (content.includes(section))
+            return;
+        mkdirSync(dirname(configPath), { recursive: true });
+        appendFileSync(configPath, `\n${section}\ntrust_level = "trusted"\n`);
+    }
+    getReadyPattern() {
+        return /% left|OpenAI Codex/m;
+    }
+    getErrorPatterns() {
+        return [
+            { pattern: /rate limit|429 Too Many Requests/i, type: "rate_limit", action: "failover", message: "OpenAI rate limit reached" },
+            { pattern: /authentication|401 Unauthorized/i, type: "auth_error", action: "pause", message: "OpenAI authentication error" },
+            { pattern: /insufficient_quota|billing/i, type: "quota", action: "pause", message: "OpenAI quota exceeded" },
+            { pattern: /you've hit your usage limit/i, type: "quota", action: "pause", message: "Codex usage limit reached — upgrade plan required" },
+            { pattern: /less than \d+% of your weekly limit/i, type: "quota", action: "notify", message: "Codex weekly limit running low" },
+        ];
+    }
+    getStartupDialogs() {
+        return [
+            { pattern: /Do you trust the files in this folder/i, keys: ["Enter"], description: "Codex trust dialog" },
+            { pattern: /Yes, continue/i, keys: ["Enter"], description: "Codex 'Yes, continue' confirmation" },
+        ];
+    }
+    getRuntimeDialogs() {
+        return [
+            {
+                // Codex shows a model switch dialog when approaching rate limits.
+                // Auto-select "Keep current model (never show again)" — option 3.
+                pattern: /Approaching rate limits[\s\S]*Switch to.*for lower credit/m,
+                keys: ["Down", "Down", "Enter"],
+                description: "Codex rate limit model switch dialog",
+            },
+        ];
+    }
+    getContextUsage() {
+        return null;
+    }
+    getSessionId() {
+        // Codex manages sessions internally via SQLite (~/.codex/state_5.sqlite).
+        // `resume --last` handles session selection by CWD automatically.
+        return null;
+    }
+    getQuitCommand() { return "/quit"; }
+    cleanup(config) {
+        for (const name of Object.keys(config.mcpServers)) {
+            const mcpName = `${name}-${config.instanceName}`;
+            try {
+                execFileSync(this.binaryPath, ["mcp", "remove", mcpName], { stdio: "ignore" });
+            }
+            catch { /* best effort */ }
+        }
+        // Remove fleet instructions marker block from AGENTS.md
+        try {
+            const agentsMd = join(config.workingDirectory, "AGENTS.md");
+            const isEmpty = removeMarker(agentsMd, config.instanceName);
+            if (isEmpty && existsSync(agentsMd))
+                unlinkSync(agentsMd);
+        }
+        catch { /* best effort */ }
+        // Remove trust entry from ~/.codex/config.toml
+        try {
+            const configPath = join(homedir(), ".codex", "config.toml");
+            const content = readFileSync(configPath, "utf-8");
+            const escaped = config.workingDirectory.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+            const re = new RegExp(`\\n?\\[projects\\."${escaped}"\\]\\ntrust_level = "trusted"\\n?`);
+            if (re.test(content)) {
+                writeFileSync(configPath, content.replace(re, "\n"));
+            }
+        }
+        catch { /* best effort */ }
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/backend/codex.js.map

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

package/dist/backend/factory.d.ts

@@ -0,0 +1,2 @@
+import type { CliBackend } from "./types.js";
+export declare function createBackend(name: string, instanceDir: string): CliBackend;

package/dist/backend/factory.js

@@ -0,0 +1,28 @@
+import { ClaudeCodeBackend } from "./claude-code.js";
+import { GeminiCliBackend } from "./gemini-cli.js";
+import { CodexBackend } from "./codex.js";
+import { OpenCodeBackend } from "./opencode.js";
+import { KiroBackend } from "./kiro.js";
+import { AntigravityBackend } from "./antigravity.js";
+import { MockBackend } from "./mock.js";
+export function createBackend(name, instanceDir) {
+    switch (name) {
+        case "claude-code":
+            return new ClaudeCodeBackend(instanceDir);
+        case "gemini-cli":
+            return new GeminiCliBackend(instanceDir);
+        case "codex":
+            return new CodexBackend(instanceDir);
+        case "opencode":
+            return new OpenCodeBackend(instanceDir);
+        case "kiro-cli":
+            return new KiroBackend(instanceDir);
+        case "antigravity":
+            return new AntigravityBackend(instanceDir);
+        case "mock":
+            return new MockBackend(instanceDir);
+        default:
+            throw new Error(`Unknown backend: ${name}. Available: claude-code, gemini-cli, codex, opencode, kiro-cli, antigravity, mock`);
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/backend/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/backend/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,WAAmB;IAC7D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,aAAa;YAChB,OAAO,IAAI,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC5C,KAAK,YAAY;YACf,OAAO,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC3C,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,CAAC,WAAW,CAAC,CAAC;QACvC,KAAK,UAAU;YACb,OAAO,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;QAC1C,KAAK,UAAU;YACb,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QACtC,KAAK,aAAa;YAChB,OAAO,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC7C,KAAK,MAAM;YACT,OAAO,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;QACtC;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,oFAAoF,CAAC,CAAC;IAClI,CAAC;AACH,CAAC"}

package/dist/backend/gemini-cli.d.ts

@@ -0,0 +1,17 @@
+import { type CliBackend, type CliBackendConfig, type ErrorPattern, type StartupDialog } from "./types.js";
+export declare class GeminiCliBackend implements CliBackend {
+    private instanceDir;
+    readonly binaryName = "gemini";
+    private binaryPath;
+    constructor(instanceDir: string);
+    buildCommand(config: CliBackendConfig): string;
+    writeConfig(config: CliBackendConfig): void;
+    preTrust(workDir: string): void;
+    getReadyPattern(): RegExp;
+    getErrorPatterns(): ErrorPattern[];
+    getStartupDialogs(): StartupDialog[];
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    getQuitCommand(): string;
+    cleanup(config: CliBackendConfig): void;
+}

package/dist/backend/gemini-cli.js

@@ -0,0 +1,163 @@
+import { join, dirname } from "node:path";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolveBinary, validateModel } from "./types.js";
+import { appendWithMarker, removeMarker } from "./marker-utils.js";
+export class GeminiCliBackend {
+    instanceDir;
+    binaryName = "gemini";
+    binaryPath;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+        this.binaryPath = resolveBinary("gemini");
+    }
+    buildCommand(config) {
+        // --resume latest lets Gemini auto-resume without showing a session picker.
+        // Using specific session IDs causes a picker dialog that daemon can't handle.
+        let cmd = `${this.binaryPath} --yolo`;
+        if (!config.skipResume)
+            cmd += " --resume latest";
+        if (config.model) {
+            cmd += ` --model ${validateModel(config.model)}`;
+        }
+        return cmd;
+    }
+    writeConfig(config) {
+        // Gemini uses .gemini/settings.json for MCP servers
+        const geminiDir = join(config.workingDirectory, ".gemini");
+        mkdirSync(geminiDir, { recursive: true });
+        const settingsPath = join(geminiDir, "settings.json");
+        let settings = {};
+        try {
+            settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        }
+        catch { /* new file */ }
+        // Inject AGEND_INSTANCE_NAME into each MCP server's env so the MCP server
+        // identifies as this instance (Gemini spawns MCP servers as separate processes).
+        // Use instance-namespaced key to avoid conflicts when multiple instances share
+        // the same working directory.
+        const servers = (settings.mcpServers ?? {});
+        for (const [name, entry] of Object.entries(config.mcpServers)) {
+            const instanceKey = `${name}-${config.instanceName}`;
+            servers[instanceKey] = {
+                ...entry,
+                env: { ...entry.env, AGEND_INSTANCE_NAME: config.instanceName },
+            };
+        }
+        // Clean up old non-namespaced key if present (one-time migration)
+        delete servers["agend"];
+        settings.mcpServers = servers;
+        // Write model to per-project settings (Gemini reads model.name from settings.json)
+        if (config.model) {
+            settings.model = { name: config.model };
+        }
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+        // Write fleet instructions into GEMINI.md (additive via marker block)
+        if (config.instructions) {
+            try {
+                const geminiMd = join(config.workingDirectory, "GEMINI.md");
+                appendWithMarker(geminiMd, config.instanceName, config.instructions);
+            }
+            catch { /* best effort */ }
+        }
+    }
+    preTrust(workDir) {
+        const trustFile = join(homedir(), ".gemini", "trustedFolders.json");
+        let trusted = {};
+        try {
+            trusted = JSON.parse(readFileSync(trustFile, "utf-8"));
+        }
+        catch { }
+        let changed = false;
+        // Trust the exact working directory
+        if (!trusted[workDir]) {
+            trusted[workDir] = "TRUST_FOLDER";
+            changed = true;
+        }
+        // Also trust parent directory (Gemini may resolve cwd differently under launchd)
+        const parent = dirname(workDir);
+        if (parent !== workDir && !trusted[parent]) {
+            trusted[parent] = "TRUST_PARENT";
+            changed = true;
+        }
+        if (changed) {
+            mkdirSync(dirname(trustFile), { recursive: true });
+            writeFileSync(trustFile, JSON.stringify(trusted, null, 2));
+        }
+    }
+    getReadyPattern() {
+        return /Type your message|\? for shortcuts|YOLO Ctrl/m;
+    }
+    getErrorPatterns() {
+        return [
+            { pattern: /RESOURCE_EXHAUSTED|quota exceeded/i, type: "rate_limit", action: "notify", message: "Gemini quota exhausted" },
+            { pattern: /PERMISSION_DENIED|API key not valid/i, type: "auth_error", action: "pause", message: "Gemini authentication error" },
+            { pattern: /(?:google|googleapis|grpc).*UNAVAILABLE|503 Service/i, type: "network", action: "notify", message: "Gemini service unavailable" },
+        ];
+    }
+    getStartupDialogs() {
+        return [
+            { pattern: /[❯›]\s*Don't trust/m, keys: ["Up", "Up", "Enter"], description: "Gemini 'Don't trust' selected — navigate to Trust folder" },
+            { pattern: /Trust folder/i, keys: ["Enter"], description: "Gemini trust folder dialog" },
+        ];
+    }
+    getContextUsage() {
+        // Gemini CLI doesn't expose context usage via a file
+        return null;
+    }
+    getSessionId() {
+        try {
+            const f = join(this.instanceDir, "session-id");
+            return readFileSync(f, "utf-8").trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getQuitCommand() { return "/quit"; }
+    cleanup(config) {
+        // Only remove namespaced keys — non-namespaced keys may belong to
+        // another instance sharing this working directory.
+        try {
+            const settingsPath = join(config.workingDirectory, ".gemini", "settings.json");
+            if (existsSync(settingsPath)) {
+                const settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+                if (settings.mcpServers) {
+                    for (const name of Object.keys(config.mcpServers)) {
+                        delete settings.mcpServers[`${name}-${config.instanceName}`];
+                    }
+                    writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+                }
+            }
+        }
+        catch { /* best effort */ }
+        // Remove fleet instructions marker block from GEMINI.md
+        try {
+            const geminiMd = join(config.workingDirectory, "GEMINI.md");
+            const isEmpty = removeMarker(geminiMd, config.instanceName);
+            if (isEmpty && existsSync(geminiMd))
+                unlinkSync(geminiMd);
+        }
+        catch { /* best effort */ }
+        // Remove trust entries added by preTrust()
+        try {
+            const trustFile = join(homedir(), ".gemini", "trustedFolders.json");
+            const trusted = JSON.parse(readFileSync(trustFile, "utf-8"));
+            const workDir = config.workingDirectory;
+            const parent = dirname(workDir);
+            let changed = false;
+            if (trusted[workDir] === "TRUST_FOLDER") {
+                delete trusted[workDir];
+                changed = true;
+            }
+            if (parent !== workDir && trusted[parent] === "TRUST_PARENT") {
+                delete trusted[parent];
+                changed = true;
+            }
+            if (changed)
+                writeFileSync(trustFile, JSON.stringify(trusted, null, 2));
+        }
+        catch { /* best effort */ }
+    }
+}
+//# sourceMappingURL=gemini-cli.js.map

package/dist/backend/gemini-cli.js.map

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

package/dist/backend/index.d.ts

@@ -0,0 +1,7 @@
+export type { CliBackend, CliBackendConfig, McpServerEntry, ErrorPattern, ErrorActionType, ErrorType, RuntimeDialog } from "./types.js";
+export { ClaudeCodeBackend } from "./claude-code.js";
+export { GeminiCliBackend } from "./gemini-cli.js";
+export { CodexBackend } from "./codex.js";
+export { OpenCodeBackend } from "./opencode.js";
+export { KiroBackend } from "./kiro.js";
+export { createBackend } from "./factory.js";

package/dist/backend/index.js

@@ -0,0 +1,7 @@
+export { ClaudeCodeBackend } from "./claude-code.js";
+export { GeminiCliBackend } from "./gemini-cli.js";
+export { CodexBackend } from "./codex.js";
+export { OpenCodeBackend } from "./opencode.js";
+export { KiroBackend } from "./kiro.js";
+export { createBackend } from "./factory.js";
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/backend/kiro.d.ts

@@ -0,0 +1,17 @@
+import { type CliBackend, type CliBackendConfig, type ErrorPattern, type StartupDialog, type RuntimeDialog } from "./types.js";
+export declare class KiroBackend implements CliBackend {
+    private instanceDir;
+    readonly binaryName = "kiro-cli";
+    private binaryPath;
+    constructor(instanceDir: string);
+    buildCommand(config: CliBackendConfig): string;
+    writeConfig(config: CliBackendConfig): void;
+    getReadyPattern(): RegExp;
+    getErrorPatterns(): ErrorPattern[];
+    getStartupDialogs(): StartupDialog[];
+    getRuntimeDialogs(): RuntimeDialog[];
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    getQuitCommand(): string;
+    cleanup(config: CliBackendConfig): void;
+}