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

package/README.md

@@ -32,8 +32,10 @@
 - 📱 **Step away from your desk. Stay with the task.** Follow tool activity, inspect file changes, handle permission requests, and answer Codex's questions from your computer or phone. Closing the page doesn't cancel the task.
 - 🗂️ **See every project in one place.** Run independent tasks in parallel and spot which conversations are working, waiting for approval, or ready to read.
 - 💬 **Pick up your Codex CLI conversations.** Browse saved history, resume existing work, or fork a new direction. Rename conversations to find them later and archive them when you're done.
+- ⚡ **Open long conversations sooner.** Recent messages appear first; scrolling preloads older history. On this device, cached pages can appear while the server checks for updates. [Loading and cache behavior](docs/session-history.md).
 - 📖 **Review the work beside the conversation.** Read Markdown documents with code, tables, and images, or open JSON files in a desktop side panel while you keep talking to Codex. JSON previews include indentation, syntax highlighting, and original text for invalid JSON. Copy the unchanged source, with a full-screen reader on mobile. File previews are read-only; Markdown and JSON files have a 2 MiB limit.
 - ✍️ **Switch tasks without losing your draft.** Each conversation keeps its own draft, pasted images, and model settings in the current page. Copy or export results when you're done.
+- 🖥️ **Run a command beside your task.** Open **Shell** to execute commands in the selected project's directory, follow stdout/stderr, interrupt a run, and reuse recent commands. The panel uses Codex's configured sandbox, with a ten-minute limit and no interactive input. Closing it keeps the command running. [Capabilities and limits](docs/shell.md).
 
 <details>
   <summary><strong>📱 A workspace that fits your phone</strong></summary>

package/README.zh-CN.md

@@ -32,8 +32,10 @@
 - 📱 **离开电脑，也能跟进任务。** 在电脑或手机上查看工具活动与文件变更、处理权限审批、回答 Codex 的问题。关闭页面，任务仍会继续。
 - 🗂️ **多个项目，一眼掌握进展。** 让独立任务并行执行，随时看到哪些会话正在工作、等待审批，哪些已有结果可读。
 - 💬 **接着你的 Codex CLI 会话。** 浏览已有历史、恢复工作，或 Fork 一个新方向；为会话命名以便查找，完成后归档。
+- ⚡ **更快打开长会话。** 优先显示最近消息，向上滚动时提前加载历史；本机已缓存的分片可先显示，再由服务端核对更新。[加载与缓存说明](docs/session-history.md)。
 - 📖 **一边看产出，一边继续讨论。** 电脑上将 Markdown 文档、JSON 文件与会话并排打开，继续向 Codex 提问；Markdown 支持代码、表格与图片，JSON 支持格式化缩进、语法高亮，格式无效时保留原文，可复制完整原文，手机上也有全屏阅读器。文件预览保持只读，Markdown 和 JSON 文件限制为 2 MiB。
 - ✍️ **切换任务，草稿还在。** 每个会话分别保留当前页面中的草稿、粘贴图片和模型设置；完成后可以复制或导出结果。
+- 🖥️ **在任务旁运行命令。** 打开 **Shell**，在所选项目目录执行命令、查看实时标准输出和错误输出、中断执行，并复用近期命令。面板沿用 Codex 配置的沙箱，最长运行十分钟，不支持交互输入；关闭面板后命令仍继续运行。[能力与限制](docs/shell.md)。
 
 <details>
   <summary><strong>📱 手机上也能舒服地使用</strong></summary>

package/dist/codex/adapter.js

@@ -1,4 +1,5 @@
 import { CODEX_COMPATIBILITY } from "./compatibility.js";
+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";
@@ -36,6 +37,8 @@ import {
 import { CodexError as CodexError2 } from "./transport.js";
 const VERIFIED_CODEX_VERSION = CODEX_COMPATIBILITY.recommended;
 const CAPABILITIES = [
+  "command/exec",
+  "command/exec/terminate",
   "thread/name/set",
   "thread/start",
   "thread/fork",
@@ -84,6 +87,7 @@ class CodexAdapter {
     this.options = options;
   }
   options;
+  commandOutputs = /* @__PURE__ */ new Map();
   epoch = randomUUID();
   child;
   rpc;
@@ -369,13 +373,13 @@ class CodexAdapter {
     });
     if (this.child === child) this.child = void 0;
   }
-  async call(method, params, initializing = false) {
+  async call(method, params, initializing = false, timeoutMs) {
     if (!this.rpc || !initializing && !this.ready)
       throw new CodexError("CODEX_UNAVAILABLE", "Codex is not ready");
     if (this.disabled.has(method))
       throw new CodexError("PROTOCOL_INCOMPATIBLE", `Codex does not support ${method}`);
     try {
-      return await this.rpc.request(method, params);
+      return await this.rpc.request(method, params, void 0, timeoutMs);
     } catch (error) {
       if (!initializing && error instanceof CodexError && error.rpcCode === -32601) {
         this.disabled.add(method);
@@ -532,6 +536,73 @@ class CodexAdapter {
     const sequence = ++this.archiveSequence;
     return this.storedThread(await this.readThreadHeader(id), sequence);
   }
+  async readThreadPage(id, continuation) {
+    const epoch = this.epoch;
+    let cursor = null;
+    if (continuation) {
+      try {
+        const decoded = JSON.parse(Buffer.from(continuation, "base64url").toString("utf8"));
+        if (decoded.threadId !== id || decoded.epoch !== epoch || typeof decoded.cursor !== "string")
+          throw new Error("Invalid cursor");
+        cursor = decoded.cursor;
+      } catch {
+        throw new AppError("HISTORY_CURSOR_EXPIRED", "\u5386\u53F2\u5206\u9875\u5DF2\u5931\u6548\uFF0C\u8BF7\u91CD\u65B0\u540C\u6B65\u4F1A\u8BDD\u3002", 409);
+      }
+    }
+    const sequence = ++this.archiveSequence;
+    const header = await this.readThreadHeader(id);
+    if (header.historyMode !== "paginated") return this.readThread(id);
+    const page = await this.call("thread/turns/list", {
+      threadId: id,
+      cursor,
+      limit: 12,
+      sortDirection: "desc",
+      itemsView: "summary"
+    });
+    if (page.nextCursor && page.nextCursor === cursor)
+      throw new CodexError("PROTOCOL_INCOMPATIBLE", "Invalid turn pagination");
+    await this.hydrateTurns(id, page.data);
+    if (this.epoch !== epoch)
+      throw new AppError("HISTORY_CURSOR_EXPIRED", "\u8BFB\u53D6\u671F\u95F4 Codex \u5DF2\u91CD\u542F\uFF0C\u8BF7\u91CD\u65B0\u540C\u6B65\u4F1A\u8BDD\u3002", 409);
+    const view = await this.storedThread(
+      { ...header, turns: page.data.slice().reverse() },
+      sequence
+    );
+    return {
+      ...view,
+      history: {
+        olderCursor: page.nextCursor ? Buffer.from(
+          JSON.stringify({
+            threadId: id,
+            epoch,
+            cursor: page.nextCursor
+          })
+        ).toString("base64url") : null
+      }
+    };
+  }
+  async hydrateTurns(id, turns) {
+    for (const turn of turns) {
+      if (turn.itemsView === "full") continue;
+      let cursor = null;
+      const seen = /* @__PURE__ */ new Set();
+      turn.items = [];
+      do {
+        const page = await this.call("thread/items/list", {
+          threadId: id,
+          turnId: turn.id,
+          cursor,
+          limit: 20,
+          sortDirection: "asc"
+        });
+        turn.items.push(...page.data.map((entry) => entry.item));
+        cursor = page.nextCursor;
+        if (cursor && (seen.has(cursor) || seen.size >= 1e3))
+          throw new CodexError("PROTOCOL_INCOMPATIBLE", "Invalid item pagination");
+        if (cursor) seen.add(cursor);
+      } while (cursor);
+    }
+  }
   async readThread(id) {
     const sequence = ++this.archiveSequence;
     const thread = await this.readThreadHeader(id);
@@ -722,7 +793,7 @@ class CodexAdapter {
       throw error;
     }
     titles?.register(result);
-    const view = await this.readThread(result.thread.id);
+    const view = await this.readThreadPage(result.thread.id);
     return { ...view, runtimeSettings: await this.responseRuntimeSettings(result) };
   }
   async forkThread(id, cwd, settings) {
@@ -801,11 +872,46 @@ class CodexAdapter {
   async compactThread(id) {
     await this.call("thread/compact/start", { threadId: id });
   }
+  async executeCommand(processId, cwd, command, output) {
+    this.commandOutputs.set(processId, output);
+    try {
+      return await this.call(
+        "command/exec",
+        {
+          processId,
+          cwd,
+          command: process.platform === "win32" ? ["cmd.exe", "/d", "/s", "/c", command] : ["/bin/sh", "-c", command],
+          streamStdoutStderr: true,
+          streamStdin: false,
+          tty: false,
+          timeoutMs: SHELL_TIMEOUT_MS,
+          outputBytesCap: SHELL_OUTPUT_BYTES / 2
+          // Omit sandboxPolicy: preserve the server's configured permission policy.
+        },
+        false,
+        SHELL_TIMEOUT_MS + 5e3
+      );
+    } finally {
+      this.commandOutputs.delete(processId);
+    }
+  }
+  async terminateCommand(processId) {
+    await this.call("command/exec/terminate", { processId });
+  }
   notification(message) {
     if (this.titles?.notification(message)) return;
     const event = message;
     const p = event.params;
     switch (event.method) {
+      case "command/exec/outputDelta": {
+        const { processId, stream, deltaBase64, capReached } = event.params;
+        this.commandOutputs.get(processId)?.(
+          stream,
+          Buffer.from(deltaBase64, "base64"),
+          capReached
+        );
+        break;
+      }
       case "thread/settings/updated":
         {
           const observed = {