lark-remote 0.5.18 → 0.5.20

package/dist/session/opencode/sessions.d.ts

@@ -15,7 +15,7 @@
  * - isSessionActive: use `updated` timestamp with 1 hour stale window.
  * - Simple memory cache with TTL.
  */
-import type { AgentSession, AgentSessionReader, SessionContent } from '../../session-contract.js';
+import type { AgentSession, AgentSessionReader, AgentSessionUsage, SessionContent } from '../../session-contract.js';
 interface OpencodeSessionReaderOptions {
     /** Path to the opencode binary. Defaults to `opencode`. */
     binary?: string;
@@ -28,6 +28,145 @@ interface OpencodeSessionReaderOptions {
      */
     captureExport?: (sessionId: string) => string;
 }
+/** v1 export 单条消息（外部 JSON 契约，导出供扫描累积器单测构造）。 */
+export interface OpencodeExportMessage {
+    info: {
+        role: 'user' | 'assistant';
+        time?: {
+            created: number;
+        };
+        id: string;
+        sessionID: string;
+    };
+    parts: Array<{
+        type: string;
+        text?: string;
+        tool?: string;
+        callID?: string;
+        state?: {
+            status: string;
+            input?: Record<string, unknown>;
+            output?: string;
+            error?: string;
+        };
+        reason?: string;
+        tokens?: {
+            total: number;
+            input: number;
+            output: number;
+            reasoning: number;
+            cache?: {
+                read: number;
+                write: number;
+            };
+        };
+    }>;
+}
+/**
+ * v2 `session export` messages are flattened: `{type, text, content}` rather
+ * than v1's `{info, parts}` envelope. Keep the v2 types local to this reader —
+ * they are an external JSON contract, not an internal model.
+ */
+/** v2 export 单条消息（外部 JSON 契约，导出供扫描累积器单测构造）。 */
+export interface OpencodeV2Message {
+    id?: string;
+    type: string;
+    time?: {
+        created?: number;
+        completed?: number;
+    };
+    text?: string;
+    content?: Array<OpencodeV2ContentPart>;
+    tokens?: {
+        input: number;
+        output: number;
+        reasoning: number;
+        cache?: {
+            read: number;
+            write: number;
+        };
+    };
+    error?: {
+        type?: string;
+        message?: string;
+    };
+    command?: string;
+    output?: string;
+    callID?: string;
+    summary?: string;
+}
+interface OpencodeV2ContentPart {
+    type: string;
+    text?: string;
+    id?: string;
+    name?: string;
+    state?: {
+        status?: string;
+        input?: unknown;
+        content?: Array<{
+            type?: string;
+            text?: string;
+            content?: {
+                type?: string;
+                text?: string;
+            };
+        }>;
+        error?: {
+            type?: string;
+            message?: string;
+        } | string;
+        result?: unknown;
+    };
+}
+/** flow 累计的五个字段（v1 step-finish tokens 与 v2 message tokens 同形）。 */
+interface OpencodeUsageFlow {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheCreation: number;
+    total: number;
+}
+/** v1 扫描累积器结果（纯数据）。 */
+export interface OpencodeV1Scan {
+    /** 末条 user 消息下标（catch-up tail 起点）；整份 export 无 user 消息 = -1。 */
+    lastUserIndex: number;
+    /** tail 内首条 user 文本（displayTitle 首选）。 */
+    tailDisplayTitle: string | undefined;
+    /** tail 内最后一次非零 step-finish 采样（contextLength 水位来源）。 */
+    latest: AgentSessionUsage | undefined;
+    /** tail 内非零 step-finish 求和（本 run flow）。 */
+    turn: OpencodeUsageFlow;
+    /** 全会话 step-finish 求和（cumulative；零 total 的退化 step 字段照加）。 */
+    cum: OpencodeUsageFlow;
+}
+/**
+ * v1 扫描累积器（纯函数）：单遍扫过全部 export 消息，产出 catch-up tail 的
+ * 位置（末条 user 消息）、本 run flow（tail 内非零 step-finish 求和）、末条
+ * 非零采样（contextLength 水位）与全会话累计。
+ *
+ * 产生：OpencodeV1Scan。依赖：入参 messages。不改任何外部状态。
+ *
+ * 口径（勿改）：cumulative 对**所有** step-finish 逐字段求和、不设零 total
+ * 门槛；turn/latest 只认 tail 内非零 total 的 step（模型在 reasoning 中被
+ * 截断的退化 step 不算采样）。
+ */
+export declare function scanV1Messages(messages: OpencodeExportMessage[]): OpencodeV1Scan;
+/** v2 usage 扫描累积器结果（纯数据）。 */
+export interface OpencodeV2UsageScan {
+    /** 末条采样（contextLength 水位来源）。 */
+    latest: AgentSessionUsage | undefined;
+    /** 末个 turn（末个 turn 起点之后）的采样求和（本 run flow）。 */
+    turn: OpencodeUsageFlow;
+    /** 全会话采样求和（cumulative）。 */
+    cum: OpencodeUsageFlow;
+}
+/**
+ * v2 扫描累积器（纯函数）：usageSample 已滤掉零 total 的退化消息；turn 边界
+ * 由 lastTurnStartIndex 判定（idle / user / synthetic / system，见其注释）。
+ *
+ * 产生：OpencodeV2UsageScan。依赖：入参 messages。不改任何外部状态。
+ */
+export declare function scanV2Usage(messages: OpencodeV2Message[]): OpencodeV2UsageScan;
 export declare class OpencodeSessionReader implements AgentSessionReader {
     private readonly binary;
     private readonly cacheTtlMs;
@@ -56,14 +195,27 @@ export declare class OpencodeSessionReader implements AgentSessionReader {
     getNewestSession(cwd: string): AgentSession | null;
     /**
      * Read session content: extract catch-up tail (last user message + everything after).
+     *
+     * 编排：定位会话文件（captureExport + parse）→ directory 精确匹配（与
+     * cwd-scoped list 同口径）→ 按 export 版本分发到 v1/v2 装配。
      */
     readSessionContent(sessionId: string, cwd: string, opts?: {
         maxEvents?: number;
     }): SessionContent;
+    /**
+     * v1 export（`{info, parts}` 信封 + step-finish 用量 part）的 catch-up tail
+     * 装配：扫描累积器（scanV1Messages）出 tail 位置与本 run/累计 usage，事件
+     * 装配（assembleV1TailEvents）出展示流，这里只做组装。
+     */
+    private readV1SessionContent;
     /**
      * v2 export: messages are flat (`type` + `text`/`content`) and assistant
      * usage lives on the message instead of a `step-finish` part. Keep this
      * mapping isolated from the v1 parser so v1 behaviour stays unchanged.
+     *
+     * turnStart 可能落在末条采样之后（新 turn 尚无采样）→ turn 全 0；latest
+     * 仍是上一轮末条采样，contextLength 保留水位。turnStart 小于最后一个采样
+     * 下标时，flow 覆盖末条值，只有 contextLength 保留末条（finalizeTurnUsage）。
      */
     private readV2SessionContent;
     /**