@autopilot-agent/cli 0.1.0 → 0.2.0

package/README.md

@@ -1,181 +1,53 @@
-<!-- 本文件用于 npm CLI 用户了解安装、配置和使用方式。 -->
 # @autopilot-agent/cli
 
-Autopilot Agent 是一个在终端中使用的 AI 编程助手，可以运行在任何支持开启终端操作的IDE、ADE中；Autopilot 可以帮助你分析项目、修改代码、执行命令和管理会话。你可以通过权限设置和操作审批控制它对项目的访问。
-
-安装后使用 `ap` 或 `autopilot` 启动，两者功能相同。
-
-## 可以做什么
-
-- **理解项目**：阅读文件、按文件名或内容搜索代码，梳理项目结构、解释实现、定位问题。输入 `@src/index.ts` 这样的相对路径，可以把指定文件带入当前对话。
-- **编写和修改代码**：根据需求创建文件、修改已有代码，帮助修复 Bug、补充测试和整理文档；交互界面会展示文件修改信息。
-- **执行开发命令**：运行测试、构建和其他命令，根据输出继续排查；耗时命令可以作为后台任务运行，随时查看输出或请求停止。
-- **跟踪任务进度**：将复杂需求拆成待办事项，在执行过程中更新完成状态；任务运行时也可以排队提交下一条需求。
-- **继续已有对话**：保存并管理项目会话，在已有会话中继续提问；中断后可恢复的任务可以通过 `ap resume` 继续。
-- **管理上下文**：查看当前上下文用量，手动压缩对话；具备有效上下文预算时，也会按阈值自动压缩，帮助继续较长的任务。
-- **控制操作权限**：确认项目是否可信，选择权限模式，并审批需要确认的操作；通过 `/undo` 预览并撤销当前会话最近一轮可撤销的文件修改。
-- **扩展工具和工作流程**：加载已安装的 Skills，通过 `/skill` 选择使用；配置并授权 MCP 服务后，可以调用其提供的工具。
-- **查资料和分析图片**：配置搜索服务后可以联网搜索、读取网页；配置可用的视觉模型后，可以分析项目中的图片，例如界面截图。
-
-你可以直接用自然语言提出需求，例如：
-
-```text
-分析这个项目的入口和主要模块，先不要修改文件。
-查找登录失败的原因，修复后运行相关测试。
-根据这张UI设计图片，还原设计稿。
-```
-
-## 常用交互命令
-
-启动 `ap` 后，输入 `/` 可以查看命令建议。
-
-| 命令 | 用途 |
-|---|---|
-| `/model`、`/effort` | 选择后续任务使用的模型和思考强度 |
-| `/skill` | 查看并选择已安装的 Skills |
-| `/permissions` | 查看或切换当前会话的权限模式 |
-| `/context`、`/context all` | 查看上下文用量，或展开详细信息 |
-| `/compact` | 手动压缩当前上下文 |
-| `/jobs` | 查看后台任务，也可查看输出或请求停止 |
-| `/queue <需求>` | 将下一条需求加入队列 |
-| `/undo` | 预览最近一轮可撤销的文件修改，再确认是否撤销 |
-| `/cancel`、`/exit` | 取消当前任务，或退出 CLI |
-
-## 安装
-
-请先安装 **Node.js >=20.11.0 且 <22** 和 npm，再运行以下命令。安装时需要联网。
+Autopilot 的终端宿主包。普通用户安装主包 `autopilot-agent@0.2.0`，无需分别安装各个 scoped 包：
 
 ```bash
-npm install -g autopilot-agent
+npm install -g autopilot-agent@0.2.0
 ap --help
 ```
 
-只需安装 `autopilot-agent`，所需依赖会自动安装。
-
-## 配置 settings.json
+完整安装、Anthropic / Chat Completions 配置、使用和限制见 [主包手册](https://github.com/C-Clay-W/autopilot/blob/main/packages/autopilot-agent/README.md)，完整 argv / slash 语法见 [CLI 参考](https://github.com/C-Clay-W/autopilot/blob/main/agent/doc/CLI-Reference.md)。开发参考随源码更新，可能先于已发布版本的行为。
 
-首次使用前，需要填写模型服务地址、API 密钥和模型名称。请在以下位置创建或编辑 `settings.json`：
+## 结构与职责
 
-| 系统 | 配置文件位置 |
-|---|---|
-| Windows | `%USERPROFILE%\.autopilot\settings.json` |
-| macOS | `~/.autopilot/settings.json` |
+- parser.ts 解析 argv 与交互命令，main.ts 编排入口、输出及退出。
+- composition-root.ts 注入共享 Core Runtime 与 Node Adapters，controller.ts 管理任务、审批与恢复。
+- tui/ 使用 React / Ink；renderer.ts 与 event-projector.ts 支持纯文本和 JSONL。
+- 内部依赖为 Core、Adapters、Presentation，0.2.0 使用匹配的精确版本。
 
- `.autopilot` 目录会随 Autopilot Cli首次启动自动创建，如果 `.autopilot` 目录不存在，可先自行创建。配置文件使用标准 JSON，不支持注释或末尾多余的逗号。按下面的示例填写即可，不添加 `schemaVersion` 字段。
+本包的 bin 提供 ap/autopilot，主入口包再转发至本包的 dist/main.js，不复制 Runtime。TTY 使用交互界面；显式 --output text/jsonl 用于脚本，JSONL 不输出 ANSI 或交互提示。
 
-### 使用 Anthropic 或兼容服务
+## 编程入口
 
-如果服务支持 Anthropic Messages 协议，使用以下配置，将 `YOUR_API_KEY` 和 `YOUR_MODEL_ID` 替换为你的密钥和模型名称。使用兼容服务时，也需要替换服务地址。
+包根导出 parseArgv、parseSlashAction、renderHelp、createCliCompositionRoot、createCliController、main、事件投影和 TUI 相关类型。优先把它作为终端应用使用；自行嵌入时需要处理输入输出、Trust、审批和退出清理，不在模块导入时自动启动任务。
 
-```json
-{
-  "env": {
-    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
-    "ANTHROPIC_API_KEY": "YOUR_API_KEY"
-  },
-  "model": "YOUR_MODEL_ID"
-}
-```
+```typescript
+import { parseArgv, renderHelp } from "@autopilot-agent/cli";
 
-如果服务要求使用 `ANTHROPIC_AUTH_TOKEN`，请用它替换 `ANTHROPIC_API_KEY`，不要同时填写两者。服务地址不要追加 `/v1/messages`，也不要包含用户名、密码、查询参数或 `#` 后的内容。
-
-### 使用 OpenAI Chat Completions 兼容服务
-
-如果服务支持 OpenAI Chat Completions 协议，使用下面的配置。替换密钥、`baseUrl` 和两处 `YOUR_MODEL_ID`；其余字段可以保留示例写法。
-
-```json
-{
-  "env": { "USER_SETTINGS_CUSTOM_API_KEY": "YOUR_API_KEY" },
-  "providerRoutes": {
-    "custom": {
-      "id": "custom",
-      "apiProtocol": "openai-chat-completions",
-      "baseUrl": "https://api.example.com/v1",
-      "credentialRef": { "provider": "custom", "key": "USER_SETTINGS_CUSTOM_API_KEY" },
-      "models": [{ "id": "YOUR_MODEL_ID" }]
-    }
-  },
-  "model": "custom/YOUR_MODEL_ID"
-}
+const parsed = parseArgv(["chat", "解释项目结构", "--output", "text"]);
+console.log(parsed);
+console.log(renderHelp());
 ```
 
-不要同时设置 `env.ANTHROPIC_MODEL`，以免覆盖这里选择的模型。
-
-需要配置多个服务时，可以在 `providerRoutes` 中增加其他条目。每个条目的名称、`id` 和 `credentialRef.provider` 应一致；`credentialRef.key` 对应 `env` 中的密钥名称。`model` 使用 `服务名称/模型名称` 的形式，模型必须列在对应服务的 `models` 中。协议只支持 `anthropic-messages` 和 `openai-chat-completions`。
-
-### 常用可选参数
+## 源码开发
 
-| 字段 | 用途与写法 |
-|---|---|
-| `model` | 使用的模型名称，或上面示例中的 `服务名称/模型名称`；建议填写服务商提供的完整模型名称 |
-| `availableModels` | 默认连接允许使用的模型列表，例如 `["MODEL_A", "MODEL_B"]`；不能为空、不能重复，当前模型也需要在列表中 |
-| `effortLevel` | 思考强度，可选 `"low"`、`"medium"`、`"high"`，具体效果取决于模型支持情况 |
-| `alwaysThinkingEnabled` | 是否启用思考，填写 `true` 或 `false`，不要加引号；需要模型支持 |
-| `maxOutputTokens` | 单次输出的 token 上限，填写 1–1,000,000 的整数；不是上下文大小 |
-| `env.API_TIMEOUT_MS` | 默认模型连接的请求超时，单位毫秒，填写 1,000–600,000 的整数字符串，例如 `"60000"` |
-| `visionModel` | 图片分析使用的模型，填写已配置的 Chat Completions 服务中的 `服务名称/模型名称`；`false` 关闭，省略时使用主模型 |
-| `webSearch` | `false` 关闭模型联网搜索；启用时需另行配置搜索服务 |
-
-`env` 中的值都需要写成字符串。填写模型名称和密钥时，避免带入首尾空格或换行。建议通过顶层 `model` 和 `effortLevel` 设置模型与思考强度；`env.ANTHROPIC_MODEL` 和 `env.CLAUDE_CODE_EFFORT_LEVEL` 会覆盖对应设置。
-
-服务地址、密钥、模型列表等连接设置请放在上面的个人配置文件中，不要把密钥提交到项目或版本控制。项目也可以提供 `.autopilot/settings.json` 和 `.autopilot/settings.local.json`，在你信任该项目后应用允许的设置；项目设置不能替换个人配置中的连接信息。
-
-### 修改配置
-
-直接编辑个人 `settings.json` 可以修改完整配置。简单配置也可以通过以下命令修改模型、思考强度和可用模型列表：
+从 monorepo 根安装依赖，依次构建 Core、Adapters、Presentation，再执行：
 
 ```bash
-ap config set model YOUR_MODEL_ID --scope user
-ap config set effortLevel high --scope user
-ap config set availableModels MODEL_A,MODEL_B --scope user
+npm run build -w apps/cli
+node apps/cli/dist/main.js --help
+npm run test -w apps/cli -- test/parser.test.ts
 ```
 
-命令中的模型列表用逗号分隔，配置文件中则使用 JSON 数组。如果文件中配置了自定义服务的 `credentialRef`、`maxOutputTokens` 等字段，当前版本可能拒绝上述修改命令，请直接编辑文件。修改后用 `ap doctor` 检查配置。
-
-## 开始使用
+build 使用 TypeScript，输出 dist/*.js 与声明，不在 npm 包中发布源码映射和测试。当前 Node 声明为 >=20.11.0 <22；建议整仓构建使用 Node 20.20.2。
 
-进入要处理的项目目录后运行：
+CLI 使用用户级 settings.json，默认工作区为当前目录，可显式指定 --workspace-root。CLI 不读取开发仓库 Web env，也不因配置中含 RAG 字段而自动启用私有知识库工具。重要项目保留版本控制，OS 沙箱、MCP 和平台限制见主包手册。
 
-```bash
-ap
-```
-
-首次打开项目时，按提示确认是否信任该项目。确认后，可以检查配置和模型连接：
-
-```bash
-ap doctor
-ap doctor --connectivity
-```
-
-`ap doctor` 检查本地配置，`--connectivity` 还会联网检查模型服务。未信任项目时，部分检查会跳过。
-
-`ap` 会进入交互模式，你可以直接输入需求。也可以提交一次任务：
-
-```bash
-ap chat "分析当前项目结构，不修改文件"
-```
-
-常用管理命令：
-
-```bash
-ap session list
-ap trust status
-ap sandbox status
-```
-
-查看各命令的具体参数与限制：`ap --help`。更新和卸载：
-
-```bash
-npm install -g autopilot-agent@latest
-npm uninstall -g autopilot-agent
-```
+## 0.2.0 版本
 
-卸载后，个人配置和会话数据仍会保留。
+本包随 npm 0.2.0 发布，内部依赖使用匹配的精确版本。Windows 命令、后台 Job 与 host MCP 逐次审批后以当前用户权限直接执行，审批不提供 OS 隔离；macOS 继续使用 Seatbelt。实机与进程树生命周期仍需按实际验证确认。
 
-## 当前限制
+## 许可证
 
-- 当前提供终端使用方式，暂不包含图形界面、内置浏览器预览、自动长期记忆或私有知识库搜索。
-- 沙箱功能需要额外的平台支持，可通过 `ap doctor` 和 `ap sandbox status` 查看状态。MCP 工具默认在本机运行，不提供操作系统级隔离。
-- Windows 后台任务的子进程可能无法全部停止；沙箱中的 MCP 工具也可能遇到输入无法转发的问题。需要可靠停止的长任务，建议先在测试项目中验证。
-- macOS 尚未完成完整功能验证，Linux 暂未验证。模型服务的可用性、限额和费用以服务商为准。
-- 当前为早期版本，处理重要项目时，请保留版本控制或备份。
+公开源码采用 [MIT 许可证](https://github.com/C-Clay-W/autopilot/blob/main/LICENSE)。第三方依赖保留各自许可证。

package/dist/activity-animation.d.ts

@@ -53,5 +53,7 @@ export declare function TuiActivityLine(props: {
     reducedMotion: boolean;
     animationActive: boolean;
     clock: TuiAnimationClock;
+    startedAt?: number;
+    activeForm?: string;
 }): ReactNode;
 export {};

package/dist/activity-animation.js

@@ -8,6 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import { useEffect, useState } from "react";
 import { Box, Text } from "ink";
+import { formatTuiDuration } from "./tui/format.js";
 export const CLI_ACTIVITY_STALLED_AFTER_MS = 20_000;
 export const CLI_ACTIVITY_TRANSITION_MS = 2_000;
 /** CC v2.1.88 的默认 spinner glyph；首尾重复保证 ping-pong 转向自然。 */
@@ -124,22 +125,24 @@ export function TuiActivityLine(props) {
     const [clockTime, setClockTime] = useState(props.clock.now());
     const view = resolveCliActivityView({ activity: props.activity, status: props.status, now: clockTime, waitingForApproval: props.waitingForApproval });
     const shouldAnimate = props.animationActive && !props.screenReader && !props.reducedMotion && view !== undefined && view.phase !== "terminal";
+    const shouldTick = shouldAnimate || (props.startedAt !== undefined && (props.status === "running" || props.status === "waiting_approval"));
     useEffect(function subscribeActivityClock() {
-        props.clock.setActive(shouldAnimate);
-        if (!shouldAnimate) {
+        props.clock.setActive(shouldTick);
+        if (!shouldTick) {
             setClockTime(props.clock.now());
             return;
         }
         setClockTime(props.clock.now());
         return props.clock.subscribe(function updateActivityClock(time) {
-            setClockTime(time);
+            // 禁动画仍按秒刷新累计时间，复用同一枚时钟。
+            setClockTime(function next(previous) { return shouldAnimate || Math.floor(previous / 1000) !== Math.floor(time / 1000) ? time : previous; });
         });
-    }, [props.clock, shouldAnimate]);
+    }, [props.clock, shouldAnimate, shouldTick]);
     if (!view)
         return null;
     if (view.phase === "terminal")
         return null;
     const frame = shouldAnimate ? view.frame : "·";
     const isStalled = view.phase === "stalled";
-    return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: 3, flexShrink: 0, children: _jsx(Text, { bold: isStalled, color: props.useColor ? "ansi256(208)" : undefined, children: frame }) }), _jsx(Text, { bold: isStalled, dimColor: props.useColor && !isStalled, children: view.label })] }));
+    return (_jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: 3, flexShrink: 0, children: _jsx(Text, { bold: isStalled, color: props.useColor ? "ansi256(208)" : undefined, children: frame }) }), _jsxs(Text, { bold: isStalled, dimColor: props.useColor && !isStalled, children: [props.activeForm ?? view.label, props.startedAt !== undefined ? ` · ${formatTuiDuration(Math.max(0, clockTime - props.startedAt))}` : ""] })] }));
 }

package/dist/composition-root.js

@@ -6,7 +6,7 @@
  */
 import { WEB_SEARCH_DATA_FLOW_NOTICE } from "@autopilot-agent/presentation";
 import { createDefaultModelSamplerFactory, createRuntimeBootstrapService, createSafeBootstrapConfig, WorkspaceTrustError, getMcpServerGrantConstraint, } from "@autopilot-agent/core";
-import { createNodeCredentialStore, createNodeCapabilityLoader, createNodeSandboxPort, createNodeSettingsLoader, createNodeSettingsWriter, ensureUserConfigDirectory, createNodeRuntimePorts, createNodeTrustPolicy, createNodeWorkspaceRegistry, createNodeWorkspaceAdapter, createNodeWorkspaceId, getNodeStateCorruptionDiagnostics, getNodeStatePaths, getNodeStateSchemaDiagnostic, initializeNodeStateRoot, resolveNodeSettingsPaths, resolveNodeStateRoot, assertNodeStateSchema, } from "@autopilot-agent/adapters";
+import { createNodeCredentialStore, createNodeCapabilityLoader, createNodeHostExecutionSandboxPort, createNodeSandboxPort, createNodeSettingsLoader, createNodeSettingsWriter, ensureUserConfigDirectory, createNodeRuntimePorts, createNodeTrustPolicy, createNodeWorkspaceRegistry, createNodeWorkspaceAdapter, createNodeWorkspaceId, getNodeStateCorruptionDiagnostics, getNodeStatePaths, getNodeStateSchemaDiagnostic, initializeNodeStateRoot, resolveNodeSettingsPaths, resolveNodeStateRoot, assertNodeStateSchema, } from "@autopilot-agent/adapters";
 import fs from "node:fs";
 import path from "node:path";
 /** CLI 专用模型行为补充：无结构化 answerer 时以普通正文完成最少必要澄清。 */
@@ -222,9 +222,19 @@ export function createCliCompositionRoot(options = {}) {
     let sandboxPort;
     let sandboxPortRoot;
     function getSandboxPort(workspaceRoot) {
+        // Talk-Plan1022 S1：Windows 宿主执行模式——status/setup/doctor 只报告停用事实，
+        // 不加载 SRT、不触发 UAC provision；macOS 装配保持不变。
+        if (process.platform === "win32") {
+            if (!sandboxPort || sandboxPortRoot !== workspaceRoot) {
+                sandboxPort = createNodeHostExecutionSandboxPort();
+                sandboxPortRoot = workspaceRoot;
+            }
+            return sandboxPort;
+        }
         if (!sandboxPort || sandboxPortRoot !== workspaceRoot) {
             sandboxPort = createNodeSandboxPort({
                 workspaceRoot,
+                stateRoot,
                 tempRoot: path.join(workspaceRoot, ".autopilot", "tmp"),
             });
             sandboxPortRoot = workspaceRoot;
@@ -338,6 +348,7 @@ export function createCliCompositionRoot(options = {}) {
             initializeNodeStateRoot(stateRoot);
             return createNodeRuntimePorts({
                 stateRoot,
+                trustRoot: options.trustRoot,
                 workspaceRoot,
                 env,
                 userSettingsPath: resolveNodeSettingsPaths(workspaceRoot).user,
@@ -355,6 +366,7 @@ export function createCliCompositionRoot(options = {}) {
                 const visionRef = resolvedSettings.visionModelRef === false ? undefined : resolvedSettings.visionModelRef ?? resolvedSettings.modelRef;
                 const visionRoute = visionRef && resolvedSettings.providerRoutes[visionRef.provider];
                 return {
+                    ...(resolvedSettings.maxTurns !== undefined ? { maxSteps: resolvedSettings.maxTurns } : {}),
                     ...(resolvedSettings.modelRef ? { modelRef: resolvedSettings.modelRef } : {}),
                     ...(resolvedSettings.reasoningProfile ? { reasoningProfile: resolvedSettings.reasoningProfile } : {}),
                     ...(selectedProvider?.credentialRef ? { credentialRef: selectedProvider.credentialRef } : {}),

package/dist/context-report.d.ts

@@ -16,5 +16,5 @@ export declare function formatContextReportLines(usage: ContextUsageView | null,
 }): string[];
 /** Plain/非 TTY 的稳定文本报告；始终跳过装饰网格。 */
 export declare function formatPlainContextReport(usage: ContextUsageView | null, expanded: boolean): string[];
-/** 状态栏 Context 行的紧凑文本：`12.3% · measured` / `≈1.2% · estimated` / `unknown`。 */
+/** 状态栏只显示整个窗口的整数剩余百分比；计量来源留在 /context all。 */
 export declare function formatTuiContextStatus(usage: ContextUsageView | null): string;

package/dist/context-report.js

@@ -165,10 +165,9 @@ export function formatContextReportLines(usage, expanded, options) {
 export function formatPlainContextReport(usage, expanded) {
     return formatContextReportLines(usage, expanded, { grid: false, columns: Number.MAX_SAFE_INTEGER });
 }
-/** 状态栏 Context 行的紧凑文本：`12.3% · measured` / `≈1.2% · estimated` / `unknown`。 */
+/** 状态栏只显示整个窗口的整数剩余百分比；计量来源留在 /context all。 */
 export function formatTuiContextStatus(usage) {
     if (!usage)
         return "unknown";
-    const percent = formatPercent(usage.usageRatio);
-    return `${usage.measurement === "measured" ? "" : "≈"}${percent} · ${usage.measurement}`;
+    return `${Math.round(Math.max(0, 1 - usage.usageRatio) * 100)}%`;
 }

package/dist/controller.js

@@ -126,6 +126,62 @@ export function createCliController(options) {
         ];
         return result("ok", 0, lines, { permissionOptions, statusView });
     }
+    /** 合并 Session 级与 Workspace 级持久授权为当前会话可见列表；按 scope+身份去重。 */
+    async function listVisiblePermissionGrants() {
+        if (!options.runtime)
+            return [];
+        const grants = new Map();
+        const collect = function collectGrant(grant) {
+            grants.set(`${grant.scope}|${grant.toolName}|${grant.constraint}|${grant.workspaceRoot ?? ""}|${grant.sessionId ?? ""}`, grant);
+        };
+        if (sessionId)
+            for (const grant of await options.runtime.approvals.listPersistentGrants({ sessionId }))
+                collect(grant);
+        if (options.workspaceRoot)
+            for (const grant of await options.runtime.approvals.listPersistentGrants({ workspaceRoot: options.workspaceRoot }))
+                collect(grant);
+        return [...grants.values()];
+    }
+    /** 列出当前 Session/工作区可见的持久授权；只展示 Core 冻结的脱敏事实。 */
+    async function listPermissionGrants() {
+        if (!options.runtime)
+            return result("error", 1, [], "CLI_RUNTIME_NOT_ATTACHED");
+        const grants = await listVisiblePermissionGrants();
+        if (grants.length === 0)
+            return result("ok", 0, ["当前 Session/工作区没有可见的持久授权。"]);
+        const lines = grants.map(function formatGrantLine(grant, index) {
+            const scope = grant.scope === "allow_workspace" ? "工作区" : "会话";
+            const projection = grant.projection === "pending" ? " · 记住未同步（待重新批准）" : "";
+            return `${index + 1}. [${scope}] ${grant.toolName} · ${grant.constraint}${projection}`;
+        });
+        lines.push("撤销：/permissions revoke <constraint>（constraint 请按列表原样复制）");
+        return result("ok", 0, lines);
+    }
+    /** 按 toolName+constraint 精确撤销当前可见授权；Core 先删 grant 权威再删 local 投影规则。 */
+    async function revokePermissionGrant(constraint) {
+        if (!options.runtime)
+            return result("error", 1, [], "CLI_RUNTIME_NOT_ATTACHED");
+        if (!sessionId || !options.workspaceRoot)
+            return result("error", 2, [], "CLI_APPROVAL_NOT_AVAILABLE");
+        const grants = await listVisiblePermissionGrants();
+        const targets = grants.filter(function matchConstraint(grant) { return grant.constraint === constraint; });
+        if (targets.length === 0)
+            return result("error", 2, [], "CLI_PERMISSION_GRANT_NOT_FOUND");
+        const lines = [];
+        for (const grant of targets) {
+            const outcome = await options.runtime.approvals.revokePersistentGrant({
+                workspaceRoot: options.workspaceRoot,
+                sessionId,
+                toolName: grant.toolName,
+                constraint,
+            });
+            if (!outcome.deleted)
+                return result("error", 1, [], "CLI_PERMISSION_GRANT_REVOKE_FAILED");
+            lines.push(`已撤销 [${grant.scope === "allow_workspace" ? "工作区" : "会话"}] ${grant.toolName} · ${grant.constraint}${outcome.ruleRemoved ? "，并已删除工作区记住规则" : ""}`);
+        }
+        lines.push("后续同范围操作将重新请求授权。");
+        return result("ok", 0, lines);
+    }
     /** 读-合并-写入 Session 默认权限，只改变 permissionMode 并保留其他配置字段。 */
     async function setPermissionMode(mode) {
         if (!sessionId)
@@ -631,6 +687,10 @@ export function createCliController(options) {
             return openPermissions();
         if (action.type === "set_permission_mode")
             return setPermissionMode(action.mode);
+        if (action.type === "list_permission_grants")
+            return listPermissionGrants();
+        if (action.type === "revoke_permission_grant")
+            return revokePermissionGrant(action.constraint);
         if (action.type === "open_model_picker")
             return openModelPicker();
         if (action.type === "set_model")

package/dist/design-tokens.d.ts

@@ -20,6 +20,10 @@ export declare const TUI_CHIP_TEXT_COLOR = "ansi256(16)";
 export declare const TUI_TOOL_SUCCESS_COLOR = "ansi256(46)";
 /** 工具失败文字的辅助红；状态永远带文字标签，不靠颜色传达。 */
 export declare const TUI_TOOL_ERROR_COLOR = "ansi256(196)";
+/** 失败徽标的红色背景；与错误文字共用语义红，NO_COLOR 时仍显示状态文字。 */
+export declare const TUI_TOOL_ERROR_BG_COLOR = "ansi256(196)";
+/** 红底失败徽标使用深色粗体文字，便于和错误背景形成明确边界。 */
+export declare const TUI_TOOL_ERROR_TEXT_COLOR = "ansi256(16)";
 /** Skill 已启用开关的语义色。 */
 export declare const TUI_SKILL_ON_COLOR = "ansi256(46)";
 /** Skill 未启用开关的语义色。 */

package/dist/design-tokens.js

@@ -20,6 +20,10 @@ export const TUI_CHIP_TEXT_COLOR = "ansi256(16)";
 export const TUI_TOOL_SUCCESS_COLOR = "ansi256(46)";
 /** 工具失败文字的辅助红；状态永远带文字标签，不靠颜色传达。 */
 export const TUI_TOOL_ERROR_COLOR = "ansi256(196)";
+/** 失败徽标的红色背景；与错误文字共用语义红，NO_COLOR 时仍显示状态文字。 */
+export const TUI_TOOL_ERROR_BG_COLOR = TUI_TOOL_ERROR_COLOR;
+/** 红底失败徽标使用深色粗体文字，便于和错误背景形成明确边界。 */
+export const TUI_TOOL_ERROR_TEXT_COLOR = TUI_CHIP_TEXT_COLOR;
 /** Skill 已启用开关的语义色。 */
 export const TUI_SKILL_ON_COLOR = "ansi256(46)";
 /** Skill 未启用开关的语义色。 */

package/dist/event-projector.js

@@ -90,7 +90,7 @@ function cloneProjection(previous, envelope) {
         ...previous,
         turnId: envelope.turnId,
         lastSeq: Math.max(previous.lastSeq ?? 0, envelope.seq),
-        activeSkills: previous.activeSkills.map(function copySkill(skill) { return { ...skill }; }),
+        activeSkills: previous.activeSkills,
         events: [...previous.events],
         seenKeys,
     };
@@ -113,7 +113,7 @@ function applyCheckpoint(projection, checkpoint, seq, turnId) {
     if (sameSkills(projection.activeSkills, activeSkills))
         return;
     projection.activeSkills = activeSkills;
-    projection.events.push({ type: "active_skills", seq, turnId, skills: activeSkills });
+    appendEvent(projection, { type: "active_skills", seq, turnId, skills: activeSkills });
 }
 /** 将安全事件追加到投影事件列表。 */
 function appendEvent(projection, event) {
@@ -187,6 +187,7 @@ function projectEvent(envelope, projection) {
                     toolName: sanitizeText(event.toolName, 160),
                     reason,
                     risk: display?.risk,
+                    constraint: event.result.approval.constraint,
                     allowedDecisions,
                     display,
                 };
@@ -198,6 +199,7 @@ function projectEvent(envelope, projection) {
                     toolName: sanitizeText(event.toolName, 160),
                     reason,
                     risk: display?.risk,
+                    constraint: event.result.approval.constraint,
                     allowedDecisions,
                     display,
                 };

package/dist/parser.js

@@ -15,7 +15,7 @@ export const CLI_SLASH_COMMANDS = [
     { name: "/model", usage: "/model", description: "查看或设置下一个 Turn 的模型" },
     { name: "/effort", usage: "/effort", description: "查看或设置下一个 Turn 的推理强度" },
     { name: "/skill", usage: "/skill [name]", description: "打开 Skill picker 或选择 Skill" },
-    { name: "/permissions", usage: "/permissions [mode]", description: "查看或设置 Session 权限模式" },
+    { name: "/permissions", usage: "/permissions [mode | grants | revoke <constraint>]", description: "查看/设置权限模式，或查看与撤销持久授权" },
     { name: "/approve", usage: "/approve <decision>", description: "提交当前工具审批决定" },
     { name: "/undo", usage: "/undo [confirm]", description: "预览并确认撤销当前会话最近一轮文件修改" },
 ];
@@ -54,7 +54,7 @@ export function renderHelp() {
         "  -h, --help               show this help",
         "",
         "Permissions: ask requires confirmation; auto_approve only auto-runs safe writes and workspace commands after Trust; full_access still enforces path, schema, and destructive-command guards.",
-        "Limits: AGENT_MAX_STEPS is optional (unset means no total step cap); AGENT_MAX_TOOL_RETRIES defaults to 5; Turn overrides win and values are capped at 100 and 10.",
+        "Limits: settings.json maxTurns, AGENT_MAX_STEPS and AGENT_MAX_DURATION_MS are optional (unset means no step/time cap); maxTurns maps to per-run steps without a fixed platform cap; AGENT_MAX_TOOL_RETRIES defaults to 5 and is capped at 10.",
         "Exit codes: 0 success/normal exit, 1 runtime error, 2 usage error, 130 SIGINT, 143 SIGTERM.",
         "Interactive uses Ink on a TTY and Plain fallback otherwise; --output jsonl never emits ANSI or prompts.",
     ].join("\n");
@@ -359,12 +359,21 @@ function isApprovalDecision(value) {
 function invalidSlashArguments(name) {
     return { kind: "error", message: `/${name} 不接受额外参数` };
 }
-/** 解析权限模式查询与 Session 默认权限更新。 */
+/** 解析权限模式查询、Session 默认权限更新与持久授权查看/撤销（Talk-Plan1013 Stage 4）。 */
 function parsePermissionsAction(parts) {
     if (parts.length === 1)
         return { kind: "action", action: { type: "open_permissions" } };
+    if (parts.length === 2 && parts[1] === "grants")
+        return { kind: "action", action: { type: "list_permission_grants" } };
+    if (parts[1] === "revoke") {
+        if (parts.length === 2)
+            return { kind: "error", message: "/permissions revoke 需要从 /permissions grants 列表中复制的完整 constraint" };
+        // constraint 由 ext-file:/path:/program: 前缀与路径组成，路径可含空格，按原样拼接且不再拆分。
+        const constraint = parts.slice(2).join(" ").trim();
+        return { kind: "action", action: { type: "revoke_permission_grant", constraint } };
+    }
     if (parts.length !== 2 || !isPermissionMode(parts[1])) {
-        return { kind: "error", message: "/permissions 需要 ask|auto_approve|full_access" };
+        return { kind: "error", message: "/permissions 需要 ask|auto_approve|full_access 或 grants | revoke <constraint>" };
     }
     return { kind: "action", action: { type: "set_permission_mode", mode: parts[1] } };
 }

package/dist/renderer.js

@@ -5,6 +5,10 @@
  * Store、checkpoint 或 Web SSE DTO；因此 text 与 JSONL 的语义来源一致。
  */
 import { formatAgentTermination } from "./termination-format.js";
+/** 判断审批约束是否为无沙箱直接执行；与 Web 审批卡同一字符串判定，休眠底座不签发，历史记录仍可能携带。 */
+function isNoSandboxApproval(constraint) {
+    return constraint === "no-sandbox-exec:v1";
+}
 /** 将安全事件渲染为不带 ANSI 的 Plain 文本行。 */
 function renderTextEvent(event) {
     switch (event.type) {
@@ -15,8 +19,18 @@ function renderTextEvent(event) {
         case "answer_reset": return "answer reset";
         case "tool_started": return `tool ${event.toolName}: ${event.summary}`;
         case "tool_progress": return `tool ${event.toolName}: ${event.tail}`;
-        case "tool_result": return `tool ${event.toolName} [${event.status}]: ${event.summary}${event.errorCode ? ` (${event.errorCode})` : ""}${event.diff ? `\n${event.diff}` : ""}`;
-        case "approval_required": return `approval ${event.approvalId}: ${event.toolName} ${event.reason}`;
+        case "tool_result": {
+            const isolation = event.display?.executionMode === "unisolated" ? " · 未隔离：宿主直接执行" : "";
+            const diagnostics = event.display?.diagnostics?.length ? ` · 诊断：${event.display.diagnostics.join("；")}` : "";
+            return `tool ${event.toolName} [${event.status}]: ${event.summary}${event.errorCode ? ` (${event.errorCode})` : ""}${diagnostics}${isolation}${event.diff ? `\n${event.diff}` : ""}`;
+        }
+        case "approval_required": {
+            const cwd = event.display?.cwd ? ` · 工作目录：${event.display.cwd}` : "";
+            const noSandbox = isNoSandboxApproval(event.constraint) ? " · 无沙箱直接执行，仅本次有效" : "";
+            // Talk-Plan1022 S3：宿主执行审批卡按"将采用"措辞说明无隔离事实，待审批不显示成已执行。
+            const hostExecution = event.display?.executionMode === "unisolated" ? " · 将在当前用户权限下运行（未启用沙箱隔离）" : "";
+            return `approval ${event.approvalId}: ${event.toolName} ${event.reason}${cwd}${noSandbox}${hostExecution}`;
+        }
         case "input_queued": return `input queued: ${event.inputId} (${event.delivery})`;
         case "todo_updated": {
             const total = event.todos.length;

package/dist/termination-format.js

@@ -4,6 +4,7 @@ export function formatAgentTermination(view) {
         runtime_budget: "执行时长达到上限",
         token_budget: "Token 预算耗尽",
         repeated_tool_calls: "检测到重复工具调用",
+        write_verification: "等待修改文件读回验证",
         stale_lease: "执行租约已过期",
         turn_limit_reached: "达到执行步数上限",
     };

package/dist/tui/app.js

@@ -19,6 +19,7 @@ import { TuiInputArea } from "./input-area.js";
 import { TuiInfoLines, TuiStatusLine } from "./status-line.js";
 import { TuiJobs } from "./jobs.js";
 import { TuiLiveTurn } from "./timeline/turn.js";
+import { getTuiTurnTodo } from "./timeline/turn-items.js";
 import { MemoizedTuiTranscriptItem, TuiPendingInputItem, TuiPromptLine } from "./transcript.js";
 import { getTuiSelectedText } from "./viewport/selection.js";
 import { createTuiViewportSourceCache } from "./viewport/sources.js";
@@ -81,10 +82,11 @@ export function CliTuiApp(props) {
         .slice(-4)
         .map(function getNoticeMessage(item) { return item.message; });
     const approvalHeight = isViewportMode && snapshot.pendingApproval ? createTuiApprovalOptions(snapshot.pendingApproval).length + 6 : 0;
-    const fixedHeight = inputLayout.promptHeight + inputLayout.pickerHeight + approvalHeight + infoMessages.length + 1 + (statusView ? 5 : 2);
-    const viewportHeight = Math.max(1, rows - fixedHeight);
     // Todo 展开态最多占 10 行；矮终端为输入框、状态栏和活动文案至少保留 6 行。
     const todoRowLimit = Math.max(2, Math.min(10, rows - 6));
+    const activeTodoForm = getTuiTurnTodo(snapshot.liveEvents, snapshot.liveTurnId ?? "")?.todos.find(function active(todo) { return todo.status === "in_progress"; })?.activeForm;
+    const fixedHeight = inputLayout.promptHeight + inputLayout.pickerHeight + approvalHeight + infoMessages.length + 1 + (statusView ? 5 : 2);
+    const viewportHeight = Math.max(1, rows - fixedHeight);
     const viewportSourceCacheRef = useRef(undefined);
     if (!viewportSourceCacheRef.current)
         viewportSourceCacheRef.current = createTuiViewportSourceCache();
@@ -94,9 +96,9 @@ export function CliTuiApp(props) {
     const viewportContentWidth = Math.max(1, columns - 1);
     const viewportSources = useMemo(function getCachedViewportSources() {
         return isViewportMode
-            ? viewportSourceCacheRef.current.getSources(snapshot, statusView, pickers.approvalPickerIndex, viewportContentWidth, todoExpanded, props.useColor)
+            ? viewportSourceCacheRef.current.getSources(snapshot, statusView, pickers.approvalPickerIndex, viewportContentWidth, todoExpanded, props.useColor, todoRowLimit)
             : EMPTY_VIEWPORT_SOURCES;
-    }, [isViewportMode, pickers.approvalPickerIndex, snapshot, statusView, viewportContentWidth, todoExpanded, props.useColor]);
+    }, [isViewportMode, pickers.approvalPickerIndex, snapshot, statusView, viewportContentWidth, todoExpanded, props.useColor, todoRowLimit]);
     const viewportLines = useMemo(function getCachedViewportLines() {
         return isViewportMode
             ? viewportLineCacheRef.current.getLines(viewportSources, viewportContentWidth)
@@ -120,6 +122,7 @@ export function CliTuiApp(props) {
             return;
         const isJobAction = action.type === "list_jobs" || action.type === "show_job" || action.type === "read_job_output" || action.type === "stop_job";
         const jobGeneration = isJobAction ? ++jobRequestGeneration.current : undefined;
+        const inputPosition = prompt && allowWhileRunning ? props.store.captureInputPosition() : undefined;
         if (prompt) {
             lastSubmittedPromptRef.current = prompt.trim();
             props.store.recordPrompt(prompt, !allowWhileRunning);
@@ -177,9 +180,9 @@ export function CliTuiApp(props) {
         }
         if (result.contextView)
             setContextView(result.contextView);
-        await refreshStatusView();
         if (prompt && result.submittedInput)
-            props.store.addPendingPrompt(prompt, result.submittedInput);
+            props.store.addPendingPrompt(prompt, result.submittedInput, inputPosition);
+        await refreshStatusView();
         if (result.skillOptions) {
             pickers.setSkillPickerSkills(result.skillOptions);
             if (!preserveSkillPickerQuery)
@@ -405,6 +408,6 @@ export function CliTuiApp(props) {
                         }
                         return _jsx(TuiBrandHeader, { statusView: statusView, columns: columns, useColor: props.useColor, screenReader: props.screenReader, reducedMotion: props.reducedMotion ?? false, animationActive: false }, item.key);
                     }), activePrompt ? _jsx(TuiPromptLine, { content: activePrompt.content, columns: columns, useColor: props.useColor, keyValue: activePrompt.key }) : null, _jsx(TuiLiveTurn, { turnId: isLiveTurnTerminal ? undefined : snapshot.liveTurnId, events: snapshot.liveEvents, presentation: snapshot.livePresentation, pendingApproval: snapshot.pendingApproval, approvalSelectedIndex: pickers.approvalPickerIndex, status: snapshot.status, metrics: snapshot.liveMetrics, useColor: props.useColor, screenReader: props.screenReader, todoExpanded: todoExpanded, todoRowLimit: todoRowLimit, maximumWidth: Math.max(1, columns - 2) }), snapshot.pendingInputs.map(function renderPendingInput(item) {
-                        return _jsx(TuiPendingInputItem, { item: item, useColor: props.useColor }, item.key);
-                    })] }), _jsx(TuiActivityLine, { activity: snapshot.activity, status: snapshot.status, waitingForApproval: snapshot.pendingApproval !== undefined, useColor: props.useColor, screenReader: props.screenReader, reducedMotion: props.reducedMotion ?? false, animationActive: animationActive, clock: animationClock }), _jsx(TuiInfoLines, { messages: infoMessages, useColor: props.useColor }), _jsx(TuiInputArea, { store: props.store, columns: columns, busy: busy, keepOpenAfterCancel: keepOpenAfterCancel, lastSubmittedPromptRef: lastSubmittedPromptRef, rawInputSequenceRef: rawInputSequenceRef, dispatchAction: dispatchAction, onEof: props.onEof, onRequestInterrupt: props.onRequestInterrupt, onRequestCancel: props.onRequestCancel, isRawModeSupported: isRawModeSupported, isInputActive: jobView === undefined && contextView === undefined, showInput: jobView === undefined && contextView === undefined, useColor: props.useColor, screenReader: props.screenReader, pickers: pickers, derivedRef: derivedRef, fileMentionIndex: fileMentionIndex, onLayoutChange: handleInputLayoutChange }), _jsx(TuiStatusLine, { snapshot: snapshot, statusView: statusView, useColor: props.useColor, screenReader: props.screenReader, selectionCharacters: selectedText.length })] }));
+                        return item.delivery === "queue" ? _jsx(TuiPendingInputItem, { item: item, useColor: props.useColor }, item.key) : null;
+                    })] }), _jsx(TuiActivityLine, { activity: snapshot.activity, status: snapshot.status, waitingForApproval: snapshot.pendingApproval !== undefined, useColor: props.useColor, screenReader: props.screenReader, reducedMotion: props.reducedMotion ?? false, animationActive: animationActive, clock: animationClock, startedAt: snapshot.liveMetrics?.startedAt, activeForm: activeTodoForm }), _jsx(TuiInfoLines, { messages: infoMessages, useColor: props.useColor }), _jsx(TuiInputArea, { store: props.store, columns: columns, busy: busy, keepOpenAfterCancel: keepOpenAfterCancel, lastSubmittedPromptRef: lastSubmittedPromptRef, rawInputSequenceRef: rawInputSequenceRef, dispatchAction: dispatchAction, onEof: props.onEof, onRequestInterrupt: props.onRequestInterrupt, onRequestCancel: props.onRequestCancel, isRawModeSupported: isRawModeSupported, isInputActive: jobView === undefined && contextView === undefined, showInput: jobView === undefined && contextView === undefined, useColor: props.useColor, screenReader: props.screenReader, pickers: pickers, derivedRef: derivedRef, fileMentionIndex: fileMentionIndex, onLayoutChange: handleInputLayoutChange }), _jsx(TuiStatusLine, { snapshot: snapshot, statusView: statusView, useColor: props.useColor, screenReader: props.screenReader, selectionCharacters: selectedText.length })] }));
 }

package/dist/tui/approval.d.ts

@@ -8,7 +8,7 @@ export interface CliTuiApprovalOption {
     }>["decision"];
     label: string;
 }
-/** 根据待审批工具收窄菜单；ask 下命令不提供可持久化授权。 */
+/** 根据待审批工具收窄菜单；旧记录缺少冻结范围时保持最保守的单次/拒绝。 */
 export declare function createTuiApprovalOptions(pendingApproval: NonNullable<CliProjection["pendingApproval"]>): CliTuiApprovalOption[];
 /** 以 CC 风格上下选择、回车确认渲染当前审批菜单。 */
 export declare function TuiApprovalPrompt(props: {