@fllf/agent-sdk 0.1.2 → 0.1.3

package/dist/history/context-window.d.ts

@@ -0,0 +1,33 @@
+import type { Message } from '../messages';
+export interface TokenEstimator {
+    estimate(message: Message): number;
+}
+/**
+ * 无 tokenizer 依赖的近似估算：约 4 字符 = 1 token，再加每条消息的
+ * 固定协议开销和 toolCalls 参数的 JSON 体积。
+ * 结果偏保守（宁可高估），用于截断预算而非计费。
+ */
+export declare class HeuristicTokenEstimator implements TokenEstimator {
+    private static readonly CHARS_PER_TOKEN;
+    private static readonly PER_MESSAGE_OVERHEAD;
+    estimate(message: Message): number;
+}
+export declare const defaultTokenEstimator: TokenEstimator;
+export interface TokenBudgetSplit {
+    kept: Message[];
+    dropped: Message[];
+}
+/**
+ * truncateToTokenBudget 的可观察版本：除了保留的后缀，还返回被丢弃的
+ * 前缀，供上层（如 ContextCompressor）把旧消息压缩成摘要再注入。
+ * kept 与 truncateToTokenBudget 的结果完全一致（含 tool 配对修复），
+ * 因此 kept 永远是原序列的一个后缀，dropped 是对应的前缀。
+ */
+export declare function splitByTokenBudget(messages: readonly Message[], maxTokens: number, estimator?: TokenEstimator): TokenBudgetSplit;
+/**
+ * 从最新消息向前保留，直到 token 预算耗尽。
+ * 最新一条消息永远保留（即使超预算，请求也应该带上当前输入让 provider 报错，
+ * 而不是发出一个空消息列表）。截断后修复开头的孤儿 tool 上下文。
+ */
+export declare function truncateToTokenBudget(messages: readonly Message[], maxTokens: number, estimator?: TokenEstimator): Message[];
+//# sourceMappingURL=context-window.d.ts.map

package/dist/history/context-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.d.ts","sourceRoot":"","sources":["../../src/history/context-window.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;CACtC;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,cAAc;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAK;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAK;IAEjD,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;CAerC;AAED,eAAO,MAAM,qBAAqB,EAAE,cAA8C,CAAC;AAEnF,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,OAAO,EAAE,OAAO,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAC9B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,cAAsC,GAClD,gBAAgB,CAOlB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,cAAsC,GAClD,OAAO,EAAE,CAqBX"}

package/dist/history/context-window.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultTokenEstimator = exports.HeuristicTokenEstimator = void 0;
+exports.splitByTokenBudget = splitByTokenBudget;
+exports.truncateToTokenBudget = truncateToTokenBudget;
+const messages_1 = require("../messages");
+const tool_pairing_1 = require("./tool-pairing");
+/**
+ * 无 tokenizer 依赖的近似估算：约 4 字符 = 1 token，再加每条消息的
+ * 固定协议开销和 toolCalls 参数的 JSON 体积。
+ * 结果偏保守（宁可高估），用于截断预算而非计费。
+ */
+class HeuristicTokenEstimator {
+    static CHARS_PER_TOKEN = 4;
+    static PER_MESSAGE_OVERHEAD = 8;
+    estimate(message) {
+        let characters = (0, messages_1.contentToText)(message.content).length;
+        const toolCalls = message.metadata.toolCalls;
+        if (toolCalls !== undefined && toolCalls.length > 0) {
+            try {
+                characters += JSON.stringify(toolCalls).length;
+            }
+            catch {
+                characters += 256 * toolCalls.length;
+            }
+        }
+        return Math.ceil(characters / HeuristicTokenEstimator.CHARS_PER_TOKEN)
+            + HeuristicTokenEstimator.PER_MESSAGE_OVERHEAD;
+    }
+}
+exports.HeuristicTokenEstimator = HeuristicTokenEstimator;
+exports.defaultTokenEstimator = new HeuristicTokenEstimator();
+/**
+ * truncateToTokenBudget 的可观察版本：除了保留的后缀，还返回被丢弃的
+ * 前缀，供上层（如 ContextCompressor）把旧消息压缩成摘要再注入。
+ * kept 与 truncateToTokenBudget 的结果完全一致（含 tool 配对修复），
+ * 因此 kept 永远是原序列的一个后缀，dropped 是对应的前缀。
+ */
+function splitByTokenBudget(messages, maxTokens, estimator = exports.defaultTokenEstimator) {
+    const kept = truncateToTokenBudget(messages, maxTokens, estimator);
+    return {
+        kept,
+        dropped: messages.slice(0, messages.length - kept.length),
+    };
+}
+/**
+ * 从最新消息向前保留，直到 token 预算耗尽。
+ * 最新一条消息永远保留（即使超预算，请求也应该带上当前输入让 provider 报错，
+ * 而不是发出一个空消息列表）。截断后修复开头的孤儿 tool 上下文。
+ */
+function truncateToTokenBudget(messages, maxTokens, estimator = exports.defaultTokenEstimator) {
+    if (messages.length === 0 || maxTokens <= 0) {
+        return messages.length > 0 ? (0, tool_pairing_1.withRepairedLeadingToolContext)([messages[messages.length - 1]]) : [];
+    }
+    const kept = [];
+    let budget = maxTokens;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        const cost = estimator.estimate(message);
+        if (cost > budget && kept.length > 0) {
+            break;
+        }
+        kept.unshift(message);
+        budget -= cost;
+    }
+    return (0, tool_pairing_1.withRepairedLeadingToolContext)(kept);
+}
+//# sourceMappingURL=context-window.js.map

package/dist/history/context-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-window.js","sourceRoot":"","sources":["../../src/history/context-window.ts"],"names":[],"mappings":";;;AA+CA,gDAWC;AAOD,sDAyBC;AA1FD,0CAA4C;AAE5C,iDAAgE;AAMhE;;;;GAIG;AACH,MAAa,uBAAuB;IACxB,MAAM,CAAU,eAAe,GAAG,CAAC,CAAC;IACpC,MAAM,CAAU,oBAAoB,GAAG,CAAC,CAAC;IAEjD,QAAQ,CAAC,OAAgB;QACrB,IAAI,UAAU,GAAG,IAAA,wBAAa,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAEvD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC7C,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC;gBACD,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACL,UAAU,IAAI,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;YACzC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,uBAAuB,CAAC,eAAe,CAAC;cAChE,uBAAuB,CAAC,oBAAoB,CAAC;IACvD,CAAC;;AAlBL,0DAmBC;AAEY,QAAA,qBAAqB,GAAmB,IAAI,uBAAuB,EAAE,CAAC;AAOnF;;;;;GAKG;AACH,SAAgB,kBAAkB,CAC9B,QAA4B,EAC5B,SAAiB,EACjB,YAA4B,6BAAqB;IAEjD,MAAM,IAAI,GAAG,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAEnE,OAAO;QACH,IAAI;QACJ,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;KAC5D,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACjC,QAA4B,EAC5B,SAAiB,EACjB,YAA4B,6BAAqB;IAEjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAA,6CAA8B,EAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvG,CAAC;IAED,MAAM,IAAI,GAAc,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAG,SAAS,CAAC;IAEvB,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;QACjC,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM;QACV,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACtB,MAAM,IAAI,IAAI,CAAC;IACnB,CAAC;IAED,OAAO,IAAA,6CAA8B,EAAC,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/history/in-memory.d.ts

@@ -1,5 +1,5 @@
 import { Message } from '../messages';
-import type { MessageHistory, MessageHistoryStore } from './base';
+import type { MessageHistory, MessageHistoryAddOptions, MessageHistoryGetOptions, MessageHistoryStore } from './base';
 export interface InMemoryMessageHistoryOptions {
     maxMessages?: number;
 }
@@ -8,17 +8,19 @@ export interface InMemoryMessageHistoryStoreOptions extends InMemoryMessageHisto
 export declare class InMemoryMessageHistory implements MessageHistory {
     private readonly messages;
     private readonly maxMessages;
+    private version;
     constructor(options?: InMemoryMessageHistoryOptions);
     add(message: Message): Promise<void>;
-    addMany(messages: Message[]): Promise<void>;
-    get(): Promise<Message[]>;
+    addMany(messages: Message[], options?: MessageHistoryAddOptions): Promise<void>;
+    get(options?: MessageHistoryGetOptions): Promise<Message[]>;
     clear(): Promise<void>;
+    getVersion(): Promise<number>;
 }
 export declare class InMemoryMessageHistoryStore implements MessageHistoryStore {
     private readonly histories;
     private readonly options;
     constructor(options?: InMemoryMessageHistoryStoreOptions);
-    get(sessionId: string): MessageHistory;
+    get(sessionId: string): InMemoryMessageHistory;
     clear(sessionId: string): Promise<void>;
     deleteSession(sessionId: string): Promise<void>;
     clearAll(): Promise<void>;

package/dist/history/in-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/history/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAElE,MAAM,WAAW,6BAA6B;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kCAAmC,SAAQ,6BAA6B;CAAG;AAE5F,qBAAa,sBAAuB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,GAAE,6BAAkC;IAIjD,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAIzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED,qBAAa,2BAA4B,YAAW,mBAAmB;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;gBAEjD,OAAO,GAAE,kCAAuC;IAI5D,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc;IAWhC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../src/history/in-memory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAItC,OAAO,KAAK,EACR,cAAc,EACd,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACtB,MAAM,QAAQ,CAAC;AAGhB,MAAM,WAAW,6BAA6B;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kCAAmC,SAAQ,6BAA6B;CAAG;AAE5F,qBAAa,sBAAuB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,OAAO,CAAK;gBAER,OAAO,GAAE,6BAAkC;IAIjD,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBnF,GAAG,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAGtC;AAED,qBAAa,2BAA4B,YAAW,mBAAmB;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;gBAEjD,OAAO,GAAE,kCAAuC;IAI5D,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB;IAWxC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/history/in-memory.js

@@ -1,27 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InMemoryMessageHistoryStore = exports.InMemoryMessageHistory = void 0;
+const errors_1 = require("../errors");
+const base_1 = require("./base");
+const tool_pairing_1 = require("./tool-pairing");
 class InMemoryMessageHistory {
     messages = [];
     maxMessages;
+    version = 0;
     constructor(options = {}) {
         this.maxMessages = options.maxMessages ?? Number.POSITIVE_INFINITY;
     }
     async add(message) {
         await this.addMany([message]);
     }
-    async addMany(messages) {
+    async addMany(messages, options = {}) {
+        // 空批次是完整 no-op：不做版本检查也不递增版本（与 Postgres 实现一致）。
+        if (messages.length === 0) {
+            return;
+        }
+        if (options.expectedVersion !== undefined && options.expectedVersion !== this.version) {
+            throw new errors_1.HistoryVersionConflictError({
+                expectedVersion: options.expectedVersion,
+                actualVersion: this.version,
+            });
+        }
         this.messages.push(...messages);
         if (this.messages.length > this.maxMessages) {
             this.messages.splice(0, this.messages.length - this.maxMessages);
         }
-        removeInvalidLeadingToolContext(this.messages);
+        (0, tool_pairing_1.repairLeadingToolContext)(this.messages);
+        this.version += 1;
     }
-    async get() {
-        return [...this.messages];
+    async get(options = {}) {
+        return (0, base_1.applyMessageHistoryWindow)(this.messages, options);
     }
     async clear() {
         this.messages.length = 0;
+        // clear 递增而非重置版本：若重置为 0，"读到 v → 清空 → 重写"的 ABA
+        // 序列会让持有旧版本号的 CAS 写入意外成功。
+        this.version += 1;
+    }
+    async getVersion() {
+        return this.version;
     }
 }
 exports.InMemoryMessageHistory = InMemoryMessageHistory;
@@ -50,39 +71,4 @@ class InMemoryMessageHistoryStore {
     }
 }
 exports.InMemoryMessageHistoryStore = InMemoryMessageHistoryStore;
-function removeInvalidLeadingToolContext(messages) {
-    while (messages.length > 0) {
-        const firstMessage = messages[0];
-        if (firstMessage?.role === 'tool') {
-            messages.shift();
-            continue;
-        }
-        if (firstMessage === undefined || !hasToolCalls(firstMessage)) {
-            return;
-        }
-        const toolCalls = firstMessage.metadata.toolCalls ?? [];
-        const toolResponseEnd = findFollowingToolResponseEnd(messages);
-        const toolResponseIds = new Set(messages
-            .slice(1, toolResponseEnd)
-            .map((message) => message.metadata.toolCallId)
-            .filter((toolCallId) => toolCallId !== undefined));
-        const hasAllToolResponses = toolCalls.every((toolCall) => (toolResponseIds.has(toolCall.id)));
-        if (hasAllToolResponses) {
-            return;
-        }
-        messages.splice(0, toolResponseEnd);
-    }
-}
-function hasToolCalls(message) {
-    return message.role === 'assistant'
-        && message.metadata.toolCalls !== undefined
-        && message.metadata.toolCalls.length > 0;
-}
-function findFollowingToolResponseEnd(messages) {
-    let index = 1;
-    while (messages[index]?.role === 'tool') {
-        index += 1;
-    }
-    return index;
-}
 //# sourceMappingURL=in-memory.js.map

package/dist/history/in-memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../src/history/in-memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../src/history/in-memory.ts"],"names":[],"mappings":";;;AAAA,sCAAwD;AAExD,iCAEgB;AAOhB,iDAA0D;AAQ1D,MAAa,sBAAsB;IACd,QAAQ,GAAc,EAAE,CAAC;IACzB,WAAW,CAAS;IAC7B,OAAO,GAAG,CAAC,CAAC;IAEpB,YAAY,UAAyC,EAAE;QACnD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,iBAAiB,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAgB;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAmB,EAAE,UAAoC,EAAE;QACrE,8CAA8C;QAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QAED,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YACpF,MAAM,IAAI,oCAA2B,CAAC;gBAClC,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,aAAa,EAAE,IAAI,CAAC,OAAO;aAC9B,CAAC,CAAC;QACP,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACrE,CAAC;QAED,IAAA,uCAAwB,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,UAAoC,EAAE;QAC5C,OAAO,IAAA,gCAAyB,EAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACzB,8CAA8C;QAC9C,0BAA0B;QAC1B,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAlDD,wDAkDC;AAED,MAAa,2BAA2B;IACnB,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IACtD,OAAO,CAAqC;IAE7D,YAAY,UAA8C,EAAE;QACxD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,SAAiB;QACjB,IAAI,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,GAAG,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB;QACzB,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB;QACjC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACJ;AA9BD,kEA8BC"}

package/dist/history/index.d.ts

@@ -1,5 +1,12 @@
-export { DEFAULT_SESSION_ID, normalizeSessionId, } from './base';
+export { applyMessageHistoryWindow, assertValidMessageHistoryLimit, DEFAULT_SESSION_ID, normalizeSessionId, parseMessageHistoryBefore, } from './base';
+export { SummarizingContextCompressor } from './compression';
+export type { ContextCompressor, ContextCompressorInput, SummarizingContextCompressorOptions, } from './compression';
+export { defaultTokenEstimator, HeuristicTokenEstimator, splitByTokenBudget, truncateToTokenBudget, } from './context-window';
+export type { TokenBudgetSplit, TokenEstimator, } from './context-window';
 export { InMemoryMessageHistory, InMemoryMessageHistoryStore, } from './in-memory';
-export type { MessageHistory, MessageHistoryStore, } from './base';
+export { createPostgresMessageHistorySchemaSql, PostgresMessageHistory, PostgresMessageHistoryStore, } from './postgres';
+export { repairLeadingToolContext, withRepairedLeadingToolContext, } from './tool-pairing';
+export type { MessageHistory, MessageHistoryAddOptions, MessageHistoryGetOptions, MessageHistoryStore, } from './base';
 export type { InMemoryMessageHistoryOptions, InMemoryMessageHistoryStoreOptions, } from './in-memory';
+export type { PostgresHistoryTableNames, PostgresMessageHistorySchemaOptions, PostgresMessageHistoryStoreOptions, PostgresQueryExecutor, PostgresQueryResult, } from './postgres';
 //# sourceMappingURL=index.d.ts.map

package/dist/history/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACH,sBAAsB,EACtB,2BAA2B,GAC9B,MAAM,aAAa,CAAC;AACrB,YAAY,EACR,cAAc,EACd,mBAAmB,GACtB,MAAM,QAAQ,CAAC;AAChB,YAAY,EACR,6BAA6B,EAC7B,kCAAkC,GACrC,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EACzB,8BAA8B,EAC9B,kBAAkB,EAClB,kBAAkB,EAClB,yBAAyB,GAC5B,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EACR,iBAAiB,EACjB,sBAAsB,EACtB,mCAAmC,GACtC,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACR,gBAAgB,EAChB,cAAc,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,sBAAsB,EACtB,2BAA2B,GAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACH,qCAAqC,EACrC,sBAAsB,EACtB,2BAA2B,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,wBAAwB,EACxB,8BAA8B,GACjC,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACR,cAAc,EACd,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,GACtB,MAAM,QAAQ,CAAC;AAChB,YAAY,EACR,6BAA6B,EAC7B,kCAAkC,GACrC,MAAM,aAAa,CAAC;AACrB,YAAY,EACR,yBAAyB,EACzB,mCAAmC,EACnC,kCAAkC,EAClC,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,YAAY,CAAC"}

package/dist/history/index.js

@@ -1,10 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryMessageHistoryStore = exports.InMemoryMessageHistory = exports.normalizeSessionId = exports.DEFAULT_SESSION_ID = void 0;
+exports.withRepairedLeadingToolContext = exports.repairLeadingToolContext = exports.PostgresMessageHistoryStore = exports.PostgresMessageHistory = exports.createPostgresMessageHistorySchemaSql = exports.InMemoryMessageHistoryStore = exports.InMemoryMessageHistory = exports.truncateToTokenBudget = exports.splitByTokenBudget = exports.HeuristicTokenEstimator = exports.defaultTokenEstimator = exports.SummarizingContextCompressor = exports.parseMessageHistoryBefore = exports.normalizeSessionId = exports.DEFAULT_SESSION_ID = exports.assertValidMessageHistoryLimit = exports.applyMessageHistoryWindow = void 0;
 var base_1 = require("./base");
+Object.defineProperty(exports, "applyMessageHistoryWindow", { enumerable: true, get: function () { return base_1.applyMessageHistoryWindow; } });
+Object.defineProperty(exports, "assertValidMessageHistoryLimit", { enumerable: true, get: function () { return base_1.assertValidMessageHistoryLimit; } });
 Object.defineProperty(exports, "DEFAULT_SESSION_ID", { enumerable: true, get: function () { return base_1.DEFAULT_SESSION_ID; } });
 Object.defineProperty(exports, "normalizeSessionId", { enumerable: true, get: function () { return base_1.normalizeSessionId; } });
+Object.defineProperty(exports, "parseMessageHistoryBefore", { enumerable: true, get: function () { return base_1.parseMessageHistoryBefore; } });
+var compression_1 = require("./compression");
+Object.defineProperty(exports, "SummarizingContextCompressor", { enumerable: true, get: function () { return compression_1.SummarizingContextCompressor; } });
+var context_window_1 = require("./context-window");
+Object.defineProperty(exports, "defaultTokenEstimator", { enumerable: true, get: function () { return context_window_1.defaultTokenEstimator; } });
+Object.defineProperty(exports, "HeuristicTokenEstimator", { enumerable: true, get: function () { return context_window_1.HeuristicTokenEstimator; } });
+Object.defineProperty(exports, "splitByTokenBudget", { enumerable: true, get: function () { return context_window_1.splitByTokenBudget; } });
+Object.defineProperty(exports, "truncateToTokenBudget", { enumerable: true, get: function () { return context_window_1.truncateToTokenBudget; } });
 var in_memory_1 = require("./in-memory");
 Object.defineProperty(exports, "InMemoryMessageHistory", { enumerable: true, get: function () { return in_memory_1.InMemoryMessageHistory; } });
 Object.defineProperty(exports, "InMemoryMessageHistoryStore", { enumerable: true, get: function () { return in_memory_1.InMemoryMessageHistoryStore; } });
+var postgres_1 = require("./postgres");
+Object.defineProperty(exports, "createPostgresMessageHistorySchemaSql", { enumerable: true, get: function () { return postgres_1.createPostgresMessageHistorySchemaSql; } });
+Object.defineProperty(exports, "PostgresMessageHistory", { enumerable: true, get: function () { return postgres_1.PostgresMessageHistory; } });
+Object.defineProperty(exports, "PostgresMessageHistoryStore", { enumerable: true, get: function () { return postgres_1.PostgresMessageHistoryStore; } });
+var tool_pairing_1 = require("./tool-pairing");
+Object.defineProperty(exports, "repairLeadingToolContext", { enumerable: true, get: function () { return tool_pairing_1.repairLeadingToolContext; } });
+Object.defineProperty(exports, "withRepairedLeadingToolContext", { enumerable: true, get: function () { return tool_pairing_1.withRepairedLeadingToolContext; } });
 //# sourceMappingURL=index.js.map

package/dist/history/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":";;;AAAA,+BAGgB;AAFZ,0GAAA,kBAAkB,OAAA;AAClB,0GAAA,kBAAkB,OAAA;AAEtB,yCAGqB;AAFjB,mHAAA,sBAAsB,OAAA;AACtB,wHAAA,2BAA2B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":";;;AAAA,+BAMgB;AALZ,iHAAA,yBAAyB,OAAA;AACzB,sHAAA,8BAA8B,OAAA;AAC9B,0GAAA,kBAAkB,OAAA;AAClB,0GAAA,kBAAkB,OAAA;AAClB,iHAAA,yBAAyB,OAAA;AAE7B,6CAA6D;AAApD,2HAAA,4BAA4B,OAAA;AAMrC,mDAK0B;AAJtB,uHAAA,qBAAqB,OAAA;AACrB,yHAAA,uBAAuB,OAAA;AACvB,oHAAA,kBAAkB,OAAA;AAClB,uHAAA,qBAAqB,OAAA;AAMzB,yCAGqB;AAFjB,mHAAA,sBAAsB,OAAA;AACtB,wHAAA,2BAA2B,OAAA;AAE/B,uCAIoB;AAHhB,iIAAA,qCAAqC,OAAA;AACrC,kHAAA,sBAAsB,OAAA;AACtB,uHAAA,2BAA2B,OAAA;AAE/B,+CAGwB;AAFpB,wHAAA,wBAAwB,OAAA;AACxB,8HAAA,8BAA8B,OAAA"}

package/dist/history/postgres/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './schema';
+export * from './postgres-message-history-store';
+//# sourceMappingURL=index.d.ts.map

package/dist/history/postgres/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/history/postgres/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,kCAAkC,CAAC"}

package/dist/history/postgres/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./schema"), exports);
+__exportStar(require("./postgres-message-history-store"), exports);
+//# sourceMappingURL=index.js.map

package/dist/history/postgres/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/history/postgres/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,mEAAiD"}

package/dist/history/postgres/postgres-message-history-store.d.ts

@@ -0,0 +1,35 @@
+import type { Message } from '../../messages';
+import type { MessageHistory, MessageHistoryAddOptions, MessageHistoryGetOptions, MessageHistoryStore } from '../base';
+import type { PostgresHistoryTableNames, PostgresMessageHistoryStoreOptions, PostgresQueryExecutor } from './types';
+/**
+ * 参考级 Postgres 消息历史。设计约束：
+ *
+ * - 只依赖注入的 query(sql, params)（可直接传 pg.Pool），不使用客户端事务
+ *   API——调用方传进来的可能就是连接池，每次 query 可能落在不同连接上。
+ * - 因此所有需要原子性的写路径都压缩为单条 SQL 语句（data-modifying CTE），
+ *   单条语句在 Postgres 里天然具备事务语义。
+ * - 乐观并发：addMany 带 expectedVersion 时用
+ *   UPDATE ... SET version = version + 1 WHERE session_id = $1 AND version = $2
+ *   RETURNING version 的 CAS 模式，无行返回即版本冲突。
+ */
+export declare class PostgresMessageHistory implements MessageHistory {
+    private readonly db;
+    private readonly tables;
+    private readonly sessionId;
+    constructor(db: PostgresQueryExecutor, tables: PostgresHistoryTableNames, sessionId: string);
+    add(message: Message): Promise<void>;
+    addMany(messages: Message[], options?: MessageHistoryAddOptions): Promise<void>;
+    get(options?: MessageHistoryGetOptions): Promise<Message[]>;
+    clear(): Promise<void>;
+    getVersion(): Promise<number>;
+}
+export declare class PostgresMessageHistoryStore implements MessageHistoryStore {
+    private readonly db;
+    private readonly tables;
+    constructor(options: PostgresMessageHistoryStoreOptions);
+    get(sessionId: string): PostgresMessageHistory;
+    clear(sessionId: string): Promise<void>;
+    deleteSession(sessionId: string): Promise<void>;
+    clearAll(): Promise<void>;
+}
+//# sourceMappingURL=postgres-message-history-store.d.ts.map

package/dist/history/postgres/postgres-message-history-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-message-history-store.d.ts","sourceRoot":"","sources":["../../../src/history/postgres/postgres-message-history-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAK9C,OAAO,KAAK,EACR,cAAc,EACd,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACtB,MAAM,SAAS,CAAC;AAQjB,OAAO,KAAK,EACR,yBAAyB,EACzB,kCAAkC,EAClC,qBAAqB,EACxB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;GAUG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAwB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAG/B,EAAE,EAAE,qBAAqB,EACzB,MAAM,EAAE,yBAAyB,EACjC,SAAS,EAAE,MAAM;IAOf,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCnF,GAAG,CAAC,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA2C/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAQtC;AAED,qBAAa,2BAA4B,YAAW,mBAAmB;IACnE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAwB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEvC,OAAO,EAAE,kCAAkC;IAKvD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,sBAAsB;IAKxC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/history/postgres/postgres-message-history-store.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresMessageHistoryStore = exports.PostgresMessageHistory = void 0;
+const errors_1 = require("../../errors");
+const base_1 = require("../base");
+const tool_pairing_1 = require("../tool-pairing");
+const sql_1 = require("./sql");
+/**
+ * 参考级 Postgres 消息历史。设计约束：
+ *
+ * - 只依赖注入的 query(sql, params)（可直接传 pg.Pool），不使用客户端事务
+ *   API——调用方传进来的可能就是连接池，每次 query 可能落在不同连接上。
+ * - 因此所有需要原子性的写路径都压缩为单条 SQL 语句（data-modifying CTE），
+ *   单条语句在 Postgres 里天然具备事务语义。
+ * - 乐观并发：addMany 带 expectedVersion 时用
+ *   UPDATE ... SET version = version + 1 WHERE session_id = $1 AND version = $2
+ *   RETURNING version 的 CAS 模式，无行返回即版本冲突。
+ */
+class PostgresMessageHistory {
+    db;
+    tables;
+    sessionId;
+    constructor(db, tables, sessionId) {
+        this.db = db;
+        this.tables = tables;
+        this.sessionId = sessionId;
+    }
+    async add(message) {
+        await this.addMany([message]);
+    }
+    async addMany(messages, options = {}) {
+        // 空批次是完整 no-op：不做版本检查也不递增版本（与内存实现一致）。
+        if (messages.length === 0) {
+            return;
+        }
+        const expectedVersion = options.expectedVersion;
+        const statement = buildAddManyStatement(this.tables, this.sessionId, messages, expectedVersion);
+        const result = await this.db.query(statement.text, statement.values);
+        if (result.rows.length > 0) {
+            return;
+        }
+        if (expectedVersion === undefined) {
+            // 无条件写入（INSERT ... ON CONFLICT DO UPDATE）总会返回一行，
+            // 走到这里说明执行器行为异常，而不是版本冲突。
+            throw new errors_1.HistoryError('Postgres message history write returned no version row.', {
+                metadata: {
+                    sessionId: this.sessionId,
+                },
+            });
+        }
+        throw new errors_1.HistoryVersionConflictError({
+            expectedVersion,
+            actualVersion: await this.getVersion(),
+            sessionId: this.sessionId,
+        });
+    }
+    async get(options = {}) {
+        const values = [this.sessionId];
+        const conditions = ['session_id = $1'];
+        if (options.before !== undefined) {
+            values.push((0, base_1.parseMessageHistoryBefore)(options.before).toISOString());
+            conditions.push(`"timestamp" < $${values.length}::timestamptz`);
+        }
+        let limitClause = '';
+        if (options.limit !== undefined) {
+            (0, base_1.assertValidMessageHistoryLimit)(options.limit);
+            if (options.limit === 0) {
+                return [];
+            }
+            values.push(options.limit);
+            limitClause = `\nLIMIT $${values.length}`;
+        }
+        // limit 语义是「最近 N 条」：SQL 侧按 seq 倒序截断，Node 侧再翻回正序。
+        const orderDirection = options.limit === undefined ? 'ASC' : 'DESC';
+        const result = await this.db.query(`
+SELECT role, content, "timestamp", metadata
+FROM ${this.tables.messages}
+WHERE ${conditions.join(' AND ')}
+ORDER BY seq ${orderDirection}${limitClause}
+`.trim(), values);
+        const messages = result.rows.map(sql_1.rowToMessage);
+        if (options.limit !== undefined) {
+            messages.reverse();
+            // 与内存实现一致：limit 切片可能砍在 assistant(toolCalls)/tool
+            // 配对中间，修复窗口开头的孤儿 tool 上下文。
+            (0, tool_pairing_1.repairLeadingToolContext)(messages);
+        }
+        return messages;
+    }
+    async clear() {
+        // 单条语句内完成「版本 +1 + 删除消息」，共享同一事务语义。
+        // clear 递增而非重置版本：防止 "读到 v → 清空 → 重写" 的 ABA 序列
+        // 让持有旧版本号的 CAS 写入意外成功。
+        await this.db.query(`
+WITH bump AS (
+    UPDATE ${this.tables.sessions}
+    SET version = version + 1
+    WHERE session_id = $1
+    RETURNING version
+)
+DELETE FROM ${this.tables.messages}
+WHERE session_id = $1
+`.trim(), [this.sessionId]);
+    }
+    async getVersion() {
+        const result = await this.db.query(`SELECT version FROM ${this.tables.sessions} WHERE session_id = $1`, [this.sessionId]);
+        return (0, sql_1.readVersionColumn)(result.rows[0]?.version);
+    }
+}
+exports.PostgresMessageHistory = PostgresMessageHistory;
+class PostgresMessageHistoryStore {
+    db;
+    tables;
+    constructor(options) {
+        this.db = options.db;
+        this.tables = (0, sql_1.resolvePostgresHistoryTableNames)(options.tablePrefix);
+    }
+    get(sessionId) {
+        // 无进程内状态，按需构造轻量句柄即可；会话状态全部在数据库里。
+        return new PostgresMessageHistory(this.db, this.tables, sessionId);
+    }
+    async clear(sessionId) {
+        await this.get(sessionId).clear();
+    }
+    async deleteSession(sessionId) {
+        // ON DELETE CASCADE 级联删除消息；会话行删除后版本从 0 重新开始。
+        await this.db.query(`DELETE FROM ${this.tables.sessions} WHERE session_id = $1`, [sessionId]);
+    }
+    async clearAll() {
+        await this.db.query(`DELETE FROM ${this.tables.sessions}`);
+    }
+}
+exports.PostgresMessageHistoryStore = PostgresMessageHistoryStore;
+/**
+ * 生成单条 addMany 语句：版本检查/自增 + multi-row 批量插入全部放进同一条
+ * data-modifying CTE，天然原子，不依赖调用方的事务 API。
+ *
+ * - expectedVersion 为 N>0：UPDATE ... WHERE version = $2 RETURNING version，
+ *   无行返回即冲突（会话不存在同样视为冲突，实际版本按 0 处理）。
+ * - expectedVersion 为 0：首次写入，INSERT ... ON CONFLICT (session_id)
+ *   DO UPDATE ... WHERE s.version = 0，同时兼容「行不存在」与「行存在但
+ *   从未成功写入」两种状态。
+ * - 未提供 expectedVersion：INSERT ... ON CONFLICT DO UPDATE 无条件自增，
+ *   总是成功，退化为 last-writer-wins 追加。
+ *
+ * 消息插入通过 CROSS JOIN cas 与版本检查联动：cas 无行时一条消息也不会
+ * 插入。seq 由 IDENTITY 生成，ORDER BY nm.ord 保证批内顺序与入参一致。
+ * 单条 addMany 不做分批：一次调用只对应一次版本 +1；每条消息 4 个参数，
+ * Postgres 协议 65535 个参数的上限足以容纳现实的单轮写入量。
+ */
+function buildAddManyStatement(tables, sessionId, messages, expectedVersion) {
+    const values = [sessionId];
+    let casSql;
+    if (expectedVersion === undefined || expectedVersion === 0) {
+        const casGuard = expectedVersion === 0 ? '\n    WHERE s.version = 0' : '';
+        casSql = `
+    INSERT INTO ${tables.sessions} AS s (session_id, version)
+    VALUES ($1, 1)
+    ON CONFLICT (session_id) DO UPDATE SET version = s.version + 1${casGuard}
+    RETURNING version`;
+    }
+    else {
+        values.push(expectedVersion);
+        casSql = `
+    UPDATE ${tables.sessions}
+    SET version = version + 1
+    WHERE session_id = $1 AND version = $2
+    RETURNING version`;
+    }
+    const rows = messages.map((message, index) => {
+        const json = message.toJSON();
+        const base = values.length;
+        values.push(json.role, (0, sql_1.createJson)(json.content), json.timestamp, (0, sql_1.createJson)(json.metadata));
+        return `    (${index + 1}, $${base + 1}, $${base + 2}::jsonb, $${base + 3}::timestamptz, $${base + 4}::jsonb)`;
+    });
+    const text = `
+WITH cas AS (${casSql}
+),
+new_messages (ord, role, content, "timestamp", metadata) AS (
+    VALUES
+${rows.join(',\n')}
+),
+inserted AS (
+    INSERT INTO ${tables.messages} (session_id, role, content, "timestamp", metadata)
+    SELECT $1, nm.role, nm.content, nm."timestamp", nm.metadata
+    FROM new_messages AS nm
+    CROSS JOIN cas
+    ORDER BY nm.ord
+)
+SELECT cas.version AS version
+FROM cas
+`.trim();
+    return { text, values };
+}
+//# sourceMappingURL=postgres-message-history-store.js.map

package/dist/history/postgres/postgres-message-history-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-message-history-store.js","sourceRoot":"","sources":["../../../src/history/postgres/postgres-message-history-store.ts"],"names":[],"mappings":";;;AAAA,yCAAyE;AAEzE,kCAGiB;AAOjB,kDAA2D;AAC3D,+BAKe;AAOf;;;;;;;;;;GAUG;AACH,MAAa,sBAAsB;IACd,EAAE,CAAwB;IAC1B,MAAM,CAA4B;IAClC,SAAS,CAAS;IAEnC,YACI,EAAyB,EACzB,MAAiC,EACjC,SAAiB;QAEjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,OAAgB;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAmB,EAAE,UAAoC,EAAE;QACrE,sCAAsC;QACtC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAChD,MAAM,SAAS,GAAG,qBAAqB,CACnC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,SAAS,EACd,QAAQ,EACR,eAAe,CAClB,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;QAErE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO;QACX,CAAC;QAED,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAChC,iDAAiD;YACjD,yBAAyB;YACzB,MAAM,IAAI,qBAAY,CAAC,yDAAyD,EAAE;gBAC9E,QAAQ,EAAE;oBACN,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC5B;aACJ,CAAC,CAAC;QACP,CAAC;QAED,MAAM,IAAI,oCAA2B,CAAC;YAClC,eAAe;YACf,aAAa,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE;YACtC,SAAS,EAAE,IAAI,CAAC,SAAS;SAC5B,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,UAAoC,EAAE;QAC5C,MAAM,MAAM,GAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAEvC,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,IAAA,gCAAyB,EAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACrE,UAAU,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,MAAM,eAAe,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAA,qCAA8B,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,OAAO,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,EAAE,CAAC;YACd,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC3B,WAAW,GAAG,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9C,CAAC;QAED,iDAAiD;QACjD,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAC9B;;OAEL,IAAI,CAAC,MAAM,CAAC,QAAQ;QACnB,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;eACjB,cAAc,GAAG,WAAW;CAC1C,CAAC,IAAI,EAAE,EACI,MAAM,CACT,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAY,CAAC,CAAC;QAE/C,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,iDAAiD;YACjD,2BAA2B;YAC3B,IAAA,uCAAwB,EAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,KAAK;QACP,kCAAkC;QAClC,8CAA8C;QAC9C,uBAAuB;QACvB,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CACf;;aAEC,IAAI,CAAC,MAAM,CAAC,QAAQ;;;;;cAKnB,IAAI,CAAC,MAAM,CAAC,QAAQ;;CAEjC,CAAC,IAAI,EAAE,EACI,CAAC,IAAI,CAAC,SAAS,CAAC,CACnB,CAAC;IACN,CAAC;IAED,KAAK,CAAC,UAAU;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAC9B,uBAAuB,IAAI,CAAC,MAAM,CAAC,QAAQ,wBAAwB,EACnE,CAAC,IAAI,CAAC,SAAS,CAAC,CACnB,CAAC;QAEF,OAAO,IAAA,uBAAiB,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;CACJ;AA7HD,wDA6HC;AAED,MAAa,2BAA2B;IACnB,EAAE,CAAwB;IAC1B,MAAM,CAA4B;IAEnD,YAAY,OAA2C;QACnD,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAA,sCAAgC,EAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxE,CAAC;IAED,GAAG,CAAC,SAAiB;QACjB,iCAAiC;QACjC,OAAO,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAiB;QACzB,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB;QACjC,6CAA6C;QAC7C,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CACf,eAAe,IAAI,CAAC,MAAM,CAAC,QAAQ,wBAAwB,EAC3D,CAAC,SAAS,CAAC,CACd,CAAC;IACN,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/D,CAAC;CACJ;AA7BD,kEA6BC;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,qBAAqB,CAC1B,MAAiC,EACjC,SAAiB,EACjB,QAAmB,EACnB,eAAmC;IAEnC,MAAM,MAAM,GAAc,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,MAAc,CAAC;IAEnB,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,MAAM,GAAG;kBACC,MAAM,CAAC,QAAQ;;oEAEmC,QAAQ;sBACtD,CAAC;IACnB,CAAC;SAAM,CAAC;QACJ,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC7B,MAAM,GAAG;aACJ,MAAM,CAAC,QAAQ;;;sBAGN,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAA,gBAAU,EAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,IAAA,gBAAU,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAE5F,OAAO,QAAQ,KAAK,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,mBAAmB,IAAI,GAAG,CAAC,UAAU,CAAC;IACnH,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG;eACF,MAAM;;;;EAInB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;;;kBAGA,MAAM,CAAC,QAAQ;;;;;;;;CAQhC,CAAC,IAAI,EAAE,CAAC;IAEL,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/history/postgres/schema.d.ts

@@ -0,0 +1,18 @@
+export interface PostgresMessageHistorySchemaOptions {
+    tablePrefix?: string;
+    createIndexes?: boolean;
+}
+/**
+ * 消息历史建表 SQL。设计约束：
+ *
+ * - sessions.version 是乐观并发的 CAS 目标：0 表示尚无成功写入，
+ *   每次成功 addMany +1（clear 也 +1，防止版本回卷造成 ABA）。
+ * - messages.seq 用全局 IDENTITY 而不是 per-session 连续序号：READ COMMITTED
+ *   下单条语句的快照看不到并发已提交的行，无法无竞态地计算 MAX(seq)+1；
+ *   IDENTITY 保证全局唯一且批内有序。因此 seq 在会话内单调递增但不保证连续，
+ *   排序语义不受影响。
+ * - content 直接存 Message.toJSON() 的 content 字段：字符串与 block 数组
+ *   都能落进 jsonb。
+ */
+export declare function createPostgresMessageHistorySchemaSql(options?: PostgresMessageHistorySchemaOptions): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/history/postgres/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/history/postgres/schema.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mCAAmC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qCAAqC,CACjD,OAAO,GAAE,mCAAwC,GAClD,MAAM,CA4BR"}