agents-bridge 0.1.0

package/.env.example

@@ -0,0 +1,20 @@
+# .env.example — agent-bridge 环境变量
+#
+# 环境变量可覆盖 config.json 中的对应值
+
+# 配置文件路径（默认按搜索顺序：~/.agent-bridge/config.json → ./config.json）
+# AGENT_BRIDGE_CONFIG=./config.json
+
+# Botlink 连接（覆盖 channels.botlink）
+# AGENT_BRIDGE_GATEWAY_URL=https://your-botlink-instance.com
+# AGENT_BRIDGE_BOT_TOKEN=bot_xxxxxxxxxxxxxxxxxx
+
+# 日志级别（覆盖 logging.level）
+# AGENT_BRIDGE_LOG_LEVEL=info
+
+# 临时文件目录（覆盖 files.temp_dir）
+# AGENT_BRIDGE_TEMP_DIR=/tmp/agent-bridge/files
+
+# LLM API Keys（用于 Pi Agent 模式）
+# ANTHROPIC_API_KEY=sk-ant-xxx
+# OPENAI_API_KEY=sk-xxx

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,259 @@
+# agents-bridge
+
+本地 Agent 网关，部署在客户本地机器上，通过长轮询连接云端 botlink 平台，驱动本地的 Claude Code / Codex 等 AI Agent。
+
+## 架构概览
+
+```
+botlink 云端                             客户本地
+┌──────────────────────┐        ┌──────────────────────────┐
+│  botlink-web         │        │  agents-bridge           │
+│  client-gateway      │        │                          │
+│  bot-gateway ◄───────┼── HTTP │  botlink channel         │
+│  message-svc         │  长轮询│    ↕                     │
+│  routing-svc         │        │  Agent Runtime           │
+└──────────────────────┘        │    ├─ Claude Code (CLI)  │
+                                │    ├─ Codex (CLI)        │
+                                │    └─ Pi Agent (API)     │
+                                └──────────────────────────┘
+```
+
+agents-bridge 始终作为客户端主动外连云端，客户无需暴露任何端口。
+
+## 快速开始
+
+### 方式 A：npm 全局安装（推荐）
+
+```bash
+npm install -g agents-bridge@latest
+
+# 交互式引导：输入 gateway URL、bot token、选择模型，自动生成配置
+agents-bridge onboard
+
+# 启动
+agents-bridge start
+```
+
+### 方式 B：Docker
+
+```bash
+docker run -d --name agents-bridge \
+  -v /home/user/project:/workspace \
+  -v agents-bridge-data:/root/.agent-bridge \
+  -e AGENT_BRIDGE_GATEWAY_URL=https://your-botlink.com \
+  -e AGENT_BRIDGE_BOT_TOKEN=bot_xxx \
+  -e ANTHROPIC_API_KEY=sk-ant-xxx \
+  agents-bridge:latest
+```
+
+或使用 docker-compose：
+
+```bash
+cp .env.example .env
+# 编辑 .env 填入实际值
+docker compose up -d
+```
+
+### 方式 C：源码运行（开发者）
+
+```bash
+git clone <repo-url>
+cd <repo-dir>
+pnpm install
+pnpm build
+cp config.example.json config.json   # 编辑配置
+node dist/entry.js start
+```
+
+开发模式（自动重载）：
+
+```bash
+pnpm dev
+```
+
+## CLI 命令
+
+```bash
+agents-bridge start                # 启动 gateway（前台）
+agents-bridge start --daemon       # 启动为后台守护进程
+agents-bridge start -c <path>      # 指定配置文件启动
+agents-bridge stop                 # 停止守护进程
+agents-bridge status               # 查看运行状态
+agents-bridge onboard              # 交互式初始化引导
+agents-bridge doctor               # 诊断环境（Node.js、CLI 工具、API Key）
+agents-bridge logs                 # 查看日志
+agents-bridge config               # 查看当前配置（脱敏显示）
+agents-bridge help                 # 帮助
+```
+
+## 配置
+
+### 配置文件
+
+主配置文件为 JSON 格式，搜索顺序：
+
+1. CLI 参数：`agents-bridge start -c /path/to/config.json`
+2. 环境变量：`AGENT_BRIDGE_CONFIG=/path/to/config.json`
+3. 用户目录：`~/.agent-bridge/config.json`
+4. 当前目录：`./config.json`
+
+完整示例见 [config.example.json](config.example.json)。
+
+### 核心配置项
+
+```json
+{
+  "channels": {
+    "botlink": {
+      "gateway_url": "https://your-botlink-instance.com",
+      "bot_token": "bot_xxxxxxxxxxxxxxxxxx",
+      "poll_timeout": 30,
+      "retry_interval": 5,
+      "max_retry_interval": 60
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": {
+        "primary": "claude-cli/opus-4.6",
+        "fallbacks": ["anthropic/claude-sonnet-4-6"]
+      },
+      "cliBackends": {
+        "claude-cli": {
+          "command": "claude",
+          "args": ["-p", "--output-format", "json", "--dangerously-skip-permissions"],
+          "resumeArgs": ["-p", "--output-format", "json", "--dangerously-skip-permissions", "--resume", "{sessionId}"],
+          "output": "json",
+          "modelArg": "--model",
+          "sessionArg": "--session-id",
+          "sessionIdFields": ["session_id", "sessionId", "conversation_id", "conversationId"],
+          "sessionMode": "always",
+          "serialize": true
+        },
+        "codex-cli": {
+          "command": "codex",
+          "args": ["exec", "--json", "..."],
+          "resumeArgs": ["exec", "resume", "{sessionId}", "..."],
+          "sessionMode": "existing",
+          "output": "jsonl",
+          "resumeOutput": "text",
+          "modelArg": "--model",
+          "sessionIdFields": ["thread_id"],
+          "serialize": true
+        }
+      }
+    }
+  },
+  "logging": {
+    "level": "info"
+  }
+}
+```
+
+### 环境变量覆盖
+
+环境变量可覆盖配置文件中的对应值：
+
+| 环境变量 | 覆盖 | 说明 |
+|---|---|---|
+| `AGENT_BRIDGE_CONFIG` | — | 配置文件路径 |
+| `AGENT_BRIDGE_GATEWAY_URL` | `channels.botlink.gateway_url` | botlink 网关地址 |
+| `AGENT_BRIDGE_BOT_TOKEN` | `channels.botlink.bot_token` | Bot Token |
+| `AGENT_BRIDGE_LOG_LEVEL` | `logging.level` | 日志级别 |
+| `AGENT_BRIDGE_TEMP_DIR` | `files.temp_dir` | 临时文件目录 |
+
+## 数据目录
+
+```
+~/.agent-bridge/
+├── config.json                # 主配置（onboard 生成）
+├── agent-bridge.pid           # PID 文件（daemon 模式）
+├── data/
+│   ├── sessions/              # Agent 会话持久化
+│   │   └── cli-sessions.json  # botlink session -> CLI session id 映射
+│   ├── files/                 # 文件中转临时目录
+│   └── logs/                  # 日志文件
+└── skills/                    # 自定义技能
+```
+
+## 项目结构
+
+```
+agents-bridge/
+├── bin/
+│   └── agent-bridge.mjs       # CLI 入口（npm 全局安装）
+├── src/
+│   ├── entry.ts               # 主入口，子命令路由
+│   ├── cli/                   # CLI 命令实现
+│   │   ├── run-main.ts        #   参数解析
+│   │   ├── cmd-start.ts       #   start 命令
+│   │   ├── cmd-stop.ts        #   stop 命令
+│   │   ├── cmd-status.ts      #   status 命令
+│   │   ├── cmd-onboard.ts     #   onboard 交互引导
+│   │   ├── cmd-doctor.ts      #   doctor 环境诊断
+│   │   ├── cmd-logs.ts        #   logs 查看
+│   │   └── cmd-config.ts      #   config 查看
+│   ├── config/                # 配置加载与校验
+│   │   ├── config.ts          #   主加载器
+│   │   ├── zod-schema.ts      #   Zod schema
+│   │   ├── paths.ts           #   数据目录路径常量
+│   │   ├── env-vars.ts        #   环境变量读取
+│   │   ├── merge-config.ts    #   配置合并
+│   │   └── agent-dirs.ts      #   目录初始化
+│   ├── channels/              # Channel 插件框架
+│   │   ├── registry.ts        #   插件注册表
+│   │   ├── session.ts         #   会话管理
+│   │   └── ...
+│   ├── agents/                # Agent 运行时
+│   │   ├── cli-backends.ts    #   CLI backend provider id / 默认配置装配
+│   │   ├── cli-session-store.ts # CLI session 映射持久化
+│   │   ├── cli-runner.ts      #   Claude/Codex CLI 执行器
+│   │   └── ...
+│   ├── types/                 # 类型定义
+│   └── logger.ts              # Pino 日志
+├── extensions/                # Channel 插件（botlink）
+├── skills/                    # 技能定义
+├── config.example.json        # 配置示例
+├── .env.example               # 环境变量示例
+├── Dockerfile
+├── docker-compose.yml
+├── package.json
+└── tsconfig.json
+```
+
+## 三种 Agent 模式
+
+| 模式 | 模型引用示例 | 说明 |
+|---|---|---|
+| Claude Code | `claude-cli/opus-4.6` | 通过 CLI backend 启动本地 `claude` 命令 |
+| Codex | `codex-cli/gpt-5.3-codex` | 通过 CLI backend 启动本地 `codex` 命令 |
+| Pi Agent | `anthropic/claude-sonnet-4-6` | 通过 LLM API 直连，内置工具执行 |
+
+在 `config.json` 的 `agents.defaults.model.primary` 中选择。
+
+## CLI Backend 约定
+
+- 内置 provider id 固定为 `claude-cli`、`codex-cli`。
+- `agents.defaults.cliBackends` 会覆盖内置默认值，不需要重复写全量字段。
+- `SessionEnvelope.sessionId` 是 botlink 稳定会话键，不等于 Claude/Codex 自己的 session id。
+- CLI backend session id 会持久化到 `~/.agent-bridge/data/sessions/cli-sessions.json` 的 `cliSessionIds[providerId]`。
+- `serialize: true` 的语义是“同一 botlink session 串行、跨 session 可并发”。
+- Claude CLI 走 JSON 输出；Codex CLI 首次运行走 JSONL，resume 走 text。
+
+## 技术栈
+
+- TypeScript + Node.js (>= 22.0.0)
+- pnpm (>= 9.0.0)
+- Pino（日志）
+- Zod（配置校验）
+- JSON（配置格式）
+
+## 开发
+
+```bash
+pnpm install          # 安装依赖
+pnpm build            # 编译
+pnpm dev              # 开发模式（自动重载）
+pnpm typecheck        # 类型检查
+```
+

package/bin/agent-bridge.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+// agents-bridge CLI entry point
+// Used by: npm install -g agents-bridge / npx agents-bridge
+
+import { fileURLToPath } from 'node:url'
+import { dirname, resolve } from 'node:path'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+// Import the compiled entry point
+await import(resolve(__dirname, '..', 'dist', 'entry.js'))

package/config.example.json

@@ -0,0 +1,117 @@
+{
+  "channels": {
+    "botlink": {
+      "gateway_url": "https://test.51yzt.cn",
+      "bot_token": "bot_WEMU0m9NVxwOQIMVaNYskiSDTK-_1hA7dcCrQCzoxcU",
+      "poll_timeout": 30,
+      "retry_interval": 5,
+      "max_retry_interval": 60
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": {
+        "primary": "claude-cli/opus-4.6",
+        "fallbacks": [
+          "anthropic/claude-sonnet-4-6"
+        ]
+      },
+      "cliBackends": {
+        "claude-cli": {
+          "command": "claude",
+          "args": [
+            "-p",
+            "--output-format",
+            "json",
+            "--dangerously-skip-permissions"
+          ],
+          "resumeArgs": [
+            "-p",
+            "--output-format",
+            "json",
+            "--dangerously-skip-permissions",
+            "--resume",
+            "{sessionId}"
+          ],
+          "output": "json",
+          "modelArg": "--model",
+          "sessionArg": "--session-id",
+          "sessionIdFields": [
+            "session_id",
+            "sessionId",
+            "conversation_id",
+            "conversationId"
+          ],
+          "systemPromptArg": "--append-system-prompt",
+          "systemPromptMode": "append",
+          "systemPromptWhen": "first",
+          "clearEnv": [
+            "ANTHROPIC_API_KEY",
+            "ANTHROPIC_API_KEY_OLD"
+          ],
+          "sessionMode": "always",
+          "serialize": true,
+          "reliability": {
+            "watchdog": {
+              "fresh": {
+                "noOutputTimeoutRatio": 0.8,
+                "minMs": 180000,
+                "maxMs": 600000
+              },
+              "resume": {
+                "noOutputTimeoutRatio": 0.3,
+                "minMs": 60000,
+                "maxMs": 180000
+              }
+            }
+          }
+        },
+        "codex-cli": {
+          "command": "codex",
+          "args": [
+            "exec", "--json", "--color", "never",
+            "--sandbox", "read-only", "--skip-git-repo-check"
+          ],
+          "resumeArgs": [
+            "exec", "resume", "{sessionId}", "--color", "never",
+            "--sandbox", "read-only", "--skip-git-repo-check"
+          ],
+          "output": "jsonl",
+          "resumeOutput": "text",
+          "modelArg": "--model",
+          "sessionIdFields": [
+            "thread_id"
+          ],
+          "imageArg": "--image",
+          "imageMode": "repeat",
+          "sessionMode": "existing",
+          "serialize": true,
+          "reliability": {
+            "watchdog": {
+              "fresh": {
+                "noOutputTimeoutRatio": 0.8,
+                "minMs": 180000,
+                "maxMs": 600000
+              },
+              "resume": {
+                "noOutputTimeoutRatio": 0.3,
+                "minMs": 60000,
+                "maxMs": 180000
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "skills": {
+    "dirs": ["./skills"]
+  },
+  "files": {
+    "temp_dir": "/tmp/agent-bridge/files",
+    "max_file_size": 52428800
+  },
+  "logging": {
+    "level": "info"
+  }
+}

package/dist/agents/cli-backends.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CLI Backend 装配 — 复用现有 cliBackends 机制
+ *
+ * 根据 agents.defaults.model 中的 provider 前缀（如 "claude-cli"、"codex-cli"），
+ * 从 agents.defaults.cliBackends 中查找对应配置，启动本地 CLI 命令。
+ *
+ * 首版不做 token 级流式，而是：
+ * - 运行期间周期性发 sendChatAction(typing)
+ * - 完成后一次性发送最终文本消息
+ *
+ * TODO: Phase 3 实现
+ */
+import type { CliBackendConfig } from '../types/index.js';
+/**
+ * 从 model reference 中提取 provider 名称
+ * e.g. "claude-cli/opus-4.6" → "claude-cli"
+ */
+export declare function extractProvider(modelRef: string): string;
+/**
+ * 从 model reference 中提取 model 名称
+ * e.g. "claude-cli/opus-4.6" → "opus-4.6"
+ */
+export declare function extractModel(modelRef: string): string;
+/**
+ * 判断 model reference 是否指向 CLI backend
+ */
+export declare function isCliBackend(modelRef: string): boolean;
+/**
+ * 根据 model reference 查找对应的 CLI backend 配置
+ */
+export declare function resolveCliBackend(modelRef: string, backends: Record<string, CliBackendConfig> | undefined): CliBackendConfig | undefined;
+//# sourceMappingURL=cli-backends.d.ts.map

package/dist/agents/cli-backends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-backends.d.ts","sourceRoot":"","sources":["../../src/agents/cli-backends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAwBD,eAAO,MAAM,2BAA2B,OAAQ,CAAA;AAEhD,eAAO,MAAM,2BAA2B;;;;CAI9B,CAAA;AAEV,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAA;AAkGV,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAkBD,wBAAgB,oBAAoB,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAOjF;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC1C,OAAO,CAYT;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAC9B,kBAAkB,GAAG,IAAI,CA6B3B;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,SAAS,GACrD,gBAAgB,GAAG,SAAS,CAW9B"}

package/dist/agents/cli-backends.js

@@ -0,0 +1,217 @@
+const CLAUDE_MODEL_ALIASES = {
+    opus: 'opus',
+    'opus-4.6': 'opus',
+    'opus-4.5': 'opus',
+    'opus-4': 'opus',
+    'claude-opus-4-6': 'opus',
+    'claude-opus-4-5': 'opus',
+    'claude-opus-4': 'opus',
+    sonnet: 'sonnet',
+    'sonnet-4.6': 'sonnet',
+    'sonnet-4.5': 'sonnet',
+    'sonnet-4.1': 'sonnet',
+    'sonnet-4.0': 'sonnet',
+    'claude-sonnet-4-6': 'sonnet',
+    'claude-sonnet-4-5': 'sonnet',
+    'claude-sonnet-4-1': 'sonnet',
+    'claude-sonnet-4-0': 'sonnet',
+    haiku: 'haiku',
+    'haiku-3.5': 'haiku',
+    'claude-haiku-3-5': 'haiku',
+};
+export const CLI_WATCHDOG_MIN_TIMEOUT_MS = 1_000;
+export const CLI_FRESH_WATCHDOG_DEFAULTS = {
+    noOutputTimeoutRatio: 0.8,
+    minMs: 180_000,
+    maxMs: 600_000,
+};
+export const CLI_RESUME_WATCHDOG_DEFAULTS = {
+    noOutputTimeoutRatio: 0.3,
+    minMs: 60_000,
+    maxMs: 180_000,
+};
+const DEFAULT_CLAUDE_BACKEND = {
+    command: 'claude',
+    args: ['-p', '--verbose', '--output-format', 'stream-json', '--dangerously-skip-permissions'],
+    resumeArgs: [
+        '-p',
+        '--verbose',
+        '--output-format',
+        'stream-json',
+        '--dangerously-skip-permissions',
+        '--resume',
+        '{sessionId}',
+    ],
+    output: 'jsonl',
+    resumeOutput: 'jsonl',
+    input: 'arg',
+    modelArg: '--model',
+    modelAliases: CLAUDE_MODEL_ALIASES,
+    sessionArg: '--session-id',
+    sessionMode: 'always',
+    sessionIdFields: ['session_id', 'sessionId', 'conversation_id', 'conversationId'],
+    systemPromptArg: '--append-system-prompt',
+    systemPromptMode: 'append',
+    systemPromptWhen: 'first',
+    clearEnv: ['ANTHROPIC_API_KEY', 'ANTHROPIC_API_KEY_OLD'],
+    reliability: {
+        watchdog: {
+            fresh: { ...CLI_FRESH_WATCHDOG_DEFAULTS },
+            resume: { ...CLI_RESUME_WATCHDOG_DEFAULTS },
+        },
+    },
+    serialize: true,
+};
+const DEFAULT_CODEX_BACKEND = {
+    command: 'codex',
+    args: ['exec', '--json', '--color', 'never', '--sandbox', 'read-only', '--skip-git-repo-check'],
+    resumeArgs: [
+        'exec',
+        'resume',
+        '{sessionId}',
+        '--color',
+        'never',
+        '--sandbox',
+        'read-only',
+        '--skip-git-repo-check',
+    ],
+    output: 'jsonl',
+    resumeOutput: 'text',
+    input: 'arg',
+    modelArg: '--model',
+    sessionIdFields: ['thread_id'],
+    sessionMode: 'existing',
+    imageArg: '--image',
+    imageMode: 'repeat',
+    reliability: {
+        watchdog: {
+            fresh: { ...CLI_FRESH_WATCHDOG_DEFAULTS },
+            resume: { ...CLI_RESUME_WATCHDOG_DEFAULTS },
+        },
+    },
+    serialize: true,
+};
+function mergeBackendConfig(base, override) {
+    if (!override) {
+        return { ...base };
+    }
+    const baseFresh = base.reliability?.watchdog?.fresh ?? {};
+    const baseResume = base.reliability?.watchdog?.resume ?? {};
+    const overrideFresh = override.reliability?.watchdog?.fresh ?? {};
+    const overrideResume = override.reliability?.watchdog?.resume ?? {};
+    return {
+        ...base,
+        ...override,
+        args: override.args ?? base.args,
+        env: { ...base.env, ...override.env },
+        modelAliases: { ...base.modelAliases, ...override.modelAliases },
+        clearEnv: Array.from(new Set([...(base.clearEnv ?? []), ...(override.clearEnv ?? [])])),
+        sessionIdFields: override.sessionIdFields ?? base.sessionIdFields,
+        sessionArgs: override.sessionArgs ?? base.sessionArgs,
+        resumeArgs: override.resumeArgs ?? base.resumeArgs,
+        reliability: {
+            ...base.reliability,
+            ...override.reliability,
+            watchdog: {
+                ...base.reliability?.watchdog,
+                ...override.reliability?.watchdog,
+                fresh: { ...baseFresh, ...overrideFresh },
+                resume: { ...baseResume, ...overrideResume },
+            },
+        },
+    };
+}
+export function normalizeProviderId(provider) {
+    const normalized = provider.trim().toLowerCase().replaceAll('_', '-');
+    if (normalized === 'claude' ||
+        normalized === 'claude-cli' ||
+        normalized === 'claudecli') {
+        return 'claude-cli';
+    }
+    if (normalized === 'codex' ||
+        normalized === 'codex-cli' ||
+        normalized === 'codexcli') {
+        return 'codex-cli';
+    }
+    return normalized;
+}
+function normalizeBackendKey(key) {
+    return normalizeProviderId(key);
+}
+function pickBackendConfig(config, normalizedId) {
+    for (const [key, entry] of Object.entries(config)) {
+        if (normalizeBackendKey(key) === normalizedId) {
+            return entry;
+        }
+    }
+    return undefined;
+}
+export function resolveCliBackendIds(cfg) {
+    const ids = new Set(['claude-cli', 'codex-cli']);
+    const configured = cfg?.agents.defaults.cliBackends ?? {};
+    for (const key of Object.keys(configured)) {
+        ids.add(normalizeBackendKey(key));
+    }
+    return ids;
+}
+export function extractProvider(modelRef) {
+    const slashIdx = modelRef.indexOf('/');
+    return normalizeProviderId(slashIdx === -1 ? modelRef : modelRef.slice(0, slashIdx));
+}
+export function extractModel(modelRef) {
+    const slashIdx = modelRef.indexOf('/');
+    return slashIdx === -1 ? '' : modelRef.slice(slashIdx + 1);
+}
+export function isCliBackend(modelRef, backends) {
+    const provider = extractProvider(modelRef);
+    if (provider === 'claude-cli' || provider === 'codex-cli') {
+        return true;
+    }
+    if (provider.endsWith('-cli')) {
+        return true;
+    }
+    if (!backends) {
+        return false;
+    }
+    return Object.keys(backends).some((key) => normalizeBackendKey(key) === provider);
+}
+export function resolveCliBackendConfig(provider, cfg) {
+    const normalized = normalizeBackendKey(provider);
+    const configured = cfg?.agents.defaults.cliBackends ?? {};
+    const override = pickBackendConfig(configured, normalized);
+    if (normalized === 'claude-cli') {
+        const merged = mergeBackendConfig(DEFAULT_CLAUDE_BACKEND, override);
+        const command = merged.command.trim();
+        if (!command)
+            return null;
+        return { id: normalized, config: { ...merged, command } };
+    }
+    if (normalized === 'codex-cli') {
+        const merged = mergeBackendConfig(DEFAULT_CODEX_BACKEND, override);
+        const command = merged.command.trim();
+        if (!command)
+            return null;
+        return { id: normalized, config: { ...merged, command } };
+    }
+    if (!override) {
+        return null;
+    }
+    const command = override.command.trim();
+    if (!command) {
+        return null;
+    }
+    return { id: normalized, config: { ...override, command } };
+}
+export function resolveCliBackend(modelRef, backends) {
+    if (!backends) {
+        return undefined;
+    }
+    const provider = extractProvider(modelRef);
+    for (const [key, config] of Object.entries(backends)) {
+        if (normalizeBackendKey(key) === provider) {
+            return config;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=cli-backends.js.map