@migor/agentia 0.2.0 → 0.2.2

package/dist/runtime/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/runtime/run.ts"],"names":[],"mappings":"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"}

package/dist/runtime/session.d.ts

@@ -0,0 +1,27 @@
+import type Anthropic from '@anthropic-ai/sdk';
+/**
+ * SessionStore —— 会话持久化 / 对话历史（C4）。
+ *
+ * ⚠️ **与 `MemoryStore` 的区别（别混，文档里必须并列讲）**：
+ * - `MemoryStore`（runtime/memory.ts）= 键值**黑板**：跨 run 存「状态与事实」
+ *   （用户是谁、上次查到哪），run 开始水合进 `RunContext.blackboard`；
+ * - `SessionStore`（本文件）= **对话历史**：存 messages 序列，run 开始拼在传入 messages
+ *   **之前**，收尾时把本轮消息追加回去。
+ *
+ * 两者正交，可以同时用。
+ */
+export interface SessionStore {
+    /** 读整段历史（没有则空数组） */
+    load(sessionId: string): Anthropic.MessageParam[] | Promise<Anthropic.MessageParam[]>;
+    /**
+     * 追加消息（**append-only**）—— 不做 upsert：并发写不会互相覆盖，
+     * 也便于事后审计「这段历史是怎么长出来的」。
+     */
+    append(sessionId: string, messages: Anthropic.MessageParam[]): void | Promise<void>;
+}
+/** Map 实现：测试与缺省场景（进程内，无持久化） */
+export declare class InMemorySessionStore implements SessionStore {
+    private readonly data;
+    load(sessionId: string): Anthropic.MessageParam[];
+    append(sessionId: string, messages: Anthropic.MessageParam[]): void;
+}

package/dist/runtime/session.js

@@ -0,0 +1,16 @@
+/** Map 实现：测试与缺省场景（进程内，无持久化） */
+export class InMemorySessionStore {
+    data = new Map();
+    load(sessionId) {
+        // 返回浅拷贝：run 会把结果拼进自己的 messages 数组并继续 push，
+        // 直接把内部数组交出去会让那些 push 反向污染 store 里的历史。
+        const cur = this.data.get(sessionId);
+        return cur ? [...cur] : [];
+    }
+    append(sessionId, messages) {
+        const cur = this.data.get(sessionId) ?? [];
+        cur.push(...messages);
+        this.data.set(sessionId, cur);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/runtime/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/runtime/session.ts"],"names":[],"mappings":"AAwBA,+BAA+B;AAC/B,MAAM,OAAO,oBAAoB;IACd,IAAI,GAAG,IAAI,GAAG,EAAoC,CAAC;IAEpE,IAAI,CAAC,SAAiB;QACpB,2CAA2C;QAC3C,uCAAuC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,SAAiB,EAAE,QAAkC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/{run → runtime}/spec.d.ts

@@ -2,6 +2,8 @@ import type Anthropic from '@anthropic-ai/sdk';
 import type { ModelClient } from '../core/tool.js';
 import type { AgentTool } from '../core/tool.js';
 import type { ContextPolicy } from '../engine/types.js';
+import type { RetryOptions } from '../engine/retry.js';
+import type { BlackboardSeed } from './context.js';
 /**
  * Agentia —— run 调用契约（spec §6.3 三类触发共用同一份入参形态）。
  * transport 层（同步 RPC / 异步任务 / 定时）只谈 RunInput / RunSpec，
@@ -14,15 +16,27 @@ export interface RunInvocationOptions {
     maxIterations?: number;
     client?: ModelClient;
     onText?: (delta: string) => void;
-    /** 预置进本次 RunContext.blackboard */
-    blackboard?: Record<string, unknown>;
+    /** 中断信号：中止则在飞请求被取消，run 以 stopReason='aborted' 收尾 */
+    signal?: AbortSignal;
+    /** 预置进本次 RunContext.blackboard（扩展过 Blackboard 时键有补全） */
+    blackboard?: BlackboardSeed;
     /** 上下文预算策略（compaction / context editing） */
     contextPolicy?: ContextPolicy;
+    /** 模型请求重试策略（覆盖应用级缺省）；见 RunAgentOptions.retry */
+    retry?: RetryOptions | false;
     /** 幂等键：异步宿主的 at-least-once 去重依据 */
     idempotencyKey?: string;
     /** 硬失败是否抛出；缺省 true（异步宿主置 false 落 failed 记录） */
     rethrow?: boolean;
     tools?: AgentTool[];
+    /** 成本硬管控：整条 run 累计 token 上限；超限以 stopReason='budget_exceeded' 收尾（算失败） */
+    maxTotalTokens?: number;
+    /** 成本硬管控：累计成本（美元）上限；依赖模型在价格表内，见 createBudgetGuard */
+    maxCostUsd?: number;
+    /** 单个工具执行超时（毫秒）；超时该条 tool_result 记 is_error，不杀 run */
+    toolTimeoutMs?: number;
+    /** 同回合并行工具上限；缺省不限 */
+    maxToolConcurrency?: number;
 }
 /** 一次任务的规范化入参：messages（已由 normalizeMessages 规整） */
 export interface RunSpec {

package/dist/runtime/spec.js

@@ -0,0 +1,28 @@
+/** 把任意任务入参规范成 messages（首条缺省包成 user）。 */
+export function normalizeMessages(input) {
+    if (typeof input === 'string') {
+        // 空串与 []、{prompt:''} 一致报错：返回 [] 会带着空 messages 去调模型
+        if (!input)
+            throw new Error('任务 messages 不能为空');
+        return [{ role: 'user', content: input }];
+    }
+    if (Array.isArray(input)) {
+        if (input.length === 0)
+            throw new Error('任务 messages 不能为空');
+        return input;
+    }
+    if (input && typeof input === 'object') {
+        const o = input;
+        if (Array.isArray(o.messages)) {
+            if (o.messages.length === 0)
+                throw new Error('任务 messages 不能为空');
+            return o.messages;
+        }
+        if (typeof o.prompt === 'string' && o.prompt)
+            return [{ role: 'user', content: o.prompt }];
+        if (typeof o.text === 'string' && o.text)
+            return [{ role: 'user', content: o.text }];
+    }
+    throw new Error(`无法识别为任务输入: ${JSON.stringify(input)?.slice(0, 200)}`);
+}
+//# sourceMappingURL=spec.js.map

package/dist/runtime/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/runtime/spec.ts"],"names":[],"mappings":"AAyDA,wCAAwC;AACxC,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,mDAAmD;QACnD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAChD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC5D,OAAO,KAAiC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,KAAiE,CAAC;QAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC,QAAoC,CAAC;QAChD,CAAC;QACD,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3F,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/{run → runtime}/systemPrompt.d.ts

@@ -13,8 +13,20 @@ export interface SystemSection {
     /** stable=false 的段不进可缓存前缀，放在 breakpoint 之后 */
     stable?: boolean;
 }
+export interface SystemPromptOptions {
+    /** 提示词版本号；见 `SystemPrompt.version` */
+    version?: string;
+}
 export declare class SystemPrompt {
     private sections;
+    /**
+     * 提示词版本号（D4）：给了它就自动落到 run 根的 `system.version` attribute ——
+     * 于是 trace 里能查出「这个结果是哪个版本的提示词产出的」（换 prompt 前后对比
+     * 效果、排查回归都靠它）。框架**不做**版本库 / 回滚平台（YAGNI，见 spec §10）：
+     * 版本号怎么来（git sha / 语义版本 / 手工）由你决定。
+     */
+    readonly version?: string;
+    constructor(opts?: SystemPromptOptions);
     add(section: SystemSection): this;
     add(name: string, text: string, stable?: boolean): this;
     get stableText(): string;

package/dist/{run → runtime}/systemPrompt.js

@@ -1,5 +1,15 @@
 export class SystemPrompt {
     sections = [];
+    /**
+     * 提示词版本号（D4）：给了它就自动落到 run 根的 `system.version` attribute ——
+     * 于是 trace 里能查出「这个结果是哪个版本的提示词产出的」（换 prompt 前后对比
+     * 效果、排查回归都靠它）。框架**不做**版本库 / 回滚平台（YAGNI，见 spec §10）：
+     * 版本号怎么来（git sha / 语义版本 / 手工）由你决定。
+     */
+    version;
+    constructor(opts = {}) {
+        this.version = opts.version;
+    }
     add(nameOrSection, text, stable = true) {
         if (typeof nameOrSection === 'string') {
             this.sections.push({ name: nameOrSection, text: text ?? '', stable });
@@ -23,11 +33,13 @@ export class SystemPrompt {
         if (!cache) {
             return [...stable, ...volatile].filter(Boolean).join('\n\n');
         }
+        // 判空必须按**过滤后的文本**：空段（text: ''）不该产出空 text block + breakpoint
+        const stableText = stable.filter(Boolean).join('\n\n');
         const blocks = [];
-        if (stable.length) {
+        if (stableText) {
             blocks.push({
                 type: 'text',
-                text: stable.join('\n\n'),
+                text: stableText,
                 cache_control: { type: 'ephemeral' },
             });
         }
@@ -35,7 +47,8 @@ export class SystemPrompt {
             if (v)
                 blocks.push({ type: 'text', text: v });
         }
-        return blocks;
+        // 无任何段时回 '' 而非 []：engine 对 [] 判真会照发一个空 system
+        return blocks.length > 0 ? blocks : '';
     }
 }
 //# sourceMappingURL=systemPrompt.js.map

package/dist/runtime/systemPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemPrompt.js","sourceRoot":"","sources":["../../src/runtime/systemPrompt.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,YAAY;IACf,QAAQ,GAAoB,EAAE,CAAC;IAEvC;;;;;OAKG;IACM,OAAO,CAAU;IAE1B,YAAY,IAAI,GAAwB,EAAE;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAID,GAAG,CAAC,aAAqC,EAAE,IAAa,EAAE,MAAM,GAAG,IAAI;QACrE,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,IAAI,GAAwB,EAAE;QAClC,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;QAED,4DAA4D;QAC5D,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,UAAU;gBAChB,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,8CAA8C;QAC9C,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC;CACF"}

package/dist/{run → runtime}/types.js.map

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

package/dist/{run → store}/fsStore.d.ts

@@ -20,10 +20,25 @@ export declare class FileTaskStore implements TaskStore {
     private readonly byKey;
     constructor(file: string);
     private load;
+    /**
+     * 尾部残行自愈：文件不以 `\n` 结尾说明最后一次 append 写残了（进程被杀、磁盘满、断电）。
+     * 不处理的话后续 append 会把新记录**粘在残行尾部**——两行并一行，重启后两条一起丢。
+     * - 残行本身是完整记录（只是丢了换行）→ 补一个换行，记录不丢；
+     * - 残行是半截 JSON → 截到最后一个换行处，之后 append 从干净的边界开始。
+     */
+    private healTail;
     private append;
     save(rec: TaskRecord): void;
     get(taskId: string): TaskRecord | undefined;
     byIdempotency(key: string): TaskRecord | undefined;
     list(): TaskRecord[];
     clear(): void;
+    /**
+     * 压实日志：把「一 task 一行」的最新快照整体重写回文件，丢弃同一 task 的历史覆写行。
+     *
+     * append-only 的 JSONL 每 save 一次就追加一行，**容量随 save 次数线性增长**（构造期
+     * load 也全量读回）——长期运行的宿主迟早要压。本方法是 TaskStore 接口之外的能力，
+     * 由宿主按需周期性调用（如低频 cron）；压实时文件短暂不含历史行，但内存态不受影响。
+     */
+    compact(): void;
 }

package/dist/{run → store}/fsStore.js

@@ -1,4 +1,4 @@
-import { mkdirSync, readFileSync, writeFileSync, rmSync, existsSync } from 'node:fs';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, rmSync, truncateSync, writeFileSync, } from 'node:fs';
 import { dirname } from 'node:path';
 /**
  * Agentia —— 文件宿主 TaskStore（spec §6.6：异步耐久 = 换宿主不换语义）。
@@ -33,6 +33,7 @@ export class FileTaskStore {
         catch {
             return; // 读失败按空宿主启动（宿主可另行告警）
         }
+        this.healTail(raw);
         for (const line of raw.split('\n')) {
             if (!line.trim())
                 continue;
@@ -49,6 +50,35 @@ export class FileTaskStore {
             }
         }
     }
+    /**
+     * 尾部残行自愈：文件不以 `\n` 结尾说明最后一次 append 写残了（进程被杀、磁盘满、断电）。
+     * 不处理的话后续 append 会把新记录**粘在残行尾部**——两行并一行，重启后两条一起丢。
+     * - 残行本身是完整记录（只是丢了换行）→ 补一个换行，记录不丢；
+     * - 残行是半截 JSON → 截到最后一个换行处，之后 append 从干净的边界开始。
+     */
+    healTail(raw) {
+        if (!raw || raw.endsWith('\n'))
+            return;
+        const cut = raw.lastIndexOf('\n') + 1; // 最后一个完整行的末尾（字符下标）
+        const tail = raw.slice(cut);
+        let complete = false;
+        try {
+            const rec = JSON.parse(tail);
+            complete = !!rec && typeof rec.taskId === 'string';
+        }
+        catch {
+            complete = false;
+        }
+        try {
+            if (complete)
+                appendFileSync(this.file, '\n'); // 记录是完整的，只差换行
+            else
+                truncateSync(this.file, Buffer.byteLength(raw.slice(0, cut), 'utf8'));
+        }
+        catch {
+            // 修不了就照旧读：能解析的行照常入内存，损坏行由下面的 parse 守卫跳过
+        }
+    }
     append(rec) {
         mkdirSync(dirname(this.file), { recursive: true });
         writeFileSync(this.file, `${JSON.stringify(rec)}\n`, { flag: 'a' });
@@ -75,5 +105,17 @@ export class FileTaskStore {
         if (existsSync(this.file))
             rmSync(this.file);
     }
+    /**
+     * 压实日志：把「一 task 一行」的最新快照整体重写回文件，丢弃同一 task 的历史覆写行。
+     *
+     * append-only 的 JSONL 每 save 一次就追加一行，**容量随 save 次数线性增长**（构造期
+     * load 也全量读回）——长期运行的宿主迟早要压。本方法是 TaskStore 接口之外的能力，
+     * 由宿主按需周期性调用（如低频 cron）；压实时文件短暂不含历史行，但内存态不受影响。
+     */
+    compact() {
+        mkdirSync(dirname(this.file), { recursive: true });
+        const body = [...this.byTask.values()].map((r) => `${JSON.stringify(r)}\n`).join('');
+        writeFileSync(this.file, body);
+    }
 }
 //# sourceMappingURL=fsStore.js.map

package/dist/store/fsStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsStore.js","sourceRoot":"","sources":["../../src/store/fsStore.ts"],"names":[],"mappings":"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"}

package/dist/{run → store}/redisStore.d.ts

@@ -9,6 +9,7 @@ import type { TaskRecord, TaskStore } from './store.js';
  * 存储模型（prefix 缺省 'agentia:'）：
  * - `${prefix}task:<taskId>` → 整行记录 JSON（save = SET 覆写，last-wins）；
  * - `${prefix}idem:<idempotencyKey>` → taskId（同键重提覆写，byIdempotency last-wins）。
+ * 两者都按 `ttlSeconds`（若设）带 EX 过期，见该选项。
  *
  * 语义对照 FileTaskStore / SqliteTaskStore：save 覆写、byIdempotency 取最近、
  * clear 清空本前缀全部 key。差异在 list 序：Redis 本身无序，按 createdAt
@@ -17,10 +18,20 @@ import type { TaskRecord, TaskStore } from './store.js';
  *
  * 前提：**单宿主写者**。save 是两次 SET（记录 + 幂等索引），未走 MULTI 事务；
  * 多写者并发下同键写可能交错，跨进程协调属部署层职责（与 FileTaskStore 一致）。
+ *
+ * 注意（load-bearing）：AsyncRunner 的延迟幂等去重依赖本实现「先 SET 记录、
+ * await 后再 SET idem 索引」的写入顺序（见 async.ts #execute 注释）——若改为
+ * 先写索引或 MULTI 事务，需同步复核该去重路径。
  */
+/** SET 选项（ioredis / node-redis 的 `EX` 形态；仅 ttlSeconds 用到） */
+export interface RedisSetOptions {
+    /** 过期秒数（EX）；<= 0 视为不过期 */
+    EX?: number;
+}
 export interface RedisLike {
     get(key: string): Promise<string | null>;
-    set(key: string, value: string): Promise<unknown>;
+    /** opts 为可选第三参（ioredis / node-redis 均兼容）；老 fake 只实现两参也照常工作 */
+    set(key: string, value: string, opts?: RedisSetOptions): Promise<unknown>;
     /** 单键删除（ioredis / node-redis 的公共最小面；批量清理由多次单删组成） */
     del(key: string): Promise<unknown>;
     /** 模式枚举（node-redis / ioredis 均有）；与 scanIterator 至少提供其一 */
@@ -37,10 +48,19 @@ export interface RedisLike {
 export interface RedisTaskStoreOptions {
     /** key 前缀，缺省 'agentia:' */
     prefix?: string;
+    /**
+     * 每条记录的过期秒数；缺省不设（永不过期）。
+     *
+     * 不设时任务记录（含完整 trace，可能很大）永久驻留，`list()` 的全库 SCAN 也
+     * 无界增长。设了之后**任务的查询窗口就是 TTL**：过期即 404，调用方需在窗口内
+     * 取走结果。<= 0 视为不设。
+     */
+    ttlSeconds?: number;
 }
 export declare class RedisTaskStore implements TaskStore {
     private readonly client;
     private readonly prefix;
+    private readonly ttlSeconds;
     constructor(client: RedisLike, opts?: RedisTaskStoreOptions);
     private taskKey;
     private idemKey;
@@ -49,6 +69,8 @@ export declare class RedisTaskStore implements TaskStore {
     byIdempotency(key: string): Promise<TaskRecord | undefined>;
     list(): Promise<TaskRecord[]>;
     clear(): Promise<void>;
+    /** `${prefix}task:*` —— prefix 里的 glob 元字符必须转义，否则会被当模式解释 */
+    private taskPattern;
     /** 按键枚举：优先 scanIterator，缺则退回 keys(pattern) */
     private enumerate;
 }

package/dist/{run → store}/redisStore.js

@@ -1,12 +1,24 @@
 export class RedisTaskStore {
     client;
     prefix;
+    ttlSeconds;
     constructor(client, opts = {}) {
         this.client = client;
         if (!client.scanIterator && !client.keys) {
             throw new Error('RedisTaskStore 需要 client 提供 scanIterator 或 keys 之一（list/clear 依赖按键枚举）');
         }
-        this.prefix = opts.prefix ?? 'agentia:';
+        const prefix = opts.prefix ?? 'agentia:';
+        if (!prefix) {
+            // 空前缀 = 无命名空间：clear() 的 `${prefix}*` 会 SCAN/DEL 整个库
+            throw new Error('RedisTaskStore 的 prefix 不能为空串（clear 会清空整个库）');
+        }
+        this.prefix = prefix;
+        const ttl = opts.ttlSeconds ?? 0;
+        if (!(ttl >= 0)) {
+            // !(ttl >= 0) 同时拦 NaN —— NaN 会让 `ttl > 0` 恒假，静默把 TTL 关掉
+            throw new Error(`RedisTaskStore 的 ttlSeconds 必须为 ≥ 0 的数（0 = 不设 TTL），收到 ${opts.ttlSeconds}`);
+        }
+        this.ttlSeconds = ttl;
     }
     taskKey(taskId) {
         return `${this.prefix}task:${taskId}`;
@@ -15,9 +27,12 @@ export class RedisTaskStore {
         return `${this.prefix}idem:${key}`;
     }
     async save(rec) {
-        await this.client.set(this.taskKey(rec.taskId), JSON.stringify(rec));
-        if (rec.idempotencyKey)
-            await this.client.set(this.idemKey(rec.idempotencyKey), rec.taskId);
+        const opts = this.ttlSeconds > 0 ? { EX: this.ttlSeconds } : undefined;
+        await this.client.set(this.taskKey(rec.taskId), JSON.stringify(rec), opts);
+        // 每次覆写都刷新 TTL：任务的查询窗口从「最后一次状态推进」起算，而不是创建时刻
+        if (rec.idempotencyKey) {
+            await this.client.set(this.idemKey(rec.idempotencyKey), rec.taskId, opts);
+        }
     }
     async get(taskId) {
         return parseRecord(await this.client.get(this.taskKey(taskId)));
@@ -27,7 +42,7 @@ export class RedisTaskStore {
         return taskId ? this.get(taskId) : undefined;
     }
     async list() {
-        const keys = await this.enumerate(`${this.prefix}task:*`);
+        const keys = await this.enumerate(this.taskPattern());
         const recs = [];
         for (const k of keys) {
             const rec = parseRecord(await this.client.get(k));
@@ -38,10 +53,14 @@ export class RedisTaskStore {
         return recs;
     }
     async clear() {
-        const keys = await this.enumerate(`${this.prefix}*`);
+        const keys = await this.enumerate(`${escapeGlob(this.prefix)}*`);
         for (const k of keys)
             await this.client.del(k);
     }
+    /** `${prefix}task:*` —— prefix 里的 glob 元字符必须转义，否则会被当模式解释 */
+    taskPattern() {
+        return `${escapeGlob(this.prefix)}task:*`;
+    }
     /** 按键枚举：优先 scanIterator，缺则退回 keys(pattern) */
     async enumerate(pattern) {
         if (this.client.scanIterator) {
@@ -57,6 +76,14 @@ export class RedisTaskStore {
         return this.client.keys(pattern);
     }
 }
+/**
+ * 转义 Redis glob 元字符（`\ * ? [ ]`）—— 用于把**字面前缀**拼进 MATCH 模式。
+ * 不转义时，prefix 含 `[` 等字符会让模式被解释成字符类（如 `app[1]:*` 匹配不到
+ * 字面 `app[1]:`），list/clear 静默查错 key。
+ */
+function escapeGlob(s) {
+    return s.replace(/[\\*?[\]]/g, '\\$&');
+}
 /** 解析整行 JSON；单条损坏按缺失处理，不整库崩（与 FileTaskStore 对齐） */
 function parseRecord(raw) {
     if (!raw)

package/dist/store/redisStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redisStore.js","sourceRoot":"","sources":["../../src/store/redisStore.ts"],"names":[],"mappings":"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"}

package/dist/{run → store}/sqliteStore.js

@@ -1,4 +1,17 @@
-import { DatabaseSync } from 'node:sqlite';
+import { createRequire } from 'node:module';
+// node:sqlite 是 Node ≥22.5 才有的内置模块。这里**延迟加载**而非顶层静态 import：
+// 顶层 import 会让**整个包**在未提供该模块的运行时「加载即崩」——`src/index.ts` 对
+// SqliteTaskStore 是 eager 再导出，于是连不用 SQLite 的用户也被殃及。延迟到真正构造
+// store 时才要求它，并给出可操作的报错（而不是一句 ERR_UNKNOWN_BUILTIN_MODULE）。
+const requireBuiltin = createRequire(import.meta.url);
+function loadDatabaseSync() {
+    try {
+        return requireBuiltin('node:sqlite').DatabaseSync;
+    }
+    catch {
+        throw new Error('SqliteTaskStore 需要 Node ≥ 22.5（依赖内置 node:sqlite 模块）');
+    }
+}
 /**
  * Agentia —— SQLite 宿主 TaskStore（spec §6.6：异步耐久 = 换宿主不换语义，roadmap R3）。
  *
@@ -14,11 +27,19 @@ import { DatabaseSync } from 'node:sqlite';
 export class SqliteTaskStore {
     db;
     constructor(path) {
+        const DatabaseSync = loadDatabaseSync();
         this.db = new DatabaseSync(path);
         if (path !== ':memory:') {
             // WAL：读写不互斥，多进程共库的基础（内存库不支持，跳过）
             this.db.exec('PRAGMA journal_mode = WAL');
         }
+        // busy_timeout：写事务争用时不立即报 SQLITE_BUSY，而是等待至多 5s 再重试。
+        // 没有它，多进程共库时第二个写者立即失败 —— 而 AsyncRunner 的 #safeSave 会把
+        // save 失败静默吞掉（不遮罩主流程），结果是任务记录无声丢失。
+        // 内存库同样支持该 pragma（且无争用），无需跳过。
+        this.db.exec('PRAGMA busy_timeout = 5000');
+        // status 列是 json 内 status 的反规范化副本：本 store 的 SELECT 只读 json，
+        // 该列专供外部/DBA 直接按状态统计（如 SELECT status, count(*) FROM tasks GROUP BY status）。
         this.db.exec(`
       CREATE TABLE IF NOT EXISTS tasks (
         task_id TEXT PRIMARY KEY,

package/dist/store/sqliteStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteStore.js","sourceRoot":"","sources":["../../src/store/sqliteStore.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,4DAA4D;AAC5D,yDAAyD;AACzD,2DAA2D;AAC3D,2DAA2D;AAC3D,MAAM,cAAc,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAEtD,SAAS,gBAAgB;IACvB,IAAI,CAAC;QACH,OAAQ,cAAc,CAAC,aAAa,CAAkC,CAAC,YAAY,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,eAAe;IACT,EAAE,CAAe;IAElC,YAAY,IAAY;QACtB,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;QACxC,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,gCAAgC;YAChC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC5C,CAAC;QACD,qDAAqD;QACrD,sDAAsD;QACtD,mCAAmC;QACnC,8BAA8B;QAC9B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC3C,4DAA4D;QAC5D,4EAA4E;QAC5E,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;KAOZ,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,CAAC,GAAe;QAClB,IAAI,CAAC,EAAE;aACJ,OAAO,CACN,2FAA2F,CAC5F;aACA,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAClF,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,CAAC,MAAM,CAErE,CAAC;QACd,OAAO,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;IAED,aAAa,CAAC,GAAW;QACvB,0DAA0D;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,8EAA8E,CAAC;aACvF,GAAG,CAAC,GAAG,CAAiC,CAAC;QAC5C,OAAO,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;IAED,IAAI;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,EAEvE,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAe,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACpC,CAAC;IAED,yCAAyC;IACzC,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/{run → store}/store.d.ts

@@ -1,7 +1,7 @@
 import type { AgentRunResult } from '../engine/types.js';
 import type { SpanError } from '../core/trace.js';
-import type { RunStatus } from './types.js';
-import type { RunSpec } from './spec.js';
+import type { RunStatus } from '../core/run.js';
+import type { RunSpec } from '../engine/spec.js';
 /**
  * Agentia —— run 存储（spec §6.6：异步耐久 = 换宿主不换语义）。
  * 宿主接口：队列/DB 版只需实现 TaskStore，AsyncRunner/调度逻辑不变。
@@ -14,6 +14,10 @@ import type { RunSpec } from './spec.js';
  */
 /** 同步或异步返回值：await 化后两种实现统一（同步值 await 即自身） */
 export type MaybePromise<T> = T | Promise<T>;
+/** store 返回值可能是同步值或 Promise —— 区分用（同步门面只在同步值上工作） */
+export declare function isThenable<T>(x: MaybePromise<T>): x is Promise<T>;
+/** 生成任务 id（与具体 store 实现无关；AsyncRunner 等统一从这里取） */
+export declare function nextTaskId(): string;
 export interface TaskRecord {
     taskId: string;
     status: RunStatus;
@@ -24,6 +28,12 @@ export interface TaskRecord {
     createdAt: number;
     startedAt?: number;
     finishedAt?: number;
+    /**
+     * 认领该任务的进程标识（AsyncRunner 在 submit/重派时写入）。
+     * 多进程共用一个 store 时，`resumePending` 靠它跳过「自己进程的记录」——
+     * 本进程的记录一定还在内存里跑，重派只会让它跑两遍。
+     */
+    ownerId?: string;
     result?: AgentRunResult;
     error?: SpanError;
 }
@@ -38,10 +48,22 @@ export interface TaskStore {
 export declare class InMemoryTaskStore implements TaskStore {
     private readonly byTask;
     private readonly byKey;
+    /** 记录条数上限；Infinity = 不限（缺省，保持旧行为） */
+    private readonly maxRecords;
+    /**
+     * `maxRecords` 给长期运行的宿主一个内存闸门：超过上限时从最旧的**已终态**记录起
+     * 淘汰（queued/running 在飞的记录永不淘汰）。缺省 Infinity = 不淘汰 ——
+     * 每条记录含完整 trace（可能很大），长跑宿主（尤其 createHttpHandler 的缺省
+     * runner）应显式设一个上限或换耐久 store。
+     */
+    constructor(opts?: {
+        maxRecords?: number;
+    });
     save(rec: TaskRecord): void;
+    /** 超过上限时按插入序淘汰已终态记录（在飞记录跳过，避免丢正在跑的任务） */
+    private evict;
     get(taskId: string): TaskRecord | undefined;
     byIdempotency(key: string): TaskRecord | undefined;
     list(): TaskRecord[];
     clear(): void;
-    static nextTaskId(): string;
 }

package/dist/store/store.js

@@ -0,0 +1,63 @@
+import { randomUUID } from 'node:crypto';
+/** store 返回值可能是同步值或 Promise —— 区分用（同步门面只在同步值上工作） */
+export function isThenable(x) {
+    return !!x && typeof x.then === 'function';
+}
+/** 生成任务 id（与具体 store 实现无关；AsyncRunner 等统一从这里取） */
+export function nextTaskId() {
+    return `task_${randomUUID()}`;
+}
+export class InMemoryTaskStore {
+    byTask = new Map();
+    byKey = new Map(); // idempotencyKey → taskId
+    /** 记录条数上限；Infinity = 不限（缺省，保持旧行为） */
+    maxRecords;
+    /**
+     * `maxRecords` 给长期运行的宿主一个内存闸门：超过上限时从最旧的**已终态**记录起
+     * 淘汰（queued/running 在飞的记录永不淘汰）。缺省 Infinity = 不淘汰 ——
+     * 每条记录含完整 trace（可能很大），长跑宿主（尤其 createHttpHandler 的缺省
+     * runner）应显式设一个上限或换耐久 store。
+     */
+    constructor(opts = {}) {
+        const max = opts.maxRecords ?? Number.POSITIVE_INFINITY;
+        if (max !== Number.POSITIVE_INFINITY && !(max > 0)) {
+            throw new Error(`InMemoryTaskStore 的 maxRecords 必须为正数或 Infinity，收到 ${opts.maxRecords}`);
+        }
+        this.maxRecords = max;
+    }
+    save(rec) {
+        this.byTask.set(rec.taskId, rec);
+        if (rec.idempotencyKey)
+            this.byKey.set(rec.idempotencyKey, rec.taskId);
+        if (this.byTask.size > this.maxRecords)
+            this.evict();
+    }
+    /** 超过上限时按插入序淘汰已终态记录（在飞记录跳过，避免丢正在跑的任务） */
+    evict() {
+        for (const [taskId, rec] of this.byTask) {
+            if (this.byTask.size <= this.maxRecords)
+                break;
+            if (rec.status === 'queued' || rec.status === 'running')
+                continue;
+            this.byTask.delete(taskId);
+            if (rec.idempotencyKey && this.byKey.get(rec.idempotencyKey) === taskId) {
+                this.byKey.delete(rec.idempotencyKey);
+            }
+        }
+    }
+    get(taskId) {
+        return this.byTask.get(taskId);
+    }
+    byIdempotency(key) {
+        const taskId = this.byKey.get(key);
+        return taskId ? this.byTask.get(taskId) : undefined;
+    }
+    list() {
+        return [...this.byTask.values()];
+    }
+    clear() {
+        this.byTask.clear();
+        this.byKey.clear();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAoBzC,oDAAoD;AACpD,MAAM,UAAU,UAAU,CAAI,CAAkB;IAC9C,OAAO,CAAC,CAAC,CAAC,IAAI,OAAQ,CAAgB,CAAC,IAAI,KAAK,UAAU,CAAC;AAC7D,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,UAAU,EAAE,EAAE,CAAC;AAChC,CAAC;AA+BD,MAAM,OAAO,iBAAiB;IACX,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IACvC,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,0BAA0B;IAC9E,qCAAqC;IACpB,UAAU,CAAS;IAEpC;;;;;OAKG;IACH,YAAY,IAAI,GAA4B,EAAE;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,iBAAiB,CAAC;QACxD,IAAI,GAAG,KAAK,MAAM,CAAC,iBAAiB,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,qDAAqD,IAAI,CAAC,UAAU,EAAE,CACvE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IACxB,CAAC;IAED,IAAI,CAAC,GAAe;QAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,cAAc;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACvD,CAAC;IAED,yCAAyC;IACjC,KAAK;QACX,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU;gBAAE,MAAM;YAC/C,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;gBAAE,SAAS;YAClE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3B,IAAI,GAAG,CAAC,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,MAAM,EAAE,CAAC;gBACxE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IACD,aAAa,CAAC,GAAW;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC;IACD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}