@agentdock/wire 0.0.1

package/README.md

@@ -0,0 +1,152 @@
+# @agentdock/wire
+
+> 协议定义层 — 系统的「宪法」。所有组件通过这里定义的格式通信。
+
+## 概述
+
+wire 是 AgentDock monorepo 的最底层包，**零运行时依赖**（仅 Zod + cuid2）。它定义了：
+
+- 会话事件（agent 产生的文本、工具调用、文件变更等）
+- 信封（给事件加上 id/时间戳/角色/turn 等元数据）
+- 消息格式（加密后的消息结构）
+- RPC 方法（客户端与服务端的远程调用协议）
+- 同步协议（增量更新、版本控制、冲突解决）
+- 元数据（权限模式、CLI 类型、控制深度等级）
+
+所有 schema 使用 Zod 定义，提供**编译时类型推断 + 运行时验证**双重保障。
+
+## 在架构中的位置
+
+```
+wire ← crypto ← sdk ← web
+wire ← server
+wire ← crypto ← daemon
+```
+
+wire 被所有其他包依赖，是唯一的零依赖底层包。
+
+## 模块结构
+
+```
+src/
+├── events.ts          # 12 种会话事件 schema（text/service/tool-call/file/turn/start/stop/question/permission/answer）
+├── interactionEvents.ts # 交互事件（question/permission-request/answer）
+├── envelope.ts        # SessionEnvelope — 事件 + 元数据封装（superRefine 交叉约束）
+├── messages.ts        # SessionMessage — 加密消息格式 + SessionProtocolMessage
+├── messageMeta.ts     # MessageMeta — 权限模式、CLI 类型、代价等元数据
+├── rpc.ts             # RPC 方法/参数/返回值 schema（daemon ↔ server ↔ client）
+├── sync.ts            # CoreUpdate — 增量同步协议 + VersionedEncryptedValue
+├── legacyProtocol.ts  # 旧版协议兼容（SessionProtocolMessage 转换）
+├── controlLevel.ts    # ControlLevel 枚举（L0-L3 控制深度）+ CLI 类型定义
+├── pairing.ts         # 设备配对协议 schema（PairingRequest/Response/Status）
+├── utils.ts           # createId (cuid2)、Unix 时间戳工具
+└── index.ts           # Barrel exports
+```
+
+## API 参考
+
+### 会话事件 (events.ts)
+
+12 种事件类型，通过 `t` 字段的 discriminated union 区分：
+
+| 事件          | `t` 值               | 关键字段                                         | 说明                              |
+| ------------- | -------------------- | ------------------------------------------------ | --------------------------------- |
+| Text          | `text`               | `text`, `thinking?`                              | AI 输出文本（含思考模式标记）     |
+| Service       | `service`            | `text`                                           | 系统服务消息                      |
+| ToolCallStart | `tool-call-start`    | `call`, `name`, `title`, `description`, `args`   | 工具调用开始                      |
+| ToolCallEnd   | `tool-call-end`      | `call`                                           | 工具调用结束                      |
+| File          | `file`               | `ref`, `name`, `size`, `image?`                  | 文件变更                          |
+| TurnStart     | `turn-start`         | —                                                | 对话轮次开始                      |
+| TurnEnd       | `turn-end`           | `status: completed\|failed\|cancelled`, `usage?` | 对话轮次结束（含可选 token 用量） |
+| Start         | `start`              | `title?`                                         | 会话开始                          |
+| Stop          | `stop`               | —                                                | 会话结束                          |
+| Question      | `question`           | `requestId`, `text`, `questionType?`             | Agent 向用户提问                  |
+| PermRequest   | `permission-request` | `requestId`, `toolName`, `toolCallId`, `args`    | 工具权限请求                      |
+| Answer        | `answer`             | `requestId`, `text`                              | 用户回答                          |
+
+```typescript
+import { SessionEventSchema } from '@agentdock/wire';
+
+const result = SessionEventSchema.safeParse({
+  t: 'text',
+  text: 'Hello world',
+  thinking: false,
+});
+// result.success === true
+```
+
+### 信封 (envelope.ts)
+
+`SessionEnvelope` 将事件包装为可传输的完整消息单元：
+
+```typescript
+import { createEnvelope } from '@agentdock/wire';
+
+const envelope = createEnvelope(
+  'agent',
+  { t: 'text', text: 'Hello' },
+  {
+    turn: 'turn-001',
+    // id 和 time 自动生成
+  },
+);
+// { id: 'cuid2...', time: 1709..., role: 'agent', turn: 'turn-001', ev: { t: 'text', text: 'Hello' } }
+```
+
+**superRefine 约束**：`service`/`start`/`stop` 事件的 `role` 必须为 `'agent'`。
+
+### 消息 (messages.ts)
+
+```typescript
+import type { SessionMessage } from '@agentdock/wire';
+
+// SessionMessage = 加密后的消息格式
+// content: { c: string (密文), n: string (nonce) }
+// createdAt / updatedAt: Unix timestamp (number)
+```
+
+### RPC (rpc.ts)
+
+定义 daemon ↔ server ↔ client 之间的远程调用方法：
+
+```typescript
+import { RpcMethodSchema } from '@agentdock/wire';
+// 包含方法名、参数 schema、返回值 schema
+```
+
+### 同步协议 (sync.ts)
+
+```typescript
+import type { CoreUpdate } from '@agentdock/wire';
+// CoreUpdate: 增量更新载体
+// VersionedEncryptedValue: 带版本号的加密值（乐观锁）
+```
+
+### 控制深度 (controlLevel.ts)
+
+```typescript
+import { ControlLevelSchema, CliTypeSchema } from '@agentdock/wire';
+
+// ControlLevel: 0(最低) | 1(仅监控) | 2(高控制) | 3(完全控制)
+// CliType: 'claude' | 'copilot' | 'opencode' | 'codex' | 'gemini' | 'qwen'
+```
+
+## 开发
+
+```bash
+# 运行测试（300 tests）
+pnpm --filter @agentdock/wire test
+
+# 覆盖率（目标 95%+）
+pnpm --filter @agentdock/wire test:coverage
+
+# 类型检查
+pnpm --filter @agentdock/wire typecheck
+```
+
+## 设计决策
+
+- **字段名对齐 Happy**：`call`/`name`/`args`（非 `toolId`/`toolName`/`params`），确保协议兼容
+- **cuid2 作为 ID**：`subagent` 字段用 cuid2 验证，`id` 用 `createId()` 生成
+- **Unix number 时间戳**：`time`/`createdAt`/`updatedAt` 都是 Unix 毫秒数，非 ISO string
+- **discriminated union**：`SessionEventSchema` 用 `t` 字段做类型判别，而非 `type`

package/dist/agentCapabilities.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Agent capability matrix — static mapping of which features each CLI agent supports.
+ *
+ * Web UI uses this to conditionally show/hide spawn parameters
+ * (model, systemPrompt, tools, permissions, etc.) based on the selected agent.
+ *
+ * Model options live in agentModels.ts (separate concern).
+ */
+import type { ControlLevelType } from './controlLevel.js';
+export interface AgentPermissionMode {
+    readonly value: string;
+    readonly labelKey: string;
+}
+export interface AgentCapability {
+    readonly controlLevel: ControlLevelType;
+    readonly supportsModel: boolean;
+    readonly supportsSystemPrompt: boolean;
+    readonly supportsToolConfig: boolean;
+    readonly supportsMcpConfig: boolean;
+    readonly supportsPermissionMode: boolean;
+    readonly supportsResume: boolean;
+    readonly supportsMaxTurns: boolean;
+    readonly supportsSlashClear: boolean;
+    /** Permission modes available for this agent. Empty = no selector. */
+    readonly permissionModes: readonly AgentPermissionMode[];
+}
+export declare const AGENT_CAPABILITIES: Readonly<Record<string, AgentCapability>>;
+/** Get capability for an agent, falling back to minimal (Level 0) for unknown agents. */
+export declare function getAgentCapability(agentType: string): AgentCapability;
+//# sourceMappingURL=agentCapabilities.d.ts.map

package/dist/agentCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentCapabilities.d.ts","sourceRoot":"","sources":["../src/agentCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC1D;AAwBD,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CA6D/D,CAAC;AAEX,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAerE"}

package/dist/agentCapabilities.js

@@ -0,0 +1,103 @@
+/**
+ * Agent capability matrix — static mapping of which features each CLI agent supports.
+ *
+ * Web UI uses this to conditionally show/hide spawn parameters
+ * (model, systemPrompt, tools, permissions, etc.) based on the selected agent.
+ *
+ * Model options live in agentModels.ts (separate concern).
+ */
+// ── Per-agent permission modes ──────────────────────────────────────
+const CLAUDE_PERMISSION_MODES = [
+    { value: 'default', labelKey: 'permissionDefault' },
+    { value: 'acceptEdits', labelKey: 'permissionAutoEdit' },
+    { value: 'plan', labelKey: 'permissionPlan' },
+    { value: 'bypassPermissions', labelKey: 'permissionFullAuto' },
+];
+const COPILOT_PERMISSION_MODES = [
+    { value: 'default', labelKey: 'permissionDefault' },
+    { value: 'plan', labelKey: 'permissionPlan' },
+    { value: 'bypassPermissions', labelKey: 'permissionFullAuto' },
+];
+const CODEX_PERMISSION_MODES = [
+    { value: 'default', labelKey: 'permissionDefault' },
+    { value: 'bypassPermissions', labelKey: 'permissionFullAuto' },
+];
+// ── Capability matrix ───────────────────────────────────────────────
+export const AGENT_CAPABILITIES = {
+    claude: {
+        controlLevel: 3,
+        supportsModel: true,
+        supportsSystemPrompt: true,
+        supportsToolConfig: true,
+        supportsMcpConfig: true,
+        supportsPermissionMode: true,
+        supportsResume: true,
+        supportsMaxTurns: true,
+        supportsSlashClear: true,
+        permissionModes: CLAUDE_PERMISSION_MODES,
+    },
+    copilot: {
+        controlLevel: 3,
+        supportsModel: true,
+        supportsSystemPrompt: false,
+        supportsToolConfig: true,
+        supportsMcpConfig: true,
+        supportsPermissionMode: true,
+        supportsResume: true,
+        supportsMaxTurns: false,
+        supportsSlashClear: false,
+        permissionModes: COPILOT_PERMISSION_MODES,
+    },
+    opencode: {
+        controlLevel: 3,
+        supportsModel: true,
+        supportsSystemPrompt: true,
+        supportsToolConfig: true,
+        supportsMcpConfig: true,
+        supportsPermissionMode: true,
+        supportsResume: true,
+        supportsMaxTurns: false,
+        supportsSlashClear: false,
+        permissionModes: CLAUDE_PERMISSION_MODES,
+    },
+    codex: {
+        controlLevel: 2,
+        supportsModel: true,
+        supportsSystemPrompt: false,
+        supportsToolConfig: false,
+        supportsMcpConfig: false,
+        supportsPermissionMode: true,
+        supportsResume: true,
+        supportsMaxTurns: false,
+        supportsSlashClear: false,
+        permissionModes: CODEX_PERMISSION_MODES,
+    },
+    gemini: {
+        controlLevel: 1,
+        supportsModel: true,
+        supportsSystemPrompt: false,
+        supportsToolConfig: false,
+        supportsMcpConfig: false,
+        supportsPermissionMode: false,
+        supportsResume: false,
+        supportsMaxTurns: false,
+        supportsSlashClear: false,
+        permissionModes: [],
+    },
+};
+/** Get capability for an agent, falling back to minimal (Level 0) for unknown agents. */
+export function getAgentCapability(agentType) {
+    return (AGENT_CAPABILITIES[agentType] ?? {
+        controlLevel: 0,
+        supportsModel: false,
+        supportsSystemPrompt: false,
+        supportsToolConfig: false,
+        supportsMcpConfig: false,
+        supportsPermissionMode: false,
+        supportsResume: false,
+        supportsMaxTurns: false,
+        supportsSlashClear: false,
+        permissionModes: [],
+    });
+}
+//# sourceMappingURL=agentCapabilities.js.map

package/dist/agentCapabilities.js.map

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

package/dist/agentInstallGuide.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Per-agent install instructions for the web UI.
+ *
+ * Display-only data — the actual gating logic lives in daemon's registry.
+ * Wire only has the strings so the web can render install/upgrade instructions.
+ */
+import type { AgentType } from './messageMeta.js';
+import type { Platform } from './machine.js';
+export interface AgentInstallInfo {
+    readonly minVersion: string;
+    readonly install: Readonly<Record<Platform, string>>;
+    readonly upgradeUrl: string;
+}
+export declare const AGENT_INSTALL_GUIDE: Readonly<Record<AgentType, AgentInstallInfo>>;
+//# sourceMappingURL=agentInstallGuide.d.ts.map

package/dist/agentInstallGuide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentInstallGuide.d.ts","sourceRoot":"","sources":["../src/agentInstallGuide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CA0D7E,CAAC"}

package/dist/agentInstallGuide.js

@@ -0,0 +1,63 @@
+/**
+ * Per-agent install instructions for the web UI.
+ *
+ * Display-only data — the actual gating logic lives in daemon's registry.
+ * Wire only has the strings so the web can render install/upgrade instructions.
+ */
+export const AGENT_INSTALL_GUIDE = {
+    claude: {
+        minVersion: '1.0.0',
+        install: {
+            darwin: 'curl -fsSL https://claude.ai/install.sh | bash',
+            linux: 'curl -fsSL https://claude.ai/install.sh | bash',
+            win32: 'irm https://claude.ai/install.ps1 | iex',
+        },
+        upgradeUrl: 'https://code.claude.com/docs/en/overview',
+    },
+    copilot: {
+        minVersion: '0.1.0',
+        install: {
+            darwin: 'curl -fsSL https://claude.ai/install.sh | bash  # then: see https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli',
+            linux: 'curl -fsSL https://claude.ai/install.sh | bash  # then: see https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli',
+            win32: 'irm https://claude.ai/install.ps1 | iex  # then: see https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli',
+        },
+        upgradeUrl: 'https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli',
+    },
+    codex: {
+        minVersion: '0.43.0',
+        install: {
+            darwin: 'npm install -g @openai/codex',
+            linux: 'npm install -g @openai/codex',
+            win32: 'npm install -g @openai/codex',
+        },
+        upgradeUrl: 'https://github.com/openai/codex',
+    },
+    gemini: {
+        minVersion: '0.1.0',
+        install: {
+            darwin: 'npm install -g @google/gemini-cli',
+            linux: 'npm install -g @google/gemini-cli',
+            win32: 'npm install -g @google/gemini-cli',
+        },
+        upgradeUrl: 'https://github.com/google-gemini/gemini-cli',
+    },
+    opencode: {
+        minVersion: '0.1.0',
+        install: {
+            darwin: 'curl -fsSL https://opencode.ai/install | bash',
+            linux: 'curl -fsSL https://opencode.ai/install | bash',
+            win32: 'npm install -g opencode-ai',
+        },
+        upgradeUrl: 'https://opencode.ai',
+    },
+    custom: {
+        minVersion: '0.0.0',
+        install: {
+            darwin: 'Install the custom agent CLI per its documentation',
+            linux: 'Install the custom agent CLI per its documentation',
+            win32: 'Install the custom agent CLI per its documentation',
+        },
+        upgradeUrl: '',
+    },
+};
+//# sourceMappingURL=agentInstallGuide.js.map

package/dist/agentInstallGuide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentInstallGuide.js","sourceRoot":"","sources":["../src/agentInstallGuide.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,CAAC,MAAM,mBAAmB,GAAkD;IAChF,MAAM,EAAE;QACN,UAAU,EAAE,OAAO;QACnB,OAAO,EAAE;YACP,MAAM,EAAE,gDAAgD;YACxD,KAAK,EAAE,gDAAgD;YACvD,KAAK,EAAE,yCAAyC;SACjD;QACD,UAAU,EAAE,0CAA0C;KACvD;IACD,OAAO,EAAE;QACP,UAAU,EAAE,OAAO;QACnB,OAAO,EAAE;YACP,MAAM,EACJ,mIAAmI;YACrI,KAAK,EACH,mIAAmI;YACrI,KAAK,EACH,4HAA4H;SAC/H;QACD,UAAU,EAAE,sEAAsE;KACnF;IACD,KAAK,EAAE;QACL,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE;YACP,MAAM,EAAE,8BAA8B;YACtC,KAAK,EAAE,8BAA8B;YACrC,KAAK,EAAE,8BAA8B;SACtC;QACD,UAAU,EAAE,iCAAiC;KAC9C;IACD,MAAM,EAAE;QACN,UAAU,EAAE,OAAO;QACnB,OAAO,EAAE;YACP,MAAM,EAAE,mCAAmC;YAC3C,KAAK,EAAE,mCAAmC;YAC1C,KAAK,EAAE,mCAAmC;SAC3C;QACD,UAAU,EAAE,6CAA6C;KAC1D;IACD,QAAQ,EAAE;QACR,UAAU,EAAE,OAAO;QACnB,OAAO,EAAE;YACP,MAAM,EAAE,+CAA+C;YACvD,KAAK,EAAE,+CAA+C;YACtD,KAAK,EAAE,4BAA4B;SACpC;QACD,UAAU,EAAE,qBAAqB;KAClC;IACD,MAAM,EAAE;QACN,UAAU,EAAE,OAAO;QACnB,OAAO,EAAE;YACP,MAAM,EAAE,oDAAoD;YAC5D,KAAK,EAAE,oDAAoD;YAC3D,KAAK,EAAE,oDAAoD;SAC5D;QACD,UAAU,EAAE,EAAE;KACf;CACF,CAAC"}

package/dist/agentModels.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Agent model options — known models per CLI agent for UI selection.
+ *
+ * Labels MUST match what users see in each CLI's TUI.
+ * Values are the short keys / model IDs accepted by each CLI's --model flag.
+ *
+ * For ACP agents (copilot), this is a static fallback — in production,
+ * models should come dynamically from ACP session/new response.
+ *
+ * Ref: Happy modelModeOptions.ts, docs/research/copilot-cli-acp.md
+ */
+export interface AgentModelOption {
+    readonly value: string;
+    readonly label: string;
+}
+export interface AgentModelConfig {
+    readonly defaultModel: string;
+    readonly models: readonly AgentModelOption[];
+}
+export declare const AGENT_MODELS: Readonly<Record<string, AgentModelConfig>>;
+/** Get model config for an agent, falling back to default-only for unknown. */
+export declare function getAgentModels(agentType: string): AgentModelConfig;
+//# sourceMappingURL=agentModels.d.ts.map

package/dist/agentModels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentModels.d.ts","sourceRoot":"","sources":["../src/agentModels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyD1D,CAAC;AAEX,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAOlE"}

package/dist/agentModels.js

@@ -0,0 +1,77 @@
+/**
+ * Agent model options — known models per CLI agent for UI selection.
+ *
+ * Labels MUST match what users see in each CLI's TUI.
+ * Values are the short keys / model IDs accepted by each CLI's --model flag.
+ *
+ * For ACP agents (copilot), this is a static fallback — in production,
+ * models should come dynamically from ACP session/new response.
+ *
+ * Ref: Happy modelModeOptions.ts, docs/research/copilot-cli-acp.md
+ */
+export const AGENT_MODELS = {
+    claude: {
+        defaultModel: '',
+        models: [
+            { value: '', label: '' },
+            { value: 'sonnet', label: 'Sonnet' },
+            { value: 'opus', label: 'Opus' },
+            { value: 'haiku', label: 'Haiku' },
+        ],
+    },
+    copilot: {
+        defaultModel: '',
+        models: [
+            { value: '', label: '' },
+            { value: 'gpt-5.3-codex', label: 'GPT-5.3-Codex' },
+            { value: 'gpt-5.2-codex', label: 'GPT-5.2-Codex' },
+            { value: 'gpt-5.2', label: 'GPT-5.2' },
+            { value: 'gpt-5.1-codex-max', label: 'GPT-5.1-Codex-Max' },
+            { value: 'gpt-5.1-codex', label: 'GPT-5.1-Codex' },
+            { value: 'gpt-5.1', label: 'GPT-5.1' },
+            { value: 'gpt-5.1-codex-mini', label: 'GPT-5.1-Codex-Mini' },
+            { value: 'gpt-5-mini', label: 'GPT-5 mini' },
+            { value: 'gpt-4.1', label: 'GPT-4.1' },
+            { value: 'claude-sonnet-4.6', label: 'Claude Sonnet 4.6' },
+            { value: 'claude-sonnet-4.5', label: 'Claude Sonnet 4.5' },
+            { value: 'claude-haiku-4.5', label: 'Claude Haiku 4.5' },
+            { value: 'claude-opus-4.6', label: 'Claude Opus 4.6' },
+            { value: 'claude-opus-4.5', label: 'Claude Opus 4.5' },
+            { value: 'claude-sonnet-4', label: 'Claude Sonnet 4' },
+            { value: 'gemini-3-pro-preview', label: 'Gemini 3 Pro (Preview)' },
+        ],
+    },
+    opencode: {
+        defaultModel: '',
+        models: [
+            { value: '', label: '' },
+            { value: 'sonnet', label: 'Sonnet' },
+            { value: 'opus', label: 'Opus' },
+        ],
+    },
+    codex: {
+        defaultModel: '',
+        models: [
+            { value: '', label: '' },
+            { value: 'o3', label: 'o3' },
+            { value: 'o4-mini', label: 'o4-mini' },
+            { value: 'gpt-4.1', label: 'GPT 4.1' },
+        ],
+    },
+    gemini: {
+        defaultModel: '',
+        models: [
+            { value: '', label: '' },
+            { value: 'gemini-2.5-pro', label: 'Gemini 2.5 Pro' },
+            { value: 'gemini-2.5-flash', label: 'Gemini 2.5 Flash' },
+        ],
+    },
+};
+/** Get model config for an agent, falling back to default-only for unknown. */
+export function getAgentModels(agentType) {
+    return (AGENT_MODELS[agentType] ?? {
+        defaultModel: '',
+        models: [{ value: '', label: '' }],
+    });
+}
+//# sourceMappingURL=agentModels.js.map

package/dist/agentModels.js.map

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

package/dist/controlLevel.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+/**
+ * Control depth level for CLI tools.
+ *
+ * Level 3: Full control — bidirectional ACP, per-tool permissions, resume (Claude Code, OpenCode)
+ * Level 2: High control — JSONL + resume + pre-configured permissions (Codex CLI)
+ * Level 1: Read-only monitoring — JSONL + no resume + binary permissions (Gemini, Qwen)
+ * Level 0: Minimal — plain text + no multi-turn (Aider, not recommended)
+ */
+export declare const ControlLevel: z.ZodUnion<[z.ZodLiteral<3>, z.ZodLiteral<2>, z.ZodLiteral<1>, z.ZodLiteral<0>]>;
+export type ControlLevelType = z.infer<typeof ControlLevel>;
+//# sourceMappingURL=controlLevel.d.ts.map

package/dist/controlLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlLevel.d.ts","sourceRoot":"","sources":["../src/controlLevel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,kFAAoE,CAAC;AAE9F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/controlLevel.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+/**
+ * Control depth level for CLI tools.
+ *
+ * Level 3: Full control — bidirectional ACP, per-tool permissions, resume (Claude Code, OpenCode)
+ * Level 2: High control — JSONL + resume + pre-configured permissions (Codex CLI)
+ * Level 1: Read-only monitoring — JSONL + no resume + binary permissions (Gemini, Qwen)
+ * Level 0: Minimal — plain text + no multi-turn (Aider, not recommended)
+ */
+export const ControlLevel = z.union([z.literal(3), z.literal(2), z.literal(1), z.literal(0)]);
+//# sourceMappingURL=controlLevel.js.map

package/dist/controlLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlLevel.js","sourceRoot":"","sources":["../src/controlLevel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}