@fitlab-ai/agent-infra 0.9.2 → 0.9.3

package/README.md

@@ -5,7 +5,7 @@
 <h1 align="center">Agent Infra</h1>
 
 <p align="center">
-  Collaboration infrastructure for AI coding agents — skills, workflows, and sandboxes for Claude Code, Codex, Gemini CLI, and OpenCode.
+  Collaboration infrastructure for AI coding agents — skills, workflows, and sandboxes for Claude Code, Codex, Antigravity CLI, and OpenCode.
 </p>
 
 <p align="center">
@@ -28,7 +28,7 @@
 
 ## Why agent-infra?
 
-Teams increasingly mix Claude Code, Codex, Gemini CLI, OpenCode, and other AI TUIs in the same repository, but each tool tends to introduce its own commands, prompts, and local conventions. Without a shared layer, the result is fragmented workflows, duplicated setup, and task history that is difficult to audit.
+Teams increasingly mix Claude Code, Codex, Antigravity CLI, OpenCode, and other AI TUIs in the same repository, but each tool tends to introduce its own commands, prompts, and local conventions. Without a shared layer, the result is fragmented workflows, duplicated setup, and task history that is difficult to audit.
 
 agent-infra standardizes that shared infrastructure. It gives every supported AI TUI the same task lifecycle, the same skill vocabulary, the same project governance files, isolated development sandboxes, and the same upgrade path, so teams can switch tools without rebuilding process from scratch.
 
@@ -81,11 +81,11 @@ Just fix it at the application layer in LoginService.
 
 **11 commands. 1 natural-language correction. From issue to merged PR.** That is the entire SOP — programming can have a standard operating procedure too.
 
-Every command above works the same way in Claude Code, Codex, Gemini CLI, and OpenCode. Switch tools mid-task — the workflow state follows. For what each skill does under the hood, see [Built-in AI Skills](./docs/en/skills.md).
+Every command above works the same way in Claude Code, Codex, Antigravity CLI, and OpenCode. Switch tools mid-task — the workflow state follows. For what each skill does under the hood, see [Built-in AI Skills](./docs/en/skills.md).
 
 ## Key Features
 
-- **Multi-AI collaboration**: one shared operating model for Claude Code, Codex, Gemini CLI, and OpenCode
+- **Multi-AI collaboration**: one shared operating model for Claude Code, Codex, Antigravity CLI, and OpenCode
 - **Bootstrap CLI + skill-driven execution**: initialize once, then let AI skills drive day-to-day work
 - **IM command bridge**: route Feishu messages to built-ins, read-only task views, sandbox management, and controlled lifecycle skill runs
 - **Bilingual project docs**: English-first docs with synchronized Chinese translations
@@ -153,7 +153,7 @@ Open the project in any AI TUI and run `update-agent-infra`:
 |-----|---------|
 | Claude Code | `/update-agent-infra` |
 | Codex | `$update-agent-infra` |
-| Gemini CLI | `/{{project}}:update-agent-infra` |
+| Antigravity CLI | `/update-agent-infra` |
 | OpenCode | `/update-agent-infra` |
 
 This detects the packaged template version and renders all managed files. The same command is used both for first-time setup and for future template upgrades.
@@ -166,21 +166,23 @@ Manage the four built-in Agent Clients independently from the project lifecycle:
 ai agent-client list
 ai agent-client status
 ai agent-client enable codex
-ai agent-client disable gemini-cli
+ai agent-client disable antigravity-cli
 ai agent-client configure
 ```
 
-The most-used lifecycle commands, in delivery order. The command prefix varies by TUI (`/skill` in Claude Code/OpenCode, `$skill` in Codex, `/{{project}}:skill` in Gemini CLI); the workflow semantics stay the same.
+The most-used lifecycle commands, in delivery order. The command prefix varies by TUI (`/skill` in Claude Code/Antigravity/OpenCode and `$skill` in Codex); the workflow semantics stay the same.
 
 | Command | Purpose |
 |---------|---------|
 | `create-task` / `import-issue` | Start a task from a description or a GitHub Issue |
-| `run-task` | Resume and orchestrate the lifecycle in Claude Code with fresh isolated executors/reviewers until a safe commit or stable pause; Codex currently fails closed because its multi-agent runtime does not expose the required lifecycle events |
+| `run-task` | Resume the lifecycle with fresh isolated executors/reviewers when the selected client exposes verified actual model/effort evidence; current built-in clients, including Claude Code and Codex, fail closed before delegation because their native start events do not expose all required evidence |
 | `analyze-task` → `review-analysis` | Capture scope and risks, then review the analysis |
 | `plan-task` → `review-plan` | Design the approach, then review the plan |
 | `code-task` → `review-code` | Implement and test, then run a structured code review |
 | `commit` → `create-pr` → `complete-task` | Commit, open a PR, and archive the task |
 
+Start with one atomic role policy, for example: `$run-task 42 --executor-model <id> --executor-reasoning-effort <value> --reviewer-model <id> --reviewer-reasoning-effort <value>`. Both roles may use the same model. With no explicit policy, `run-task` reads the current Agent Client's optional `agentClients[].orchestration`; if neither source is complete, it shows the host model-selection guidance before creating any run. Re-entry uses the persisted v2 policy.
+
 See the full catalog — task status, release, security, and project-maintenance skills — in [Built-in AI Skills](./docs/en/skills.md).
 
 ## What You Get
@@ -196,7 +198,6 @@ my-project/
 │   ├── workflows/         # 4 prebuilt workflows
 │   └── templates/         # Task and artifact templates
 ├── .claude/               # Claude Code config and commands
-├── .gemini/               # Gemini CLI config and commands
 ├── .opencode/             # OpenCode config and commands
 └── AGENTS.md              # Universal AI agent instructions
 ```

package/README.zh-CN.md

@@ -5,7 +5,7 @@
 <h1 align="center">Agent Infra</h1>
 
 <p align="center">
-  AI 编程代理的协作基础设施 —— 为 Claude Code、Codex、Gemini CLI、OpenCode 提供 skills、工作流和沙箱。
+  AI 编程代理的协作基础设施 —— 为 Claude Code、Codex、Antigravity CLI、OpenCode 提供 skills、工作流和沙箱。
 </p>
 
 <p align="center">
@@ -28,7 +28,7 @@
 
 ## 为什么需要 agent-infra？
 
-越来越多的团队会在同一个仓库里混用 Claude Code、Codex、Gemini CLI、OpenCode 等 AI TUI，但每个工具往往都会带来自己的命令体系、提示词习惯和本地约定。缺少共享层时，结果通常是工作流割裂、初始化重复、任务历史难以追踪。
+越来越多的团队会在同一个仓库里混用 Claude Code、Codex、Antigravity CLI、OpenCode 等 AI TUI，但每个工具往往都会带来自己的命令体系、提示词习惯和本地约定。缺少共享层时，结果通常是工作流割裂、初始化重复、任务历史难以追踪。
 
 agent-infra 的目标就是把这层共享基础设施标准化。它为所有支持的 AI TUI 提供统一的任务生命周期、统一的 skill 词汇、统一的项目治理文件、隔离的开发沙箱以及统一的升级路径，让团队切换工具时不必重新发明流程。
 
@@ -80,11 +80,11 @@ agent-infra 的目标就是把这层共享基础设施标准化。它为所有
 
 **11 条命令，1 次自然语言纠正，从 Issue 到合并 PR。** 这就是完整的 SOP —— 编程也可以有标准作业流程。
 
-以上每条命令在 Claude Code、Codex、Gemini CLI、OpenCode 中完全通用。任务进行到一半切换工具，工作流状态照常延续。每个 skill 背后做了什么，见 [内置 AI Skills](./docs/zh-CN/skills.md)。
+以上每条命令在 Claude Code、Codex、Antigravity CLI、OpenCode 中完全通用。任务进行到一半切换工具，工作流状态照常延续。每个 skill 背后做了什么，见 [内置 AI Skills](./docs/zh-CN/skills.md)。
 
 ## 核心特性
 
-- **多 AI 协作**：为 Claude Code、Codex、Gemini CLI、OpenCode 提供统一的协作模型
+- **多 AI 协作**：为 Claude Code、Codex、Antigravity CLI、OpenCode 提供统一的协作模型
 - **引导 CLI + skill 驱动执行**：初始化一次，后续日常操作交给 AI skills
 - **IM 命令桥接**：把飞书消息路由到内置命令、任务只读视图、沙箱管理和受控生命周期 skill 执行
 - **双语文档**：英文为主文档，配套同步的中文版本
@@ -152,7 +152,7 @@ CLI 会收集项目元数据，让你选择启用的 Agent Client，为其安装
 |-----|------|
 | Claude Code | `/update-agent-infra` |
 | Codex | `$update-agent-infra` |
-| Gemini CLI | `/{{project}}:update-agent-infra` |
+| Antigravity CLI | `/update-agent-infra` |
 | OpenCode | `/update-agent-infra` |
 
 该命令会检测当前打包模板版本并渲染所有受管理文件。首次安装和后续升级都使用同一条命令。
@@ -165,21 +165,23 @@ CLI 会收集项目元数据，让你选择启用的 Agent Client，为其安装
 ai agent-client list
 ai agent-client status
 ai agent-client enable codex
-ai agent-client disable gemini-cli
+ai agent-client disable antigravity-cli
 ai agent-client configure
 ```
 
-最常用的生命周期命令，按交付顺序排列。命令前缀因 TUI 而异（Claude Code/OpenCode 用 `/skill`，Codex 用 `$skill`，Gemini CLI 用 `/{{project}}:skill`），工作流语义保持一致。
+最常用的生命周期命令，按交付顺序排列。命令前缀因 TUI 而异（Claude Code/Antigravity/OpenCode 用 `/skill`，Codex 用 `$skill`），工作流语义保持一致。
 
 | 命令 | 用途 |
 |------|------|
 | `create-task` / `import-issue` | 从描述或 GitHub Issue 创建任务 |
-| `run-task` | 在 Claude Code 中从当前状态续跑生命周期，用 fresh 隔离 executor/reviewer 推进到安全提交或稳定暂停；Codex 当前因多代理运行时未暴露所需生命周期事件而失败关闭 |
+| `run-task` | 当所选客户端能提供已验证的 actual model/effort 证据时，用 fresh 隔离 executor/reviewer 续跑生命周期；当前内建客户端（含 Claude Code 与 Codex）因原生 start 事件未暴露全部必需证据，会在委派前失败关闭 |
 | `analyze-task` → `review-analysis` | 明确范围与风险，再审查分析 |
 | `plan-task` → `review-plan` | 设计实现路径，再审查方案 |
 | `code-task` → `review-code` | 实现并测试，再执行结构化代码审查 |
 | `commit` → `create-pr` → `complete-task` | 提交、创建 PR、归档任务 |
 
+启动时可提供原子角色策略，例如：`$run-task 42 --executor-model <id> --executor-reasoning-effort <值> --reviewer-model <id> --reviewer-reasoning-effort <值>`。两个角色可以使用同一模型。完全没有显式策略时，`run-task` 读取当前 Agent Client 可选的 `agentClients[].orchestration`；两个来源都不完整时，会在创建任何 run 前展示宿主模型选择指引。重入使用已持久化的 v2 策略。
+
 完整清单（任务状态、发布、安全、项目维护等 skill）见 [内置 AI Skills](./docs/zh-CN/skills.md)。
 
 ## 安装效果
@@ -195,7 +197,6 @@ my-project/
 │   ├── workflows/         # 4 个预置工作流
 │   └── templates/         # 任务与产物模板
 ├── .claude/               # Claude Code 配置与命令
-├── .gemini/               # Gemini CLI 配置与命令
 ├── .opencode/             # OpenCode 配置与命令
 └── AGENTS.md              # 通用 AI agent 指令
 ```

package/dist/bin/internal-cli.js

@@ -46,6 +46,16 @@ switch (command) {
         platformPr(process.argv.slice(3));
         break;
     }
+    case 'platform-pr-review': {
+        const { platformPrReview } = await import('../lib/internal/platform-pr-review.js');
+        platformPrReview(process.argv.slice(3));
+        break;
+    }
+    case 'pr-review-grade': {
+        const { prReviewGrade } = await import('../lib/internal/pr-review-grade.js');
+        prReviewGrade(process.argv.slice(3));
+        break;
+    }
     case 'platform-checks': {
         const { platformChecks } = await import('../lib/internal/platform-checks.js');
         await platformChecks(process.argv.slice(3));
@@ -66,6 +76,11 @@ switch (command) {
         taskWarning(process.argv.slice(3));
         break;
     }
+    case 'task-activity': {
+        const { taskActivity } = await import('../lib/internal/task-activity.js');
+        taskActivity(process.argv.slice(3));
+        break;
+    }
     case 'task-artifact': {
         const { taskArtifact } = await import('../lib/internal/task-artifact.js');
         taskArtifact(process.argv.slice(3));

package/dist/lib/agent-clients/adapter.js

@@ -116,14 +116,55 @@ function defineAgentClientAdapter(candidate) {
         }
         return [capability, Object.freeze({ level: support.level })];
     }));
+    const modelSelection = candidate.modelSelection;
+    if (!modelSelection || typeof modelSelection !== 'object') {
+        throw new Error(`Agent Client '${candidate.id}' has an invalid model-selection context`);
+    }
+    let frozenModelSelection;
+    if (modelSelection.kind === 'interactive-only') {
+        if (!modelSelection.command?.trim() || !modelSelection.guidance?.trim()) {
+            throw new Error(`Agent Client '${candidate.id}' has an invalid model-selection context`);
+        }
+        frozenModelSelection = Object.freeze({ ...modelSelection });
+    }
+    else if (modelSelection.kind === 'catalog'
+        && ['complete', 'partial'].includes(modelSelection.completeness)
+        && typeof modelSelection.source === 'string'
+        && modelSelection.source.trim() !== ''
+        && Array.isArray(modelSelection.models)) {
+        const models = modelSelection.models.map((model) => {
+            if (!model?.id?.trim() || (model.reasoningEfforts && !Array.isArray(model.reasoningEfforts))) {
+                throw new Error(`Agent Client '${candidate.id}' has an invalid model-selection context`);
+            }
+            return Object.freeze({
+                id: model.id,
+                ...(model.reasoningEfforts
+                    ? { reasoningEfforts: Object.freeze([...model.reasoningEfforts]) }
+                    : {})
+            });
+        });
+        frozenModelSelection = Object.freeze({
+            ...modelSelection,
+            models: Object.freeze(models)
+        });
+    }
+    else {
+        throw new Error(`Agent Client '${candidate.id}' has an invalid model-selection context`);
+    }
+    const evidence = candidate.delegationEvidence;
+    if (!evidence
+        || !['host-event', 'unavailable'].includes(evidence.actualModel)
+        || !['host-event', 'spawn-ack', 'unavailable'].includes(evidence.actualReasoningEffort)) {
+        throw new Error(`Agent Client '${candidate.id}' has invalid delegation evidence`);
+    }
     if (typeof candidate.project !== 'object'
         || candidate.project === null
         || Array.isArray(candidate.project)) {
         throw new Error(`Agent Client '${candidate.id}' has an invalid project descriptor`);
     }
     const ownedPathPrefixes = candidate.project.ownedPathPrefixes;
-    if (!Array.isArray(ownedPathPrefixes) || ownedPathPrefixes.length === 0) {
-        throw new Error(`Agent Client '${candidate.id}' requires owned path prefixes`);
+    if (!Array.isArray(ownedPathPrefixes)) {
+        throw new Error(`Agent Client '${candidate.id}' has invalid owned path prefixes`);
     }
     const paths = ownedPathPrefixes.map((prefix) => {
         if (typeof prefix !== 'string'
@@ -282,6 +323,8 @@ function defineAgentClientAdapter(candidate) {
         displayName: candidate.displayName,
         invocation: candidate.invocation,
         capabilities: Object.freeze(capabilities),
+        modelSelection: frozenModelSelection,
+        delegationEvidence: Object.freeze({ ...evidence }),
         project: Object.freeze({
             ownedPathPrefixes: Object.freeze(paths),
             ...projectAssets,

package/dist/lib/agent-clients/adapters/antigravity-cli.js

@@ -0,0 +1,64 @@
+import { defineAgentClientAdapter } from '../adapter.js';
+import { hostJoin } from '../../sandbox/engines/wsl2-paths.js';
+const antigravityCliAdapter = defineAgentClientAdapter({
+    id: 'antigravity-cli',
+    displayName: 'Antigravity CLI',
+    invocation: '/${skillName}',
+    capabilities: {
+        instructions: { level: 'compatible' },
+        skills: { level: 'integrated' },
+        commands: { level: 'integrated' },
+        hooks: { level: 'compatible' },
+        subagents: { level: 'unsupported' },
+        orchestration: { level: 'unsupported' },
+        sandbox: { level: 'integrated' },
+        verification: { level: 'compatible' }
+    },
+    modelSelection: {
+        kind: 'interactive-only',
+        command: '/model',
+        guidance: 'Use the host model picker for the complete model and reasoning-effort catalog.'
+    },
+    delegationEvidence: {
+        actualModel: 'unavailable',
+        actualReasoningEffort: 'unavailable'
+    },
+    project: {
+        ownedPathPrefixes: [],
+        managed: [],
+        merged: [],
+        ejected: [],
+        seedCommands: []
+    },
+    sandbox: {
+        createTool: ({ home }) => ({
+            id: 'antigravity-cli',
+            name: 'Antigravity CLI',
+            install: {
+                type: 'shell',
+                cmd: 'curl -fsSL https://antigravity.google/cli/install.sh | bash -s -- --dir /home/devuser/.npm-global/bin'
+            },
+            sandboxBase: hostJoin(home, '.agent-infra', 'sandboxes', 'antigravity-cli'),
+            containerMount: '/home/devuser/.gemini',
+            versionCmd: 'agy --version',
+            setupHint: 'Run agy inside the container to finish authentication.',
+            hostPreSeedFiles: [
+                {
+                    hostPath: hostJoin(home, '.gemini', 'antigravity-cli', 'keybindings.json'),
+                    sandboxName: 'antigravity-cli/keybindings.json'
+                },
+                {
+                    hostPath: hostJoin(home, '.gemini', 'config', 'mcp_config.json'),
+                    sandboxName: 'config/mcp_config.json'
+                }
+            ]
+        }),
+        aliases: [
+            { name: 'antigravity-yolo', command: 'agy --dangerously-skip-permissions; tput ed' },
+            { name: 'agy-yolo', command: 'agy --dangerously-skip-permissions; tput ed' }
+        ],
+        hooks: []
+    }
+});
+export { antigravityCliAdapter };
+//# sourceMappingURL=antigravity-cli.js.map

package/dist/lib/agent-clients/adapters/claude-code.js

@@ -10,10 +10,19 @@ const claudeCodeAdapter = defineAgentClientAdapter({
         commands: { level: 'integrated' },
         hooks: { level: 'integrated' },
         subagents: { level: 'experimental' },
-        orchestration: { level: 'experimental' },
+        orchestration: { level: 'unsupported' },
         sandbox: { level: 'integrated' },
         verification: { level: 'compatible' }
     },
+    modelSelection: {
+        kind: 'interactive-only',
+        command: '/model',
+        guidance: 'Use the host model picker for the complete model and reasoning-effort catalog.'
+    },
+    delegationEvidence: {
+        actualModel: 'unavailable',
+        actualReasoningEffort: 'unavailable'
+    },
     project: {
         ownedPathPrefixes: ['.claude/'],
         managed: ['.claude/commands/', '.claude/agents/'],

package/dist/lib/agent-clients/adapters/codex.js

@@ -15,6 +15,15 @@ const codexAdapter = defineAgentClientAdapter({
         sandbox: { level: 'integrated' },
         verification: { level: 'compatible' }
     },
+    modelSelection: {
+        kind: 'interactive-only',
+        command: '/model',
+        guidance: 'Use the host model picker for the complete model and reasoning-effort catalog.'
+    },
+    delegationEvidence: {
+        actualModel: 'unavailable',
+        actualReasoningEffort: 'unavailable'
+    },
     project: {
         ownedPathPrefixes: ['.codex/'],
         managed: ['.codex/hooks.json', '.codex/agents/'],

package/dist/lib/agent-clients/adapters/index.js

@@ -1,12 +1,12 @@
 import { AGENT_CLIENT_IDS } from '../types.js';
 import { claudeCodeAdapter } from './claude-code.js';
 import { codexAdapter } from './codex.js';
-import { geminiCliAdapter } from './gemini-cli.js';
+import { antigravityCliAdapter } from './antigravity-cli.js';
 import { opencodeAdapter } from './opencode.js';
 const adaptersById = new Map([
     claudeCodeAdapter,
     codexAdapter,
-    geminiCliAdapter,
+    antigravityCliAdapter,
     opencodeAdapter
 ].map((adapter) => [adapter.id, adapter]));
 const BUILTIN_AGENT_CLIENT_ADAPTERS = Object.freeze(AGENT_CLIENT_IDS.map((id) => {

package/dist/lib/agent-clients/adapters/opencode.js

@@ -15,6 +15,15 @@ const opencodeAdapter = defineAgentClientAdapter({
         sandbox: { level: 'integrated' },
         verification: { level: 'compatible' }
     },
+    modelSelection: {
+        kind: 'interactive-only',
+        command: '/models',
+        guidance: 'Use the host model picker for the complete model and reasoning-effort catalog.'
+    },
+    delegationEvidence: {
+        actualModel: 'unavailable',
+        actualReasoningEffort: 'unavailable'
+    },
     project: {
         ownedPathPrefixes: ['.opencode/'],
         managed: ['.opencode/commands/'],

package/dist/lib/agent-clients/config.js

@@ -20,6 +20,37 @@ function isRecord(value) {
 function fail(code, path) {
     throw new AgentClientConfigError({ code, path });
 }
+function parseExactText(value, path) {
+    if (typeof value !== 'string' || value.length === 0 || value.trim() !== value) {
+        fail('INVALID_AGENT_CLIENTS', path);
+    }
+    return value;
+}
+function parseOrchestrationPolicy(value, path) {
+    if (!isRecord(value))
+        fail('INVALID_AGENT_CLIENTS', path);
+    const keys = Object.keys(value);
+    if (keys.length !== 2
+        || !hasOwn(value, 'executor')
+        || !hasOwn(value, 'reviewer')) {
+        fail('INVALID_AGENT_CLIENTS', path);
+    }
+    const parseRole = (candidate, rolePath) => {
+        if (!isRecord(candidate)
+            || Object.keys(candidate).length !== 2
+            || !hasOwn(candidate, 'model')
+            || !hasOwn(candidate, 'reasoningEffort')) {
+            fail('INVALID_AGENT_CLIENTS', rolePath);
+        }
+        return Object.freeze({
+            model: parseExactText(candidate.model, `${rolePath}.model`),
+            reasoningEffort: parseExactText(candidate.reasoningEffort, `${rolePath}.reasoningEffort`)
+        });
+    };
+    const executor = parseRole(value.executor, `${path}.executor`);
+    const reviewer = parseRole(value.reviewer, `${path}.reviewer`);
+    return Object.freeze({ executor, reviewer });
+}
 function parseCanonical(value) {
     if (!Array.isArray(value))
         fail('INVALID_AGENT_CLIENTS', 'agentClients');
@@ -29,10 +60,11 @@ function parseCanonical(value) {
         if (!isRecord(candidate))
             fail('INVALID_AGENT_CLIENTS', path);
         const keys = Object.keys(candidate);
-        if (keys.length !== 3
+        if ((keys.length !== 3 && keys.length !== 4)
             || !hasOwn(candidate, 'id')
             || !hasOwn(candidate, 'enabled')
-            || !hasOwn(candidate, 'installInSandbox')) {
+            || !hasOwn(candidate, 'installInSandbox')
+            || (keys.length === 4 && !hasOwn(candidate, 'orchestration'))) {
             fail('INVALID_AGENT_CLIENTS', path);
         }
         if (!isAgentClientId(candidate.id)) {
@@ -47,7 +79,10 @@ function parseCanonical(value) {
         }
         entries.set(candidate.id, {
             enabled: candidate.enabled,
-            installInSandbox: candidate.installInSandbox
+            installInSandbox: candidate.installInSandbox,
+            ...(hasOwn(candidate, 'orchestration')
+                ? { orchestration: parseOrchestrationPolicy(candidate.orchestration, `${path}.orchestration`) }
+                : {})
         });
     }
     for (const id of AGENT_CLIENT_IDS) {
@@ -60,7 +95,10 @@ function serializeAgentClients(state) {
     return AGENT_CLIENT_IDS.map((id) => ({
         id,
         enabled: state[id].enabled,
-        installInSandbox: state[id].installInSandbox
+        installInSandbox: state[id].installInSandbox,
+        ...(state[id].orchestration
+            ? { orchestration: structuredClone(state[id].orchestration) }
+            : {})
     }));
 }
 function projectLegacyTuis(value, diagnostics) {

package/dist/lib/agent-clients/next-steps.js

@@ -1,5 +1,6 @@
 import { listEnabledAgentClientAdapters } from './registry.js';
 import { renderAgentClientInvocation } from './invocation.js';
+import semver from 'semver';
 const SAFE_NAME = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
 const SAFE_TASK_REF = /^(?:\d+|TASK-\d{8}-\d{6})$/;
 function requireSafeName(value, field) {
@@ -13,6 +14,14 @@ function renderNextStepCommands(input) {
     if (input.taskRef !== undefined && !SAFE_TASK_REF.test(input.taskRef)) {
         throw new Error('Invalid task ref');
     }
+    if (input.version !== undefined
+        && (!/^[0-9]/.test(input.version) || semver.valid(input.version) !== input.version)) {
+        throw new Error('Invalid version');
+    }
+    const args = [
+        ...(input.taskRef === undefined ? [] : [input.taskRef]),
+        ...(input.version === undefined ? [] : [input.version])
+    ];
     const builtins = listEnabledAgentClientAdapters(input.state).map((adapter) => Object.freeze({
         source: 'builtin',
         clientId: adapter.id,
@@ -20,7 +29,7 @@ function renderNextStepCommands(input) {
         command: renderAgentClientInvocation(adapter.invocation, {
             projectName: input.projectName,
             skillName: input.skillName,
-            args: input.taskRef === undefined ? [] : [input.taskRef]
+            args
         })
     }));
     const custom = input.customTUIs.map((tool) => Object.freeze({
@@ -29,7 +38,7 @@ function renderNextStepCommands(input) {
         command: renderAgentClientInvocation(tool.invocation, {
             projectName: input.projectName,
             skillName: input.skillName,
-            args: input.taskRef === undefined ? [] : [input.taskRef]
+            args
         })
     }));
     return Object.freeze([...builtins, ...custom]);

package/dist/lib/agent-clients/reconcile.js

@@ -158,7 +158,8 @@ function planAgentClientReconciliation(input) {
         skillName: 'update-agent-infra'
     });
     const actionableSeed = seedOperations.some((operation) => operation.kind === 'write' || operation.kind === 'remove');
-    const changed = JSON.stringify(nextConfig) !== JSON.stringify(input.config) || actionableSeed;
+    const changed = JSON.stringify(nextConfig) !== JSON.stringify(input.config)
+        || actionableSeed;
     return Object.freeze({
         source: normalized.source,
         before: normalized.state,

package/dist/lib/agent-clients/registry.js

@@ -52,6 +52,12 @@ function listInstalledAgentClientAdapters(state) {
 function getAgentClientCapability(id, capability) {
     return getAgentClientAdapter(id).capabilities[capability];
 }
+function getAgentClientModelSelection(id) {
+    return getAgentClientAdapter(id).modelSelection;
+}
+function getAgentClientDelegationEvidence(id) {
+    return getAgentClientAdapter(id).delegationEvidence;
+}
 function listEnabledAgentClientAdaptersByCapability(state, capability, acceptedLevels) {
     const accepted = new Set(acceptedLevels);
     return Object.freeze(AGENT_CLIENT_ADAPTERS.filter((adapter) => state[adapter.id].enabled
@@ -68,5 +74,5 @@ function createAgentClientManifest() {
         ejected: Object.freeze([...adapter.project.ejected])
     })));
 }
-export { AGENT_CLIENT_REGISTRY, createAgentClientManifest, getAgentClientAdapter, getAgentClientCapability, listAgentClientAdapters, listEnabledAgentClientAdapters, listEnabledAgentClientAdaptersByCapability, listInstalledAgentClientAdapters };
+export { AGENT_CLIENT_REGISTRY, createAgentClientManifest, getAgentClientAdapter, getAgentClientCapability, getAgentClientDelegationEvidence, getAgentClientModelSelection, listAgentClientAdapters, listEnabledAgentClientAdapters, listEnabledAgentClientAdaptersByCapability, listInstalledAgentClientAdapters };
 //# sourceMappingURL=registry.js.map

package/dist/lib/agent-clients/schema.js

@@ -24,6 +24,15 @@ const AGENT_CLIENTS_SCHEMA = {
                     },
                     installInSandbox: {
                         type: 'boolean'
+                    },
+                    orchestration: {
+                        type: 'object',
+                        additionalProperties: false,
+                        required: ['executor', 'reviewer'],
+                        properties: {
+                            executor: { $ref: '#/definitions/orchestrationRolePolicy' },
+                            reviewer: { $ref: '#/definitions/orchestrationRolePolicy' }
+                        }
                     }
                 }
             }
@@ -43,6 +52,15 @@ const AGENT_CLIENTS_SCHEMA = {
         }
     },
     definitions: {
+        orchestrationRolePolicy: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['model', 'reasoningEffort'],
+            properties: {
+                model: { type: 'string', minLength: 1 },
+                reasoningEffort: { type: 'string', minLength: 1 }
+            }
+        },
         agentClientCapabilityId: {
             type: 'string',
             enum: [...AGENT_CLIENT_CAPABILITY_IDS]

package/dist/lib/agent-clients/tokens.js

@@ -0,0 +1,49 @@
+// Active AI collaborator short tokens — the write-side whitelist for the
+// activity log. Migrated from lib/task/commands/log.ts so that the write-side
+// internal commands and the rendering side share one definition. Historical
+// Gemini tokens remain read-only and are handled by classifyAgent below.
+export const KNOWN_AI_AGENTS = new Set(['claude', 'codex', 'antigravity', 'opencode', 'cursor']);
+// Long name -> short name mapping (HD-4, decision A): `claude-code` reuses the
+// existing orchestration precedent, and `antigravity-cli` is the active
+// client. `gemini-cli` is intentionally not writable.
+export const AGENT_LONG_NAMES = {
+    'claude-code': 'claude',
+    'antigravity-cli': 'antigravity'
+};
+export const AGENT_USAGE_HINT = "agent must be a short token (claude/codex/antigravity/opencode/cursor), " +
+    "a long name (claude-code -> claude, antigravity-cli -> antigravity), or 'human'";
+// Read-side historical compatibility for activity-log rendering: `gemini` and
+// `gemini-cli` stay recognizable when displaying old logs, but are never
+// accepted by normalizeAgentToken (write side).
+const READ_KNOWN_AI_AGENTS = new Set([...KNOWN_AI_AGENTS, 'gemini']);
+const READ_AGENT_LONG_NAMES = {
+    ...AGENT_LONG_NAMES,
+    'gemini-cli': 'gemini'
+};
+// Strict write-side validation: the value must be exactly a short token, a
+// long name, or 'human'; returns the normalized short token, or null when
+// the value is not a recognized agent.
+export function normalizeAgentToken(value) {
+    const trimmed = value.trim();
+    if (trimmed === 'human')
+        return 'human';
+    if (KNOWN_AI_AGENTS.has(trimmed))
+        return trimmed;
+    const short = AGENT_LONG_NAMES[trimmed];
+    return short ?? null;
+}
+// Loose rendering-side classification: tolerates historical parenthetical
+// annotations; unknown tokens keep the `human` grouping but get a visible
+// signal. The "known AI token" test is `classifyAgent(value).status === 'ai'`.
+export function classifyAgent(raw) {
+    const token = raw.trim().split(/\s+/)[0]?.replace(/\(.*$/, '') ?? '';
+    if (token === '')
+        return { status: 'unknown', display: 'human' };
+    if (token === 'human')
+        return { status: 'human', display: 'human' };
+    if (READ_KNOWN_AI_AGENTS.has(token))
+        return { status: 'ai', display: token };
+    const short = READ_AGENT_LONG_NAMES[token];
+    return short ? { status: 'ai', display: short } : { status: 'unknown', display: 'human' };
+}
+//# sourceMappingURL=tokens.js.map

package/dist/lib/agent-clients/types.js

@@ -1,7 +1,7 @@
 const AGENT_CLIENT_IDS = [
     'claude-code',
     'codex',
-    'gemini-cli',
+    'antigravity-cli',
     'opencode'
 ];
 const AGENT_CLIENT_CAPABILITY_IDS = [

package/dist/lib/defaults.json

@@ -14,7 +14,7 @@
             "installInSandbox": true
         },
         {
-            "id": "gemini-cli",
+            "id": "antigravity-cli",
             "enabled": true,
             "installInSandbox": true
         },