@kiturone/kapibala 0.0.8 → 0.0.9

package/dist/index.d.cts

@@ -1151,9 +1151,13 @@ declare class SessionManager {
     constructor(options?: SessionManagerOptions);
     /** 默认新建独立空会话，写入头部并持有单写者锁；不读取其它正文。 */
     create(): Promise<ManagedSession>;
-    /** 每页 20 项按正文活动排序；有效 sidecar 只读元数据，不读取完整 JSONL。默认排除已归档会话。 */
+    /**
+     * 按正文活动排序分页；有效 sidecar 只读元数据，不读取完整 JSONL。默认排除已归档会话。
+     * pageSize 由调用方显式给出时必须在 1–100 之间；非法页参数直接失败，不静默修正。
+     */
     list(page?: number, options?: {
         includeArchived?: boolean;
+        pageSize?: number;
     }): Promise<{
         items: SessionMetadata[];
         total: number;

package/dist/index.d.ts

@@ -1151,9 +1151,13 @@ declare class SessionManager {
     constructor(options?: SessionManagerOptions);
     /** 默认新建独立空会话，写入头部并持有单写者锁；不读取其它正文。 */
     create(): Promise<ManagedSession>;
-    /** 每页 20 项按正文活动排序；有效 sidecar 只读元数据，不读取完整 JSONL。默认排除已归档会话。 */
+    /**
+     * 按正文活动排序分页；有效 sidecar 只读元数据，不读取完整 JSONL。默认排除已归档会话。
+     * pageSize 由调用方显式给出时必须在 1–100 之间；非法页参数直接失败，不静默修正。
+     */
     list(page?: number, options?: {
         includeArchived?: boolean;
+        pageSize?: number;
     }): Promise<{
         items: SessionMetadata[];
         total: number;

package/dist/index.js

@@ -1598,17 +1598,21 @@ var SessionManager = class {
       throw error;
     }
   }
-  /** 每页 20 项按正文活动排序；有效 sidecar 只读元数据，不读取完整 JSONL。默认排除已归档会话。 */
+  /**
+   * 按正文活动排序分页；有效 sidecar 只读元数据，不读取完整 JSONL。默认排除已归档会话。
+   * pageSize 由调用方显式给出时必须在 1–100 之间；非法页参数直接失败，不静默修正。
+   */
   async list(page = 1, options) {
-    if (!Number.isSafeInteger(page) || page < 1)
+    const pageSize = options?.pageSize ?? 20;
+    if (!Number.isSafeInteger(page) || page < 1 || !Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 100)
       throw new Error("History page must be a positive integer");
     const all = await this.allMetadata();
     const filtered = options?.includeArchived ? all : all.filter((m) => !m.archived);
     return {
-      items: filtered.slice((page - 1) * 20, page * 20),
+      items: filtered.slice((page - 1) * pageSize, page * pageSize),
       total: filtered.length,
       page,
-      pages: Math.max(1, Math.ceil(filtered.length / 20))
+      pages: Math.max(1, Math.ceil(filtered.length / pageSize))
     };
   }
   /** 解析完整 ID 或唯一前缀对应的会话文件与 ID。 */