npm - @leanandmean/agent - Versions diffs - 0.74.1-scramjet.21 → 0.74.1-scramjet.23 - Mend

@leanandmean/agent 0.74.1-scramjet.21 → 0.74.1-scramjet.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/agent.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype AssistantMessage,\n\ttype ImageContent,\n\ttype Message,\n\ttype Model,\n\ttype SimpleStreamOptions,\n\tstreamSimple,\n\ttype TextContent,\n\ttype ThinkingBudgets,\n\ttype Transport,\n} from \"@leanandmean/ai\";\nimport { executeHarnessToolCall, runAgentLoop, runAgentLoopContinue } from \"./agent-loop.js\";\nimport type {\n\tAfterToolCallContext,\n\tAfterToolCallResult,\n\tAgentContext,\n\tAgentEvent,\n\tAgentLoopConfig,\n\tAgentLoopTurnUpdate,\n\tAgentMessage,\n\tAgentState,\n\tAgentTool,\n\tAgentToolCall,\n\tBeforeToolBatchContext,\n\tBeforeToolCallContext,\n\tBeforeToolCallResult,\n\tPrepareNextTurnContext,\n\tQueueMode,\n\tStreamFn,\n\tToolExecutionMode,\n} from \"./types.js\";\n\nexport type { QueueMode } from \"./types.js\";\n\nfunction defaultConvertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages.filter(\n\t\t(message) => message.role === \"user\" \|\| message.role === \"assistant\" \|\| message.role === \"toolResult\",\n\t);\n}\n\nconst EMPTY_USAGE = {\n\tinput: 0,\n\toutput: 0,\n\tcacheRead: 0,\n\tcacheWrite: 0,\n\ttotalTokens: 0,\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n};\n\nconst DEFAULT_MODEL = {\n\tid: \"unknown\",\n\tname: \"unknown\",\n\tapi: \"unknown\",\n\tprovider: \"unknown\",\n\tbaseUrl: \"\",\n\treasoning: false,\n\tinput: [],\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\tcontextWindow: 0,\n\tmaxTokens: 0,\n} satisfies Model<any>;\n\n// SCRAMJET-DIVERGENCE: provider-safe tool-call id generation for harness-originated calls (#244).\n// The id must satisfy every provider's constraint (Anthropic's `^[a-zA-Z0-9_-]+$`, bounded length)\n// and must never embed raw model ids. A random suffix (not a bare counter) avoids collisions with\n// ids already present in a resumed transcript.\nexport function generateHarnessToolCallId(): string {\n\tconst uuid = globalThis.crypto?.randomUUID?.();\n\tconst suffix = uuid\n\t\t? uuid.replace(/-/g, \"\")\n\t\t: `${Date.now().toString(36)}${Math.floor(Math.random() * 1e9).toString(36)}`;\n\treturn `harness-tool-${suffix}`.slice(0, 64);\n}\n\ntype MutableAgentState = Omit<AgentState, \"isStreaming\" \| \"streamingMessage\" \| \"pendingToolCalls\" \| \"errorMessage\"> & {\n\tisStreaming: boolean;\n\tstreamingMessage?: AgentMessage;\n\tpendingToolCalls: Set<string>;\n\terrorMessage?: string;\n};\n\nfunction createMutableAgentState(\n\tinitialState?: Partial<Omit<AgentState, \"pendingToolCalls\" \| \"isStreaming\" \| \"streamingMessage\" \| \"errorMessage\">>,\n): MutableAgentState {\n\tlet tools = initialState?.tools?.slice() ?? [];\n\tlet messages = initialState?.messages?.slice() ?? [];\n\n\treturn {\n\t\tsystemPrompt: initialState?.systemPrompt ?? \"\",\n\t\tmodel: initialState?.model ?? DEFAULT_MODEL,\n\t\tthinkingLevel: initialState?.thinkingLevel ?? \"off\",\n\t\tget tools() {\n\t\t\treturn tools;\n\t\t},\n\t\tset tools(nextTools: AgentTool<any>[]) {\n\t\t\ttools = nextTools.slice();\n\t\t},\n\t\tget messages() {\n\t\t\treturn messages;\n\t\t},\n\t\tset messages(nextMessages: AgentMessage[]) {\n\t\t\tmessages = nextMessages.slice();\n\t\t},\n\t\tisStreaming: false,\n\t\tstreamingMessage: undefined,\n\t\tpendingToolCalls: new Set<string>(),\n\t\terrorMessage: undefined,\n\t};\n}\n\n/** Options for constructing an {@link Agent}. /\nexport interface AgentOptions {\n\tinitialState?: Partial<Omit<AgentState, \"pendingToolCalls\" \| \"isStreaming\" \| \"streamingMessage\" \| \"errorMessage\">>;\n\tconvertToLlm?: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tbeforeProviderCall?: AgentLoopConfig[\"beforeProviderCall\"];\n\tstreamFn?: StreamFn;\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tonPayload?: SimpleStreamOptions[\"onPayload\"];\n\tonResponse?: SimpleStreamOptions[\"onResponse\"];\n\tbeforeToolBatch?: (context: BeforeToolBatchContext, signal?: AbortSignal) => Promise<void>;\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\t// SCRAMJET-DIVERGENCE: prepareNextTurn receives the live turn context (previously the loop\n\t// context it passes was discarded by the Agent adapter) (#244).\n\tprepareNextTurn?: (\n\t\tctx: PrepareNextTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentLoopTurnUpdate \| undefined> \| AgentLoopTurnUpdate \| undefined;\n\tsteeringMode?: QueueMode;\n\tfollowUpMode?: QueueMode;\n\tsessionId?: string;\n\tthinkingBudgets?: ThinkingBudgets;\n\ttransport?: Transport;\n\tmaxRetryDelayMs?: number;\n\ttoolExecution?: ToolExecutionMode;\n}\n\nclass PendingMessageQueue {\n\tprivate messages: AgentMessage[] = [];\n\n\tconstructor(public mode: QueueMode) {}\n\n\tenqueue(message: AgentMessage): void {\n\t\tthis.messages.push(message);\n\t}\n\n\thasItems(): boolean {\n\t\treturn this.messages.length > 0;\n\t}\n\n\tdrain(): AgentMessage[] {\n\t\tif (this.mode === \"all\") {\n\t\t\tconst drained = this.messages.slice();\n\t\t\tthis.messages = [];\n\t\t\treturn drained;\n\t\t}\n\n\t\tconst first = this.messages[0];\n\t\tif (!first) {\n\t\t\treturn [];\n\t\t}\n\t\tthis.messages = this.messages.slice(1);\n\t\treturn [first];\n\t}\n\n\tclear(): void {\n\t\tthis.messages = [];\n\t}\n}\n\ntype ActiveRun = {\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\tabortController: AbortController;\n};\n\n// SCRAMJET-DIVERGENCE: harness-tool-invocation settlement records (#341).\n/\n One harness-tool invocation and the deferred promise that `runHarnessTool` returns for it. The\n * promise settles only when the invocation's Agent-core pipeline completes (resolve) or when\n * reset/teardown revokes the invocation or an infrastructure failure escapes the pipeline (reject).\n /\ntype HarnessToolInvocation = {\n\ttool: AgentTool<any>;\n\targs: unknown;\n\ttoolCallId: string;\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\treject: (reason: Error) => void;\n};\n\n/\n Stateful wrapper around the low-level agent loop.\n \n `Agent` owns the current transcript, emits lifecycle events, executes tools,\n * and exposes queueing APIs for steering and follow-up messages.\n /\nexport class Agent {\n\tprivate _state: MutableAgentState;\n\tprivate readonly listeners = new Set<(event: AgentEvent, signal: AbortSignal) => Promise<void> \| void>();\n\tprivate readonly steeringQueue: PendingMessageQueue;\n\tprivate readonly followUpQueue: PendingMessageQueue;\n\n\tpublic convertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\tpublic transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tpublic beforeProviderCall?: AgentLoopConfig[\"beforeProviderCall\"];\n\tpublic streamFn: StreamFn;\n\tpublic getApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tpublic onPayload?: SimpleStreamOptions[\"onPayload\"];\n\tpublic onResponse?: SimpleStreamOptions[\"onResponse\"];\n\t// SCRAMJET-DIVERGENCE: beforeToolBatch hook — async message_end mutations must settle before tool-call extraction\n\tpublic beforeToolBatch?: (context: BeforeToolBatchContext, signal?: AbortSignal) => Promise<void>;\n\tpublic beforeToolCall?: (\n\t\tcontext: BeforeToolCallContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<BeforeToolCallResult \| undefined>;\n\tpublic afterToolCall?: (\n\t\tcontext: AfterToolCallContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AfterToolCallResult \| undefined>;\n\tpublic prepareNextTurn?: (\n\t\tctx: PrepareNextTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentLoopTurnUpdate \| undefined> \| AgentLoopTurnUpdate \| undefined;\n\tprivate activeRun?: ActiveRun;\n\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive state (#244, settlement #341).\n\t/* Harness tool invocations queued while a run is active, drained at the next turn boundary. /\n\tprivate readonly harnessToolQueue: HarnessToolInvocation[] = [];\n\t/\n\t Every harness-tool invocation whose public promise has not yet settled — queued, shifted and\n\t * draining, or transient. Reset/teardown rejects this set; each invocation is removed as it\n\t * settles. Queue length is not a proxy for this: a draining call has left the queue but is still\n\t * unsettled (#341).\n\t /\n\tprivate readonly unsettledHarnessTools = new Set<HarnessToolInvocation>();\n\t/\n\t Markers for in-flight transient (idle) harness-tool runs; each resolves when its run settles.\n\t * A set (not a single field) keeps nested and overlapping transient runs valid, and lets a new\n\t * real run wait for transient work to finish before emitting its own events.\n\t /\n\tprivate readonly transientRuns = new Set<Promise<void>>();\n\t/* Shared, never-aborted signal delivered to listeners during transient harness-tool runs. /\n\tprivate readonly transientRunAbort = new AbortController();\n\t/* Session identifier forwarded to providers for cache-aware backends. /\n\tpublic sessionId?: string;\n\t/* Optional per-level thinking token budgets forwarded to the stream function. /\n\tpublic thinkingBudgets?: ThinkingBudgets;\n\t/* Preferred transport forwarded to the stream function. /\n\tpublic transport: Transport;\n\t/* Optional cap for provider-requested retry delays. /\n\tpublic maxRetryDelayMs?: number;\n\t/* Tool execution strategy for assistant messages that contain multiple tool calls. /\n\tpublic toolExecution: ToolExecutionMode;\n\n\tconstructor(options: AgentOptions = {}) {\n\t\tthis._state = createMutableAgentState(options.initialState);\n\t\tthis.convertToLlm = options.convertToLlm ?? defaultConvertToLlm;\n\t\tthis.transformContext = options.transformContext;\n\t\tthis.beforeProviderCall = options.beforeProviderCall;\n\t\tthis.streamFn = options.streamFn ?? streamSimple;\n\t\tthis.getApiKey = options.getApiKey;\n\t\tthis.onPayload = options.onPayload;\n\t\tthis.onResponse = options.onResponse;\n\t\tthis.beforeToolBatch = options.beforeToolBatch;\n\t\tthis.beforeToolCall = options.beforeToolCall;\n\t\tthis.afterToolCall = options.afterToolCall;\n\t\tthis.prepareNextTurn = options.prepareNextTurn;\n\t\tthis.steeringQueue = new PendingMessageQueue(options.steeringMode ?? \"one-at-a-time\");\n\t\tthis.followUpQueue = new PendingMessageQueue(options.followUpMode ?? \"one-at-a-time\");\n\t\tthis.sessionId = options.sessionId;\n\t\tthis.thinkingBudgets = options.thinkingBudgets;\n\t\tthis.transport = options.transport ?? \"auto\";\n\t\tthis.maxRetryDelayMs = options.maxRetryDelayMs;\n\t\tthis.toolExecution = options.toolExecution ?? \"parallel\";\n\t}\n\n\t/\n\t Subscribe to agent lifecycle events.\n\t \n\t Listener promises are awaited in subscription order and are included in\n\t * the current run's settlement. Listeners also receive the active abort\n\t * signal for the current run.\n\t \n\t `agent_end` is the final emitted event for a run, but the agent does not\n\t * become idle until all awaited listeners for that event have settled.\n\t /\n\tsubscribe(listener: (event: AgentEvent, signal: AbortSignal) => Promise<void> \| void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => this.listeners.delete(listener);\n\t}\n\n\t/\n\t Current agent state.\n\t \n\t Assigning `state.tools` or `state.messages` copies the provided top-level array.\n\t /\n\tget state(): AgentState {\n\t\treturn this._state;\n\t}\n\n\t/* Controls how queued steering messages are drained. /\n\tset steeringMode(mode: QueueMode) {\n\t\tthis.steeringQueue.mode = mode;\n\t}\n\n\tget steeringMode(): QueueMode {\n\t\treturn this.steeringQueue.mode;\n\t}\n\n\t/* Controls how queued follow-up messages are drained. /\n\tset followUpMode(mode: QueueMode) {\n\t\tthis.followUpQueue.mode = mode;\n\t}\n\n\tget followUpMode(): QueueMode {\n\t\treturn this.followUpQueue.mode;\n\t}\n\n\t/* Queue a message to be injected after the current assistant turn finishes. /\n\tsteer(message: AgentMessage): void {\n\t\tthis.steeringQueue.enqueue(message);\n\t}\n\n\t/* Queue a message to run only after the agent would otherwise stop. /\n\tfollowUp(message: AgentMessage): void {\n\t\tthis.followUpQueue.enqueue(message);\n\t}\n\n\t/* Remove all queued steering messages. /\n\tclearSteeringQueue(): void {\n\t\tthis.steeringQueue.clear();\n\t}\n\n\t/* Remove all queued follow-up messages. /\n\tclearFollowUpQueue(): void {\n\t\tthis.followUpQueue.clear();\n\t}\n\n\t/* Remove all queued steering and follow-up messages. /\n\tclearAllQueues(): void {\n\t\tthis.clearSteeringQueue();\n\t\tthis.clearFollowUpQueue();\n\t}\n\n\t/* Returns true when either queue still contains pending messages. /\n\thasQueuedMessages(): boolean {\n\t\treturn this.steeringQueue.hasItems() \|\| this.followUpQueue.hasItems();\n\t}\n\n\t/* Active abort signal for the current run, if any. /\n\tget signal(): AbortSignal \| undefined {\n\t\treturn this.activeRun?.abortController.signal;\n\t}\n\n\t/* Abort the current run, if one is active. /\n\tabort(): void {\n\t\tthis.activeRun?.abortController.abort();\n\t}\n\n\t/\n\t Resolve when the current run and all awaited event listeners have finished.\n\t \n\t This resolves after `agent_end` listeners settle.\n\t /\n\twaitForIdle(): Promise<void> {\n\t\treturn this.activeRun?.promise ?? Promise.resolve();\n\t}\n\n\t/* Clear transcript state, runtime state, and queued messages. /\n\treset(): void {\n\t\tthis._state.messages = [];\n\t\tthis._state.isStreaming = false;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.pendingToolCalls = new Set<string>();\n\t\tthis._state.errorMessage = undefined;\n\t\tthis.clearFollowUpQueue();\n\t\tthis.clearSteeringQueue();\n\t\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive (#244, settlement #341). reset()\n\t\t// rejects the public promise of every unsettled harness invocation so awaiting callers stop\n\t\t// waiting. The effect on the record row differs by kind: a queued (not-yet-draining) call loses\n\t\t// its row entirely, while a transient in-flight call keeps running — reset() does not abort\n\t\t// transientRunAbort — so its row is still emitted and persisted; only its promise is rejected.\n\t\t// The warning surfaces the rejection so a lost queued row is diagnosable.\n\t\tif (this.unsettledHarnessTools.size > 0) {\n\t\t\tconst names = [...this.unsettledHarnessTools].map((record) => record.tool.name).join(\", \");\n\t\t\tconsole.warn(\n\t\t\t\t`Agent.reset() rejected ${this.unsettledHarnessTools.size} unsettled harness tool call(s): ${names}`,\n\t\t\t);\n\t\t}\n\t\tthis.rejectUnsettledHarnessTools(new Error(\"Agent.reset() discarded unsettled harness tool call\"));\n\t}\n\n\t/* Start a new prompt from text, a single message, or a batch of messages. /\n\tasync prompt(message: AgentMessage \| AgentMessage[]): Promise<void>;\n\tasync prompt(input: string, images?: ImageContent[]): Promise<void>;\n\tasync prompt(input: string \| AgentMessage \| AgentMessage[], images?: ImageContent[]): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\n\t\t\t\t\"Agent is already processing a prompt. Use steer() or followUp() to queue messages, or wait for completion.\",\n\t\t\t);\n\t\t}\n\t\tconst messages = this.normalizePromptInput(input, images);\n\t\tawait this.runPromptMessages(messages);\n\t}\n\n\t/* Continue from the current transcript. The last message must be a user or tool-result message. /\n\tasync continue(): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\"Agent is already processing. Wait for completion before continuing.\");\n\t\t}\n\n\t\tconst lastMessage = this._state.messages[this._state.messages.length - 1];\n\t\tif (!lastMessage) {\n\t\t\tthrow new Error(\"No messages to continue from\");\n\t\t}\n\n\t\tif (lastMessage.role === \"assistant\") {\n\t\t\tconst queuedSteering = this.steeringQueue.drain();\n\t\t\tif (queuedSteering.length > 0) {\n\t\t\t\tawait this.runPromptMessages(queuedSteering, { skipInitialSteeringPoll: true });\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst queuedFollowUps = this.followUpQueue.drain();\n\t\t\tif (queuedFollowUps.length > 0) {\n\t\t\t\tawait this.runPromptMessages(queuedFollowUps);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new Error(\"Cannot continue from message role: assistant\");\n\t\t}\n\n\t\tawait this.runContinuation();\n\t}\n\n\tprivate normalizePromptInput(\n\t\tinput: string \| AgentMessage \| AgentMessage[],\n\t\timages?: ImageContent[],\n\t): AgentMessage[] {\n\t\tif (Array.isArray(input)) {\n\t\t\treturn input;\n\t\t}\n\n\t\tif (typeof input !== \"string\") {\n\t\t\treturn [input];\n\t\t}\n\n\t\tconst content: Array<TextContent \| ImageContent> = [{ type: \"text\", text: input }];\n\t\tif (images && images.length > 0) {\n\t\t\tcontent.push(...images);\n\t\t}\n\t\treturn [{ role: \"user\", content, timestamp: Date.now() }];\n\t}\n\n\tprivate async runPromptMessages(\n\t\tmessages: AgentMessage[],\n\t\toptions: { skipInitialSteeringPoll?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.runWithLifecycle(async (signal) => {\n\t\t\tawait runAgentLoop(\n\t\t\t\tmessages,\n\t\t\t\tthis.createContextSnapshot(),\n\t\t\t\tthis.createLoopConfig(options),\n\t\t\t\t(event) => this.processEvents(event),\n\t\t\t\tsignal,\n\t\t\t\tthis.streamFn,\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate async runContinuation(): Promise<void> {\n\t\tawait this.runWithLifecycle(async (signal) => {\n\t\t\tawait runAgentLoopContinue(\n\t\t\t\tthis.createContextSnapshot(),\n\t\t\t\tthis.createLoopConfig(),\n\t\t\t\t(event) => this.processEvents(event),\n\t\t\t\tsignal,\n\t\t\t\tthis.streamFn,\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate createContextSnapshot(): AgentContext {\n\t\treturn {\n\t\t\tsystemPrompt: this._state.systemPrompt,\n\t\t\tmessages: this._state.messages.slice(),\n\t\t\ttools: this._state.tools.slice(),\n\t\t};\n\t}\n\n\tprivate createLoopConfig(options: { skipInitialSteeringPoll?: boolean } = {}): AgentLoopConfig {\n\t\tlet skipInitialSteeringPoll = options.skipInitialSteeringPoll === true;\n\t\treturn {\n\t\t\tmodel: this._state.model,\n\t\t\treasoning: this._state.thinkingLevel === \"off\" ? undefined : this._state.thinkingLevel,\n\t\t\tsessionId: this.sessionId,\n\t\t\tonPayload: this.onPayload,\n\t\t\tonResponse: this.onResponse,\n\t\t\ttransport: this.transport,\n\t\t\tthinkingBudgets: this.thinkingBudgets,\n\t\t\tmaxRetryDelayMs: this.maxRetryDelayMs,\n\t\t\ttoolExecution: this.toolExecution,\n\t\t\tbeforeToolBatch: this.beforeToolBatch,\n\t\t\tbeforeToolCall: this.beforeToolCall,\n\t\t\tafterToolCall: this.afterToolCall,\n\t\t\t// SCRAMJET-DIVERGENCE: always run prepareNextTurn so mid-run harness tool calls drain\n\t\t\t// before the next LLM call and live model/effort changes self-heal without overriding\n\t\t\t// explicit callback updates (#244, #447).\n\t\t\tprepareNextTurn: async (ctx) => {\n\t\t\t\tawait this.drainHarnessToolQueue(ctx, this.signal);\n\t\t\t\tconst update = await this.prepareNextTurn?.(ctx, this.signal);\n\t\t\t\treturn {\n\t\t\t\t\t...update,\n\t\t\t\t\tmodel: update?.model ?? this._state.model,\n\t\t\t\t\tthinkingLevel: update?.thinkingLevel ?? this._state.thinkingLevel,\n\t\t\t\t};\n\t\t\t},\n\t\t\tconvertToLlm: this.convertToLlm,\n\t\t\ttransformContext: this.transformContext,\n\t\t\tbeforeProviderCall: this.beforeProviderCall,\n\t\t\tgetApiKey: this.getApiKey,\n\t\t\tgetSteeringMessages: async () => {\n\t\t\t\tif (skipInitialSteeringPoll) {\n\t\t\t\t\tskipInitialSteeringPoll = false;\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t\treturn this.steeringQueue.drain();\n\t\t\t},\n\t\t\tgetFollowUpMessages: async () => this.followUpQueue.drain(),\n\t\t};\n\t}\n\n\tprivate async runWithLifecycle(executor: (signal: AbortSignal) => Promise<void>): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\"Agent is already processing.\");\n\t\t}\n\n\t\tconst abortController = new AbortController();\n\t\tlet resolvePromise = () => {};\n\t\tconst promise = new Promise<void>((resolve) => {\n\t\t\tresolvePromise = resolve;\n\t\t});\n\t\tthis.activeRun = { promise, resolve: resolvePromise, abortController };\n\n\t\tthis._state.isStreaming = true;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.errorMessage = undefined;\n\n\t\t// SCRAMJET-DIVERGENCE (#341): a failed final flush leaves later queued calls unable to execute.\n\t\t// Capture it (rejecting remnants below) and re-throw after finishRun so the error propagates out\n\t\t// of prompt()/continue() — not activeRun.promise, which finishRun always resolves — without a\n\t\t// lint-flagged throw inside a finally block. The { error } wrapper (not a bare `unknown` field)\n\t\t// is deliberate: it distinguishes \"no drain error\" from a falsy throw (e.g. `throw undefined`),\n\t\t// which a `!== undefined` check on a bare field would silently swallow.\n\t\tlet finalDrainError: { error: unknown } \| undefined;\n\t\ttry {\n\t\t\t// Wait for in-flight transient harness-tool runs so their events do not interleave\n\t\t\t// with this run's transcript.\n\t\t\twhile (this.transientRuns.size > 0) {\n\t\t\t\tawait Promise.all(this.transientRuns);\n\t\t\t}\n\t\t\tawait executor(abortController.signal);\n\t\t} catch (error) {\n\t\t\tawait this.handleRunFailure(error, abortController.signal.aborted);\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\t// Flush harness tool calls queued during the run's final turn — including failed or\n\t\t\t\t// aborted runs — after the last prepareNextTurn drain point, so a queued call is\n\t\t\t\t// never stranded. Emits messages/tool events but no run framing.\n\t\t\t\tawait this.drainHarnessToolQueue(undefined, abortController.signal);\n\t\t\t} catch (drainError) {\n\t\t\t\t// The failing call was already rejected by executeHarnessInvocation; reject the\n\t\t\t\t// remnants too so their promises settle.\n\t\t\t\tthis.rejectUnsettledHarnessTools(drainError instanceof Error ? drainError : new Error(String(drainError)));\n\t\t\t\tfinalDrainError = { error: drainError };\n\t\t\t} finally {\n\t\t\t\tthis.finishRun();\n\t\t\t}\n\t\t}\n\t\tif (finalDrainError) {\n\t\t\tthrow finalDrainError.error;\n\t\t}\n\t}\n\n\tprivate async handleRunFailure(error: unknown, aborted: boolean): Promise<void> {\n\t\tconst failureMessage = {\n\t\t\trole: \"assistant\",\n\t\t\torigin: \"harness\",\n\t\t\tcontent: [{ type: \"text\", text: \"\" }],\n\t\t\tapi: this._state.model.api,\n\t\t\tprovider: this._state.model.provider,\n\t\t\tmodel: this._state.model.id,\n\t\t\tusage: EMPTY_USAGE,\n\t\t\tstopReason: aborted ? \"aborted\" : \"error\",\n\t\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\t\ttimestamp: Date.now(),\n\t\t} satisfies AgentMessage;\n\t\tawait this.processEvents({ type: \"message_start\", message: failureMessage });\n\t\tawait this.processEvents({ type: \"message_end\", message: failureMessage });\n\t\tawait this.processEvents({ type: \"turn_end\", message: failureMessage, toolResults: [] });\n\t\tawait this.processEvents({ type: \"agent_end\", messages: [failureMessage] });\n\t}\n\n\tprivate finishRun(): void {\n\t\tthis._state.isStreaming = false;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.pendingToolCalls = new Set<string>();\n\t\tthis.activeRun?.resolve();\n\t\tthis.activeRun = undefined;\n\t}\n\n\t/\n\t Reduce internal state for a loop event, then await listeners.\n\t \n\t `agent_end` only means no further loop events will be emitted. The run is\n\t * considered idle later, after all awaited listeners for `agent_end` finish\n\t * and `finishRun()` clears runtime-owned state.\n\t /\n\tprivate async processEvents(event: AgentEvent): Promise<void> {\n\t\tswitch (event.type) {\n\t\t\tcase \"message_start\":\n\t\t\t\tthis._state.streamingMessage = event.message;\n\t\t\t\tbreak;\n\n\t\t\tcase \"message_update\":\n\t\t\t\tthis._state.streamingMessage = event.message;\n\t\t\t\tbreak;\n\n\t\t\tcase \"message_end\":\n\t\t\t\tthis._state.streamingMessage = undefined;\n\t\t\t\tthis._state.messages.push(event.message);\n\t\t\t\tbreak;\n\n\t\t\tcase \"tool_execution_start\": {\n\t\t\t\tconst pendingToolCalls = new Set(this._state.pendingToolCalls);\n\t\t\t\tpendingToolCalls.add(event.toolCallId);\n\t\t\t\tthis._state.pendingToolCalls = pendingToolCalls;\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"tool_execution_end\": {\n\t\t\t\tconst pendingToolCalls = new Set(this._state.pendingToolCalls);\n\t\t\t\tpendingToolCalls.delete(event.toolCallId);\n\t\t\t\tthis._state.pendingToolCalls = pendingToolCalls;\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"turn_end\":\n\t\t\t\tif (event.message.role === \"assistant\" && event.message.errorMessage) {\n\t\t\t\t\tthis._state.errorMessage = event.message.errorMessage;\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"agent_end\":\n\t\t\t\tthis._state.streamingMessage = undefined;\n\t\t\t\tbreak;\n\t\t}\n\n\t\t// SCRAMJET-DIVERGENCE: fall back to the shared transient-run signal while transient\n\t\t// harness-tool work (which intentionally has no `activeRun`) is in flight (#244).\n\t\tconst signal =\n\t\t\tthis.activeRun?.abortController.signal ??\n\t\t\t(this.transientRuns.size > 0 ? this.transientRunAbort.signal : undefined);\n\t\tif (!signal) {\n\t\t\tthrow new Error(\"Agent listener invoked outside active run\");\n\t\t}\n\t\tfor (const listener of this.listeners) {\n\t\t\tawait listener(event, signal);\n\t\t}\n\t}\n\n\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive (#244, execution settlement #341).\n\t/\n\t Execute a harness-originated tool call through the real execution pipeline.\n\t \n\t The tool object is supplied directly, so it need not appear in `state.tools` — this is what\n\t * lets LLM-invisible harness tools execute. The call produces the same `tool_execution_` and\n\t message events, persisted messages, and `beforeToolCall`/`afterToolCall` invocations as a\n\t * normal tool execution, but emits no run/turn framing events (`agent_start`, `turn_start`,\n\t * `turn_end`, `agent_end`). It is therefore intentionally invisible to every `agent_end`-keyed\n\t * consumer (probe scheduling, compaction bookkeeping).\n\t \n\t When idle, the call executes immediately in a transient run scope. When a run is active, it is\n\t * queued and drained at the next turn boundary — before the next intra-run LLM call — with an\n\t * end-of-run flush for calls queued during the run's final turn, so a queued call is never stranded.\n\t \n\t Settlement (#341). The returned promise resolves only after the call's full Agent-core\n\t * pipeline finishes: the synthetic assistant tool-call message, tool prepare/execute/finalize, the\n\t * tool-result message, Agent state reduction, and every awaited listener for those events. A queued\n\t * call therefore does not resolve at enqueue time — it resolves when the drain executes it. The\n\t * promise rejects when reset or session teardown revokes an unsettled invocation, when an\n\t * infrastructure/listener/hook failure escapes the pipeline, or when a failed final drain leaves a\n\t * later queued call unable to execute. A tool's own `execute()` throwing is not a rejection: it\n\t * becomes a normal `isError: true` tool result, so the promise resolves after that error-result\n\t * pipeline completes. Rejection means the promised pipeline did not complete — it does not prove\n\t * artifact absence (state and persistence may have partially completed), so callers must not blindly\n\t * retry.\n\t \n\t This settles Agent-core execution only. It does not prove AgentSession persistence;\n\t * `AgentSession.invokeHarnessTool` layers the persisted-settlement boundary on top of it.\n\t \n\t Reentrancy. Do not `await` this from work whose return is required for the Agent to reach the\n\t * drain point (a model-callable `execute`, `beforeToolBatch`/`beforeToolCall`/`afterToolCall`/\n\t * `prepareNextTurn`, or an awaited listener), or the queued call can never execute and the await\n\t * deadlocks. Start/capture the promise, return from the gating callback, and await it from an\n\t * independent continuation.\n\t /\n\tasync runHarnessTool(tool: AgentTool<any>, args: unknown, options: { toolCallId?: string } = {}): Promise<void> {\n\t\tconst toolCallId = options.toolCallId ?? generateHarnessToolCallId();\n\t\tconst record = this.createHarnessInvocation(tool, args, toolCallId);\n\t\tif (this.activeRun) {\n\t\t\tthis.harnessToolQueue.push(record);\n\t\t\treturn record.promise;\n\t\t}\n\t\t// Register the marker before the first event so processEvents sees transient work in\n\t\t// flight from the start, including for nested calls (a harness tool invoking another). The\n\t\t// marker tracks the underlying work even if reset/teardown rejects the public promise first,\n\t\t// so a later prompt still waits for the transient events to finish before emitting its own.\n\t\tlet settleMarker!: () => void;\n\t\tconst marker = new Promise<void>((resolve) => {\n\t\t\tsettleMarker = resolve;\n\t\t});\n\t\tthis.transientRuns.add(marker);\n\t\tvoid (async () => {\n\t\t\ttry {\n\t\t\t\tawait this.executeHarnessInvocation(record, this.transientRunAbort.signal, undefined);\n\t\t\t} catch {\n\t\t\t\t// The rejection is already recorded on record.promise; a transient run has no run-failure\n\t\t\t\t// path to propagate into, so nothing escapes here.\n\t\t\t} finally {\n\t\t\t\tthis.transientRuns.delete(marker);\n\t\t\t\tsettleMarker();\n\t\t\t}\n\t\t})();\n\t\treturn record.promise;\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): back a harness-tool invocation with a deferred promise and track it\n\t// as unsettled until it resolves or is rejected.\n\tprivate createHarnessInvocation(tool: AgentTool<any>, args: unknown, toolCallId: string): HarnessToolInvocation {\n\t\tlet resolve!: () => void;\n\t\tlet reject!: (reason: Error) => void;\n\t\tconst promise = new Promise<void>((res, rej) => {\n\t\t\tresolve = res;\n\t\t\treject = rej;\n\t\t});\n\t\tconst record: HarnessToolInvocation = { tool, args, toolCallId, promise, resolve, reject };\n\t\tthis.unsettledHarnessTools.add(record);\n\t\treturn record;\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): settle a harness invocation exactly once. Set membership is the\n\t// settled flag: unsettledHarnessTools.delete() returns false when the record was already removed\n\t// (e.g. underlying transient work finishing after reset already rejected it), so a later attempt\n\t// is a no-op.\n\tprivate settleHarnessInvocation(record: HarnessToolInvocation, error?: Error): void {\n\t\tif (!this.unsettledHarnessTools.delete(record)) return;\n\t\tif (error) record.reject(error);\n\t\telse record.resolve();\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): run one invocation's pipeline and settle its record. Infrastructure\n\t// failures reject the record and rethrow so the drain path preserves current run-failure behavior;\n\t// a tool's own execute() error is not seen here (it resolves as an isError tool result).\n\tprivate async executeHarnessInvocation(\n\t\trecord: HarnessToolInvocation,\n\t\tsignal: AbortSignal \| undefined,\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t): Promise<void> {\n\t\ttry {\n\t\t\tawait this.emitHarnessToolCall(record.tool, record.args, record.toolCallId, signal, ctx);\n\t\t} catch (error) {\n\t\t\tthis.settleHarnessInvocation(record, error instanceof Error ? error : new Error(String(error)));\n\t\t\tthrow error;\n\t\t}\n\t\tthis.settleHarnessInvocation(record);\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): idempotently clear the queue and reject every still-unsettled\n\t// invocation (queued, draining, or transient). Used by reset() and by the final-drain failure path.\n\trejectUnsettledHarnessTools(reason: Error): void {\n\t\tthis.harnessToolQueue.length = 0;\n\t\tfor (const record of [...this.unsettledHarnessTools]) {\n\t\t\tthis.settleHarnessInvocation(record, reason);\n\t\t}\n\t}\n\n\t/* Drain all queued harness tool calls, splicing them into `ctx` when draining mid-run. /\n\tprivate async drainHarnessToolQueue(\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t\tsignal: AbortSignal \| undefined,\n\t): Promise<void> {\n\t\twhile (this.harnessToolQueue.length > 0) {\n\t\t\tconst record = this.harnessToolQueue.shift()!;\n\t\t\tawait this.executeHarnessInvocation(record, signal, ctx);\n\t\t}\n\t}\n\n\t/\n\t Emit the full event sequence for one harness tool call: a synthetic single-toolCall assistant\n\t * message, then the tool execution and its result message. When `ctx` is provided (mid-run drain),\n\t * the synthetic messages are also spliced into the live turn context and returned-message set so\n\t * the next intra-run LLM call includes them.\n\t */\n\tprivate async emitHarnessToolCall(\n\t\ttool: AgentTool<any>,\n\t\targs: unknown,\n\t\ttoolCallId: string,\n\t\tsignal: AbortSignal \| undefined,\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t): Promise<void> {\n\t\tconst toolCall: AgentToolCall = {\n\t\t\ttype: \"toolCall\",\n\t\t\tid: toolCallId,\n\t\t\tname: tool.name,\n\t\t\targuments: (args ?? {}) as Record<string, any>,\n\t\t};\n\t\tconst assistantMessage = this.createHarnessAssistantMessage(toolCall);\n\t\tawait this.processEvents({ type: \"message_start\", message: assistantMessage });\n\t\tawait this.processEvents({ type: \"message_end\", message: assistantMessage });\n\t\tif (ctx) {\n\t\t\tctx.context.messages.push(assistantMessage);\n\t\t\tctx.newMessages.push(assistantMessage);\n\t\t}\n\n\t\tconst hookContext = ctx?.context ?? this.createContextSnapshot();\n\t\tconst toolResultMessage = await executeHarnessToolCall(\n\t\t\ttool,\n\t\t\ttoolCall,\n\t\t\thookContext,\n\t\t\tassistantMessage,\n\t\t\t{ beforeToolCall: this.beforeToolCall, afterToolCall: this.afterToolCall },\n\t\t\tsignal,\n\t\t\t(event) => this.processEvents(event),\n\t\t);\n\t\tif (ctx) {\n\t\t\tctx.context.messages.push(toolResultMessage);\n\t\t\tctx.newMessages.push(toolResultMessage);\n\t\t}\n\t}\n\n\tprivate createHarnessAssistantMessage(toolCall: AgentToolCall): AssistantMessage {\n\t\treturn {\n\t\t\trole: \"assistant\",\n\t\t\torigin: \"harness\",\n\t\t\tcontent: [toolCall],\n\t\t\tapi: this._state.model.api,\n\t\t\tprovider: this._state.model.provider,\n\t\t\tmodel: this._state.model.id,\n\t\t\tusage: EMPTY_USAGE,\n\t\t\tstopReason: \"toolUse\",\n\t\t\ttimestamp: Date.now(),\n\t\t};\n\t}\n}\n"]}
1	+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype AssistantMessage,\n\ttype ImageContent,\n\ttype Message,\n\ttype Model,\n\ttype SimpleStreamOptions,\n\tstreamSimple,\n\ttype TextContent,\n\ttype ThinkingBudgets,\n\ttype Transport,\n} from \"@leanandmean/ai\";\nimport { executeHarnessToolCall, runAgentLoop, runAgentLoopContinue } from \"./agent-loop.js\";\nimport type {\n\tAfterToolCallContext,\n\tAfterToolCallResult,\n\tAgentContext,\n\tAgentEvent,\n\tAgentLoopConfig,\n\tAgentLoopTurnUpdate,\n\tAgentMessage,\n\tAgentState,\n\tAgentTool,\n\tAgentToolCall,\n\tBeforeToolBatchContext,\n\tBeforeToolCallContext,\n\tBeforeToolCallResult,\n\tPrepareNextTurnContext,\n\tQueueMode,\n\tStreamFn,\n\tToolExecutionMode,\n} from \"./types.js\";\n\nexport type { QueueMode } from \"./types.js\";\n\nfunction defaultConvertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages.filter(\n\t\t(message) => message.role === \"user\" \|\| message.role === \"assistant\" \|\| message.role === \"toolResult\",\n\t);\n}\n\nconst EMPTY_USAGE = {\n\tinput: 0,\n\toutput: 0,\n\tcacheRead: 0,\n\tcacheWrite: 0,\n\ttotalTokens: 0,\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n};\n\nconst DEFAULT_MODEL = {\n\tid: \"unknown\",\n\tname: \"unknown\",\n\tapi: \"unknown\",\n\tprovider: \"unknown\",\n\tbaseUrl: \"\",\n\treasoning: false,\n\tinput: [],\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\tcontextWindow: 0,\n\tmaxTokens: 0,\n} satisfies Model<any>;\n\n// SCRAMJET-DIVERGENCE: provider-safe tool-call id generation for harness-originated calls (#244).\n// The id must satisfy every provider's constraint (Anthropic's `^[a-zA-Z0-9_-]+$`, bounded length)\n// and must never embed raw model ids. A random suffix (not a bare counter) avoids collisions with\n// ids already present in a resumed transcript.\nexport function generateHarnessToolCallId(): string {\n\tconst uuid = globalThis.crypto?.randomUUID?.();\n\tconst suffix = uuid\n\t\t? uuid.replace(/-/g, \"\")\n\t\t: `${Date.now().toString(36)}${Math.floor(Math.random() * 1e9).toString(36)}`;\n\treturn `harness-tool-${suffix}`.slice(0, 64);\n}\n\ntype MutableAgentState = Omit<AgentState, \"isStreaming\" \| \"streamingMessage\" \| \"pendingToolCalls\" \| \"errorMessage\"> & {\n\tisStreaming: boolean;\n\tstreamingMessage?: AgentMessage;\n\tpendingToolCalls: Set<string>;\n\terrorMessage?: string;\n};\n\nfunction createMutableAgentState(\n\tinitialState?: Partial<Omit<AgentState, \"pendingToolCalls\" \| \"isStreaming\" \| \"streamingMessage\" \| \"errorMessage\">>,\n): MutableAgentState {\n\tlet tools = initialState?.tools?.slice() ?? [];\n\tlet messages = initialState?.messages?.slice() ?? [];\n\n\treturn {\n\t\tsystemPrompt: initialState?.systemPrompt ?? \"\",\n\t\tmodel: initialState?.model ?? DEFAULT_MODEL,\n\t\tthinkingLevel: initialState?.thinkingLevel ?? \"off\",\n\t\tget tools() {\n\t\t\treturn tools;\n\t\t},\n\t\tset tools(nextTools: AgentTool<any>[]) {\n\t\t\ttools = nextTools.slice();\n\t\t},\n\t\tget messages() {\n\t\t\treturn messages;\n\t\t},\n\t\tset messages(nextMessages: AgentMessage[]) {\n\t\t\tmessages = nextMessages.slice();\n\t\t},\n\t\tisStreaming: false,\n\t\tstreamingMessage: undefined,\n\t\tpendingToolCalls: new Set<string>(),\n\t\terrorMessage: undefined,\n\t};\n}\n\n/** Options for constructing an {@link Agent}. /\nexport interface AgentOptions {\n\tinitialState?: Partial<Omit<AgentState, \"pendingToolCalls\" \| \"isStreaming\" \| \"streamingMessage\" \| \"errorMessage\">>;\n\tconvertToLlm?: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tbeforeProviderCall?: AgentLoopConfig[\"beforeProviderCall\"];\n\tstreamFn?: StreamFn;\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tonPayload?: SimpleStreamOptions[\"onPayload\"];\n\tonResponse?: SimpleStreamOptions[\"onResponse\"];\n\tbeforeToolBatch?: (context: BeforeToolBatchContext, signal?: AbortSignal) => Promise<void>;\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\t// SCRAMJET-DIVERGENCE: prepareNextTurn receives the live turn context (previously the loop\n\t// context it passes was discarded by the Agent adapter) (#244).\n\tprepareNextTurn?: (\n\t\tctx: PrepareNextTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentLoopTurnUpdate \| undefined> \| AgentLoopTurnUpdate \| undefined;\n\tsteeringMode?: QueueMode;\n\tfollowUpMode?: QueueMode;\n\tsessionId?: string;\n\tthinkingBudgets?: ThinkingBudgets;\n\ttransport?: Transport;\n\tmaxRetryDelayMs?: number;\n\ttoolExecution?: ToolExecutionMode;\n}\n\nclass PendingMessageQueue {\n\tprivate messages: AgentMessage[] = [];\n\n\tconstructor(public mode: QueueMode) {}\n\n\tenqueue(message: AgentMessage): void {\n\t\tthis.messages.push(message);\n\t}\n\n\thasItems(): boolean {\n\t\treturn this.messages.length > 0;\n\t}\n\n\tdrain(): AgentMessage[] {\n\t\tif (this.mode === \"all\") {\n\t\t\tconst drained = this.messages.slice();\n\t\t\tthis.messages = [];\n\t\t\treturn drained;\n\t\t}\n\n\t\tconst first = this.messages[0];\n\t\tif (!first) {\n\t\t\treturn [];\n\t\t}\n\t\tthis.messages = this.messages.slice(1);\n\t\treturn [first];\n\t}\n\n\tclear(): void {\n\t\tthis.messages = [];\n\t}\n}\n\ntype ActiveRun = {\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\tabortController: AbortController;\n};\n\n// SCRAMJET-DIVERGENCE: harness-tool-invocation settlement records (#341).\n/\n One harness-tool invocation and the deferred promise that `runHarnessTool` returns for it. The\n * promise settles only when the invocation's Agent-core pipeline completes (resolve) or when\n * reset/teardown revokes the invocation or an infrastructure failure escapes the pipeline (reject).\n /\ntype HarnessToolInvocation = {\n\ttool: AgentTool<any>;\n\targs: unknown;\n\ttoolCallId: string;\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\treject: (reason: Error) => void;\n};\n\n/\n Stateful wrapper around the low-level agent loop.\n \n `Agent` owns the current transcript, emits lifecycle events, executes tools,\n * and exposes queueing APIs for steering and follow-up messages.\n /\nexport class Agent {\n\tprivate _state: MutableAgentState;\n\tprivate readonly listeners = new Set<(event: AgentEvent, signal: AbortSignal) => Promise<void> \| void>();\n\tprivate readonly steeringQueue: PendingMessageQueue;\n\tprivate readonly followUpQueue: PendingMessageQueue;\n\n\tpublic convertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\tpublic transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tpublic beforeProviderCall?: AgentLoopConfig[\"beforeProviderCall\"];\n\tpublic streamFn: StreamFn;\n\tpublic getApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tpublic onPayload?: SimpleStreamOptions[\"onPayload\"];\n\tpublic onResponse?: SimpleStreamOptions[\"onResponse\"];\n\t// SCRAMJET-DIVERGENCE: beforeToolBatch hook — async message_end mutations must settle before tool-call extraction\n\tpublic beforeToolBatch?: (context: BeforeToolBatchContext, signal?: AbortSignal) => Promise<void>;\n\tpublic beforeToolCall?: (\n\t\tcontext: BeforeToolCallContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<BeforeToolCallResult \| undefined>;\n\tpublic afterToolCall?: (\n\t\tcontext: AfterToolCallContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AfterToolCallResult \| undefined>;\n\tpublic prepareNextTurn?: (\n\t\tctx: PrepareNextTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentLoopTurnUpdate \| undefined> \| AgentLoopTurnUpdate \| undefined;\n\tprivate activeRun?: ActiveRun;\n\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive state (#244, settlement #341).\n\t/* Harness tool invocations queued while a run is active, drained at the next turn boundary. /\n\tprivate readonly harnessToolQueue: HarnessToolInvocation[] = [];\n\t/\n\t Every harness-tool invocation whose public promise has not yet settled — queued, shifted and\n\t * draining, or transient. Reset/teardown rejects this set; each invocation is removed as it\n\t * settles. Queue length is not a proxy for this: a draining call has left the queue but is still\n\t * unsettled (#341).\n\t /\n\tprivate readonly unsettledHarnessTools = new Set<HarnessToolInvocation>();\n\t/\n\t Markers for in-flight transient (idle) harness-tool runs; each resolves when its run settles.\n\t * A set (not a single field) keeps nested and overlapping transient runs valid, and lets a new\n\t * real run wait for transient work to finish before emitting its own events.\n\t /\n\tprivate readonly transientRuns = new Set<Promise<void>>();\n\t/* Shared, never-aborted signal delivered to listeners during transient harness-tool runs. /\n\tprivate readonly transientRunAbort = new AbortController();\n\t/* Session identifier forwarded to providers for cache-aware backends. /\n\tpublic sessionId?: string;\n\t/* Optional per-level thinking token budgets forwarded to the stream function. /\n\tpublic thinkingBudgets?: ThinkingBudgets;\n\t/* Preferred transport forwarded to the stream function. /\n\tpublic transport: Transport;\n\t/* Optional cap for provider-requested retry delays. /\n\tpublic maxRetryDelayMs?: number;\n\t/* Tool execution strategy for assistant messages that contain multiple tool calls. /\n\tpublic toolExecution: ToolExecutionMode;\n\n\tconstructor(options: AgentOptions = {}) {\n\t\tthis._state = createMutableAgentState(options.initialState);\n\t\tthis.convertToLlm = options.convertToLlm ?? defaultConvertToLlm;\n\t\tthis.transformContext = options.transformContext;\n\t\tthis.beforeProviderCall = options.beforeProviderCall;\n\t\tthis.streamFn = options.streamFn ?? streamSimple;\n\t\tthis.getApiKey = options.getApiKey;\n\t\tthis.onPayload = options.onPayload;\n\t\tthis.onResponse = options.onResponse;\n\t\tthis.beforeToolBatch = options.beforeToolBatch;\n\t\tthis.beforeToolCall = options.beforeToolCall;\n\t\tthis.afterToolCall = options.afterToolCall;\n\t\tthis.prepareNextTurn = options.prepareNextTurn;\n\t\tthis.steeringQueue = new PendingMessageQueue(options.steeringMode ?? \"one-at-a-time\");\n\t\tthis.followUpQueue = new PendingMessageQueue(options.followUpMode ?? \"one-at-a-time\");\n\t\tthis.sessionId = options.sessionId;\n\t\tthis.thinkingBudgets = options.thinkingBudgets;\n\t\tthis.transport = options.transport ?? \"auto\";\n\t\tthis.maxRetryDelayMs = options.maxRetryDelayMs;\n\t\tthis.toolExecution = options.toolExecution ?? \"parallel\";\n\t}\n\n\t/\n\t Subscribe to agent lifecycle events.\n\t \n\t Listener promises are awaited in subscription order and are included in\n\t * the current run's settlement. Listeners also receive the active abort\n\t * signal for the current run.\n\t \n\t `agent_end` is the final emitted event for a run, but the agent does not\n\t * become idle until all awaited listeners for that event have settled.\n\t /\n\tsubscribe(listener: (event: AgentEvent, signal: AbortSignal) => Promise<void> \| void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => this.listeners.delete(listener);\n\t}\n\n\t/\n\t Current agent state.\n\t \n\t Assigning `state.tools` or `state.messages` copies the provided top-level array.\n\t /\n\tget state(): AgentState {\n\t\treturn this._state;\n\t}\n\n\t/* Controls how queued steering messages are drained. /\n\tset steeringMode(mode: QueueMode) {\n\t\tthis.steeringQueue.mode = mode;\n\t}\n\n\tget steeringMode(): QueueMode {\n\t\treturn this.steeringQueue.mode;\n\t}\n\n\t/* Controls how queued follow-up messages are drained. /\n\tset followUpMode(mode: QueueMode) {\n\t\tthis.followUpQueue.mode = mode;\n\t}\n\n\tget followUpMode(): QueueMode {\n\t\treturn this.followUpQueue.mode;\n\t}\n\n\t/* Queue a message to be injected after the current assistant turn finishes. /\n\tsteer(message: AgentMessage): void {\n\t\tthis.steeringQueue.enqueue(message);\n\t}\n\n\t/* Queue a message to run only after the agent would otherwise stop. /\n\tfollowUp(message: AgentMessage): void {\n\t\tthis.followUpQueue.enqueue(message);\n\t}\n\n\t/* Remove all queued steering messages. /\n\tclearSteeringQueue(): void {\n\t\tthis.steeringQueue.clear();\n\t}\n\n\t/* Remove all queued follow-up messages. /\n\tclearFollowUpQueue(): void {\n\t\tthis.followUpQueue.clear();\n\t}\n\n\t/* Remove all queued steering and follow-up messages. /\n\tclearAllQueues(): void {\n\t\tthis.clearSteeringQueue();\n\t\tthis.clearFollowUpQueue();\n\t}\n\n\t/* Returns true when either queue still contains pending messages. /\n\thasQueuedMessages(): boolean {\n\t\treturn this.steeringQueue.hasItems() \|\| this.followUpQueue.hasItems();\n\t}\n\n\t/* Active abort signal for the current run, if any. /\n\tget signal(): AbortSignal \| undefined {\n\t\treturn this.activeRun?.abortController.signal;\n\t}\n\n\t/* Abort the current run, if one is active. /\n\tabort(): void {\n\t\tthis.activeRun?.abortController.abort();\n\t}\n\n\t/\n\t Resolve when the current run and all awaited event listeners have finished.\n\t \n\t This resolves after `agent_end` listeners settle.\n\t /\n\twaitForIdle(): Promise<void> {\n\t\treturn this.activeRun?.promise ?? Promise.resolve();\n\t}\n\n\t/* Clear transcript state, runtime state, and queued messages. /\n\treset(): void {\n\t\tthis._state.messages = [];\n\t\tthis._state.isStreaming = false;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.pendingToolCalls = new Set<string>();\n\t\tthis._state.errorMessage = undefined;\n\t\tthis.clearFollowUpQueue();\n\t\tthis.clearSteeringQueue();\n\t\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive (#244, settlement #341). reset()\n\t\t// rejects the public promise of every unsettled harness invocation so awaiting callers stop\n\t\t// waiting. The effect on the record row differs by kind: a queued (not-yet-draining) call loses\n\t\t// its row entirely, while a transient in-flight call keeps running — reset() does not abort\n\t\t// transientRunAbort — so its row is still emitted and persisted; only its promise is rejected.\n\t\t// The warning surfaces the rejection so a lost queued row is diagnosable.\n\t\tif (this.unsettledHarnessTools.size > 0) {\n\t\t\tconst names = [...this.unsettledHarnessTools].map((record) => record.tool.name).join(\", \");\n\t\t\tconsole.warn(\n\t\t\t\t`Agent.reset() rejected ${this.unsettledHarnessTools.size} unsettled harness tool call(s): ${names}`,\n\t\t\t);\n\t\t}\n\t\tthis.rejectUnsettledHarnessTools(new Error(\"Agent.reset() discarded unsettled harness tool call\"));\n\t}\n\n\t/* Start a new prompt from text, a single message, or a batch of messages. /\n\tasync prompt(message: AgentMessage \| AgentMessage[]): Promise<void>;\n\tasync prompt(input: string, images?: ImageContent[]): Promise<void>;\n\tasync prompt(input: string \| AgentMessage \| AgentMessage[], images?: ImageContent[]): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\n\t\t\t\t\"Agent is already processing a prompt. Use steer() or followUp() to queue messages, or wait for completion.\",\n\t\t\t);\n\t\t}\n\t\tconst messages = this.normalizePromptInput(input, images);\n\t\tawait this.runPromptMessages(messages);\n\t}\n\n\t/* Continue from the current transcript. The last message must be a user or tool-result message. /\n\tasync continue(): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\"Agent is already processing. Wait for completion before continuing.\");\n\t\t}\n\n\t\tconst lastMessage = this._state.messages[this._state.messages.length - 1];\n\t\tif (!lastMessage) {\n\t\t\tthrow new Error(\"No messages to continue from\");\n\t\t}\n\n\t\tif (lastMessage.role === \"assistant\") {\n\t\t\tconst queuedSteering = this.steeringQueue.drain();\n\t\t\tif (queuedSteering.length > 0) {\n\t\t\t\tawait this.runPromptMessages(queuedSteering, { skipInitialSteeringPoll: true });\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst queuedFollowUps = this.followUpQueue.drain();\n\t\t\tif (queuedFollowUps.length > 0) {\n\t\t\t\tawait this.runPromptMessages(queuedFollowUps);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new Error(\"Cannot continue from message role: assistant\");\n\t\t}\n\n\t\tawait this.runContinuation();\n\t}\n\n\tprivate normalizePromptInput(\n\t\tinput: string \| AgentMessage \| AgentMessage[],\n\t\timages?: ImageContent[],\n\t): AgentMessage[] {\n\t\tif (Array.isArray(input)) {\n\t\t\treturn input;\n\t\t}\n\n\t\tif (typeof input !== \"string\") {\n\t\t\treturn [input];\n\t\t}\n\n\t\tconst content: Array<TextContent \| ImageContent> = [{ type: \"text\", text: input }];\n\t\tif (images && images.length > 0) {\n\t\t\tcontent.push(...images);\n\t\t}\n\t\treturn [{ role: \"user\", content, timestamp: Date.now() }];\n\t}\n\n\tprivate async runPromptMessages(\n\t\tmessages: AgentMessage[],\n\t\toptions: { skipInitialSteeringPoll?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.runWithLifecycle(async (signal) => {\n\t\t\tawait runAgentLoop(\n\t\t\t\tmessages,\n\t\t\t\tthis.createContextSnapshot(),\n\t\t\t\tthis.createLoopConfig(options),\n\t\t\t\t(event) => this.processEvents(event),\n\t\t\t\tsignal,\n\t\t\t\tthis.streamFn,\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate async runContinuation(): Promise<void> {\n\t\tawait this.runWithLifecycle(async (signal) => {\n\t\t\tawait runAgentLoopContinue(\n\t\t\t\tthis.createContextSnapshot(),\n\t\t\t\tthis.createLoopConfig(),\n\t\t\t\t(event) => this.processEvents(event),\n\t\t\t\tsignal,\n\t\t\t\tthis.streamFn,\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate createContextSnapshot(): AgentContext {\n\t\treturn {\n\t\t\tsystemPrompt: this._state.systemPrompt,\n\t\t\tmessages: this._state.messages.slice(),\n\t\t\ttools: this._state.tools.slice(),\n\t\t};\n\t}\n\n\tprivate createLoopConfig(options: { skipInitialSteeringPoll?: boolean } = {}): AgentLoopConfig {\n\t\tlet skipInitialSteeringPoll = options.skipInitialSteeringPoll === true;\n\t\treturn {\n\t\t\tmodel: this._state.model,\n\t\t\treasoning: this._state.thinkingLevel === \"off\" ? undefined : this._state.thinkingLevel,\n\t\t\tsessionId: this.sessionId,\n\t\t\tonPayload: this.onPayload,\n\t\t\tonResponse: this.onResponse,\n\t\t\ttransport: this.transport,\n\t\t\tthinkingBudgets: this.thinkingBudgets,\n\t\t\tmaxRetryDelayMs: this.maxRetryDelayMs,\n\t\t\ttoolExecution: this.toolExecution,\n\t\t\tbeforeToolBatch: this.beforeToolBatch,\n\t\t\tbeforeToolCall: this.beforeToolCall,\n\t\t\tafterToolCall: this.afterToolCall,\n\t\t\t// SCRAMJET-DIVERGENCE: always run prepareNextTurn so mid-run harness tool calls drain\n\t\t\t// and live request context/routing self-heals without overriding explicit callback updates\n\t\t\t// (#244, #447, #524).\n\t\t\tprepareNextTurn: async (ctx) => {\n\t\t\t\tawait this.drainHarnessToolQueue(ctx, this.signal);\n\t\t\t\tconst liveSystemPrompt = this._state.systemPrompt;\n\t\t\t\tconst refreshedContext: AgentContext = {\n\t\t\t\t\tsystemPrompt: Array.isArray(liveSystemPrompt) ? liveSystemPrompt.slice() : liveSystemPrompt,\n\t\t\t\t\tmessages: ctx.context.messages,\n\t\t\t\t\ttools: this._state.tools.slice(),\n\t\t\t\t};\n\t\t\t\tconst update = await this.prepareNextTurn?.({ ...ctx, context: refreshedContext }, this.signal);\n\t\t\t\treturn {\n\t\t\t\t\t...update,\n\t\t\t\t\tcontext: update?.context ?? refreshedContext,\n\t\t\t\t\tmodel: update?.model ?? this._state.model,\n\t\t\t\t\tthinkingLevel: update?.thinkingLevel ?? this._state.thinkingLevel,\n\t\t\t\t};\n\t\t\t},\n\t\t\tconvertToLlm: this.convertToLlm,\n\t\t\ttransformContext: this.transformContext,\n\t\t\tbeforeProviderCall: this.beforeProviderCall,\n\t\t\tgetApiKey: this.getApiKey,\n\t\t\tgetSteeringMessages: async () => {\n\t\t\t\tif (skipInitialSteeringPoll) {\n\t\t\t\t\tskipInitialSteeringPoll = false;\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t\treturn this.steeringQueue.drain();\n\t\t\t},\n\t\t\tgetFollowUpMessages: async () => this.followUpQueue.drain(),\n\t\t};\n\t}\n\n\tprivate async runWithLifecycle(executor: (signal: AbortSignal) => Promise<void>): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\"Agent is already processing.\");\n\t\t}\n\n\t\tconst abortController = new AbortController();\n\t\tlet resolvePromise = () => {};\n\t\tconst promise = new Promise<void>((resolve) => {\n\t\t\tresolvePromise = resolve;\n\t\t});\n\t\tthis.activeRun = { promise, resolve: resolvePromise, abortController };\n\n\t\tthis._state.isStreaming = true;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.errorMessage = undefined;\n\n\t\t// SCRAMJET-DIVERGENCE (#341): a failed final flush leaves later queued calls unable to execute.\n\t\t// Capture it (rejecting remnants below) and re-throw after finishRun so the error propagates out\n\t\t// of prompt()/continue() — not activeRun.promise, which finishRun always resolves — without a\n\t\t// lint-flagged throw inside a finally block. The { error } wrapper (not a bare `unknown` field)\n\t\t// is deliberate: it distinguishes \"no drain error\" from a falsy throw (e.g. `throw undefined`),\n\t\t// which a `!== undefined` check on a bare field would silently swallow.\n\t\tlet finalDrainError: { error: unknown } \| undefined;\n\t\ttry {\n\t\t\t// Wait for in-flight transient harness-tool runs so their events do not interleave\n\t\t\t// with this run's transcript.\n\t\t\twhile (this.transientRuns.size > 0) {\n\t\t\t\tawait Promise.all(this.transientRuns);\n\t\t\t}\n\t\t\tawait executor(abortController.signal);\n\t\t} catch (error) {\n\t\t\tawait this.handleRunFailure(error, abortController.signal.aborted);\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\t// Flush harness tool calls queued during the run's final turn — including failed or\n\t\t\t\t// aborted runs — after the last prepareNextTurn drain point, so a queued call is\n\t\t\t\t// never stranded. Emits messages/tool events but no run framing.\n\t\t\t\tawait this.drainHarnessToolQueue(undefined, abortController.signal);\n\t\t\t} catch (drainError) {\n\t\t\t\t// The failing call was already rejected by executeHarnessInvocation; reject the\n\t\t\t\t// remnants too so their promises settle.\n\t\t\t\tthis.rejectUnsettledHarnessTools(drainError instanceof Error ? drainError : new Error(String(drainError)));\n\t\t\t\tfinalDrainError = { error: drainError };\n\t\t\t} finally {\n\t\t\t\tthis.finishRun();\n\t\t\t}\n\t\t}\n\t\tif (finalDrainError) {\n\t\t\tthrow finalDrainError.error;\n\t\t}\n\t}\n\n\tprivate async handleRunFailure(error: unknown, aborted: boolean): Promise<void> {\n\t\tconst failureMessage = {\n\t\t\trole: \"assistant\",\n\t\t\torigin: \"harness\",\n\t\t\tcontent: [{ type: \"text\", text: \"\" }],\n\t\t\tapi: this._state.model.api,\n\t\t\tprovider: this._state.model.provider,\n\t\t\tmodel: this._state.model.id,\n\t\t\tusage: EMPTY_USAGE,\n\t\t\tstopReason: aborted ? \"aborted\" : \"error\",\n\t\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\t\ttimestamp: Date.now(),\n\t\t} satisfies AgentMessage;\n\t\tawait this.processEvents({ type: \"message_start\", message: failureMessage });\n\t\tawait this.processEvents({ type: \"message_end\", message: failureMessage });\n\t\tawait this.processEvents({ type: \"turn_end\", message: failureMessage, toolResults: [] });\n\t\tawait this.processEvents({ type: \"agent_end\", messages: [failureMessage] });\n\t}\n\n\tprivate finishRun(): void {\n\t\tthis._state.isStreaming = false;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.pendingToolCalls = new Set<string>();\n\t\tthis.activeRun?.resolve();\n\t\tthis.activeRun = undefined;\n\t}\n\n\t/\n\t Reduce internal state for a loop event, then await listeners.\n\t \n\t `agent_end` only means no further loop events will be emitted. The run is\n\t * considered idle later, after all awaited listeners for `agent_end` finish\n\t * and `finishRun()` clears runtime-owned state.\n\t /\n\tprivate async processEvents(event: AgentEvent): Promise<void> {\n\t\tswitch (event.type) {\n\t\t\tcase \"message_start\":\n\t\t\t\tthis._state.streamingMessage = event.message;\n\t\t\t\tbreak;\n\n\t\t\tcase \"message_update\":\n\t\t\t\tthis._state.streamingMessage = event.message;\n\t\t\t\tbreak;\n\n\t\t\tcase \"message_end\":\n\t\t\t\tthis._state.streamingMessage = undefined;\n\t\t\t\tthis._state.messages.push(event.message);\n\t\t\t\tbreak;\n\n\t\t\tcase \"tool_execution_start\": {\n\t\t\t\tconst pendingToolCalls = new Set(this._state.pendingToolCalls);\n\t\t\t\tpendingToolCalls.add(event.toolCallId);\n\t\t\t\tthis._state.pendingToolCalls = pendingToolCalls;\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"tool_execution_end\": {\n\t\t\t\tconst pendingToolCalls = new Set(this._state.pendingToolCalls);\n\t\t\t\tpendingToolCalls.delete(event.toolCallId);\n\t\t\t\tthis._state.pendingToolCalls = pendingToolCalls;\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"turn_end\":\n\t\t\t\tif (event.message.role === \"assistant\" && event.message.errorMessage) {\n\t\t\t\t\tthis._state.errorMessage = event.message.errorMessage;\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"agent_end\":\n\t\t\t\tthis._state.streamingMessage = undefined;\n\t\t\t\tbreak;\n\t\t}\n\n\t\t// SCRAMJET-DIVERGENCE: fall back to the shared transient-run signal while transient\n\t\t// harness-tool work (which intentionally has no `activeRun`) is in flight (#244).\n\t\tconst signal =\n\t\t\tthis.activeRun?.abortController.signal ??\n\t\t\t(this.transientRuns.size > 0 ? this.transientRunAbort.signal : undefined);\n\t\tif (!signal) {\n\t\t\tthrow new Error(\"Agent listener invoked outside active run\");\n\t\t}\n\t\tfor (const listener of this.listeners) {\n\t\t\tawait listener(event, signal);\n\t\t}\n\t}\n\n\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive (#244, execution settlement #341).\n\t/\n\t Execute a harness-originated tool call through the real execution pipeline.\n\t \n\t The tool object is supplied directly, so it need not appear in `state.tools` — this is what\n\t * lets LLM-invisible harness tools execute. The call produces the same `tool_execution_` and\n\t message events, persisted messages, and `beforeToolCall`/`afterToolCall` invocations as a\n\t * normal tool execution, but emits no run/turn framing events (`agent_start`, `turn_start`,\n\t * `turn_end`, `agent_end`). It is therefore intentionally invisible to every `agent_end`-keyed\n\t * consumer (probe scheduling, compaction bookkeeping).\n\t \n\t When idle, the call executes immediately in a transient run scope. When a run is active, it is\n\t * queued and drained at the next turn boundary — before the next intra-run LLM call — with an\n\t * end-of-run flush for calls queued during the run's final turn, so a queued call is never stranded.\n\t \n\t Settlement (#341). The returned promise resolves only after the call's full Agent-core\n\t * pipeline finishes: the synthetic assistant tool-call message, tool prepare/execute/finalize, the\n\t * tool-result message, Agent state reduction, and every awaited listener for those events. A queued\n\t * call therefore does not resolve at enqueue time — it resolves when the drain executes it. The\n\t * promise rejects when reset or session teardown revokes an unsettled invocation, when an\n\t * infrastructure/listener/hook failure escapes the pipeline, or when a failed final drain leaves a\n\t * later queued call unable to execute. A tool's own `execute()` throwing is not a rejection: it\n\t * becomes a normal `isError: true` tool result, so the promise resolves after that error-result\n\t * pipeline completes. Rejection means the promised pipeline did not complete — it does not prove\n\t * artifact absence (state and persistence may have partially completed), so callers must not blindly\n\t * retry.\n\t \n\t This settles Agent-core execution only. It does not prove AgentSession persistence;\n\t * `AgentSession.invokeHarnessTool` layers the persisted-settlement boundary on top of it.\n\t \n\t Reentrancy. Do not `await` this from work whose return is required for the Agent to reach the\n\t * drain point (a model-callable `execute`, `beforeToolBatch`/`beforeToolCall`/`afterToolCall`/\n\t * `prepareNextTurn`, or an awaited listener), or the queued call can never execute and the await\n\t * deadlocks. Start/capture the promise, return from the gating callback, and await it from an\n\t * independent continuation.\n\t /\n\tasync runHarnessTool(tool: AgentTool<any>, args: unknown, options: { toolCallId?: string } = {}): Promise<void> {\n\t\tconst toolCallId = options.toolCallId ?? generateHarnessToolCallId();\n\t\tconst record = this.createHarnessInvocation(tool, args, toolCallId);\n\t\tif (this.activeRun) {\n\t\t\tthis.harnessToolQueue.push(record);\n\t\t\treturn record.promise;\n\t\t}\n\t\t// Register the marker before the first event so processEvents sees transient work in\n\t\t// flight from the start, including for nested calls (a harness tool invoking another). The\n\t\t// marker tracks the underlying work even if reset/teardown rejects the public promise first,\n\t\t// so a later prompt still waits for the transient events to finish before emitting its own.\n\t\tlet settleMarker!: () => void;\n\t\tconst marker = new Promise<void>((resolve) => {\n\t\t\tsettleMarker = resolve;\n\t\t});\n\t\tthis.transientRuns.add(marker);\n\t\tvoid (async () => {\n\t\t\ttry {\n\t\t\t\tawait this.executeHarnessInvocation(record, this.transientRunAbort.signal, undefined);\n\t\t\t} catch {\n\t\t\t\t// The rejection is already recorded on record.promise; a transient run has no run-failure\n\t\t\t\t// path to propagate into, so nothing escapes here.\n\t\t\t} finally {\n\t\t\t\tthis.transientRuns.delete(marker);\n\t\t\t\tsettleMarker();\n\t\t\t}\n\t\t})();\n\t\treturn record.promise;\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): back a harness-tool invocation with a deferred promise and track it\n\t// as unsettled until it resolves or is rejected.\n\tprivate createHarnessInvocation(tool: AgentTool<any>, args: unknown, toolCallId: string): HarnessToolInvocation {\n\t\tlet resolve!: () => void;\n\t\tlet reject!: (reason: Error) => void;\n\t\tconst promise = new Promise<void>((res, rej) => {\n\t\t\tresolve = res;\n\t\t\treject = rej;\n\t\t});\n\t\tconst record: HarnessToolInvocation = { tool, args, toolCallId, promise, resolve, reject };\n\t\tthis.unsettledHarnessTools.add(record);\n\t\treturn record;\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): settle a harness invocation exactly once. Set membership is the\n\t// settled flag: unsettledHarnessTools.delete() returns false when the record was already removed\n\t// (e.g. underlying transient work finishing after reset already rejected it), so a later attempt\n\t// is a no-op.\n\tprivate settleHarnessInvocation(record: HarnessToolInvocation, error?: Error): void {\n\t\tif (!this.unsettledHarnessTools.delete(record)) return;\n\t\tif (error) record.reject(error);\n\t\telse record.resolve();\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): run one invocation's pipeline and settle its record. Infrastructure\n\t// failures reject the record and rethrow so the drain path preserves current run-failure behavior;\n\t// a tool's own execute() error is not seen here (it resolves as an isError tool result).\n\tprivate async executeHarnessInvocation(\n\t\trecord: HarnessToolInvocation,\n\t\tsignal: AbortSignal \| undefined,\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t): Promise<void> {\n\t\ttry {\n\t\t\tawait this.emitHarnessToolCall(record.tool, record.args, record.toolCallId, signal, ctx);\n\t\t} catch (error) {\n\t\t\tthis.settleHarnessInvocation(record, error instanceof Error ? error : new Error(String(error)));\n\t\t\tthrow error;\n\t\t}\n\t\tthis.settleHarnessInvocation(record);\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): idempotently clear the queue and reject every still-unsettled\n\t// invocation (queued, draining, or transient). Used by reset() and by the final-drain failure path.\n\trejectUnsettledHarnessTools(reason: Error): void {\n\t\tthis.harnessToolQueue.length = 0;\n\t\tfor (const record of [...this.unsettledHarnessTools]) {\n\t\t\tthis.settleHarnessInvocation(record, reason);\n\t\t}\n\t}\n\n\t/* Drain all queued harness tool calls, splicing them into `ctx` when draining mid-run. /\n\tprivate async drainHarnessToolQueue(\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t\tsignal: AbortSignal \| undefined,\n\t): Promise<void> {\n\t\twhile (this.harnessToolQueue.length > 0) {\n\t\t\tconst record = this.harnessToolQueue.shift()!;\n\t\t\tawait this.executeHarnessInvocation(record, signal, ctx);\n\t\t}\n\t}\n\n\t/\n\t Emit the full event sequence for one harness tool call: a synthetic single-toolCall assistant\n\t * message, then the tool execution and its result message. When `ctx` is provided (mid-run drain),\n\t * the synthetic messages are also spliced into the live turn context and returned-message set so\n\t * the next intra-run LLM call includes them.\n\t */\n\tprivate async emitHarnessToolCall(\n\t\ttool: AgentTool<any>,\n\t\targs: unknown,\n\t\ttoolCallId: string,\n\t\tsignal: AbortSignal \| undefined,\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t): Promise<void> {\n\t\tconst toolCall: AgentToolCall = {\n\t\t\ttype: \"toolCall\",\n\t\t\tid: toolCallId,\n\t\t\tname: tool.name,\n\t\t\targuments: (args ?? {}) as Record<string, any>,\n\t\t};\n\t\tconst assistantMessage = this.createHarnessAssistantMessage(toolCall);\n\t\tawait this.processEvents({ type: \"message_start\", message: assistantMessage });\n\t\tawait this.processEvents({ type: \"message_end\", message: assistantMessage });\n\t\tif (ctx) {\n\t\t\tctx.context.messages.push(assistantMessage);\n\t\t\tctx.newMessages.push(assistantMessage);\n\t\t}\n\n\t\tconst hookContext = ctx?.context ?? this.createContextSnapshot();\n\t\tconst toolResultMessage = await executeHarnessToolCall(\n\t\t\ttool,\n\t\t\ttoolCall,\n\t\t\thookContext,\n\t\t\tassistantMessage,\n\t\t\t{ beforeToolCall: this.beforeToolCall, afterToolCall: this.afterToolCall },\n\t\t\tsignal,\n\t\t\t(event) => this.processEvents(event),\n\t\t);\n\t\tif (ctx) {\n\t\t\tctx.context.messages.push(toolResultMessage);\n\t\t\tctx.newMessages.push(toolResultMessage);\n\t\t}\n\t}\n\n\tprivate createHarnessAssistantMessage(toolCall: AgentToolCall): AssistantMessage {\n\t\treturn {\n\t\t\trole: \"assistant\",\n\t\t\torigin: \"harness\",\n\t\t\tcontent: [toolCall],\n\t\t\tapi: this._state.model.api,\n\t\t\tprovider: this._state.model.provider,\n\t\t\tmodel: this._state.model.id,\n\t\t\tusage: EMPTY_USAGE,\n\t\t\tstopReason: \"toolUse\",\n\t\t\ttimestamp: Date.now(),\n\t\t};\n\t}\n}\n"]}

package/dist/agent.js CHANGED Viewed

@@ -336,13 +336,20 @@ export class Agent {
             beforeToolCall: this.beforeToolCall,
             afterToolCall: this.afterToolCall,
             // SCRAMJET-DIVERGENCE: always run prepareNextTurn so mid-run harness tool calls drain
-            // before the next LLM call and live model/effort changes self-heal without overriding
-            // explicit callback updates (#244, #447).
+            // and live request context/routing self-heals without overriding explicit callback updates
+            // (#244, #447, #524).
             prepareNextTurn: async (ctx) => {
                 await this.drainHarnessToolQueue(ctx, this.signal);
-                const update = await this.prepareNextTurn?.(ctx, this.signal);
+                const liveSystemPrompt = this._state.systemPrompt;
+                const refreshedContext = {
+                    systemPrompt: Array.isArray(liveSystemPrompt) ? liveSystemPrompt.slice() : liveSystemPrompt,
+                    messages: ctx.context.messages,
+                    tools: this._state.tools.slice(),
+                };
+                const update = await this.prepareNextTurn?.({ ...ctx, context: refreshedContext }, this.signal);
                 return {
                     ...update,
+                    context: update?.context ?? refreshedContext,
                     model: update?.model ?? this._state.model,
                     thinkingLevel: update?.thinkingLevel ?? this._state.thinkingLevel,
                 };

package/dist/agent.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype AssistantMessage,\n\ttype ImageContent,\n\ttype Message,\n\ttype Model,\n\ttype SimpleStreamOptions,\n\tstreamSimple,\n\ttype TextContent,\n\ttype ThinkingBudgets,\n\ttype Transport,\n} from \"@leanandmean/ai\";\nimport { executeHarnessToolCall, runAgentLoop, runAgentLoopContinue } from \"./agent-loop.js\";\nimport type {\n\tAfterToolCallContext,\n\tAfterToolCallResult,\n\tAgentContext,\n\tAgentEvent,\n\tAgentLoopConfig,\n\tAgentLoopTurnUpdate,\n\tAgentMessage,\n\tAgentState,\n\tAgentTool,\n\tAgentToolCall,\n\tBeforeToolBatchContext,\n\tBeforeToolCallContext,\n\tBeforeToolCallResult,\n\tPrepareNextTurnContext,\n\tQueueMode,\n\tStreamFn,\n\tToolExecutionMode,\n} from \"./types.js\";\n\nexport type { QueueMode } from \"./types.js\";\n\nfunction defaultConvertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages.filter(\n\t\t(message) => message.role === \"user\" \|\| message.role === \"assistant\" \|\| message.role === \"toolResult\",\n\t);\n}\n\nconst EMPTY_USAGE = {\n\tinput: 0,\n\toutput: 0,\n\tcacheRead: 0,\n\tcacheWrite: 0,\n\ttotalTokens: 0,\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n};\n\nconst DEFAULT_MODEL = {\n\tid: \"unknown\",\n\tname: \"unknown\",\n\tapi: \"unknown\",\n\tprovider: \"unknown\",\n\tbaseUrl: \"\",\n\treasoning: false,\n\tinput: [],\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\tcontextWindow: 0,\n\tmaxTokens: 0,\n} satisfies Model<any>;\n\n// SCRAMJET-DIVERGENCE: provider-safe tool-call id generation for harness-originated calls (#244).\n// The id must satisfy every provider's constraint (Anthropic's `^[a-zA-Z0-9_-]+$`, bounded length)\n// and must never embed raw model ids. A random suffix (not a bare counter) avoids collisions with\n// ids already present in a resumed transcript.\nexport function generateHarnessToolCallId(): string {\n\tconst uuid = globalThis.crypto?.randomUUID?.();\n\tconst suffix = uuid\n\t\t? uuid.replace(/-/g, \"\")\n\t\t: `${Date.now().toString(36)}${Math.floor(Math.random() * 1e9).toString(36)}`;\n\treturn `harness-tool-${suffix}`.slice(0, 64);\n}\n\ntype MutableAgentState = Omit<AgentState, \"isStreaming\" \| \"streamingMessage\" \| \"pendingToolCalls\" \| \"errorMessage\"> & {\n\tisStreaming: boolean;\n\tstreamingMessage?: AgentMessage;\n\tpendingToolCalls: Set<string>;\n\terrorMessage?: string;\n};\n\nfunction createMutableAgentState(\n\tinitialState?: Partial<Omit<AgentState, \"pendingToolCalls\" \| \"isStreaming\" \| \"streamingMessage\" \| \"errorMessage\">>,\n): MutableAgentState {\n\tlet tools = initialState?.tools?.slice() ?? [];\n\tlet messages = initialState?.messages?.slice() ?? [];\n\n\treturn {\n\t\tsystemPrompt: initialState?.systemPrompt ?? \"\",\n\t\tmodel: initialState?.model ?? DEFAULT_MODEL,\n\t\tthinkingLevel: initialState?.thinkingLevel ?? \"off\",\n\t\tget tools() {\n\t\t\treturn tools;\n\t\t},\n\t\tset tools(nextTools: AgentTool<any>[]) {\n\t\t\ttools = nextTools.slice();\n\t\t},\n\t\tget messages() {\n\t\t\treturn messages;\n\t\t},\n\t\tset messages(nextMessages: AgentMessage[]) {\n\t\t\tmessages = nextMessages.slice();\n\t\t},\n\t\tisStreaming: false,\n\t\tstreamingMessage: undefined,\n\t\tpendingToolCalls: new Set<string>(),\n\t\terrorMessage: undefined,\n\t};\n}\n\n/** Options for constructing an {@link Agent}. /\nexport interface AgentOptions {\n\tinitialState?: Partial<Omit<AgentState, \"pendingToolCalls\" \| \"isStreaming\" \| \"streamingMessage\" \| \"errorMessage\">>;\n\tconvertToLlm?: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tbeforeProviderCall?: AgentLoopConfig[\"beforeProviderCall\"];\n\tstreamFn?: StreamFn;\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tonPayload?: SimpleStreamOptions[\"onPayload\"];\n\tonResponse?: SimpleStreamOptions[\"onResponse\"];\n\tbeforeToolBatch?: (context: BeforeToolBatchContext, signal?: AbortSignal) => Promise<void>;\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\t// SCRAMJET-DIVERGENCE: prepareNextTurn receives the live turn context (previously the loop\n\t// context it passes was discarded by the Agent adapter) (#244).\n\tprepareNextTurn?: (\n\t\tctx: PrepareNextTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentLoopTurnUpdate \| undefined> \| AgentLoopTurnUpdate \| undefined;\n\tsteeringMode?: QueueMode;\n\tfollowUpMode?: QueueMode;\n\tsessionId?: string;\n\tthinkingBudgets?: ThinkingBudgets;\n\ttransport?: Transport;\n\tmaxRetryDelayMs?: number;\n\ttoolExecution?: ToolExecutionMode;\n}\n\nclass PendingMessageQueue {\n\tprivate messages: AgentMessage[] = [];\n\n\tconstructor(public mode: QueueMode) {}\n\n\tenqueue(message: AgentMessage): void {\n\t\tthis.messages.push(message);\n\t}\n\n\thasItems(): boolean {\n\t\treturn this.messages.length > 0;\n\t}\n\n\tdrain(): AgentMessage[] {\n\t\tif (this.mode === \"all\") {\n\t\t\tconst drained = this.messages.slice();\n\t\t\tthis.messages = [];\n\t\t\treturn drained;\n\t\t}\n\n\t\tconst first = this.messages[0];\n\t\tif (!first) {\n\t\t\treturn [];\n\t\t}\n\t\tthis.messages = this.messages.slice(1);\n\t\treturn [first];\n\t}\n\n\tclear(): void {\n\t\tthis.messages = [];\n\t}\n}\n\ntype ActiveRun = {\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\tabortController: AbortController;\n};\n\n// SCRAMJET-DIVERGENCE: harness-tool-invocation settlement records (#341).\n/\n One harness-tool invocation and the deferred promise that `runHarnessTool` returns for it. The\n * promise settles only when the invocation's Agent-core pipeline completes (resolve) or when\n * reset/teardown revokes the invocation or an infrastructure failure escapes the pipeline (reject).\n /\ntype HarnessToolInvocation = {\n\ttool: AgentTool<any>;\n\targs: unknown;\n\ttoolCallId: string;\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\treject: (reason: Error) => void;\n};\n\n/\n Stateful wrapper around the low-level agent loop.\n \n `Agent` owns the current transcript, emits lifecycle events, executes tools,\n * and exposes queueing APIs for steering and follow-up messages.\n /\nexport class Agent {\n\tprivate _state: MutableAgentState;\n\tprivate readonly listeners = new Set<(event: AgentEvent, signal: AbortSignal) => Promise<void> \| void>();\n\tprivate readonly steeringQueue: PendingMessageQueue;\n\tprivate readonly followUpQueue: PendingMessageQueue;\n\n\tpublic convertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\tpublic transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tpublic beforeProviderCall?: AgentLoopConfig[\"beforeProviderCall\"];\n\tpublic streamFn: StreamFn;\n\tpublic getApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tpublic onPayload?: SimpleStreamOptions[\"onPayload\"];\n\tpublic onResponse?: SimpleStreamOptions[\"onResponse\"];\n\t// SCRAMJET-DIVERGENCE: beforeToolBatch hook — async message_end mutations must settle before tool-call extraction\n\tpublic beforeToolBatch?: (context: BeforeToolBatchContext, signal?: AbortSignal) => Promise<void>;\n\tpublic beforeToolCall?: (\n\t\tcontext: BeforeToolCallContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<BeforeToolCallResult \| undefined>;\n\tpublic afterToolCall?: (\n\t\tcontext: AfterToolCallContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AfterToolCallResult \| undefined>;\n\tpublic prepareNextTurn?: (\n\t\tctx: PrepareNextTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentLoopTurnUpdate \| undefined> \| AgentLoopTurnUpdate \| undefined;\n\tprivate activeRun?: ActiveRun;\n\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive state (#244, settlement #341).\n\t/* Harness tool invocations queued while a run is active, drained at the next turn boundary. /\n\tprivate readonly harnessToolQueue: HarnessToolInvocation[] = [];\n\t/\n\t Every harness-tool invocation whose public promise has not yet settled — queued, shifted and\n\t * draining, or transient. Reset/teardown rejects this set; each invocation is removed as it\n\t * settles. Queue length is not a proxy for this: a draining call has left the queue but is still\n\t * unsettled (#341).\n\t /\n\tprivate readonly unsettledHarnessTools = new Set<HarnessToolInvocation>();\n\t/\n\t Markers for in-flight transient (idle) harness-tool runs; each resolves when its run settles.\n\t * A set (not a single field) keeps nested and overlapping transient runs valid, and lets a new\n\t * real run wait for transient work to finish before emitting its own events.\n\t /\n\tprivate readonly transientRuns = new Set<Promise<void>>();\n\t/* Shared, never-aborted signal delivered to listeners during transient harness-tool runs. /\n\tprivate readonly transientRunAbort = new AbortController();\n\t/* Session identifier forwarded to providers for cache-aware backends. /\n\tpublic sessionId?: string;\n\t/* Optional per-level thinking token budgets forwarded to the stream function. /\n\tpublic thinkingBudgets?: ThinkingBudgets;\n\t/* Preferred transport forwarded to the stream function. /\n\tpublic transport: Transport;\n\t/* Optional cap for provider-requested retry delays. /\n\tpublic maxRetryDelayMs?: number;\n\t/* Tool execution strategy for assistant messages that contain multiple tool calls. /\n\tpublic toolExecution: ToolExecutionMode;\n\n\tconstructor(options: AgentOptions = {}) {\n\t\tthis._state = createMutableAgentState(options.initialState);\n\t\tthis.convertToLlm = options.convertToLlm ?? defaultConvertToLlm;\n\t\tthis.transformContext = options.transformContext;\n\t\tthis.beforeProviderCall = options.beforeProviderCall;\n\t\tthis.streamFn = options.streamFn ?? streamSimple;\n\t\tthis.getApiKey = options.getApiKey;\n\t\tthis.onPayload = options.onPayload;\n\t\tthis.onResponse = options.onResponse;\n\t\tthis.beforeToolBatch = options.beforeToolBatch;\n\t\tthis.beforeToolCall = options.beforeToolCall;\n\t\tthis.afterToolCall = options.afterToolCall;\n\t\tthis.prepareNextTurn = options.prepareNextTurn;\n\t\tthis.steeringQueue = new PendingMessageQueue(options.steeringMode ?? \"one-at-a-time\");\n\t\tthis.followUpQueue = new PendingMessageQueue(options.followUpMode ?? \"one-at-a-time\");\n\t\tthis.sessionId = options.sessionId;\n\t\tthis.thinkingBudgets = options.thinkingBudgets;\n\t\tthis.transport = options.transport ?? \"auto\";\n\t\tthis.maxRetryDelayMs = options.maxRetryDelayMs;\n\t\tthis.toolExecution = options.toolExecution ?? \"parallel\";\n\t}\n\n\t/\n\t Subscribe to agent lifecycle events.\n\t \n\t Listener promises are awaited in subscription order and are included in\n\t * the current run's settlement. Listeners also receive the active abort\n\t * signal for the current run.\n\t \n\t `agent_end` is the final emitted event for a run, but the agent does not\n\t * become idle until all awaited listeners for that event have settled.\n\t /\n\tsubscribe(listener: (event: AgentEvent, signal: AbortSignal) => Promise<void> \| void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => this.listeners.delete(listener);\n\t}\n\n\t/\n\t Current agent state.\n\t \n\t Assigning `state.tools` or `state.messages` copies the provided top-level array.\n\t /\n\tget state(): AgentState {\n\t\treturn this._state;\n\t}\n\n\t/* Controls how queued steering messages are drained. /\n\tset steeringMode(mode: QueueMode) {\n\t\tthis.steeringQueue.mode = mode;\n\t}\n\n\tget steeringMode(): QueueMode {\n\t\treturn this.steeringQueue.mode;\n\t}\n\n\t/* Controls how queued follow-up messages are drained. /\n\tset followUpMode(mode: QueueMode) {\n\t\tthis.followUpQueue.mode = mode;\n\t}\n\n\tget followUpMode(): QueueMode {\n\t\treturn this.followUpQueue.mode;\n\t}\n\n\t/* Queue a message to be injected after the current assistant turn finishes. /\n\tsteer(message: AgentMessage): void {\n\t\tthis.steeringQueue.enqueue(message);\n\t}\n\n\t/* Queue a message to run only after the agent would otherwise stop. /\n\tfollowUp(message: AgentMessage): void {\n\t\tthis.followUpQueue.enqueue(message);\n\t}\n\n\t/* Remove all queued steering messages. /\n\tclearSteeringQueue(): void {\n\t\tthis.steeringQueue.clear();\n\t}\n\n\t/* Remove all queued follow-up messages. /\n\tclearFollowUpQueue(): void {\n\t\tthis.followUpQueue.clear();\n\t}\n\n\t/* Remove all queued steering and follow-up messages. /\n\tclearAllQueues(): void {\n\t\tthis.clearSteeringQueue();\n\t\tthis.clearFollowUpQueue();\n\t}\n\n\t/* Returns true when either queue still contains pending messages. /\n\thasQueuedMessages(): boolean {\n\t\treturn this.steeringQueue.hasItems() \|\| this.followUpQueue.hasItems();\n\t}\n\n\t/* Active abort signal for the current run, if any. /\n\tget signal(): AbortSignal \| undefined {\n\t\treturn this.activeRun?.abortController.signal;\n\t}\n\n\t/* Abort the current run, if one is active. /\n\tabort(): void {\n\t\tthis.activeRun?.abortController.abort();\n\t}\n\n\t/\n\t Resolve when the current run and all awaited event listeners have finished.\n\t \n\t This resolves after `agent_end` listeners settle.\n\t /\n\twaitForIdle(): Promise<void> {\n\t\treturn this.activeRun?.promise ?? Promise.resolve();\n\t}\n\n\t/* Clear transcript state, runtime state, and queued messages. /\n\treset(): void {\n\t\tthis._state.messages = [];\n\t\tthis._state.isStreaming = false;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.pendingToolCalls = new Set<string>();\n\t\tthis._state.errorMessage = undefined;\n\t\tthis.clearFollowUpQueue();\n\t\tthis.clearSteeringQueue();\n\t\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive (#244, settlement #341). reset()\n\t\t// rejects the public promise of every unsettled harness invocation so awaiting callers stop\n\t\t// waiting. The effect on the record row differs by kind: a queued (not-yet-draining) call loses\n\t\t// its row entirely, while a transient in-flight call keeps running — reset() does not abort\n\t\t// transientRunAbort — so its row is still emitted and persisted; only its promise is rejected.\n\t\t// The warning surfaces the rejection so a lost queued row is diagnosable.\n\t\tif (this.unsettledHarnessTools.size > 0) {\n\t\t\tconst names = [...this.unsettledHarnessTools].map((record) => record.tool.name).join(\", \");\n\t\t\tconsole.warn(\n\t\t\t\t`Agent.reset() rejected ${this.unsettledHarnessTools.size} unsettled harness tool call(s): ${names}`,\n\t\t\t);\n\t\t}\n\t\tthis.rejectUnsettledHarnessTools(new Error(\"Agent.reset() discarded unsettled harness tool call\"));\n\t}\n\n\t/* Start a new prompt from text, a single message, or a batch of messages. /\n\tasync prompt(message: AgentMessage \| AgentMessage[]): Promise<void>;\n\tasync prompt(input: string, images?: ImageContent[]): Promise<void>;\n\tasync prompt(input: string \| AgentMessage \| AgentMessage[], images?: ImageContent[]): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\n\t\t\t\t\"Agent is already processing a prompt. Use steer() or followUp() to queue messages, or wait for completion.\",\n\t\t\t);\n\t\t}\n\t\tconst messages = this.normalizePromptInput(input, images);\n\t\tawait this.runPromptMessages(messages);\n\t}\n\n\t/* Continue from the current transcript. The last message must be a user or tool-result message. /\n\tasync continue(): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\"Agent is already processing. Wait for completion before continuing.\");\n\t\t}\n\n\t\tconst lastMessage = this._state.messages[this._state.messages.length - 1];\n\t\tif (!lastMessage) {\n\t\t\tthrow new Error(\"No messages to continue from\");\n\t\t}\n\n\t\tif (lastMessage.role === \"assistant\") {\n\t\t\tconst queuedSteering = this.steeringQueue.drain();\n\t\t\tif (queuedSteering.length > 0) {\n\t\t\t\tawait this.runPromptMessages(queuedSteering, { skipInitialSteeringPoll: true });\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst queuedFollowUps = this.followUpQueue.drain();\n\t\t\tif (queuedFollowUps.length > 0) {\n\t\t\t\tawait this.runPromptMessages(queuedFollowUps);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new Error(\"Cannot continue from message role: assistant\");\n\t\t}\n\n\t\tawait this.runContinuation();\n\t}\n\n\tprivate normalizePromptInput(\n\t\tinput: string \| AgentMessage \| AgentMessage[],\n\t\timages?: ImageContent[],\n\t): AgentMessage[] {\n\t\tif (Array.isArray(input)) {\n\t\t\treturn input;\n\t\t}\n\n\t\tif (typeof input !== \"string\") {\n\t\t\treturn [input];\n\t\t}\n\n\t\tconst content: Array<TextContent \| ImageContent> = [{ type: \"text\", text: input }];\n\t\tif (images && images.length > 0) {\n\t\t\tcontent.push(...images);\n\t\t}\n\t\treturn [{ role: \"user\", content, timestamp: Date.now() }];\n\t}\n\n\tprivate async runPromptMessages(\n\t\tmessages: AgentMessage[],\n\t\toptions: { skipInitialSteeringPoll?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.runWithLifecycle(async (signal) => {\n\t\t\tawait runAgentLoop(\n\t\t\t\tmessages,\n\t\t\t\tthis.createContextSnapshot(),\n\t\t\t\tthis.createLoopConfig(options),\n\t\t\t\t(event) => this.processEvents(event),\n\t\t\t\tsignal,\n\t\t\t\tthis.streamFn,\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate async runContinuation(): Promise<void> {\n\t\tawait this.runWithLifecycle(async (signal) => {\n\t\t\tawait runAgentLoopContinue(\n\t\t\t\tthis.createContextSnapshot(),\n\t\t\t\tthis.createLoopConfig(),\n\t\t\t\t(event) => this.processEvents(event),\n\t\t\t\tsignal,\n\t\t\t\tthis.streamFn,\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate createContextSnapshot(): AgentContext {\n\t\treturn {\n\t\t\tsystemPrompt: this._state.systemPrompt,\n\t\t\tmessages: this._state.messages.slice(),\n\t\t\ttools: this._state.tools.slice(),\n\t\t};\n\t}\n\n\tprivate createLoopConfig(options: { skipInitialSteeringPoll?: boolean } = {}): AgentLoopConfig {\n\t\tlet skipInitialSteeringPoll = options.skipInitialSteeringPoll === true;\n\t\treturn {\n\t\t\tmodel: this._state.model,\n\t\t\treasoning: this._state.thinkingLevel === \"off\" ? undefined : this._state.thinkingLevel,\n\t\t\tsessionId: this.sessionId,\n\t\t\tonPayload: this.onPayload,\n\t\t\tonResponse: this.onResponse,\n\t\t\ttransport: this.transport,\n\t\t\tthinkingBudgets: this.thinkingBudgets,\n\t\t\tmaxRetryDelayMs: this.maxRetryDelayMs,\n\t\t\ttoolExecution: this.toolExecution,\n\t\t\tbeforeToolBatch: this.beforeToolBatch,\n\t\t\tbeforeToolCall: this.beforeToolCall,\n\t\t\tafterToolCall: this.afterToolCall,\n\t\t\t// SCRAMJET-DIVERGENCE: always run prepareNextTurn so mid-run harness tool calls drain\n\t\t\t// before the next LLM call and live model/effort changes self-heal without overriding\n\t\t\t// explicit callback updates (#244, #447).\n\t\t\tprepareNextTurn: async (ctx) => {\n\t\t\t\tawait this.drainHarnessToolQueue(ctx, this.signal);\n\t\t\t\tconst update = await this.prepareNextTurn?.(ctx, this.signal);\n\t\t\t\treturn {\n\t\t\t\t\t...update,\n\t\t\t\t\tmodel: update?.model ?? this._state.model,\n\t\t\t\t\tthinkingLevel: update?.thinkingLevel ?? this._state.thinkingLevel,\n\t\t\t\t};\n\t\t\t},\n\t\t\tconvertToLlm: this.convertToLlm,\n\t\t\ttransformContext: this.transformContext,\n\t\t\tbeforeProviderCall: this.beforeProviderCall,\n\t\t\tgetApiKey: this.getApiKey,\n\t\t\tgetSteeringMessages: async () => {\n\t\t\t\tif (skipInitialSteeringPoll) {\n\t\t\t\t\tskipInitialSteeringPoll = false;\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t\treturn this.steeringQueue.drain();\n\t\t\t},\n\t\t\tgetFollowUpMessages: async () => this.followUpQueue.drain(),\n\t\t};\n\t}\n\n\tprivate async runWithLifecycle(executor: (signal: AbortSignal) => Promise<void>): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\"Agent is already processing.\");\n\t\t}\n\n\t\tconst abortController = new AbortController();\n\t\tlet resolvePromise = () => {};\n\t\tconst promise = new Promise<void>((resolve) => {\n\t\t\tresolvePromise = resolve;\n\t\t});\n\t\tthis.activeRun = { promise, resolve: resolvePromise, abortController };\n\n\t\tthis._state.isStreaming = true;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.errorMessage = undefined;\n\n\t\t// SCRAMJET-DIVERGENCE (#341): a failed final flush leaves later queued calls unable to execute.\n\t\t// Capture it (rejecting remnants below) and re-throw after finishRun so the error propagates out\n\t\t// of prompt()/continue() — not activeRun.promise, which finishRun always resolves — without a\n\t\t// lint-flagged throw inside a finally block. The { error } wrapper (not a bare `unknown` field)\n\t\t// is deliberate: it distinguishes \"no drain error\" from a falsy throw (e.g. `throw undefined`),\n\t\t// which a `!== undefined` check on a bare field would silently swallow.\n\t\tlet finalDrainError: { error: unknown } \| undefined;\n\t\ttry {\n\t\t\t// Wait for in-flight transient harness-tool runs so their events do not interleave\n\t\t\t// with this run's transcript.\n\t\t\twhile (this.transientRuns.size > 0) {\n\t\t\t\tawait Promise.all(this.transientRuns);\n\t\t\t}\n\t\t\tawait executor(abortController.signal);\n\t\t} catch (error) {\n\t\t\tawait this.handleRunFailure(error, abortController.signal.aborted);\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\t// Flush harness tool calls queued during the run's final turn — including failed or\n\t\t\t\t// aborted runs — after the last prepareNextTurn drain point, so a queued call is\n\t\t\t\t// never stranded. Emits messages/tool events but no run framing.\n\t\t\t\tawait this.drainHarnessToolQueue(undefined, abortController.signal);\n\t\t\t} catch (drainError) {\n\t\t\t\t// The failing call was already rejected by executeHarnessInvocation; reject the\n\t\t\t\t// remnants too so their promises settle.\n\t\t\t\tthis.rejectUnsettledHarnessTools(drainError instanceof Error ? drainError : new Error(String(drainError)));\n\t\t\t\tfinalDrainError = { error: drainError };\n\t\t\t} finally {\n\t\t\t\tthis.finishRun();\n\t\t\t}\n\t\t}\n\t\tif (finalDrainError) {\n\t\t\tthrow finalDrainError.error;\n\t\t}\n\t}\n\n\tprivate async handleRunFailure(error: unknown, aborted: boolean): Promise<void> {\n\t\tconst failureMessage = {\n\t\t\trole: \"assistant\",\n\t\t\torigin: \"harness\",\n\t\t\tcontent: [{ type: \"text\", text: \"\" }],\n\t\t\tapi: this._state.model.api,\n\t\t\tprovider: this._state.model.provider,\n\t\t\tmodel: this._state.model.id,\n\t\t\tusage: EMPTY_USAGE,\n\t\t\tstopReason: aborted ? \"aborted\" : \"error\",\n\t\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\t\ttimestamp: Date.now(),\n\t\t} satisfies AgentMessage;\n\t\tawait this.processEvents({ type: \"message_start\", message: failureMessage });\n\t\tawait this.processEvents({ type: \"message_end\", message: failureMessage });\n\t\tawait this.processEvents({ type: \"turn_end\", message: failureMessage, toolResults: [] });\n\t\tawait this.processEvents({ type: \"agent_end\", messages: [failureMessage] });\n\t}\n\n\tprivate finishRun(): void {\n\t\tthis._state.isStreaming = false;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.pendingToolCalls = new Set<string>();\n\t\tthis.activeRun?.resolve();\n\t\tthis.activeRun = undefined;\n\t}\n\n\t/\n\t Reduce internal state for a loop event, then await listeners.\n\t \n\t `agent_end` only means no further loop events will be emitted. The run is\n\t * considered idle later, after all awaited listeners for `agent_end` finish\n\t * and `finishRun()` clears runtime-owned state.\n\t /\n\tprivate async processEvents(event: AgentEvent): Promise<void> {\n\t\tswitch (event.type) {\n\t\t\tcase \"message_start\":\n\t\t\t\tthis._state.streamingMessage = event.message;\n\t\t\t\tbreak;\n\n\t\t\tcase \"message_update\":\n\t\t\t\tthis._state.streamingMessage = event.message;\n\t\t\t\tbreak;\n\n\t\t\tcase \"message_end\":\n\t\t\t\tthis._state.streamingMessage = undefined;\n\t\t\t\tthis._state.messages.push(event.message);\n\t\t\t\tbreak;\n\n\t\t\tcase \"tool_execution_start\": {\n\t\t\t\tconst pendingToolCalls = new Set(this._state.pendingToolCalls);\n\t\t\t\tpendingToolCalls.add(event.toolCallId);\n\t\t\t\tthis._state.pendingToolCalls = pendingToolCalls;\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"tool_execution_end\": {\n\t\t\t\tconst pendingToolCalls = new Set(this._state.pendingToolCalls);\n\t\t\t\tpendingToolCalls.delete(event.toolCallId);\n\t\t\t\tthis._state.pendingToolCalls = pendingToolCalls;\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"turn_end\":\n\t\t\t\tif (event.message.role === \"assistant\" && event.message.errorMessage) {\n\t\t\t\t\tthis._state.errorMessage = event.message.errorMessage;\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"agent_end\":\n\t\t\t\tthis._state.streamingMessage = undefined;\n\t\t\t\tbreak;\n\t\t}\n\n\t\t// SCRAMJET-DIVERGENCE: fall back to the shared transient-run signal while transient\n\t\t// harness-tool work (which intentionally has no `activeRun`) is in flight (#244).\n\t\tconst signal =\n\t\t\tthis.activeRun?.abortController.signal ??\n\t\t\t(this.transientRuns.size > 0 ? this.transientRunAbort.signal : undefined);\n\t\tif (!signal) {\n\t\t\tthrow new Error(\"Agent listener invoked outside active run\");\n\t\t}\n\t\tfor (const listener of this.listeners) {\n\t\t\tawait listener(event, signal);\n\t\t}\n\t}\n\n\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive (#244, execution settlement #341).\n\t/\n\t Execute a harness-originated tool call through the real execution pipeline.\n\t \n\t The tool object is supplied directly, so it need not appear in `state.tools` — this is what\n\t * lets LLM-invisible harness tools execute. The call produces the same `tool_execution_` and\n\t message events, persisted messages, and `beforeToolCall`/`afterToolCall` invocations as a\n\t * normal tool execution, but emits no run/turn framing events (`agent_start`, `turn_start`,\n\t * `turn_end`, `agent_end`). It is therefore intentionally invisible to every `agent_end`-keyed\n\t * consumer (probe scheduling, compaction bookkeeping).\n\t \n\t When idle, the call executes immediately in a transient run scope. When a run is active, it is\n\t * queued and drained at the next turn boundary — before the next intra-run LLM call — with an\n\t * end-of-run flush for calls queued during the run's final turn, so a queued call is never stranded.\n\t \n\t Settlement (#341). The returned promise resolves only after the call's full Agent-core\n\t * pipeline finishes: the synthetic assistant tool-call message, tool prepare/execute/finalize, the\n\t * tool-result message, Agent state reduction, and every awaited listener for those events. A queued\n\t * call therefore does not resolve at enqueue time — it resolves when the drain executes it. The\n\t * promise rejects when reset or session teardown revokes an unsettled invocation, when an\n\t * infrastructure/listener/hook failure escapes the pipeline, or when a failed final drain leaves a\n\t * later queued call unable to execute. A tool's own `execute()` throwing is not a rejection: it\n\t * becomes a normal `isError: true` tool result, so the promise resolves after that error-result\n\t * pipeline completes. Rejection means the promised pipeline did not complete — it does not prove\n\t * artifact absence (state and persistence may have partially completed), so callers must not blindly\n\t * retry.\n\t \n\t This settles Agent-core execution only. It does not prove AgentSession persistence;\n\t * `AgentSession.invokeHarnessTool` layers the persisted-settlement boundary on top of it.\n\t \n\t Reentrancy. Do not `await` this from work whose return is required for the Agent to reach the\n\t * drain point (a model-callable `execute`, `beforeToolBatch`/`beforeToolCall`/`afterToolCall`/\n\t * `prepareNextTurn`, or an awaited listener), or the queued call can never execute and the await\n\t * deadlocks. Start/capture the promise, return from the gating callback, and await it from an\n\t * independent continuation.\n\t /\n\tasync runHarnessTool(tool: AgentTool<any>, args: unknown, options: { toolCallId?: string } = {}): Promise<void> {\n\t\tconst toolCallId = options.toolCallId ?? generateHarnessToolCallId();\n\t\tconst record = this.createHarnessInvocation(tool, args, toolCallId);\n\t\tif (this.activeRun) {\n\t\t\tthis.harnessToolQueue.push(record);\n\t\t\treturn record.promise;\n\t\t}\n\t\t// Register the marker before the first event so processEvents sees transient work in\n\t\t// flight from the start, including for nested calls (a harness tool invoking another). The\n\t\t// marker tracks the underlying work even if reset/teardown rejects the public promise first,\n\t\t// so a later prompt still waits for the transient events to finish before emitting its own.\n\t\tlet settleMarker!: () => void;\n\t\tconst marker = new Promise<void>((resolve) => {\n\t\t\tsettleMarker = resolve;\n\t\t});\n\t\tthis.transientRuns.add(marker);\n\t\tvoid (async () => {\n\t\t\ttry {\n\t\t\t\tawait this.executeHarnessInvocation(record, this.transientRunAbort.signal, undefined);\n\t\t\t} catch {\n\t\t\t\t// The rejection is already recorded on record.promise; a transient run has no run-failure\n\t\t\t\t// path to propagate into, so nothing escapes here.\n\t\t\t} finally {\n\t\t\t\tthis.transientRuns.delete(marker);\n\t\t\t\tsettleMarker();\n\t\t\t}\n\t\t})();\n\t\treturn record.promise;\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): back a harness-tool invocation with a deferred promise and track it\n\t// as unsettled until it resolves or is rejected.\n\tprivate createHarnessInvocation(tool: AgentTool<any>, args: unknown, toolCallId: string): HarnessToolInvocation {\n\t\tlet resolve!: () => void;\n\t\tlet reject!: (reason: Error) => void;\n\t\tconst promise = new Promise<void>((res, rej) => {\n\t\t\tresolve = res;\n\t\t\treject = rej;\n\t\t});\n\t\tconst record: HarnessToolInvocation = { tool, args, toolCallId, promise, resolve, reject };\n\t\tthis.unsettledHarnessTools.add(record);\n\t\treturn record;\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): settle a harness invocation exactly once. Set membership is the\n\t// settled flag: unsettledHarnessTools.delete() returns false when the record was already removed\n\t// (e.g. underlying transient work finishing after reset already rejected it), so a later attempt\n\t// is a no-op.\n\tprivate settleHarnessInvocation(record: HarnessToolInvocation, error?: Error): void {\n\t\tif (!this.unsettledHarnessTools.delete(record)) return;\n\t\tif (error) record.reject(error);\n\t\telse record.resolve();\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): run one invocation's pipeline and settle its record. Infrastructure\n\t// failures reject the record and rethrow so the drain path preserves current run-failure behavior;\n\t// a tool's own execute() error is not seen here (it resolves as an isError tool result).\n\tprivate async executeHarnessInvocation(\n\t\trecord: HarnessToolInvocation,\n\t\tsignal: AbortSignal \| undefined,\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t): Promise<void> {\n\t\ttry {\n\t\t\tawait this.emitHarnessToolCall(record.tool, record.args, record.toolCallId, signal, ctx);\n\t\t} catch (error) {\n\t\t\tthis.settleHarnessInvocation(record, error instanceof Error ? error : new Error(String(error)));\n\t\t\tthrow error;\n\t\t}\n\t\tthis.settleHarnessInvocation(record);\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): idempotently clear the queue and reject every still-unsettled\n\t// invocation (queued, draining, or transient). Used by reset() and by the final-drain failure path.\n\trejectUnsettledHarnessTools(reason: Error): void {\n\t\tthis.harnessToolQueue.length = 0;\n\t\tfor (const record of [...this.unsettledHarnessTools]) {\n\t\t\tthis.settleHarnessInvocation(record, reason);\n\t\t}\n\t}\n\n\t/* Drain all queued harness tool calls, splicing them into `ctx` when draining mid-run. /\n\tprivate async drainHarnessToolQueue(\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t\tsignal: AbortSignal \| undefined,\n\t): Promise<void> {\n\t\twhile (this.harnessToolQueue.length > 0) {\n\t\t\tconst record = this.harnessToolQueue.shift()!;\n\t\t\tawait this.executeHarnessInvocation(record, signal, ctx);\n\t\t}\n\t}\n\n\t/\n\t Emit the full event sequence for one harness tool call: a synthetic single-toolCall assistant\n\t * message, then the tool execution and its result message. When `ctx` is provided (mid-run drain),\n\t * the synthetic messages are also spliced into the live turn context and returned-message set so\n\t * the next intra-run LLM call includes them.\n\t */\n\tprivate async emitHarnessToolCall(\n\t\ttool: AgentTool<any>,\n\t\targs: unknown,\n\t\ttoolCallId: string,\n\t\tsignal: AbortSignal \| undefined,\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t): Promise<void> {\n\t\tconst toolCall: AgentToolCall = {\n\t\t\ttype: \"toolCall\",\n\t\t\tid: toolCallId,\n\t\t\tname: tool.name,\n\t\t\targuments: (args ?? {}) as Record<string, any>,\n\t\t};\n\t\tconst assistantMessage = this.createHarnessAssistantMessage(toolCall);\n\t\tawait this.processEvents({ type: \"message_start\", message: assistantMessage });\n\t\tawait this.processEvents({ type: \"message_end\", message: assistantMessage });\n\t\tif (ctx) {\n\t\t\tctx.context.messages.push(assistantMessage);\n\t\t\tctx.newMessages.push(assistantMessage);\n\t\t}\n\n\t\tconst hookContext = ctx?.context ?? this.createContextSnapshot();\n\t\tconst toolResultMessage = await executeHarnessToolCall(\n\t\t\ttool,\n\t\t\ttoolCall,\n\t\t\thookContext,\n\t\t\tassistantMessage,\n\t\t\t{ beforeToolCall: this.beforeToolCall, afterToolCall: this.afterToolCall },\n\t\t\tsignal,\n\t\t\t(event) => this.processEvents(event),\n\t\t);\n\t\tif (ctx) {\n\t\t\tctx.context.messages.push(toolResultMessage);\n\t\t\tctx.newMessages.push(toolResultMessage);\n\t\t}\n\t}\n\n\tprivate createHarnessAssistantMessage(toolCall: AgentToolCall): AssistantMessage {\n\t\treturn {\n\t\t\trole: \"assistant\",\n\t\t\torigin: \"harness\",\n\t\t\tcontent: [toolCall],\n\t\t\tapi: this._state.model.api,\n\t\t\tprovider: this._state.model.provider,\n\t\t\tmodel: this._state.model.id,\n\t\t\tusage: EMPTY_USAGE,\n\t\t\tstopReason: \"toolUse\",\n\t\t\ttimestamp: Date.now(),\n\t\t};\n\t}\n}\n"]}
1	+ {"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\ttype AssistantMessage,\n\ttype ImageContent,\n\ttype Message,\n\ttype Model,\n\ttype SimpleStreamOptions,\n\tstreamSimple,\n\ttype TextContent,\n\ttype ThinkingBudgets,\n\ttype Transport,\n} from \"@leanandmean/ai\";\nimport { executeHarnessToolCall, runAgentLoop, runAgentLoopContinue } from \"./agent-loop.js\";\nimport type {\n\tAfterToolCallContext,\n\tAfterToolCallResult,\n\tAgentContext,\n\tAgentEvent,\n\tAgentLoopConfig,\n\tAgentLoopTurnUpdate,\n\tAgentMessage,\n\tAgentState,\n\tAgentTool,\n\tAgentToolCall,\n\tBeforeToolBatchContext,\n\tBeforeToolCallContext,\n\tBeforeToolCallResult,\n\tPrepareNextTurnContext,\n\tQueueMode,\n\tStreamFn,\n\tToolExecutionMode,\n} from \"./types.js\";\n\nexport type { QueueMode } from \"./types.js\";\n\nfunction defaultConvertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages.filter(\n\t\t(message) => message.role === \"user\" \|\| message.role === \"assistant\" \|\| message.role === \"toolResult\",\n\t);\n}\n\nconst EMPTY_USAGE = {\n\tinput: 0,\n\toutput: 0,\n\tcacheRead: 0,\n\tcacheWrite: 0,\n\ttotalTokens: 0,\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n};\n\nconst DEFAULT_MODEL = {\n\tid: \"unknown\",\n\tname: \"unknown\",\n\tapi: \"unknown\",\n\tprovider: \"unknown\",\n\tbaseUrl: \"\",\n\treasoning: false,\n\tinput: [],\n\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },\n\tcontextWindow: 0,\n\tmaxTokens: 0,\n} satisfies Model<any>;\n\n// SCRAMJET-DIVERGENCE: provider-safe tool-call id generation for harness-originated calls (#244).\n// The id must satisfy every provider's constraint (Anthropic's `^[a-zA-Z0-9_-]+$`, bounded length)\n// and must never embed raw model ids. A random suffix (not a bare counter) avoids collisions with\n// ids already present in a resumed transcript.\nexport function generateHarnessToolCallId(): string {\n\tconst uuid = globalThis.crypto?.randomUUID?.();\n\tconst suffix = uuid\n\t\t? uuid.replace(/-/g, \"\")\n\t\t: `${Date.now().toString(36)}${Math.floor(Math.random() * 1e9).toString(36)}`;\n\treturn `harness-tool-${suffix}`.slice(0, 64);\n}\n\ntype MutableAgentState = Omit<AgentState, \"isStreaming\" \| \"streamingMessage\" \| \"pendingToolCalls\" \| \"errorMessage\"> & {\n\tisStreaming: boolean;\n\tstreamingMessage?: AgentMessage;\n\tpendingToolCalls: Set<string>;\n\terrorMessage?: string;\n};\n\nfunction createMutableAgentState(\n\tinitialState?: Partial<Omit<AgentState, \"pendingToolCalls\" \| \"isStreaming\" \| \"streamingMessage\" \| \"errorMessage\">>,\n): MutableAgentState {\n\tlet tools = initialState?.tools?.slice() ?? [];\n\tlet messages = initialState?.messages?.slice() ?? [];\n\n\treturn {\n\t\tsystemPrompt: initialState?.systemPrompt ?? \"\",\n\t\tmodel: initialState?.model ?? DEFAULT_MODEL,\n\t\tthinkingLevel: initialState?.thinkingLevel ?? \"off\",\n\t\tget tools() {\n\t\t\treturn tools;\n\t\t},\n\t\tset tools(nextTools: AgentTool<any>[]) {\n\t\t\ttools = nextTools.slice();\n\t\t},\n\t\tget messages() {\n\t\t\treturn messages;\n\t\t},\n\t\tset messages(nextMessages: AgentMessage[]) {\n\t\t\tmessages = nextMessages.slice();\n\t\t},\n\t\tisStreaming: false,\n\t\tstreamingMessage: undefined,\n\t\tpendingToolCalls: new Set<string>(),\n\t\terrorMessage: undefined,\n\t};\n}\n\n/** Options for constructing an {@link Agent}. /\nexport interface AgentOptions {\n\tinitialState?: Partial<Omit<AgentState, \"pendingToolCalls\" \| \"isStreaming\" \| \"streamingMessage\" \| \"errorMessage\">>;\n\tconvertToLlm?: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tbeforeProviderCall?: AgentLoopConfig[\"beforeProviderCall\"];\n\tstreamFn?: StreamFn;\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tonPayload?: SimpleStreamOptions[\"onPayload\"];\n\tonResponse?: SimpleStreamOptions[\"onResponse\"];\n\tbeforeToolBatch?: (context: BeforeToolBatchContext, signal?: AbortSignal) => Promise<void>;\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\t// SCRAMJET-DIVERGENCE: prepareNextTurn receives the live turn context (previously the loop\n\t// context it passes was discarded by the Agent adapter) (#244).\n\tprepareNextTurn?: (\n\t\tctx: PrepareNextTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentLoopTurnUpdate \| undefined> \| AgentLoopTurnUpdate \| undefined;\n\tsteeringMode?: QueueMode;\n\tfollowUpMode?: QueueMode;\n\tsessionId?: string;\n\tthinkingBudgets?: ThinkingBudgets;\n\ttransport?: Transport;\n\tmaxRetryDelayMs?: number;\n\ttoolExecution?: ToolExecutionMode;\n}\n\nclass PendingMessageQueue {\n\tprivate messages: AgentMessage[] = [];\n\n\tconstructor(public mode: QueueMode) {}\n\n\tenqueue(message: AgentMessage): void {\n\t\tthis.messages.push(message);\n\t}\n\n\thasItems(): boolean {\n\t\treturn this.messages.length > 0;\n\t}\n\n\tdrain(): AgentMessage[] {\n\t\tif (this.mode === \"all\") {\n\t\t\tconst drained = this.messages.slice();\n\t\t\tthis.messages = [];\n\t\t\treturn drained;\n\t\t}\n\n\t\tconst first = this.messages[0];\n\t\tif (!first) {\n\t\t\treturn [];\n\t\t}\n\t\tthis.messages = this.messages.slice(1);\n\t\treturn [first];\n\t}\n\n\tclear(): void {\n\t\tthis.messages = [];\n\t}\n}\n\ntype ActiveRun = {\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\tabortController: AbortController;\n};\n\n// SCRAMJET-DIVERGENCE: harness-tool-invocation settlement records (#341).\n/\n One harness-tool invocation and the deferred promise that `runHarnessTool` returns for it. The\n * promise settles only when the invocation's Agent-core pipeline completes (resolve) or when\n * reset/teardown revokes the invocation or an infrastructure failure escapes the pipeline (reject).\n /\ntype HarnessToolInvocation = {\n\ttool: AgentTool<any>;\n\targs: unknown;\n\ttoolCallId: string;\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\treject: (reason: Error) => void;\n};\n\n/\n Stateful wrapper around the low-level agent loop.\n \n `Agent` owns the current transcript, emits lifecycle events, executes tools,\n * and exposes queueing APIs for steering and follow-up messages.\n /\nexport class Agent {\n\tprivate _state: MutableAgentState;\n\tprivate readonly listeners = new Set<(event: AgentEvent, signal: AbortSignal) => Promise<void> \| void>();\n\tprivate readonly steeringQueue: PendingMessageQueue;\n\tprivate readonly followUpQueue: PendingMessageQueue;\n\n\tpublic convertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\tpublic transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tpublic beforeProviderCall?: AgentLoopConfig[\"beforeProviderCall\"];\n\tpublic streamFn: StreamFn;\n\tpublic getApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tpublic onPayload?: SimpleStreamOptions[\"onPayload\"];\n\tpublic onResponse?: SimpleStreamOptions[\"onResponse\"];\n\t// SCRAMJET-DIVERGENCE: beforeToolBatch hook — async message_end mutations must settle before tool-call extraction\n\tpublic beforeToolBatch?: (context: BeforeToolBatchContext, signal?: AbortSignal) => Promise<void>;\n\tpublic beforeToolCall?: (\n\t\tcontext: BeforeToolCallContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<BeforeToolCallResult \| undefined>;\n\tpublic afterToolCall?: (\n\t\tcontext: AfterToolCallContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AfterToolCallResult \| undefined>;\n\tpublic prepareNextTurn?: (\n\t\tctx: PrepareNextTurnContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentLoopTurnUpdate \| undefined> \| AgentLoopTurnUpdate \| undefined;\n\tprivate activeRun?: ActiveRun;\n\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive state (#244, settlement #341).\n\t/* Harness tool invocations queued while a run is active, drained at the next turn boundary. /\n\tprivate readonly harnessToolQueue: HarnessToolInvocation[] = [];\n\t/\n\t Every harness-tool invocation whose public promise has not yet settled — queued, shifted and\n\t * draining, or transient. Reset/teardown rejects this set; each invocation is removed as it\n\t * settles. Queue length is not a proxy for this: a draining call has left the queue but is still\n\t * unsettled (#341).\n\t /\n\tprivate readonly unsettledHarnessTools = new Set<HarnessToolInvocation>();\n\t/\n\t Markers for in-flight transient (idle) harness-tool runs; each resolves when its run settles.\n\t * A set (not a single field) keeps nested and overlapping transient runs valid, and lets a new\n\t * real run wait for transient work to finish before emitting its own events.\n\t /\n\tprivate readonly transientRuns = new Set<Promise<void>>();\n\t/* Shared, never-aborted signal delivered to listeners during transient harness-tool runs. /\n\tprivate readonly transientRunAbort = new AbortController();\n\t/* Session identifier forwarded to providers for cache-aware backends. /\n\tpublic sessionId?: string;\n\t/* Optional per-level thinking token budgets forwarded to the stream function. /\n\tpublic thinkingBudgets?: ThinkingBudgets;\n\t/* Preferred transport forwarded to the stream function. /\n\tpublic transport: Transport;\n\t/* Optional cap for provider-requested retry delays. /\n\tpublic maxRetryDelayMs?: number;\n\t/* Tool execution strategy for assistant messages that contain multiple tool calls. /\n\tpublic toolExecution: ToolExecutionMode;\n\n\tconstructor(options: AgentOptions = {}) {\n\t\tthis._state = createMutableAgentState(options.initialState);\n\t\tthis.convertToLlm = options.convertToLlm ?? defaultConvertToLlm;\n\t\tthis.transformContext = options.transformContext;\n\t\tthis.beforeProviderCall = options.beforeProviderCall;\n\t\tthis.streamFn = options.streamFn ?? streamSimple;\n\t\tthis.getApiKey = options.getApiKey;\n\t\tthis.onPayload = options.onPayload;\n\t\tthis.onResponse = options.onResponse;\n\t\tthis.beforeToolBatch = options.beforeToolBatch;\n\t\tthis.beforeToolCall = options.beforeToolCall;\n\t\tthis.afterToolCall = options.afterToolCall;\n\t\tthis.prepareNextTurn = options.prepareNextTurn;\n\t\tthis.steeringQueue = new PendingMessageQueue(options.steeringMode ?? \"one-at-a-time\");\n\t\tthis.followUpQueue = new PendingMessageQueue(options.followUpMode ?? \"one-at-a-time\");\n\t\tthis.sessionId = options.sessionId;\n\t\tthis.thinkingBudgets = options.thinkingBudgets;\n\t\tthis.transport = options.transport ?? \"auto\";\n\t\tthis.maxRetryDelayMs = options.maxRetryDelayMs;\n\t\tthis.toolExecution = options.toolExecution ?? \"parallel\";\n\t}\n\n\t/\n\t Subscribe to agent lifecycle events.\n\t \n\t Listener promises are awaited in subscription order and are included in\n\t * the current run's settlement. Listeners also receive the active abort\n\t * signal for the current run.\n\t \n\t `agent_end` is the final emitted event for a run, but the agent does not\n\t * become idle until all awaited listeners for that event have settled.\n\t /\n\tsubscribe(listener: (event: AgentEvent, signal: AbortSignal) => Promise<void> \| void): () => void {\n\t\tthis.listeners.add(listener);\n\t\treturn () => this.listeners.delete(listener);\n\t}\n\n\t/\n\t Current agent state.\n\t \n\t Assigning `state.tools` or `state.messages` copies the provided top-level array.\n\t /\n\tget state(): AgentState {\n\t\treturn this._state;\n\t}\n\n\t/* Controls how queued steering messages are drained. /\n\tset steeringMode(mode: QueueMode) {\n\t\tthis.steeringQueue.mode = mode;\n\t}\n\n\tget steeringMode(): QueueMode {\n\t\treturn this.steeringQueue.mode;\n\t}\n\n\t/* Controls how queued follow-up messages are drained. /\n\tset followUpMode(mode: QueueMode) {\n\t\tthis.followUpQueue.mode = mode;\n\t}\n\n\tget followUpMode(): QueueMode {\n\t\treturn this.followUpQueue.mode;\n\t}\n\n\t/* Queue a message to be injected after the current assistant turn finishes. /\n\tsteer(message: AgentMessage): void {\n\t\tthis.steeringQueue.enqueue(message);\n\t}\n\n\t/* Queue a message to run only after the agent would otherwise stop. /\n\tfollowUp(message: AgentMessage): void {\n\t\tthis.followUpQueue.enqueue(message);\n\t}\n\n\t/* Remove all queued steering messages. /\n\tclearSteeringQueue(): void {\n\t\tthis.steeringQueue.clear();\n\t}\n\n\t/* Remove all queued follow-up messages. /\n\tclearFollowUpQueue(): void {\n\t\tthis.followUpQueue.clear();\n\t}\n\n\t/* Remove all queued steering and follow-up messages. /\n\tclearAllQueues(): void {\n\t\tthis.clearSteeringQueue();\n\t\tthis.clearFollowUpQueue();\n\t}\n\n\t/* Returns true when either queue still contains pending messages. /\n\thasQueuedMessages(): boolean {\n\t\treturn this.steeringQueue.hasItems() \|\| this.followUpQueue.hasItems();\n\t}\n\n\t/* Active abort signal for the current run, if any. /\n\tget signal(): AbortSignal \| undefined {\n\t\treturn this.activeRun?.abortController.signal;\n\t}\n\n\t/* Abort the current run, if one is active. /\n\tabort(): void {\n\t\tthis.activeRun?.abortController.abort();\n\t}\n\n\t/\n\t Resolve when the current run and all awaited event listeners have finished.\n\t \n\t This resolves after `agent_end` listeners settle.\n\t /\n\twaitForIdle(): Promise<void> {\n\t\treturn this.activeRun?.promise ?? Promise.resolve();\n\t}\n\n\t/* Clear transcript state, runtime state, and queued messages. /\n\treset(): void {\n\t\tthis._state.messages = [];\n\t\tthis._state.isStreaming = false;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.pendingToolCalls = new Set<string>();\n\t\tthis._state.errorMessage = undefined;\n\t\tthis.clearFollowUpQueue();\n\t\tthis.clearSteeringQueue();\n\t\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive (#244, settlement #341). reset()\n\t\t// rejects the public promise of every unsettled harness invocation so awaiting callers stop\n\t\t// waiting. The effect on the record row differs by kind: a queued (not-yet-draining) call loses\n\t\t// its row entirely, while a transient in-flight call keeps running — reset() does not abort\n\t\t// transientRunAbort — so its row is still emitted and persisted; only its promise is rejected.\n\t\t// The warning surfaces the rejection so a lost queued row is diagnosable.\n\t\tif (this.unsettledHarnessTools.size > 0) {\n\t\t\tconst names = [...this.unsettledHarnessTools].map((record) => record.tool.name).join(\", \");\n\t\t\tconsole.warn(\n\t\t\t\t`Agent.reset() rejected ${this.unsettledHarnessTools.size} unsettled harness tool call(s): ${names}`,\n\t\t\t);\n\t\t}\n\t\tthis.rejectUnsettledHarnessTools(new Error(\"Agent.reset() discarded unsettled harness tool call\"));\n\t}\n\n\t/* Start a new prompt from text, a single message, or a batch of messages. /\n\tasync prompt(message: AgentMessage \| AgentMessage[]): Promise<void>;\n\tasync prompt(input: string, images?: ImageContent[]): Promise<void>;\n\tasync prompt(input: string \| AgentMessage \| AgentMessage[], images?: ImageContent[]): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\n\t\t\t\t\"Agent is already processing a prompt. Use steer() or followUp() to queue messages, or wait for completion.\",\n\t\t\t);\n\t\t}\n\t\tconst messages = this.normalizePromptInput(input, images);\n\t\tawait this.runPromptMessages(messages);\n\t}\n\n\t/* Continue from the current transcript. The last message must be a user or tool-result message. /\n\tasync continue(): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\"Agent is already processing. Wait for completion before continuing.\");\n\t\t}\n\n\t\tconst lastMessage = this._state.messages[this._state.messages.length - 1];\n\t\tif (!lastMessage) {\n\t\t\tthrow new Error(\"No messages to continue from\");\n\t\t}\n\n\t\tif (lastMessage.role === \"assistant\") {\n\t\t\tconst queuedSteering = this.steeringQueue.drain();\n\t\t\tif (queuedSteering.length > 0) {\n\t\t\t\tawait this.runPromptMessages(queuedSteering, { skipInitialSteeringPoll: true });\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst queuedFollowUps = this.followUpQueue.drain();\n\t\t\tif (queuedFollowUps.length > 0) {\n\t\t\t\tawait this.runPromptMessages(queuedFollowUps);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new Error(\"Cannot continue from message role: assistant\");\n\t\t}\n\n\t\tawait this.runContinuation();\n\t}\n\n\tprivate normalizePromptInput(\n\t\tinput: string \| AgentMessage \| AgentMessage[],\n\t\timages?: ImageContent[],\n\t): AgentMessage[] {\n\t\tif (Array.isArray(input)) {\n\t\t\treturn input;\n\t\t}\n\n\t\tif (typeof input !== \"string\") {\n\t\t\treturn [input];\n\t\t}\n\n\t\tconst content: Array<TextContent \| ImageContent> = [{ type: \"text\", text: input }];\n\t\tif (images && images.length > 0) {\n\t\t\tcontent.push(...images);\n\t\t}\n\t\treturn [{ role: \"user\", content, timestamp: Date.now() }];\n\t}\n\n\tprivate async runPromptMessages(\n\t\tmessages: AgentMessage[],\n\t\toptions: { skipInitialSteeringPoll?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.runWithLifecycle(async (signal) => {\n\t\t\tawait runAgentLoop(\n\t\t\t\tmessages,\n\t\t\t\tthis.createContextSnapshot(),\n\t\t\t\tthis.createLoopConfig(options),\n\t\t\t\t(event) => this.processEvents(event),\n\t\t\t\tsignal,\n\t\t\t\tthis.streamFn,\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate async runContinuation(): Promise<void> {\n\t\tawait this.runWithLifecycle(async (signal) => {\n\t\t\tawait runAgentLoopContinue(\n\t\t\t\tthis.createContextSnapshot(),\n\t\t\t\tthis.createLoopConfig(),\n\t\t\t\t(event) => this.processEvents(event),\n\t\t\t\tsignal,\n\t\t\t\tthis.streamFn,\n\t\t\t);\n\t\t});\n\t}\n\n\tprivate createContextSnapshot(): AgentContext {\n\t\treturn {\n\t\t\tsystemPrompt: this._state.systemPrompt,\n\t\t\tmessages: this._state.messages.slice(),\n\t\t\ttools: this._state.tools.slice(),\n\t\t};\n\t}\n\n\tprivate createLoopConfig(options: { skipInitialSteeringPoll?: boolean } = {}): AgentLoopConfig {\n\t\tlet skipInitialSteeringPoll = options.skipInitialSteeringPoll === true;\n\t\treturn {\n\t\t\tmodel: this._state.model,\n\t\t\treasoning: this._state.thinkingLevel === \"off\" ? undefined : this._state.thinkingLevel,\n\t\t\tsessionId: this.sessionId,\n\t\t\tonPayload: this.onPayload,\n\t\t\tonResponse: this.onResponse,\n\t\t\ttransport: this.transport,\n\t\t\tthinkingBudgets: this.thinkingBudgets,\n\t\t\tmaxRetryDelayMs: this.maxRetryDelayMs,\n\t\t\ttoolExecution: this.toolExecution,\n\t\t\tbeforeToolBatch: this.beforeToolBatch,\n\t\t\tbeforeToolCall: this.beforeToolCall,\n\t\t\tafterToolCall: this.afterToolCall,\n\t\t\t// SCRAMJET-DIVERGENCE: always run prepareNextTurn so mid-run harness tool calls drain\n\t\t\t// and live request context/routing self-heals without overriding explicit callback updates\n\t\t\t// (#244, #447, #524).\n\t\t\tprepareNextTurn: async (ctx) => {\n\t\t\t\tawait this.drainHarnessToolQueue(ctx, this.signal);\n\t\t\t\tconst liveSystemPrompt = this._state.systemPrompt;\n\t\t\t\tconst refreshedContext: AgentContext = {\n\t\t\t\t\tsystemPrompt: Array.isArray(liveSystemPrompt) ? liveSystemPrompt.slice() : liveSystemPrompt,\n\t\t\t\t\tmessages: ctx.context.messages,\n\t\t\t\t\ttools: this._state.tools.slice(),\n\t\t\t\t};\n\t\t\t\tconst update = await this.prepareNextTurn?.({ ...ctx, context: refreshedContext }, this.signal);\n\t\t\t\treturn {\n\t\t\t\t\t...update,\n\t\t\t\t\tcontext: update?.context ?? refreshedContext,\n\t\t\t\t\tmodel: update?.model ?? this._state.model,\n\t\t\t\t\tthinkingLevel: update?.thinkingLevel ?? this._state.thinkingLevel,\n\t\t\t\t};\n\t\t\t},\n\t\t\tconvertToLlm: this.convertToLlm,\n\t\t\ttransformContext: this.transformContext,\n\t\t\tbeforeProviderCall: this.beforeProviderCall,\n\t\t\tgetApiKey: this.getApiKey,\n\t\t\tgetSteeringMessages: async () => {\n\t\t\t\tif (skipInitialSteeringPoll) {\n\t\t\t\t\tskipInitialSteeringPoll = false;\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\t\t\t\treturn this.steeringQueue.drain();\n\t\t\t},\n\t\t\tgetFollowUpMessages: async () => this.followUpQueue.drain(),\n\t\t};\n\t}\n\n\tprivate async runWithLifecycle(executor: (signal: AbortSignal) => Promise<void>): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new Error(\"Agent is already processing.\");\n\t\t}\n\n\t\tconst abortController = new AbortController();\n\t\tlet resolvePromise = () => {};\n\t\tconst promise = new Promise<void>((resolve) => {\n\t\t\tresolvePromise = resolve;\n\t\t});\n\t\tthis.activeRun = { promise, resolve: resolvePromise, abortController };\n\n\t\tthis._state.isStreaming = true;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.errorMessage = undefined;\n\n\t\t// SCRAMJET-DIVERGENCE (#341): a failed final flush leaves later queued calls unable to execute.\n\t\t// Capture it (rejecting remnants below) and re-throw after finishRun so the error propagates out\n\t\t// of prompt()/continue() — not activeRun.promise, which finishRun always resolves — without a\n\t\t// lint-flagged throw inside a finally block. The { error } wrapper (not a bare `unknown` field)\n\t\t// is deliberate: it distinguishes \"no drain error\" from a falsy throw (e.g. `throw undefined`),\n\t\t// which a `!== undefined` check on a bare field would silently swallow.\n\t\tlet finalDrainError: { error: unknown } \| undefined;\n\t\ttry {\n\t\t\t// Wait for in-flight transient harness-tool runs so their events do not interleave\n\t\t\t// with this run's transcript.\n\t\t\twhile (this.transientRuns.size > 0) {\n\t\t\t\tawait Promise.all(this.transientRuns);\n\t\t\t}\n\t\t\tawait executor(abortController.signal);\n\t\t} catch (error) {\n\t\t\tawait this.handleRunFailure(error, abortController.signal.aborted);\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\t// Flush harness tool calls queued during the run's final turn — including failed or\n\t\t\t\t// aborted runs — after the last prepareNextTurn drain point, so a queued call is\n\t\t\t\t// never stranded. Emits messages/tool events but no run framing.\n\t\t\t\tawait this.drainHarnessToolQueue(undefined, abortController.signal);\n\t\t\t} catch (drainError) {\n\t\t\t\t// The failing call was already rejected by executeHarnessInvocation; reject the\n\t\t\t\t// remnants too so their promises settle.\n\t\t\t\tthis.rejectUnsettledHarnessTools(drainError instanceof Error ? drainError : new Error(String(drainError)));\n\t\t\t\tfinalDrainError = { error: drainError };\n\t\t\t} finally {\n\t\t\t\tthis.finishRun();\n\t\t\t}\n\t\t}\n\t\tif (finalDrainError) {\n\t\t\tthrow finalDrainError.error;\n\t\t}\n\t}\n\n\tprivate async handleRunFailure(error: unknown, aborted: boolean): Promise<void> {\n\t\tconst failureMessage = {\n\t\t\trole: \"assistant\",\n\t\t\torigin: \"harness\",\n\t\t\tcontent: [{ type: \"text\", text: \"\" }],\n\t\t\tapi: this._state.model.api,\n\t\t\tprovider: this._state.model.provider,\n\t\t\tmodel: this._state.model.id,\n\t\t\tusage: EMPTY_USAGE,\n\t\t\tstopReason: aborted ? \"aborted\" : \"error\",\n\t\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\t\ttimestamp: Date.now(),\n\t\t} satisfies AgentMessage;\n\t\tawait this.processEvents({ type: \"message_start\", message: failureMessage });\n\t\tawait this.processEvents({ type: \"message_end\", message: failureMessage });\n\t\tawait this.processEvents({ type: \"turn_end\", message: failureMessage, toolResults: [] });\n\t\tawait this.processEvents({ type: \"agent_end\", messages: [failureMessage] });\n\t}\n\n\tprivate finishRun(): void {\n\t\tthis._state.isStreaming = false;\n\t\tthis._state.streamingMessage = undefined;\n\t\tthis._state.pendingToolCalls = new Set<string>();\n\t\tthis.activeRun?.resolve();\n\t\tthis.activeRun = undefined;\n\t}\n\n\t/\n\t Reduce internal state for a loop event, then await listeners.\n\t \n\t `agent_end` only means no further loop events will be emitted. The run is\n\t * considered idle later, after all awaited listeners for `agent_end` finish\n\t * and `finishRun()` clears runtime-owned state.\n\t /\n\tprivate async processEvents(event: AgentEvent): Promise<void> {\n\t\tswitch (event.type) {\n\t\t\tcase \"message_start\":\n\t\t\t\tthis._state.streamingMessage = event.message;\n\t\t\t\tbreak;\n\n\t\t\tcase \"message_update\":\n\t\t\t\tthis._state.streamingMessage = event.message;\n\t\t\t\tbreak;\n\n\t\t\tcase \"message_end\":\n\t\t\t\tthis._state.streamingMessage = undefined;\n\t\t\t\tthis._state.messages.push(event.message);\n\t\t\t\tbreak;\n\n\t\t\tcase \"tool_execution_start\": {\n\t\t\t\tconst pendingToolCalls = new Set(this._state.pendingToolCalls);\n\t\t\t\tpendingToolCalls.add(event.toolCallId);\n\t\t\t\tthis._state.pendingToolCalls = pendingToolCalls;\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"tool_execution_end\": {\n\t\t\t\tconst pendingToolCalls = new Set(this._state.pendingToolCalls);\n\t\t\t\tpendingToolCalls.delete(event.toolCallId);\n\t\t\t\tthis._state.pendingToolCalls = pendingToolCalls;\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tcase \"turn_end\":\n\t\t\t\tif (event.message.role === \"assistant\" && event.message.errorMessage) {\n\t\t\t\t\tthis._state.errorMessage = event.message.errorMessage;\n\t\t\t\t}\n\t\t\t\tbreak;\n\n\t\t\tcase \"agent_end\":\n\t\t\t\tthis._state.streamingMessage = undefined;\n\t\t\t\tbreak;\n\t\t}\n\n\t\t// SCRAMJET-DIVERGENCE: fall back to the shared transient-run signal while transient\n\t\t// harness-tool work (which intentionally has no `activeRun`) is in flight (#244).\n\t\tconst signal =\n\t\t\tthis.activeRun?.abortController.signal ??\n\t\t\t(this.transientRuns.size > 0 ? this.transientRunAbort.signal : undefined);\n\t\tif (!signal) {\n\t\t\tthrow new Error(\"Agent listener invoked outside active run\");\n\t\t}\n\t\tfor (const listener of this.listeners) {\n\t\t\tawait listener(event, signal);\n\t\t}\n\t}\n\n\t// SCRAMJET-DIVERGENCE: harness-tool-invocation primitive (#244, execution settlement #341).\n\t/\n\t Execute a harness-originated tool call through the real execution pipeline.\n\t \n\t The tool object is supplied directly, so it need not appear in `state.tools` — this is what\n\t * lets LLM-invisible harness tools execute. The call produces the same `tool_execution_` and\n\t message events, persisted messages, and `beforeToolCall`/`afterToolCall` invocations as a\n\t * normal tool execution, but emits no run/turn framing events (`agent_start`, `turn_start`,\n\t * `turn_end`, `agent_end`). It is therefore intentionally invisible to every `agent_end`-keyed\n\t * consumer (probe scheduling, compaction bookkeeping).\n\t \n\t When idle, the call executes immediately in a transient run scope. When a run is active, it is\n\t * queued and drained at the next turn boundary — before the next intra-run LLM call — with an\n\t * end-of-run flush for calls queued during the run's final turn, so a queued call is never stranded.\n\t \n\t Settlement (#341). The returned promise resolves only after the call's full Agent-core\n\t * pipeline finishes: the synthetic assistant tool-call message, tool prepare/execute/finalize, the\n\t * tool-result message, Agent state reduction, and every awaited listener for those events. A queued\n\t * call therefore does not resolve at enqueue time — it resolves when the drain executes it. The\n\t * promise rejects when reset or session teardown revokes an unsettled invocation, when an\n\t * infrastructure/listener/hook failure escapes the pipeline, or when a failed final drain leaves a\n\t * later queued call unable to execute. A tool's own `execute()` throwing is not a rejection: it\n\t * becomes a normal `isError: true` tool result, so the promise resolves after that error-result\n\t * pipeline completes. Rejection means the promised pipeline did not complete — it does not prove\n\t * artifact absence (state and persistence may have partially completed), so callers must not blindly\n\t * retry.\n\t \n\t This settles Agent-core execution only. It does not prove AgentSession persistence;\n\t * `AgentSession.invokeHarnessTool` layers the persisted-settlement boundary on top of it.\n\t \n\t Reentrancy. Do not `await` this from work whose return is required for the Agent to reach the\n\t * drain point (a model-callable `execute`, `beforeToolBatch`/`beforeToolCall`/`afterToolCall`/\n\t * `prepareNextTurn`, or an awaited listener), or the queued call can never execute and the await\n\t * deadlocks. Start/capture the promise, return from the gating callback, and await it from an\n\t * independent continuation.\n\t /\n\tasync runHarnessTool(tool: AgentTool<any>, args: unknown, options: { toolCallId?: string } = {}): Promise<void> {\n\t\tconst toolCallId = options.toolCallId ?? generateHarnessToolCallId();\n\t\tconst record = this.createHarnessInvocation(tool, args, toolCallId);\n\t\tif (this.activeRun) {\n\t\t\tthis.harnessToolQueue.push(record);\n\t\t\treturn record.promise;\n\t\t}\n\t\t// Register the marker before the first event so processEvents sees transient work in\n\t\t// flight from the start, including for nested calls (a harness tool invoking another). The\n\t\t// marker tracks the underlying work even if reset/teardown rejects the public promise first,\n\t\t// so a later prompt still waits for the transient events to finish before emitting its own.\n\t\tlet settleMarker!: () => void;\n\t\tconst marker = new Promise<void>((resolve) => {\n\t\t\tsettleMarker = resolve;\n\t\t});\n\t\tthis.transientRuns.add(marker);\n\t\tvoid (async () => {\n\t\t\ttry {\n\t\t\t\tawait this.executeHarnessInvocation(record, this.transientRunAbort.signal, undefined);\n\t\t\t} catch {\n\t\t\t\t// The rejection is already recorded on record.promise; a transient run has no run-failure\n\t\t\t\t// path to propagate into, so nothing escapes here.\n\t\t\t} finally {\n\t\t\t\tthis.transientRuns.delete(marker);\n\t\t\t\tsettleMarker();\n\t\t\t}\n\t\t})();\n\t\treturn record.promise;\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): back a harness-tool invocation with a deferred promise and track it\n\t// as unsettled until it resolves or is rejected.\n\tprivate createHarnessInvocation(tool: AgentTool<any>, args: unknown, toolCallId: string): HarnessToolInvocation {\n\t\tlet resolve!: () => void;\n\t\tlet reject!: (reason: Error) => void;\n\t\tconst promise = new Promise<void>((res, rej) => {\n\t\t\tresolve = res;\n\t\t\treject = rej;\n\t\t});\n\t\tconst record: HarnessToolInvocation = { tool, args, toolCallId, promise, resolve, reject };\n\t\tthis.unsettledHarnessTools.add(record);\n\t\treturn record;\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): settle a harness invocation exactly once. Set membership is the\n\t// settled flag: unsettledHarnessTools.delete() returns false when the record was already removed\n\t// (e.g. underlying transient work finishing after reset already rejected it), so a later attempt\n\t// is a no-op.\n\tprivate settleHarnessInvocation(record: HarnessToolInvocation, error?: Error): void {\n\t\tif (!this.unsettledHarnessTools.delete(record)) return;\n\t\tif (error) record.reject(error);\n\t\telse record.resolve();\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): run one invocation's pipeline and settle its record. Infrastructure\n\t// failures reject the record and rethrow so the drain path preserves current run-failure behavior;\n\t// a tool's own execute() error is not seen here (it resolves as an isError tool result).\n\tprivate async executeHarnessInvocation(\n\t\trecord: HarnessToolInvocation,\n\t\tsignal: AbortSignal \| undefined,\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t): Promise<void> {\n\t\ttry {\n\t\t\tawait this.emitHarnessToolCall(record.tool, record.args, record.toolCallId, signal, ctx);\n\t\t} catch (error) {\n\t\t\tthis.settleHarnessInvocation(record, error instanceof Error ? error : new Error(String(error)));\n\t\t\tthrow error;\n\t\t}\n\t\tthis.settleHarnessInvocation(record);\n\t}\n\n\t// SCRAMJET-DIVERGENCE (#341): idempotently clear the queue and reject every still-unsettled\n\t// invocation (queued, draining, or transient). Used by reset() and by the final-drain failure path.\n\trejectUnsettledHarnessTools(reason: Error): void {\n\t\tthis.harnessToolQueue.length = 0;\n\t\tfor (const record of [...this.unsettledHarnessTools]) {\n\t\t\tthis.settleHarnessInvocation(record, reason);\n\t\t}\n\t}\n\n\t/* Drain all queued harness tool calls, splicing them into `ctx` when draining mid-run. /\n\tprivate async drainHarnessToolQueue(\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t\tsignal: AbortSignal \| undefined,\n\t): Promise<void> {\n\t\twhile (this.harnessToolQueue.length > 0) {\n\t\t\tconst record = this.harnessToolQueue.shift()!;\n\t\t\tawait this.executeHarnessInvocation(record, signal, ctx);\n\t\t}\n\t}\n\n\t/\n\t Emit the full event sequence for one harness tool call: a synthetic single-toolCall assistant\n\t * message, then the tool execution and its result message. When `ctx` is provided (mid-run drain),\n\t * the synthetic messages are also spliced into the live turn context and returned-message set so\n\t * the next intra-run LLM call includes them.\n\t */\n\tprivate async emitHarnessToolCall(\n\t\ttool: AgentTool<any>,\n\t\targs: unknown,\n\t\ttoolCallId: string,\n\t\tsignal: AbortSignal \| undefined,\n\t\tctx: PrepareNextTurnContext \| undefined,\n\t): Promise<void> {\n\t\tconst toolCall: AgentToolCall = {\n\t\t\ttype: \"toolCall\",\n\t\t\tid: toolCallId,\n\t\t\tname: tool.name,\n\t\t\targuments: (args ?? {}) as Record<string, any>,\n\t\t};\n\t\tconst assistantMessage = this.createHarnessAssistantMessage(toolCall);\n\t\tawait this.processEvents({ type: \"message_start\", message: assistantMessage });\n\t\tawait this.processEvents({ type: \"message_end\", message: assistantMessage });\n\t\tif (ctx) {\n\t\t\tctx.context.messages.push(assistantMessage);\n\t\t\tctx.newMessages.push(assistantMessage);\n\t\t}\n\n\t\tconst hookContext = ctx?.context ?? this.createContextSnapshot();\n\t\tconst toolResultMessage = await executeHarnessToolCall(\n\t\t\ttool,\n\t\t\ttoolCall,\n\t\t\thookContext,\n\t\t\tassistantMessage,\n\t\t\t{ beforeToolCall: this.beforeToolCall, afterToolCall: this.afterToolCall },\n\t\t\tsignal,\n\t\t\t(event) => this.processEvents(event),\n\t\t);\n\t\tif (ctx) {\n\t\t\tctx.context.messages.push(toolResultMessage);\n\t\t\tctx.newMessages.push(toolResultMessage);\n\t\t}\n\t}\n\n\tprivate createHarnessAssistantMessage(toolCall: AgentToolCall): AssistantMessage {\n\t\treturn {\n\t\t\trole: \"assistant\",\n\t\t\torigin: \"harness\",\n\t\t\tcontent: [toolCall],\n\t\t\tapi: this._state.model.api,\n\t\t\tprovider: this._state.model.provider,\n\t\t\tmodel: this._state.model.id,\n\t\t\tusage: EMPTY_USAGE,\n\t\t\tstopReason: \"toolUse\",\n\t\t\ttimestamp: Date.now(),\n\t\t};\n\t}\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "@leanandmean/agent",
-	"version": "0.74.1-scramjet.21",
+	"version": "0.74.1-scramjet.23",
 	"publishConfig": {
 		"access": "public"
 	},
@@ -32,7 +32,7 @@
 		"test": "vitest --run --passWithNoTests"
 	},
 	"dependencies": {
-		"@leanandmean/ai": "0.74.1-scramjet.17",
+		"@leanandmean/ai": "0.74.1-scramjet.19",
 		"ignore": "^7.0.5",
 		"typebox": "^1.1.24",
 		"yaml": "^2.8.2"