@suzuke/agend 0.0.1 → 1.0.2

package/README.md

@@ -1 +1,79 @@
 # AgEnD
+
+[![npm](https://img.shields.io/npm/v/@suzuke/agend)](https://www.npmjs.com/package/@suzuke/agend)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js >= 20](https://img.shields.io/badge/Node.js-%3E%3D%2020-green.svg)](https://nodejs.org)
+
+**Agent Engineering Daemon** — run a fleet of AI coding agents from your phone.
+
+One Telegram bot, multiple CLI backends (Claude Code, Gemini CLI, Codex, OpenCode), unlimited projects. Each Forum Topic is an independent agent session with crash recovery and zero babysitting.
+
+[繁體中文](README.zh-TW.md)
+
+> **⚠️** All CLI backends run with `--dangerously-skip-permissions` (or equivalent). See [Security](SECURITY.md).
+
+## Problems agend solves
+
+| Without agend | With agend |
+|---|---|
+| Close the terminal, agent goes offline | Runs as a system service — survives reboots |
+| One terminal = one project | One bot, unlimited projects running in parallel |
+| Long-running sessions accumulate stale context | Auto-rotates sessions by max age to stay fresh |
+| No idea what your agents are doing overnight | Daily cost reports + hang detection alerts |
+| Cron tasks disappear when the session ends | Persistent schedules backed by SQLite |
+| Rate limited on one model, everything stops | Auto-failover to backup models |
+| Can't approve tool use from your phone | Inline Telegram buttons with countdown + Always Allow |
+| Agents work in silos, can't coordinate | Peer-to-peer collaboration via MCP tools |
+| Runaway costs from unattended sessions | Per-instance daily spending limits with auto-pause |
+
+## Quick start
+
+```bash
+brew install tmux               # macOS (prerequisite)
+npm install -g @suzuke/agend    # install
+agend init                      # interactive setup
+agend fleet start               # launch the fleet
+```
+
+## Features
+
+- **Fleet mode** — one bot, N projects, each in its own Telegram Forum Topic
+- **Persistent schedules** — cron-based tasks that survive restarts (SQLite-backed)
+- **Context rotation** — auto-restart long-running sessions to keep context fresh (max-age based)
+- **Peer-to-peer collaboration** — agents discover, wake, and message each other via MCP tools
+- **General Topic** — natural language dispatcher that routes tasks to the right agent
+- **Permission relay** — inline Telegram buttons for Allow/Deny with countdown + Always Allow
+- **Voice messages** — Groq Whisper transcription, talk to your agents
+- **Cost guard** — per-instance daily spending limits with auto-pause
+- **Hang detection** — auto-detect stuck sessions, notify with restart buttons
+- **Model failover** — auto-switch to backup model on rate limits
+- **Daily summary** — fleet cost report posted to Telegram
+- **External sessions** — connect local Claude Code to the fleet via IPC
+- **Discord adapter** — use Discord instead of (or alongside) Telegram
+- **Health endpoint** — HTTP API for external monitoring
+- **Webhook notifications** — push events to Slack or custom endpoints
+- **System service** — one command to install as launchd/systemd service
+
+## Requirements
+
+- Node.js >= 20
+- tmux
+- Claude Code CLI (`claude`)
+- Telegram bot token ([@BotFather](https://t.me/BotFather))
+- Groq API key (optional, for voice)
+
+## Documentation
+
+- [Features](docs/features.md) — detailed feature documentation
+- [CLI Reference](docs/cli.md) — all commands and options
+- [Configuration](docs/configuration.md) — fleet.yaml, .env, data directory
+- [Security](SECURITY.md) — trust model and hardening
+
+## Known limitations
+
+- macOS (launchd) and Linux (systemd) supported; Windows is not
+- Official Telegram plugin in global `enabledPlugins` causes 409 polling conflicts
+
+## License
+
+MIT

package/README.zh-TW.md

@@ -0,0 +1,79 @@
+# AgEnD
+
+[![npm](https://img.shields.io/npm/v/@suzuke/agend)](https://www.npmjs.com/package/@suzuke/agend)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js >= 20](https://img.shields.io/badge/Node.js-%3E%3D%2020-green.svg)](https://nodejs.org)
+
+**Agent Engineering Daemon** — 用手機管理一整個 AI coding agent 團隊。
+
+一個 Telegram bot，多種 CLI 後端（Claude Code、Gemini CLI、Codex、OpenCode），無限專案。每個 Forum Topic 就是一個獨立的 agent session，crash 自動恢復，不用顧。
+
+[English](README.md)
+
+> **⚠️** 所有 CLI 後端都以 `--dangerously-skip-permissions`（或等效參數）執行。詳見 [Security](SECURITY.md)。
+
+## agend 解決什麼問題
+
+| 沒有 agend | 有 agend |
+|---|---|
+| 關掉終端機，agent 就斷線 | 系統服務常駐，重開機也不怕 |
+| 一個終端機 = 一個專案 | 一個 bot，無限專案同時跑 |
+| 長時間 session 累積過時 context | 依 max age 自動輪替 session，保持新鮮 |
+| 不知道 agent 半夜在幹嘛 | 每日花費報告 + 卡住偵測通知 |
+| 排程任務隨 session 結束消失 | 持久化排程，SQLite 儲存 |
+| 某個 model 被限速，全部停擺 | 自動切換備用 model |
+| 沒辦法從手機核准工具使用 | Telegram inline 按鈕，倒數計時 + Always Allow |
+| Agent 各做各的，無法協作 | 點對點協作，透過 MCP tools |
+| 無人看管時帳單暴增 | 每個 instance 每日花費上限，自動暫停 |
+
+## 開始用
+
+```bash
+brew install tmux               # macOS（前置需求）
+npm install -g @suzuke/agend    # 安裝
+agend init                      # 互動式設定
+agend fleet start               # 啟動 fleet
+```
+
+## 功能
+
+- **Fleet 模式** — 一個 bot、N 個專案，各自獨立的 Telegram Forum Topic
+- **持久化排程** — cron 排程任務，重啟不遺失（SQLite 儲存）
+- **Context 輪替** — 長時間 session 依 max age 自動重啟，保持 context 新鮮
+- **點對點協作** — agent 之間透過 MCP tools 互相發現、喚醒、傳訊
+- **General Topic** — 自然語言調度器，把任務路由到對的 agent
+- **權限轉發** — Telegram inline 按鈕 Allow/Deny，倒數計時 + Always Allow
+- **語音訊息** — Groq Whisper 轉文字，用說的跟 agent 溝通
+- **花費上限** — 每個 instance 每日限額，超過自動暫停
+- **卡住偵測** — 自動偵測無回應的 session，通知並提供重啟按鈕
+- **Model Failover** — 被限速時自動切換備用 model
+- **每日摘要** — Fleet 花費報告，發到 Telegram
+- **外部 Session** — 本地 Claude Code 透過 IPC 連入 fleet
+- **Discord Adapter** — 用 Discord 取代（或同時使用）Telegram
+- **Health Endpoint** — HTTP API 供外部監控
+- **Webhook 通知** — 推送事件到 Slack 或自訂 endpoint
+- **系統服務** — 一行指令裝成 launchd/systemd 服務
+
+## 系統需求
+
+- Node.js >= 20
+- tmux
+- Claude Code CLI（`claude`）
+- Telegram bot token（[@BotFather](https://t.me/BotFather)）
+- Groq API key（選用，語音轉文字用）
+
+## 文件
+
+- [Features](docs/features.md) — 功能詳細說明
+- [CLI Reference](docs/cli.md) — 所有指令與選項
+- [Configuration](docs/configuration.md) — fleet.yaml、.env、資料目錄
+- [Security](SECURITY.md) — 信任模型與安全強化
+
+## 已知限制
+
+- 支援 macOS（launchd）和 Linux（systemd），不支援 Windows
+- 全域 `enabledPlugins` 裡有官方 Telegram plugin 會造成 409 polling 衝突
+
+## 授權
+
+MIT

package/dist/access-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Resolve the access.json path for an instance.
+ * Topic mode uses fleet-level access; otherwise per-instance.
+ */
+export declare function resolveAccessPathFromConfig(dataDir: string, _instance: string, fleetChannel: {
+    mode?: string;
+} | undefined): string;

package/dist/access-path.js

@@ -0,0 +1,12 @@
+import { join } from "node:path";
+/**
+ * Resolve the access.json path for an instance.
+ * Topic mode uses fleet-level access; otherwise per-instance.
+ */
+export function resolveAccessPathFromConfig(dataDir, _instance, fleetChannel) {
+    if (fleetChannel?.mode === "topic") {
+        return join(dataDir, "access", "access.json");
+    }
+    return join(dataDir, "access", "access.json");
+}
+//# sourceMappingURL=access-path.js.map

package/dist/access-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-path.js","sourceRoot":"","sources":["../src/access-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAe,EACf,SAAiB,EACjB,YAA2C;IAE3C,IAAI,YAAY,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAChD,CAAC"}

package/dist/backend/claude-code.d.ts

@@ -0,0 +1,13 @@
+import type { CliBackend, CliBackendConfig } from "./types.js";
+export declare class ClaudeCodeBackend implements CliBackend {
+    private instanceDir;
+    constructor(instanceDir: string);
+    buildCommand(config: CliBackendConfig): string;
+    writeConfig(config: CliBackendConfig): void;
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    cleanup(_config: CliBackendConfig): void;
+    /** Pre-approve ANTHROPIC_API_KEY in ~/.claude.json to skip the interactive prompt */
+    private preApproveApiKey;
+    private writeStatusLineScript;
+}

package/dist/backend/claude-code.js

@@ -0,0 +1,114 @@
+import { join } from "node:path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+export class ClaudeCodeBackend {
+    instanceDir;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+    }
+    buildCommand(config) {
+        const settingsPath = join(this.instanceDir, "claude-settings.json");
+        const mcpConfigPath = join(this.instanceDir, "mcp-config.json");
+        // Forward Anthropic env vars to the CLI process (tmux shell doesn't inherit daemon's env)
+        const envPrefix = ["CMUX_CLAUDE_HOOKS_DISABLED=1", "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1"];
+        for (const key of ["ANTHROPIC_BASE_URL", "ANTHROPIC_API_KEY"]) {
+            if (process.env[key])
+                envPrefix.push(`${key}=${process.env[key]}`);
+        }
+        let cmd = `${envPrefix.join(" ")} claude --settings ${settingsPath} --mcp-config ${mcpConfigPath} --dangerously-skip-permissions`;
+        const sessionIdFile = join(this.instanceDir, "session-id");
+        if (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 ${config.model}`;
+        }
+        if (config.systemPrompt) {
+            const promptPath = join(this.instanceDir, "system-prompt.md");
+            writeFileSync(promptPath, config.systemPrompt);
+            cmd += ` --system-prompt "${promptPath}"`;
+        }
+        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);
+    }
+    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;
+        }
+    }
+    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));
+        }
+    }
+    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,10 @@
+import type { CliBackend, CliBackendConfig } from "./types.js";
+export declare class CodexBackend implements CliBackend {
+    private instanceDir;
+    constructor(instanceDir: string);
+    buildCommand(config: CliBackendConfig): string;
+    writeConfig(config: CliBackendConfig): void;
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    cleanup(config: CliBackendConfig): void;
+}

package/dist/backend/codex.js

@@ -0,0 +1,58 @@
+import { join } from "node:path";
+import { readFileSync, writeFileSync } from "node:fs";
+export class CodexBackend {
+    instanceDir;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+    }
+    buildCommand(config) {
+        let cmd = "codex --full-auto";
+        if (config.model) {
+            cmd += ` -c model="${config.model}"`;
+        }
+        if (config.systemPrompt) {
+            const promptPath = join(this.instanceDir, "system-prompt.md");
+            writeFileSync(promptPath, config.systemPrompt);
+            cmd += ` --system-prompt-file "${promptPath}"`;
+        }
+        return cmd;
+    }
+    writeConfig(config) {
+        // Codex uses codex mcp add (global config), write a setup script
+        // that registers MCP servers on first launch
+        const setupScript = Object.entries(config.mcpServers).map(([name, entry]) => {
+            const args = entry.args.map(a => `"${a}"`).join(" ");
+            const envFlags = Object.entries(entry.env || {}).map(([k, v]) => `-e ${k}="${v}"`).join(" ");
+            return `codex mcp add ${name} ${entry.command} ${args} ${envFlags} 2>/dev/null || true`;
+        }).join("\n");
+        writeFileSync(join(this.instanceDir, "setup-mcp.sh"), setupScript, { mode: 0o755 });
+        // Run setup immediately
+        const { execSync } = require("node:child_process");
+        try {
+            execSync(`bash ${join(this.instanceDir, "setup-mcp.sh")}`, { stdio: "ignore" });
+        }
+        catch { /* best effort */ }
+    }
+    getContextUsage() {
+        return null;
+    }
+    getSessionId() {
+        try {
+            const f = join(this.instanceDir, "session-id");
+            return readFileSync(f, "utf-8").trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    cleanup(config) {
+        const { execSync } = require("node:child_process");
+        for (const name of Object.keys(config.mcpServers)) {
+            try {
+                execSync(`codex mcp remove ${name}`, { stdio: "ignore" });
+            }
+            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,19 @@
+import { ClaudeCodeBackend } from "./claude-code.js";
+import { GeminiCliBackend } from "./gemini-cli.js";
+import { CodexBackend } from "./codex.js";
+import { OpenCodeBackend } from "./opencode.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);
+        default:
+            throw new Error(`Unknown backend: ${name}. Available: claude-code, gemini-cli, codex, opencode`);
+    }
+}
+//# 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;AAEhD,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;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,uDAAuD,CAAC,CAAC;IACrG,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { CliBackend, CliBackendConfig } from "./types.js";
+export declare class GeminiCliBackend implements CliBackend {
+    private instanceDir;
+    constructor(instanceDir: string);
+    buildCommand(config: CliBackendConfig): string;
+    writeConfig(config: CliBackendConfig): void;
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    cleanup(config: CliBackendConfig): void;
+}

package/dist/backend/gemini-cli.js

@@ -0,0 +1,68 @@
+import { join } from "node:path";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+export class GeminiCliBackend {
+    instanceDir;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+    }
+    buildCommand(config) {
+        let cmd = "gemini --yolo";
+        const sessionIdFile = join(this.instanceDir, "session-id");
+        if (existsSync(sessionIdFile)) {
+            const sid = readFileSync(sessionIdFile, "utf-8").trim();
+            if (sid)
+                cmd += ` --resume ${sid}`;
+        }
+        if (config.model) {
+            cmd += ` --model ${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 */ }
+        settings.mcpServers = config.mcpServers;
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+        // System prompt via GEMINI.md
+        if (config.systemPrompt) {
+            writeFileSync(join(geminiDir, "GEMINI.md"), config.systemPrompt);
+        }
+    }
+    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;
+        }
+    }
+    cleanup(config) {
+        // Clean up .gemini/settings.json MCP entries
+        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];
+                    }
+                    writeFileSync(settingsPath, JSON.stringify(settings, 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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAG7E,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAE3C,YAAY,CAAC,MAAwB;QACnC,IAAI,GAAG,GAAG,eAAe,CAAC;QAE1B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAC3D,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YACxD,IAAI,GAAG;gBAAE,GAAG,IAAI,aAAa,GAAG,EAAE,CAAC;QACrC,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,GAAG,IAAI,YAAY,MAAM,CAAC,KAAK,EAAE,CAAC;QACpC,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,WAAW,CAAC,MAAwB;QAClC,oDAAoD;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;QAC3D,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QACtD,IAAI,QAAQ,GAA4B,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QAE1B,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACxC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE/D,8BAA8B;QAC9B,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAED,eAAe;QACb,qDAAqD;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY;QACV,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAC/C,OAAO,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,MAAwB;QAC9B,6CAA6C;QAC7C,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;YAC/E,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;gBACjE,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;oBACxB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;wBAClD,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;oBACnC,CAAC;oBACD,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/backend/index.d.ts

@@ -0,0 +1,6 @@
+export type { CliBackend, CliBackendConfig, McpServerEntry } 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 { createBackend } from "./factory.js";

package/dist/backend/index.js

@@ -0,0 +1,6 @@
+export { ClaudeCodeBackend } from "./claude-code.js";
+export { GeminiCliBackend } from "./gemini-cli.js";
+export { CodexBackend } from "./codex.js";
+export { OpenCodeBackend } from "./opencode.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,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/backend/opencode.d.ts

@@ -0,0 +1,10 @@
+import type { CliBackend, CliBackendConfig } from "./types.js";
+export declare class OpenCodeBackend implements CliBackend {
+    private instanceDir;
+    constructor(instanceDir: string);
+    buildCommand(_config: CliBackendConfig): string;
+    writeConfig(config: CliBackendConfig): void;
+    getContextUsage(): number | null;
+    getSessionId(): string | null;
+    cleanup(config: CliBackendConfig): void;
+}

package/dist/backend/opencode.js

@@ -0,0 +1,63 @@
+import { join } from "node:path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+export class OpenCodeBackend {
+    instanceDir;
+    constructor(instanceDir) {
+        this.instanceDir = instanceDir;
+    }
+    buildCommand(_config) {
+        return "opencode";
+    }
+    writeConfig(config) {
+        // OpenCode uses opencode.json in the working directory
+        const configPath = join(config.workingDirectory, "opencode.json");
+        let oc = {};
+        try {
+            oc = JSON.parse(readFileSync(configPath, "utf-8"));
+        }
+        catch { /* new file */ }
+        // MCP servers
+        oc.mcp = {};
+        for (const [name, entry] of Object.entries(config.mcpServers)) {
+            oc.mcp[name] = {
+                type: "local",
+                command: [entry.command, ...entry.args],
+                env: entry.env,
+            };
+        }
+        // System prompt via instructions
+        if (config.systemPrompt) {
+            oc.instructions = config.systemPrompt;
+        }
+        writeFileSync(configPath, JSON.stringify(oc, null, 2));
+    }
+    getContextUsage() {
+        return null;
+    }
+    getSessionId() {
+        try {
+            const f = join(this.instanceDir, "session-id");
+            return readFileSync(f, "utf-8").trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    cleanup(config) {
+        // Clean up opencode.json MCP entries
+        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)) {
+                        delete oc.mcp[name];
+                    }
+                    writeFileSync(configPath, JSON.stringify(oc, null, 2));
+                }
+            }
+        }
+        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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGlE,MAAM,OAAO,eAAe;IACN;IAApB,YAAoB,WAAmB;QAAnB,gBAAW,GAAX,WAAW,CAAQ;IAAG,CAAC;IAE3C,YAAY,CAAC,OAAyB;QACpC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,WAAW,CAAC,MAAwB;QAClC,uDAAuD;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;QAClE,IAAI,EAAE,GAA4B,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QAE1B,cAAc;QACd,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7D,EAAE,CAAC,GAA+B,CAAC,IAAI,CAAC,GAAG;gBAC1C,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;gBACvC,GAAG,EAAE,KAAK,CAAC,GAAG;aACf,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,EAAE,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,CAAC;QAED,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY;QACV,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAC/C,OAAO,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,MAAwB;QAC9B,qCAAqC;QACrC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;YAClE,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBACzD,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;oBACX,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;wBAClD,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBACtB,CAAC;oBACD,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/backend/types.d.ts

@@ -0,0 +1,26 @@
+export interface McpServerEntry {
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+}
+export interface CliBackendConfig {
+    workingDirectory: string;
+    instanceDir: string;
+    instanceName: string;
+    mcpServers: Record<string, McpServerEntry>;
+    systemPrompt?: string;
+    skipPermissions?: boolean;
+    model?: string;
+}
+export interface CliBackend {
+    /** 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;
+    /** Clean up config files on shutdown. */
+    cleanup?(config: CliBackendConfig): void;
+}

package/dist/backend/types.js

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}