@notic/agent-engine 3.0.3 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +4 -3
  3. package/dist/agent/Agent.d.ts +13 -1
  4. package/dist/agent/Agent.d.ts.map +1 -1
  5. package/dist/agent/Agent.js +80 -7
  6. package/dist/agent/Agent.js.map +1 -1
  7. package/dist/agent/index.d.ts +5 -0
  8. package/dist/agent/index.d.ts.map +1 -1
  9. package/dist/agent/index.js +8 -0
  10. package/dist/agent/index.js.map +1 -1
  11. package/dist/agent/runFromContext.d.ts +13 -0
  12. package/dist/agent/runFromContext.d.ts.map +1 -0
  13. package/dist/agent/runFromContext.js +124 -0
  14. package/dist/agent/runFromContext.js.map +1 -0
  15. package/dist/agent/runFromOptions.d.ts +99 -0
  16. package/dist/agent/runFromOptions.d.ts.map +1 -0
  17. package/dist/agent/runFromOptions.js +19 -0
  18. package/dist/agent/runFromOptions.js.map +1 -0
  19. package/dist/agent/runFromPersistence.d.ts +36 -0
  20. package/dist/agent/runFromPersistence.d.ts.map +1 -0
  21. package/dist/agent/runFromPersistence.js +267 -0
  22. package/dist/agent/runFromPersistence.js.map +1 -0
  23. package/dist/agent/runFromRecovery.d.ts +81 -0
  24. package/dist/agent/runFromRecovery.d.ts.map +1 -0
  25. package/dist/agent/runFromRecovery.js +277 -0
  26. package/dist/agent/runFromRecovery.js.map +1 -0
  27. package/dist/agent/runFromRun.d.ts +25 -0
  28. package/dist/agent/runFromRun.d.ts.map +1 -0
  29. package/dist/agent/runFromRun.js +548 -0
  30. package/dist/agent/runFromRun.js.map +1 -0
  31. package/dist/agent/runFromStore.d.ts +63 -0
  32. package/dist/agent/runFromStore.d.ts.map +1 -0
  33. package/dist/agent/runFromStore.js +131 -0
  34. package/dist/agent/runFromStore.js.map +1 -0
  35. package/dist/agent/runFromTools.d.ts +26 -0
  36. package/dist/agent/runFromTools.d.ts.map +1 -0
  37. package/dist/agent/runFromTools.js +196 -0
  38. package/dist/agent/runFromTools.js.map +1 -0
  39. package/dist/core/data.d.ts +2 -0
  40. package/dist/core/data.d.ts.map +1 -1
  41. package/dist/core/data.js +11 -1
  42. package/dist/core/data.js.map +1 -1
  43. package/dist/message/Message.d.ts +4 -0
  44. package/dist/message/Message.d.ts.map +1 -1
  45. package/dist/message/Message.js +15 -1
  46. package/dist/message/Message.js.map +1 -1
  47. package/dist/session/BaseSession.d.ts +4 -0
  48. package/dist/session/BaseSession.d.ts.map +1 -1
  49. package/dist/session/BaseSession.js +40 -2
  50. package/dist/session/BaseSession.js.map +1 -1
  51. package/dist/session/ListSession.d.ts +3 -0
  52. package/dist/session/ListSession.d.ts.map +1 -1
  53. package/dist/session/ListSession.js +61 -0
  54. package/dist/session/ListSession.js.map +1 -1
  55. package/dist/session/TreeSession.d.ts +3 -0
  56. package/dist/session/TreeSession.d.ts.map +1 -1
  57. package/dist/session/TreeSession.js +31 -4
  58. package/dist/session/TreeSession.js.map +1 -1
  59. package/dist/session/runFromSession.d.ts +60 -0
  60. package/dist/session/runFromSession.d.ts.map +1 -0
  61. package/dist/session/runFromSession.js +220 -0
  62. package/dist/session/runFromSession.js.map +1 -0
  63. package/dist/session/runFromSessionAccess.d.ts +40 -0
  64. package/dist/session/runFromSessionAccess.d.ts.map +1 -0
  65. package/dist/session/runFromSessionAccess.js +8 -0
  66. package/dist/session/runFromSessionAccess.js.map +1 -0
  67. package/dist/session/trace.d.ts +3 -0
  68. package/dist/session/trace.d.ts.map +1 -1
  69. package/dist/session/trace.js +10 -0
  70. package/dist/session/trace.js.map +1 -1
  71. package/dist/tool/ToolExecutor.d.ts +4 -0
  72. package/dist/tool/ToolExecutor.d.ts.map +1 -1
  73. package/dist/tool/ToolExecutor.js +92 -22
  74. package/dist/tool/ToolExecutor.js.map +1 -1
  75. package/dist/tool/runFromToolAccess.d.ts +26 -0
  76. package/dist/tool/runFromToolAccess.d.ts.map +1 -0
  77. package/dist/tool/runFromToolAccess.js +16 -0
  78. package/dist/tool/runFromToolAccess.js.map +1 -0
  79. package/docs/API.md +114 -4
  80. package/docs/RUN-FROM-DESIGN.md +356 -0
  81. package/package.json +1 -1
@@ -0,0 +1,16 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.runFromToolAccess = exports.ToolOutcomeUnknown = void 0;
4
+ const data_1 = require("../core/data");
5
+ /** A handler was invoked but no serializable result was obtained. */
6
+ class ToolOutcomeUnknown extends Error {
7
+ record;
8
+ constructor(cause, record) {
9
+ super((0, data_1.errorOf)(cause).message, { cause });
10
+ this.record = record;
11
+ this.name = "ToolOutcomeUnknown";
12
+ }
13
+ }
14
+ exports.ToolOutcomeUnknown = ToolOutcomeUnknown;
15
+ exports.runFromToolAccess = Symbol("runFromToolAccess");
16
+ //# sourceMappingURL=runFromToolAccess.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runFromToolAccess.js","sourceRoot":"","sources":["../../src/tool/runFromToolAccess.ts"],"names":[],"mappings":";;;AAAA,uCAAuC;AAsBvC,qEAAqE;AACrE,MAAa,kBAAmB,SAAQ,KAAK;IACJ;IAArC,YAAY,KAAc,EAAW,MAA2B;QAC5D,KAAK,CAAC,IAAA,cAAO,EAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QADR,WAAM,GAAN,MAAM,CAAqB;QAE5D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ;AALD,gDAKC;AAEY,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}
package/docs/API.md CHANGED
@@ -1,4 +1,4 @@
1
- # AgentEngine 3.0 API
1
+ # AgentEngine 3.1 API
2
2
 
3
3
  本文对应当前运行时代码。根入口及 /agent、/message、/session、/prompt、/provider、/generator、/tool 子入口提供新 API。历史方案保留在设计记录;迁移见 [MIGRATION-3.0.md](./MIGRATION-3.0.md)。
4
4
 
@@ -210,12 +210,13 @@ const result = await agent.chat("完成任务");
210
210
  | --- | --- |
211
211
  | chat(input,options?) | 添加 User,开始交互,自动执行模型/工具循环 |
212
212
  | run(options?) | 从已准备历史执行,不添加用户消息 |
213
- | continue(options?) | 扩展最后选中 Assistant,支持 targetMessageId/instruction/carryThinking |
214
- | resume(options?) | 接续本实例上一失败/中断运行,新 Run 关联同一 Turn 和 resumedFrom |
213
+ | continue(options?) | 扩展最后选中 Assistant,支持 targetMessageId、instruction、carryThinking 和 persistInstruction |
214
+ | resume(options?) | 接续本实例上一失败或中断的运行,支持 persistInstruction,新 Run 关联原 Turn 和 resumedFrom |
215
+ | runFrom(options) | 从新输入、指定回复或已存档的运行位置开始执行 |
215
216
  | abort(reason?) | 取消当前运行 |
216
217
  | previewContext(options?) | 无消耗预览 run、continue 或 resume 请求上下文 |
217
218
 
218
- options 支持 signal、stream、generation、execution、thinking、requestTimeoutMs。execution.maxSteps 默认 10,3.0.1 起 0 表示不限轮数;负数、非整数和非有限值无效。execution.timeoutMs 覆盖整次运行的模型、工具和审批等待,0 或不设置表示不限时。工具默认 sequential,也可 parallel,与 toolErrorPolicy 独立。return 将异常回传模型;pause/throw 保存失败工具结果后结束,应用决定是否 resume。审批拒绝是工具结果。
219
+ `chat()`、`run()`、`continue()` 和 `resume()` 的 options 支持 signal、stream、generation、execution、thinking、requestTimeoutMs。execution.maxSteps 默认 10,3.0.1 起 0 表示不限轮数;负数、非整数和非有限值无效。execution.timeoutMs 覆盖整次运行的模型、工具和审批等待,0 或不设置表示不限时。工具默认 sequential,也可 parallel,与 toolErrorPolicy 独立。return 将异常回传模型;pause/throw 保存失败工具结果后结束,应用决定是否 resume。审批拒绝是工具结果。
219
220
 
220
221
  `execution.lengthPolicy`(3.0.2)可为 `"error"`(默认,沿用原行为)或 `"complete"`。complete 允许没有工具调用的 length 回复正常结束,结果 status=completed、stopReason=length,afterCommit/afterRun 与 lastRunState 一致;续写同样适用。包含工具调用的截断回复始终失败,不执行工具。单次执行配置可覆盖 Agent 默认值,例如 `await agent.continue({execution:{lengthPolicy:"complete"}})`。CE 希望保持 2.x 截断行为时,应显式设置这个选项。
221
222
 
@@ -231,6 +232,22 @@ AgentResult 包含 runId/turnId?/status/stopReason/message?/usage/error?/unappli
231
232
 
232
233
  导入 Session 恢复数据,不恢复进程运行、等待审批或 exactly-once 工具现场。新 Agent 不能 resume 另一实例运行,可显式 run 已导入上下文。
233
234
 
235
+ ### 保存续写指令
236
+
237
+ `continue()` 和 `resume()` 的 `persistInstruction` 默认关闭。对内置会话开启后,两个入口使用 `runFrom()` 的执行流程,在首个新模型请求前把指令保存为 User 消息。`continue()` 会在该指令之后创建 Assistant 回复。`instruction: ""` 关闭本次指令,续写按原位追加。开启保存的运行仍可通过 `lastRunState` 查看,运行开始后的错误由 `AgentRunError` 携带结果。
238
+
239
+ ```ts
240
+ await agent.continue({
241
+ instruction: "继续给出一个例子。",
242
+ persistInstruction: true,
243
+ });
244
+
245
+ // 在同一个 Agent 中接手一次可恢复的失败或中断。
246
+ await agent.resume({ persistInstruction: true });
247
+ ```
248
+
249
+ 中断的旧运行首次用该选项接手时,从原 Turn 的选中历史开始建立恢复记录。后续 `resume()` 沿用此运行的恢复点,先结算遗留工具批次,再请求模型。如果恢复点已经停在保存的指令上,直接复用该消息。
250
+
234
251
  ### 生命周期与业务保存
235
252
 
236
253
  hooks.beforeRequest(context,identity) 修改请求副本;beforeCommit(message,commitContext) 修改或返回替代生成 Message;afterCommit(actualMessage,commitContext) 在内存提交后执行;afterRun(result) 在运行结算后执行。hook 可异步,内存提交与业务数据库保存分别处理。
@@ -241,6 +258,99 @@ hooks.beforeRequest(context,identity) 修改请求副本;beforeCommit(message,
241
258
 
242
259
  afterCommit 失败保留已提交内容,停止后续执行;afterRun 失败用 AgentRunError 携带原结果,运行状态仍表示实际执行事实。Agent 通知事件包含 Generator、Executor 事件,以及 runStarted/messageCommitted/runFinished。messageCommitted.message 为提交快照。普通通知异常交给 onHandlerError,不用于转换;显示、保存、发送的内容可以不同。
243
260
 
261
+ ### `runFrom()`
262
+
263
+ `Agent.runFrom(options: RunFromOptions): Promise<RunFromResult>` 支持 `TreeSession`、`ListSession` 和 `AgentSession`。本次执行的位置、上下文和写回方式由 `from`、`context` 和 `commit` 决定。
264
+
265
+ | `from.kind` | 起点和默认行为 |
266
+ | --- | --- |
267
+ | `input` | 在当前路径追加 User 消息,创建 Turn 和回复 |
268
+ | `reply` | 从指定 Assistant 回复接写。首步把新增内容合并到该回复,历史思考以临时 Assistant 文本回传。显式 `fork: true` 时在新分支创建回复 |
269
+ | `run` | 用 `runId` 找到该任务的最新恢复点。先处理遗留工具批次,再创建新模型回复。可用 `afterStepId` 定位到某个已完成步骤及其结算后的工具历史 |
270
+
271
+ 树位置由 `nodeId` 指定。列表和 Agent 会话的位置需要行 ID、候选 ID、消息 ID 和从 0 开始的 `messageIndex`。接续时核对当前选中路径、消息位置和请求版本。更早的位置需显式分支,若切点之后已有工具活动,返回 `later_tool_activity`。
272
+
273
+ `context.instruction` 和 `replayThinking` 构造首个新模型请求的临时消息。`replayThinking` 可选 `reply` 或 `turn` 范围及 `assistant` 或 `user` 角色。`context.build` 每步收到历史副本、思考块、请求草稿和 `stepIndex`。`commit` 可为静态决定或回调。静态决定用于首个新步骤,后续创建新消息。回调用 `currentEnd` 核对写入位置,并可按 `partial` 处理保留片段。
274
+
275
+ 设置 `context.persistInstruction: true` 会在首次新模型请求前把继续指令保存为当前路径的一条 User 消息。有遗留工具批次时,先把工具结果写入历史,再保存指令。思考回传仍是临时上下文,空字符串关闭本次指令。若恢复点停在已保存的指令上,接手时会复用该消息。保存后会话末尾为 User,所以 `reply` 默认创建新回复。自定义提交可通过 `commit({ currentEnd })` 确认写入位置并返回 `create`。
276
+
277
+ ```ts
278
+ import type { Agent, RunFromPosition, RunFromStore } from "@notic/agent-engine";
279
+
280
+ export function startTask(agent: Agent, input: string, store?: RunFromStore) {
281
+ return agent.runFrom({ from: { kind: "input", input }, store });
282
+ }
283
+
284
+ export function finishReply(agent: Agent, nodeId: string, persistInstruction = false, store?: RunFromStore) {
285
+ const position: RunFromPosition = { type: "tree", nodeId };
286
+ return agent.runFrom({
287
+ from: { kind: "reply", position },
288
+ store,
289
+ context: { persistInstruction, replayThinking: { scope: "reply", role: "user" } },
290
+ });
291
+ }
292
+ ```
293
+
294
+ **跨进程接手**
295
+
296
+ 默认存档随 Agent 实例保存在内存中。需要在应用重启后接手时,从首次调用起传入持久化 `RunFromStore`。可以在收到 `runStarted` 后保存 `session.id` 和 `runId`,也可以通过 `store.read(sessionId)` 读取存档中的任务链。
297
+
298
+ ```ts
299
+ import { Agent, restoreRunFromSaveData } from "@notic/agent-engine/agent";
300
+ import type { RunFromStore, RunFromToolResolution } from "@notic/agent-engine/agent";
301
+ import type { ChatProvider, ToolKit } from "@notic/agent-engine";
302
+
303
+ export async function resumeTask(
304
+ store: RunFromStore,
305
+ sessionId: string,
306
+ runId: string,
307
+ provider: ChatProvider,
308
+ model: string,
309
+ toolkit: ToolKit,
310
+ toolResolutions?: readonly RunFromToolResolution[],
311
+ ) {
312
+ const saved = await store.read(sessionId);
313
+ if (!saved) throw new Error("任务存档不存在");
314
+ const { session } = restoreRunFromSaveData(saved.data, sessionId);
315
+ const agent = new Agent({ session, provider, model, toolkit });
316
+ return agent.runFrom({
317
+ from: { kind: "run", runId },
318
+ store,
319
+ toolResolutions,
320
+ context: { replayThinking: { scope: "turn", role: "user" } },
321
+ commit: ({ currentEnd }) => ({ mode: "create", at: currentEnd }),
322
+ });
323
+ }
324
+ ```
325
+
326
+ 存档中的 `model` 表示可以发起新模型请求,`tools` 表示需要先处理工具批次,`closed` 表示运行已完成。新进程重新装配工具、审批、Provider 和业务回调。从存档恢复时,`RunFromResult.recovery` 给出最新确认的位置。错误通过 `RunFromError.code` 区分。仍被占用的存档返回 `session_busy`,分支或请求不一致返回 `session_conflict`,已完成任务返回 `recovery_closed`。单独读取和校验存档时,`restoreRunFromSaveData()` 会对无效数据抛出 `InvalidRunFromRecoveryError`。
327
+
328
+ **工具结果补录与重试**
329
+
330
+ 接手批次时,已结算结果会复用,待执行调用使用当前工具和审批。租约过期后,存档中仍为 `started` 的调用按未知结果处理。`tool_outcome_unknown` 的 `error.tools` 给出对应的执行 ID。应用为每个未知调用提供决定后,批次才能推进。对尚未调用工具时发现的确定失败,`toolErrorPolicy` 默认把结果发给模型,`pause` 或 `throw` 会暂停本批并保留待执行调用。
331
+
332
+ ```ts
333
+ import type { JsonValue, RunFromToolResolution, SettledToolStatus } from "@notic/agent-engine";
334
+
335
+ export function toolDecisions(
336
+ confirmedId: string,
337
+ status: SettledToolStatus,
338
+ receipt: JsonValue,
339
+ idempotentId: string,
340
+ ): RunFromToolResolution[] {
341
+ return [
342
+ { executionId: confirmedId, action: "record", status, value: receipt },
343
+ { executionId: idempotentId, action: "retry" },
344
+ ];
345
+ }
346
+ ```
347
+
348
+ `record` 接受查证后的 `completed`、`failed` 或 `rejected` 结果。`retry` 沿用原 `ToolContext.toolExecutionId`,由工具把它作为外部服务的幂等键。所有结果确认后按原顺序写回调用所在路径,并保留工具最初所属的 Run 和 Step。
349
+
350
+ 应用实现的 `RunFromStore` 以 `RunFromStoreWrite` 一次提交会话、追踪记录和恢复点。`acquire` 核对预期修订号并取得租约,首次写入的 `expectedRevision` 为 `null`。`renew` 和 `write` 校验有效的租约令牌,`write` 同时核对修订号。存档返回 `revision` 和最近的 `lastWriteId`,供写入响应丢失时读回确认。在同一有效租约中,应用可以用相同的 `writeId` 和数据确认最近一次写入。`release` 只释放匹配令牌的租约。`RunFromStoreErrorCode` 区分版本冲突、租约占用、租约失效和写入 ID 冲突。
351
+
352
+ 公开类型和存档帮助函数可从包根或 `@notic/agent-engine/agent` 导入。完整字段、原子事务约定和分支规则见 [runFrom 设计](./RUN-FROM-DESIGN.md)。
353
+
244
354
  ## PromptBuilder:独立临时上下文
245
355
 
246
356
  ```ts
@@ -0,0 +1,356 @@
1
+ # AgentEngine runFrom 接续设计
2
+
3
+ 设计稿 · 2026-11-16 · 基线 AgentEngine 3.0.3(`cb64c77`)
4
+
5
+ `Agent.runFrom()` 从新输入、指定回复或已保存的运行恢复点开始执行。业务可以选择接续位置、构造本次模型上下文,并决定把生成内容合并到现有回复还是创建新回复。需要跨应用重启的任务从首次执行起使用 `runFrom()` 和持久化存储。
6
+
7
+ `runFrom()` 可以直接调用,`continue()` 和 `resume()` 开启 `persistInstruction` 后也使用同一执行流程。`resume()` 接手这类运行时使用其已保存的恢复点。新入口复用 Message、Session、PromptBuilder、Generator 和 ToolExecutor,使用 Session v3 格式。 [3.0 API](./API.md)
8
+
9
+ ## 公开接口
10
+
11
+ ```ts
12
+ import type {
13
+ AgentResult, Message, MessageContent, MessageData, PromptContext,
14
+ PromptTransformResult, RunOptions, SessionData,
15
+ } from "@notic/agent-engine";
16
+
17
+ export type RunFromPosition =
18
+ | { type: "tree"; nodeId: string }
19
+ | {
20
+ type: "list" | "agent";
21
+ rowId: string;
22
+ candidateId: string;
23
+ messageIndex: number;
24
+ messageId: string;
25
+ };
26
+
27
+ export type RunFromSource =
28
+ | { kind: "input"; input: MessageContent | Message }
29
+ | { kind: "reply"; position: RunFromPosition; fork?: boolean }
30
+ | { kind: "run"; runId: string; afterStepId?: string; fork?: boolean };
31
+
32
+ export interface RunFromResolvedSource {
33
+ kind: RunFromSource["kind"];
34
+ position: RunFromPosition;
35
+ turnId?: string;
36
+ fromRunId?: string;
37
+ fromStepId?: string;
38
+ }
39
+
40
+ export interface RunFromThinkingPart {
41
+ position: RunFromPosition;
42
+ messageId: string;
43
+ partId: string;
44
+ text: string;
45
+ }
46
+
47
+ export interface RunFromContextInput {
48
+ source: RunFromResolvedSource;
49
+ history: readonly Message[];
50
+ thinkingParts: readonly RunFromThinkingPart[];
51
+ draft: PromptContext;
52
+ stepIndex: number;
53
+ signal: AbortSignal;
54
+ }
55
+
56
+ export interface RunFromContextOptions {
57
+ instruction?: string;
58
+ persistInstruction?: boolean;
59
+ replayThinking?: false | { scope: "reply" | "turn"; role: "assistant" | "user" };
60
+ build?: (input: RunFromContextInput) =>
61
+ Message[] | PromptTransformResult | Promise<Message[] | PromptTransformResult>;
62
+ }
63
+
64
+ export type RunFromCommitDecision =
65
+ | { mode: "append"; at?: RunFromPosition }
66
+ | { mode: "create"; at?: RunFromPosition };
67
+
68
+ export interface RunFromCommitInput {
69
+ source: RunFromResolvedSource;
70
+ currentEnd: RunFromPosition;
71
+ generated: Message;
72
+ stepIndex: number;
73
+ partial: boolean;
74
+ signal?: AbortSignal;
75
+ }
76
+
77
+ export type RunFromCommit = RunFromCommitDecision | ((input: RunFromCommitInput) =>
78
+ RunFromCommitDecision | Promise<RunFromCommitDecision>);
79
+
80
+ export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };
81
+ export type SettledToolStatus = "completed" | "failed" | "rejected";
82
+
83
+ export type RunFromToolResolution =
84
+ | { executionId: string; action: "record"; status: SettledToolStatus; value: JsonValue }
85
+ | { executionId: string; action: "retry" };
86
+
87
+ export interface RunFromOptions extends RunOptions {
88
+ from: RunFromSource;
89
+ context?: RunFromContextOptions;
90
+ commit?: RunFromCommit;
91
+ store?: RunFromStore;
92
+ toolResolutions?: readonly RunFromToolResolution[];
93
+ }
94
+
95
+ export interface RunFromRecovery {
96
+ id: string;
97
+ rootRunId: string;
98
+ runId: string;
99
+ turnId?: string;
100
+ stepId?: string;
101
+ position: RunFromPosition;
102
+ path: SavedRunFromPath;
103
+ phase: "model" | "tools" | "closed";
104
+ }
105
+
106
+ export interface RunFromResult extends AgentResult {
107
+ recovery: RunFromRecovery;
108
+ }
109
+
110
+ export type RunFromErrorCode =
111
+ | "invalid_options" | "unsupported_session" | "session_busy" | "session_conflict"
112
+ | "recovery_missing" | "recovery_closed" | "invalid_recovery" | "later_tool_activity"
113
+ | "invalid_context" | "invalid_commit" | "invalid_tool_resolution" | "tool_outcome_unknown"
114
+ | "storage_failed" | "abort" | "timeout" | "max_steps" | "generation_failed"
115
+ | "tool_failed" | "hook_failed";
116
+
117
+ export declare class RunFromError extends Error {
118
+ readonly code: RunFromErrorCode;
119
+ readonly result?: RunFromResult;
120
+ readonly recovery?: RunFromRecovery;
121
+ readonly tools?: readonly SavedRunFromTool[];
122
+ readonly cause?: unknown;
123
+ }
124
+ ```
125
+
126
+ `Agent` 新增方法 `runFrom(options: RunFromOptions): Promise<RunFromResult>`。新类型从包根和 `./agent` 导出。`RunFromStore` 与 `SavedRunFromTool` 的数据契约见下文。
127
+
128
+ `messageIndex` 从 0 开始。列表位置同时核对行、候选、索引和预期的消息 ID。首版适配 `TreeSession`、`ListSession` 的两种候选单位和 `AgentSession`。其他 `SessionLike` 在新入口报告 `unsupported_session`。
129
+
130
+ ### 输入、上下文和写回默认值
131
+
132
+ | `from.kind` | 读取的起点 | 第一次新模型请求 | 写回默认值 |
133
+ | --- | --- | --- | --- |
134
+ | `input` | 当前选中的可用历史,追加一条 User 并建立 Turn | 正常构建上下文 | 创建新回复 |
135
+ | `reply` | 指定位置的 Assistant 回复 | 把该回复已有的思考作为临时 Assistant 文本,再加续写指令 | 首段合并到原回复,后续步骤创建新回复。显式 `fork` 时首段也创建新回复 |
136
+ | `run` | 所指任务最近的恢复点。指定 `afterStepId` 时,从该步骤及其工具批次结算后的位置起步 | 把已保存的工具结果纳入历史,再加任务接续指令。额外思考文本由业务开启 | 创建新回复 |
137
+
138
+ `input` 接受用户消息或可转换为用户消息的内容。`reply` 要求目标回复可作为模型历史的结尾,且自身没有工具调用。`runId` 可以取自恢复链上的任一 Run,默认找到该链最新的恢复点。传入 `afterStepId` 后,目标步骤必须属于这条恢复链并形成完整的请求历史。若希望接续仍在执行的工具批次,使用当前恢复点。
139
+
140
+ `RunOptions` 中的信号、生成参数、流式选项、思考协议、超时和工具策略继续适用。默认流式生成、最多 10 个新模型步骤、顺序执行工具,确定的工具失败作为结果发给模型。总时限覆盖此次模型、工具和审批。单次请求时限按本次选项、Agent、Generator 的顺序取值,两项时限缺省或为 0 时不限时。`maxSteps: 0` 表示不限模型步骤。长度截断默认按 `lengthPolicy: "error"` 处理。显式 `"complete"` 允许无工具调用的截断回复结算,截断的工具调用始终走失败处理。 [运行配置](./API.md#agent自主运行与提交)
141
+
142
+ 各入口共用 Agent 和 Session 的活动运行互斥,`abort()` 可以停止当前的 `runFrom()`。直接调用 `runFrom()` 时使用返回值、错误和存档跟踪运行。通过 `continue()` 或 `resume()` 调用时,`lastRunState` 也记录此次运行,供同一实例继续接手。
143
+
144
+ ### 请求上下文
145
+
146
+ - `instruction` 省略时,回复接续使用「继续上一条回复,避免重复」,任务接续使用「根据已有结果继续任务,避免重复已完成的操作」。`input` 默认直接使用提交的用户输入。空字符串关闭额外指令。
147
+ - `persistInstruction` 默认使用临时指令。设为 `true` 时,首个新模型请求前将指令保存为当前路径的一条 User 消息,并计入已有 Turn 的输入。先接手工具时,指令紧跟已结算的工具结果。恢复点若停在该指令上,使用已有消息。持久化指令后的会话末尾是 User,`reply` 默认创建新回复,显式提交也使用 `create`。
148
+ - `replayThinking: false` 关闭额外的思考文本。`scope: "reply"` 读取选定的回复,适用于 `reply`。`scope: "turn"` 按当前接续路径从该 Turn 的用户输入收集到接续位置,包含独立工具调用消息中的已保存思考块。同一位置里的每个思考块按原顺序收录一次。当前历史缺少可核对的 Turn 时返回 `invalid_context`,业务可以通过 `build` 按自己的轮次归组。
149
+ - 回传内容作为普通文本合成指定角色的一条临时消息。当角色为 User 且同时有接续指令时,两者放在同一条临时 User 消息的不同段落。`RunOptions.thinking` 单独负责历史思考块的 Provider 协议编码。
150
+ - 默认回传和临时指令只加在此次调用的第一个新模型请求中。若先处理遗留的工具批次,等结果进入历史后再构造该请求。`build` 在每次模型请求时收到历史快照、所选范围内的思考块、默认草稿和从 0 开始的 `stepIndex`。返回值交给 `PromptBuilder` 的注入和转换,再经过 `beforeRequest`。引擎检查最后的工具调用与结果配对,临时消息只进入请求上下文。
151
+
152
+ ### 提交与结果
153
+
154
+ `commit` 支持静态写法,以及按每步生成结果选择写法的回调。静态 `commit` 用于首个新模型步骤,后续步骤默认 `create`。回调会在每次提交前收到脱离会话的生成快照,也可对保留片段单独给出决定。
155
+
156
+ - `append` 要求 `at` 是已验证路径末尾的一条可续写 Assistant 回复。省略 `at` 时使用当前末尾。唯一出现的目标以原消息 ID 保存。首版对多处共享的 Message 返回 `invalid_commit`,业务可以选择在指定位置创建新回复,避免一次编辑同时改动多个候选。
157
+ - `create` 在本次执行路径的末尾创建回复。`at` 用来确认具体写入位置,省略时使用已解析的末尾。从较早位置继续时,由 `from.fork` 先建立执行分支,之后的提交沿该分支进行。
158
+ - 生成的正文和工具协议消息按实际提交方案处理。合并正文时,工具调用及其相关思考保存在独立的助手消息里。工具结果属于发出调用的模型步骤,始终沿本次执行的候选追加。原有 `beforeCommit` 和 `beforeAppend` 可编辑提交草稿,写入前再次校验目标和协议关系。
159
+ - 流中断、被取消或超时时,默认提交可用的文本、思考和媒体片段。残缺的工具调用从可提交片段中移除。片段沿统一的提交和持久化流程,取消后的收尾使用仍有效的存储租约,提交钩子的 `signal` 可以省略。Provider 已报告的部分用量计入对应 Step。若冲突或写入失败,错误结果通过 `unapplied` 或 `unappliedToolResults` 交回尚未提交的内容。
160
+ - 写入确认后发布 `messageCommitted` 并调用 `afterCommit`。需要和消息一起落盘的业务字段在提交前处理。存储适配器的确认是推进恢复点的依据。`afterCommit` 失败时保留已保存的进度。运行结算后触发 `runFinished` 和 `afterRun`,结算后的钩子错误也通过 `RunFromError` 带回已保存的结果。
161
+
162
+ 完成时返回 `RunFromResult`。首份运行存档获得确认后,运行正式开始。失败时抛出带 `code` 的 `RunFromError`,如果运行已经开始,`result` 包含进度、停止原因及最近确认的恢复点。位置冲突携带原位置。工具结果未确认或从历史位置恢复遇到后续工具活动时,错误携带相关工具记录。
163
+
164
+ 本次 Run 的 `usage` 统计本次新发出的模型请求。恢复后继续处理的旧工具调用保留原 `runId`、`stepId` 和内部执行 ID。普通 Run 记录使用现有 `kind`,分别为 `chat`、`continue` 或 `resume`。接手已有任务时,记录同一个 Turn,并用 `resumedFrom` 指向本次接手的 Run。
165
+
166
+ ### 调用示例
167
+
168
+ ```ts
169
+ // 首次运行即保存恢复点
170
+ await agent.runFrom({
171
+ from: { kind: "input", input: "整理本轮任务的材料" },
172
+ store,
173
+ });
174
+
175
+ // 以 User 身份回传本轮已保存的思考,在接续位置后创建回复
176
+ await agent.runFrom({
177
+ from: { kind: "run", runId },
178
+ store,
179
+ context: {
180
+ replayThinking: { scope: "turn", role: "user" },
181
+ instruction: "参考本轮已有思考和已保存的工具结果,继续完成任务。",
182
+ },
183
+ commit: { mode: "create" },
184
+ });
185
+
186
+ // 补完一条已经保存在会话里的回复
187
+ await agent.runFrom({
188
+ from: { kind: "reply", position: { type: "tree", nodeId: partialReplyNodeId } },
189
+ commit: { mode: "append" },
190
+ });
191
+ ```
192
+
193
+ ## 恢复点存储与校验
194
+
195
+ ### 数据和存储接口
196
+
197
+ 恢复存档包含原样的 `SessionData` 和独立版本的恢复记录。应用可以分表保存,只要会话、执行记录和本次恢复状态能在同一个事务中提交。`Session.toJSON()` 继续产出现有格式。省略 `store` 时,`runFrom()` 使用本 Agent 实例内的存档。应用重启后恢复任务使用同一个持久化适配器。 [Session v3 格式](./API.md#公开存储结构)
198
+
199
+ ```ts
200
+ export type SavedRunFromToolState =
201
+ | { state: "pending" }
202
+ | { state: "started"; leaseToken: string }
203
+ | { state: "unknown" }
204
+ | { state: "settled"; status: SettledToolStatus; result: MessageData };
205
+
206
+ export interface SavedRunFromTool {
207
+ executionId: string;
208
+ runId: string;
209
+ stepId: string;
210
+ ordinal: number;
211
+ toolCallId: string;
212
+ name: string;
213
+ arguments: string;
214
+ progress: SavedRunFromToolState;
215
+ }
216
+
217
+ export type SavedRunFromPath =
218
+ | { type: "tree"; cursor: string }
219
+ | {
220
+ type: "list" | "agent";
221
+ rows: readonly { rowId: string; candidateId: string }[];
222
+ excludedRows?: readonly { rowId: string; candidateId: string }[];
223
+ };
224
+
225
+ export interface SavedRunFromPoint extends RunFromRecovery {
226
+ requestFingerprint: string;
227
+ tools: readonly SavedRunFromTool[];
228
+ instructionMessageId?: string;
229
+ }
230
+
231
+ export interface SavedRunFromTask {
232
+ rootRunId: string;
233
+ headPointId: string;
234
+ points: readonly SavedRunFromPoint[];
235
+ }
236
+
237
+ export interface RunFromSaveData {
238
+ format: "agent-engine-run-from";
239
+ version: 1;
240
+ session: SessionData;
241
+ tasks: readonly SavedRunFromTask[];
242
+ }
243
+
244
+ export interface RunFromStoredSession {
245
+ revision: number;
246
+ lastWriteId: string;
247
+ data: RunFromSaveData;
248
+ }
249
+
250
+ export interface RunFromLease {
251
+ sessionId: string;
252
+ token: string;
253
+ expiresAt: number;
254
+ }
255
+
256
+ export interface RunFromStoreWrite {
257
+ lease: RunFromLease;
258
+ expectedRevision: number | null;
259
+ writeId: string;
260
+ data: RunFromSaveData;
261
+ }
262
+
263
+ export interface RunFromStore {
264
+ read(sessionId: string): Promise<RunFromStoredSession | undefined>;
265
+ acquire(sessionId: string, expectedRevision: number | null): Promise<RunFromLease>;
266
+ renew(lease: RunFromLease): Promise<RunFromLease>;
267
+ write(input: RunFromStoreWrite): Promise<RunFromStoredSession>;
268
+ release(lease: RunFromLease): Promise<void>;
269
+ }
270
+ ```
271
+
272
+ 恢复点使用现有会话和执行记录中的 ID。`runId` 指推进该恢复点的运行,`stepId` 可以是同一恢复链上被接手的模型步骤。工具批次尚未写入会话时,结果保存在 `settled.result`。批次写入后,结果消息沿用这份数据的 ID,供原 Step 和工具执行记录引用。存储实现可对同一条已保存的消息按 ID 去重,读取时还原为 `MessageData`。 [执行记录](./API.md#查询与记录)
273
+
274
+ 存储修订号从首次写入开始递增,`expectedRevision: null` 表示尚无记录。`acquire` 原子核对修订号并取得该会话的执行权。租约使用存储的时钟和有效期,每次重新取得执行权都分配新的令牌。`renew`、`write` 和 `release` 都校验令牌,`write` 还核对期望修订号。应用持久化会话编辑和位置选择时也用同一个修订号协调更新。并行工具的状态写入在同一租约内排队。相同 `writeId` 的最近一次提交可幂等确认,写入响应丢失时通过当前版本与 `lastWriteId` 核查。
275
+
276
+ ### 保存顺序
277
+
278
+ 1. 完成输入、位置和写入方案的前置校验,取得本地 Session 租约及存储执行权。新任务把初始用户输入、Turn、Run 和第一份 `model` 恢复点一起保存。已有回复接续在同一事务中记录起点和新 Run。
279
+ 2. 每次模型输出提交时保存会话变更、Step 和用量。模型请求有效完成且工具调用内容完整时,保存调用消息、原始顺序、稳定的执行 ID 和 `pending` 状态,将恢复点推进到 `tools`。通过结束策略判定完成的最终回复与 Run 完成状态一起保存为 `closed`。保留的中断片段对应一个可再次发起模型请求的 `model` 恢复点。
280
+ 3. 每项工具通过参数校验和当前审批后,实际启动前写入 `started`,拿到确认再复查取消、工具注册状态和会话所有权。取得确定结果后逐项写入 `settled`,并行执行也如此。若最后一次校验拦住了启动,仍在运行的执行者可以明确恢复该项的 `pending` 状态。
281
+ 4. 全部工具有确定结果后,按原调用顺序把结果成对写入会话,更新原 Step 的执行记录,同时推进到 `model`。下一次模型请求以这个已确认的位置为起点。
282
+
283
+ 写入采用提议快照,经存储确认后发布到 live Session。写入前后都校验本地请求上下文。若保存期间业务编辑了 live 会话,保留业务编辑并报告冲突,已确认存档保留在原位置。存储修订号变化时重新读取,能确认只是业务标签或普通元数据变动时,基于最新业务字段重新提交。位置、请求内容或租约冲突时停止推进。写入结果不明时先核查写入 ID,随后才能开始下一项工具。已启动的工具结果优先记入原批次的存档,应用重新进入原位置时再写入会话历史。
284
+
285
+ ### 位置和版本校验
286
+
287
+ 恢复前检查存档版本、会话 ID、包含该 Run 的恢复链、Turn 和 Step 引用、目标位置,以及工具出现序号、调用 ID 和结果归属。存档内部损坏报告 `invalid_recovery`。当前会话的位置发生变化报告 `session_conflict`。树路径从目标节点的父链恢复。列表路径按行和候选恢复,并核对最后一条消息在候选中的索引。较早行分出的候选记录被保留的后缀行及其候选,校验时通过这些结构 ID 识别原后缀,请求仅构造到接续位置。新增行或后缀候选切换按位置冲突处理。
288
+
289
+ `requestFingerprint` 使用固定顺序的 JSON 数据生成版本化摘要。输入包括系统消息的 ID 与 `requestRevision`,以及截至恢复位置的每个结构位置、消息 ID 与 `requestRevision`。恢复时同时核对活跃路径和末尾,避免在同一前缀后已经追加新输入时接错任务。普通 tags 和业务 metadata 可以变化,请求相关元数据与内容编辑通过 `requestRevision` 检出。列表现有 `context` 值用于历史有效性校验,恢复摘要单独生成。 [请求版本和列表指纹](./API.md#listsession-与-agentsession)
290
+
291
+ ## 分支切换
292
+
293
+ | 场景 | 接续行为 |
294
+ | --- | --- |
295
+ | A 分支中断后选中 B | 返回 `session_conflict` 并附上 A 的位置和选中路径。应用可以引导用户重新选中 A |
296
+ | 切回 A | 路径、末尾和请求版本核对通过后,可从 A 的恢复点继续 |
297
+ | A 的消息被编辑、删除或移动,或尾部已有新输入 | 返回 `session_conflict`。业务可以用当前历史开始新的执行 |
298
+ | 工具启动后切换分支 | 停止启动后续工具。已取得的结果写回原批次的存档,等原位置核验后进入会话历史 |
299
+ | 业务明确选择当前路径的较早回复或 Step | 指定 `fork: true`。树会话从该节点创建新路径。列表和 Agent 会话在该行复制截至指定位置的消息引用,建立并选中新候选,后续行保留为失效历史 |
300
+
301
+ `fork` 创建独立的恢复链。`afterStepId` 选择较早位置时,检查同一路径后续是否有已启动、已有结果或执行无法确认的工具。遇到这类记录返回 `later_tool_activity`,附上执行事实,供业务选择最新恢复点或依据实际结果准备新任务。切点必须包含一段完整的工具协议历史。
302
+
303
+ ## 工具只完成一部分
304
+
305
+ 工具执行 ID 在模型提交调用清单时分配,以 `stepId` 和调用序号区分每次出现。厂商的 `toolCallId` 用于模型上下文里的调用与结果配对。同一厂商 ID 跨步骤重复时,工具执行 ID 仍各自独立。
306
+
307
+ | 存档状态 | 接续行为 |
308
+ | --- | --- |
309
+ | `settled` | 复用已确认的结果,包括明确失败或拒绝。以原工具执行 ID 归档 |
310
+ | `pending` | 在当前工具注册表和策略下校验参数与授权。需要审批时重新发起审批 |
311
+ | `started` 且原租约仍有效 | 本次接手返回 `session_busy`,由现有执行者继续推进 |
312
+ | `started` 且执行权已失效,或 `unknown` | 将结果视为待核对。默认返回 `tool_outcome_unknown`,等业务补齐这批未知项后再启动该批剩余的 `pending` 工具 |
313
+
314
+ `toolResolutions` 用于 `from.kind: "run"` 的遗留批次。`record` 把业务按执行 ID 查到的确定结果转换成对应的 Tool 消息。`retry` 表示业务已确认该工具可用原 `toolExecutionId` 幂等重试。重试仍经过当前的参数校验、授权和审批。每个决定先校验是否对应本批未知项。处理决定覆盖全部未知项后,随接手记录一起持久化。获准重试的调用进入 `pending` 并使用原 ID,在启动前再次保存为 `started`。
315
+
316
+ 进程可能在工具生效后、结果落盘前退出。已启动的调用在取消、超时或传输失败后缺少明确结果时同样按未知处理。审批拒绝保存为明确结果,确定失败按 `toolErrorPolicy` 处理。`pause` 或 `throw` 中断批次时保存其余待执行项供下次接续。工具历史送入模型时沿用保存的结果,新模型步骤发出的调用按当前策略处理。
317
+
318
+ ## 应用重启
319
+
320
+ 1. 应用用 `store.read(sessionId)` 取回原子存档,从 `data.session` 恢复 Session 后创建新的 Agent,并装配 Provider、工具、审批和业务回调。
321
+ 2. 使用 `runFrom({ from: { kind: "run", runId }, store })` 接手。同一次任务的旧 `runId` 定位到该恢复链最近的进度。按需要重新传入 `context` 和 `commit`,本次传入的配置决定新的请求与写回。函数和 Provider 由应用在新进程装配。
322
+ 3. 从 `model` 恢复点开始时,用已确认的历史发起新模型请求。从 `tools` 恢复时,先结算遗留批次。若上一进程在新请求中退出且片段已经提交,该片段可以作为任务上下文,也可明确从回复位置接写。
323
+ 4. 若两个实例同时尝试接手,存储只授权其中一个。原租约失效后,旧持有者的后续提交会被拒绝。若旧 Run 仍标记为 `running`,新 Run 开始时将它结算为中断。新 Run 关联 `resumedFrom`,恢复链的最新位置在同一次写入内推进。
324
+
325
+ 旧 Session v3 可以直接导入,也可以用 `runFrom({ from: { kind: "reply", position } })` 补完已保存的回复。从 Run 恢复需有对应的恢复记录。应用只持有旧会话 JSON 时,`kind: "run"` 返回 `recovery_missing`,仍可选择已保存的回复或写入新输入。 [旧会话导入与恢复语义](./API.md#agent自主运行与提交)
326
+
327
+ ## 实现顺序
328
+
329
+ 1. **位置解析与写回。** 在三种内置会话上实现位置解析、活跃前缀校验、尾部写回和显式分支。先用固定消息验证选择、共享消息以及历史后缀的行为。
330
+ 2. **恢复数据与存储。** 实现版本化存档、请求摘要、内存适配器、原子写入和租约契约。用持久化测试适配器验证 CAS、租约过期和重启往返。
331
+ 3. **新入口和模型阶段。** 接入 `runFrom()`、默认选项、思考回传、构造回调与提交回调。先覆盖无工具、片段保留和统一持久化,再验证事件、运行预算与追踪记录。
332
+ 4. **工具阶段与未知结果。** 让新路径使用已分配的执行 ID,在实际调用前确认保存,逐项记录结果。补齐审批重入、未决批次、结果补录和幂等重试。
333
+ 5. **恢复流程验收。** 验证跨进程、分支切换和故障注入。补公开类型和 API 示例,并运行现有全量测试、浏览器构建和包导出检查。
334
+
335
+ ## 测试用例
336
+
337
+ | 编号 | 场景 | 验收结果 |
338
+ | --- | --- | --- |
339
+ | RF-01 | `input`、`reply`、`run` 的默认值 | 入参、提示词和写回与默认表一致。从 Run 恢复沿用原 Turn 和已存的用户输入 |
340
+ | RF-02 | 无效输入、过期位置、共享 Message 上的 `append`、不支持的会话 | 报告对应错误。Provider 和工具调用次数均为 0,前置校验失败前的会话内容和执行记录保持原值 |
341
+ | RF-03 | 整轮 `thinking` 以 User 回传,包含多步和独立工具调用消息 | 只收集当前路径中截至接续点的思考块,顺序及角色正确。会话导出不含临时消息 |
342
+ | RF-04 | `build` 编辑快照,按生成步骤决定 `append` 或 `create` | 请求改写与会话编辑隔离,写回落在实际位置。普通提交和保留片段都触发提交钩子 |
343
+ | RF-05 | A 转 B、回到 A、同路径追加输入、编辑正文和普通业务字段 | 错分支或内容冲突在请求前被发现。选回原位置和仅业务字段变更时可恢复 |
344
+ | RF-06 | 同一消息 ID 出现在不同树节点,或两个列表候选共享回复 | 位置按实际节点或候选区分。显式 `create` 的工具轨迹和最终回复出现在所选路径 |
345
+ | RF-07 | 从较早 Step 显式分支,及该 Step 之后有工具执行 | 可用的切点建立新分支,旧后缀保留。发现后续工具活动时报告执行事实,模型及工具调用次数均为 0 |
346
+ | RF-08 | 工具 A 已结算、B 待启动、C 结果未知 | 未决时返回 C 的执行 ID。补录 C 后只执行 B,并按原顺序把 A、B、C 的结果发给模型 |
347
+ | RF-09 | 对未知工具显式 `retry`,注册表变化或审批再次被拒绝 | 复用原执行 ID,当前批准规则生效。跨步骤重复的平台调用 ID 不合并执行记录 |
348
+ | RF-10 | 工具启动前落盘失败,或保存 `started` 后进程退出 | 写入失败时工具调用次数为 0。进程退出后按未知状态恢复,应用能够补录确认结果 |
349
+ | RF-11 | 分支切换或超时发生在工具执行中 | 停止推进原会话。取得的明确结果留在原批次存档,缺结果的调用进入待核对状态 |
350
+ | RF-12 | 进程在首次模型请求、模型片段提交后、部分工具完成后和最终提交后退出 | 新实例读取各自阶段并接续。已关闭的恢复点抛出 `recovery_closed`,模型请求计数保持为 0 |
351
+ | RF-13 | 两个进程争抢同一存档,旧租约过期或写入确认丢失 | 只有一个有效执行者推进。拒绝旧令牌的写入,按写入 ID 核对已确认的提交 |
352
+ | RF-14 | 流式截断、取消、超时、已报告的部分用量 | 可用片段与用量一起保存。残缺调用的执行次数为 0,恢复后发起的新模型步骤可正确结算 |
353
+ | RF-15 | Session v3 与恢复存档分别往返,读取 3.0.3 旧快照 | 原会话格式正常导入。旧回复仍可补写,缺少任务恢复点时返回 `recovery_missing` |
354
+ | RF-16 | 既有 Agent、独立 ToolExecutor、legacy、浏览器和包导出 | 旧入口现有测试继续通过,新入口导出在 Node 和浏览器均可使用 |
355
+
356
+ 恢复测试使用假 Provider、可计数工具和能在指定写入位置中断的存储适配器。跨进程用例在指定存档阶段向子进程发送 `SIGKILL`,由另一个进程从同一存储创建 Agent,再断言请求上下文、实际副作用次数、恢复点版本、结构位置和执行归属。租约边界由测试存储的时钟控制。 [跨进程验收测试](../test/v3/run-from-process.test.ts) [既有 Agent 测试](../test/v3/agent.test.ts) [续写恢复测试](../test/v3/continuation-recovery.test.ts)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@notic/agent-engine",
3
- "version": "3.0.3",
3
+ "version": "3.1.0",
4
4
  "description": "A lightweight, elegant, and feature-complete TypeScript AI Agent framework",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",