@covro/covro 0.5.1-dev.2 → 0.5.1-dev.4

package/README.md

@@ -34,7 +34,17 @@
 - 📖 **Read results while you chat.** Preview documents, diagrams, and code changes beside the conversation on desktop, or full-screen on mobile.
 - 🔔 **Know when your attention is needed.** Enable browser notifications for completed work, questions, and approvals; keep the page open in a supported desktop browser.
 
-Use **＋** in the message box to attach images from your phone or computer. Open the combined model control to choose the model, reasoning effort, and Fast mode.
+Use **＋** in the message box to attach images from your phone or computer. Open the combined model control to choose the model, reasoning effort, Fast mode, and Plan/Execute mode. Use `/plan [task]` to select Plan mode or submit a planning task.
+
+When the selected model is at capacity, Covro shows native retry progress and can make up to three additional attempts after 5, 10, and 20 seconds when Codex does not retry and no output or tool work has started. You can cancel, or choose another model and retry manually. See [retry behavior](docs/capacity-retry.md) for recovery boundaries.
+
+Use `/review` to choose uncommitted changes, a base branch, a commit, or custom review instructions. Use `/init` to request a project contributor guide; an existing `AGENTS.md` is preserved.
+
+Use `/diff` to inspect staged, unstaged, and untracked Git changes in the current workspace without starting a model task. Use `/approve` to explicitly authorize a recorded automatic-review denial once, then ask Codex to continue.
+
+Use `/recap` to summarize recent visible messages in a separate model request without changing conversation context.
+
+Use `/goal` to view and manage a native session goal, its token budget and actual progress. Activating a goal can start automatic continuation; pausing and clearing remain available during a task.
 
 See the [usage guide · 中文](docs/usage.zh-CN.md) for workflow details and controls.
 

package/README.zh-CN.md

@@ -34,7 +34,17 @@
 - 📖 **一边看产出，一边讨论。** 电脑上将文档、图表和代码变更与会话并排阅读，手机上使用全屏阅读器。
 - 🔔 **及时收到待办提醒。** 开启浏览器通知，在工作结束、需要回答或审批时收到提醒；需在支持通知的桌面浏览器中保持页面运行。
 
-点击输入框中的 **＋**，可从手机或电脑选择图片附件。模型、推理强度和 Fast 模式统一收进模型设置入口。
+点击输入框中的 **＋**，可从手机或电脑选择图片附件。模型、推理强度、Fast 和 Plan/执行模式统一收进模型设置入口。使用 `/plan [任务]` 可选择 Plan 模式或直接提交规划任务。
+
+当前模型容量不足时，Covro 会展示原生重试进度；如果 Codex 没有自行重试，且本轮尚无输出或工具操作，会在 5、10、20 秒后最多补偿重试 3 次。可以取消，也可以选择其他模型后手动重试。恢复边界见[容量重试说明](docs/capacity-retry.md)。
+
+使用 `/review` 可选择未提交改动、基础分支、指定 commit 或自定义要求进行代码审查。使用 `/init` 可请求生成项目说明，已有 `AGENTS.md` 会保留。
+
+使用 `/diff` 可查看当前工作区已暂存、未暂存和未跟踪的 Git 改动，不创建模型任务。使用 `/approve` 可显式单次授权一条自动审核拒绝记录，再发送任务让 Codex 继续。
+
+使用 `/recap` 可通过独立模型请求总结近期可见消息，不改变会话上下文。
+
+使用 `/goal` 可查看和管理原生会话目标、Token 预算与实际进度。激活后 Codex 可自动继续工作，任务运行期间仍可暂停或清除目标。
 
 操作方式与使用细节见[使用指南](docs/usage.zh-CN.md)。
 

package/dist/codex/adapter.js

@@ -3,7 +3,13 @@ import { SHELL_TIMEOUT_MS, SHELL_OUTPUT_BYTES } from "../shared/shell.js";
 import { spawn, execFile } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { promisify } from "node:util";
+import { readGoal } from "./thread-goals.js";
+import { GuardianDenials } from "./guardian-denials.js";
 import { ThreadTitles } from "./thread-titles.js";
+import {
+  collaborationSelection,
+  reportedCollaborationMode
+} from "./collaboration.js";
 import { TurnTokenUsage } from "./turn-token-usage.js";
 import { AppError } from "../shared/errors.js";
 import { threadNameError } from "../shared/thread-name.js";
@@ -21,6 +27,7 @@ import {
   mapItem,
   mapThread,
   mapTurn,
+  mapTurnError,
   permissionSettings,
   serviceTierSettings,
   threadSettings,
@@ -53,6 +60,10 @@ const CAPABILITIES = [
   "thread/items/list",
   "turn/start",
   "review/start",
+  "thread/goal/get",
+  "thread/goal/set",
+  "thread/goal/clear",
+  "thread/approveGuardianDeniedAction",
   "turn/steer",
   "turn/interrupt",
   "model/list",
@@ -97,6 +108,7 @@ class CodexAdapter {
   restartTimer;
   restartAttempt = 0;
   titles;
+  denials = new GuardianDenials();
   tokenUsage = new TurnTokenUsage();
   // Ordering only. Persisted archive state belongs exclusively to Codex.
   archiveSequence = 0;
@@ -174,6 +186,7 @@ class CodexAdapter {
       const version = stdout.trim().replace(/^codex-cli\s+/, "");
       this.state.codexVersion = version;
       this.permissionState.clear();
+      this.denials.clear();
       this.state.compatibility = CODEX_COMPATIBILITY.verified.includes(version) ? "verified" : "unverified";
       const child = spawn(
         this.options.binary,
@@ -220,6 +233,7 @@ class CodexAdapter {
         const wasReady = this.ready;
         this.state.ready = false;
         this.tokenUsage.clear();
+        this.denials.clear();
         this.state.connection = "unavailable";
         this.state.error = error.message;
         this.expireActions();
@@ -764,6 +778,9 @@ class CodexAdapter {
     const previous = this.permissionState.get(result.thread.id);
     const settings = {
       model: result.model ?? result.thread.model ?? null,
+      ...reportedCollaborationMode(
+        result.collaborationMode
+      ),
       reasoningEffort: result.reasoningEffort ?? null,
       ...serviceTierSettings(result.serviceTier),
       ...permissionSettings(
@@ -847,15 +864,16 @@ class CodexAdapter {
         threadId: id,
         cwd,
         input: taskInput(text, images),
-        ...turnSettings(cwd, settings)
+        ...turnSettings(cwd, settings),
+        ...collaborationSelection(settings, this.permissionState.get(id))
       })).turn
     );
     return turn;
   }
-  async startReview(id) {
+  async startReview(id, target = { type: "uncommittedChanges" }) {
     const result = await this.call("review/start", {
       threadId: id,
-      target: { type: "uncommittedChanges" },
+      target: target.type === "commit" ? { ...target, title: null } : target,
       delivery: "inline"
     });
     if (!isRecord(result) || result.reviewThreadId !== id)
@@ -876,6 +894,37 @@ class CodexAdapter {
   async interruptTurn(id, turnId) {
     await this.call("turn/interrupt", { threadId: id, turnId });
   }
+  async getGoal(id) {
+    try {
+      return readGoal((await this.call("thread/goal/get", { threadId: id })).goal, id);
+    } catch (error) {
+      if (error instanceof Error && /goals feature is disabled/i.test(error.message))
+        throw new AppError("GOAL_UNAVAILABLE", "\u5F53\u524D Codex \u672A\u542F\u7528 goals \u529F\u80FD", 409);
+      throw error;
+    }
+  }
+  async mutateGoal(id, mutation) {
+    if (mutation.action === "clear") {
+      await this.call("thread/goal/clear", { threadId: id, origin: "user" });
+      return null;
+    }
+    const { action: _, ...fields } = mutation;
+    return readGoal(
+      (await this.call("thread/goal/set", { threadId: id, origin: "user", ...fields })).goal,
+      id
+    );
+  }
+  async recapThread(id, prompt) {
+    if (!this.titles) throw new CodexError("CODEX_UNAVAILABLE", "Codex unavailable");
+    return this.titles.recap(id, prompt);
+  }
+  listGuardianDenials(id) {
+    return this.denials.list(id);
+  }
+  async approveGuardianDenial(id, denialId) {
+    const event = this.denials.take(id, denialId);
+    await this.call("thread/approveGuardianDeniedAction", { threadId: id, event });
+  }
   async compactThread(id) {
     await this.call("thread/compact/start", { threadId: id });
   }
@@ -919,9 +968,18 @@ class CodexAdapter {
         );
         break;
       }
+      case "thread/goal/updated":
+        this.emit({ type: "goal", threadId: event.params.threadId, goal: event.params.goal });
+        break;
+      case "thread/goal/cleared":
+        this.emit({ type: "goal", threadId: event.params.threadId, goal: null });
+        break;
       case "thread/settings/updated":
         {
           const observed = {
+            ...reportedCollaborationMode(
+              event.params.threadSettings.collaborationMode
+            ),
             model: event.params.threadSettings.model ?? null,
             reasoningEffort: event.params.threadSettings.effort ?? null,
             ...serviceTierSettings(event.params.threadSettings.serviceTier),
@@ -944,6 +1002,7 @@ class CodexAdapter {
         break;
       case "item/autoApprovalReview/started":
       case "item/autoApprovalReview/completed":
+        if (event.method === "item/autoApprovalReview/completed") this.denials.record(event.params);
         this.emit({
           type: "autoReview",
           threadId: event.params.threadId,
@@ -1088,7 +1147,8 @@ class CodexAdapter {
           threadId: event.params.threadId,
           turnId: event.params.turnId,
           message: event.params.error.message,
-          willRetry: event.params.willRetry
+          willRetry: event.params.willRetry,
+          ...mapTurnError(event.params.error)
         });
         break;
       default:
@@ -1100,7 +1160,7 @@ class CodexAdapter {
       await this.rpc?.reject(
         message.id,
         -32601,
-        "Interactive tools are disabled for title generation"
+        "Interactive tools are disabled for isolated helper requests"
       );
       return;
     }