@fllf/agent-sdk 0.1.2 → 0.1.3

package/dist/history/postgres/schema.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPostgresMessageHistorySchemaSql = createPostgresMessageHistorySchemaSql;
+const sql_1 = require("./sql");
+/**
+ * 消息历史建表 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。
+ */
+function createPostgresMessageHistorySchemaSql(options = {}) {
+    const tables = (0, sql_1.resolvePostgresHistoryTableNames)(options.tablePrefix);
+    const statements = [];
+    statements.push(`
+CREATE TABLE IF NOT EXISTS ${tables.sessions} (
+    session_id text PRIMARY KEY,
+    version bigint NOT NULL DEFAULT 0
+);`.trim());
+    statements.push(`
+CREATE TABLE IF NOT EXISTS ${tables.messages} (
+    session_id text NOT NULL REFERENCES ${tables.sessions}(session_id) ON DELETE CASCADE,
+    seq bigint GENERATED ALWAYS AS IDENTITY,
+    role text NOT NULL,
+    content jsonb NOT NULL,
+    "timestamp" timestamptz NOT NULL,
+    metadata jsonb NOT NULL DEFAULT '{}'::jsonb,
+    PRIMARY KEY (session_id, seq)
+);`.trim());
+    if (options.createIndexes ?? true) {
+        // get({ before }) 的时间窗口查询走 (session_id, "timestamp")；
+        // 主键 (session_id, seq) 已覆盖按序读取。
+        statements.push(`CREATE INDEX IF NOT EXISTS ${indexName(options.tablePrefix, 'messages_session_timestamp_idx')} ON ${tables.messages} (session_id, "timestamp");`);
+    }
+    return `${statements.join('\n\n')}\n`;
+}
+function indexName(tablePrefix, suffix) {
+    const prefix = tablePrefix ?? 'history';
+    return `"${prefix}_${suffix}"`;
+}
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/history/postgres/schema.ts"],"names":[],"mappings":";;AAqBA,sFA8BC;AAnDD,+BAEe;AAOf;;;;;;;;;;;GAWG;AACH,SAAgB,qCAAqC,CACjD,UAA+C,EAAE;IAEjD,MAAM,MAAM,GAAG,IAAA,sCAAgC,EAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACrE,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,UAAU,CAAC,IAAI,CAAC;6BACS,MAAM,CAAC,QAAQ;;;GAGzC,CAAC,IAAI,EAAE,CAAC,CAAC;IAER,UAAU,CAAC,IAAI,CAAC;6BACS,MAAM,CAAC,QAAQ;0CACF,MAAM,CAAC,QAAQ;;;;;;;GAOtD,CAAC,IAAI,EAAE,CAAC,CAAC;IAER,IAAI,OAAO,CAAC,aAAa,IAAI,IAAI,EAAE,CAAC;QAChC,sDAAsD;QACtD,gCAAgC;QAChC,UAAU,CAAC,IAAI,CAAC,8BAA8B,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,gCAAgC,CAAC,OAAO,MAAM,CAAC,QAAQ,6BAA6B,CAAC,CAAC;IACvK,CAAC;IAED,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,WAA+B,EAAE,MAAc;IAC9D,MAAM,MAAM,GAAG,WAAW,IAAI,SAAS,CAAC;IAExC,OAAO,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { Message } from '../../messages';
+import type { PostgresHistoryTableNames } from './types';
+export declare function resolvePostgresHistoryTableNames(tablePrefix?: string): PostgresHistoryTableNames;
+export declare function quoteIdentifier(identifier: string): string;
+export declare function createJson(value: unknown): string;
+/**
+ * content 列直接存 Message.toJSON() 的 content 字段（jsonb）：
+ * 字符串内容是 jsonb 字符串标量，block 数组是 jsonb 数组。
+ * 读取时驱动可能返回已解析的值（node-pg 对 jsonb 的默认行为），也可能返回
+ * JSON 文本（text 模式执行器），这里统一还原：
+ * - 非字符串（数组等）→ 已解析，原样返回；
+ * - 字符串 → 先尝试按 JSON 文本解析，仅当结果是字符串或合法 block 数组时
+ *   采用，否则视为已解析的纯文本内容本身。
+ */
+export declare function readMessageContentColumn(value: unknown): unknown;
+export declare function readJsonObjectColumn(value: unknown): Record<string, unknown>;
+export declare function readTimestampColumn(value: unknown): string;
+/**
+ * sessions.version 是 bigint，node-pg 默认以字符串返回，统一转成 number。
+ * 行缺失（会话不存在）视为版本 0。
+ */
+export declare function readVersionColumn(value: unknown): number;
+/**
+ * 从 SELECT 行复原 Message。
+ * reviveMessage 负责校验 role/content/timestamp：坏行会以
+ * invalid_message_json 报错，而不是悄悄产出畸形消息。
+ */
+export declare function rowToMessage(row: Record<string, unknown>): Message;
+//# sourceMappingURL=sql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../../src/history/postgres/sql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAKzD,wBAAgB,gCAAgC,CAC5C,WAAW,SAAuB,GACnC,yBAAyB,CAO3B;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI1D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmBhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAI5E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM1D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIxD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAOlE"}

package/dist/history/postgres/sql.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePostgresHistoryTableNames = resolvePostgresHistoryTableNames;
+exports.quoteIdentifier = quoteIdentifier;
+exports.createJson = createJson;
+exports.readMessageContentColumn = readMessageContentColumn;
+exports.readJsonObjectColumn = readJsonObjectColumn;
+exports.readTimestampColumn = readTimestampColumn;
+exports.readVersionColumn = readVersionColumn;
+exports.rowToMessage = rowToMessage;
+const messages_1 = require("../../messages");
+const DEFAULT_TABLE_PREFIX = 'history';
+const IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function resolvePostgresHistoryTableNames(tablePrefix = DEFAULT_TABLE_PREFIX) {
+    assertSafeIdentifier(tablePrefix, 'tablePrefix');
+    return {
+        sessions: quoteIdentifier(`${tablePrefix}_sessions`),
+        messages: quoteIdentifier(`${tablePrefix}_messages`),
+    };
+}
+function quoteIdentifier(identifier) {
+    assertSafeIdentifier(identifier, 'identifier');
+    return `"${identifier}"`;
+}
+function createJson(value) {
+    return JSON.stringify(value ?? null);
+}
+/**
+ * content 列直接存 Message.toJSON() 的 content 字段（jsonb）：
+ * 字符串内容是 jsonb 字符串标量，block 数组是 jsonb 数组。
+ * 读取时驱动可能返回已解析的值（node-pg 对 jsonb 的默认行为），也可能返回
+ * JSON 文本（text 模式执行器），这里统一还原：
+ * - 非字符串（数组等）→ 已解析，原样返回；
+ * - 字符串 → 先尝试按 JSON 文本解析，仅当结果是字符串或合法 block 数组时
+ *   采用，否则视为已解析的纯文本内容本身。
+ */
+function readMessageContentColumn(value) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed === 'string') {
+            return parsed;
+        }
+        if (Array.isArray(parsed) && parsed.every(messages_1.isContentBlock)) {
+            return parsed;
+        }
+    }
+    catch {
+        // 不是 JSON 文本：驱动已把 jsonb 字符串标量解析为纯文本。
+    }
+    return value;
+}
+function readJsonObjectColumn(value) {
+    const parsed = typeof value === 'string' ? parseJsonSafely(value) : value;
+    return isRecord(parsed) ? parsed : {};
+}
+function readTimestampColumn(value) {
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    return String(value);
+}
+/**
+ * sessions.version 是 bigint，node-pg 默认以字符串返回，统一转成 number。
+ * 行缺失（会话不存在）视为版本 0。
+ */
+function readVersionColumn(value) {
+    const version = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(version) ? version : 0;
+}
+/**
+ * 从 SELECT 行复原 Message。
+ * reviveMessage 负责校验 role/content/timestamp：坏行会以
+ * invalid_message_json 报错，而不是悄悄产出畸形消息。
+ */
+function rowToMessage(row) {
+    return (0, messages_1.reviveMessage)({
+        role: row.role,
+        content: readMessageContentColumn(row.content),
+        timestamp: readTimestampColumn(row.timestamp),
+        metadata: readJsonObjectColumn(row.metadata),
+    });
+}
+function parseJsonSafely(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function assertSafeIdentifier(value, label) {
+    if (!IDENTIFIER_PATTERN.test(value)) {
+        throw new Error(`Invalid PostgreSQL ${label}: ${value}`);
+    }
+}
+//# sourceMappingURL=sql.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../../src/history/postgres/sql.ts"],"names":[],"mappings":";;AAOA,4EASC;AAED,0CAIC;AAED,gCAEC;AAWD,4DAmBC;AAED,oDAIC;AAED,kDAMC;AAMD,8CAIC;AAOD,oCAOC;AA9FD,6CAA+D;AAI/D,MAAM,oBAAoB,GAAG,SAAS,CAAC;AACvC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC;AAEtD,SAAgB,gCAAgC,CAC5C,WAAW,GAAG,oBAAoB;IAElC,oBAAoB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAEjD,OAAO;QACH,QAAQ,EAAE,eAAe,CAAC,GAAG,WAAW,WAAW,CAAC;QACpD,QAAQ,EAAE,eAAe,CAAC,GAAG,WAAW,WAAW,CAAC;KACvD,CAAC;AACN,CAAC;AAED,SAAgB,eAAe,CAAC,UAAkB;IAC9C,oBAAoB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE/C,OAAO,IAAI,UAAU,GAAG,CAAC;AAC7B,CAAC;AAED,SAAgB,UAAU,CAAC,KAAc;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,wBAAwB,CAAC,KAAc;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE1C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,MAAM,CAAC;QAClB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,yBAAc,CAAC,EAAE,CAAC;YACxD,OAAO,MAAM,CAAC;QAClB,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,qCAAqC;IACzC,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAAc;IAC/C,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAE1E,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,SAAgB,mBAAmB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,KAAc;IAC5C,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAElE,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,GAA4B;IACrD,OAAO,IAAA,wBAAa,EAAC;QACjB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC;QAC9C,SAAS,EAAE,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC;QAC7C,QAAQ,EAAE,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC;KAC/C,CAAC,CAAC;AACP,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IAClC,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { PostgresQueryExecutor } from '../../rag/stores/postgres/types';
+/**
+ * 复用 RAG Postgres 存储的查询执行器类型（仅类型层依赖，不引入 pg 包）：
+ * 同一个 pg.Pool / pg.Client 对象可以同时注入 RAG 存储与消息历史存储。
+ * 用 re-export 而不是重新声明，避免根 barrel 里出现两个同名类型。
+ */
+export type { PostgresQueryExecutor, PostgresQueryResult, } from '../../rag/stores/postgres/types';
+export interface PostgresMessageHistoryStoreOptions {
+    /**
+     * 注入的查询客户端：任何提供 query(sql, params) 的对象（例如 pg.Pool）。
+     * 实现不依赖客户端事务 API，所有原子写路径都压缩为单条 SQL 语句。
+     */
+    db: PostgresQueryExecutor;
+    tablePrefix?: string;
+}
+export interface PostgresHistoryTableNames {
+    sessions: string;
+    messages: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/history/postgres/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;;;GAIG;AACH,YAAY,EACR,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,kCAAkC;IAC/C;;;OAGG;IACH,EAAE,EAAE,qBAAqB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB"}

package/dist/history/postgres/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/history/postgres/types.ts"],"names":[],"mappings":""}

package/dist/history/tool-pairing.d.ts

@@ -0,0 +1,11 @@
+import type { Message } from '../messages';
+/**
+ * 修复消息序列开头被截断产生的孤儿 tool 上下文：
+ * - 序列不能以 tool 消息开头；
+ * - 带 toolCalls 的 assistant 消息若缺少对应的 tool 响应，则连同其后的
+ *   tool 消息一起移除。
+ * 否则把这段历史发给 OpenAI-compatible 端点会直接 400。
+ */
+export declare function repairLeadingToolContext(messages: Message[]): void;
+export declare function withRepairedLeadingToolContext(messages: readonly Message[]): Message[];
+//# sourceMappingURL=tool-pairing.d.ts.map

package/dist/history/tool-pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pairing.d.ts","sourceRoot":"","sources":["../../src/history/tool-pairing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CA+BlE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAItF"}

package/dist/history/tool-pairing.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.repairLeadingToolContext = repairLeadingToolContext;
+exports.withRepairedLeadingToolContext = withRepairedLeadingToolContext;
+/**
+ * 修复消息序列开头被截断产生的孤儿 tool 上下文：
+ * - 序列不能以 tool 消息开头；
+ * - 带 toolCalls 的 assistant 消息若缺少对应的 tool 响应，则连同其后的
+ *   tool 消息一起移除。
+ * 否则把这段历史发给 OpenAI-compatible 端点会直接 400。
+ */
+function repairLeadingToolContext(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 withRepairedLeadingToolContext(messages) {
+    const result = [...messages];
+    repairLeadingToolContext(result);
+    return result;
+}
+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=tool-pairing.js.map

package/dist/history/tool-pairing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pairing.js","sourceRoot":"","sources":["../../src/history/tool-pairing.ts"],"names":[],"mappings":";;AASA,4DA+BC;AAED,wEAIC;AA5CD;;;;;;GAMG;AACH,SAAgB,wBAAwB,CAAC,QAAmB;IACxD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEjC,IAAI,YAAY,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACjB,SAAS;QACb,CAAC;QAED,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5D,OAAO;QACX,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;QACxD,MAAM,eAAe,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,eAAe,GAAG,IAAI,GAAG,CAC3B,QAAQ;aACH,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;aACzB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;aAC7C,MAAM,CAAC,CAAC,UAAU,EAAwB,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,CAC9E,CAAC;QACF,MAAM,mBAAmB,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CACtD,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CACnC,CAAC,CAAC;QAEH,IAAI,mBAAmB,EAAE,CAAC;YACtB,OAAO;QACX,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IACxC,CAAC;AACL,CAAC;AAED,SAAgB,8BAA8B,CAAC,QAA4B;IACvE,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC7B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,OAAgB;IAClC,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW;WAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS;WACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,4BAA4B,CAAC,QAAmB;IACrD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,MAAM,EAAE,CAAC;QACtC,KAAK,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,12 @@
 export * from './agent';
 export * from './config';
+export * from './errors';
 export * from './executors';
 export * from './history';
 export * from './llm';
 export * from './messages';
 export * from './observability';
 export * from './rag';
+export * from './testing';
 export * from './tools';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -16,11 +16,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./agent"), exports);
 __exportStar(require("./config"), exports);
+__exportStar(require("./errors"), exports);
 __exportStar(require("./executors"), exports);
 __exportStar(require("./history"), exports);
 __exportStar(require("./llm"), exports);
 __exportStar(require("./messages"), exports);
 __exportStar(require("./observability"), exports);
 __exportStar(require("./rag"), exports);
+__exportStar(require("./testing"), exports);
 __exportStar(require("./tools"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,8CAA4B;AAC5B,4CAA0B;AAC1B,wCAAsB;AACtB,6CAA2B;AAC3B,kDAAgC;AAChC,wCAAsB;AACtB,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,2CAAyB;AACzB,2CAAyB;AACzB,8CAA4B;AAC5B,4CAA0B;AAC1B,wCAAsB;AACtB,6CAA2B;AAC3B,kDAAgC;AAChC,wCAAsB;AACtB,4CAA0B;AAC1B,0CAAwB"}

package/dist/llm/LLM.d.ts

@@ -18,6 +18,7 @@ export declare class LLM<TClient = unknown> implements ChatModel<TClient> {
     private runSingleAttempt;
     private observeStream;
     private runStreamWithRetries;
+    private emitRetryEvent;
     private runStreamSingleAttempt;
 }
 //# sourceMappingURL=LLM.d.ts.map

package/dist/llm/LLM.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LLM.d.ts","sourceRoot":"","sources":["../../src/llm/LLM.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,EAET,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EAC3B,MAAM,SAAS,CAAC;AAejB,qBAAa,GAAG,CAAC,OAAO,GAAG,OAAO,CAAE,YAAW,SAAS,CAAC,OAAO,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAE/C,MAAM,GAAE,SAAc;IAsBlC,IAAI,IAAI,IAAI,iBAAiB,CAE5B;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,OAAO,GAAG,SAAS,CAEhC;IAED,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAI/C;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAuDjD,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAmClG,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC;YAU9C,cAAc;YA0Bd,gBAAgB;YAoCf,aAAa;YAwDb,oBAAoB;YA+BpB,sBAAsB;CAsDxC"}
+{"version":3,"file":"LLM.d.ts","sourceRoot":"","sources":["../../src/llm/LLM.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,eAAe,EACf,SAAS,EAET,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EAC3B,MAAM,SAAS,CAAC;AAejB,qBAAa,GAAG,CAAC,OAAO,GAAG,OAAO,CAAE,YAAW,SAAS,CAAC,OAAO,CAAC;IAC7D,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;gBAE/C,MAAM,GAAE,SAAc;IA0BlC,IAAI,IAAI,IAAI,iBAAiB,CAE5B;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,OAAO,GAAG,SAAS,CAEhC;IAED,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAI/C;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAgEjD,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC;IAmClG,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC;YAU9C,cAAc;YA2Bd,gBAAgB;YAoCf,aAAa;YAgEb,oBAAoB;YAgCrB,cAAc;YAoBb,sBAAsB;CA0DxC"}