@clawos-dev/clawd 0.2.29 → 0.2.30

package/dist/cli.cjs

@@ -8583,7 +8583,7 @@ var init_zod = __esm({
 });
 
 // ../protocol/src/persona-schemas.ts
-var PersonaTokenEntrySchema, PersonaFileSchema, PersonaHelloFrameSchema, PersonaSendFrameSchema, PersonaResetFrameSchema, PersonaPingFrameSchema, PersonaReadyFrameSchema, PersonaHistoryEventFrameSchema, PersonaHistoryDoneFrameSchema, PersonaEventFrameSchema, PersonaErrorFrameSchema, PersonaPongFrameSchema, PersonaClientFrameSchema, PersonaServerFrameSchema, PersonaCreateArgsSchema, PersonaIdArgsSchema, PersonaUpdateArgsSchema, PersonaIssueTokenArgsSchema, PersonaRevokeTokenArgsSchema, PersonaAppendOwnerMessageArgsSchema;
+var PersonaTokenEntrySchema, PersonaFileSchema, PersonaHelloFrameSchema, PersonaSendFrameSchema, PersonaResetFrameSchema, PersonaPingFrameSchema, PersonaReadyFrameSchema, PersonaHistoryEventFrameSchema, PersonaHistoryDoneFrameSchema, PersonaEventFrameSchema, PersonaErrorFrameSchema, PersonaPongFrameSchema, PersonaHistoryPageRequestFrameSchema, PersonaHistoryPageFrameSchema, PersonaClientFrameSchema, PersonaServerFrameSchema, PersonaCreateArgsSchema, PersonaIdArgsSchema, PersonaUpdateArgsSchema, PersonaIssueTokenArgsSchema, PersonaRevokeTokenArgsSchema, PersonaAppendOwnerMessageArgsSchema;
 var init_persona_schemas = __esm({
   "../protocol/src/persona-schemas.ts"() {
     "use strict";
@@ -8628,7 +8628,9 @@ var init_persona_schemas = __esm({
       event: external_exports.unknown()
     });
     PersonaHistoryDoneFrameSchema = external_exports.object({
-      kind: external_exports.literal("history-done")
+      kind: external_exports.literal("history-done"),
+      offset: external_exports.number().int().nonnegative(),
+      total: external_exports.number().int().nonnegative()
     });
     PersonaEventFrameSchema = external_exports.object({
       kind: external_exports.literal("event"),
@@ -8648,11 +8650,25 @@ var init_persona_schemas = __esm({
     PersonaPongFrameSchema = external_exports.object({
       kind: external_exports.literal("pong")
     });
+    PersonaHistoryPageRequestFrameSchema = external_exports.object({
+      kind: external_exports.literal("history-page-request"),
+      requestId: external_exports.string().min(1),
+      limit: external_exports.number().int().positive(),
+      offset: external_exports.number().int().nonnegative()
+    });
+    PersonaHistoryPageFrameSchema = external_exports.object({
+      kind: external_exports.literal("history-page"),
+      requestId: external_exports.string().min(1),
+      events: external_exports.array(external_exports.unknown()),
+      offset: external_exports.number().int().nonnegative(),
+      total: external_exports.number().int().nonnegative()
+    });
     PersonaClientFrameSchema = external_exports.discriminatedUnion("kind", [
       PersonaHelloFrameSchema,
       PersonaSendFrameSchema,
       PersonaResetFrameSchema,
-      PersonaPingFrameSchema
+      PersonaPingFrameSchema,
+      PersonaHistoryPageRequestFrameSchema
     ]);
     PersonaServerFrameSchema = external_exports.discriminatedUnion("kind", [
       PersonaReadyFrameSchema,
@@ -8660,7 +8676,8 @@ var init_persona_schemas = __esm({
       PersonaHistoryDoneFrameSchema,
       PersonaEventFrameSchema,
       PersonaErrorFrameSchema,
-      PersonaPongFrameSchema
+      PersonaPongFrameSchema,
+      PersonaHistoryPageFrameSchema
     ]);
     PersonaCreateArgsSchema = external_exports.object({
       label: external_exports.string().min(1),
@@ -17238,6 +17255,32 @@ var SessionManager = class {
     const runner = this.ensureRunnerFor(file, agentId);
     return runner.getState().buffer.map((e) => e.event);
   }
+  /**
+   * persona-bound transport 用：基于 readHistoryEvents 的 buffer 切片视图，支持分页。
+   *
+   * Why a new method instead of reusing `history:read` RPC handler:
+   *   - `history:read` 走 HandlerDeps.history.read()，读 CC 写盘的 jsonl 文件
+   *   - 本方法走 reducer buffer（与实时 `subscribe` 同一数据源）
+   *   两条路径数据形态、时序、字段不同，不能共享 helper。persona-bound 客户端必须
+   *   走 buffer 路径，才能保证首屏回放和实时帧无 gap、无重复。
+   *
+   * Why not 改 readHistoryEvents 加 limit/offset：现有 readHistoryEvents 的语义是
+   * "返回 buffer 全部"，被其它路径（rewind uuid 转译等）依赖；保留它不动，新加分页方法。
+   *
+   * 切片语义：clip 安全边界，response.offset 保留请求值便于客户端识别越界请求。
+   * - offset >= total → events: [], offset: 请求值, total: 当前 buffer 长度
+   * - offset + limit > total → 返回 tail [offset, total)，长度 = total - offset
+   * - 正常 → 返回 [offset, offset + limit)
+   *
+   * SESSION_NOT_FOUND 行为继承 readHistoryEvents（store.read 返回 null 即抛）。
+   */
+  readHistoryPage(sessionId, agentId, limit, offset) {
+    const all = this.readHistoryEvents(sessionId, agentId);
+    const total = all.length;
+    const start = Math.min(offset, total);
+    const end = Math.min(start + limit, total);
+    return { events: all.slice(start, end), offset, total };
+  }
   /**
    * persona-bound transport 用：订阅 sub-session 实时 ParsedEvent。
    * 返回 unsubscribe；不破坏现有 wire 广播路径——routeFromRunner 同时 fan-out 到
@@ -18469,20 +18512,31 @@ var PersonaBoundHandler = class {
             send({ kind: "event", event });
           }
         );
+        const FIRST_PAGE_SIZE = 50;
+        let firstPageOffset = 0;
+        let firstPageTotal = 0;
         try {
-          const history = this.deps.sessionManager.readHistoryEvents(
+          const page = this.deps.sessionManager.readHistoryPage(
             subSessionFile.sessionId,
-            personaId
+            personaId,
+            FIRST_PAGE_SIZE,
+            0
           );
-          for (const event of history) {
+          for (const event of page.events) {
             send({ kind: "history-event", event });
           }
+          firstPageOffset = page.events.length;
+          firstPageTotal = page.total;
         } catch (err) {
           this.deps.logger.warn(
             `persona history read failed: ${err.message}`
           );
         }
-        send({ kind: "history-done" });
+        send({
+          kind: "history-done",
+          offset: firstPageOffset,
+          total: firstPageTotal
+        });
         return;
       }
       switch (frame.kind) {
@@ -18519,6 +18573,36 @@ var PersonaBoundHandler = class {
         case "ping":
           send({ kind: "pong" });
           return;
+        case "history-page-request": {
+          try {
+            const page = this.deps.sessionManager.readHistoryPage(
+              scope.subSessionId,
+              scope.personaId,
+              frame.limit,
+              frame.offset
+            );
+            send({
+              kind: "history-page",
+              requestId: frame.requestId,
+              events: page.events,
+              offset: frame.offset,
+              // 请求值原样回传，便于 client 识别越界
+              total: page.total
+            });
+          } catch (err) {
+            this.deps.logger.warn(
+              `persona history-page-request failed: ${err.message}`
+            );
+            send({
+              kind: "history-page",
+              requestId: frame.requestId,
+              events: [],
+              offset: frame.offset,
+              total: 0
+            });
+          }
+          return;
+        }
       }
     });
     ws.on("close", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawos-dev/clawd",
-  "version": "0.2.29",
+  "version": "0.2.30",
   "description": "Standalone clawd daemon — Claude Code (and future Codex) session server over WebSocket",
   "type": "module",
   "license": "MIT",