@ai-agent-forge/agent-forge 0.86.6 → 0.87.0

package/dist/core/agent-session-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-context.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAExF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG;IAAE,OAAO,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAanH;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAInG;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAIhF;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,OAAO,GAClB,OAAO,CAET;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,OAAO,GAClB,IAAI,CASN;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EACzC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7D,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,OAAO,CAAC,CAAC,CAAC,CA6BZ;AAED,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,GAAG,QAAQ,GAC3B,YAAY,EAAE,CA2BhB;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,GAAE,uBAAuB,CAAC,QAAQ,CAAqB,EAC7D,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAmCzB;AAED,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,WAAW,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,EACtD,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAoBzB;AAED,kFAAkF;AAClF,wBAAsB,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOtF;AAED,yDAAyD;AACzD,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAG/G;AAED,wEAAwE;AACxE,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAIrH","sourcesContent":["/**\n * Context transition pipeline for AgentSession: the strategy gate, the\n * transition fence, and the snapshot/restore/replace operations.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name delegates so call sites, dynamic dispatch, and test spies\n * keep working unchanged. Method-to-method calls that have a facade member go\n * through the session parameter (not direct function calls) to preserve that\n * dispatch — including `session._dispatchContextReplacedLifecycle`, whose\n * delegate stays on the class with the other lifecycle dispatchers and\n * forwards to `agent-session-lifecycle.ts`.\n */\n\nimport type { AgentMessage } from \"@agent-forge/agent-core\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport type { CapabilityRuntime, ContextOperationOptions } from \"./extensions/index.ts\";\n\nexport function requireContextStrategy(session: AgentSessionInternals): { runtime: CapabilityRuntime; name: string } {\n\tconst name = session._contextStrategyName;\n\tif (!name) {\n\t\tthrow new Error(\"Context strategy is not configured\");\n\t}\n\tconst runtime = session._capabilityRuntime;\n\tif (!runtime) {\n\t\tthrow new Error(\"Capability runtime is not available\");\n\t}\n\tif (!runtime.hasContextStrategy(name)) {\n\t\tthrow new Error(`Configured context strategy is not registered: ${name}`);\n\t}\n\treturn { runtime, name };\n}\n\nexport function requireIdleContextOperation(session: AgentSessionInternals, operation: string): void {\n\tif (!session.isIdle) {\n\t\tthrow new Error(`Cannot ${operation} while the session is running`);\n\t}\n}\n\nexport function beginContextTransitionFence(session: AgentSessionInternals): void {\n\tsession._contextEpoch += 1;\n\tsession._contextTransitionAbortController.abort(\"context runtime replaced\");\n\tsession._contextTransitionAbortController = new AbortController();\n}\n\nexport function isContextTransitionCurrent(\n\tsession: AgentSessionInternals,\n\tepoch: number,\n\tallowReload: boolean,\n): boolean {\n\treturn !session.isDisposed && epoch === session._contextEpoch && (allowReload || !session._reloadInProgress);\n}\n\nexport function assertContextTransitionCurrent(\n\tsession: AgentSessionInternals,\n\tepoch: number,\n\tallowReload: boolean,\n): void {\n\tif (session._isContextTransitionCurrent(epoch, allowReload)) return;\n\tthrow new Error(\n\t\tsession.isDisposed\n\t\t\t? \"Session is disposed; context transition was cancelled\"\n\t\t\t: session._reloadInProgress\n\t\t\t\t? \"Session reload in progress; context transition was cancelled\"\n\t\t\t\t: \"Context transition was superseded\",\n\t);\n}\n\nexport function enqueueContextTransition<T>(\n\tsession: AgentSessionInternals,\n\toperation: (epoch: number, signal: AbortSignal) => Promise<T>,\n\toptions?: { signal?: AbortSignal; allowReload?: boolean },\n): Promise<T> {\n\tconst allowReload = options?.allowReload ?? false;\n\tif (session.isDisposed) {\n\t\treturn Promise.reject(new Error(\"Session is disposed; context transition is unavailable\"));\n\t}\n\tif (session._reloadInProgress && !allowReload) {\n\t\treturn Promise.reject(new Error(\"Session reload in progress; context transition is unavailable\"));\n\t}\n\tconst epoch = session._contextEpoch;\n\tconst fenceSignal = session._contextTransitionAbortController.signal;\n\tconst signal = options?.signal ? AbortSignal.any([fenceSignal, options.signal]) : fenceSignal;\n\tconst previous = session._activeContextTransition;\n\t// Keep the failure visible to its original caller, but do not poison the\n\t// serialized tail: a later independent context operation may still run.\n\tconst tail = previous?.catch(() => undefined);\n\tconst queued = (tail ?? Promise.resolve()).then(() => {\n\t\tsession._assertContextTransitionCurrent(epoch, allowReload);\n\t\treturn operation(epoch, signal);\n\t});\n\tsession._activeContextTransition = queued;\n\tvoid queued.then(\n\t\t() => {\n\t\t\tif (session._activeContextTransition === queued) session._activeContextTransition = undefined;\n\t\t},\n\t\t() => {\n\t\t\tif (session._activeContextTransition === queued) session._activeContextTransition = undefined;\n\t\t},\n\t);\n\treturn queued;\n}\n\nexport function copyContextMessages(\n\tvalue: unknown,\n\tstrategyName: string,\n\tdirection: \"input\" | \"result\",\n): AgentMessage[] {\n\tif (\n\t\t!Array.isArray(value) ||\n\t\tvalue.some(\n\t\t\t(message) =>\n\t\t\t\ttypeof message !== \"object\" ||\n\t\t\t\tmessage === null ||\n\t\t\t\t!(\"role\" in message) ||\n\t\t\t\ttypeof (message as { role?: unknown }).role !== \"string\",\n\t\t)\n\t) {\n\t\tthrow new Error(\n\t\t\tdirection === \"result\"\n\t\t\t\t? `Context strategy must return an AgentMessage array: ${strategyName}`\n\t\t\t\t: `Context transition requires an AgentMessage array: ${strategyName}`,\n\t\t);\n\t}\n\ttry {\n\t\treturn structuredClone(value) as AgentMessage[];\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\tdirection === \"result\"\n\t\t\t\t? `Context strategy must return structured-cloneable AgentMessage values: ${strategyName}`\n\t\t\t\t: `Context transition requires structured-cloneable AgentMessage values: ${strategyName}`,\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\n/** Apply a persisted-context transition, including strategy-owned projections. */\nexport function applyContextTransition(\n\tsession: AgentSessionInternals,\n\tmessages: AgentMessage[],\n\treason: ContextOperationOptions[\"reason\"] = \"session_replace\",\n\tsignal?: AbortSignal,\n\toptions?: { allowReload?: boolean },\n): Promise<AgentMessage[]> {\n\treturn session._enqueueContextTransition(\n\t\tasync (epoch, transitionSignal) => {\n\t\t\tconst name = session._contextStrategyName;\n\t\t\tconst runtime = session._capabilityRuntime;\n\t\t\tif (name) {\n\t\t\t\tif (!runtime) {\n\t\t\t\t\tthrow new Error(\"Capability runtime is not available\");\n\t\t\t\t}\n\t\t\t\tif (!runtime.hasContextStrategy(name)) {\n\t\t\t\t\tthrow new Error(`Configured context strategy is not registered: ${name}`);\n\t\t\t\t}\n\t\t\t\tconst replaced = await runtime.replaceContext(name, session._copyContextMessages(messages, name, \"input\"), {\n\t\t\t\t\tsignal: transitionSignal,\n\t\t\t\t\treason,\n\t\t\t\t\tsessionId: session.sessionId,\n\t\t\t\t});\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tconst committed = session._copyContextMessages(replaced, name, \"result\");\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tsession.agent.state.messages = committed;\n\t\t\t\tsession._contextRevision += 1;\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tawait session._dispatchContextReplacedLifecycle(reason, name);\n\t\t\t\treturn committed;\n\t\t\t}\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tsession.agent.state.messages = messages;\n\t\t\tsession._contextRevision += 1;\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tawait session._dispatchContextReplacedLifecycle(reason);\n\t\t\treturn messages;\n\t\t},\n\t\t{ signal, allowReload: options?.allowReload },\n\t);\n}\n\nexport function restoreContextTransition(\n\tsession: AgentSessionInternals,\n\tsnapshot: unknown,\n\treason: NonNullable<ContextOperationOptions[\"reason\"]>,\n\toptions?: { allowReload?: boolean },\n): Promise<AgentMessage[]> {\n\treturn session._enqueueContextTransition(\n\t\tasync (epoch, signal) => {\n\t\t\tconst { runtime, name } = session._requireContextStrategy();\n\t\t\tconst restored = await runtime.restoreContext(name, snapshot, {\n\t\t\t\tsignal,\n\t\t\t\treason,\n\t\t\t\tsessionId: session.sessionId,\n\t\t\t});\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tconst committed = session._copyContextMessages(restored, name, \"result\");\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tsession.agent.state.messages = committed;\n\t\t\tsession._contextRevision += 1;\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tawait session._dispatchContextReplacedLifecycle(reason, name);\n\t\t\treturn committed;\n\t\t},\n\t\t{ allowReload: options?.allowReload },\n\t);\n}\n\n/** Snapshot the current session messages with the configured context strategy. */\nexport async function snapshotContext(session: AgentSessionInternals): Promise<unknown> {\n\tsession._requireIdleContextOperation(\"snapshot context\");\n\tconst { runtime, name } = session._requireContextStrategy();\n\treturn runtime.snapshotContext(name, session._copyContextMessages(session.agent.state.messages, name, \"input\"), {\n\t\treason: \"reload\",\n\t\tsessionId: session.sessionId,\n\t});\n}\n\n/** Restore session messages from a strategy snapshot. */\nexport async function restoreContext(session: AgentSessionInternals, snapshot: unknown): Promise<AgentMessage[]> {\n\tsession._requireIdleContextOperation(\"restore context\");\n\treturn session._restoreContextTransition(snapshot, \"session_replace\");\n}\n\n/** Replace session messages through the configured context strategy. */\nexport async function replaceContext(session: AgentSessionInternals, context: AgentMessage[]): Promise<AgentMessage[]> {\n\tsession._requireIdleContextOperation(\"replace context\");\n\tconst { name } = session._requireContextStrategy();\n\treturn session._applyContextTransition(session._copyContextMessages(context, name, \"input\"), \"session_replace\");\n}\n"]}
+{"version":3,"file":"agent-session-context.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGxF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG;IAAE,OAAO,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAanH;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAInG;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAIhF;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,OAAO,GAClB,OAAO,CAET;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,OAAO,GAClB,IAAI,CASN;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EACzC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7D,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD,OAAO,CAAC,CAAC,CAAC,CA6BZ;AAED,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,GAAG,QAAQ,GAC3B,YAAY,EAAE,CA+BhB;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,GAAE,uBAAuB,CAAC,QAAQ,CAAqB,EAC7D,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAmCzB;AAED,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,WAAW,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,EACtD,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,YAAY,EAAE,CAAC,CAoBzB;AAED,kFAAkF;AAClF,wBAAsB,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAOtF;AAED,yDAAyD;AACzD,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAG/G;AAED,wEAAwE;AACxE,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAIrH","sourcesContent":["/**\n * Context transition pipeline for AgentSession: the strategy gate, the\n * transition fence, and the snapshot/restore/replace operations.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name delegates so call sites, dynamic dispatch, and test spies\n * keep working unchanged. Method-to-method calls that have a facade member go\n * through the session parameter (not direct function calls) to preserve that\n * dispatch — including `session._dispatchContextReplacedLifecycle`, whose\n * delegate stays on the class with the other lifecycle dispatchers and\n * forwards to `agent-session-lifecycle.ts`.\n */\n\nimport type { AgentMessage } from \"@agent-forge/agent-core\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport type { CapabilityRuntime, ContextOperationOptions } from \"./extensions/index.ts\";\nimport { t } from \"./i18n/index.ts\";\n\nexport function requireContextStrategy(session: AgentSessionInternals): { runtime: CapabilityRuntime; name: string } {\n\tconst name = session._contextStrategyName;\n\tif (!name) {\n\t\tthrow new Error(t(\"Context strategy is not configured\"));\n\t}\n\tconst runtime = session._capabilityRuntime;\n\tif (!runtime) {\n\t\tthrow new Error(t(\"Capability runtime is not available\"));\n\t}\n\tif (!runtime.hasContextStrategy(name)) {\n\t\tthrow new Error(t(\"Configured context strategy is not registered: {name}\", { name }));\n\t}\n\treturn { runtime, name };\n}\n\nexport function requireIdleContextOperation(session: AgentSessionInternals, operation: string): void {\n\tif (!session.isIdle) {\n\t\tthrow new Error(t(\"Cannot {operation} while the session is running\", { operation }));\n\t}\n}\n\nexport function beginContextTransitionFence(session: AgentSessionInternals): void {\n\tsession._contextEpoch += 1;\n\tsession._contextTransitionAbortController.abort(\"context runtime replaced\");\n\tsession._contextTransitionAbortController = new AbortController();\n}\n\nexport function isContextTransitionCurrent(\n\tsession: AgentSessionInternals,\n\tepoch: number,\n\tallowReload: boolean,\n): boolean {\n\treturn !session.isDisposed && epoch === session._contextEpoch && (allowReload || !session._reloadInProgress);\n}\n\nexport function assertContextTransitionCurrent(\n\tsession: AgentSessionInternals,\n\tepoch: number,\n\tallowReload: boolean,\n): void {\n\tif (session._isContextTransitionCurrent(epoch, allowReload)) return;\n\tthrow new Error(\n\t\tsession.isDisposed\n\t\t\t? t(\"Session is disposed; context transition was cancelled\")\n\t\t\t: session._reloadInProgress\n\t\t\t\t? t(\"Session reload in progress; context transition was cancelled\")\n\t\t\t\t: t(\"Context transition was superseded\"),\n\t);\n}\n\nexport function enqueueContextTransition<T>(\n\tsession: AgentSessionInternals,\n\toperation: (epoch: number, signal: AbortSignal) => Promise<T>,\n\toptions?: { signal?: AbortSignal; allowReload?: boolean },\n): Promise<T> {\n\tconst allowReload = options?.allowReload ?? false;\n\tif (session.isDisposed) {\n\t\treturn Promise.reject(new Error(\"Session is disposed; context transition is unavailable\"));\n\t}\n\tif (session._reloadInProgress && !allowReload) {\n\t\treturn Promise.reject(new Error(\"Session reload in progress; context transition is unavailable\"));\n\t}\n\tconst epoch = session._contextEpoch;\n\tconst fenceSignal = session._contextTransitionAbortController.signal;\n\tconst signal = options?.signal ? AbortSignal.any([fenceSignal, options.signal]) : fenceSignal;\n\tconst previous = session._activeContextTransition;\n\t// Keep the failure visible to its original caller, but do not poison the\n\t// serialized tail: a later independent context operation may still run.\n\tconst tail = previous?.catch(() => undefined);\n\tconst queued = (tail ?? Promise.resolve()).then(() => {\n\t\tsession._assertContextTransitionCurrent(epoch, allowReload);\n\t\treturn operation(epoch, signal);\n\t});\n\tsession._activeContextTransition = queued;\n\tvoid queued.then(\n\t\t() => {\n\t\t\tif (session._activeContextTransition === queued) session._activeContextTransition = undefined;\n\t\t},\n\t\t() => {\n\t\t\tif (session._activeContextTransition === queued) session._activeContextTransition = undefined;\n\t\t},\n\t);\n\treturn queued;\n}\n\nexport function copyContextMessages(\n\tvalue: unknown,\n\tstrategyName: string,\n\tdirection: \"input\" | \"result\",\n): AgentMessage[] {\n\tif (\n\t\t!Array.isArray(value) ||\n\t\tvalue.some(\n\t\t\t(message) =>\n\t\t\t\ttypeof message !== \"object\" ||\n\t\t\t\tmessage === null ||\n\t\t\t\t!(\"role\" in message) ||\n\t\t\t\ttypeof (message as { role?: unknown }).role !== \"string\",\n\t\t)\n\t) {\n\t\tthrow new Error(\n\t\t\tdirection === \"result\"\n\t\t\t\t? t(\"Context strategy must return an AgentMessage array: {strategyName}\", { strategyName })\n\t\t\t\t: t(\"Context transition requires an AgentMessage array: {strategyName}\", { strategyName }),\n\t\t);\n\t}\n\ttry {\n\t\treturn structuredClone(value) as AgentMessage[];\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\tdirection === \"result\"\n\t\t\t\t? t(\"Context strategy must return structured-cloneable AgentMessage values: {strategyName}\", {\n\t\t\t\t\t\tstrategyName,\n\t\t\t\t\t})\n\t\t\t\t: t(\"Context transition requires structured-cloneable AgentMessage values: {strategyName}\", {\n\t\t\t\t\t\tstrategyName,\n\t\t\t\t\t}),\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\n/** Apply a persisted-context transition, including strategy-owned projections. */\nexport function applyContextTransition(\n\tsession: AgentSessionInternals,\n\tmessages: AgentMessage[],\n\treason: ContextOperationOptions[\"reason\"] = \"session_replace\",\n\tsignal?: AbortSignal,\n\toptions?: { allowReload?: boolean },\n): Promise<AgentMessage[]> {\n\treturn session._enqueueContextTransition(\n\t\tasync (epoch, transitionSignal) => {\n\t\t\tconst name = session._contextStrategyName;\n\t\t\tconst runtime = session._capabilityRuntime;\n\t\t\tif (name) {\n\t\t\t\tif (!runtime) {\n\t\t\t\t\tthrow new Error(t(\"Capability runtime is not available\"));\n\t\t\t\t}\n\t\t\t\tif (!runtime.hasContextStrategy(name)) {\n\t\t\t\t\tthrow new Error(t(\"Configured context strategy is not registered: {name}\", { name }));\n\t\t\t\t}\n\t\t\t\tconst replaced = await runtime.replaceContext(name, session._copyContextMessages(messages, name, \"input\"), {\n\t\t\t\t\tsignal: transitionSignal,\n\t\t\t\t\treason,\n\t\t\t\t\tsessionId: session.sessionId,\n\t\t\t\t});\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tconst committed = session._copyContextMessages(replaced, name, \"result\");\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tsession.agent.state.messages = committed;\n\t\t\t\tsession._contextRevision += 1;\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tawait session._dispatchContextReplacedLifecycle(reason, name);\n\t\t\t\treturn committed;\n\t\t\t}\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tsession.agent.state.messages = messages;\n\t\t\tsession._contextRevision += 1;\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tawait session._dispatchContextReplacedLifecycle(reason);\n\t\t\treturn messages;\n\t\t},\n\t\t{ signal, allowReload: options?.allowReload },\n\t);\n}\n\nexport function restoreContextTransition(\n\tsession: AgentSessionInternals,\n\tsnapshot: unknown,\n\treason: NonNullable<ContextOperationOptions[\"reason\"]>,\n\toptions?: { allowReload?: boolean },\n): Promise<AgentMessage[]> {\n\treturn session._enqueueContextTransition(\n\t\tasync (epoch, signal) => {\n\t\t\tconst { runtime, name } = session._requireContextStrategy();\n\t\t\tconst restored = await runtime.restoreContext(name, snapshot, {\n\t\t\t\tsignal,\n\t\t\t\treason,\n\t\t\t\tsessionId: session.sessionId,\n\t\t\t});\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tconst committed = session._copyContextMessages(restored, name, \"result\");\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tsession.agent.state.messages = committed;\n\t\t\tsession._contextRevision += 1;\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tawait session._dispatchContextReplacedLifecycle(reason, name);\n\t\t\treturn committed;\n\t\t},\n\t\t{ allowReload: options?.allowReload },\n\t);\n}\n\n/** Snapshot the current session messages with the configured context strategy. */\nexport async function snapshotContext(session: AgentSessionInternals): Promise<unknown> {\n\tsession._requireIdleContextOperation(\"snapshot context\");\n\tconst { runtime, name } = session._requireContextStrategy();\n\treturn runtime.snapshotContext(name, session._copyContextMessages(session.agent.state.messages, name, \"input\"), {\n\t\treason: \"reload\",\n\t\tsessionId: session.sessionId,\n\t});\n}\n\n/** Restore session messages from a strategy snapshot. */\nexport async function restoreContext(session: AgentSessionInternals, snapshot: unknown): Promise<AgentMessage[]> {\n\tsession._requireIdleContextOperation(\"restore context\");\n\treturn session._restoreContextTransition(snapshot, \"session_replace\");\n}\n\n/** Replace session messages through the configured context strategy. */\nexport async function replaceContext(session: AgentSessionInternals, context: AgentMessage[]): Promise<AgentMessage[]> {\n\tsession._requireIdleContextOperation(\"replace context\");\n\tconst { name } = session._requireContextStrategy();\n\treturn session._applyContextTransition(session._copyContextMessages(context, name, \"input\"), \"session_replace\");\n}\n"]}

package/dist/core/agent-session-context.js

@@ -11,23 +11,24 @@
  * delegate stays on the class with the other lifecycle dispatchers and
  * forwards to `agent-session-lifecycle.ts`.
  */
+import { t } from "./i18n/index.js";
 export function requireContextStrategy(session) {
     const name = session._contextStrategyName;
     if (!name) {
-        throw new Error("Context strategy is not configured");
+        throw new Error(t("Context strategy is not configured"));
     }
     const runtime = session._capabilityRuntime;
     if (!runtime) {
-        throw new Error("Capability runtime is not available");
+        throw new Error(t("Capability runtime is not available"));
     }
     if (!runtime.hasContextStrategy(name)) {
-        throw new Error(`Configured context strategy is not registered: ${name}`);
+        throw new Error(t("Configured context strategy is not registered: {name}", { name }));
     }
     return { runtime, name };
 }
 export function requireIdleContextOperation(session, operation) {
     if (!session.isIdle) {
-        throw new Error(`Cannot ${operation} while the session is running`);
+        throw new Error(t("Cannot {operation} while the session is running", { operation }));
     }
 }
 export function beginContextTransitionFence(session) {
@@ -42,10 +43,10 @@ export function assertContextTransitionCurrent(session, epoch, allowReload) {
     if (session._isContextTransitionCurrent(epoch, allowReload))
         return;
     throw new Error(session.isDisposed
-        ? "Session is disposed; context transition was cancelled"
+        ? t("Session is disposed; context transition was cancelled")
         : session._reloadInProgress
-            ? "Session reload in progress; context transition was cancelled"
-            : "Context transition was superseded");
+            ? t("Session reload in progress; context transition was cancelled")
+            : t("Context transition was superseded"));
 }
 export function enqueueContextTransition(session, operation, options) {
     const allowReload = options?.allowReload ?? false;
@@ -83,16 +84,20 @@ export function copyContextMessages(value, strategyName, direction) {
             !("role" in message) ||
             typeof message.role !== "string")) {
         throw new Error(direction === "result"
-            ? `Context strategy must return an AgentMessage array: ${strategyName}`
-            : `Context transition requires an AgentMessage array: ${strategyName}`);
+            ? t("Context strategy must return an AgentMessage array: {strategyName}", { strategyName })
+            : t("Context transition requires an AgentMessage array: {strategyName}", { strategyName }));
     }
     try {
         return structuredClone(value);
     }
     catch (error) {
         throw new Error(direction === "result"
-            ? `Context strategy must return structured-cloneable AgentMessage values: ${strategyName}`
-            : `Context transition requires structured-cloneable AgentMessage values: ${strategyName}`, { cause: error });
+            ? t("Context strategy must return structured-cloneable AgentMessage values: {strategyName}", {
+                strategyName,
+            })
+            : t("Context transition requires structured-cloneable AgentMessage values: {strategyName}", {
+                strategyName,
+            }), { cause: error });
     }
 }
 /** Apply a persisted-context transition, including strategy-owned projections. */
@@ -102,10 +107,10 @@ export function applyContextTransition(session, messages, reason = "session_repl
         const runtime = session._capabilityRuntime;
         if (name) {
             if (!runtime) {
-                throw new Error("Capability runtime is not available");
+                throw new Error(t("Capability runtime is not available"));
             }
             if (!runtime.hasContextStrategy(name)) {
-                throw new Error(`Configured context strategy is not registered: ${name}`);
+                throw new Error(t("Configured context strategy is not registered: {name}", { name }));
             }
             const replaced = await runtime.replaceContext(name, session._copyContextMessages(messages, name, "input"), {
                 signal: transitionSignal,

package/dist/core/agent-session-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-context.js","sourceRoot":"","sources":["../../src/core/agent-session-context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Context transition pipeline for AgentSession: the strategy gate, the\n * transition fence, and the snapshot/restore/replace operations.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name delegates so call sites, dynamic dispatch, and test spies\n * keep working unchanged. Method-to-method calls that have a facade member go\n * through the session parameter (not direct function calls) to preserve that\n * dispatch — including `session._dispatchContextReplacedLifecycle`, whose\n * delegate stays on the class with the other lifecycle dispatchers and\n * forwards to `agent-session-lifecycle.ts`.\n */\n\nimport type { AgentMessage } from \"@agent-forge/agent-core\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport type { CapabilityRuntime, ContextOperationOptions } from \"./extensions/index.ts\";\n\nexport function requireContextStrategy(session: AgentSessionInternals): { runtime: CapabilityRuntime; name: string } {\n\tconst name = session._contextStrategyName;\n\tif (!name) {\n\t\tthrow new Error(\"Context strategy is not configured\");\n\t}\n\tconst runtime = session._capabilityRuntime;\n\tif (!runtime) {\n\t\tthrow new Error(\"Capability runtime is not available\");\n\t}\n\tif (!runtime.hasContextStrategy(name)) {\n\t\tthrow new Error(`Configured context strategy is not registered: ${name}`);\n\t}\n\treturn { runtime, name };\n}\n\nexport function requireIdleContextOperation(session: AgentSessionInternals, operation: string): void {\n\tif (!session.isIdle) {\n\t\tthrow new Error(`Cannot ${operation} while the session is running`);\n\t}\n}\n\nexport function beginContextTransitionFence(session: AgentSessionInternals): void {\n\tsession._contextEpoch += 1;\n\tsession._contextTransitionAbortController.abort(\"context runtime replaced\");\n\tsession._contextTransitionAbortController = new AbortController();\n}\n\nexport function isContextTransitionCurrent(\n\tsession: AgentSessionInternals,\n\tepoch: number,\n\tallowReload: boolean,\n): boolean {\n\treturn !session.isDisposed && epoch === session._contextEpoch && (allowReload || !session._reloadInProgress);\n}\n\nexport function assertContextTransitionCurrent(\n\tsession: AgentSessionInternals,\n\tepoch: number,\n\tallowReload: boolean,\n): void {\n\tif (session._isContextTransitionCurrent(epoch, allowReload)) return;\n\tthrow new Error(\n\t\tsession.isDisposed\n\t\t\t? \"Session is disposed; context transition was cancelled\"\n\t\t\t: session._reloadInProgress\n\t\t\t\t? \"Session reload in progress; context transition was cancelled\"\n\t\t\t\t: \"Context transition was superseded\",\n\t);\n}\n\nexport function enqueueContextTransition<T>(\n\tsession: AgentSessionInternals,\n\toperation: (epoch: number, signal: AbortSignal) => Promise<T>,\n\toptions?: { signal?: AbortSignal; allowReload?: boolean },\n): Promise<T> {\n\tconst allowReload = options?.allowReload ?? false;\n\tif (session.isDisposed) {\n\t\treturn Promise.reject(new Error(\"Session is disposed; context transition is unavailable\"));\n\t}\n\tif (session._reloadInProgress && !allowReload) {\n\t\treturn Promise.reject(new Error(\"Session reload in progress; context transition is unavailable\"));\n\t}\n\tconst epoch = session._contextEpoch;\n\tconst fenceSignal = session._contextTransitionAbortController.signal;\n\tconst signal = options?.signal ? AbortSignal.any([fenceSignal, options.signal]) : fenceSignal;\n\tconst previous = session._activeContextTransition;\n\t// Keep the failure visible to its original caller, but do not poison the\n\t// serialized tail: a later independent context operation may still run.\n\tconst tail = previous?.catch(() => undefined);\n\tconst queued = (tail ?? Promise.resolve()).then(() => {\n\t\tsession._assertContextTransitionCurrent(epoch, allowReload);\n\t\treturn operation(epoch, signal);\n\t});\n\tsession._activeContextTransition = queued;\n\tvoid queued.then(\n\t\t() => {\n\t\t\tif (session._activeContextTransition === queued) session._activeContextTransition = undefined;\n\t\t},\n\t\t() => {\n\t\t\tif (session._activeContextTransition === queued) session._activeContextTransition = undefined;\n\t\t},\n\t);\n\treturn queued;\n}\n\nexport function copyContextMessages(\n\tvalue: unknown,\n\tstrategyName: string,\n\tdirection: \"input\" | \"result\",\n): AgentMessage[] {\n\tif (\n\t\t!Array.isArray(value) ||\n\t\tvalue.some(\n\t\t\t(message) =>\n\t\t\t\ttypeof message !== \"object\" ||\n\t\t\t\tmessage === null ||\n\t\t\t\t!(\"role\" in message) ||\n\t\t\t\ttypeof (message as { role?: unknown }).role !== \"string\",\n\t\t)\n\t) {\n\t\tthrow new Error(\n\t\t\tdirection === \"result\"\n\t\t\t\t? `Context strategy must return an AgentMessage array: ${strategyName}`\n\t\t\t\t: `Context transition requires an AgentMessage array: ${strategyName}`,\n\t\t);\n\t}\n\ttry {\n\t\treturn structuredClone(value) as AgentMessage[];\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\tdirection === \"result\"\n\t\t\t\t? `Context strategy must return structured-cloneable AgentMessage values: ${strategyName}`\n\t\t\t\t: `Context transition requires structured-cloneable AgentMessage values: ${strategyName}`,\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\n/** Apply a persisted-context transition, including strategy-owned projections. */\nexport function applyContextTransition(\n\tsession: AgentSessionInternals,\n\tmessages: AgentMessage[],\n\treason: ContextOperationOptions[\"reason\"] = \"session_replace\",\n\tsignal?: AbortSignal,\n\toptions?: { allowReload?: boolean },\n): Promise<AgentMessage[]> {\n\treturn session._enqueueContextTransition(\n\t\tasync (epoch, transitionSignal) => {\n\t\t\tconst name = session._contextStrategyName;\n\t\t\tconst runtime = session._capabilityRuntime;\n\t\t\tif (name) {\n\t\t\t\tif (!runtime) {\n\t\t\t\t\tthrow new Error(\"Capability runtime is not available\");\n\t\t\t\t}\n\t\t\t\tif (!runtime.hasContextStrategy(name)) {\n\t\t\t\t\tthrow new Error(`Configured context strategy is not registered: ${name}`);\n\t\t\t\t}\n\t\t\t\tconst replaced = await runtime.replaceContext(name, session._copyContextMessages(messages, name, \"input\"), {\n\t\t\t\t\tsignal: transitionSignal,\n\t\t\t\t\treason,\n\t\t\t\t\tsessionId: session.sessionId,\n\t\t\t\t});\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tconst committed = session._copyContextMessages(replaced, name, \"result\");\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tsession.agent.state.messages = committed;\n\t\t\t\tsession._contextRevision += 1;\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tawait session._dispatchContextReplacedLifecycle(reason, name);\n\t\t\t\treturn committed;\n\t\t\t}\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tsession.agent.state.messages = messages;\n\t\t\tsession._contextRevision += 1;\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tawait session._dispatchContextReplacedLifecycle(reason);\n\t\t\treturn messages;\n\t\t},\n\t\t{ signal, allowReload: options?.allowReload },\n\t);\n}\n\nexport function restoreContextTransition(\n\tsession: AgentSessionInternals,\n\tsnapshot: unknown,\n\treason: NonNullable<ContextOperationOptions[\"reason\"]>,\n\toptions?: { allowReload?: boolean },\n): Promise<AgentMessage[]> {\n\treturn session._enqueueContextTransition(\n\t\tasync (epoch, signal) => {\n\t\t\tconst { runtime, name } = session._requireContextStrategy();\n\t\t\tconst restored = await runtime.restoreContext(name, snapshot, {\n\t\t\t\tsignal,\n\t\t\t\treason,\n\t\t\t\tsessionId: session.sessionId,\n\t\t\t});\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tconst committed = session._copyContextMessages(restored, name, \"result\");\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tsession.agent.state.messages = committed;\n\t\t\tsession._contextRevision += 1;\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tawait session._dispatchContextReplacedLifecycle(reason, name);\n\t\t\treturn committed;\n\t\t},\n\t\t{ allowReload: options?.allowReload },\n\t);\n}\n\n/** Snapshot the current session messages with the configured context strategy. */\nexport async function snapshotContext(session: AgentSessionInternals): Promise<unknown> {\n\tsession._requireIdleContextOperation(\"snapshot context\");\n\tconst { runtime, name } = session._requireContextStrategy();\n\treturn runtime.snapshotContext(name, session._copyContextMessages(session.agent.state.messages, name, \"input\"), {\n\t\treason: \"reload\",\n\t\tsessionId: session.sessionId,\n\t});\n}\n\n/** Restore session messages from a strategy snapshot. */\nexport async function restoreContext(session: AgentSessionInternals, snapshot: unknown): Promise<AgentMessage[]> {\n\tsession._requireIdleContextOperation(\"restore context\");\n\treturn session._restoreContextTransition(snapshot, \"session_replace\");\n}\n\n/** Replace session messages through the configured context strategy. */\nexport async function replaceContext(session: AgentSessionInternals, context: AgentMessage[]): Promise<AgentMessage[]> {\n\tsession._requireIdleContextOperation(\"replace context\");\n\tconst { name } = session._requireContextStrategy();\n\treturn session._applyContextTransition(session._copyContextMessages(context, name, \"input\"), \"session_replace\");\n}\n"]}
+{"version":3,"file":"agent-session-context.js","sourceRoot":"","sources":["../../src/core/agent-session-context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Context transition pipeline for AgentSession: the strategy gate, the\n * transition fence, and the snapshot/restore/replace operations.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name delegates so call sites, dynamic dispatch, and test spies\n * keep working unchanged. Method-to-method calls that have a facade member go\n * through the session parameter (not direct function calls) to preserve that\n * dispatch — including `session._dispatchContextReplacedLifecycle`, whose\n * delegate stays on the class with the other lifecycle dispatchers and\n * forwards to `agent-session-lifecycle.ts`.\n */\n\nimport type { AgentMessage } from \"@agent-forge/agent-core\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport type { CapabilityRuntime, ContextOperationOptions } from \"./extensions/index.ts\";\nimport { t } from \"./i18n/index.ts\";\n\nexport function requireContextStrategy(session: AgentSessionInternals): { runtime: CapabilityRuntime; name: string } {\n\tconst name = session._contextStrategyName;\n\tif (!name) {\n\t\tthrow new Error(t(\"Context strategy is not configured\"));\n\t}\n\tconst runtime = session._capabilityRuntime;\n\tif (!runtime) {\n\t\tthrow new Error(t(\"Capability runtime is not available\"));\n\t}\n\tif (!runtime.hasContextStrategy(name)) {\n\t\tthrow new Error(t(\"Configured context strategy is not registered: {name}\", { name }));\n\t}\n\treturn { runtime, name };\n}\n\nexport function requireIdleContextOperation(session: AgentSessionInternals, operation: string): void {\n\tif (!session.isIdle) {\n\t\tthrow new Error(t(\"Cannot {operation} while the session is running\", { operation }));\n\t}\n}\n\nexport function beginContextTransitionFence(session: AgentSessionInternals): void {\n\tsession._contextEpoch += 1;\n\tsession._contextTransitionAbortController.abort(\"context runtime replaced\");\n\tsession._contextTransitionAbortController = new AbortController();\n}\n\nexport function isContextTransitionCurrent(\n\tsession: AgentSessionInternals,\n\tepoch: number,\n\tallowReload: boolean,\n): boolean {\n\treturn !session.isDisposed && epoch === session._contextEpoch && (allowReload || !session._reloadInProgress);\n}\n\nexport function assertContextTransitionCurrent(\n\tsession: AgentSessionInternals,\n\tepoch: number,\n\tallowReload: boolean,\n): void {\n\tif (session._isContextTransitionCurrent(epoch, allowReload)) return;\n\tthrow new Error(\n\t\tsession.isDisposed\n\t\t\t? t(\"Session is disposed; context transition was cancelled\")\n\t\t\t: session._reloadInProgress\n\t\t\t\t? t(\"Session reload in progress; context transition was cancelled\")\n\t\t\t\t: t(\"Context transition was superseded\"),\n\t);\n}\n\nexport function enqueueContextTransition<T>(\n\tsession: AgentSessionInternals,\n\toperation: (epoch: number, signal: AbortSignal) => Promise<T>,\n\toptions?: { signal?: AbortSignal; allowReload?: boolean },\n): Promise<T> {\n\tconst allowReload = options?.allowReload ?? false;\n\tif (session.isDisposed) {\n\t\treturn Promise.reject(new Error(\"Session is disposed; context transition is unavailable\"));\n\t}\n\tif (session._reloadInProgress && !allowReload) {\n\t\treturn Promise.reject(new Error(\"Session reload in progress; context transition is unavailable\"));\n\t}\n\tconst epoch = session._contextEpoch;\n\tconst fenceSignal = session._contextTransitionAbortController.signal;\n\tconst signal = options?.signal ? AbortSignal.any([fenceSignal, options.signal]) : fenceSignal;\n\tconst previous = session._activeContextTransition;\n\t// Keep the failure visible to its original caller, but do not poison the\n\t// serialized tail: a later independent context operation may still run.\n\tconst tail = previous?.catch(() => undefined);\n\tconst queued = (tail ?? Promise.resolve()).then(() => {\n\t\tsession._assertContextTransitionCurrent(epoch, allowReload);\n\t\treturn operation(epoch, signal);\n\t});\n\tsession._activeContextTransition = queued;\n\tvoid queued.then(\n\t\t() => {\n\t\t\tif (session._activeContextTransition === queued) session._activeContextTransition = undefined;\n\t\t},\n\t\t() => {\n\t\t\tif (session._activeContextTransition === queued) session._activeContextTransition = undefined;\n\t\t},\n\t);\n\treturn queued;\n}\n\nexport function copyContextMessages(\n\tvalue: unknown,\n\tstrategyName: string,\n\tdirection: \"input\" | \"result\",\n): AgentMessage[] {\n\tif (\n\t\t!Array.isArray(value) ||\n\t\tvalue.some(\n\t\t\t(message) =>\n\t\t\t\ttypeof message !== \"object\" ||\n\t\t\t\tmessage === null ||\n\t\t\t\t!(\"role\" in message) ||\n\t\t\t\ttypeof (message as { role?: unknown }).role !== \"string\",\n\t\t)\n\t) {\n\t\tthrow new Error(\n\t\t\tdirection === \"result\"\n\t\t\t\t? t(\"Context strategy must return an AgentMessage array: {strategyName}\", { strategyName })\n\t\t\t\t: t(\"Context transition requires an AgentMessage array: {strategyName}\", { strategyName }),\n\t\t);\n\t}\n\ttry {\n\t\treturn structuredClone(value) as AgentMessage[];\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\tdirection === \"result\"\n\t\t\t\t? t(\"Context strategy must return structured-cloneable AgentMessage values: {strategyName}\", {\n\t\t\t\t\t\tstrategyName,\n\t\t\t\t\t})\n\t\t\t\t: t(\"Context transition requires structured-cloneable AgentMessage values: {strategyName}\", {\n\t\t\t\t\t\tstrategyName,\n\t\t\t\t\t}),\n\t\t\t{ cause: error },\n\t\t);\n\t}\n}\n\n/** Apply a persisted-context transition, including strategy-owned projections. */\nexport function applyContextTransition(\n\tsession: AgentSessionInternals,\n\tmessages: AgentMessage[],\n\treason: ContextOperationOptions[\"reason\"] = \"session_replace\",\n\tsignal?: AbortSignal,\n\toptions?: { allowReload?: boolean },\n): Promise<AgentMessage[]> {\n\treturn session._enqueueContextTransition(\n\t\tasync (epoch, transitionSignal) => {\n\t\t\tconst name = session._contextStrategyName;\n\t\t\tconst runtime = session._capabilityRuntime;\n\t\t\tif (name) {\n\t\t\t\tif (!runtime) {\n\t\t\t\t\tthrow new Error(t(\"Capability runtime is not available\"));\n\t\t\t\t}\n\t\t\t\tif (!runtime.hasContextStrategy(name)) {\n\t\t\t\t\tthrow new Error(t(\"Configured context strategy is not registered: {name}\", { name }));\n\t\t\t\t}\n\t\t\t\tconst replaced = await runtime.replaceContext(name, session._copyContextMessages(messages, name, \"input\"), {\n\t\t\t\t\tsignal: transitionSignal,\n\t\t\t\t\treason,\n\t\t\t\t\tsessionId: session.sessionId,\n\t\t\t\t});\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tconst committed = session._copyContextMessages(replaced, name, \"result\");\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tsession.agent.state.messages = committed;\n\t\t\t\tsession._contextRevision += 1;\n\t\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\t\tawait session._dispatchContextReplacedLifecycle(reason, name);\n\t\t\t\treturn committed;\n\t\t\t}\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tsession.agent.state.messages = messages;\n\t\t\tsession._contextRevision += 1;\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tawait session._dispatchContextReplacedLifecycle(reason);\n\t\t\treturn messages;\n\t\t},\n\t\t{ signal, allowReload: options?.allowReload },\n\t);\n}\n\nexport function restoreContextTransition(\n\tsession: AgentSessionInternals,\n\tsnapshot: unknown,\n\treason: NonNullable<ContextOperationOptions[\"reason\"]>,\n\toptions?: { allowReload?: boolean },\n): Promise<AgentMessage[]> {\n\treturn session._enqueueContextTransition(\n\t\tasync (epoch, signal) => {\n\t\t\tconst { runtime, name } = session._requireContextStrategy();\n\t\t\tconst restored = await runtime.restoreContext(name, snapshot, {\n\t\t\t\tsignal,\n\t\t\t\treason,\n\t\t\t\tsessionId: session.sessionId,\n\t\t\t});\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tconst committed = session._copyContextMessages(restored, name, \"result\");\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tsession.agent.state.messages = committed;\n\t\t\tsession._contextRevision += 1;\n\t\t\tsession._assertContextTransitionCurrent(epoch, options?.allowReload ?? false);\n\t\t\tawait session._dispatchContextReplacedLifecycle(reason, name);\n\t\t\treturn committed;\n\t\t},\n\t\t{ allowReload: options?.allowReload },\n\t);\n}\n\n/** Snapshot the current session messages with the configured context strategy. */\nexport async function snapshotContext(session: AgentSessionInternals): Promise<unknown> {\n\tsession._requireIdleContextOperation(\"snapshot context\");\n\tconst { runtime, name } = session._requireContextStrategy();\n\treturn runtime.snapshotContext(name, session._copyContextMessages(session.agent.state.messages, name, \"input\"), {\n\t\treason: \"reload\",\n\t\tsessionId: session.sessionId,\n\t});\n}\n\n/** Restore session messages from a strategy snapshot. */\nexport async function restoreContext(session: AgentSessionInternals, snapshot: unknown): Promise<AgentMessage[]> {\n\tsession._requireIdleContextOperation(\"restore context\");\n\treturn session._restoreContextTransition(snapshot, \"session_replace\");\n}\n\n/** Replace session messages through the configured context strategy. */\nexport async function replaceContext(session: AgentSessionInternals, context: AgentMessage[]): Promise<AgentMessage[]> {\n\tsession._requireIdleContextOperation(\"replace context\");\n\tconst { name } = session._requireContextStrategy();\n\treturn session._applyContextTransition(session._copyContextMessages(context, name, \"input\"), \"session_replace\");\n}\n"]}

package/dist/core/agent-session-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-model.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,wBAAsB,eAAe,CACpC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EACrB,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,EACrC,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,GACjC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC7B,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAY1G;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,OAAO,EAAE,qBAAqB,EAC9B,SAAS,GAAE,SAAS,GAAG,UAAsB,EAC7C,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAKvC;AAED,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,SAAS,GAAG,UAAU,EACjC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAoCvC;AAED,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,SAAS,GAAG,UAAU,EACjC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA2BvC;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAC9B,OAAO,EAAE,qBAAqB,GAC5B,aAAa,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAAC,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAErE;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAQlE;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAC9B,OAAO,EAAE,qBAAqB,EAC9B,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAAC,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,GACvE,IAAI,CAEN;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,EACxB,aAAa,CAAC,EAAE,aAAa,GAC3B,aAAa,CAYf","sourcesContent":["/**\n * Model selection and thinking-level resolution for AgentSession.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name delegates so call sites, dynamic dispatch, and test spies\n * keep working unchanged. Method-to-method calls that have a facade member go\n * through the session parameter (not direct function calls) to preserve that\n * dispatch. `setModel` and `cycleModel` stay parallel implementations: each\n * keeps its own apply/persist/thinking/model_select sequence and never calls\n * the other.\n */\n\nimport type { ThinkingLevel } from \"@agent-forge/agent-core\";\nimport type { Api, Model } from \"@agent-forge/ai/compat\";\nimport { modelsAreEqual } from \"@agent-forge/ai/compat\";\nimport type { ModelCycleResult, ModelMutationOptions } from \"./agent-session.ts\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport { dispatchModelSelectLifecycle } from \"./agent-session-lifecycle.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type { ModelFactsViewV1 } from \"./extensions/public-api.ts\";\n\nexport async function emitModelSelect(\n\tsession: AgentSessionInternals,\n\tnextModel: Model<Api>,\n\tpreviousModel: Model<Api> | undefined,\n\tsource: \"set\" | \"cycle\" | \"restore\",\n): Promise<void> {\n\tif (modelsAreEqual(previousModel, nextModel)) return;\n\tawait dispatchModelSelectLifecycle(session, { provider: nextModel.provider, id: nextModel.id }, source);\n}\n\n/**\n * Set model directly.\n * Validates that auth is configured and saves to the session transcript.\n * Persists to global defaults only when options.persist is true.\n * @throws Error if no auth is configured for the model\n */\nexport async function setModel(\n\tsession: AgentSessionInternals,\n\tmodel: Model<Api>,\n\toptions: ModelMutationOptions = {},\n): Promise<void> {\n\tif (!(await session._modelRuntime.checkAuth(model.provider))) {\n\t\tthrow new Error(`No API key for ${model.provider}/${model.id}`);\n\t}\n\n\tconst previousModel = session.model;\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(model);\n\tsession.agent.state.model = model;\n\tsession.sessionManager.appendModelChange(model.provider, model.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(model.provider, model.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(model);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// Per-model thinking level overrides take priority over the global default.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(model, previousModel, \"set\");\n}\n\nexport function addPersistedDefaultToNonEmptyScope(session: AgentSessionInternals, model: Model<Api>): void {\n\tif (session._scopedModels.length === 0) return;\n\tif (session._scopedModels.some((scoped) => modelsAreEqual(scoped.model, model))) return;\n\n\tsession._scopedModels = [...session._scopedModels, { model }];\n\n\tconst enabledModels = session.settingsManager.getEnabledModels();\n\tif (!enabledModels?.length) return;\n\n\tconst modelReference = `${model.provider}/${model.id}`;\n\tif (enabledModels.some((pattern) => pattern.toLowerCase() === modelReference.toLowerCase())) return;\n\tsession.settingsManager.setEnabledModels([...enabledModels, modelReference]);\n}\n\n/**\n * Cycle to next/previous model.\n * Uses scoped models (from --models flag) if available, otherwise all available models.\n * @param direction - \"forward\" (default) or \"backward\"\n * @returns The new model info, or undefined if only one model available\n */\nexport async function cycleModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\" = \"forward\",\n\toptions: ModelMutationOptions = {},\n): Promise<ModelCycleResult | undefined> {\n\tif (session._scopedModels.length > 0) {\n\t\treturn session._cycleScopedModel(direction, options);\n\t}\n\treturn session._cycleAvailableModel(direction, options);\n}\n\nexport async function cycleScopedModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\",\n\toptions: ModelMutationOptions,\n): Promise<ModelCycleResult | undefined> {\n\tconst availableIds = new Set(\n\t\tsession._modelRuntime.getAvailableSnapshot().map((model) => `${model.provider}\\0${model.id}`),\n\t);\n\tconst scopedModels = session._scopedModels.filter((scoped) =>\n\t\tavailableIds.has(`${scoped.model.provider}\\0${scoped.model.id}`),\n\t);\n\tif (scopedModels.length <= 1) return undefined;\n\n\tconst currentModel = session.model;\n\tlet currentIndex = scopedModels.findIndex((sm) => modelsAreEqual(sm.model, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = scopedModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst next = scopedModels[nextIndex];\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(next.model, next.thinkingLevel);\n\n\t// Apply model\n\tsession.agent.state.model = next.model;\n\tsession.sessionManager.appendModelChange(next.model.provider, next.model.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(next.model.provider, next.model.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(next.model);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// - Explicit scoped model thinking level overrides defaults\n\t// - Per-model thinking level overrides take priority over the global default\n\t// setThinkingLevel clamps to model capabilities.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(next.model, currentModel, \"cycle\");\n\n\treturn { model: next.model, thinkingLevel: session.thinkingLevel, isScoped: true };\n}\n\nexport async function cycleAvailableModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\",\n\toptions: ModelMutationOptions,\n): Promise<ModelCycleResult | undefined> {\n\tconst availableModels = session._modelRuntime.getAvailableSnapshot();\n\tif (availableModels.length <= 1) return undefined;\n\n\tconst currentModel = session.model;\n\tlet currentIndex = availableModels.findIndex((m) => modelsAreEqual(m, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = availableModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst nextModel = availableModels[nextIndex];\n\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(nextModel);\n\tsession.agent.state.model = nextModel;\n\tsession.sessionManager.appendModelChange(nextModel.provider, nextModel.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(nextModel);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(nextModel, currentModel, \"cycle\");\n\n\treturn { model: nextModel, thinkingLevel: session.thinkingLevel, isScoped: false };\n}\n\n/** Scoped models for cycling (from --models flag). */\nexport function getScopedModels(\n\tsession: AgentSessionInternals,\n): ReadonlyArray<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }> {\n\treturn session._scopedModels;\n}\n\n/** Project provider-agnostic facts off a Model without exposing api/headers/cost internals. */\nexport function modelFactsView(model: Model<Api>): ModelFactsViewV1 {\n\treturn {\n\t\tprovider: model.provider,\n\t\tid: model.id,\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxTokens,\n\t\treasoning: model.reasoning,\n\t};\n}\n\n/** Update scoped models for cycling. */\nexport function setScopedModels(\n\tsession: AgentSessionInternals,\n\tscopedModels: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>,\n): void {\n\tsession._scopedModels = scopedModels;\n}\n\nexport function getThinkingLevelForModelSwitch(\n\tsession: AgentSessionInternals,\n\ttargetModel?: Model<Api>,\n\texplicitLevel?: ThinkingLevel,\n): ThinkingLevel {\n\tif (explicitLevel !== undefined) {\n\t\treturn explicitLevel;\n\t}\n\t// Per-model default takes priority when switching to a model that has one\n\tif (targetModel) {\n\t\tconst perModel = session.settingsManager.getModelThinkingLevel(targetModel.provider, targetModel.id);\n\t\tif (perModel !== undefined) {\n\t\t\treturn perModel;\n\t\t}\n\t}\n\treturn session.settingsManager.getDefaultThinkingLevel() ?? session.thinkingLevel ?? DEFAULT_THINKING_LEVEL;\n}\n"]}
+{"version":3,"file":"agent-session-model.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,wBAAsB,eAAe,CACpC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EACrB,aAAa,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,EACrC,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,SAAS,GACjC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC7B,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EACjB,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,IAAI,CAAC,CAoBf;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAY1G;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC/B,OAAO,EAAE,qBAAqB,EAC9B,SAAS,GAAE,SAAS,GAAG,UAAsB,EAC7C,OAAO,GAAE,oBAAyB,GAChC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAKvC;AAED,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,SAAS,GAAG,UAAU,EACjC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAoCvC;AAED,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,SAAS,GAAG,UAAU,EACjC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CA2BvC;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAC9B,OAAO,EAAE,qBAAqB,GAC5B,aAAa,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAAC,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAErE;AAED,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAQlE;AAED,wCAAwC;AACxC,wBAAgB,eAAe,CAC9B,OAAO,EAAE,qBAAqB,EAC9B,YAAY,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAAC,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,GACvE,IAAI,CAEN;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,EACxB,aAAa,CAAC,EAAE,aAAa,GAC3B,aAAa,CAYf","sourcesContent":["/**\n * Model selection and thinking-level resolution for AgentSession.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name delegates so call sites, dynamic dispatch, and test spies\n * keep working unchanged. Method-to-method calls that have a facade member go\n * through the session parameter (not direct function calls) to preserve that\n * dispatch. `setModel` and `cycleModel` stay parallel implementations: each\n * keeps its own apply/persist/thinking/model_select sequence and never calls\n * the other.\n */\n\nimport type { ThinkingLevel } from \"@agent-forge/agent-core\";\nimport type { Api, Model } from \"@agent-forge/ai/compat\";\nimport { modelsAreEqual } from \"@agent-forge/ai/compat\";\nimport type { ModelCycleResult, ModelMutationOptions } from \"./agent-session.ts\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport { dispatchModelSelectLifecycle } from \"./agent-session-lifecycle.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type { ModelFactsViewV1 } from \"./extensions/public-api.ts\";\nimport { t } from \"./i18n/index.ts\";\n\nexport async function emitModelSelect(\n\tsession: AgentSessionInternals,\n\tnextModel: Model<Api>,\n\tpreviousModel: Model<Api> | undefined,\n\tsource: \"set\" | \"cycle\" | \"restore\",\n): Promise<void> {\n\tif (modelsAreEqual(previousModel, nextModel)) return;\n\tawait dispatchModelSelectLifecycle(session, { provider: nextModel.provider, id: nextModel.id }, source);\n}\n\n/**\n * Set model directly.\n * Validates that auth is configured and saves to the session transcript.\n * Persists to global defaults only when options.persist is true.\n * @throws Error if no auth is configured for the model\n */\nexport async function setModel(\n\tsession: AgentSessionInternals,\n\tmodel: Model<Api>,\n\toptions: ModelMutationOptions = {},\n): Promise<void> {\n\tif (!(await session._modelRuntime.checkAuth(model.provider))) {\n\t\tthrow new Error(t(\"No API key for {provider}/{model}\", { provider: model.provider, model: model.id }));\n\t}\n\n\tconst previousModel = session.model;\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(model);\n\tsession.agent.state.model = model;\n\tsession.sessionManager.appendModelChange(model.provider, model.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(model.provider, model.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(model);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// Per-model thinking level overrides take priority over the global default.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(model, previousModel, \"set\");\n}\n\nexport function addPersistedDefaultToNonEmptyScope(session: AgentSessionInternals, model: Model<Api>): void {\n\tif (session._scopedModels.length === 0) return;\n\tif (session._scopedModels.some((scoped) => modelsAreEqual(scoped.model, model))) return;\n\n\tsession._scopedModels = [...session._scopedModels, { model }];\n\n\tconst enabledModels = session.settingsManager.getEnabledModels();\n\tif (!enabledModels?.length) return;\n\n\tconst modelReference = `${model.provider}/${model.id}`;\n\tif (enabledModels.some((pattern) => pattern.toLowerCase() === modelReference.toLowerCase())) return;\n\tsession.settingsManager.setEnabledModels([...enabledModels, modelReference]);\n}\n\n/**\n * Cycle to next/previous model.\n * Uses scoped models (from --models flag) if available, otherwise all available models.\n * @param direction - \"forward\" (default) or \"backward\"\n * @returns The new model info, or undefined if only one model available\n */\nexport async function cycleModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\" = \"forward\",\n\toptions: ModelMutationOptions = {},\n): Promise<ModelCycleResult | undefined> {\n\tif (session._scopedModels.length > 0) {\n\t\treturn session._cycleScopedModel(direction, options);\n\t}\n\treturn session._cycleAvailableModel(direction, options);\n}\n\nexport async function cycleScopedModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\",\n\toptions: ModelMutationOptions,\n): Promise<ModelCycleResult | undefined> {\n\tconst availableIds = new Set(\n\t\tsession._modelRuntime.getAvailableSnapshot().map((model) => `${model.provider}\\0${model.id}`),\n\t);\n\tconst scopedModels = session._scopedModels.filter((scoped) =>\n\t\tavailableIds.has(`${scoped.model.provider}\\0${scoped.model.id}`),\n\t);\n\tif (scopedModels.length <= 1) return undefined;\n\n\tconst currentModel = session.model;\n\tlet currentIndex = scopedModels.findIndex((sm) => modelsAreEqual(sm.model, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = scopedModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst next = scopedModels[nextIndex];\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(next.model, next.thinkingLevel);\n\n\t// Apply model\n\tsession.agent.state.model = next.model;\n\tsession.sessionManager.appendModelChange(next.model.provider, next.model.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(next.model.provider, next.model.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(next.model);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// - Explicit scoped model thinking level overrides defaults\n\t// - Per-model thinking level overrides take priority over the global default\n\t// setThinkingLevel clamps to model capabilities.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(next.model, currentModel, \"cycle\");\n\n\treturn { model: next.model, thinkingLevel: session.thinkingLevel, isScoped: true };\n}\n\nexport async function cycleAvailableModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\",\n\toptions: ModelMutationOptions,\n): Promise<ModelCycleResult | undefined> {\n\tconst availableModels = session._modelRuntime.getAvailableSnapshot();\n\tif (availableModels.length <= 1) return undefined;\n\n\tconst currentModel = session.model;\n\tlet currentIndex = availableModels.findIndex((m) => modelsAreEqual(m, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = availableModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst nextModel = availableModels[nextIndex];\n\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(nextModel);\n\tsession.agent.state.model = nextModel;\n\tsession.sessionManager.appendModelChange(nextModel.provider, nextModel.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(nextModel);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(nextModel, currentModel, \"cycle\");\n\n\treturn { model: nextModel, thinkingLevel: session.thinkingLevel, isScoped: false };\n}\n\n/** Scoped models for cycling (from --models flag). */\nexport function getScopedModels(\n\tsession: AgentSessionInternals,\n): ReadonlyArray<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }> {\n\treturn session._scopedModels;\n}\n\n/** Project provider-agnostic facts off a Model without exposing api/headers/cost internals. */\nexport function modelFactsView(model: Model<Api>): ModelFactsViewV1 {\n\treturn {\n\t\tprovider: model.provider,\n\t\tid: model.id,\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxTokens,\n\t\treasoning: model.reasoning,\n\t};\n}\n\n/** Update scoped models for cycling. */\nexport function setScopedModels(\n\tsession: AgentSessionInternals,\n\tscopedModels: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>,\n): void {\n\tsession._scopedModels = scopedModels;\n}\n\nexport function getThinkingLevelForModelSwitch(\n\tsession: AgentSessionInternals,\n\ttargetModel?: Model<Api>,\n\texplicitLevel?: ThinkingLevel,\n): ThinkingLevel {\n\tif (explicitLevel !== undefined) {\n\t\treturn explicitLevel;\n\t}\n\t// Per-model default takes priority when switching to a model that has one\n\tif (targetModel) {\n\t\tconst perModel = session.settingsManager.getModelThinkingLevel(targetModel.provider, targetModel.id);\n\t\tif (perModel !== undefined) {\n\t\t\treturn perModel;\n\t\t}\n\t}\n\treturn session.settingsManager.getDefaultThinkingLevel() ?? session.thinkingLevel ?? DEFAULT_THINKING_LEVEL;\n}\n"]}

package/dist/core/agent-session-model.js

@@ -13,6 +13,7 @@
 import { modelsAreEqual } from "@agent-forge/ai/compat";
 import { dispatchModelSelectLifecycle } from "./agent-session-lifecycle.js";
 import { DEFAULT_THINKING_LEVEL } from "./defaults.js";
+import { t } from "./i18n/index.js";
 export async function emitModelSelect(session, nextModel, previousModel, source) {
     if (modelsAreEqual(previousModel, nextModel))
         return;
@@ -26,7 +27,7 @@ export async function emitModelSelect(session, nextModel, previousModel, source)
  */
 export async function setModel(session, model, options = {}) {
     if (!(await session._modelRuntime.checkAuth(model.provider))) {
-        throw new Error(`No API key for ${model.provider}/${model.id}`);
+        throw new Error(t("No API key for {provider}/{model}", { provider: model.provider, model: model.id }));
     }
     const previousModel = session.model;
     const thinkingLevel = session._getThinkingLevelForModelSwitch(model);

package/dist/core/agent-session-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-model.js","sourceRoot":"","sources":["../../src/core/agent-session-model.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Model selection and thinking-level resolution for AgentSession.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name delegates so call sites, dynamic dispatch, and test spies\n * keep working unchanged. Method-to-method calls that have a facade member go\n * through the session parameter (not direct function calls) to preserve that\n * dispatch. `setModel` and `cycleModel` stay parallel implementations: each\n * keeps its own apply/persist/thinking/model_select sequence and never calls\n * the other.\n */\n\nimport type { ThinkingLevel } from \"@agent-forge/agent-core\";\nimport type { Api, Model } from \"@agent-forge/ai/compat\";\nimport { modelsAreEqual } from \"@agent-forge/ai/compat\";\nimport type { ModelCycleResult, ModelMutationOptions } from \"./agent-session.ts\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport { dispatchModelSelectLifecycle } from \"./agent-session-lifecycle.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type { ModelFactsViewV1 } from \"./extensions/public-api.ts\";\n\nexport async function emitModelSelect(\n\tsession: AgentSessionInternals,\n\tnextModel: Model<Api>,\n\tpreviousModel: Model<Api> | undefined,\n\tsource: \"set\" | \"cycle\" | \"restore\",\n): Promise<void> {\n\tif (modelsAreEqual(previousModel, nextModel)) return;\n\tawait dispatchModelSelectLifecycle(session, { provider: nextModel.provider, id: nextModel.id }, source);\n}\n\n/**\n * Set model directly.\n * Validates that auth is configured and saves to the session transcript.\n * Persists to global defaults only when options.persist is true.\n * @throws Error if no auth is configured for the model\n */\nexport async function setModel(\n\tsession: AgentSessionInternals,\n\tmodel: Model<Api>,\n\toptions: ModelMutationOptions = {},\n): Promise<void> {\n\tif (!(await session._modelRuntime.checkAuth(model.provider))) {\n\t\tthrow new Error(`No API key for ${model.provider}/${model.id}`);\n\t}\n\n\tconst previousModel = session.model;\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(model);\n\tsession.agent.state.model = model;\n\tsession.sessionManager.appendModelChange(model.provider, model.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(model.provider, model.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(model);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// Per-model thinking level overrides take priority over the global default.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(model, previousModel, \"set\");\n}\n\nexport function addPersistedDefaultToNonEmptyScope(session: AgentSessionInternals, model: Model<Api>): void {\n\tif (session._scopedModels.length === 0) return;\n\tif (session._scopedModels.some((scoped) => modelsAreEqual(scoped.model, model))) return;\n\n\tsession._scopedModels = [...session._scopedModels, { model }];\n\n\tconst enabledModels = session.settingsManager.getEnabledModels();\n\tif (!enabledModels?.length) return;\n\n\tconst modelReference = `${model.provider}/${model.id}`;\n\tif (enabledModels.some((pattern) => pattern.toLowerCase() === modelReference.toLowerCase())) return;\n\tsession.settingsManager.setEnabledModels([...enabledModels, modelReference]);\n}\n\n/**\n * Cycle to next/previous model.\n * Uses scoped models (from --models flag) if available, otherwise all available models.\n * @param direction - \"forward\" (default) or \"backward\"\n * @returns The new model info, or undefined if only one model available\n */\nexport async function cycleModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\" = \"forward\",\n\toptions: ModelMutationOptions = {},\n): Promise<ModelCycleResult | undefined> {\n\tif (session._scopedModels.length > 0) {\n\t\treturn session._cycleScopedModel(direction, options);\n\t}\n\treturn session._cycleAvailableModel(direction, options);\n}\n\nexport async function cycleScopedModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\",\n\toptions: ModelMutationOptions,\n): Promise<ModelCycleResult | undefined> {\n\tconst availableIds = new Set(\n\t\tsession._modelRuntime.getAvailableSnapshot().map((model) => `${model.provider}\\0${model.id}`),\n\t);\n\tconst scopedModels = session._scopedModels.filter((scoped) =>\n\t\tavailableIds.has(`${scoped.model.provider}\\0${scoped.model.id}`),\n\t);\n\tif (scopedModels.length <= 1) return undefined;\n\n\tconst currentModel = session.model;\n\tlet currentIndex = scopedModels.findIndex((sm) => modelsAreEqual(sm.model, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = scopedModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst next = scopedModels[nextIndex];\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(next.model, next.thinkingLevel);\n\n\t// Apply model\n\tsession.agent.state.model = next.model;\n\tsession.sessionManager.appendModelChange(next.model.provider, next.model.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(next.model.provider, next.model.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(next.model);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// - Explicit scoped model thinking level overrides defaults\n\t// - Per-model thinking level overrides take priority over the global default\n\t// setThinkingLevel clamps to model capabilities.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(next.model, currentModel, \"cycle\");\n\n\treturn { model: next.model, thinkingLevel: session.thinkingLevel, isScoped: true };\n}\n\nexport async function cycleAvailableModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\",\n\toptions: ModelMutationOptions,\n): Promise<ModelCycleResult | undefined> {\n\tconst availableModels = session._modelRuntime.getAvailableSnapshot();\n\tif (availableModels.length <= 1) return undefined;\n\n\tconst currentModel = session.model;\n\tlet currentIndex = availableModels.findIndex((m) => modelsAreEqual(m, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = availableModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst nextModel = availableModels[nextIndex];\n\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(nextModel);\n\tsession.agent.state.model = nextModel;\n\tsession.sessionManager.appendModelChange(nextModel.provider, nextModel.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(nextModel);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(nextModel, currentModel, \"cycle\");\n\n\treturn { model: nextModel, thinkingLevel: session.thinkingLevel, isScoped: false };\n}\n\n/** Scoped models for cycling (from --models flag). */\nexport function getScopedModels(\n\tsession: AgentSessionInternals,\n): ReadonlyArray<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }> {\n\treturn session._scopedModels;\n}\n\n/** Project provider-agnostic facts off a Model without exposing api/headers/cost internals. */\nexport function modelFactsView(model: Model<Api>): ModelFactsViewV1 {\n\treturn {\n\t\tprovider: model.provider,\n\t\tid: model.id,\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxTokens,\n\t\treasoning: model.reasoning,\n\t};\n}\n\n/** Update scoped models for cycling. */\nexport function setScopedModels(\n\tsession: AgentSessionInternals,\n\tscopedModels: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>,\n): void {\n\tsession._scopedModels = scopedModels;\n}\n\nexport function getThinkingLevelForModelSwitch(\n\tsession: AgentSessionInternals,\n\ttargetModel?: Model<Api>,\n\texplicitLevel?: ThinkingLevel,\n): ThinkingLevel {\n\tif (explicitLevel !== undefined) {\n\t\treturn explicitLevel;\n\t}\n\t// Per-model default takes priority when switching to a model that has one\n\tif (targetModel) {\n\t\tconst perModel = session.settingsManager.getModelThinkingLevel(targetModel.provider, targetModel.id);\n\t\tif (perModel !== undefined) {\n\t\t\treturn perModel;\n\t\t}\n\t}\n\treturn session.settingsManager.getDefaultThinkingLevel() ?? session.thinkingLevel ?? DEFAULT_THINKING_LEVEL;\n}\n"]}
+{"version":3,"file":"agent-session-model.js","sourceRoot":"","sources":["../../src/core/agent-session-model.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Model selection and thinking-level resolution for AgentSession.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name delegates so call sites, dynamic dispatch, and test spies\n * keep working unchanged. Method-to-method calls that have a facade member go\n * through the session parameter (not direct function calls) to preserve that\n * dispatch. `setModel` and `cycleModel` stay parallel implementations: each\n * keeps its own apply/persist/thinking/model_select sequence and never calls\n * the other.\n */\n\nimport type { ThinkingLevel } from \"@agent-forge/agent-core\";\nimport type { Api, Model } from \"@agent-forge/ai/compat\";\nimport { modelsAreEqual } from \"@agent-forge/ai/compat\";\nimport type { ModelCycleResult, ModelMutationOptions } from \"./agent-session.ts\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport { dispatchModelSelectLifecycle } from \"./agent-session-lifecycle.ts\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.ts\";\nimport type { ModelFactsViewV1 } from \"./extensions/public-api.ts\";\nimport { t } from \"./i18n/index.ts\";\n\nexport async function emitModelSelect(\n\tsession: AgentSessionInternals,\n\tnextModel: Model<Api>,\n\tpreviousModel: Model<Api> | undefined,\n\tsource: \"set\" | \"cycle\" | \"restore\",\n): Promise<void> {\n\tif (modelsAreEqual(previousModel, nextModel)) return;\n\tawait dispatchModelSelectLifecycle(session, { provider: nextModel.provider, id: nextModel.id }, source);\n}\n\n/**\n * Set model directly.\n * Validates that auth is configured and saves to the session transcript.\n * Persists to global defaults only when options.persist is true.\n * @throws Error if no auth is configured for the model\n */\nexport async function setModel(\n\tsession: AgentSessionInternals,\n\tmodel: Model<Api>,\n\toptions: ModelMutationOptions = {},\n): Promise<void> {\n\tif (!(await session._modelRuntime.checkAuth(model.provider))) {\n\t\tthrow new Error(t(\"No API key for {provider}/{model}\", { provider: model.provider, model: model.id }));\n\t}\n\n\tconst previousModel = session.model;\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(model);\n\tsession.agent.state.model = model;\n\tsession.sessionManager.appendModelChange(model.provider, model.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(model.provider, model.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(model);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// Per-model thinking level overrides take priority over the global default.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(model, previousModel, \"set\");\n}\n\nexport function addPersistedDefaultToNonEmptyScope(session: AgentSessionInternals, model: Model<Api>): void {\n\tif (session._scopedModels.length === 0) return;\n\tif (session._scopedModels.some((scoped) => modelsAreEqual(scoped.model, model))) return;\n\n\tsession._scopedModels = [...session._scopedModels, { model }];\n\n\tconst enabledModels = session.settingsManager.getEnabledModels();\n\tif (!enabledModels?.length) return;\n\n\tconst modelReference = `${model.provider}/${model.id}`;\n\tif (enabledModels.some((pattern) => pattern.toLowerCase() === modelReference.toLowerCase())) return;\n\tsession.settingsManager.setEnabledModels([...enabledModels, modelReference]);\n}\n\n/**\n * Cycle to next/previous model.\n * Uses scoped models (from --models flag) if available, otherwise all available models.\n * @param direction - \"forward\" (default) or \"backward\"\n * @returns The new model info, or undefined if only one model available\n */\nexport async function cycleModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\" = \"forward\",\n\toptions: ModelMutationOptions = {},\n): Promise<ModelCycleResult | undefined> {\n\tif (session._scopedModels.length > 0) {\n\t\treturn session._cycleScopedModel(direction, options);\n\t}\n\treturn session._cycleAvailableModel(direction, options);\n}\n\nexport async function cycleScopedModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\",\n\toptions: ModelMutationOptions,\n): Promise<ModelCycleResult | undefined> {\n\tconst availableIds = new Set(\n\t\tsession._modelRuntime.getAvailableSnapshot().map((model) => `${model.provider}\\0${model.id}`),\n\t);\n\tconst scopedModels = session._scopedModels.filter((scoped) =>\n\t\tavailableIds.has(`${scoped.model.provider}\\0${scoped.model.id}`),\n\t);\n\tif (scopedModels.length <= 1) return undefined;\n\n\tconst currentModel = session.model;\n\tlet currentIndex = scopedModels.findIndex((sm) => modelsAreEqual(sm.model, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = scopedModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst next = scopedModels[nextIndex];\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(next.model, next.thinkingLevel);\n\n\t// Apply model\n\tsession.agent.state.model = next.model;\n\tsession.sessionManager.appendModelChange(next.model.provider, next.model.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(next.model.provider, next.model.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(next.model);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// - Explicit scoped model thinking level overrides defaults\n\t// - Per-model thinking level overrides take priority over the global default\n\t// setThinkingLevel clamps to model capabilities.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(next.model, currentModel, \"cycle\");\n\n\treturn { model: next.model, thinkingLevel: session.thinkingLevel, isScoped: true };\n}\n\nexport async function cycleAvailableModel(\n\tsession: AgentSessionInternals,\n\tdirection: \"forward\" | \"backward\",\n\toptions: ModelMutationOptions,\n): Promise<ModelCycleResult | undefined> {\n\tconst availableModels = session._modelRuntime.getAvailableSnapshot();\n\tif (availableModels.length <= 1) return undefined;\n\n\tconst currentModel = session.model;\n\tlet currentIndex = availableModels.findIndex((m) => modelsAreEqual(m, currentModel));\n\n\tif (currentIndex === -1) currentIndex = 0;\n\tconst len = availableModels.length;\n\tconst nextIndex = direction === \"forward\" ? (currentIndex + 1) % len : (currentIndex - 1 + len) % len;\n\tconst nextModel = availableModels[nextIndex];\n\n\tconst thinkingLevel = session._getThinkingLevelForModelSwitch(nextModel);\n\tsession.agent.state.model = nextModel;\n\tsession.sessionManager.appendModelChange(nextModel.provider, nextModel.id);\n\tif (options.persist) {\n\t\tsession.settingsManager.setDefaultModelAndProvider(nextModel.provider, nextModel.id);\n\t\tsession._addPersistedDefaultToNonEmptyScope(nextModel);\n\t}\n\n\t// Apply thinking level for the new model.\n\t// Model persistence does not implicitly rewrite the global thinking default.\n\tsession.setThinkingLevel(thinkingLevel);\n\n\tawait session._emitModelSelect(nextModel, currentModel, \"cycle\");\n\n\treturn { model: nextModel, thinkingLevel: session.thinkingLevel, isScoped: false };\n}\n\n/** Scoped models for cycling (from --models flag). */\nexport function getScopedModels(\n\tsession: AgentSessionInternals,\n): ReadonlyArray<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }> {\n\treturn session._scopedModels;\n}\n\n/** Project provider-agnostic facts off a Model without exposing api/headers/cost internals. */\nexport function modelFactsView(model: Model<Api>): ModelFactsViewV1 {\n\treturn {\n\t\tprovider: model.provider,\n\t\tid: model.id,\n\t\tcontextWindow: model.contextWindow,\n\t\tmaxTokens: model.maxTokens,\n\t\treasoning: model.reasoning,\n\t};\n}\n\n/** Update scoped models for cycling. */\nexport function setScopedModels(\n\tsession: AgentSessionInternals,\n\tscopedModels: Array<{ model: Model<Api>; thinkingLevel?: ThinkingLevel }>,\n): void {\n\tsession._scopedModels = scopedModels;\n}\n\nexport function getThinkingLevelForModelSwitch(\n\tsession: AgentSessionInternals,\n\ttargetModel?: Model<Api>,\n\texplicitLevel?: ThinkingLevel,\n): ThinkingLevel {\n\tif (explicitLevel !== undefined) {\n\t\treturn explicitLevel;\n\t}\n\t// Per-model default takes priority when switching to a model that has one\n\tif (targetModel) {\n\t\tconst perModel = session.settingsManager.getModelThinkingLevel(targetModel.provider, targetModel.id);\n\t\tif (perModel !== undefined) {\n\t\t\treturn perModel;\n\t\t}\n\t}\n\treturn session.settingsManager.getDefaultThinkingLevel() ?? session.thinkingLevel ?? DEFAULT_THINKING_LEVEL;\n}\n"]}

package/dist/core/agent-session-retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-retry.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,EACjD,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAsB,WAAW,CAChC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,WAAW,gEAiBpB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CACjC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,GACzE,OAAO,CAAC,OAAO,CAAC,CA0DlB","sourcesContent":["/**\n * Auto-retry and overflow classification for AgentSession.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name private delegates so call sites, dynamic dispatch, and test\n * spies keep working unchanged. Method-to-method calls go through the session\n * parameter (not direct function calls) to preserve that dispatch.\n */\n\nimport type { AgentEvent } from \"@agent-forge/agent-core\";\nimport { retryDelayMs } from \"@agent-forge/ai\";\nimport type { AssistantMessage } from \"@agent-forge/ai/compat\";\nimport { sleep } from \"../utils/sleep.ts\";\nimport { decideOverflow, executionFacts } from \"./agent-session-compaction.ts\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport { dispatchAutoRetryLifecycle } from \"./agent-session-lifecycle.ts\";\nimport type { CapabilityRuntime, ExecutionFactsV1 } from \"./extensions/index.ts\";\n\nexport async function willRetryAfterAgentEnd(\n\tsession: AgentSessionInternals,\n\tevent: Extract<AgentEvent, { type: \"agent_end\" }>,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\tif (signal?.aborted) {\n\t\tsession._pendingRetryDecision = undefined;\n\t\treturn false;\n\t}\n\tconst settings = session.settingsManager.getRetrySettings();\n\tif (session._retryAttempt >= settings.maxRetries) {\n\t\tsession._pendingRetryDecision = undefined;\n\t\treturn false;\n\t}\n\n\tfor (let i = event.messages.length - 1; i >= 0; i--) {\n\t\tconst message = event.messages[i];\n\t\tif (message.role === \"assistant\") {\n\t\t\tconst assistantMessage = message as AssistantMessage;\n\t\t\ttry {\n\t\t\t\tconst decision = await decideRetry(session, assistantMessage, undefined, signal);\n\t\t\t\tsession._pendingRetryDecision = { message: assistantMessage, decision };\n\t\t\t\treturn decision.retry;\n\t\t\t} catch (error) {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\tsession._pendingRetryDecision = undefined;\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\tsession._pendingRetryDecision = undefined;\n\treturn false;\n}\n\n/**\n * Check if an error is retryable (overloaded, rate limit, server errors).\n * Context overflow errors are NOT retryable (handled by compaction instead).\n */\nexport async function isRetryableError(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\texecution?: ExecutionFactsV1,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\t// Context overflow is handled by compaction, not retry.\n\tif ((await decideOverflow(session, message, execution, signal)).contextOverflow) return false;\n\tconst runtime = session._capabilityRuntime;\n\t// v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在\n\tif (!runtime) throw new Error(\"Capability runtime is not available\");\n\treturn runtime.classifyRetry(session._retryPolicyName, {\n\t\tmessage,\n\t\tsignal,\n\t\tcontext: { version: 1, sessionId: session.sessionId, phase: \"retry\" },\n\t\texecution: execution ?? executionFacts(session, \"retry\"),\n\t});\n}\n\nexport async function decideRetry(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\texecution?: ExecutionFactsV1,\n\tsignal?: AbortSignal,\n) {\n\tconst settings = session.settingsManager.getRetrySettings();\n\tconst runtime = session._capabilityRuntime;\n\t// v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在\n\tif (!runtime) throw new Error(\"Capability runtime is not available\");\n\treturn runtime.decideRetry(session._retryPolicyName, {\n\t\tretryable: await session._isRetryableError(message, execution, signal),\n\t\tenabled: settings.enabled,\n\t\tattempt: session._retryAttempt + 1,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tbaseDelayMs: settings.baseDelayMs,\n\t\terrorMessage: message.errorMessage,\n\t\tsignal,\n\t\tcontext: { version: 1, sessionId: session.sessionId, phase: \"retry\" },\n\t\texecution: execution ?? executionFacts(session, \"retry\"),\n\t});\n}\n\n/**\n * Prepare a retryable error for continuation with exponential backoff.\n * @returns true if the caller should continue the agent, false otherwise\n */\nexport async function prepareRetry(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\tprecomputedDecision?: Awaited<ReturnType<CapabilityRuntime[\"decideRetry\"]>>,\n): Promise<boolean> {\n\tconst settings = session.settingsManager.getRetrySettings();\n\tconst decision = precomputedDecision ?? (await decideRetry(session, message));\n\tif (!decision.retry) return false;\n\tsession._retryAttempt++;\n\t// ±10% jitter on the exponential backoff (borrowed from codex's backoff):\n\t// prevents synchronized retry storms when many sessions hit the same outage.\n\t// The effective delay is capped by maxAgentDelayMs before jitter (retryDelayMs\n\t// already caps the exponential path; the min() also clamps policy-provided\n\t// delayMs), so a capped delay can overshoot the cap by at most the jitter band.\n\tconst baseDelayMs = Math.min(\n\t\tdecision.delayMs ?? retryDelayMs(settings, session._retryAttempt),\n\t\tsettings.maxAgentDelayMs,\n\t);\n\tconst delayMs = Math.round(baseDelayMs * (0.9 + Math.random() * 0.2));\n\t// Install the controller before announcing the retry so listeners can cancel\n\t// the pending delay from the auto_retry_start event itself.\n\tsession._retryAbortController = new AbortController();\n\n\tsession._emit({\n\t\ttype: \"auto_retry_start\",\n\t\tattempt: session._retryAttempt,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tdelayMs,\n\t\terrorMessage: message.errorMessage || \"Unknown error\",\n\t});\n\tawait dispatchAutoRetryLifecycle(session, {\n\t\tattempt: session._retryAttempt,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tdelayMs,\n\t\terrorMessage: message.errorMessage || \"Unknown error\",\n\t});\n\n\t// Remove error message from agent state (keep in session for history)\n\tconst messages = session.agent.state.messages;\n\tif (messages.length > 0 && messages[messages.length - 1].role === \"assistant\") {\n\t\tawait session._applyContextTransition(messages.slice(0, -1), \"retry\");\n\t}\n\n\t// Wait with exponential backoff (abortable)\n\ttry {\n\t\tawait sleep(delayMs, session._retryAbortController.signal);\n\t} catch {\n\t\t// Aborted during sleep - emit end event so UI can clean up\n\t\tconst attempt = session._retryAttempt;\n\t\tsession._retryAttempt = 0;\n\t\tsession._emit({\n\t\t\ttype: \"auto_retry_end\",\n\t\t\tsuccess: false,\n\t\t\tattempt,\n\t\t\tfinalError: \"Retry cancelled\",\n\t\t});\n\t\treturn false;\n\t} finally {\n\t\tsession._retryAbortController = undefined;\n\t}\n\n\treturn true;\n}\n"]}
+{"version":3,"file":"agent-session-retry.d.ts","sourceRoot":"","sources":["../../src/core/agent-session-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,EACjD,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CA8BlB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAsB,WAAW,CAChC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,WAAW,gEAiBpB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CACjC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,GACzE,OAAO,CAAC,OAAO,CAAC,CA0DlB","sourcesContent":["/**\n * Auto-retry and overflow classification for AgentSession.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name private delegates so call sites, dynamic dispatch, and test\n * spies keep working unchanged. Method-to-method calls go through the session\n * parameter (not direct function calls) to preserve that dispatch.\n */\n\nimport type { AgentEvent } from \"@agent-forge/agent-core\";\nimport { retryDelayMs } from \"@agent-forge/ai\";\nimport type { AssistantMessage } from \"@agent-forge/ai/compat\";\nimport { sleep } from \"../utils/sleep.ts\";\nimport { decideOverflow, executionFacts } from \"./agent-session-compaction.ts\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport { dispatchAutoRetryLifecycle } from \"./agent-session-lifecycle.ts\";\nimport type { CapabilityRuntime, ExecutionFactsV1 } from \"./extensions/index.ts\";\nimport { t } from \"./i18n/index.ts\";\n\nexport async function willRetryAfterAgentEnd(\n\tsession: AgentSessionInternals,\n\tevent: Extract<AgentEvent, { type: \"agent_end\" }>,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\tif (signal?.aborted) {\n\t\tsession._pendingRetryDecision = undefined;\n\t\treturn false;\n\t}\n\tconst settings = session.settingsManager.getRetrySettings();\n\tif (session._retryAttempt >= settings.maxRetries) {\n\t\tsession._pendingRetryDecision = undefined;\n\t\treturn false;\n\t}\n\n\tfor (let i = event.messages.length - 1; i >= 0; i--) {\n\t\tconst message = event.messages[i];\n\t\tif (message.role === \"assistant\") {\n\t\t\tconst assistantMessage = message as AssistantMessage;\n\t\t\ttry {\n\t\t\t\tconst decision = await decideRetry(session, assistantMessage, undefined, signal);\n\t\t\t\tsession._pendingRetryDecision = { message: assistantMessage, decision };\n\t\t\t\treturn decision.retry;\n\t\t\t} catch (error) {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\tsession._pendingRetryDecision = undefined;\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\tsession._pendingRetryDecision = undefined;\n\treturn false;\n}\n\n/**\n * Check if an error is retryable (overloaded, rate limit, server errors).\n * Context overflow errors are NOT retryable (handled by compaction instead).\n */\nexport async function isRetryableError(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\texecution?: ExecutionFactsV1,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\t// Context overflow is handled by compaction, not retry.\n\tif ((await decideOverflow(session, message, execution, signal)).contextOverflow) return false;\n\tconst runtime = session._capabilityRuntime;\n\t// v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在\n\tif (!runtime) throw new Error(t(\"Capability runtime is not available\"));\n\treturn runtime.classifyRetry(session._retryPolicyName, {\n\t\tmessage,\n\t\tsignal,\n\t\tcontext: { version: 1, sessionId: session.sessionId, phase: \"retry\" },\n\t\texecution: execution ?? executionFacts(session, \"retry\"),\n\t});\n}\n\nexport async function decideRetry(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\texecution?: ExecutionFactsV1,\n\tsignal?: AbortSignal,\n) {\n\tconst settings = session.settingsManager.getRetrySettings();\n\tconst runtime = session._capabilityRuntime;\n\t// v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在\n\tif (!runtime) throw new Error(t(\"Capability runtime is not available\"));\n\treturn runtime.decideRetry(session._retryPolicyName, {\n\t\tretryable: await session._isRetryableError(message, execution, signal),\n\t\tenabled: settings.enabled,\n\t\tattempt: session._retryAttempt + 1,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tbaseDelayMs: settings.baseDelayMs,\n\t\terrorMessage: message.errorMessage,\n\t\tsignal,\n\t\tcontext: { version: 1, sessionId: session.sessionId, phase: \"retry\" },\n\t\texecution: execution ?? executionFacts(session, \"retry\"),\n\t});\n}\n\n/**\n * Prepare a retryable error for continuation with exponential backoff.\n * @returns true if the caller should continue the agent, false otherwise\n */\nexport async function prepareRetry(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\tprecomputedDecision?: Awaited<ReturnType<CapabilityRuntime[\"decideRetry\"]>>,\n): Promise<boolean> {\n\tconst settings = session.settingsManager.getRetrySettings();\n\tconst decision = precomputedDecision ?? (await decideRetry(session, message));\n\tif (!decision.retry) return false;\n\tsession._retryAttempt++;\n\t// ±10% jitter on the exponential backoff (borrowed from codex's backoff):\n\t// prevents synchronized retry storms when many sessions hit the same outage.\n\t// The effective delay is capped by maxAgentDelayMs before jitter (retryDelayMs\n\t// already caps the exponential path; the min() also clamps policy-provided\n\t// delayMs), so a capped delay can overshoot the cap by at most the jitter band.\n\tconst baseDelayMs = Math.min(\n\t\tdecision.delayMs ?? retryDelayMs(settings, session._retryAttempt),\n\t\tsettings.maxAgentDelayMs,\n\t);\n\tconst delayMs = Math.round(baseDelayMs * (0.9 + Math.random() * 0.2));\n\t// Install the controller before announcing the retry so listeners can cancel\n\t// the pending delay from the auto_retry_start event itself.\n\tsession._retryAbortController = new AbortController();\n\n\tsession._emit({\n\t\ttype: \"auto_retry_start\",\n\t\tattempt: session._retryAttempt,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tdelayMs,\n\t\terrorMessage: message.errorMessage || \"Unknown error\",\n\t});\n\tawait dispatchAutoRetryLifecycle(session, {\n\t\tattempt: session._retryAttempt,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tdelayMs,\n\t\terrorMessage: message.errorMessage || \"Unknown error\",\n\t});\n\n\t// Remove error message from agent state (keep in session for history)\n\tconst messages = session.agent.state.messages;\n\tif (messages.length > 0 && messages[messages.length - 1].role === \"assistant\") {\n\t\tawait session._applyContextTransition(messages.slice(0, -1), \"retry\");\n\t}\n\n\t// Wait with exponential backoff (abortable)\n\ttry {\n\t\tawait sleep(delayMs, session._retryAbortController.signal);\n\t} catch {\n\t\t// Aborted during sleep - emit end event so UI can clean up\n\t\tconst attempt = session._retryAttempt;\n\t\tsession._retryAttempt = 0;\n\t\tsession._emit({\n\t\t\ttype: \"auto_retry_end\",\n\t\t\tsuccess: false,\n\t\t\tattempt,\n\t\t\tfinalError: \"Retry cancelled\",\n\t\t});\n\t\treturn false;\n\t} finally {\n\t\tsession._retryAbortController = undefined;\n\t}\n\n\treturn true;\n}\n"]}

package/dist/core/agent-session-retry.js

@@ -11,6 +11,7 @@ import { retryDelayMs } from "@agent-forge/ai";
 import { sleep } from "../utils/sleep.js";
 import { decideOverflow, executionFacts } from "./agent-session-compaction.js";
 import { dispatchAutoRetryLifecycle } from "./agent-session-lifecycle.js";
+import { t } from "./i18n/index.js";
 export async function willRetryAfterAgentEnd(session, event, signal) {
     if (signal?.aborted) {
         session._pendingRetryDecision = undefined;
@@ -53,7 +54,7 @@ export async function isRetryableError(session, message, execution, signal) {
     const runtime = session._capabilityRuntime;
     // v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在
     if (!runtime)
-        throw new Error("Capability runtime is not available");
+        throw new Error(t("Capability runtime is not available"));
     return runtime.classifyRetry(session._retryPolicyName, {
         message,
         signal,
@@ -66,7 +67,7 @@ export async function decideRetry(session, message, execution, signal) {
     const runtime = session._capabilityRuntime;
     // v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在
     if (!runtime)
-        throw new Error("Capability runtime is not available");
+        throw new Error(t("Capability runtime is not available"));
     return runtime.decideRetry(session._retryPolicyName, {
         retryable: await session._isRetryableError(message, execution, signal),
         enabled: settings.enabled,

package/dist/core/agent-session-retry.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-session-retry.js","sourceRoot":"","sources":["../../src/core/agent-session-retry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Auto-retry and overflow classification for AgentSession.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name private delegates so call sites, dynamic dispatch, and test\n * spies keep working unchanged. Method-to-method calls go through the session\n * parameter (not direct function calls) to preserve that dispatch.\n */\n\nimport type { AgentEvent } from \"@agent-forge/agent-core\";\nimport { retryDelayMs } from \"@agent-forge/ai\";\nimport type { AssistantMessage } from \"@agent-forge/ai/compat\";\nimport { sleep } from \"../utils/sleep.ts\";\nimport { decideOverflow, executionFacts } from \"./agent-session-compaction.ts\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport { dispatchAutoRetryLifecycle } from \"./agent-session-lifecycle.ts\";\nimport type { CapabilityRuntime, ExecutionFactsV1 } from \"./extensions/index.ts\";\n\nexport async function willRetryAfterAgentEnd(\n\tsession: AgentSessionInternals,\n\tevent: Extract<AgentEvent, { type: \"agent_end\" }>,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\tif (signal?.aborted) {\n\t\tsession._pendingRetryDecision = undefined;\n\t\treturn false;\n\t}\n\tconst settings = session.settingsManager.getRetrySettings();\n\tif (session._retryAttempt >= settings.maxRetries) {\n\t\tsession._pendingRetryDecision = undefined;\n\t\treturn false;\n\t}\n\n\tfor (let i = event.messages.length - 1; i >= 0; i--) {\n\t\tconst message = event.messages[i];\n\t\tif (message.role === \"assistant\") {\n\t\t\tconst assistantMessage = message as AssistantMessage;\n\t\t\ttry {\n\t\t\t\tconst decision = await decideRetry(session, assistantMessage, undefined, signal);\n\t\t\t\tsession._pendingRetryDecision = { message: assistantMessage, decision };\n\t\t\t\treturn decision.retry;\n\t\t\t} catch (error) {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\tsession._pendingRetryDecision = undefined;\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\tsession._pendingRetryDecision = undefined;\n\treturn false;\n}\n\n/**\n * Check if an error is retryable (overloaded, rate limit, server errors).\n * Context overflow errors are NOT retryable (handled by compaction instead).\n */\nexport async function isRetryableError(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\texecution?: ExecutionFactsV1,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\t// Context overflow is handled by compaction, not retry.\n\tif ((await decideOverflow(session, message, execution, signal)).contextOverflow) return false;\n\tconst runtime = session._capabilityRuntime;\n\t// v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在\n\tif (!runtime) throw new Error(\"Capability runtime is not available\");\n\treturn runtime.classifyRetry(session._retryPolicyName, {\n\t\tmessage,\n\t\tsignal,\n\t\tcontext: { version: 1, sessionId: session.sessionId, phase: \"retry\" },\n\t\texecution: execution ?? executionFacts(session, \"retry\"),\n\t});\n}\n\nexport async function decideRetry(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\texecution?: ExecutionFactsV1,\n\tsignal?: AbortSignal,\n) {\n\tconst settings = session.settingsManager.getRetrySettings();\n\tconst runtime = session._capabilityRuntime;\n\t// v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在\n\tif (!runtime) throw new Error(\"Capability runtime is not available\");\n\treturn runtime.decideRetry(session._retryPolicyName, {\n\t\tretryable: await session._isRetryableError(message, execution, signal),\n\t\tenabled: settings.enabled,\n\t\tattempt: session._retryAttempt + 1,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tbaseDelayMs: settings.baseDelayMs,\n\t\terrorMessage: message.errorMessage,\n\t\tsignal,\n\t\tcontext: { version: 1, sessionId: session.sessionId, phase: \"retry\" },\n\t\texecution: execution ?? executionFacts(session, \"retry\"),\n\t});\n}\n\n/**\n * Prepare a retryable error for continuation with exponential backoff.\n * @returns true if the caller should continue the agent, false otherwise\n */\nexport async function prepareRetry(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\tprecomputedDecision?: Awaited<ReturnType<CapabilityRuntime[\"decideRetry\"]>>,\n): Promise<boolean> {\n\tconst settings = session.settingsManager.getRetrySettings();\n\tconst decision = precomputedDecision ?? (await decideRetry(session, message));\n\tif (!decision.retry) return false;\n\tsession._retryAttempt++;\n\t// ±10% jitter on the exponential backoff (borrowed from codex's backoff):\n\t// prevents synchronized retry storms when many sessions hit the same outage.\n\t// The effective delay is capped by maxAgentDelayMs before jitter (retryDelayMs\n\t// already caps the exponential path; the min() also clamps policy-provided\n\t// delayMs), so a capped delay can overshoot the cap by at most the jitter band.\n\tconst baseDelayMs = Math.min(\n\t\tdecision.delayMs ?? retryDelayMs(settings, session._retryAttempt),\n\t\tsettings.maxAgentDelayMs,\n\t);\n\tconst delayMs = Math.round(baseDelayMs * (0.9 + Math.random() * 0.2));\n\t// Install the controller before announcing the retry so listeners can cancel\n\t// the pending delay from the auto_retry_start event itself.\n\tsession._retryAbortController = new AbortController();\n\n\tsession._emit({\n\t\ttype: \"auto_retry_start\",\n\t\tattempt: session._retryAttempt,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tdelayMs,\n\t\terrorMessage: message.errorMessage || \"Unknown error\",\n\t});\n\tawait dispatchAutoRetryLifecycle(session, {\n\t\tattempt: session._retryAttempt,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tdelayMs,\n\t\terrorMessage: message.errorMessage || \"Unknown error\",\n\t});\n\n\t// Remove error message from agent state (keep in session for history)\n\tconst messages = session.agent.state.messages;\n\tif (messages.length > 0 && messages[messages.length - 1].role === \"assistant\") {\n\t\tawait session._applyContextTransition(messages.slice(0, -1), \"retry\");\n\t}\n\n\t// Wait with exponential backoff (abortable)\n\ttry {\n\t\tawait sleep(delayMs, session._retryAbortController.signal);\n\t} catch {\n\t\t// Aborted during sleep - emit end event so UI can clean up\n\t\tconst attempt = session._retryAttempt;\n\t\tsession._retryAttempt = 0;\n\t\tsession._emit({\n\t\t\ttype: \"auto_retry_end\",\n\t\t\tsuccess: false,\n\t\t\tattempt,\n\t\t\tfinalError: \"Retry cancelled\",\n\t\t});\n\t\treturn false;\n\t} finally {\n\t\tsession._retryAbortController = undefined;\n\t}\n\n\treturn true;\n}\n"]}
+{"version":3,"file":"agent-session-retry.js","sourceRoot":"","sources":["../../src/core/agent-session-retry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Auto-retry and overflow classification for AgentSession.\n *\n * Extracted from `agent-session.ts`. Every function here operates on the\n * internal session facade ({@link AgentSessionInternals}); `AgentSession`\n * keeps same-name private delegates so call sites, dynamic dispatch, and test\n * spies keep working unchanged. Method-to-method calls go through the session\n * parameter (not direct function calls) to preserve that dispatch.\n */\n\nimport type { AgentEvent } from \"@agent-forge/agent-core\";\nimport { retryDelayMs } from \"@agent-forge/ai\";\nimport type { AssistantMessage } from \"@agent-forge/ai/compat\";\nimport { sleep } from \"../utils/sleep.ts\";\nimport { decideOverflow, executionFacts } from \"./agent-session-compaction.ts\";\nimport type { AgentSessionInternals } from \"./agent-session-internal.ts\";\nimport { dispatchAutoRetryLifecycle } from \"./agent-session-lifecycle.ts\";\nimport type { CapabilityRuntime, ExecutionFactsV1 } from \"./extensions/index.ts\";\nimport { t } from \"./i18n/index.ts\";\n\nexport async function willRetryAfterAgentEnd(\n\tsession: AgentSessionInternals,\n\tevent: Extract<AgentEvent, { type: \"agent_end\" }>,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\tif (signal?.aborted) {\n\t\tsession._pendingRetryDecision = undefined;\n\t\treturn false;\n\t}\n\tconst settings = session.settingsManager.getRetrySettings();\n\tif (session._retryAttempt >= settings.maxRetries) {\n\t\tsession._pendingRetryDecision = undefined;\n\t\treturn false;\n\t}\n\n\tfor (let i = event.messages.length - 1; i >= 0; i--) {\n\t\tconst message = event.messages[i];\n\t\tif (message.role === \"assistant\") {\n\t\t\tconst assistantMessage = message as AssistantMessage;\n\t\t\ttry {\n\t\t\t\tconst decision = await decideRetry(session, assistantMessage, undefined, signal);\n\t\t\t\tsession._pendingRetryDecision = { message: assistantMessage, decision };\n\t\t\t\treturn decision.retry;\n\t\t\t} catch (error) {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\tsession._pendingRetryDecision = undefined;\n\t\t\t\t\treturn false;\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t}\n\t}\n\tsession._pendingRetryDecision = undefined;\n\treturn false;\n}\n\n/**\n * Check if an error is retryable (overloaded, rate limit, server errors).\n * Context overflow errors are NOT retryable (handled by compaction instead).\n */\nexport async function isRetryableError(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\texecution?: ExecutionFactsV1,\n\tsignal?: AbortSignal,\n): Promise<boolean> {\n\t// Context overflow is handled by compaction, not retry.\n\tif ((await decideOverflow(session, message, execution, signal)).contextOverflow) return false;\n\tconst runtime = session._capabilityRuntime;\n\t// v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在\n\tif (!runtime) throw new Error(t(\"Capability runtime is not available\"));\n\treturn runtime.classifyRetry(session._retryPolicyName, {\n\t\tmessage,\n\t\tsignal,\n\t\tcontext: { version: 1, sessionId: session.sessionId, phase: \"retry\" },\n\t\texecution: execution ?? executionFacts(session, \"retry\"),\n\t});\n}\n\nexport async function decideRetry(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\texecution?: ExecutionFactsV1,\n\tsignal?: AbortSignal,\n) {\n\tconst settings = session.settingsManager.getRetrySettings();\n\tconst runtime = session._capabilityRuntime;\n\t// v8 ignore next -- capability runtime 恒由 _buildRuntime 创建，dispose 后不再调用，运行期恒存在\n\tif (!runtime) throw new Error(t(\"Capability runtime is not available\"));\n\treturn runtime.decideRetry(session._retryPolicyName, {\n\t\tretryable: await session._isRetryableError(message, execution, signal),\n\t\tenabled: settings.enabled,\n\t\tattempt: session._retryAttempt + 1,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tbaseDelayMs: settings.baseDelayMs,\n\t\terrorMessage: message.errorMessage,\n\t\tsignal,\n\t\tcontext: { version: 1, sessionId: session.sessionId, phase: \"retry\" },\n\t\texecution: execution ?? executionFacts(session, \"retry\"),\n\t});\n}\n\n/**\n * Prepare a retryable error for continuation with exponential backoff.\n * @returns true if the caller should continue the agent, false otherwise\n */\nexport async function prepareRetry(\n\tsession: AgentSessionInternals,\n\tmessage: AssistantMessage,\n\tprecomputedDecision?: Awaited<ReturnType<CapabilityRuntime[\"decideRetry\"]>>,\n): Promise<boolean> {\n\tconst settings = session.settingsManager.getRetrySettings();\n\tconst decision = precomputedDecision ?? (await decideRetry(session, message));\n\tif (!decision.retry) return false;\n\tsession._retryAttempt++;\n\t// ±10% jitter on the exponential backoff (borrowed from codex's backoff):\n\t// prevents synchronized retry storms when many sessions hit the same outage.\n\t// The effective delay is capped by maxAgentDelayMs before jitter (retryDelayMs\n\t// already caps the exponential path; the min() also clamps policy-provided\n\t// delayMs), so a capped delay can overshoot the cap by at most the jitter band.\n\tconst baseDelayMs = Math.min(\n\t\tdecision.delayMs ?? retryDelayMs(settings, session._retryAttempt),\n\t\tsettings.maxAgentDelayMs,\n\t);\n\tconst delayMs = Math.round(baseDelayMs * (0.9 + Math.random() * 0.2));\n\t// Install the controller before announcing the retry so listeners can cancel\n\t// the pending delay from the auto_retry_start event itself.\n\tsession._retryAbortController = new AbortController();\n\n\tsession._emit({\n\t\ttype: \"auto_retry_start\",\n\t\tattempt: session._retryAttempt,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tdelayMs,\n\t\terrorMessage: message.errorMessage || \"Unknown error\",\n\t});\n\tawait dispatchAutoRetryLifecycle(session, {\n\t\tattempt: session._retryAttempt,\n\t\tmaxAttempts: settings.maxRetries,\n\t\tdelayMs,\n\t\terrorMessage: message.errorMessage || \"Unknown error\",\n\t});\n\n\t// Remove error message from agent state (keep in session for history)\n\tconst messages = session.agent.state.messages;\n\tif (messages.length > 0 && messages[messages.length - 1].role === \"assistant\") {\n\t\tawait session._applyContextTransition(messages.slice(0, -1), \"retry\");\n\t}\n\n\t// Wait with exponential backoff (abortable)\n\ttry {\n\t\tawait sleep(delayMs, session._retryAbortController.signal);\n\t} catch {\n\t\t// Aborted during sleep - emit end event so UI can clean up\n\t\tconst attempt = session._retryAttempt;\n\t\tsession._retryAttempt = 0;\n\t\tsession._emit({\n\t\t\ttype: \"auto_retry_end\",\n\t\t\tsuccess: false,\n\t\t\tattempt,\n\t\t\tfinalError: \"Retry cancelled\",\n\t\t});\n\t\treturn false;\n\t} finally {\n\t\tsession._retryAbortController = undefined;\n\t}\n\n\treturn true;\n}\n"]}