lark-remote 0.5.0 → 0.5.2

package/dist/runner/codex/app-server/runner.d.ts

@@ -42,6 +42,8 @@ export declare class CodexAppServerRunner extends ConnectionBasedRunner<JsonRpcC
     private connectionManager;
     private currentTranslator;
     private activeThreadId;
+    /** 本轮已记录过日志的外来（子 agent）线程 id，避免逐条 delta 刷盘。 */
+    private foreignThreadIds;
     private model?;
     private modelProvider?;
     private reasoningEffort?;
@@ -91,7 +93,33 @@ export declare class CodexAppServerRunner extends ConnectionBasedRunner<JsonRpcC
      * thread/resume（按 sessionId 恢复既有线程）→ turn/start。
      */
     protected setupTurn(message: string, opts: SpawnOptions): Promise<void>;
+    /**
+     * Route one server notification into the current turn's translator.
+     *
+     * App-server 把已知线程的通知全部复用同一条 stdio 连接：agent 用
+     * multi-agent v2 派生子 agent 后，子线程的 `turn/started`、`item/*`、
+     * `turn/completed`、`thread/tokenUsage/updated` 会与本轮通知交错到达
+     * （2026-10-09 实测）。一个 turn 只属于一个线程，因此外来线程的通知一律
+     * 丢弃——否则子线程的 `turn/started` 会覆盖本轮 threadId，会话写回把子
+     * 线程 id 当成顶层会话指针存盘（冷连接 `thread/resume` 直接报
+     * "cannot resume an unloaded multi-agent v2 sub-agent"），且子线程的
+     * `turn/completed` 会提前结束本轮 run、token 用量也会串台。
+     */
     private handleNotification;
+    /**
+     * 线程归属闸门：通知是否属于本轮 turn 的线程。
+     *
+     * - 无 threadId 的通知（如部分 warning）没有线程维度可用，放行；
+     * - `serverRequest/resolved` 保持线程无关：审批按 requestId 关联（桥侧
+     *   ApprovalCoordinator 跟踪），子 agent 的审批同样必须能结算，否则卡片
+     *   上的审批条目会一直挂在 pending。
+     */
+    private belongsToActiveThread;
+    /**
+     * 每个被忽略的外来线程只记一条日志：这是会话指针被污染的入口，出问题时
+     * 必须能从日志直接看到「本轮忽略了哪些子线程」，同时避免逐条 delta 刷盘。
+     */
+    private noteForeignThread;
     private handleServerRequest;
     private buildGrantedPermissions;
     /** 拒绝权限审批：空 fileSystem + 关闭网络（真实 GrantedPermissionProfile）。 */

package/dist/runner/codex/app-server/runner.js

@@ -12,6 +12,7 @@
  */
 import { ConnectionManager, } from '../../common/jsonrpc/connection-manager.js';
 import { CodexAppServerTranslator } from './translator.js';
+import { NotificationMethod, } from './protocol-types.js';
 import { RpcErrorCode } from '../../common/acp/protocol-types.js';
 import { mapAnswersByIndex } from '../../question-common.js';
 import { getLogger } from '../../../logger/index.js';
@@ -102,6 +103,8 @@ export class CodexAppServerRunner extends ConnectionBasedRunner {
     connectionManager;
     currentTranslator = null;
     activeThreadId = null;
+    /** 本轮已记录过日志的外来（子 agent）线程 id，避免逐条 delta 刷盘。 */
+    foreignThreadIds = new Set();
     model;
     modelProvider;
     reasoningEffort;
@@ -171,6 +174,7 @@ export class CodexAppServerRunner extends ConnectionBasedRunner {
     clearTurnState() {
         this.currentTranslator = null;
         this.activeThreadId = null;
+        this.foreignThreadIds.clear();
     }
     async releaseConnection(cwd) {
         await this.connectionManager.release(cwd);
@@ -362,7 +366,8 @@ export class CodexAppServerRunner extends ConnectionBasedRunner {
             // 故 thread.id 可同时用作协议 threadId 与 store/session reader 的 session
             // 键（bridge 用 turn_started 通知的 threadId 写回，/resume、Compact 按此
             // 键定位 JSONL）。forked/subagent 线程二者会分叉（openai/codex#29327），
-            // 桥只把主线程作为顶层会话，不在此链路内。
+            // 桥只把主线程作为顶层会话——子线程的通知由 handleNotification 的线程
+            // 归属闸门挡掉，不会进来（见 belongsToActiveThread）。
             threadId = threadResult.thread.id;
         }
         this.activeThreadId = threadId;
@@ -372,10 +377,58 @@ export class CodexAppServerRunner extends ConnectionBasedRunner {
         const turnResult = await client.request('turn/start', turnParams);
         this.currentTurnId = turnResult.turn.id;
     }
+    /**
+     * Route one server notification into the current turn's translator.
+     *
+     * App-server 把已知线程的通知全部复用同一条 stdio 连接：agent 用
+     * multi-agent v2 派生子 agent 后，子线程的 `turn/started`、`item/*`、
+     * `turn/completed`、`thread/tokenUsage/updated` 会与本轮通知交错到达
+     * （2026-10-09 实测）。一个 turn 只属于一个线程，因此外来线程的通知一律
+     * 丢弃——否则子线程的 `turn/started` 会覆盖本轮 threadId，会话写回把子
+     * 线程 id 当成顶层会话指针存盘（冷连接 `thread/resume` 直接报
+     * "cannot resume an unloaded multi-agent v2 sub-agent"），且子线程的
+     * `turn/completed` 会提前结束本轮 run、token 用量也会串台。
+     */
     handleNotification(method, params) {
+        if (!this.belongsToActiveThread(method, params)) {
+            this.noteForeignThread(params);
+            return;
+        }
         const events = this.currentTranslator?.handleNotification(method, params) ?? [];
         this.pushEvents(events);
     }
+    /**
+     * 线程归属闸门：通知是否属于本轮 turn 的线程。
+     *
+     * - 无 threadId 的通知（如部分 warning）没有线程维度可用，放行；
+     * - `serverRequest/resolved` 保持线程无关：审批按 requestId 关联（桥侧
+     *   ApprovalCoordinator 跟踪），子 agent 的审批同样必须能结算，否则卡片
+     *   上的审批条目会一直挂在 pending。
+     */
+    belongsToActiveThread(method, params) {
+        const active = this.activeThreadId;
+        if (!active)
+            return true;
+        if (method === NotificationMethod.SERVER_REQUEST_RESOLVED)
+            return true;
+        const threadId = params?.threadId;
+        if (typeof threadId !== 'string' || threadId.length === 0)
+            return true;
+        return threadId === active;
+    }
+    /**
+     * 每个被忽略的外来线程只记一条日志：这是会话指针被污染的入口，出问题时
+     * 必须能从日志直接看到「本轮忽略了哪些子线程」，同时避免逐条 delta 刷盘。
+     */
+    noteForeignThread(params) {
+        const threadId = params?.threadId;
+        if (typeof threadId !== 'string' || threadId.length === 0)
+            return;
+        if (this.foreignThreadIds.has(threadId))
+            return;
+        this.foreignThreadIds.add(threadId);
+        getLogger().info(`[${this.logTag}] ignoring notifications from foreign thread threadId=${threadId} activeThreadId=${this.activeThreadId}`);
+    }
     handleServerRequest(id, method, params) {
         const events = this.currentTranslator?.handleServerRequest(id, method, params) ?? [];
         if (events.length === 0) {

package/dist/runner/codex/app-server/translator.js

@@ -456,10 +456,18 @@ export class CodexAppServerTranslator {
     }
     handleTokenUsageUpdated(params) {
         const last = params.tokenUsage.last;
+        // 协议原生 inputTokens 含 cached（total = input + output），而 lark-remote 的
+        // 卡片契约是 ccusage 口径「input_tokens 表示未命中缓存的输入」（design §9.21）。
+        // 在入口归一，否则 done 卡 Input 会等于 Context、cache% 分母重复计数、
+        // Total 被 max(total, input+output+cache) 抬高一倍（实测 364K → 727K）。
+        // jsonl 链路有同一处减法（session/codex/rollout-reader.ts buildUsageFromScan）。
+        const cachedInputTokens = last.cachedInputTokens === undefined
+            ? undefined
+            : Math.min(last.cachedInputTokens, last.inputTokens);
         this.usage = {
-            inputTokens: last.inputTokens,
+            inputTokens: last.inputTokens - (cachedInputTokens ?? 0),
             outputTokens: last.outputTokens,
-            cachedInputTokens: last.cachedInputTokens,
+            cachedInputTokens,
             totalTokens: last.totalTokens,
             contextLimit: params.tokenUsage.modelContextWindow,
         };

package/dist/runner/types.d.ts

@@ -402,7 +402,16 @@ export interface Runner {
      */
     unregisterExitHandlers?(): void;
 }
-export type AgentKind = 'claude' | 'codex' | 'opencode' | 'pi' | 'kimi' | 'dsh';
+/**
+ * Agent 名单单源（运行时数组 + 类型同源，二者不可能漂移）。
+ *
+ * 历史上这份名单被手抄成多份（router 的 VALID_AGENTS、bridge 的 resume.compact
+ * 校验、各 agent 的 config builder…），漂移过：dsh 加入后 bridge 的
+ * resume.compact 仍只有 5 个，带 dsh 的 resume 卡片会静默退回 defaultAgent。
+ * 新增 agent 只改这里。
+ */
+export declare const AGENT_KINDS: readonly ["claude", "codex", "opencode", "pi", "kimi", "dsh"];
+export type AgentKind = (typeof AGENT_KINDS)[number];
 /** Unified session descriptor returned by every AgentSessionReader. */
 export interface AgentSession {
     sessionId: string;

package/dist/runner/types.js

@@ -4,5 +4,16 @@
  * 本文件包含所有 Agent 相关的类型定义，从 runner/index.ts 提取。
  * 所有下游模块应从本文件 import 类型，而非直接依赖实现。
  */
-export {};
+// =============================================================================
+// Multi-Agent Adapter Types
+// =============================================================================
+/**
+ * Agent 名单单源（运行时数组 + 类型同源，二者不可能漂移）。
+ *
+ * 历史上这份名单被手抄成多份（router 的 VALID_AGENTS、bridge 的 resume.compact
+ * 校验、各 agent 的 config builder…），漂移过：dsh 加入后 bridge 的
+ * resume.compact 仍只有 5 个，带 dsh 的 resume 卡片会静默退回 defaultAgent。
+ * 新增 agent 只改这里。
+ */
+export const AGENT_KINDS = ['claude', 'codex', 'opencode', 'pi', 'kimi', 'dsh'];
 //# sourceMappingURL=types.js.map

package/dist/session/codex/rollout-reader.js

@@ -42,6 +42,15 @@ function subtractRawUsage(a, b) {
         total_tokens: a.total_tokens - b.total_tokens,
     };
 }
+/**
+ * `compacted` 事件自带的摘要调用 usage（`latest_token_usage_record.usage`）。
+ * 用于把「压缩前窗口」与「摘要调用自身的消耗」区分开——两者都写在 compacted 前。
+ */
+function readCompactedCallTotal(payload) {
+    const record = payload?.latest_token_usage_record;
+    const total = record?.usage?.total_tokens;
+    return typeof total === 'number' ? total : undefined;
+}
 export function readCodexRollout(filePath) {
     if (!fs.existsSync(filePath)) {
         return null;
@@ -136,6 +145,8 @@ function scanCodexRollout(filePath, includeEvents) {
     // pi/opencode /resume "last turn" display semantics). When
     // last_token_usage is absent we derive it as total - previous_total.
     let lastRawUsage;
+    /** 上一条被接受的 raw usage；compacted 分支回退一条时用（见下方注释）。 */
+    let previousRawUsage;
     // Context window limit from the same token_count event as lastRawUsage
     // (codex reports info.model_context_window per turn; absent on old data).
     let lastContextLimit;
@@ -202,6 +213,7 @@ function scanCodexRollout(filePath, includeEvents) {
                         lastTotalUsage = total;
                     }
                     if (raw && (raw.input_tokens || raw.cached_input_tokens || raw.output_tokens)) {
+                        previousRawUsage = lastRawUsage;
                         lastRawUsage = raw;
                         const ctxWindow = info?.model_context_window;
                         lastContextLimit = typeof ctxWindow === 'number' ? ctxWindow : undefined;
@@ -223,10 +235,19 @@ function scanCodexRollout(filePath, includeEvents) {
                 }
             }
             else if (parsed.type === 'compacted') {
-                // 顶层 compacted 事件：压缩次数 +1，压缩前水位取最近一次非零 token_count。
+                // 顶层 compacted 事件：压缩次数 +1，压缩前水位取「压缩调用之前」那条非零
+                // token_count 的 total_tokens。真实 rollout 落盘顺序是
+                // 末轮 → 摘要调用 → compacted → 压缩后水位：摘要调用自身的 token_count 紧贴
+                // 在 compacted 之前，直接取 lastRawUsage 会把摘要调用的消耗当成压缩前窗口
+                // （实测把 363K 的窗口显示成 207K）。compacted 自带的摘要调用 usage 用于判定
+                // 并回退一条；旧数据没有 latest_token_usage_record 时保持原语义。
                 compactCount++;
-                if (lastRawUsage?.total_tokens !== undefined) {
-                    compactPreContextLength = lastRawUsage.total_tokens;
+                const compactCallTotal = readCompactedCallTotal(parsed.payload);
+                const preCompactUsage = compactCallTotal !== undefined && lastRawUsage?.total_tokens === compactCallTotal
+                    ? previousRawUsage
+                    : lastRawUsage;
+                if (preCompactUsage?.total_tokens !== undefined) {
+                    compactPreContextLength = preCompactUsage.total_tokens;
                 }
             }
             else if (includeEvents && parsed.type === 'response_item' && parsed.payload) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lark-remote",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Feishu (Lark) private-chat bridge to local coding agents — Claude Code / Codex / opencode / pi / kimi, with live-streaming CardKit 2.0 cards",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",