@songsid/agend 0.0.1

package/dist/backend/kiro.js

@@ -0,0 +1,147 @@
+import { join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync, unlinkSync } from "node:fs";
+import { resolveBinary, validateModel } from "./types.js";
+export class KiroBackend {
+    instanceDir;
+    binaryName = "kiro-cli";
+    binaryPath;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+        this.binaryPath = resolveBinary("kiro-cli");
+    }
+    buildCommand(config) {
+        let cmd = `${this.binaryPath} chat --legacy-ui`;
+        if (config.skipPermissions !== false)
+            cmd += " --trust-all-tools";
+        // --resume is boolean: Kiro auto-resumes latest conversation for this working directory
+        if (!config.skipResume)
+            cmd += " --resume";
+        if (config.model)
+            cmd += ` --model ${validateModel(config.model)}`;
+        cmd += " --require-mcp-startup";
+        return cmd;
+    }
+    writeConfig(config) {
+        // Kiro CLI reads workspace MCP config from .kiro/settings/mcp.json
+        // Format: { "mcpServers": { "name": { command, args, env } } }
+        //
+        // WORKAROUND: kiro-cli ignores the "env" block in mcp.json — the MCP server
+        // subprocess inherits the fleet manager's process env, which has a stale
+        // AGEND_SOCKET_PATH from whichever daemon wrote to it last.
+        // Fix: generate a wrapper script that exports the correct env vars before
+        // exec-ing the real MCP server.
+        const mcpDir = join(config.workingDirectory, ".kiro", "settings");
+        mkdirSync(mcpDir, { recursive: true });
+        const mcpConfigPath = join(mcpDir, "mcp.json");
+        let mcpConfig = {};
+        try {
+            mcpConfig = JSON.parse(readFileSync(mcpConfigPath, "utf-8"));
+        }
+        catch { /* new file */ }
+        const servers = (mcpConfig.mcpServers ?? {});
+        // Remove stale agend entries whose wrapper scripts no longer exist
+        for (const [key, val] of Object.entries(servers)) {
+            if (key.startsWith("agend-")) {
+                const cmd = val?.command;
+                if (typeof cmd === "string" && !existsSync(cmd)) {
+                    delete servers[key];
+                }
+            }
+        }
+        for (const [name, entry] of Object.entries(config.mcpServers)) {
+            const instanceKey = `${name}-${config.instanceName}`;
+            const allEnv = { ...entry.env, AGEND_INSTANCE_NAME: config.instanceName };
+            // Write a wrapper script that sets env vars explicitly
+            const wrapperPath = join(this.instanceDir, `mcp-wrapper-${name}.sh`);
+            const envExports = Object.entries(allEnv)
+                .map(([k, v]) => `export ${k}='${String(v).replace(/'/g, "'\\''")}'`)
+                .join("\n");
+            // 0o700 (owner-only rwx): wrapper inlines sensitive env (tokens, socket paths).
+            // Other users on the host must not be able to read it. Set mode at creation
+            // to avoid a world-readable window between writeFileSync and chmodSync.
+            writeFileSync(wrapperPath, `#!/bin/bash\n${envExports}\n# Wait for IPC socket to be ready (up to 10s)\nfor i in $(seq 1 20); do [ -S "$AGEND_SOCKET_PATH" ] && break; sleep 0.5; done\nexec ${entry.command} ${entry.args.map((a) => JSON.stringify(a)).join(" ")}\n`, { mode: 0o700 });
+            // Re-chmod in case the file already existed with looser permissions (writeFileSync's
+            // mode only applies on create).
+            chmodSync(wrapperPath, 0o700);
+            servers[instanceKey] = {
+                command: wrapperPath,
+                args: [],
+            };
+        }
+        // Clean up old non-namespaced key if present
+        delete servers["agend"];
+        mcpConfig.mcpServers = servers;
+        writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2));
+        // Write fleet instructions to .kiro/steering/ (auto-loaded by Kiro CLI)
+        if (config.instructions) {
+            try {
+                const steeringDir = join(config.workingDirectory, ".kiro", "steering");
+                mkdirSync(steeringDir, { recursive: true });
+                writeFileSync(join(steeringDir, `agend-${config.instanceName}.md`), config.instructions);
+            }
+            catch { /* best effort */ }
+        }
+    }
+    getReadyPattern() {
+        // Kiro 1.x: "All tools are now trusted" / Kiro 2.x: "Trust All Tools active"
+        return /All tools are now trusted|Trust All Tools active|Credits:.*Time:|ask a question or describe a task/m;
+    }
+    getErrorPatterns() {
+        return [];
+    }
+    getStartupDialogs() {
+        return [
+            {
+                // Kiro CLI --trust-all-tools now shows a confirmation prompt.
+                // Default cursor is on "No, exit" — press Down then Enter to select "Yes, I accept".
+                pattern: /[❯›]\s*No, exit/m,
+                keys: ["Down", "Enter"],
+                description: "Kiro --trust-all-tools confirmation — navigate to 'Yes, I accept'",
+            },
+        ];
+    }
+    getRuntimeDialogs() {
+        return [
+            {
+                // Same trust prompt can also appear mid-session if Kiro re-validates.
+                pattern: /Do you trust the files|Yes, I accept[\s\S]*No, exit/m,
+                keys: ["Down", "Enter"],
+                description: "Kiro trust confirmation dialog — auto-accept",
+            },
+        ];
+    }
+    getContextUsage() {
+        return null;
+    }
+    getSessionId() {
+        // Kiro manages sessions internally via SQLite keyed by working directory.
+        // No external session ID needed — --resume handles it automatically.
+        return null;
+    }
+    getQuitCommand() { return "/quit"; }
+    cleanup(config) {
+        // Only remove namespaced keys — non-namespaced "agend" key may belong to
+        // another instance sharing this working directory.
+        try {
+            const mcpConfigPath = join(config.workingDirectory, ".kiro", "settings", "mcp.json");
+            if (existsSync(mcpConfigPath)) {
+                const mcpConfig = JSON.parse(readFileSync(mcpConfigPath, "utf-8"));
+                if (mcpConfig.mcpServers) {
+                    for (const name of Object.keys(config.mcpServers)) {
+                        delete mcpConfig.mcpServers[`${name}-${config.instanceName}`];
+                    }
+                    writeFileSync(mcpConfigPath, JSON.stringify(mcpConfig, null, 2));
+                }
+            }
+        }
+        catch { /* best effort */ }
+        // Remove fleet instructions steering file
+        try {
+            const steeringFile = join(config.workingDirectory, ".kiro", "steering", `agend-${config.instanceName}.md`);
+            if (existsSync(steeringFile))
+                unlinkSync(steeringFile);
+        }
+        catch { /* best effort */ }
+    }
+}
+//# sourceMappingURL=kiro.js.map

package/dist/backend/kiro.js.map

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

package/dist/backend/marker-utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Append content wrapped in marker tags to a file. Idempotent — removes any
+ * existing block with the same id before appending.
+ */
+export declare function appendWithMarker(filePath: string, id: string, content: string): void;
+/**
+ * Remove a marker block from a file. Returns true if the file is empty/whitespace
+ * after removal (caller may want to delete it).
+ * Returns false if the file was not modified or still has content.
+ */
+export declare function removeMarker(filePath: string, id: string, logger?: {
+    warn: (msg: string) => void;
+}): boolean;

package/dist/backend/marker-utils.js

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+/** Escape special regex characters in a string */
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function beginTag(id) { return `<!-- AGEND:${id}:BEGIN -->`; }
+function endTag(id) { return `<!-- AGEND:${id}:END -->`; }
+/**
+ * Append content wrapped in marker tags to a file. Idempotent — removes any
+ * existing block with the same id before appending.
+ */
+export function appendWithMarker(filePath, id, content) {
+    let existing = "";
+    try {
+        existing = readFileSync(filePath, "utf-8");
+    }
+    catch { /* new file */ }
+    // Remove old block first (idempotent)
+    existing = stripMarkerBlock(existing, id);
+    // Ensure preceding newline
+    const sep = existing.length > 0 && !existing.endsWith("\n") ? "\n\n" : existing.length > 0 ? "\n" : "";
+    const block = `${beginTag(id)}\n${content}\n${endTag(id)}\n`;
+    writeFileSync(filePath, existing + sep + block);
+}
+/**
+ * Remove a marker block from a file. Returns true if the file is empty/whitespace
+ * after removal (caller may want to delete it).
+ * Returns false if the file was not modified or still has content.
+ */
+export function removeMarker(filePath, id, logger) {
+    if (!existsSync(filePath))
+        return false;
+    let content;
+    try {
+        content = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return false;
+    }
+    const escaped = escapeRegex(id);
+    const re = new RegExp(`\\n?<!-- AGEND:${escaped}:BEGIN -->\\n[\\s\\S]*?<!-- AGEND:${escaped}:END -->\\n?`, "g");
+    const updated = content.replace(re, "");
+    if (updated === content) {
+        // Regex didn't match — try fallback: find BEGIN marker to end of file
+        const beginStr = beginTag(id);
+        const idx = content.indexOf(beginStr);
+        if (idx >= 0) {
+            const fallback = content.slice(0, idx).replace(/\n+$/, "\n");
+            writeFileSync(filePath, fallback);
+            logger?.warn(`marker-utils: END marker missing for ${id} in ${filePath}, removed from BEGIN to EOF`);
+            return fallback.trim().length === 0;
+        }
+        return false;
+    }
+    writeFileSync(filePath, updated);
+    return updated.trim().length === 0;
+}
+/** Strip a marker block from a string (in-memory, no file I/O) */
+function stripMarkerBlock(content, id) {
+    const escaped = escapeRegex(id);
+    const re = new RegExp(`\\n?<!-- AGEND:${escaped}:BEGIN -->\\n[\\s\\S]*?<!-- AGEND:${escaped}:END -->\\n?`, "g");
+    return content.replace(re, "");
+}
+//# sourceMappingURL=marker-utils.js.map

package/dist/backend/marker-utils.js.map

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

package/dist/backend/mock.d.ts

@@ -0,0 +1,25 @@
+import type { CliBackend, CliBackendConfig, ErrorPattern } from "./types.js";
+/**
+ * Mock backend for E2E testing.
+ *
+ * Instead of spawning a real CLI (claude, gemini, etc.), it launches a small
+ * Node.js script (`mock-claude.mjs`) that:
+ * - Starts the real agend MCP server (connects to daemon IPC)
+ * - Writes periodic statusline.json updates
+ * - Accepts stdin messages and outputs canned responses
+ *
+ * This lets E2E tests exercise the full agend orchestration (daemon, IPC,
+ * routing, tmux) without needing a real AI API or CLI binary.
+ */
+export declare class MockBackend implements CliBackend {
+    private instanceDir;
+    readonly binaryName = "node";
+    constructor(instanceDir: string);
+    buildCommand(config: CliBackendConfig): string;
+    writeConfig(config: CliBackendConfig): void;
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    getQuitCommand(): string;
+    getReadyPattern(): RegExp;
+    getErrorPatterns(): ErrorPattern[];
+}

package/dist/backend/mock.js

@@ -0,0 +1,85 @@
+import { join, dirname } from "node:path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Mock backend for E2E testing.
+ *
+ * Instead of spawning a real CLI (claude, gemini, etc.), it launches a small
+ * Node.js script (`mock-claude.mjs`) that:
+ * - Starts the real agend MCP server (connects to daemon IPC)
+ * - Writes periodic statusline.json updates
+ * - Accepts stdin messages and outputs canned responses
+ *
+ * This lets E2E tests exercise the full agend orchestration (daemon, IPC,
+ * routing, tmux) without needing a real AI API or CLI binary.
+ */
+export class MockBackend {
+    instanceDir;
+    binaryName = "node";
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+    }
+    buildCommand(config) {
+        // Try dist path first, then src-relative path for dev mode
+        const distScript = join(__dirname, "..", "e2e", "mock-servers", "mock-claude.mjs");
+        const srcScript = join(__dirname, "..", "..", "e2e", "mock-servers", "mock-claude.mjs");
+        const script = existsSync(distScript) ? distScript : srcScript;
+        const q = (v) => `'${v.replace(/'/g, "'\\''")}'`;
+        const envPrefix = [
+            `AGEND_SOCKET_PATH=${q(join(this.instanceDir, "channel.sock"))}`,
+            `AGEND_INSTANCE_NAME=${q(config.instanceName)}`,
+            `MOCK_INSTANCE_DIR=${q(this.instanceDir)}`,
+        ];
+        if (process.env.MOCK_RESPONSE)
+            envPrefix.push(`MOCK_RESPONSE=${q(process.env.MOCK_RESPONSE)}`);
+        if (process.env.MOCK_DELAY)
+            envPrefix.push(`MOCK_DELAY=${q(process.env.MOCK_DELAY)}`);
+        return `${envPrefix.join(" ")} node ${q(script)}`;
+    }
+    writeConfig(config) {
+        const mcpConfigPath = join(this.instanceDir, "mcp-config.json");
+        writeFileSync(mcpConfigPath, JSON.stringify({ mcpServers: config.mcpServers }, null, 2));
+        // Write initial statusline.json matching real Claude Code format
+        const statusline = {
+            session_id: `mock-${config.instanceName}-${Date.now()}`,
+            model: "mock-model",
+            cost_usd: 0,
+            total_tokens: 0,
+            context_window: {
+                used_percentage: 0,
+                context_window_size: 200000,
+            },
+        };
+        writeFileSync(join(this.instanceDir, "statusline.json"), JSON.stringify(statusline));
+    }
+    getContextUsage() {
+        try {
+            const data = JSON.parse(readFileSync(join(this.instanceDir, "statusline.json"), "utf-8"));
+            return data.context_window?.used_percentage ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getSessionId() {
+        try {
+            return readFileSync(join(this.instanceDir, "session-id"), "utf-8").trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getQuitCommand() { return "/quit"; }
+    getReadyPattern() {
+        return /MOCK_READY|mock-claude ready/;
+    }
+    getErrorPatterns() {
+        return [
+            { pattern: /MOCK_RATE_LIMIT/i, type: "rate_limit", action: "failover", message: "Mock rate limit reached" },
+            { pattern: /MOCK_AUTH_ERROR/i, type: "auth_error", action: "notify", message: "Mock auth error" },
+        ];
+    }
+}
+//# sourceMappingURL=mock.js.map

package/dist/backend/mock.js.map

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

package/dist/backend/opencode.d.ts

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

package/dist/backend/opencode.js

@@ -0,0 +1,136 @@
+import { join } from "node:path";
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { resolveBinary, validateModel } from "./types.js";
+export class OpenCodeBackend {
+    instanceDir;
+    binaryName = "opencode";
+    binaryPath;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+        this.binaryPath = resolveBinary("opencode");
+    }
+    buildCommand(config) {
+        // Use per-instance config via OPENCODE_CONFIG env (set in writeConfig)
+        let cmd = this.binaryPath;
+        // Resume last session if skipResume is not set
+        if (!config.skipResume) {
+            const sessionIdFile = join(this.instanceDir, "session-id");
+            if (existsSync(sessionIdFile)) {
+                const sid = readFileSync(sessionIdFile, "utf-8").trim();
+                if (sid)
+                    cmd += ` --session ${sid}`;
+            }
+            else {
+                cmd += " --continue";
+            }
+        }
+        if (config.model) {
+            cmd += ` --model ${validateModel(config.model)}`;
+        }
+        return cmd;
+    }
+    writeConfig(config) {
+        // OpenCode reads opencode.json from the working directory.
+        // Use instance-specific MCP server key name to avoid conflicts when
+        // multiple instances share the same working directory.
+        const configPath = join(config.workingDirectory, "opencode.json");
+        let oc = {};
+        try {
+            oc = JSON.parse(readFileSync(configPath, "utf-8"));
+        }
+        catch { /* new file */ }
+        // MCP servers — use instance name as key to avoid multi-instance conflicts
+        const mcp = (oc.mcp ?? {});
+        for (const [name, entry] of Object.entries(config.mcpServers)) {
+            const safeInstanceName = config.instanceName.replace(/[^\x20-\x7E]/g, "").replace(/\s+/g, "-") || config.instanceName.replace(/[^a-zA-Z0-9-]/g, "x");
+            const instanceKey = `${name}-${safeInstanceName}`;
+            // Remove old non-sanitized key if present
+            const oldKey = `${name}-${config.instanceName}`;
+            if (oldKey !== instanceKey)
+                delete mcp[oldKey];
+            mcp[instanceKey] = {
+                type: "local",
+                command: [entry.command, ...entry.args],
+                environment: { ...entry.env, AGEND_INSTANCE_NAME: config.instanceName },
+            };
+        }
+        // Clean up old non-namespaced key if present
+        delete mcp["agend"];
+        oc.mcp = mcp;
+        delete oc.mcpServers;
+        // Add fleet instructions file to instructions (additive — appends to existing array)
+        if (config.instructions) {
+            try {
+                const instrFile = join(config.instanceDir, "fleet-instructions.md");
+                writeFileSync(instrFile, config.instructions);
+                const paths = (oc.instructions ?? []);
+                if (!paths.includes(instrFile))
+                    paths.push(instrFile);
+                oc.instructions = paths;
+            }
+            catch { /* best effort */ }
+        }
+        writeFileSync(configPath, JSON.stringify(oc, null, 2));
+    }
+    getReadyPattern() {
+        return /Ask anything|ctrl\+p commands/m;
+    }
+    getErrorPatterns() {
+        return [
+            { pattern: /rate.?limit|too many requests|429/i, type: "rate_limit", action: "failover", message: "Rate limit reached" },
+            { pattern: /auth.*error|unauthorized|401/i, type: "auth_error", action: "pause", message: "Authentication error" },
+        ];
+    }
+    getContextUsage() {
+        return null;
+    }
+    getSessionId() {
+        try {
+            const f = join(this.instanceDir, "session-id");
+            return readFileSync(f, "utf-8").trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    getQuitCommand() { return "/quit"; }
+    getRuntimeDialogs() {
+        return [
+            { pattern: /Permission required/i, keys: ["Right", "Enter"], description: "OpenCode permission prompt — Allow always" },
+            { pattern: /confirm/i, keys: ["Enter"], description: "OpenCode confirm prompt" },
+        ];
+    }
+    cleanup(config) {
+        // Clean up instance-specific MCP entries from opencode.json.
+        // Only remove namespaced keys — non-namespaced "agend" key may belong to
+        // another instance sharing this working directory.
+        try {
+            const configPath = join(config.workingDirectory, "opencode.json");
+            if (existsSync(configPath)) {
+                const oc = JSON.parse(readFileSync(configPath, "utf-8"));
+                if (oc.mcp) {
+                    for (const name of Object.keys(config.mcpServers)) {
+                        const safeName = config.instanceName.replace(/[^\x20-\x7E]/g, "").replace(/\s+/g, "-") || config.instanceName.replace(/[^a-zA-Z0-9-]/g, "x");
+                        delete oc.mcp[`${name}-${safeName}`];
+                        delete oc.mcp[`${name}-${config.instanceName}`]; // clean up old non-sanitized keys
+                    }
+                }
+                // Remove fleet instructions path from instructions
+                const instrFile = join(config.instanceDir, "fleet-instructions.md");
+                if (Array.isArray(oc.instructions)) {
+                    oc.instructions = oc.instructions.filter((p) => p !== instrFile);
+                }
+                writeFileSync(configPath, JSON.stringify(oc, null, 2));
+            }
+        }
+        catch { /* best effort */ }
+        // Remove fleet instructions file
+        try {
+            const instrFile = join(config.instanceDir, "fleet-instructions.md");
+            if (existsSync(instrFile))
+                unlinkSync(instrFile);
+        }
+        catch { /* best effort */ }
+    }
+}
+//# sourceMappingURL=opencode.js.map

package/dist/backend/opencode.js.map

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

package/dist/backend/types.d.ts

@@ -0,0 +1,86 @@
+export interface McpServerEntry {
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+}
+export interface CliBackendConfig {
+    workingDirectory: string;
+    instanceDir: string;
+    instanceName: string;
+    mcpServers: Record<string, McpServerEntry>;
+    skipPermissions?: boolean;
+    model?: string;
+    /** When true, backend should not resume a previous session (crash recovery). */
+    skipResume?: boolean;
+    /** Fleet instructions content to inject into the CLI's additive system prompt mechanism. */
+    instructions?: string;
+    /** Agent communication mode: "mcp" (default) or "cli" (HTTP endpoint). */
+    agentMode?: "mcp" | "cli";
+    /** Health server port for CLI mode (agend-agent connects here). */
+    agentPort?: number;
+}
+/** Action to take when an error pattern is detected in PTY output. */
+export type ErrorActionType = "notify" | "failover" | "restart" | "pause";
+/** Categorizes detected errors for logging and response. */
+export type ErrorType = "rate_limit" | "auth_error" | "crash" | "network" | "quota";
+export interface ErrorPattern {
+    pattern: RegExp;
+    type: ErrorType;
+    action: ErrorActionType;
+    /** Human-readable description for notifications. */
+    message: string;
+}
+/** A dialog that may appear at runtime and needs auto-dismissal via key sequences. */
+export interface RuntimeDialog {
+    /** Pattern to detect the dialog in PTY output. */
+    pattern: RegExp;
+    /** Key sequence to dismiss: strings are literal text, "Up"/"Down"/"Enter"/"Escape" are special keys. */
+    keys: string[];
+    /** Human-readable description for logging. */
+    description: string;
+}
+/** A dialog that may appear during CLI startup (trust prompts, session pickers, etc.). */
+export type StartupDialog = RuntimeDialog;
+export interface CliBackend {
+    /** The CLI binary name (e.g. "claude", "gemini", "codex") */
+    readonly binaryName: string;
+    /** Build the shell command string to launch the CLI in a tmux window. */
+    buildCommand(config: CliBackendConfig): string;
+    /** Write all config files the CLI needs before launch. */
+    writeConfig(config: CliBackendConfig): void;
+    /** Read context window usage percentage (0-100). Returns null if unavailable. */
+    getContextUsage(): number | null;
+    /** Read session ID for resume capability. Returns null if unavailable. */
+    getSessionId(): string | null;
+    /** Regex to detect when the CLI is ready to accept input. */
+    getReadyPattern(): RegExp;
+    /** Error patterns to detect in PTY output during operation. */
+    getErrorPatterns?(): ErrorPattern[];
+    /**
+     * Interactive dialogs that can appear during operation (not just startup).
+     * The daemon's error monitor auto-dismisses these by sending the specified keys.
+     */
+    getRuntimeDialogs?(): RuntimeDialog[];
+    /**
+     * Dialogs that may appear during CLI startup (trust prompts, confirmation dialogs).
+     * The daemon's dismissDialogsUntilReady auto-dismisses these before the CLI is ready.
+     */
+    getStartupDialogs?(): StartupDialog[];
+    /** Whether this backend re-reads instruction files on --resume (e.g. Claude Code's --append-system-prompt-file). */
+    readonly instructionsReloadedOnResume?: boolean;
+    /** Pre-approve a working directory to skip trust dialogs on startup. */
+    preTrust?(workingDirectory: string): void;
+    /** Command to gracefully quit the CLI (e.g. "/exit", "/quit"). */
+    getQuitCommand(): string;
+    /** Clean up config files on shutdown. */
+    cleanup?(config: CliBackendConfig): void;
+}
+/**
+ * Resolve the full path to a CLI binary.
+ * tmux new-window runs commands in a minimal shell without user PATH,
+ * so we resolve at daemon startup time when the full PATH is available.
+ */
+export declare function resolveBinary(name: string): string;
+export declare function validateModel(model: string): string;
+/** POSIX single-quote escape for embedding arbitrary values in a shell command. */
+export declare function shellQuote(s: string): string;

package/dist/backend/types.js

@@ -0,0 +1,33 @@
+import { execFileSync } from "node:child_process";
+/**
+ * Resolve the full path to a CLI binary.
+ * tmux new-window runs commands in a minimal shell without user PATH,
+ * so we resolve at daemon startup time when the full PATH is available.
+ */
+export function resolveBinary(name) {
+    try {
+        return execFileSync("which", [name], { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return name; // fallback to bare name
+    }
+}
+/**
+ * Whitelist for model names embedded into the shell command line.
+ * Allows letters, digits, dot, underscore, hyphen, colon, slash
+ * (e.g. "claude-3-5-sonnet", "gpt-4o-mini-2024-07-18", "openrouter/anthropic:beta").
+ * Throws if `model` contains anything else, since `buildCommand` returns a
+ * shell string consumed by tmux and we cannot rely on argv-style quoting.
+ */
+const SAFE_MODEL_RE = /^[A-Za-z0-9._:/-]+$/;
+export function validateModel(model) {
+    if (!SAFE_MODEL_RE.test(model)) {
+        throw new Error(`Invalid model name: ${JSON.stringify(model)} — must match ${SAFE_MODEL_RE}`);
+    }
+    return model;
+}
+/** POSIX single-quote escape for embedding arbitrary values in a shell command. */
+export function shellQuote(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+//# sourceMappingURL=types.js.map

package/dist/backend/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAmGlD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,wBAAwB;IACvC,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAC5C,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,iBAAiB,aAAa,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AACzC,CAAC"}