npm - @ponythewhite/base-context-agent - Versions diffs - 1.0.0 → 1.0.2 - Mend

@ponythewhite/base-context-agent 1.0.0 → 1.0.2

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 (11) hide show

package/NOTICE CHANGED Viewed

@@ -14,9 +14,4 @@ this fork is not an official Prime Intellect release.
 Prime Agent builds on Mario Zechner's Pi project:
 https://github.com/badlogic/pi-mono
-We also credit Prime Intellect's PrimeRL authors for their open-source
-reinforcement-learning work: https://github.com/PrimeIntellect-ai/prime-rl
-This acknowledgement does not imply that PrimeRL is a runtime dependency
-or that upstream authors endorse this fork.
 Third-party dependencies retain their own licenses and notices.

package/README.md CHANGED Viewed

@@ -2,7 +2,7 @@
 Stateful agent runtime with native context and recovery ownership.
-Part of **[Synerise base-context](https://github.com/BaseModelAI/base-context)**. Forked from Prime Intellect's [Prime Agent](https://github.com/PrimeIntellect-ai/prime-agent), built on Mario Zechner's Pi. MIT; see [LICENSE](LICENSE) and [NOTICE](NOTICE).
+Part of **[Synerise base-context](https://github.com/BaseModelAI/base-context)**. MIT; see [LICENSE](LICENSE) and [NOTICE](NOTICE).
 ## Workspace Package

package/dist/NOTICE CHANGED Viewed

@@ -14,9 +14,4 @@ this fork is not an official Prime Intellect release.
 Prime Agent builds on Mario Zechner's Pi project:
 https://github.com/badlogic/pi-mono
-We also credit Prime Intellect's PrimeRL authors for their open-source
-reinforcement-learning work: https://github.com/PrimeIntellect-ai/prime-rl
-This acknowledgement does not imply that PrimeRL is a runtime dependency
-or that upstream authors endorse this fork.
 Third-party dependencies retain their own licenses and notices.

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\tcreateAssistantMessageDiagnostic,\n\ttype ImageContent,\n\tisLocalRequestPreparationError,\n\ttype Message,\n\ttype Model,\n\tRequestTokenBudgetError,\n\ttype SimpleStreamOptions,\n\tstreamSimple,\n\ttype TextContent,\n\ttype ThinkingBudgets,\n\ttype Transport,\n} from \"@ponythewhite/base-context-ai\";\nimport { runAgentLoop, runAgentLoopContinue } from \"./agent-loop.js\";\nimport { AgentOutputLimitError } from \"./invocation-output.js\";\nimport type {\n\tAfterToolCallContext,\n\tAfterToolCallResult,\n\tAgentContext,\n\tAgentContextBuildResult,\n\tAgentContinuationOutcome,\n\tAgentEvent,\n\tAgentLoopConfig,\n\tAgentMessage,\n\tAgentOutputPolicy,\n\tAgentOwnedStreamFn,\n\tAgentState,\n\tAgentTool,\n\tAgentTurnOutcome,\n\tBeforeToolCallContext,\n\tBeforeToolCallResult,\n\tFinalizedToolExchange,\n\tGetContinuationMessagesContext,\n\tGetTurnOutcomeContext,\n\tShouldStopAfterTurnContext,\n\tStreamFn,\n\tToolExecutionMode,\n\tToolInvocation,\n} from \"./types.js\";\n\n/** Preserve actual local request preparation failures and primary cleanup chains without inventing an assistant. /\nfunction isRequestTokenBudgetFailure(error: unknown): error is Error {\n\treturn (\n\t\terror instanceof RequestTokenBudgetError \|\|\n\t\tisLocalRequestPreparationError(error) \|\|\n\t\t(error instanceof AggregateError && isRequestTokenBudgetFailure(error.errors[0]))\n\t);\n}\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\ntype QueueMode = \"all\" \| \"one-at-a-time\";\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\tserviceTier: initialState?.serviceTier ?? \"default\",\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\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\tstreamFn?: StreamFn;\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tonPayload?: SimpleStreamOptions[\"onPayload\"];\n\tonResponse?: SimpleStreamOptions[\"onResponse\"];\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\tonToolInvocationStarting?: (invocation: ToolInvocation, signal?: AbortSignal) => void \| Promise<void>;\n\tonToolExchangeFinalized?: (exchange: FinalizedToolExchange, signal?: AbortSignal) => void \| Promise<void>;\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\tgetTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\tshouldStopBeforeTurn?: () => boolean;\n\tgetContinuationMessages?: (context: GetContinuationMessagesContext, signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tgetContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\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 batches: AgentMessage[][] = [];\n\n\tconstructor(public mode: QueueMode) {}\n\n\tenqueue(message: AgentMessage \| AgentMessage[]): void {\n\t\tconst batch = Array.isArray(message) ? message.slice() : [message];\n\t\tif (batch.length > 0) {\n\t\t\tthis.batches.push(batch);\n\t\t}\n\t}\n\n\thasItems(): boolean {\n\t\treturn this.batches.length > 0;\n\t}\n\n\tdrain(): AgentMessage[] {\n\t\tif (this.mode === \"all\") {\n\t\t\tconst drained = this.batches.flat();\n\t\t\tthis.batches = [];\n\t\t\treturn drained;\n\t\t}\n\n\t\tconst first = this.batches[0];\n\t\tif (!first) {\n\t\t\treturn [];\n\t\t}\n\t\tthis.batches = this.batches.slice(1);\n\t\treturn first;\n\t}\n\n\tclear(): void {\n\t\tthis.batches = [];\n\t}\n\n\tremoveWhere(predicate: (message: AgentMessage) => boolean): AgentMessage[] {\n\t\tconst removed: AgentMessage[] = [];\n\t\tconst retained: AgentMessage[][] = [];\n\t\tfor (const batch of this.batches) {\n\t\t\tif (batch.some(predicate)) {\n\t\t\t\tremoved.push(...batch);\n\t\t\t} else {\n\t\t\t\tretained.push(batch);\n\t\t\t}\n\t\t}\n\t\tthis.batches = retained;\n\t\treturn removed;\n\t}\n}\n\ntype ActiveRun = {\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\tabortController: AbortController;\n};\n\n/* Why {@link Agent.continue} refused to start a continuation. /\nexport type AgentContinueErrorCode = \"busy\" \| \"nothing-to-continue\";\n\n/* Typed precondition failure from {@link Agent.continue}, so callers classify by code instead of message text. /\nexport class AgentContinueError extends Error {\n\tconstructor(\n\t\treadonly code: AgentContinueErrorCode,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"AgentContinueError\";\n\t}\n}\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\tprivate initializationOwner?: () => Promise<void>;\n\tprivate contextOwner?: () => Promise<AgentContextBuildResult>;\n\tprivate requestPreparationRecoveryOwner?: AgentLoopConfig[\"recoverRequestPreparation\"];\n\tprivate providerFailureRecoveryOwner?: {\n\t\trecover: NonNullable<AgentLoopConfig[\"recoverProviderFailure\"]>;\n\t\tsettle?: () => void;\n\t};\n\tprivate outputOwner?: () => AgentOutputPolicy \| undefined;\n\tprivate activeOutputPolicy?: AgentOutputPolicy;\n\n\t/* Native sinks join finalized message values; configuration is captured once per invocation. /\n\tbindOutputOwner(owner: () => AgentOutputPolicy \| undefined): void {\n\t\tif (this.outputOwner) throw new Error(\"Agent output owner is already bound\");\n\t\tthis.outputOwner = owner;\n\t}\n\n\t/* Finish native initialization before capturing context or emitting loop events. /\n\tbindInitializationOwner(owner: () => Promise<void>): void {\n\t\tif (this.initializationOwner) throw new Error(\"Agent initialization owner is already bound\");\n\t\tthis.initializationOwner = owner;\n\t}\n\n\t/* Native persistence remains ahead of replaceable context callbacks. /\n\tbindContextOwner(owner: () => Promise<AgentContextBuildResult>): void {\n\t\tif (this.contextOwner) throw new Error(\"Agent context owner is already bound\");\n\t\tthis.contextOwner = owner;\n\t}\n\n\tbindRequestPreparationRecoveryOwner(owner: NonNullable<AgentLoopConfig[\"recoverRequestPreparation\"]>): void {\n\t\tif (this.requestPreparationRecoveryOwner)\n\t\t\tthrow new Error(\"Agent request preparation recovery owner is already bound\");\n\t\tthis.requestPreparationRecoveryOwner = owner;\n\t}\n\n\tbindProviderFailureRecoveryOwner(owner: {\n\t\trecover: NonNullable<AgentLoopConfig[\"recoverProviderFailure\"]>;\n\t\tsettle?: () => void;\n\t}): void {\n\t\tif (this.providerFailureRecoveryOwner) throw new Error(\"Agent provider failure recovery owner is already bound\");\n\t\tthis.providerFailureRecoveryOwner = owner;\n\t}\n\n\tprivate configuredStreamFn!: StreamFn;\n\tprivate effectiveStreamFn!: StreamFn;\n\tprivate ownedStreamFn?: AgentOwnedStreamFn;\n\tprivate streamOwner?: (streamFn: StreamFn) => AgentOwnedStreamFn;\n\n\tget streamFn(): StreamFn {\n\t\treturn this.effectiveStreamFn;\n\t}\n\tset streamFn(streamFn: StreamFn) {\n\t\tthis.configuredStreamFn = streamFn;\n\t\tconst ownedStreamFn = this.streamOwner?.(streamFn);\n\t\tthis.ownedStreamFn = ownedStreamFn;\n\t\tthis.effectiveStreamFn = ownedStreamFn ?? streamFn;\n\t}\n\n\t/* A native owner remains in the path when an embedding changes its configured stream. /\n\tbindStreamOwner(owner: (streamFn: StreamFn) => AgentOwnedStreamFn): void {\n\t\tif (this.streamOwner) throw new Error(\"Agent stream owner is already bound\");\n\t\tthis.streamOwner = owner;\n\t\tthis.streamFn = this.configuredStreamFn;\n\t}\n\tpublic getApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tpublic onPayload?: SimpleStreamOptions[\"onPayload\"];\n\tpublic onResponse?: SimpleStreamOptions[\"onResponse\"];\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 onToolInvocationStarting?: (invocation: ToolInvocation, signal?: AbortSignal) => void \| Promise<void>;\n\tpublic onToolExchangeFinalized?: (exchange: FinalizedToolExchange, signal?: AbortSignal) => void \| Promise<void>;\n\tprivate toolExecutionOwner?: Required<Pick<AgentLoopConfig, \"onToolInvocationStarting\" \| \"onToolExchangeFinalized\">>;\n\n\t/* Native persistence runs before replaceable caller hooks. /\n\tbindToolExecutionOwner(\n\t\towner: Required<Pick<AgentLoopConfig, \"onToolInvocationStarting\" \| \"onToolExchangeFinalized\">>,\n\t): void {\n\t\tif (this.toolExecutionOwner) throw new Error(\"Agent tool execution owner is already bound\");\n\t\tthis.toolExecutionOwner = {\n\t\t\tonToolInvocationStarting: owner.onToolInvocationStarting,\n\t\t\tonToolExchangeFinalized: owner.onToolExchangeFinalized,\n\t\t};\n\t}\n\n\tpublic shouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\tpublic getTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\tpublic shouldStopBeforeTurn?: () => boolean;\n\tpublic getContinuationMessages?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentMessage[]>;\n\tpublic getContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\n\tprivate activeRun?: ActiveRun;\n\tpublic sessionId?: string;\n\tpublic thinkingBudgets?: ThinkingBudgets;\n\tpublic transport: Transport;\n\tpublic maxRetryDelayMs?: number;\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.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.beforeToolCall = options.beforeToolCall;\n\t\tthis.afterToolCall = options.afterToolCall;\n\t\tthis.onToolInvocationStarting = options.onToolInvocationStarting;\n\t\tthis.onToolExchangeFinalized = options.onToolExchangeFinalized;\n\t\tthis.shouldStopAfterTurn = options.shouldStopAfterTurn;\n\t\tthis.getTurnOutcome = options.getTurnOutcome;\n\t\tthis.shouldStopBeforeTurn = options.shouldStopBeforeTurn;\n\t\tthis.getContinuationMessages = options.getContinuationMessages;\n\t\tthis.getContinuationOutcome = options.getContinuationOutcome;\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\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\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 batch to be injected after the current assistant turn finishes. /\n\tsteer(message: AgentMessage \| AgentMessage[]): void {\n\t\tthis.steeringQueue.enqueue(message);\n\t}\n\n\t/* Queue a message batch to run only after the agent would otherwise stop. /\n\tfollowUp(message: AgentMessage \| AgentMessage[]): void {\n\t\tthis.followUpQueue.enqueue(message);\n\t}\n\n\tclearSteeringQueue(): void {\n\t\tthis.steeringQueue.clear();\n\t}\n\n\tclearFollowUpQueue(): void {\n\t\tthis.followUpQueue.clear();\n\t}\n\n\tclearAllQueues(): void {\n\t\tthis.clearSteeringQueue();\n\t\tthis.clearFollowUpQueue();\n\t}\n\n\tremoveQueuedMessages(predicate: (message: AgentMessage) => boolean): AgentMessage[] {\n\t\treturn [...this.steeringQueue.removeWhere(predicate), ...this.followUpQueue.removeWhere(predicate)];\n\t}\n\n\thasQueuedMessages(): boolean {\n\t\treturn this.steeringQueue.hasItems() \|\| this.followUpQueue.hasItems();\n\t}\n\n\tget signal(): AbortSignal \| undefined {\n\t\treturn this.activeRun?.abortController.signal;\n\t}\n\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\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}\n\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/* The last message must convert to a user or tool-result message. /\n\tasync continue(): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new AgentContinueError(\"busy\", \"Agent is already processing. Wait for completion before continuing.\");\n\t\t}\n\n\t\tconst runQueuedMessages = (): Promise<void> \| undefined => {\n\t\t\tconst queuedSteering = this.steeringQueue.drain();\n\t\t\tif (queuedSteering.length > 0) {\n\t\t\t\treturn this.runPromptMessages(queuedSteering, { skipInitialSteeringPoll: true });\n\t\t\t}\n\n\t\t\tconst queuedFollowUps = this.followUpQueue.drain();\n\t\t\tif (queuedFollowUps.length > 0) {\n\t\t\t\treturn this.runPromptMessages(queuedFollowUps);\n\t\t\t}\n\n\t\t\treturn undefined;\n\t\t};\n\n\t\tconst lastMessage = this._state.messages[this._state.messages.length - 1];\n\t\tif (!lastMessage) {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new AgentContinueError(\"nothing-to-continue\", \"No messages to continue from\");\n\t\t}\n\n\t\tif (lastMessage.role === \"assistant\") {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new AgentContinueError(\"nothing-to-continue\", \"Cannot continue from message role: assistant\");\n\t\t}\n\n\t\tconst lastMessageRole: string = lastMessage.role;\n\t\tif (lastMessageRole === \"custom\") {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\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\tconst onToolInvocationStarting = this.onToolInvocationStarting;\n\t\tconst onToolExchangeFinalized = this.onToolExchangeFinalized;\n\t\treturn {\n\t\t\toutputPolicy: this.activeOutputPolicy,\n\t\t\tmodel: this._state.model,\n\t\t\treasoning: this._state.thinkingLevel,\n\t\t\tserviceTier: this._state.serviceTier,\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\tbeforeToolCall: this.beforeToolCall,\n\t\t\tafterToolCall: this.afterToolCall,\n\t\t\tonToolInvocationStarting: async (invocation, signal, tool, execute, assistantMessage) => {\n\t\t\t\tconst owner = await this.toolExecutionOwner?.onToolInvocationStarting(\n\t\t\t\t\tinvocation,\n\t\t\t\t\tsignal,\n\t\t\t\t\ttool,\n\t\t\t\t\texecute,\n\t\t\t\t\tassistantMessage,\n\t\t\t\t);\n\t\t\t\tawait onToolInvocationStarting?.(invocation, signal);\n\t\t\t\treturn owner \|\| undefined;\n\t\t\t},\n\t\t\tonToolExchangeFinalized: async (exchange, signal, owner) => {\n\t\t\t\tif (owner) await owner.finalize(exchange, signal);\n\t\t\t\telse await this.toolExecutionOwner?.onToolExchangeFinalized(exchange, signal);\n\t\t\t\tawait onToolExchangeFinalized?.(exchange, signal);\n\t\t\t},\n\t\t\tshouldStopAfterTurn: async (context) => this.shouldStopAfterTurn?.(context) ?? false,\n\t\t\tgetTurnOutcome: this.getTurnOutcome?.bind(this),\n\t\t\tshouldStopBeforeTurn: () => this.shouldStopBeforeTurn?.() ?? false,\n\t\t\tbeforeContextBuild: async () => this.contextOwner?.(),\n\t\t\trecoverRequestPreparation: this.requestPreparationRecoveryOwner,\n\t\t\trecoverProviderFailure: this.providerFailureRecoveryOwner?.recover,\n\t\t\tonContextAdopted: (messages) => {\n\t\t\t\tthis._state.messages = messages;\n\t\t\t},\n\t\t\townedStreamFn: this.ownedStreamFn,\n\t\t\tconvertToLlm: this.convertToLlm,\n\t\t\ttransformContext: this.transformContext,\n\t\t\tgetSystemPrompt: () => this._state.systemPrompt,\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\tgetContinuationMessages: async (context, signal) => this.getContinuationMessages?.(context, signal) ?? [],\n\t\t\tgetContinuationOutcome: this.getContinuationOutcome?.bind(this),\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\ttry {\n\t\t\tconst outputPolicy = this.outputOwner?.();\n\t\t\tthis.activeOutputPolicy = outputPolicy\n\t\t\t\t? {\n\t\t\t\t\t\tlimits: { ...outputPolicy.limits },\n\t\t\t\t\t\tsnapshot: outputPolicy.snapshot.bind(outputPolicy),\n\t\t\t\t\t\tbindUpdates: outputPolicy.bindUpdates?.bind(outputPolicy),\n\t\t\t\t\t\tsettleUpdates: outputPolicy.settleUpdates?.bind(outputPolicy),\n\t\t\t\t\t}\n\t\t\t\t: undefined;\n\t\t\tif (this.initializationOwner) {\n\t\t\t\tawait this.initializationOwner();\n\t\t\t\tabortController.signal.throwIfAborted();\n\t\t\t}\n\t\t\tawait executor(abortController.signal);\n\t\t} catch (error) {\n\t\t\tif (error instanceof AgentOutputLimitError \|\| isRequestTokenBudgetFailure(error)) {\n\t\t\t\tthis._state.errorMessage = error.message;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tawait this.handleRunFailure(error, abortController.signal.aborted);\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tthis.providerFailureRecoveryOwner?.settle?.();\n\t\t\t} finally {\n\t\t\t\tthis.finishRun();\n\t\t\t}\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\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\tdiagnostics: aborted\n\t\t\t\t? undefined\n\t\t\t\t: [createAssistantMessageDiagnostic(\"agent_lifecycle_failure\", error, { source: \"run_with_lifecycle\" })],\n\t\t\ttimestamp: Date.now(),\n\t\t} satisfies AgentMessage;\n\t\tthis._state.errorMessage = failureMessage.errorMessage;\n\t\tawait this.processEvents({ type: \"message_start\", message: failureMessage }).catch(() => undefined);\n\t\tawait this.processEvents({ type: \"message_end\", message: failureMessage }).catch(() => undefined);\n\t\tawait this.processEvents({ type: \"agent_end\", messages: [failureMessage] }).catch(() => undefined);\n\t}\n\n\tprivate finishRun(): void {\n\t\tthis.activeOutputPolicy = undefined;\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\tif (event.refusal) this._state.errorMessage = new AgentOutputLimitError(event.refusal).message;\n\t\t\t\tbreak;\n\t\t}\n\n\t\tconst signal = this.activeRun?.abortController.signal;\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"]}
1	+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tcreateAssistantMessageDiagnostic,\n\ttype ImageContent,\n\tisLocalRequestPreparationError,\n\ttype Message,\n\tRequestTokenBudgetError,\n\ttype SimpleStreamOptions,\n\tstreamSimple,\n\ttype TextContent,\n\ttype ThinkingBudgets,\n\ttype Transport,\n} from \"@ponythewhite/base-context-ai\";\nimport { runAgentLoop, runAgentLoopContinue } from \"./agent-loop.js\";\nimport { AgentOutputLimitError } from \"./invocation-output.js\";\nimport type {\n\tAfterToolCallContext,\n\tAfterToolCallResult,\n\tAgentContext,\n\tAgentContextBuildResult,\n\tAgentContinuationOutcome,\n\tAgentEvent,\n\tAgentLoopConfig,\n\tAgentMessage,\n\tAgentOutputPolicy,\n\tAgentOwnedStreamFn,\n\tAgentState,\n\tAgentTool,\n\tAgentTurnOutcome,\n\tBeforeToolCallContext,\n\tBeforeToolCallResult,\n\tFinalizedToolExchange,\n\tGetContinuationMessagesContext,\n\tGetTurnOutcomeContext,\n\tShouldStopAfterTurnContext,\n\tStreamFn,\n\tToolExecutionMode,\n\tToolInvocation,\n} from \"./types.js\";\n\n/** Preserve actual local request preparation failures and primary cleanup chains without inventing an assistant. /\nfunction isRequestTokenBudgetFailure(error: unknown): error is Error {\n\treturn (\n\t\terror instanceof RequestTokenBudgetError \|\|\n\t\tisLocalRequestPreparationError(error) \|\|\n\t\t(error instanceof AggregateError && isRequestTokenBudgetFailure(error.errors[0]))\n\t);\n}\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\ntype QueueMode = \"all\" \| \"one-at-a-time\";\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,\n\t\tthinkingLevel: initialState?.thinkingLevel ?? \"off\",\n\t\tserviceTier: initialState?.serviceTier ?? \"default\",\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\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\tstreamFn?: StreamFn;\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tonPayload?: SimpleStreamOptions[\"onPayload\"];\n\tonResponse?: SimpleStreamOptions[\"onResponse\"];\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\tonToolInvocationStarting?: (invocation: ToolInvocation, signal?: AbortSignal) => void \| Promise<void>;\n\tonToolExchangeFinalized?: (exchange: FinalizedToolExchange, signal?: AbortSignal) => void \| Promise<void>;\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\tgetTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\tshouldStopBeforeTurn?: () => boolean;\n\tgetContinuationMessages?: (context: GetContinuationMessagesContext, signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tgetContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\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 batches: AgentMessage[][] = [];\n\n\tconstructor(public mode: QueueMode) {}\n\n\tenqueue(message: AgentMessage \| AgentMessage[]): void {\n\t\tconst batch = Array.isArray(message) ? message.slice() : [message];\n\t\tif (batch.length > 0) {\n\t\t\tthis.batches.push(batch);\n\t\t}\n\t}\n\n\thasItems(): boolean {\n\t\treturn this.batches.length > 0;\n\t}\n\n\tdrain(): AgentMessage[] {\n\t\tif (this.mode === \"all\") {\n\t\t\tconst drained = this.batches.flat();\n\t\t\tthis.batches = [];\n\t\t\treturn drained;\n\t\t}\n\n\t\tconst first = this.batches[0];\n\t\tif (!first) {\n\t\t\treturn [];\n\t\t}\n\t\tthis.batches = this.batches.slice(1);\n\t\treturn first;\n\t}\n\n\tclear(): void {\n\t\tthis.batches = [];\n\t}\n\n\tremoveWhere(predicate: (message: AgentMessage) => boolean): AgentMessage[] {\n\t\tconst removed: AgentMessage[] = [];\n\t\tconst retained: AgentMessage[][] = [];\n\t\tfor (const batch of this.batches) {\n\t\t\tif (batch.some(predicate)) {\n\t\t\t\tremoved.push(...batch);\n\t\t\t} else {\n\t\t\t\tretained.push(batch);\n\t\t\t}\n\t\t}\n\t\tthis.batches = retained;\n\t\treturn removed;\n\t}\n}\n\ntype ActiveRun = {\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\tabortController: AbortController;\n};\n\n/* Why {@link Agent.continue} refused to start a continuation. /\nexport type AgentContinueErrorCode = \"busy\" \| \"nothing-to-continue\";\n\n/* Typed precondition failure from {@link Agent.continue}, so callers classify by code instead of message text. /\nexport class AgentContinueError extends Error {\n\tconstructor(\n\t\treadonly code: AgentContinueErrorCode,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"AgentContinueError\";\n\t}\n}\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\tprivate initializationOwner?: () => Promise<void>;\n\tprivate contextOwner?: () => Promise<AgentContextBuildResult>;\n\tprivate requestPreparationRecoveryOwner?: AgentLoopConfig[\"recoverRequestPreparation\"];\n\tprivate providerFailureRecoveryOwner?: {\n\t\trecover: NonNullable<AgentLoopConfig[\"recoverProviderFailure\"]>;\n\t\tsettle?: () => void;\n\t};\n\tprivate outputOwner?: () => AgentOutputPolicy \| undefined;\n\tprivate activeOutputPolicy?: AgentOutputPolicy;\n\n\t/* Native sinks join finalized message values; configuration is captured once per invocation. /\n\tbindOutputOwner(owner: () => AgentOutputPolicy \| undefined): void {\n\t\tif (this.outputOwner) throw new Error(\"Agent output owner is already bound\");\n\t\tthis.outputOwner = owner;\n\t}\n\n\t/* Finish native initialization before capturing context or emitting loop events. /\n\tbindInitializationOwner(owner: () => Promise<void>): void {\n\t\tif (this.initializationOwner) throw new Error(\"Agent initialization owner is already bound\");\n\t\tthis.initializationOwner = owner;\n\t}\n\n\t/* Native persistence remains ahead of replaceable context callbacks. /\n\tbindContextOwner(owner: () => Promise<AgentContextBuildResult>): void {\n\t\tif (this.contextOwner) throw new Error(\"Agent context owner is already bound\");\n\t\tthis.contextOwner = owner;\n\t}\n\n\tbindRequestPreparationRecoveryOwner(owner: NonNullable<AgentLoopConfig[\"recoverRequestPreparation\"]>): void {\n\t\tif (this.requestPreparationRecoveryOwner)\n\t\t\tthrow new Error(\"Agent request preparation recovery owner is already bound\");\n\t\tthis.requestPreparationRecoveryOwner = owner;\n\t}\n\n\tbindProviderFailureRecoveryOwner(owner: {\n\t\trecover: NonNullable<AgentLoopConfig[\"recoverProviderFailure\"]>;\n\t\tsettle?: () => void;\n\t}): void {\n\t\tif (this.providerFailureRecoveryOwner) throw new Error(\"Agent provider failure recovery owner is already bound\");\n\t\tthis.providerFailureRecoveryOwner = owner;\n\t}\n\n\tprivate configuredStreamFn!: StreamFn;\n\tprivate effectiveStreamFn!: StreamFn;\n\tprivate ownedStreamFn?: AgentOwnedStreamFn;\n\tprivate streamOwner?: (streamFn: StreamFn) => AgentOwnedStreamFn;\n\n\tget streamFn(): StreamFn {\n\t\treturn this.effectiveStreamFn;\n\t}\n\tset streamFn(streamFn: StreamFn) {\n\t\tthis.configuredStreamFn = streamFn;\n\t\tconst ownedStreamFn = this.streamOwner?.(streamFn);\n\t\tthis.ownedStreamFn = ownedStreamFn;\n\t\tthis.effectiveStreamFn = ownedStreamFn ?? streamFn;\n\t}\n\n\t/* A native owner remains in the path when an embedding changes its configured stream. /\n\tbindStreamOwner(owner: (streamFn: StreamFn) => AgentOwnedStreamFn): void {\n\t\tif (this.streamOwner) throw new Error(\"Agent stream owner is already bound\");\n\t\tthis.streamOwner = owner;\n\t\tthis.streamFn = this.configuredStreamFn;\n\t}\n\tpublic getApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tpublic onPayload?: SimpleStreamOptions[\"onPayload\"];\n\tpublic onResponse?: SimpleStreamOptions[\"onResponse\"];\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 onToolInvocationStarting?: (invocation: ToolInvocation, signal?: AbortSignal) => void \| Promise<void>;\n\tpublic onToolExchangeFinalized?: (exchange: FinalizedToolExchange, signal?: AbortSignal) => void \| Promise<void>;\n\tprivate toolExecutionOwner?: Required<Pick<AgentLoopConfig, \"onToolInvocationStarting\" \| \"onToolExchangeFinalized\">>;\n\n\t/* Native persistence runs before replaceable caller hooks. /\n\tbindToolExecutionOwner(\n\t\towner: Required<Pick<AgentLoopConfig, \"onToolInvocationStarting\" \| \"onToolExchangeFinalized\">>,\n\t): void {\n\t\tif (this.toolExecutionOwner) throw new Error(\"Agent tool execution owner is already bound\");\n\t\tthis.toolExecutionOwner = {\n\t\t\tonToolInvocationStarting: owner.onToolInvocationStarting,\n\t\t\tonToolExchangeFinalized: owner.onToolExchangeFinalized,\n\t\t};\n\t}\n\n\tpublic shouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\tpublic getTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\tpublic shouldStopBeforeTurn?: () => boolean;\n\tpublic getContinuationMessages?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentMessage[]>;\n\tpublic getContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\n\tprivate activeRun?: ActiveRun;\n\tpublic sessionId?: string;\n\tpublic thinkingBudgets?: ThinkingBudgets;\n\tpublic transport: Transport;\n\tpublic maxRetryDelayMs?: number;\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.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.beforeToolCall = options.beforeToolCall;\n\t\tthis.afterToolCall = options.afterToolCall;\n\t\tthis.onToolInvocationStarting = options.onToolInvocationStarting;\n\t\tthis.onToolExchangeFinalized = options.onToolExchangeFinalized;\n\t\tthis.shouldStopAfterTurn = options.shouldStopAfterTurn;\n\t\tthis.getTurnOutcome = options.getTurnOutcome;\n\t\tthis.shouldStopBeforeTurn = options.shouldStopBeforeTurn;\n\t\tthis.getContinuationMessages = options.getContinuationMessages;\n\t\tthis.getContinuationOutcome = options.getContinuationOutcome;\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\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\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 batch to be injected after the current assistant turn finishes. /\n\tsteer(message: AgentMessage \| AgentMessage[]): void {\n\t\tthis.steeringQueue.enqueue(message);\n\t}\n\n\t/* Queue a message batch to run only after the agent would otherwise stop. /\n\tfollowUp(message: AgentMessage \| AgentMessage[]): void {\n\t\tthis.followUpQueue.enqueue(message);\n\t}\n\n\tclearSteeringQueue(): void {\n\t\tthis.steeringQueue.clear();\n\t}\n\n\tclearFollowUpQueue(): void {\n\t\tthis.followUpQueue.clear();\n\t}\n\n\tclearAllQueues(): void {\n\t\tthis.clearSteeringQueue();\n\t\tthis.clearFollowUpQueue();\n\t}\n\n\tremoveQueuedMessages(predicate: (message: AgentMessage) => boolean): AgentMessage[] {\n\t\treturn [...this.steeringQueue.removeWhere(predicate), ...this.followUpQueue.removeWhere(predicate)];\n\t}\n\n\thasQueuedMessages(): boolean {\n\t\treturn this.steeringQueue.hasItems() \|\| this.followUpQueue.hasItems();\n\t}\n\n\tget signal(): AbortSignal \| undefined {\n\t\treturn this.activeRun?.abortController.signal;\n\t}\n\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\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}\n\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/* The last message must convert to a user or tool-result message. /\n\tasync continue(): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new AgentContinueError(\"busy\", \"Agent is already processing. Wait for completion before continuing.\");\n\t\t}\n\n\t\tconst runQueuedMessages = (): Promise<void> \| undefined => {\n\t\t\tconst queuedSteering = this.steeringQueue.drain();\n\t\t\tif (queuedSteering.length > 0) {\n\t\t\t\treturn this.runPromptMessages(queuedSteering, { skipInitialSteeringPoll: true });\n\t\t\t}\n\n\t\t\tconst queuedFollowUps = this.followUpQueue.drain();\n\t\t\tif (queuedFollowUps.length > 0) {\n\t\t\t\treturn this.runPromptMessages(queuedFollowUps);\n\t\t\t}\n\n\t\t\treturn undefined;\n\t\t};\n\n\t\tconst lastMessage = this._state.messages[this._state.messages.length - 1];\n\t\tif (!lastMessage) {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new AgentContinueError(\"nothing-to-continue\", \"No messages to continue from\");\n\t\t}\n\n\t\tif (lastMessage.role === \"assistant\") {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new AgentContinueError(\"nothing-to-continue\", \"Cannot continue from message role: assistant\");\n\t\t}\n\n\t\tconst lastMessageRole: string = lastMessage.role;\n\t\tif (lastMessageRole === \"custom\") {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\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\tif (!this._state.model)\n\t\t\tthrow new Error(\"No model selected. Select a provider and model before starting the agent.\");\n\t\tlet skipInitialSteeringPoll = options.skipInitialSteeringPoll === true;\n\t\tconst onToolInvocationStarting = this.onToolInvocationStarting;\n\t\tconst onToolExchangeFinalized = this.onToolExchangeFinalized;\n\t\treturn {\n\t\t\toutputPolicy: this.activeOutputPolicy,\n\t\t\tmodel: this._state.model,\n\t\t\treasoning: this._state.thinkingLevel,\n\t\t\tserviceTier: this._state.serviceTier,\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\tbeforeToolCall: this.beforeToolCall,\n\t\t\tafterToolCall: this.afterToolCall,\n\t\t\tonToolInvocationStarting: async (invocation, signal, tool, execute, assistantMessage) => {\n\t\t\t\tconst owner = await this.toolExecutionOwner?.onToolInvocationStarting(\n\t\t\t\t\tinvocation,\n\t\t\t\t\tsignal,\n\t\t\t\t\ttool,\n\t\t\t\t\texecute,\n\t\t\t\t\tassistantMessage,\n\t\t\t\t);\n\t\t\t\tawait onToolInvocationStarting?.(invocation, signal);\n\t\t\t\treturn owner \|\| undefined;\n\t\t\t},\n\t\t\tonToolExchangeFinalized: async (exchange, signal, owner) => {\n\t\t\t\tif (owner) await owner.finalize(exchange, signal);\n\t\t\t\telse await this.toolExecutionOwner?.onToolExchangeFinalized(exchange, signal);\n\t\t\t\tawait onToolExchangeFinalized?.(exchange, signal);\n\t\t\t},\n\t\t\tshouldStopAfterTurn: async (context) => this.shouldStopAfterTurn?.(context) ?? false,\n\t\t\tgetTurnOutcome: this.getTurnOutcome?.bind(this),\n\t\t\tshouldStopBeforeTurn: () => this.shouldStopBeforeTurn?.() ?? false,\n\t\t\tbeforeContextBuild: async () => this.contextOwner?.(),\n\t\t\trecoverRequestPreparation: this.requestPreparationRecoveryOwner,\n\t\t\trecoverProviderFailure: this.providerFailureRecoveryOwner?.recover,\n\t\t\tonContextAdopted: (messages) => {\n\t\t\t\tthis._state.messages = messages;\n\t\t\t},\n\t\t\townedStreamFn: this.ownedStreamFn,\n\t\t\tconvertToLlm: this.convertToLlm,\n\t\t\ttransformContext: this.transformContext,\n\t\t\tgetSystemPrompt: () => this._state.systemPrompt,\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\tgetContinuationMessages: async (context, signal) => this.getContinuationMessages?.(context, signal) ?? [],\n\t\t\tgetContinuationOutcome: this.getContinuationOutcome?.bind(this),\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\t\tif (!this._state.model)\n\t\t\tthrow new Error(\"No model selected. Select a provider and model before starting the agent.\");\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\ttry {\n\t\t\tconst outputPolicy = this.outputOwner?.();\n\t\t\tthis.activeOutputPolicy = outputPolicy\n\t\t\t\t? {\n\t\t\t\t\t\tlimits: { ...outputPolicy.limits },\n\t\t\t\t\t\tsnapshot: outputPolicy.snapshot.bind(outputPolicy),\n\t\t\t\t\t\tbindUpdates: outputPolicy.bindUpdates?.bind(outputPolicy),\n\t\t\t\t\t\tsettleUpdates: outputPolicy.settleUpdates?.bind(outputPolicy),\n\t\t\t\t\t}\n\t\t\t\t: undefined;\n\t\t\tif (this.initializationOwner) {\n\t\t\t\tawait this.initializationOwner();\n\t\t\t\tabortController.signal.throwIfAborted();\n\t\t\t}\n\t\t\tawait executor(abortController.signal);\n\t\t} catch (error) {\n\t\t\tif (error instanceof AgentOutputLimitError \|\| isRequestTokenBudgetFailure(error)) {\n\t\t\t\tthis._state.errorMessage = error.message;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tawait this.handleRunFailure(error, abortController.signal.aborted);\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tthis.providerFailureRecoveryOwner?.settle?.();\n\t\t\t} finally {\n\t\t\t\tthis.finishRun();\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async handleRunFailure(error: unknown, aborted: boolean): Promise<void> {\n\t\tif (!this._state.model) throw error;\n\t\tconst failureMessage = {\n\t\t\trole: \"assistant\",\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\tdiagnostics: aborted\n\t\t\t\t? undefined\n\t\t\t\t: [createAssistantMessageDiagnostic(\"agent_lifecycle_failure\", error, { source: \"run_with_lifecycle\" })],\n\t\t\ttimestamp: Date.now(),\n\t\t} satisfies AgentMessage;\n\t\tthis._state.errorMessage = failureMessage.errorMessage;\n\t\tawait this.processEvents({ type: \"message_start\", message: failureMessage }).catch(() => undefined);\n\t\tawait this.processEvents({ type: \"message_end\", message: failureMessage }).catch(() => undefined);\n\t\tawait this.processEvents({ type: \"agent_end\", messages: [failureMessage] }).catch(() => undefined);\n\t}\n\n\tprivate finishRun(): void {\n\t\tthis.activeOutputPolicy = undefined;\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\tif (event.refusal) this._state.errorMessage = new AgentOutputLimitError(event.refusal).message;\n\t\t\t\tbreak;\n\t\t}\n\n\t\tconst signal = this.activeRun?.abortController.signal;\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"]}

package/dist/agent.js CHANGED Viewed

@@ -18,24 +18,12 @@ const EMPTY_USAGE = {
     totalTokens: 0,
     cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
 };
-const DEFAULT_MODEL = {
-    id: "unknown",
-    name: "unknown",
-    api: "unknown",
-    provider: "unknown",
-    baseUrl: "",
-    reasoning: false,
-    input: [],
-    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
-    contextWindow: 0,
-    maxTokens: 0,
-};
 function createMutableAgentState(initialState) {
     let tools = initialState?.tools?.slice() ?? [];
     let messages = initialState?.messages?.slice() ?? [];
     return {
         systemPrompt: initialState?.systemPrompt ?? "",
-        model: initialState?.model ?? DEFAULT_MODEL,
+        model: initialState?.model,
         thinkingLevel: initialState?.thinkingLevel ?? "off",
         serviceTier: initialState?.serviceTier ?? "default",
         get tools() {
@@ -387,6 +375,8 @@ export class Agent {
         };
     }
     createLoopConfig(options = {}) {
+        if (!this._state.model)
+            throw new Error("No model selected. Select a provider and model before starting the agent.");
         let skipInitialSteeringPoll = options.skipInitialSteeringPoll === true;
         const onToolInvocationStarting = this.onToolInvocationStarting;
         const onToolExchangeFinalized = this.onToolExchangeFinalized;
@@ -446,6 +436,8 @@ export class Agent {
         if (this.activeRun) {
             throw new Error("Agent is already processing.");
         }
+        if (!this._state.model)
+            throw new Error("No model selected. Select a provider and model before starting the agent.");
         const abortController = new AbortController();
         let resolvePromise = () => { };
         const promise = new Promise((resolve) => {
@@ -488,6 +480,8 @@ export class Agent {
         }
     }
     async handleRunFailure(error, aborted) {
+        if (!this._state.model)
+            throw error;
         const failureMessage = {
             role: "assistant",
             content: [{ type: "text", text: "" }],

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\tcreateAssistantMessageDiagnostic,\n\ttype ImageContent,\n\tisLocalRequestPreparationError,\n\ttype Message,\n\ttype Model,\n\tRequestTokenBudgetError,\n\ttype SimpleStreamOptions,\n\tstreamSimple,\n\ttype TextContent,\n\ttype ThinkingBudgets,\n\ttype Transport,\n} from \"@ponythewhite/base-context-ai\";\nimport { runAgentLoop, runAgentLoopContinue } from \"./agent-loop.js\";\nimport { AgentOutputLimitError } from \"./invocation-output.js\";\nimport type {\n\tAfterToolCallContext,\n\tAfterToolCallResult,\n\tAgentContext,\n\tAgentContextBuildResult,\n\tAgentContinuationOutcome,\n\tAgentEvent,\n\tAgentLoopConfig,\n\tAgentMessage,\n\tAgentOutputPolicy,\n\tAgentOwnedStreamFn,\n\tAgentState,\n\tAgentTool,\n\tAgentTurnOutcome,\n\tBeforeToolCallContext,\n\tBeforeToolCallResult,\n\tFinalizedToolExchange,\n\tGetContinuationMessagesContext,\n\tGetTurnOutcomeContext,\n\tShouldStopAfterTurnContext,\n\tStreamFn,\n\tToolExecutionMode,\n\tToolInvocation,\n} from \"./types.js\";\n\n/** Preserve actual local request preparation failures and primary cleanup chains without inventing an assistant. /\nfunction isRequestTokenBudgetFailure(error: unknown): error is Error {\n\treturn (\n\t\terror instanceof RequestTokenBudgetError \|\|\n\t\tisLocalRequestPreparationError(error) \|\|\n\t\t(error instanceof AggregateError && isRequestTokenBudgetFailure(error.errors[0]))\n\t);\n}\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\ntype QueueMode = \"all\" \| \"one-at-a-time\";\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\tserviceTier: initialState?.serviceTier ?? \"default\",\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\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\tstreamFn?: StreamFn;\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tonPayload?: SimpleStreamOptions[\"onPayload\"];\n\tonResponse?: SimpleStreamOptions[\"onResponse\"];\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\tonToolInvocationStarting?: (invocation: ToolInvocation, signal?: AbortSignal) => void \| Promise<void>;\n\tonToolExchangeFinalized?: (exchange: FinalizedToolExchange, signal?: AbortSignal) => void \| Promise<void>;\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\tgetTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\tshouldStopBeforeTurn?: () => boolean;\n\tgetContinuationMessages?: (context: GetContinuationMessagesContext, signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tgetContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\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 batches: AgentMessage[][] = [];\n\n\tconstructor(public mode: QueueMode) {}\n\n\tenqueue(message: AgentMessage \| AgentMessage[]): void {\n\t\tconst batch = Array.isArray(message) ? message.slice() : [message];\n\t\tif (batch.length > 0) {\n\t\t\tthis.batches.push(batch);\n\t\t}\n\t}\n\n\thasItems(): boolean {\n\t\treturn this.batches.length > 0;\n\t}\n\n\tdrain(): AgentMessage[] {\n\t\tif (this.mode === \"all\") {\n\t\t\tconst drained = this.batches.flat();\n\t\t\tthis.batches = [];\n\t\t\treturn drained;\n\t\t}\n\n\t\tconst first = this.batches[0];\n\t\tif (!first) {\n\t\t\treturn [];\n\t\t}\n\t\tthis.batches = this.batches.slice(1);\n\t\treturn first;\n\t}\n\n\tclear(): void {\n\t\tthis.batches = [];\n\t}\n\n\tremoveWhere(predicate: (message: AgentMessage) => boolean): AgentMessage[] {\n\t\tconst removed: AgentMessage[] = [];\n\t\tconst retained: AgentMessage[][] = [];\n\t\tfor (const batch of this.batches) {\n\t\t\tif (batch.some(predicate)) {\n\t\t\t\tremoved.push(...batch);\n\t\t\t} else {\n\t\t\t\tretained.push(batch);\n\t\t\t}\n\t\t}\n\t\tthis.batches = retained;\n\t\treturn removed;\n\t}\n}\n\ntype ActiveRun = {\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\tabortController: AbortController;\n};\n\n/* Why {@link Agent.continue} refused to start a continuation. /\nexport type AgentContinueErrorCode = \"busy\" \| \"nothing-to-continue\";\n\n/* Typed precondition failure from {@link Agent.continue}, so callers classify by code instead of message text. /\nexport class AgentContinueError extends Error {\n\tconstructor(\n\t\treadonly code: AgentContinueErrorCode,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"AgentContinueError\";\n\t}\n}\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\tprivate initializationOwner?: () => Promise<void>;\n\tprivate contextOwner?: () => Promise<AgentContextBuildResult>;\n\tprivate requestPreparationRecoveryOwner?: AgentLoopConfig[\"recoverRequestPreparation\"];\n\tprivate providerFailureRecoveryOwner?: {\n\t\trecover: NonNullable<AgentLoopConfig[\"recoverProviderFailure\"]>;\n\t\tsettle?: () => void;\n\t};\n\tprivate outputOwner?: () => AgentOutputPolicy \| undefined;\n\tprivate activeOutputPolicy?: AgentOutputPolicy;\n\n\t/* Native sinks join finalized message values; configuration is captured once per invocation. /\n\tbindOutputOwner(owner: () => AgentOutputPolicy \| undefined): void {\n\t\tif (this.outputOwner) throw new Error(\"Agent output owner is already bound\");\n\t\tthis.outputOwner = owner;\n\t}\n\n\t/* Finish native initialization before capturing context or emitting loop events. /\n\tbindInitializationOwner(owner: () => Promise<void>): void {\n\t\tif (this.initializationOwner) throw new Error(\"Agent initialization owner is already bound\");\n\t\tthis.initializationOwner = owner;\n\t}\n\n\t/* Native persistence remains ahead of replaceable context callbacks. /\n\tbindContextOwner(owner: () => Promise<AgentContextBuildResult>): void {\n\t\tif (this.contextOwner) throw new Error(\"Agent context owner is already bound\");\n\t\tthis.contextOwner = owner;\n\t}\n\n\tbindRequestPreparationRecoveryOwner(owner: NonNullable<AgentLoopConfig[\"recoverRequestPreparation\"]>): void {\n\t\tif (this.requestPreparationRecoveryOwner)\n\t\t\tthrow new Error(\"Agent request preparation recovery owner is already bound\");\n\t\tthis.requestPreparationRecoveryOwner = owner;\n\t}\n\n\tbindProviderFailureRecoveryOwner(owner: {\n\t\trecover: NonNullable<AgentLoopConfig[\"recoverProviderFailure\"]>;\n\t\tsettle?: () => void;\n\t}): void {\n\t\tif (this.providerFailureRecoveryOwner) throw new Error(\"Agent provider failure recovery owner is already bound\");\n\t\tthis.providerFailureRecoveryOwner = owner;\n\t}\n\n\tprivate configuredStreamFn!: StreamFn;\n\tprivate effectiveStreamFn!: StreamFn;\n\tprivate ownedStreamFn?: AgentOwnedStreamFn;\n\tprivate streamOwner?: (streamFn: StreamFn) => AgentOwnedStreamFn;\n\n\tget streamFn(): StreamFn {\n\t\treturn this.effectiveStreamFn;\n\t}\n\tset streamFn(streamFn: StreamFn) {\n\t\tthis.configuredStreamFn = streamFn;\n\t\tconst ownedStreamFn = this.streamOwner?.(streamFn);\n\t\tthis.ownedStreamFn = ownedStreamFn;\n\t\tthis.effectiveStreamFn = ownedStreamFn ?? streamFn;\n\t}\n\n\t/* A native owner remains in the path when an embedding changes its configured stream. /\n\tbindStreamOwner(owner: (streamFn: StreamFn) => AgentOwnedStreamFn): void {\n\t\tif (this.streamOwner) throw new Error(\"Agent stream owner is already bound\");\n\t\tthis.streamOwner = owner;\n\t\tthis.streamFn = this.configuredStreamFn;\n\t}\n\tpublic getApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tpublic onPayload?: SimpleStreamOptions[\"onPayload\"];\n\tpublic onResponse?: SimpleStreamOptions[\"onResponse\"];\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 onToolInvocationStarting?: (invocation: ToolInvocation, signal?: AbortSignal) => void \| Promise<void>;\n\tpublic onToolExchangeFinalized?: (exchange: FinalizedToolExchange, signal?: AbortSignal) => void \| Promise<void>;\n\tprivate toolExecutionOwner?: Required<Pick<AgentLoopConfig, \"onToolInvocationStarting\" \| \"onToolExchangeFinalized\">>;\n\n\t/* Native persistence runs before replaceable caller hooks. /\n\tbindToolExecutionOwner(\n\t\towner: Required<Pick<AgentLoopConfig, \"onToolInvocationStarting\" \| \"onToolExchangeFinalized\">>,\n\t): void {\n\t\tif (this.toolExecutionOwner) throw new Error(\"Agent tool execution owner is already bound\");\n\t\tthis.toolExecutionOwner = {\n\t\t\tonToolInvocationStarting: owner.onToolInvocationStarting,\n\t\t\tonToolExchangeFinalized: owner.onToolExchangeFinalized,\n\t\t};\n\t}\n\n\tpublic shouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\tpublic getTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\tpublic shouldStopBeforeTurn?: () => boolean;\n\tpublic getContinuationMessages?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentMessage[]>;\n\tpublic getContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\n\tprivate activeRun?: ActiveRun;\n\tpublic sessionId?: string;\n\tpublic thinkingBudgets?: ThinkingBudgets;\n\tpublic transport: Transport;\n\tpublic maxRetryDelayMs?: number;\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.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.beforeToolCall = options.beforeToolCall;\n\t\tthis.afterToolCall = options.afterToolCall;\n\t\tthis.onToolInvocationStarting = options.onToolInvocationStarting;\n\t\tthis.onToolExchangeFinalized = options.onToolExchangeFinalized;\n\t\tthis.shouldStopAfterTurn = options.shouldStopAfterTurn;\n\t\tthis.getTurnOutcome = options.getTurnOutcome;\n\t\tthis.shouldStopBeforeTurn = options.shouldStopBeforeTurn;\n\t\tthis.getContinuationMessages = options.getContinuationMessages;\n\t\tthis.getContinuationOutcome = options.getContinuationOutcome;\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\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\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 batch to be injected after the current assistant turn finishes. /\n\tsteer(message: AgentMessage \| AgentMessage[]): void {\n\t\tthis.steeringQueue.enqueue(message);\n\t}\n\n\t/* Queue a message batch to run only after the agent would otherwise stop. /\n\tfollowUp(message: AgentMessage \| AgentMessage[]): void {\n\t\tthis.followUpQueue.enqueue(message);\n\t}\n\n\tclearSteeringQueue(): void {\n\t\tthis.steeringQueue.clear();\n\t}\n\n\tclearFollowUpQueue(): void {\n\t\tthis.followUpQueue.clear();\n\t}\n\n\tclearAllQueues(): void {\n\t\tthis.clearSteeringQueue();\n\t\tthis.clearFollowUpQueue();\n\t}\n\n\tremoveQueuedMessages(predicate: (message: AgentMessage) => boolean): AgentMessage[] {\n\t\treturn [...this.steeringQueue.removeWhere(predicate), ...this.followUpQueue.removeWhere(predicate)];\n\t}\n\n\thasQueuedMessages(): boolean {\n\t\treturn this.steeringQueue.hasItems() \|\| this.followUpQueue.hasItems();\n\t}\n\n\tget signal(): AbortSignal \| undefined {\n\t\treturn this.activeRun?.abortController.signal;\n\t}\n\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\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}\n\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/* The last message must convert to a user or tool-result message. /\n\tasync continue(): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new AgentContinueError(\"busy\", \"Agent is already processing. Wait for completion before continuing.\");\n\t\t}\n\n\t\tconst runQueuedMessages = (): Promise<void> \| undefined => {\n\t\t\tconst queuedSteering = this.steeringQueue.drain();\n\t\t\tif (queuedSteering.length > 0) {\n\t\t\t\treturn this.runPromptMessages(queuedSteering, { skipInitialSteeringPoll: true });\n\t\t\t}\n\n\t\t\tconst queuedFollowUps = this.followUpQueue.drain();\n\t\t\tif (queuedFollowUps.length > 0) {\n\t\t\t\treturn this.runPromptMessages(queuedFollowUps);\n\t\t\t}\n\n\t\t\treturn undefined;\n\t\t};\n\n\t\tconst lastMessage = this._state.messages[this._state.messages.length - 1];\n\t\tif (!lastMessage) {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new AgentContinueError(\"nothing-to-continue\", \"No messages to continue from\");\n\t\t}\n\n\t\tif (lastMessage.role === \"assistant\") {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new AgentContinueError(\"nothing-to-continue\", \"Cannot continue from message role: assistant\");\n\t\t}\n\n\t\tconst lastMessageRole: string = lastMessage.role;\n\t\tif (lastMessageRole === \"custom\") {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\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\tconst onToolInvocationStarting = this.onToolInvocationStarting;\n\t\tconst onToolExchangeFinalized = this.onToolExchangeFinalized;\n\t\treturn {\n\t\t\toutputPolicy: this.activeOutputPolicy,\n\t\t\tmodel: this._state.model,\n\t\t\treasoning: this._state.thinkingLevel,\n\t\t\tserviceTier: this._state.serviceTier,\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\tbeforeToolCall: this.beforeToolCall,\n\t\t\tafterToolCall: this.afterToolCall,\n\t\t\tonToolInvocationStarting: async (invocation, signal, tool, execute, assistantMessage) => {\n\t\t\t\tconst owner = await this.toolExecutionOwner?.onToolInvocationStarting(\n\t\t\t\t\tinvocation,\n\t\t\t\t\tsignal,\n\t\t\t\t\ttool,\n\t\t\t\t\texecute,\n\t\t\t\t\tassistantMessage,\n\t\t\t\t);\n\t\t\t\tawait onToolInvocationStarting?.(invocation, signal);\n\t\t\t\treturn owner \|\| undefined;\n\t\t\t},\n\t\t\tonToolExchangeFinalized: async (exchange, signal, owner) => {\n\t\t\t\tif (owner) await owner.finalize(exchange, signal);\n\t\t\t\telse await this.toolExecutionOwner?.onToolExchangeFinalized(exchange, signal);\n\t\t\t\tawait onToolExchangeFinalized?.(exchange, signal);\n\t\t\t},\n\t\t\tshouldStopAfterTurn: async (context) => this.shouldStopAfterTurn?.(context) ?? false,\n\t\t\tgetTurnOutcome: this.getTurnOutcome?.bind(this),\n\t\t\tshouldStopBeforeTurn: () => this.shouldStopBeforeTurn?.() ?? false,\n\t\t\tbeforeContextBuild: async () => this.contextOwner?.(),\n\t\t\trecoverRequestPreparation: this.requestPreparationRecoveryOwner,\n\t\t\trecoverProviderFailure: this.providerFailureRecoveryOwner?.recover,\n\t\t\tonContextAdopted: (messages) => {\n\t\t\t\tthis._state.messages = messages;\n\t\t\t},\n\t\t\townedStreamFn: this.ownedStreamFn,\n\t\t\tconvertToLlm: this.convertToLlm,\n\t\t\ttransformContext: this.transformContext,\n\t\t\tgetSystemPrompt: () => this._state.systemPrompt,\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\tgetContinuationMessages: async (context, signal) => this.getContinuationMessages?.(context, signal) ?? [],\n\t\t\tgetContinuationOutcome: this.getContinuationOutcome?.bind(this),\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\ttry {\n\t\t\tconst outputPolicy = this.outputOwner?.();\n\t\t\tthis.activeOutputPolicy = outputPolicy\n\t\t\t\t? {\n\t\t\t\t\t\tlimits: { ...outputPolicy.limits },\n\t\t\t\t\t\tsnapshot: outputPolicy.snapshot.bind(outputPolicy),\n\t\t\t\t\t\tbindUpdates: outputPolicy.bindUpdates?.bind(outputPolicy),\n\t\t\t\t\t\tsettleUpdates: outputPolicy.settleUpdates?.bind(outputPolicy),\n\t\t\t\t\t}\n\t\t\t\t: undefined;\n\t\t\tif (this.initializationOwner) {\n\t\t\t\tawait this.initializationOwner();\n\t\t\t\tabortController.signal.throwIfAborted();\n\t\t\t}\n\t\t\tawait executor(abortController.signal);\n\t\t} catch (error) {\n\t\t\tif (error instanceof AgentOutputLimitError \|\| isRequestTokenBudgetFailure(error)) {\n\t\t\t\tthis._state.errorMessage = error.message;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tawait this.handleRunFailure(error, abortController.signal.aborted);\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tthis.providerFailureRecoveryOwner?.settle?.();\n\t\t\t} finally {\n\t\t\t\tthis.finishRun();\n\t\t\t}\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\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\tdiagnostics: aborted\n\t\t\t\t? undefined\n\t\t\t\t: [createAssistantMessageDiagnostic(\"agent_lifecycle_failure\", error, { source: \"run_with_lifecycle\" })],\n\t\t\ttimestamp: Date.now(),\n\t\t} satisfies AgentMessage;\n\t\tthis._state.errorMessage = failureMessage.errorMessage;\n\t\tawait this.processEvents({ type: \"message_start\", message: failureMessage }).catch(() => undefined);\n\t\tawait this.processEvents({ type: \"message_end\", message: failureMessage }).catch(() => undefined);\n\t\tawait this.processEvents({ type: \"agent_end\", messages: [failureMessage] }).catch(() => undefined);\n\t}\n\n\tprivate finishRun(): void {\n\t\tthis.activeOutputPolicy = undefined;\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\tif (event.refusal) this._state.errorMessage = new AgentOutputLimitError(event.refusal).message;\n\t\t\t\tbreak;\n\t\t}\n\n\t\tconst signal = this.activeRun?.abortController.signal;\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"]}
1	+ {"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tcreateAssistantMessageDiagnostic,\n\ttype ImageContent,\n\tisLocalRequestPreparationError,\n\ttype Message,\n\tRequestTokenBudgetError,\n\ttype SimpleStreamOptions,\n\tstreamSimple,\n\ttype TextContent,\n\ttype ThinkingBudgets,\n\ttype Transport,\n} from \"@ponythewhite/base-context-ai\";\nimport { runAgentLoop, runAgentLoopContinue } from \"./agent-loop.js\";\nimport { AgentOutputLimitError } from \"./invocation-output.js\";\nimport type {\n\tAfterToolCallContext,\n\tAfterToolCallResult,\n\tAgentContext,\n\tAgentContextBuildResult,\n\tAgentContinuationOutcome,\n\tAgentEvent,\n\tAgentLoopConfig,\n\tAgentMessage,\n\tAgentOutputPolicy,\n\tAgentOwnedStreamFn,\n\tAgentState,\n\tAgentTool,\n\tAgentTurnOutcome,\n\tBeforeToolCallContext,\n\tBeforeToolCallResult,\n\tFinalizedToolExchange,\n\tGetContinuationMessagesContext,\n\tGetTurnOutcomeContext,\n\tShouldStopAfterTurnContext,\n\tStreamFn,\n\tToolExecutionMode,\n\tToolInvocation,\n} from \"./types.js\";\n\n/** Preserve actual local request preparation failures and primary cleanup chains without inventing an assistant. /\nfunction isRequestTokenBudgetFailure(error: unknown): error is Error {\n\treturn (\n\t\terror instanceof RequestTokenBudgetError \|\|\n\t\tisLocalRequestPreparationError(error) \|\|\n\t\t(error instanceof AggregateError && isRequestTokenBudgetFailure(error.errors[0]))\n\t);\n}\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\ntype QueueMode = \"all\" \| \"one-at-a-time\";\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,\n\t\tthinkingLevel: initialState?.thinkingLevel ?? \"off\",\n\t\tserviceTier: initialState?.serviceTier ?? \"default\",\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\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\tstreamFn?: StreamFn;\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tonPayload?: SimpleStreamOptions[\"onPayload\"];\n\tonResponse?: SimpleStreamOptions[\"onResponse\"];\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n\tonToolInvocationStarting?: (invocation: ToolInvocation, signal?: AbortSignal) => void \| Promise<void>;\n\tonToolExchangeFinalized?: (exchange: FinalizedToolExchange, signal?: AbortSignal) => void \| Promise<void>;\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\tgetTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\tshouldStopBeforeTurn?: () => boolean;\n\tgetContinuationMessages?: (context: GetContinuationMessagesContext, signal?: AbortSignal) => Promise<AgentMessage[]>;\n\tgetContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\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 batches: AgentMessage[][] = [];\n\n\tconstructor(public mode: QueueMode) {}\n\n\tenqueue(message: AgentMessage \| AgentMessage[]): void {\n\t\tconst batch = Array.isArray(message) ? message.slice() : [message];\n\t\tif (batch.length > 0) {\n\t\t\tthis.batches.push(batch);\n\t\t}\n\t}\n\n\thasItems(): boolean {\n\t\treturn this.batches.length > 0;\n\t}\n\n\tdrain(): AgentMessage[] {\n\t\tif (this.mode === \"all\") {\n\t\t\tconst drained = this.batches.flat();\n\t\t\tthis.batches = [];\n\t\t\treturn drained;\n\t\t}\n\n\t\tconst first = this.batches[0];\n\t\tif (!first) {\n\t\t\treturn [];\n\t\t}\n\t\tthis.batches = this.batches.slice(1);\n\t\treturn first;\n\t}\n\n\tclear(): void {\n\t\tthis.batches = [];\n\t}\n\n\tremoveWhere(predicate: (message: AgentMessage) => boolean): AgentMessage[] {\n\t\tconst removed: AgentMessage[] = [];\n\t\tconst retained: AgentMessage[][] = [];\n\t\tfor (const batch of this.batches) {\n\t\t\tif (batch.some(predicate)) {\n\t\t\t\tremoved.push(...batch);\n\t\t\t} else {\n\t\t\t\tretained.push(batch);\n\t\t\t}\n\t\t}\n\t\tthis.batches = retained;\n\t\treturn removed;\n\t}\n}\n\ntype ActiveRun = {\n\tpromise: Promise<void>;\n\tresolve: () => void;\n\tabortController: AbortController;\n};\n\n/* Why {@link Agent.continue} refused to start a continuation. /\nexport type AgentContinueErrorCode = \"busy\" \| \"nothing-to-continue\";\n\n/* Typed precondition failure from {@link Agent.continue}, so callers classify by code instead of message text. /\nexport class AgentContinueError extends Error {\n\tconstructor(\n\t\treadonly code: AgentContinueErrorCode,\n\t\tmessage: string,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"AgentContinueError\";\n\t}\n}\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\tprivate initializationOwner?: () => Promise<void>;\n\tprivate contextOwner?: () => Promise<AgentContextBuildResult>;\n\tprivate requestPreparationRecoveryOwner?: AgentLoopConfig[\"recoverRequestPreparation\"];\n\tprivate providerFailureRecoveryOwner?: {\n\t\trecover: NonNullable<AgentLoopConfig[\"recoverProviderFailure\"]>;\n\t\tsettle?: () => void;\n\t};\n\tprivate outputOwner?: () => AgentOutputPolicy \| undefined;\n\tprivate activeOutputPolicy?: AgentOutputPolicy;\n\n\t/* Native sinks join finalized message values; configuration is captured once per invocation. /\n\tbindOutputOwner(owner: () => AgentOutputPolicy \| undefined): void {\n\t\tif (this.outputOwner) throw new Error(\"Agent output owner is already bound\");\n\t\tthis.outputOwner = owner;\n\t}\n\n\t/* Finish native initialization before capturing context or emitting loop events. /\n\tbindInitializationOwner(owner: () => Promise<void>): void {\n\t\tif (this.initializationOwner) throw new Error(\"Agent initialization owner is already bound\");\n\t\tthis.initializationOwner = owner;\n\t}\n\n\t/* Native persistence remains ahead of replaceable context callbacks. /\n\tbindContextOwner(owner: () => Promise<AgentContextBuildResult>): void {\n\t\tif (this.contextOwner) throw new Error(\"Agent context owner is already bound\");\n\t\tthis.contextOwner = owner;\n\t}\n\n\tbindRequestPreparationRecoveryOwner(owner: NonNullable<AgentLoopConfig[\"recoverRequestPreparation\"]>): void {\n\t\tif (this.requestPreparationRecoveryOwner)\n\t\t\tthrow new Error(\"Agent request preparation recovery owner is already bound\");\n\t\tthis.requestPreparationRecoveryOwner = owner;\n\t}\n\n\tbindProviderFailureRecoveryOwner(owner: {\n\t\trecover: NonNullable<AgentLoopConfig[\"recoverProviderFailure\"]>;\n\t\tsettle?: () => void;\n\t}): void {\n\t\tif (this.providerFailureRecoveryOwner) throw new Error(\"Agent provider failure recovery owner is already bound\");\n\t\tthis.providerFailureRecoveryOwner = owner;\n\t}\n\n\tprivate configuredStreamFn!: StreamFn;\n\tprivate effectiveStreamFn!: StreamFn;\n\tprivate ownedStreamFn?: AgentOwnedStreamFn;\n\tprivate streamOwner?: (streamFn: StreamFn) => AgentOwnedStreamFn;\n\n\tget streamFn(): StreamFn {\n\t\treturn this.effectiveStreamFn;\n\t}\n\tset streamFn(streamFn: StreamFn) {\n\t\tthis.configuredStreamFn = streamFn;\n\t\tconst ownedStreamFn = this.streamOwner?.(streamFn);\n\t\tthis.ownedStreamFn = ownedStreamFn;\n\t\tthis.effectiveStreamFn = ownedStreamFn ?? streamFn;\n\t}\n\n\t/* A native owner remains in the path when an embedding changes its configured stream. /\n\tbindStreamOwner(owner: (streamFn: StreamFn) => AgentOwnedStreamFn): void {\n\t\tif (this.streamOwner) throw new Error(\"Agent stream owner is already bound\");\n\t\tthis.streamOwner = owner;\n\t\tthis.streamFn = this.configuredStreamFn;\n\t}\n\tpublic getApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\tpublic onPayload?: SimpleStreamOptions[\"onPayload\"];\n\tpublic onResponse?: SimpleStreamOptions[\"onResponse\"];\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 onToolInvocationStarting?: (invocation: ToolInvocation, signal?: AbortSignal) => void \| Promise<void>;\n\tpublic onToolExchangeFinalized?: (exchange: FinalizedToolExchange, signal?: AbortSignal) => void \| Promise<void>;\n\tprivate toolExecutionOwner?: Required<Pick<AgentLoopConfig, \"onToolInvocationStarting\" \| \"onToolExchangeFinalized\">>;\n\n\t/* Native persistence runs before replaceable caller hooks. /\n\tbindToolExecutionOwner(\n\t\towner: Required<Pick<AgentLoopConfig, \"onToolInvocationStarting\" \| \"onToolExchangeFinalized\">>,\n\t): void {\n\t\tif (this.toolExecutionOwner) throw new Error(\"Agent tool execution owner is already bound\");\n\t\tthis.toolExecutionOwner = {\n\t\t\tonToolInvocationStarting: owner.onToolInvocationStarting,\n\t\t\tonToolExchangeFinalized: owner.onToolExchangeFinalized,\n\t\t};\n\t}\n\n\tpublic shouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\tpublic getTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\tpublic shouldStopBeforeTurn?: () => boolean;\n\tpublic getContinuationMessages?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentMessage[]>;\n\tpublic getContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\n\tprivate activeRun?: ActiveRun;\n\tpublic sessionId?: string;\n\tpublic thinkingBudgets?: ThinkingBudgets;\n\tpublic transport: Transport;\n\tpublic maxRetryDelayMs?: number;\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.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.beforeToolCall = options.beforeToolCall;\n\t\tthis.afterToolCall = options.afterToolCall;\n\t\tthis.onToolInvocationStarting = options.onToolInvocationStarting;\n\t\tthis.onToolExchangeFinalized = options.onToolExchangeFinalized;\n\t\tthis.shouldStopAfterTurn = options.shouldStopAfterTurn;\n\t\tthis.getTurnOutcome = options.getTurnOutcome;\n\t\tthis.shouldStopBeforeTurn = options.shouldStopBeforeTurn;\n\t\tthis.getContinuationMessages = options.getContinuationMessages;\n\t\tthis.getContinuationOutcome = options.getContinuationOutcome;\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\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\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 batch to be injected after the current assistant turn finishes. /\n\tsteer(message: AgentMessage \| AgentMessage[]): void {\n\t\tthis.steeringQueue.enqueue(message);\n\t}\n\n\t/* Queue a message batch to run only after the agent would otherwise stop. /\n\tfollowUp(message: AgentMessage \| AgentMessage[]): void {\n\t\tthis.followUpQueue.enqueue(message);\n\t}\n\n\tclearSteeringQueue(): void {\n\t\tthis.steeringQueue.clear();\n\t}\n\n\tclearFollowUpQueue(): void {\n\t\tthis.followUpQueue.clear();\n\t}\n\n\tclearAllQueues(): void {\n\t\tthis.clearSteeringQueue();\n\t\tthis.clearFollowUpQueue();\n\t}\n\n\tremoveQueuedMessages(predicate: (message: AgentMessage) => boolean): AgentMessage[] {\n\t\treturn [...this.steeringQueue.removeWhere(predicate), ...this.followUpQueue.removeWhere(predicate)];\n\t}\n\n\thasQueuedMessages(): boolean {\n\t\treturn this.steeringQueue.hasItems() \|\| this.followUpQueue.hasItems();\n\t}\n\n\tget signal(): AbortSignal \| undefined {\n\t\treturn this.activeRun?.abortController.signal;\n\t}\n\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\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}\n\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/* The last message must convert to a user or tool-result message. /\n\tasync continue(): Promise<void> {\n\t\tif (this.activeRun) {\n\t\t\tthrow new AgentContinueError(\"busy\", \"Agent is already processing. Wait for completion before continuing.\");\n\t\t}\n\n\t\tconst runQueuedMessages = (): Promise<void> \| undefined => {\n\t\t\tconst queuedSteering = this.steeringQueue.drain();\n\t\t\tif (queuedSteering.length > 0) {\n\t\t\t\treturn this.runPromptMessages(queuedSteering, { skipInitialSteeringPoll: true });\n\t\t\t}\n\n\t\t\tconst queuedFollowUps = this.followUpQueue.drain();\n\t\t\tif (queuedFollowUps.length > 0) {\n\t\t\t\treturn this.runPromptMessages(queuedFollowUps);\n\t\t\t}\n\n\t\t\treturn undefined;\n\t\t};\n\n\t\tconst lastMessage = this._state.messages[this._state.messages.length - 1];\n\t\tif (!lastMessage) {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new AgentContinueError(\"nothing-to-continue\", \"No messages to continue from\");\n\t\t}\n\n\t\tif (lastMessage.role === \"assistant\") {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tthrow new AgentContinueError(\"nothing-to-continue\", \"Cannot continue from message role: assistant\");\n\t\t}\n\n\t\tconst lastMessageRole: string = lastMessage.role;\n\t\tif (lastMessageRole === \"custom\") {\n\t\t\tconst queuedRun = runQueuedMessages();\n\t\t\tif (queuedRun) {\n\t\t\t\tawait queuedRun;\n\t\t\t\treturn;\n\t\t\t}\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\tif (!this._state.model)\n\t\t\tthrow new Error(\"No model selected. Select a provider and model before starting the agent.\");\n\t\tlet skipInitialSteeringPoll = options.skipInitialSteeringPoll === true;\n\t\tconst onToolInvocationStarting = this.onToolInvocationStarting;\n\t\tconst onToolExchangeFinalized = this.onToolExchangeFinalized;\n\t\treturn {\n\t\t\toutputPolicy: this.activeOutputPolicy,\n\t\t\tmodel: this._state.model,\n\t\t\treasoning: this._state.thinkingLevel,\n\t\t\tserviceTier: this._state.serviceTier,\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\tbeforeToolCall: this.beforeToolCall,\n\t\t\tafterToolCall: this.afterToolCall,\n\t\t\tonToolInvocationStarting: async (invocation, signal, tool, execute, assistantMessage) => {\n\t\t\t\tconst owner = await this.toolExecutionOwner?.onToolInvocationStarting(\n\t\t\t\t\tinvocation,\n\t\t\t\t\tsignal,\n\t\t\t\t\ttool,\n\t\t\t\t\texecute,\n\t\t\t\t\tassistantMessage,\n\t\t\t\t);\n\t\t\t\tawait onToolInvocationStarting?.(invocation, signal);\n\t\t\t\treturn owner \|\| undefined;\n\t\t\t},\n\t\t\tonToolExchangeFinalized: async (exchange, signal, owner) => {\n\t\t\t\tif (owner) await owner.finalize(exchange, signal);\n\t\t\t\telse await this.toolExecutionOwner?.onToolExchangeFinalized(exchange, signal);\n\t\t\t\tawait onToolExchangeFinalized?.(exchange, signal);\n\t\t\t},\n\t\t\tshouldStopAfterTurn: async (context) => this.shouldStopAfterTurn?.(context) ?? false,\n\t\t\tgetTurnOutcome: this.getTurnOutcome?.bind(this),\n\t\t\tshouldStopBeforeTurn: () => this.shouldStopBeforeTurn?.() ?? false,\n\t\t\tbeforeContextBuild: async () => this.contextOwner?.(),\n\t\t\trecoverRequestPreparation: this.requestPreparationRecoveryOwner,\n\t\t\trecoverProviderFailure: this.providerFailureRecoveryOwner?.recover,\n\t\t\tonContextAdopted: (messages) => {\n\t\t\t\tthis._state.messages = messages;\n\t\t\t},\n\t\t\townedStreamFn: this.ownedStreamFn,\n\t\t\tconvertToLlm: this.convertToLlm,\n\t\t\ttransformContext: this.transformContext,\n\t\t\tgetSystemPrompt: () => this._state.systemPrompt,\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\tgetContinuationMessages: async (context, signal) => this.getContinuationMessages?.(context, signal) ?? [],\n\t\t\tgetContinuationOutcome: this.getContinuationOutcome?.bind(this),\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\t\tif (!this._state.model)\n\t\t\tthrow new Error(\"No model selected. Select a provider and model before starting the agent.\");\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\ttry {\n\t\t\tconst outputPolicy = this.outputOwner?.();\n\t\t\tthis.activeOutputPolicy = outputPolicy\n\t\t\t\t? {\n\t\t\t\t\t\tlimits: { ...outputPolicy.limits },\n\t\t\t\t\t\tsnapshot: outputPolicy.snapshot.bind(outputPolicy),\n\t\t\t\t\t\tbindUpdates: outputPolicy.bindUpdates?.bind(outputPolicy),\n\t\t\t\t\t\tsettleUpdates: outputPolicy.settleUpdates?.bind(outputPolicy),\n\t\t\t\t\t}\n\t\t\t\t: undefined;\n\t\t\tif (this.initializationOwner) {\n\t\t\t\tawait this.initializationOwner();\n\t\t\t\tabortController.signal.throwIfAborted();\n\t\t\t}\n\t\t\tawait executor(abortController.signal);\n\t\t} catch (error) {\n\t\t\tif (error instanceof AgentOutputLimitError \|\| isRequestTokenBudgetFailure(error)) {\n\t\t\t\tthis._state.errorMessage = error.message;\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tawait this.handleRunFailure(error, abortController.signal.aborted);\n\t\t} finally {\n\t\t\ttry {\n\t\t\t\tthis.providerFailureRecoveryOwner?.settle?.();\n\t\t\t} finally {\n\t\t\t\tthis.finishRun();\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async handleRunFailure(error: unknown, aborted: boolean): Promise<void> {\n\t\tif (!this._state.model) throw error;\n\t\tconst failureMessage = {\n\t\t\trole: \"assistant\",\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\tdiagnostics: aborted\n\t\t\t\t? undefined\n\t\t\t\t: [createAssistantMessageDiagnostic(\"agent_lifecycle_failure\", error, { source: \"run_with_lifecycle\" })],\n\t\t\ttimestamp: Date.now(),\n\t\t} satisfies AgentMessage;\n\t\tthis._state.errorMessage = failureMessage.errorMessage;\n\t\tawait this.processEvents({ type: \"message_start\", message: failureMessage }).catch(() => undefined);\n\t\tawait this.processEvents({ type: \"message_end\", message: failureMessage }).catch(() => undefined);\n\t\tawait this.processEvents({ type: \"agent_end\", messages: [failureMessage] }).catch(() => undefined);\n\t}\n\n\tprivate finishRun(): void {\n\t\tthis.activeOutputPolicy = undefined;\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\tif (event.refusal) this._state.errorMessage = new AgentOutputLimitError(event.refusal).message;\n\t\t\t\tbreak;\n\t\t}\n\n\t\tconst signal = this.activeRun?.abortController.signal;\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"]}

package/dist/build-info.json CHANGED Viewed

@@ -1,5 +1,5 @@
 {
-  "sourceCommit": "3b6e414e5d955f03bdebf866f39b85853a896d13",
+  "sourceCommit": "4192025d919683d61a402b666b4790e26118df53",
   "sourceDirty": false,
   "buildHost": {
     "platform": "linux",

package/dist/types.d.ts CHANGED Viewed

@@ -379,7 +379,7 @@ export interface AgentState {
     /** System prompt sent with each model request. */
     systemPrompt: string;
     /** Model used for future turns. */
-    model: Model<any>;
+    model: Model<any> | undefined;
     /** Requested reasoning level for future turns. */
     thinkingLevel: ThinkingLevel;
     /** Requested provider service tier for future turns. */

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

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,OAAO,EACP,KAAK,EACL,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,IAAI,EACJ,iBAAiB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG,CACtB,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,KACpC,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACtC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAGD,MAAM,MAAM,uBAAuB,GAAG,IAAI,GAAG,sBAAsB,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,KAAK,UAAU,CAAC,QAAQ,CAAC,CAAC;AAEvH;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE1D,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAE/F;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IACnC,OAAO,CAAC,EAAE,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACrC,iDAAiD;IACjD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,EAAE,aAAa,CAAC;IACxB,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;IACd,gDAAgD;IAChD,OAAO,EAAE,YAAY,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,oBAAoB;IACpC,iDAAiD;IACjD,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,2DAA2D;IAC3D,QAAQ,EAAE,aAAa,CAAC;IACxB,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;IACd,4DAA4D;IAC5D,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC;IAC7B,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,OAAO,EAAE,YAAY,CAAC;CACtB;AAED,+FAA+F;AAC/F,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAE9F,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;CAC1C;AAED,+FAA+F;AAC/F,MAAM,WAAW,kBAAkB;IAClC,GAAG,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;IACzF,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF;AAED,iGAAiG;AACjG,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC;IACnF,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;IAChD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACnC;AAED,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC5D,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,gBAAgB,CAAC;CACtD;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,yGAAyG;IACzG,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,GAAG,MAAM,IAAI,CAAC;IACtE,8FAA8F;IAC9F,aAAa,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,sGAAsG;IACtG,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACpH;AAED,+EAA+E;AAC/E,MAAM,WAAW,0BAA0B;IAC1C,iDAAiD;IACjD,OAAO,EAAE,gBAAgB,CAAC;IAC1B,uEAAuE;IACvE,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,6EAA6E;IAC7E,OAAO,EAAE,YAAY,CAAC;IACtB,kHAAkH;IAClH,WAAW,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAsB,SAAQ,0BAA0B;IACxE,gBAAgB,EAAE,OAAO,CAAC;CAC1B;AAED,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,0BAA0B,GAAG,WAAW,CAAA;CAAE,CAAC;AAEzG,MAAM,MAAM,8BAA8B,GAAG,0BAA0B,CAAC;AAExE,sGAAsG;AACtG,MAAM,MAAM,wBAAwB,GACjC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,QAAQ,GAAG,qBAAqB,GAAG,WAAW,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC3D,sFAAsF;IACtF,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAElB,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAE5D,kGAAkG;IAClG,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE,oFAAoF;IACpF,yBAAyB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvF,wFAAwF;IACxF,sBAAsB,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAE/F,sFAAsF;IACtF,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,YAAY,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAE3E;;;;;;;;;;;;;;;;;;;OAmBG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAE/F,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;IAE/B;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;IAEnF;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1F,6GAA6G;IAC7G,cAAc,CAAC,EAAE,CAChB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,WAAW,KAChB,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAElD;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC;IAErC;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEpD;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEpD;;;;;;;;;;;OAWG;IACH,uBAAuB,CAAC,EAAE,CAAC,OAAO,EAAE,8BAA8B,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAErH;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,CACxB,OAAO,EAAE,8BAA8B,EACvC,MAAM,CAAC,EAAE,WAAW,KAChB,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAEvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,CAC1B,UAAU,EAAE,cAAc,EAC1B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAC7B,gBAAgB,CAAC,EAAE,gBAAgB,KAC/B,IAAI,GAAG,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAEzF;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,CACzB,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,KAAK,CAAC,EAAE,kBAAkB,KACtB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAErH;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;CAClH;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5F;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,mBAAmB;CAAG;AAEvC,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,mBAAmB,CAAC,MAAM,mBAAmB,CAAC,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IAC1B,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,kDAAkD;IAClD,aAAa,EAAE,aAAa,CAAC;IAC7B,wDAAwD;IACxD,WAAW,EAAE,WAAW,CAAC;IACzB,yEAAyE;IACzE,IAAI,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE;IACnC,IAAI,KAAK,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9B,iFAAiF;IACjF,IAAI,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE;IACvC,IAAI,QAAQ,IAAI,YAAY,EAAE,CAAC;IAC/B,+FAA+F;IAC/F,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,YAAY,CAAC;IACzC,yCAAyC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,mDAAmD;IACnD,OAAO,EAAE,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACxC,mDAAmD;IACnD,OAAO,EAAE,CAAC,CAAC;IACX;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,MAAM,uBAAuB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAE3F,iDAAiD;AACjD,MAAM,WAAW,SAAS,CAAC,WAAW,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,GAAG,CAAE,SAAQ,IAAI,CAAC,WAAW,CAAC;IAC1G,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1D,uFAAuF;IACvF,OAAO,EAAE,CACR,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,EAC3B,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,uBAAuB,CAAC,QAAQ,CAAC,KACxC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,iBAAiB,CAAC;CAClC;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC5B,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,oCAAoC;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU;AACrB,4FAA4F;AAC1F;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;CAAE;AACtE,2DAA2D;GACzD;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IACA,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,oFAAoF;IACpF,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,sFAAsF;IACtF,SAAS,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC5C;AACH,sEAAsE;GACpE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE;AAClD,4DAA4D;GAC1D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,YAAY,CAAC;IAAC,qBAAqB,EAAE,qBAAqB,CAAA;CAAE,GAC/F;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE;AAChD,4FAA4F;GAC1F;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAC;IAAC,aAAa,EAAE,GAAG,CAAA;CAAE,GACtG;IACA,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAChC,CAAC","sourcesContent":["import type {\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tImageContent,\n\tMessage,\n\tModel,\n\tServiceTier,\n\tSimpleStreamOptions,\n\tstreamSimple,\n\tTextContent,\n\tTool,\n\tToolResultMessage,\n} from \"@ponythewhite/base-context-ai\";\nimport type { Static, TSchema } from \"typebox\";\n\n/*\n Stream function used by the agent loop.\n \n Contract:\n * - Must not throw or return a rejected promise for request/model/runtime failures.\n * - Must return an AssistantMessageEventStream.\n * - Failures must be encoded in the returned stream via protocol events and a\n * final AssistantMessage with stopReason \"error\" or \"aborted\" and errorMessage.\n /\nexport type StreamFn = (\n\t...args: Parameters<typeof streamSimple>\n) => ReturnType<typeof streamSimple> \| Promise<ReturnType<typeof streamSimple>>;\n\nexport interface AgentContextProjection {\n\tmessages: AgentMessage[];\n\t/\n\t Adopt this complete working set in the owning Agent and loop, not only for inference.\n\t * It must include the current turn and pending tool closure. This is not a last-N tail.\n\t * Omitted/false preserves the existing inference-only projection behavior.\n\t /\n\tadoptMessages?: boolean;\n\tstreamContext?: unknown;\n\trelease?: () => Promise<void>;\n}\n\n// biome-ignore lint/suspicious/noConfusingVoidType: this return contract accepts existing Promise<void> context barriers.\nexport type AgentContextBuildResult = void \| AgentContextProjection;\n\nexport type AgentOwnedStreamFn = (...args: [...Parameters<StreamFn>, streamContext?: unknown]) => ReturnType<StreamFn>;\n\n/\n Configuration for how tool calls from a single assistant message are executed.\n \n - \"sequential\": each tool call is prepared, executed, and finalized before the next one starts.\n * - \"parallel\": tool calls are prepared sequentially, then allowed tools execute concurrently.\n * `tool_execution_end` is emitted in tool completion order after each tool is finalized,\n * while tool-result message artifacts are emitted later in assistant source order.\n /\nexport type ToolExecutionMode = \"sequential\" \| \"parallel\";\n\n/* A tool-call content block emitted by an assistant message. /\nexport type AgentToolCall = Extract<AssistantMessage[\"content\"][number], { type: \"toolCall\" }>;\n\n/\n Result returned from `beforeToolCall`.\n \n Returning `{ block: true }` prevents the tool from executing. The loop emits an error tool result instead.\n * `reason` becomes the text shown in that error result. If omitted, a default blocked message is used.\n /\nexport interface BeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\n/\n Partial override returned from `afterToolCall`.\n \n Merge semantics are field-by-field:\n * - `content`: if provided, replaces the tool result content array in full\n * - `details`: if provided, replaces the tool result details value in full\n * - `isError`: if provided, replaces the tool result error flag\n * - `terminate`: if provided, replaces the early-termination hint\n \n Omitted fields keep the original executed tool result values.\n * There is no deep merge for `content` or `details`.\n /\nexport interface AfterToolCallResult {\n\tcontent?: (TextContent \| ImageContent)[];\n\tdetails?: unknown;\n\tisError?: boolean;\n\t/\n\t Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t /\n\tterminate?: boolean;\n}\n\n/* Context passed to `beforeToolCall` after arguments are validated. /\nexport interface BeforeToolCallContext {\n\t/* Assistant message that requested the call. /\n\tassistantMessage: AssistantMessage;\n\t/* Raw tool-call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated arguments for the target tool schema. /\n\targs: unknown;\n\t/* Agent context when this call is prepared. /\n\tcontext: AgentContext;\n}\n\n/* Context passed to `afterToolCall`. /\nexport interface AfterToolCallContext {\n\t/* Assistant message that requested the call. /\n\tassistantMessage: AssistantMessage;\n\t/* Raw tool-call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated arguments for the target tool schema. /\n\targs: unknown;\n\t/* Executed result before any `afterToolCall` overrides. /\n\tresult: AgentToolResult<any>;\n\t/* Whether the executed result is currently treated as an error. /\n\tisError: boolean;\n\t/* Agent context when this call is finalized. /\n\tcontext: AgentContext;\n}\n\n/* What is known about the actual invocation, independently of middleware result overrides. /\nexport type ToolExecutionOutcome = \"not_started\" \| \"completed\" \| \"failed\" \| \"outcome_unknown\";\n\n/* Immutable invocation admitted by the execution owner before the tool can run. /\nexport interface ToolInvocation {\n\treadonly executionId: string;\n\treadonly sourceOrder: number;\n\treadonly toolCallId: string;\n\treadonly toolName: string;\n\t/* Snapshot before argument preparation, validation, or tool middleware. /\n\treadonly originalInput: unknown;\n\t/* Arguments reserved for this invocation, not a live middleware object. /\n\treadonly executedInput: unknown;\n\treadonly toolExecution: ToolExecutionMode;\n}\n\n/* @internal Per-invocation owner closure; never serialized or supplied by result metadata. /\nexport interface BoundToolExecution {\n\trun(execute: () => Promise<AgentToolResult<unknown>>): Promise<AgentToolResult<unknown>>;\n\tfinalize(exchange: FinalizedToolExchange, signal?: AbortSignal): void \| Promise<void>;\n}\n\n/* Finalized source evidence; parallel exchanges retain assistant call order via sourceOrder. /\nexport interface FinalizedToolExchange extends Omit<ToolInvocation, \"executedInput\"> {\n\t/* Snapshot at invocation; absent when execution never started. /\n\treadonly executedInput?: unknown;\n\t/* An aborted wait does not establish whether an external effect stopped. /\n\treadonly executionOutcome: ToolExecutionOutcome;\n\treadonly cancellationRequested: boolean;\n\t/* Final middleware result, also used for the tool-result message. /\n\treadonly result: ToolResultMessage;\n}\n\n/* Limits on the complete invocation result, not the working context or observer queues. /\nexport interface AgentOutputLimits {\n\tmaxMessages: number;\n\tmaxSourceBytes: number;\n}\n\nexport interface AgentOutputRefusal extends AgentOutputLimits {\n\tkind: \"output_limit\";\n\tlimit: \"messages\" \| \"source_bytes\" \| \"value_encoding\";\n}\n\nexport interface AgentOutputPolicy {\n\tlimits: AgentOutputLimits;\n\t/* Optional native update feed. Its synchronous refresh never revokes an ACK or throws a quota error. /\n\tbindUpdates?(refresh: (message: AgentMessage) => boolean): () => void;\n\t/* Close update admission and join the updates already accepted at this terminal boundary. /\n\tsettleUpdates?(): Promise<void>;\n\t/* Copy one finalized value within the supplied JSON-byte budget; undefined means it does not fit. /\n\tsnapshot(message: AgentMessage, maxSourceBytes: number): { message: AgentMessage; sourceBytes: number } \| undefined;\n}\n\n/* Context passed to `shouldStopAfterTurn` and both continuation callbacks. /\nexport interface ShouldStopAfterTurnContext {\n\t/* Assistant message that completed the turn. /\n\tmessage: AssistantMessage;\n\t/* Tool-result messages included in the preceding `turn_end` event. /\n\ttoolResults: ToolResultMessage[];\n\t/* Context after appending the turn's assistant message and tool results. /\n\tcontext: AgentContext;\n\t/* Messages returned by this invocation; prompts include initial prompts, continuations exclude prior context. /\n\tnewMessages: AgentMessage[];\n}\n\n/* The finalized loop decision, not a guess from the rendered message tail. /\nexport interface GetTurnOutcomeContext extends ShouldStopAfterTurnContext {\n\thasMoreToolCalls: boolean;\n}\n\n/* Control before queue polling; proceed keeps the ordinary loop policy. /\nexport type AgentTurnOutcome = { kind: \"proceed\" \| \"finish\" \| \"checkpoint_then_continue\" \| \"cancelled\" };\n\nexport type GetContinuationMessagesContext = ShouldStopAfterTurnContext;\n\n/* Runtime control at a natural turn boundary; message payload does not decide whether to restart. /\nexport type AgentContinuationOutcome =\n\t\| { kind: \"continue\"; messages: AgentMessage[] }\n\t\| { kind: \"finish\" \| \"wait_for_owned_work\" \| \"cancelled\" };\n\nexport interface AgentLoopConfig extends SimpleStreamOptions {\n\t/* Opt-in bounded finalized results. Native sinks must join their message_end job. /\n\toutputPolicy?: AgentOutputPolicy;\n\tmodel: Model<any>;\n\n\t/* Native owner barrier before transform/convert. Rejection stops context construction. /\n\tbeforeContextBuild?: () => Promise<AgentContextBuildResult>;\n\n\t/* Internal state mirror for adopted working sets. Awaited and excluded from provider options. /\n\tonContextAdopted?: (messages: AgentMessage[]) => void \| Promise<void>;\n\n\t/* Native owner recovery after an unsent request's projection has been released. /\n\trecoverRequestPreparation?: (error: unknown, signal?: AbortSignal) => Promise<boolean>;\n\n\t/* Retry a settled provider failure within this invocation and its output allowance. /\n\trecoverProviderFailure?: (message: AssistantMessage, signal?: AbortSignal) => Promise<boolean>;\n\n\t/* Copied native owner callback; excluded from configured/provider stream options. /\n\townedStreamFn?: AgentOwnedStreamFn;\n\n\t/\n\t Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.\n\t \n\t Each AgentMessage must be converted to a UserMessage, AssistantMessage, or ToolResultMessage\n\t * that the LLM can understand. AgentMessages that cannot be converted (e.g., UI-only notifications,\n\t * status messages) should be filtered out.\n\t \n\t Contract: must not throw or reject. Return a safe fallback value instead.\n\t * Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t \n\t @example\n\t * ```typescript\n\t * convertToLlm: (messages) => messages.flatMap(m => {\n\t * if (m.role === \"custom\") {\n\t * // Convert custom message to user message\n\t * return [{ role: \"user\", content: m.content, timestamp: m.timestamp }];\n\t * }\n\t * if (m.role === \"notification\") {\n\t * // Filter out UI-only messages\n\t * return [];\n\t * }\n\t * // Pass through standard LLM messages\n\t * return [m];\n\t * })\n\t * ```\n\t /\n\tconvertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\n\t/\n\t Optional transform applied to the context before `convertToLlm`.\n\t \n\t Use this for operations that work at the AgentMessage level:\n\t * - Context window management (pruning old messages)\n\t * - Injecting context from external sources\n\t \n\t Contract: must not throw or reject. Return the original messages or another\n\t * safe fallback value instead.\n\t \n\t @example\n\t * ```typescript\n\t * transformContext: async (messages) => {\n\t * if (estimateTokens(messages) > MAX_TOKENS) {\n\t * return pruneOldMessages(messages);\n\t * }\n\t * return messages;\n\t * }\n\t * ```\n\t /\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/* Resolves the system prompt immediately before each LLM call. /\n\tgetSystemPrompt?: () => string;\n\n\t/\n\t Resolves an API key dynamically for each LLM call.\n\t \n\t Useful for short-lived OAuth tokens (e.g., GitHub Copilot) that may expire\n\t * during long-running tool execution phases.\n\t \n\t Contract: must not throw or reject. Return undefined when no key is available.\n\t /\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\n\t/\n\t Called after each turn fully completes and `turn_end` has been emitted.\n\t \n\t If it returns true, the loop emits `agent_end` and exits before polling steering or follow-up queues,\n\t * without starting another LLM call. The current assistant response and any tool executions finish normally.\n\t \n\t Use this to request a graceful stop after the current turn, e.g. before context gets too full.\n\t \n\t Contract: must not throw or reject. Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t /\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\n\t/* When present, this typed owner replaces shouldStopAfterTurn; it does not replace natural continuation. /\n\tgetTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\n\t/\n\t Called synchronously after a completed turn and before polling work for another turn.\n\t * Return true to emit `agent_end` without starting another provider call. Work returned by\n\t * an asynchronous poll owns that boundary; queue owners must suppress stale continuation\n\t * results if their higher-level stop condition changes while generating them.\n\t * The hook is never checked before the initial assistant turn.\n\t /\n\tshouldStopBeforeTurn?: () => boolean;\n\n\t/\n\t Returns steering messages to inject into the conversation mid-run.\n\t \n\t Called after the current assistant turn finishes executing its tool calls, unless `shouldStopAfterTurn` exits first.\n\t * If messages are returned, they are added to the context before the next LLM call.\n\t * Tool calls from the current assistant message are not skipped.\n\t \n\t Use this for \"steering\" the agent while it's working.\n\t \n\t Contract: must not throw or reject. Return [] when no steering messages are available.\n\t /\n\tgetSteeringMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns follow-up messages to process after the agent would otherwise stop.\n\t \n\t Called when the agent has no more tool calls and no steering messages.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for follow-up messages that should wait until the agent finishes.\n\t \n\t Contract: must not throw or reject. Return [] when no follow-up messages are available.\n\t /\n\tgetFollowUpMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns continuation messages when the agent would otherwise stop.\n\t \n\t Called after follow-up messages have been polled and none are available.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for host-owned continuation policies such as long-running goals.\n\t * Explicit follow-up messages always take precedence over continuation messages.\n\t \n\t Contract: must not throw or reject. Return [] when no continuation should run.\n\t /\n\tgetContinuationMessages?: (context: GetContinuationMessagesContext, signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/\n\t Authoritative runtime continuation control, after steering and explicit follow-ups.\n\t * When present, only this callback is called; getContinuationMessages is not polled.\n\t * Only continue restarts this invocation. Waiting leaves future work with its existing owner.\n\t /\n\tgetContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\n\n\t/\n\t Tool execution mode. Defaults to `\"parallel\"`.\n\t * Parallel mode preflights calls sequentially, executes allowed calls concurrently, emits\n\t * `tool_execution_end` in completion order, then emits tool-result messages in assistant source order.\n\t /\n\ttoolExecution?: ToolExecutionMode;\n\n\t/\n\t Awaited before invoking the tool. Rejection prevents execution and stops the loop.\n\t * The owner records intent here; admission is not proof that an external effect occurred.\n\t /\n\tonToolInvocationStarting?: (\n\t\tinvocation: ToolInvocation,\n\t\tsignal: AbortSignal \| undefined,\n\t\ttool: AgentTool,\n\t\texecute: AgentTool[\"execute\"],\n\t\tassistantMessage?: AssistantMessage,\n\t) => void \| BoundToolExecution \| Promise<void> \| Promise<BoundToolExecution \| undefined>;\n\n\t/\n\t Native execution owner, awaited after final middleware and before observer/result events.\n\t * Persist source evidence here. Rejection stops publication; this is not an observer hook.\n\t * Cancellation does not skip settlement. The owner must bound its own persistence work.\n\t /\n\tonToolExchangeFinalized?: (\n\t\texchange: FinalizedToolExchange,\n\t\tsignal?: AbortSignal,\n\t\towner?: BoundToolExecution,\n\t) => void \| Promise<void>;\n\n\t/\n\t Called before a tool is executed, after arguments have been validated.\n\t \n\t Return `{ block: true }` to prevent execution. The loop emits an error tool result instead.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\n\t/\n\t Called after a tool finishes executing, before `tool_execution_end` and tool-result message events are emitted.\n\t \n\t Return an `AfterToolCallResult` to override parts of the executed tool result:\n\t * - `content` replaces the full content array\n\t * - `details` replaces the full details payload\n\t * - `isError` replaces the error flag\n\t * - `terminate` replaces the early-termination hint\n\t \n\t Any omitted fields keep their original values. No deep merge is performed.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n}\n\n/\n Thinking/reasoning level for models that support it.\n * Note: \"xhigh\" and \"max\" are only supported by selected model families. Use model\n * thinking-level metadata from @ponythewhite/base-context-ai to detect support for a concrete model.\n /\nexport type ThinkingLevel = \"off\" \| \"minimal\" \| \"low\" \| \"medium\" \| \"high\" \| \"xhigh\" \| \"max\";\n\n/\n Extensible interface for custom app messages.\n * Apps can extend via declaration merging:\n \n @example\n * ```typescript\n * declare module \"@mariozechner/agent\" {\n * interface CustomAgentMessages {\n * artifact: ArtifactMessage;\n * notification: NotificationMessage;\n * }\n * }\n * ```\n /\nexport interface CustomAgentMessages {}\n\nexport type AgentMessage = Message \| CustomAgentMessages[keyof CustomAgentMessages];\n\n/\n Public agent state.\n \n `tools` and `messages` use accessor properties so implementations can copy\n * assigned arrays before storing them.\n /\nexport interface AgentState {\n\t/* System prompt sent with each model request. /\n\tsystemPrompt: string;\n\t/* Model used for future turns. /\n\tmodel: Model<any>;\n\t/* Requested reasoning level for future turns. /\n\tthinkingLevel: ThinkingLevel;\n\t/* Requested provider service tier for future turns. /\n\tserviceTier: ServiceTier;\n\t/* Available tools. Assigning a new array copies its top-level array. /\n\tset tools(tools: AgentTool<any>[]);\n\tget tools(): AgentTool<any>[];\n\t/* Conversation transcript. Assigning a new array copies its top-level array. /\n\tset messages(messages: AgentMessage[]);\n\tget messages(): AgentMessage[];\n\t/* True while processing a prompt or continuation, including awaited `agent_end` listeners. /\n\treadonly isStreaming: boolean;\n\t/* Partial assistant message for the active streamed response, if any. /\n\treadonly streamingMessage?: AgentMessage;\n\t/* Tool-call IDs currently executing. /\n\treadonly pendingToolCalls: ReadonlySet<string>;\n\t/* Error from the most recent failed or aborted assistant turn, if any. /\n\treadonly errorMessage?: string;\n}\n\n/* Final or partial result produced by a tool. /\nexport interface AgentToolResult<T> {\n\t/* Text or image content returned to the model. /\n\tcontent: (TextContent \| ImageContent)[];\n\t/* Structured details for logs or UI rendering. /\n\tdetails: T;\n\t/\n\t Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t /\n\tterminate?: boolean;\n}\n\n/* Callback used by tools to publish partial execution updates. /\nexport type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;\n\n/* Tool definition used by the agent runtime. /\nexport interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {\n\t/* Human-readable label for UI display. /\n\tlabel: string;\n\t/\n\t Optional compatibility shim for raw tool-call arguments before schema validation.\n\t * Must return an object that matches `TParameters`.\n\t /\n\tprepareArguments?: (args: unknown) => Static<TParameters>;\n\t/* Execute the tool call. Throw on failure instead of encoding errors in `content`. /\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<TParameters>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => Promise<AgentToolResult<TDetails>>;\n\t/\n\t Per-tool execution mode override.\n\t * - \"sequential\": this tool must execute one at a time with other tool calls.\n\t * - \"parallel\": this tool can execute concurrently with other tool calls.\n\t \n\t If omitted, the default execution mode applies.\n\t /\n\texecutionMode?: ToolExecutionMode;\n}\n\n/* Context snapshot passed to the low-level agent loop and tool hooks. /\nexport interface AgentContext {\n\t/* System prompt included with the request. /\n\tsystemPrompt: string;\n\t/* Transcript visible to the model. /\n\tmessages: AgentMessage[];\n\t/* Tools available for this run. /\n\ttools?: AgentTool<any>[];\n}\n\n/\n Events emitted by the Agent for UI updates.\n \n `agent_end` is the last event emitted for a run, but awaited `Agent.subscribe()`\n * listeners for that event are still part of run settlement. The agent becomes\n * idle only after those listeners finish.\n /\nexport type AgentEvent =\n\t/* Starts and ends one agent run; `agent_end` carries all messages produced by that run. /\n\t\| { type: \"agent_start\" }\n\t\| { type: \"agent_end\"; messages: AgentMessage[]; refusal?: never }\n\t\| { type: \"agent_end\"; refusal: AgentOutputRefusal; messages?: never }\n\t/* One assistant response and its resulting tool calls. /\n\t\| { type: \"turn_start\" }\n\t\| {\n\t\t\ttype: \"turn_end\";\n\t\t\tmessage: AgentMessage;\n\t\t\ttoolResults: ToolResultMessage[];\n\t\t\t/* Always populated by native execution; historical observer events may omit it. /\n\t\t\ttoolExecution?: ToolExecutionMode;\n\t\t\t/* Settled calls in source order. Absent historical evidence is not reconstructed. /\n\t\t\texchanges?: readonly FinalizedToolExchange[];\n\t }\n\t/* Lifecycle events for user, assistant, and tool-result messages. /\n\t\| { type: \"message_start\"; message: AgentMessage }\n\t/* Only emitted for assistant messages during streaming. /\n\t\| { type: \"message_update\"; message: AgentMessage; assistantMessageEvent: AssistantMessageEvent }\n\t\| { type: \"message_end\"; message: AgentMessage }\n\t/* Tool execution events; parallel calls may end in completion rather than source order. /\n\t\| { type: \"tool_execution_start\"; toolCallId: string; toolName: string; args: any }\n\t\| { type: \"tool_execution_update\"; toolCallId: string; toolName: string; args: any; partialResult: any }\n\t\| {\n\t\t\ttype: \"tool_execution_end\";\n\t\t\ttoolCallId: string;\n\t\t\ttoolName: string;\n\t\t\tresult: any;\n\t\t\tisError: boolean;\n\t\t\t/* Always populated by native execution; absent for older observer events. */\n\t\t\texchange?: FinalizedToolExchange;\n\t };\n"]}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tImageContent,\n\tMessage,\n\tModel,\n\tServiceTier,\n\tSimpleStreamOptions,\n\tstreamSimple,\n\tTextContent,\n\tTool,\n\tToolResultMessage,\n} from \"@ponythewhite/base-context-ai\";\nimport type { Static, TSchema } from \"typebox\";\n\n/*\n Stream function used by the agent loop.\n \n Contract:\n * - Must not throw or return a rejected promise for request/model/runtime failures.\n * - Must return an AssistantMessageEventStream.\n * - Failures must be encoded in the returned stream via protocol events and a\n * final AssistantMessage with stopReason \"error\" or \"aborted\" and errorMessage.\n /\nexport type StreamFn = (\n\t...args: Parameters<typeof streamSimple>\n) => ReturnType<typeof streamSimple> \| Promise<ReturnType<typeof streamSimple>>;\n\nexport interface AgentContextProjection {\n\tmessages: AgentMessage[];\n\t/\n\t Adopt this complete working set in the owning Agent and loop, not only for inference.\n\t * It must include the current turn and pending tool closure. This is not a last-N tail.\n\t * Omitted/false preserves the existing inference-only projection behavior.\n\t /\n\tadoptMessages?: boolean;\n\tstreamContext?: unknown;\n\trelease?: () => Promise<void>;\n}\n\n// biome-ignore lint/suspicious/noConfusingVoidType: this return contract accepts existing Promise<void> context barriers.\nexport type AgentContextBuildResult = void \| AgentContextProjection;\n\nexport type AgentOwnedStreamFn = (...args: [...Parameters<StreamFn>, streamContext?: unknown]) => ReturnType<StreamFn>;\n\n/\n Configuration for how tool calls from a single assistant message are executed.\n \n - \"sequential\": each tool call is prepared, executed, and finalized before the next one starts.\n * - \"parallel\": tool calls are prepared sequentially, then allowed tools execute concurrently.\n * `tool_execution_end` is emitted in tool completion order after each tool is finalized,\n * while tool-result message artifacts are emitted later in assistant source order.\n /\nexport type ToolExecutionMode = \"sequential\" \| \"parallel\";\n\n/* A tool-call content block emitted by an assistant message. /\nexport type AgentToolCall = Extract<AssistantMessage[\"content\"][number], { type: \"toolCall\" }>;\n\n/\n Result returned from `beforeToolCall`.\n \n Returning `{ block: true }` prevents the tool from executing. The loop emits an error tool result instead.\n * `reason` becomes the text shown in that error result. If omitted, a default blocked message is used.\n /\nexport interface BeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\n/\n Partial override returned from `afterToolCall`.\n \n Merge semantics are field-by-field:\n * - `content`: if provided, replaces the tool result content array in full\n * - `details`: if provided, replaces the tool result details value in full\n * - `isError`: if provided, replaces the tool result error flag\n * - `terminate`: if provided, replaces the early-termination hint\n \n Omitted fields keep the original executed tool result values.\n * There is no deep merge for `content` or `details`.\n /\nexport interface AfterToolCallResult {\n\tcontent?: (TextContent \| ImageContent)[];\n\tdetails?: unknown;\n\tisError?: boolean;\n\t/\n\t Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t /\n\tterminate?: boolean;\n}\n\n/* Context passed to `beforeToolCall` after arguments are validated. /\nexport interface BeforeToolCallContext {\n\t/* Assistant message that requested the call. /\n\tassistantMessage: AssistantMessage;\n\t/* Raw tool-call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated arguments for the target tool schema. /\n\targs: unknown;\n\t/* Agent context when this call is prepared. /\n\tcontext: AgentContext;\n}\n\n/* Context passed to `afterToolCall`. /\nexport interface AfterToolCallContext {\n\t/* Assistant message that requested the call. /\n\tassistantMessage: AssistantMessage;\n\t/* Raw tool-call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated arguments for the target tool schema. /\n\targs: unknown;\n\t/* Executed result before any `afterToolCall` overrides. /\n\tresult: AgentToolResult<any>;\n\t/* Whether the executed result is currently treated as an error. /\n\tisError: boolean;\n\t/* Agent context when this call is finalized. /\n\tcontext: AgentContext;\n}\n\n/* What is known about the actual invocation, independently of middleware result overrides. /\nexport type ToolExecutionOutcome = \"not_started\" \| \"completed\" \| \"failed\" \| \"outcome_unknown\";\n\n/* Immutable invocation admitted by the execution owner before the tool can run. /\nexport interface ToolInvocation {\n\treadonly executionId: string;\n\treadonly sourceOrder: number;\n\treadonly toolCallId: string;\n\treadonly toolName: string;\n\t/* Snapshot before argument preparation, validation, or tool middleware. /\n\treadonly originalInput: unknown;\n\t/* Arguments reserved for this invocation, not a live middleware object. /\n\treadonly executedInput: unknown;\n\treadonly toolExecution: ToolExecutionMode;\n}\n\n/* @internal Per-invocation owner closure; never serialized or supplied by result metadata. /\nexport interface BoundToolExecution {\n\trun(execute: () => Promise<AgentToolResult<unknown>>): Promise<AgentToolResult<unknown>>;\n\tfinalize(exchange: FinalizedToolExchange, signal?: AbortSignal): void \| Promise<void>;\n}\n\n/* Finalized source evidence; parallel exchanges retain assistant call order via sourceOrder. /\nexport interface FinalizedToolExchange extends Omit<ToolInvocation, \"executedInput\"> {\n\t/* Snapshot at invocation; absent when execution never started. /\n\treadonly executedInput?: unknown;\n\t/* An aborted wait does not establish whether an external effect stopped. /\n\treadonly executionOutcome: ToolExecutionOutcome;\n\treadonly cancellationRequested: boolean;\n\t/* Final middleware result, also used for the tool-result message. /\n\treadonly result: ToolResultMessage;\n}\n\n/* Limits on the complete invocation result, not the working context or observer queues. /\nexport interface AgentOutputLimits {\n\tmaxMessages: number;\n\tmaxSourceBytes: number;\n}\n\nexport interface AgentOutputRefusal extends AgentOutputLimits {\n\tkind: \"output_limit\";\n\tlimit: \"messages\" \| \"source_bytes\" \| \"value_encoding\";\n}\n\nexport interface AgentOutputPolicy {\n\tlimits: AgentOutputLimits;\n\t/* Optional native update feed. Its synchronous refresh never revokes an ACK or throws a quota error. /\n\tbindUpdates?(refresh: (message: AgentMessage) => boolean): () => void;\n\t/* Close update admission and join the updates already accepted at this terminal boundary. /\n\tsettleUpdates?(): Promise<void>;\n\t/* Copy one finalized value within the supplied JSON-byte budget; undefined means it does not fit. /\n\tsnapshot(message: AgentMessage, maxSourceBytes: number): { message: AgentMessage; sourceBytes: number } \| undefined;\n}\n\n/* Context passed to `shouldStopAfterTurn` and both continuation callbacks. /\nexport interface ShouldStopAfterTurnContext {\n\t/* Assistant message that completed the turn. /\n\tmessage: AssistantMessage;\n\t/* Tool-result messages included in the preceding `turn_end` event. /\n\ttoolResults: ToolResultMessage[];\n\t/* Context after appending the turn's assistant message and tool results. /\n\tcontext: AgentContext;\n\t/* Messages returned by this invocation; prompts include initial prompts, continuations exclude prior context. /\n\tnewMessages: AgentMessage[];\n}\n\n/* The finalized loop decision, not a guess from the rendered message tail. /\nexport interface GetTurnOutcomeContext extends ShouldStopAfterTurnContext {\n\thasMoreToolCalls: boolean;\n}\n\n/* Control before queue polling; proceed keeps the ordinary loop policy. /\nexport type AgentTurnOutcome = { kind: \"proceed\" \| \"finish\" \| \"checkpoint_then_continue\" \| \"cancelled\" };\n\nexport type GetContinuationMessagesContext = ShouldStopAfterTurnContext;\n\n/* Runtime control at a natural turn boundary; message payload does not decide whether to restart. /\nexport type AgentContinuationOutcome =\n\t\| { kind: \"continue\"; messages: AgentMessage[] }\n\t\| { kind: \"finish\" \| \"wait_for_owned_work\" \| \"cancelled\" };\n\nexport interface AgentLoopConfig extends SimpleStreamOptions {\n\t/* Opt-in bounded finalized results. Native sinks must join their message_end job. /\n\toutputPolicy?: AgentOutputPolicy;\n\tmodel: Model<any>;\n\n\t/* Native owner barrier before transform/convert. Rejection stops context construction. /\n\tbeforeContextBuild?: () => Promise<AgentContextBuildResult>;\n\n\t/* Internal state mirror for adopted working sets. Awaited and excluded from provider options. /\n\tonContextAdopted?: (messages: AgentMessage[]) => void \| Promise<void>;\n\n\t/* Native owner recovery after an unsent request's projection has been released. /\n\trecoverRequestPreparation?: (error: unknown, signal?: AbortSignal) => Promise<boolean>;\n\n\t/* Retry a settled provider failure within this invocation and its output allowance. /\n\trecoverProviderFailure?: (message: AssistantMessage, signal?: AbortSignal) => Promise<boolean>;\n\n\t/* Copied native owner callback; excluded from configured/provider stream options. /\n\townedStreamFn?: AgentOwnedStreamFn;\n\n\t/\n\t Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.\n\t \n\t Each AgentMessage must be converted to a UserMessage, AssistantMessage, or ToolResultMessage\n\t * that the LLM can understand. AgentMessages that cannot be converted (e.g., UI-only notifications,\n\t * status messages) should be filtered out.\n\t \n\t Contract: must not throw or reject. Return a safe fallback value instead.\n\t * Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t \n\t @example\n\t * ```typescript\n\t * convertToLlm: (messages) => messages.flatMap(m => {\n\t * if (m.role === \"custom\") {\n\t * // Convert custom message to user message\n\t * return [{ role: \"user\", content: m.content, timestamp: m.timestamp }];\n\t * }\n\t * if (m.role === \"notification\") {\n\t * // Filter out UI-only messages\n\t * return [];\n\t * }\n\t * // Pass through standard LLM messages\n\t * return [m];\n\t * })\n\t * ```\n\t /\n\tconvertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\n\t/\n\t Optional transform applied to the context before `convertToLlm`.\n\t \n\t Use this for operations that work at the AgentMessage level:\n\t * - Context window management (pruning old messages)\n\t * - Injecting context from external sources\n\t \n\t Contract: must not throw or reject. Return the original messages or another\n\t * safe fallback value instead.\n\t \n\t @example\n\t * ```typescript\n\t * transformContext: async (messages) => {\n\t * if (estimateTokens(messages) > MAX_TOKENS) {\n\t * return pruneOldMessages(messages);\n\t * }\n\t * return messages;\n\t * }\n\t * ```\n\t /\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/* Resolves the system prompt immediately before each LLM call. /\n\tgetSystemPrompt?: () => string;\n\n\t/\n\t Resolves an API key dynamically for each LLM call.\n\t \n\t Useful for short-lived OAuth tokens (e.g., GitHub Copilot) that may expire\n\t * during long-running tool execution phases.\n\t \n\t Contract: must not throw or reject. Return undefined when no key is available.\n\t /\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\n\t/\n\t Called after each turn fully completes and `turn_end` has been emitted.\n\t \n\t If it returns true, the loop emits `agent_end` and exits before polling steering or follow-up queues,\n\t * without starting another LLM call. The current assistant response and any tool executions finish normally.\n\t \n\t Use this to request a graceful stop after the current turn, e.g. before context gets too full.\n\t \n\t Contract: must not throw or reject. Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t /\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\n\t/* When present, this typed owner replaces shouldStopAfterTurn; it does not replace natural continuation. /\n\tgetTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\n\t/\n\t Called synchronously after a completed turn and before polling work for another turn.\n\t * Return true to emit `agent_end` without starting another provider call. Work returned by\n\t * an asynchronous poll owns that boundary; queue owners must suppress stale continuation\n\t * results if their higher-level stop condition changes while generating them.\n\t * The hook is never checked before the initial assistant turn.\n\t /\n\tshouldStopBeforeTurn?: () => boolean;\n\n\t/\n\t Returns steering messages to inject into the conversation mid-run.\n\t \n\t Called after the current assistant turn finishes executing its tool calls, unless `shouldStopAfterTurn` exits first.\n\t * If messages are returned, they are added to the context before the next LLM call.\n\t * Tool calls from the current assistant message are not skipped.\n\t \n\t Use this for \"steering\" the agent while it's working.\n\t \n\t Contract: must not throw or reject. Return [] when no steering messages are available.\n\t /\n\tgetSteeringMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns follow-up messages to process after the agent would otherwise stop.\n\t \n\t Called when the agent has no more tool calls and no steering messages.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for follow-up messages that should wait until the agent finishes.\n\t \n\t Contract: must not throw or reject. Return [] when no follow-up messages are available.\n\t /\n\tgetFollowUpMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns continuation messages when the agent would otherwise stop.\n\t \n\t Called after follow-up messages have been polled and none are available.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for host-owned continuation policies such as long-running goals.\n\t * Explicit follow-up messages always take precedence over continuation messages.\n\t \n\t Contract: must not throw or reject. Return [] when no continuation should run.\n\t /\n\tgetContinuationMessages?: (context: GetContinuationMessagesContext, signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/\n\t Authoritative runtime continuation control, after steering and explicit follow-ups.\n\t * When present, only this callback is called; getContinuationMessages is not polled.\n\t * Only continue restarts this invocation. Waiting leaves future work with its existing owner.\n\t /\n\tgetContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\n\n\t/\n\t Tool execution mode. Defaults to `\"parallel\"`.\n\t * Parallel mode preflights calls sequentially, executes allowed calls concurrently, emits\n\t * `tool_execution_end` in completion order, then emits tool-result messages in assistant source order.\n\t /\n\ttoolExecution?: ToolExecutionMode;\n\n\t/\n\t Awaited before invoking the tool. Rejection prevents execution and stops the loop.\n\t * The owner records intent here; admission is not proof that an external effect occurred.\n\t /\n\tonToolInvocationStarting?: (\n\t\tinvocation: ToolInvocation,\n\t\tsignal: AbortSignal \| undefined,\n\t\ttool: AgentTool,\n\t\texecute: AgentTool[\"execute\"],\n\t\tassistantMessage?: AssistantMessage,\n\t) => void \| BoundToolExecution \| Promise<void> \| Promise<BoundToolExecution \| undefined>;\n\n\t/\n\t Native execution owner, awaited after final middleware and before observer/result events.\n\t * Persist source evidence here. Rejection stops publication; this is not an observer hook.\n\t * Cancellation does not skip settlement. The owner must bound its own persistence work.\n\t /\n\tonToolExchangeFinalized?: (\n\t\texchange: FinalizedToolExchange,\n\t\tsignal?: AbortSignal,\n\t\towner?: BoundToolExecution,\n\t) => void \| Promise<void>;\n\n\t/\n\t Called before a tool is executed, after arguments have been validated.\n\t \n\t Return `{ block: true }` to prevent execution. The loop emits an error tool result instead.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\n\t/\n\t Called after a tool finishes executing, before `tool_execution_end` and tool-result message events are emitted.\n\t \n\t Return an `AfterToolCallResult` to override parts of the executed tool result:\n\t * - `content` replaces the full content array\n\t * - `details` replaces the full details payload\n\t * - `isError` replaces the error flag\n\t * - `terminate` replaces the early-termination hint\n\t \n\t Any omitted fields keep their original values. No deep merge is performed.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n}\n\n/\n Thinking/reasoning level for models that support it.\n * Note: \"xhigh\" and \"max\" are only supported by selected model families. Use model\n * thinking-level metadata from @ponythewhite/base-context-ai to detect support for a concrete model.\n /\nexport type ThinkingLevel = \"off\" \| \"minimal\" \| \"low\" \| \"medium\" \| \"high\" \| \"xhigh\" \| \"max\";\n\n/\n Extensible interface for custom app messages.\n * Apps can extend via declaration merging:\n \n @example\n * ```typescript\n * declare module \"@mariozechner/agent\" {\n * interface CustomAgentMessages {\n * artifact: ArtifactMessage;\n * notification: NotificationMessage;\n * }\n * }\n * ```\n /\nexport interface CustomAgentMessages {}\n\nexport type AgentMessage = Message \| CustomAgentMessages[keyof CustomAgentMessages];\n\n/\n Public agent state.\n \n `tools` and `messages` use accessor properties so implementations can copy\n * assigned arrays before storing them.\n /\nexport interface AgentState {\n\t/* System prompt sent with each model request. /\n\tsystemPrompt: string;\n\t/* Model used for future turns. /\n\tmodel: Model<any> \| undefined;\n\t/* Requested reasoning level for future turns. /\n\tthinkingLevel: ThinkingLevel;\n\t/* Requested provider service tier for future turns. /\n\tserviceTier: ServiceTier;\n\t/* Available tools. Assigning a new array copies its top-level array. /\n\tset tools(tools: AgentTool<any>[]);\n\tget tools(): AgentTool<any>[];\n\t/* Conversation transcript. Assigning a new array copies its top-level array. /\n\tset messages(messages: AgentMessage[]);\n\tget messages(): AgentMessage[];\n\t/* True while processing a prompt or continuation, including awaited `agent_end` listeners. /\n\treadonly isStreaming: boolean;\n\t/* Partial assistant message for the active streamed response, if any. /\n\treadonly streamingMessage?: AgentMessage;\n\t/* Tool-call IDs currently executing. /\n\treadonly pendingToolCalls: ReadonlySet<string>;\n\t/* Error from the most recent failed or aborted assistant turn, if any. /\n\treadonly errorMessage?: string;\n}\n\n/* Final or partial result produced by a tool. /\nexport interface AgentToolResult<T> {\n\t/* Text or image content returned to the model. /\n\tcontent: (TextContent \| ImageContent)[];\n\t/* Structured details for logs or UI rendering. /\n\tdetails: T;\n\t/\n\t Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t /\n\tterminate?: boolean;\n}\n\n/* Callback used by tools to publish partial execution updates. /\nexport type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;\n\n/* Tool definition used by the agent runtime. /\nexport interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {\n\t/* Human-readable label for UI display. /\n\tlabel: string;\n\t/\n\t Optional compatibility shim for raw tool-call arguments before schema validation.\n\t * Must return an object that matches `TParameters`.\n\t /\n\tprepareArguments?: (args: unknown) => Static<TParameters>;\n\t/* Execute the tool call. Throw on failure instead of encoding errors in `content`. /\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<TParameters>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => Promise<AgentToolResult<TDetails>>;\n\t/\n\t Per-tool execution mode override.\n\t * - \"sequential\": this tool must execute one at a time with other tool calls.\n\t * - \"parallel\": this tool can execute concurrently with other tool calls.\n\t \n\t If omitted, the default execution mode applies.\n\t /\n\texecutionMode?: ToolExecutionMode;\n}\n\n/* Context snapshot passed to the low-level agent loop and tool hooks. /\nexport interface AgentContext {\n\t/* System prompt included with the request. /\n\tsystemPrompt: string;\n\t/* Transcript visible to the model. /\n\tmessages: AgentMessage[];\n\t/* Tools available for this run. /\n\ttools?: AgentTool<any>[];\n}\n\n/\n Events emitted by the Agent for UI updates.\n \n `agent_end` is the last event emitted for a run, but awaited `Agent.subscribe()`\n * listeners for that event are still part of run settlement. The agent becomes\n * idle only after those listeners finish.\n /\nexport type AgentEvent =\n\t/* Starts and ends one agent run; `agent_end` carries all messages produced by that run. /\n\t\| { type: \"agent_start\" }\n\t\| { type: \"agent_end\"; messages: AgentMessage[]; refusal?: never }\n\t\| { type: \"agent_end\"; refusal: AgentOutputRefusal; messages?: never }\n\t/* One assistant response and its resulting tool calls. /\n\t\| { type: \"turn_start\" }\n\t\| {\n\t\t\ttype: \"turn_end\";\n\t\t\tmessage: AgentMessage;\n\t\t\ttoolResults: ToolResultMessage[];\n\t\t\t/* Always populated by native execution; historical observer events may omit it. /\n\t\t\ttoolExecution?: ToolExecutionMode;\n\t\t\t/* Settled calls in source order. Absent historical evidence is not reconstructed. /\n\t\t\texchanges?: readonly FinalizedToolExchange[];\n\t }\n\t/* Lifecycle events for user, assistant, and tool-result messages. /\n\t\| { type: \"message_start\"; message: AgentMessage }\n\t/* Only emitted for assistant messages during streaming. /\n\t\| { type: \"message_update\"; message: AgentMessage; assistantMessageEvent: AssistantMessageEvent }\n\t\| { type: \"message_end\"; message: AgentMessage }\n\t/* Tool execution events; parallel calls may end in completion rather than source order. /\n\t\| { type: \"tool_execution_start\"; toolCallId: string; toolName: string; args: any }\n\t\| { type: \"tool_execution_update\"; toolCallId: string; toolName: string; args: any; partialResult: any }\n\t\| {\n\t\t\ttype: \"tool_execution_end\";\n\t\t\ttoolCallId: string;\n\t\t\ttoolName: string;\n\t\t\tresult: any;\n\t\t\tisError: boolean;\n\t\t\t/* Always populated by native execution; absent for older observer events. */\n\t\t\texchange?: FinalizedToolExchange;\n\t };\n"]}

package/dist/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tImageContent,\n\tMessage,\n\tModel,\n\tServiceTier,\n\tSimpleStreamOptions,\n\tstreamSimple,\n\tTextContent,\n\tTool,\n\tToolResultMessage,\n} from \"@ponythewhite/base-context-ai\";\nimport type { Static, TSchema } from \"typebox\";\n\n/*\n Stream function used by the agent loop.\n \n Contract:\n * - Must not throw or return a rejected promise for request/model/runtime failures.\n * - Must return an AssistantMessageEventStream.\n * - Failures must be encoded in the returned stream via protocol events and a\n * final AssistantMessage with stopReason \"error\" or \"aborted\" and errorMessage.\n /\nexport type StreamFn = (\n\t...args: Parameters<typeof streamSimple>\n) => ReturnType<typeof streamSimple> \| Promise<ReturnType<typeof streamSimple>>;\n\nexport interface AgentContextProjection {\n\tmessages: AgentMessage[];\n\t/\n\t Adopt this complete working set in the owning Agent and loop, not only for inference.\n\t * It must include the current turn and pending tool closure. This is not a last-N tail.\n\t * Omitted/false preserves the existing inference-only projection behavior.\n\t /\n\tadoptMessages?: boolean;\n\tstreamContext?: unknown;\n\trelease?: () => Promise<void>;\n}\n\n// biome-ignore lint/suspicious/noConfusingVoidType: this return contract accepts existing Promise<void> context barriers.\nexport type AgentContextBuildResult = void \| AgentContextProjection;\n\nexport type AgentOwnedStreamFn = (...args: [...Parameters<StreamFn>, streamContext?: unknown]) => ReturnType<StreamFn>;\n\n/\n Configuration for how tool calls from a single assistant message are executed.\n \n - \"sequential\": each tool call is prepared, executed, and finalized before the next one starts.\n * - \"parallel\": tool calls are prepared sequentially, then allowed tools execute concurrently.\n * `tool_execution_end` is emitted in tool completion order after each tool is finalized,\n * while tool-result message artifacts are emitted later in assistant source order.\n /\nexport type ToolExecutionMode = \"sequential\" \| \"parallel\";\n\n/* A tool-call content block emitted by an assistant message. /\nexport type AgentToolCall = Extract<AssistantMessage[\"content\"][number], { type: \"toolCall\" }>;\n\n/\n Result returned from `beforeToolCall`.\n \n Returning `{ block: true }` prevents the tool from executing. The loop emits an error tool result instead.\n * `reason` becomes the text shown in that error result. If omitted, a default blocked message is used.\n /\nexport interface BeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\n/\n Partial override returned from `afterToolCall`.\n \n Merge semantics are field-by-field:\n * - `content`: if provided, replaces the tool result content array in full\n * - `details`: if provided, replaces the tool result details value in full\n * - `isError`: if provided, replaces the tool result error flag\n * - `terminate`: if provided, replaces the early-termination hint\n \n Omitted fields keep the original executed tool result values.\n * There is no deep merge for `content` or `details`.\n /\nexport interface AfterToolCallResult {\n\tcontent?: (TextContent \| ImageContent)[];\n\tdetails?: unknown;\n\tisError?: boolean;\n\t/\n\t Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t /\n\tterminate?: boolean;\n}\n\n/* Context passed to `beforeToolCall` after arguments are validated. /\nexport interface BeforeToolCallContext {\n\t/* Assistant message that requested the call. /\n\tassistantMessage: AssistantMessage;\n\t/* Raw tool-call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated arguments for the target tool schema. /\n\targs: unknown;\n\t/* Agent context when this call is prepared. /\n\tcontext: AgentContext;\n}\n\n/* Context passed to `afterToolCall`. /\nexport interface AfterToolCallContext {\n\t/* Assistant message that requested the call. /\n\tassistantMessage: AssistantMessage;\n\t/* Raw tool-call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated arguments for the target tool schema. /\n\targs: unknown;\n\t/* Executed result before any `afterToolCall` overrides. /\n\tresult: AgentToolResult<any>;\n\t/* Whether the executed result is currently treated as an error. /\n\tisError: boolean;\n\t/* Agent context when this call is finalized. /\n\tcontext: AgentContext;\n}\n\n/* What is known about the actual invocation, independently of middleware result overrides. /\nexport type ToolExecutionOutcome = \"not_started\" \| \"completed\" \| \"failed\" \| \"outcome_unknown\";\n\n/* Immutable invocation admitted by the execution owner before the tool can run. /\nexport interface ToolInvocation {\n\treadonly executionId: string;\n\treadonly sourceOrder: number;\n\treadonly toolCallId: string;\n\treadonly toolName: string;\n\t/* Snapshot before argument preparation, validation, or tool middleware. /\n\treadonly originalInput: unknown;\n\t/* Arguments reserved for this invocation, not a live middleware object. /\n\treadonly executedInput: unknown;\n\treadonly toolExecution: ToolExecutionMode;\n}\n\n/* @internal Per-invocation owner closure; never serialized or supplied by result metadata. /\nexport interface BoundToolExecution {\n\trun(execute: () => Promise<AgentToolResult<unknown>>): Promise<AgentToolResult<unknown>>;\n\tfinalize(exchange: FinalizedToolExchange, signal?: AbortSignal): void \| Promise<void>;\n}\n\n/* Finalized source evidence; parallel exchanges retain assistant call order via sourceOrder. /\nexport interface FinalizedToolExchange extends Omit<ToolInvocation, \"executedInput\"> {\n\t/* Snapshot at invocation; absent when execution never started. /\n\treadonly executedInput?: unknown;\n\t/* An aborted wait does not establish whether an external effect stopped. /\n\treadonly executionOutcome: ToolExecutionOutcome;\n\treadonly cancellationRequested: boolean;\n\t/* Final middleware result, also used for the tool-result message. /\n\treadonly result: ToolResultMessage;\n}\n\n/* Limits on the complete invocation result, not the working context or observer queues. /\nexport interface AgentOutputLimits {\n\tmaxMessages: number;\n\tmaxSourceBytes: number;\n}\n\nexport interface AgentOutputRefusal extends AgentOutputLimits {\n\tkind: \"output_limit\";\n\tlimit: \"messages\" \| \"source_bytes\" \| \"value_encoding\";\n}\n\nexport interface AgentOutputPolicy {\n\tlimits: AgentOutputLimits;\n\t/* Optional native update feed. Its synchronous refresh never revokes an ACK or throws a quota error. /\n\tbindUpdates?(refresh: (message: AgentMessage) => boolean): () => void;\n\t/* Close update admission and join the updates already accepted at this terminal boundary. /\n\tsettleUpdates?(): Promise<void>;\n\t/* Copy one finalized value within the supplied JSON-byte budget; undefined means it does not fit. /\n\tsnapshot(message: AgentMessage, maxSourceBytes: number): { message: AgentMessage; sourceBytes: number } \| undefined;\n}\n\n/* Context passed to `shouldStopAfterTurn` and both continuation callbacks. /\nexport interface ShouldStopAfterTurnContext {\n\t/* Assistant message that completed the turn. /\n\tmessage: AssistantMessage;\n\t/* Tool-result messages included in the preceding `turn_end` event. /\n\ttoolResults: ToolResultMessage[];\n\t/* Context after appending the turn's assistant message and tool results. /\n\tcontext: AgentContext;\n\t/* Messages returned by this invocation; prompts include initial prompts, continuations exclude prior context. /\n\tnewMessages: AgentMessage[];\n}\n\n/* The finalized loop decision, not a guess from the rendered message tail. /\nexport interface GetTurnOutcomeContext extends ShouldStopAfterTurnContext {\n\thasMoreToolCalls: boolean;\n}\n\n/* Control before queue polling; proceed keeps the ordinary loop policy. /\nexport type AgentTurnOutcome = { kind: \"proceed\" \| \"finish\" \| \"checkpoint_then_continue\" \| \"cancelled\" };\n\nexport type GetContinuationMessagesContext = ShouldStopAfterTurnContext;\n\n/* Runtime control at a natural turn boundary; message payload does not decide whether to restart. /\nexport type AgentContinuationOutcome =\n\t\| { kind: \"continue\"; messages: AgentMessage[] }\n\t\| { kind: \"finish\" \| \"wait_for_owned_work\" \| \"cancelled\" };\n\nexport interface AgentLoopConfig extends SimpleStreamOptions {\n\t/* Opt-in bounded finalized results. Native sinks must join their message_end job. /\n\toutputPolicy?: AgentOutputPolicy;\n\tmodel: Model<any>;\n\n\t/* Native owner barrier before transform/convert. Rejection stops context construction. /\n\tbeforeContextBuild?: () => Promise<AgentContextBuildResult>;\n\n\t/* Internal state mirror for adopted working sets. Awaited and excluded from provider options. /\n\tonContextAdopted?: (messages: AgentMessage[]) => void \| Promise<void>;\n\n\t/* Native owner recovery after an unsent request's projection has been released. /\n\trecoverRequestPreparation?: (error: unknown, signal?: AbortSignal) => Promise<boolean>;\n\n\t/* Retry a settled provider failure within this invocation and its output allowance. /\n\trecoverProviderFailure?: (message: AssistantMessage, signal?: AbortSignal) => Promise<boolean>;\n\n\t/* Copied native owner callback; excluded from configured/provider stream options. /\n\townedStreamFn?: AgentOwnedStreamFn;\n\n\t/\n\t Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.\n\t \n\t Each AgentMessage must be converted to a UserMessage, AssistantMessage, or ToolResultMessage\n\t * that the LLM can understand. AgentMessages that cannot be converted (e.g., UI-only notifications,\n\t * status messages) should be filtered out.\n\t \n\t Contract: must not throw or reject. Return a safe fallback value instead.\n\t * Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t \n\t @example\n\t * ```typescript\n\t * convertToLlm: (messages) => messages.flatMap(m => {\n\t * if (m.role === \"custom\") {\n\t * // Convert custom message to user message\n\t * return [{ role: \"user\", content: m.content, timestamp: m.timestamp }];\n\t * }\n\t * if (m.role === \"notification\") {\n\t * // Filter out UI-only messages\n\t * return [];\n\t * }\n\t * // Pass through standard LLM messages\n\t * return [m];\n\t * })\n\t * ```\n\t /\n\tconvertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\n\t/\n\t Optional transform applied to the context before `convertToLlm`.\n\t \n\t Use this for operations that work at the AgentMessage level:\n\t * - Context window management (pruning old messages)\n\t * - Injecting context from external sources\n\t \n\t Contract: must not throw or reject. Return the original messages or another\n\t * safe fallback value instead.\n\t \n\t @example\n\t * ```typescript\n\t * transformContext: async (messages) => {\n\t * if (estimateTokens(messages) > MAX_TOKENS) {\n\t * return pruneOldMessages(messages);\n\t * }\n\t * return messages;\n\t * }\n\t * ```\n\t /\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/* Resolves the system prompt immediately before each LLM call. /\n\tgetSystemPrompt?: () => string;\n\n\t/\n\t Resolves an API key dynamically for each LLM call.\n\t \n\t Useful for short-lived OAuth tokens (e.g., GitHub Copilot) that may expire\n\t * during long-running tool execution phases.\n\t \n\t Contract: must not throw or reject. Return undefined when no key is available.\n\t /\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\n\t/\n\t Called after each turn fully completes and `turn_end` has been emitted.\n\t \n\t If it returns true, the loop emits `agent_end` and exits before polling steering or follow-up queues,\n\t * without starting another LLM call. The current assistant response and any tool executions finish normally.\n\t \n\t Use this to request a graceful stop after the current turn, e.g. before context gets too full.\n\t \n\t Contract: must not throw or reject. Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t /\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\n\t/* When present, this typed owner replaces shouldStopAfterTurn; it does not replace natural continuation. /\n\tgetTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\n\t/\n\t Called synchronously after a completed turn and before polling work for another turn.\n\t * Return true to emit `agent_end` without starting another provider call. Work returned by\n\t * an asynchronous poll owns that boundary; queue owners must suppress stale continuation\n\t * results if their higher-level stop condition changes while generating them.\n\t * The hook is never checked before the initial assistant turn.\n\t /\n\tshouldStopBeforeTurn?: () => boolean;\n\n\t/\n\t Returns steering messages to inject into the conversation mid-run.\n\t \n\t Called after the current assistant turn finishes executing its tool calls, unless `shouldStopAfterTurn` exits first.\n\t * If messages are returned, they are added to the context before the next LLM call.\n\t * Tool calls from the current assistant message are not skipped.\n\t \n\t Use this for \"steering\" the agent while it's working.\n\t \n\t Contract: must not throw or reject. Return [] when no steering messages are available.\n\t /\n\tgetSteeringMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns follow-up messages to process after the agent would otherwise stop.\n\t \n\t Called when the agent has no more tool calls and no steering messages.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for follow-up messages that should wait until the agent finishes.\n\t \n\t Contract: must not throw or reject. Return [] when no follow-up messages are available.\n\t /\n\tgetFollowUpMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns continuation messages when the agent would otherwise stop.\n\t \n\t Called after follow-up messages have been polled and none are available.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for host-owned continuation policies such as long-running goals.\n\t * Explicit follow-up messages always take precedence over continuation messages.\n\t \n\t Contract: must not throw or reject. Return [] when no continuation should run.\n\t /\n\tgetContinuationMessages?: (context: GetContinuationMessagesContext, signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/\n\t Authoritative runtime continuation control, after steering and explicit follow-ups.\n\t * When present, only this callback is called; getContinuationMessages is not polled.\n\t * Only continue restarts this invocation. Waiting leaves future work with its existing owner.\n\t /\n\tgetContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\n\n\t/\n\t Tool execution mode. Defaults to `\"parallel\"`.\n\t * Parallel mode preflights calls sequentially, executes allowed calls concurrently, emits\n\t * `tool_execution_end` in completion order, then emits tool-result messages in assistant source order.\n\t /\n\ttoolExecution?: ToolExecutionMode;\n\n\t/\n\t Awaited before invoking the tool. Rejection prevents execution and stops the loop.\n\t * The owner records intent here; admission is not proof that an external effect occurred.\n\t /\n\tonToolInvocationStarting?: (\n\t\tinvocation: ToolInvocation,\n\t\tsignal: AbortSignal \| undefined,\n\t\ttool: AgentTool,\n\t\texecute: AgentTool[\"execute\"],\n\t\tassistantMessage?: AssistantMessage,\n\t) => void \| BoundToolExecution \| Promise<void> \| Promise<BoundToolExecution \| undefined>;\n\n\t/\n\t Native execution owner, awaited after final middleware and before observer/result events.\n\t * Persist source evidence here. Rejection stops publication; this is not an observer hook.\n\t * Cancellation does not skip settlement. The owner must bound its own persistence work.\n\t /\n\tonToolExchangeFinalized?: (\n\t\texchange: FinalizedToolExchange,\n\t\tsignal?: AbortSignal,\n\t\towner?: BoundToolExecution,\n\t) => void \| Promise<void>;\n\n\t/\n\t Called before a tool is executed, after arguments have been validated.\n\t \n\t Return `{ block: true }` to prevent execution. The loop emits an error tool result instead.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\n\t/\n\t Called after a tool finishes executing, before `tool_execution_end` and tool-result message events are emitted.\n\t \n\t Return an `AfterToolCallResult` to override parts of the executed tool result:\n\t * - `content` replaces the full content array\n\t * - `details` replaces the full details payload\n\t * - `isError` replaces the error flag\n\t * - `terminate` replaces the early-termination hint\n\t \n\t Any omitted fields keep their original values. No deep merge is performed.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n}\n\n/\n Thinking/reasoning level for models that support it.\n * Note: \"xhigh\" and \"max\" are only supported by selected model families. Use model\n * thinking-level metadata from @ponythewhite/base-context-ai to detect support for a concrete model.\n /\nexport type ThinkingLevel = \"off\" \| \"minimal\" \| \"low\" \| \"medium\" \| \"high\" \| \"xhigh\" \| \"max\";\n\n/\n Extensible interface for custom app messages.\n * Apps can extend via declaration merging:\n \n @example\n * ```typescript\n * declare module \"@mariozechner/agent\" {\n * interface CustomAgentMessages {\n * artifact: ArtifactMessage;\n * notification: NotificationMessage;\n * }\n * }\n * ```\n /\nexport interface CustomAgentMessages {}\n\nexport type AgentMessage = Message \| CustomAgentMessages[keyof CustomAgentMessages];\n\n/\n Public agent state.\n \n `tools` and `messages` use accessor properties so implementations can copy\n * assigned arrays before storing them.\n /\nexport interface AgentState {\n\t/* System prompt sent with each model request. /\n\tsystemPrompt: string;\n\t/* Model used for future turns. /\n\tmodel: Model<any>;\n\t/* Requested reasoning level for future turns. /\n\tthinkingLevel: ThinkingLevel;\n\t/* Requested provider service tier for future turns. /\n\tserviceTier: ServiceTier;\n\t/* Available tools. Assigning a new array copies its top-level array. /\n\tset tools(tools: AgentTool<any>[]);\n\tget tools(): AgentTool<any>[];\n\t/* Conversation transcript. Assigning a new array copies its top-level array. /\n\tset messages(messages: AgentMessage[]);\n\tget messages(): AgentMessage[];\n\t/* True while processing a prompt or continuation, including awaited `agent_end` listeners. /\n\treadonly isStreaming: boolean;\n\t/* Partial assistant message for the active streamed response, if any. /\n\treadonly streamingMessage?: AgentMessage;\n\t/* Tool-call IDs currently executing. /\n\treadonly pendingToolCalls: ReadonlySet<string>;\n\t/* Error from the most recent failed or aborted assistant turn, if any. /\n\treadonly errorMessage?: string;\n}\n\n/* Final or partial result produced by a tool. /\nexport interface AgentToolResult<T> {\n\t/* Text or image content returned to the model. /\n\tcontent: (TextContent \| ImageContent)[];\n\t/* Structured details for logs or UI rendering. /\n\tdetails: T;\n\t/\n\t Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t /\n\tterminate?: boolean;\n}\n\n/* Callback used by tools to publish partial execution updates. /\nexport type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;\n\n/* Tool definition used by the agent runtime. /\nexport interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {\n\t/* Human-readable label for UI display. /\n\tlabel: string;\n\t/\n\t Optional compatibility shim for raw tool-call arguments before schema validation.\n\t * Must return an object that matches `TParameters`.\n\t /\n\tprepareArguments?: (args: unknown) => Static<TParameters>;\n\t/* Execute the tool call. Throw on failure instead of encoding errors in `content`. /\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<TParameters>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => Promise<AgentToolResult<TDetails>>;\n\t/\n\t Per-tool execution mode override.\n\t * - \"sequential\": this tool must execute one at a time with other tool calls.\n\t * - \"parallel\": this tool can execute concurrently with other tool calls.\n\t \n\t If omitted, the default execution mode applies.\n\t /\n\texecutionMode?: ToolExecutionMode;\n}\n\n/* Context snapshot passed to the low-level agent loop and tool hooks. /\nexport interface AgentContext {\n\t/* System prompt included with the request. /\n\tsystemPrompt: string;\n\t/* Transcript visible to the model. /\n\tmessages: AgentMessage[];\n\t/* Tools available for this run. /\n\ttools?: AgentTool<any>[];\n}\n\n/\n Events emitted by the Agent for UI updates.\n \n `agent_end` is the last event emitted for a run, but awaited `Agent.subscribe()`\n * listeners for that event are still part of run settlement. The agent becomes\n * idle only after those listeners finish.\n /\nexport type AgentEvent =\n\t/* Starts and ends one agent run; `agent_end` carries all messages produced by that run. /\n\t\| { type: \"agent_start\" }\n\t\| { type: \"agent_end\"; messages: AgentMessage[]; refusal?: never }\n\t\| { type: \"agent_end\"; refusal: AgentOutputRefusal; messages?: never }\n\t/* One assistant response and its resulting tool calls. /\n\t\| { type: \"turn_start\" }\n\t\| {\n\t\t\ttype: \"turn_end\";\n\t\t\tmessage: AgentMessage;\n\t\t\ttoolResults: ToolResultMessage[];\n\t\t\t/* Always populated by native execution; historical observer events may omit it. /\n\t\t\ttoolExecution?: ToolExecutionMode;\n\t\t\t/* Settled calls in source order. Absent historical evidence is not reconstructed. /\n\t\t\texchanges?: readonly FinalizedToolExchange[];\n\t }\n\t/* Lifecycle events for user, assistant, and tool-result messages. /\n\t\| { type: \"message_start\"; message: AgentMessage }\n\t/* Only emitted for assistant messages during streaming. /\n\t\| { type: \"message_update\"; message: AgentMessage; assistantMessageEvent: AssistantMessageEvent }\n\t\| { type: \"message_end\"; message: AgentMessage }\n\t/* Tool execution events; parallel calls may end in completion rather than source order. /\n\t\| { type: \"tool_execution_start\"; toolCallId: string; toolName: string; args: any }\n\t\| { type: \"tool_execution_update\"; toolCallId: string; toolName: string; args: any; partialResult: any }\n\t\| {\n\t\t\ttype: \"tool_execution_end\";\n\t\t\ttoolCallId: string;\n\t\t\ttoolName: string;\n\t\t\tresult: any;\n\t\t\tisError: boolean;\n\t\t\t/* Always populated by native execution; absent for older observer events. */\n\t\t\texchange?: FinalizedToolExchange;\n\t };\n"]}
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tAssistantMessage,\n\tAssistantMessageEvent,\n\tImageContent,\n\tMessage,\n\tModel,\n\tServiceTier,\n\tSimpleStreamOptions,\n\tstreamSimple,\n\tTextContent,\n\tTool,\n\tToolResultMessage,\n} from \"@ponythewhite/base-context-ai\";\nimport type { Static, TSchema } from \"typebox\";\n\n/*\n Stream function used by the agent loop.\n \n Contract:\n * - Must not throw or return a rejected promise for request/model/runtime failures.\n * - Must return an AssistantMessageEventStream.\n * - Failures must be encoded in the returned stream via protocol events and a\n * final AssistantMessage with stopReason \"error\" or \"aborted\" and errorMessage.\n /\nexport type StreamFn = (\n\t...args: Parameters<typeof streamSimple>\n) => ReturnType<typeof streamSimple> \| Promise<ReturnType<typeof streamSimple>>;\n\nexport interface AgentContextProjection {\n\tmessages: AgentMessage[];\n\t/\n\t Adopt this complete working set in the owning Agent and loop, not only for inference.\n\t * It must include the current turn and pending tool closure. This is not a last-N tail.\n\t * Omitted/false preserves the existing inference-only projection behavior.\n\t /\n\tadoptMessages?: boolean;\n\tstreamContext?: unknown;\n\trelease?: () => Promise<void>;\n}\n\n// biome-ignore lint/suspicious/noConfusingVoidType: this return contract accepts existing Promise<void> context barriers.\nexport type AgentContextBuildResult = void \| AgentContextProjection;\n\nexport type AgentOwnedStreamFn = (...args: [...Parameters<StreamFn>, streamContext?: unknown]) => ReturnType<StreamFn>;\n\n/\n Configuration for how tool calls from a single assistant message are executed.\n \n - \"sequential\": each tool call is prepared, executed, and finalized before the next one starts.\n * - \"parallel\": tool calls are prepared sequentially, then allowed tools execute concurrently.\n * `tool_execution_end` is emitted in tool completion order after each tool is finalized,\n * while tool-result message artifacts are emitted later in assistant source order.\n /\nexport type ToolExecutionMode = \"sequential\" \| \"parallel\";\n\n/* A tool-call content block emitted by an assistant message. /\nexport type AgentToolCall = Extract<AssistantMessage[\"content\"][number], { type: \"toolCall\" }>;\n\n/\n Result returned from `beforeToolCall`.\n \n Returning `{ block: true }` prevents the tool from executing. The loop emits an error tool result instead.\n * `reason` becomes the text shown in that error result. If omitted, a default blocked message is used.\n /\nexport interface BeforeToolCallResult {\n\tblock?: boolean;\n\treason?: string;\n}\n\n/\n Partial override returned from `afterToolCall`.\n \n Merge semantics are field-by-field:\n * - `content`: if provided, replaces the tool result content array in full\n * - `details`: if provided, replaces the tool result details value in full\n * - `isError`: if provided, replaces the tool result error flag\n * - `terminate`: if provided, replaces the early-termination hint\n \n Omitted fields keep the original executed tool result values.\n * There is no deep merge for `content` or `details`.\n /\nexport interface AfterToolCallResult {\n\tcontent?: (TextContent \| ImageContent)[];\n\tdetails?: unknown;\n\tisError?: boolean;\n\t/\n\t Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t /\n\tterminate?: boolean;\n}\n\n/* Context passed to `beforeToolCall` after arguments are validated. /\nexport interface BeforeToolCallContext {\n\t/* Assistant message that requested the call. /\n\tassistantMessage: AssistantMessage;\n\t/* Raw tool-call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated arguments for the target tool schema. /\n\targs: unknown;\n\t/* Agent context when this call is prepared. /\n\tcontext: AgentContext;\n}\n\n/* Context passed to `afterToolCall`. /\nexport interface AfterToolCallContext {\n\t/* Assistant message that requested the call. /\n\tassistantMessage: AssistantMessage;\n\t/* Raw tool-call block from `assistantMessage.content`. /\n\ttoolCall: AgentToolCall;\n\t/* Validated arguments for the target tool schema. /\n\targs: unknown;\n\t/* Executed result before any `afterToolCall` overrides. /\n\tresult: AgentToolResult<any>;\n\t/* Whether the executed result is currently treated as an error. /\n\tisError: boolean;\n\t/* Agent context when this call is finalized. /\n\tcontext: AgentContext;\n}\n\n/* What is known about the actual invocation, independently of middleware result overrides. /\nexport type ToolExecutionOutcome = \"not_started\" \| \"completed\" \| \"failed\" \| \"outcome_unknown\";\n\n/* Immutable invocation admitted by the execution owner before the tool can run. /\nexport interface ToolInvocation {\n\treadonly executionId: string;\n\treadonly sourceOrder: number;\n\treadonly toolCallId: string;\n\treadonly toolName: string;\n\t/* Snapshot before argument preparation, validation, or tool middleware. /\n\treadonly originalInput: unknown;\n\t/* Arguments reserved for this invocation, not a live middleware object. /\n\treadonly executedInput: unknown;\n\treadonly toolExecution: ToolExecutionMode;\n}\n\n/* @internal Per-invocation owner closure; never serialized or supplied by result metadata. /\nexport interface BoundToolExecution {\n\trun(execute: () => Promise<AgentToolResult<unknown>>): Promise<AgentToolResult<unknown>>;\n\tfinalize(exchange: FinalizedToolExchange, signal?: AbortSignal): void \| Promise<void>;\n}\n\n/* Finalized source evidence; parallel exchanges retain assistant call order via sourceOrder. /\nexport interface FinalizedToolExchange extends Omit<ToolInvocation, \"executedInput\"> {\n\t/* Snapshot at invocation; absent when execution never started. /\n\treadonly executedInput?: unknown;\n\t/* An aborted wait does not establish whether an external effect stopped. /\n\treadonly executionOutcome: ToolExecutionOutcome;\n\treadonly cancellationRequested: boolean;\n\t/* Final middleware result, also used for the tool-result message. /\n\treadonly result: ToolResultMessage;\n}\n\n/* Limits on the complete invocation result, not the working context or observer queues. /\nexport interface AgentOutputLimits {\n\tmaxMessages: number;\n\tmaxSourceBytes: number;\n}\n\nexport interface AgentOutputRefusal extends AgentOutputLimits {\n\tkind: \"output_limit\";\n\tlimit: \"messages\" \| \"source_bytes\" \| \"value_encoding\";\n}\n\nexport interface AgentOutputPolicy {\n\tlimits: AgentOutputLimits;\n\t/* Optional native update feed. Its synchronous refresh never revokes an ACK or throws a quota error. /\n\tbindUpdates?(refresh: (message: AgentMessage) => boolean): () => void;\n\t/* Close update admission and join the updates already accepted at this terminal boundary. /\n\tsettleUpdates?(): Promise<void>;\n\t/* Copy one finalized value within the supplied JSON-byte budget; undefined means it does not fit. /\n\tsnapshot(message: AgentMessage, maxSourceBytes: number): { message: AgentMessage; sourceBytes: number } \| undefined;\n}\n\n/* Context passed to `shouldStopAfterTurn` and both continuation callbacks. /\nexport interface ShouldStopAfterTurnContext {\n\t/* Assistant message that completed the turn. /\n\tmessage: AssistantMessage;\n\t/* Tool-result messages included in the preceding `turn_end` event. /\n\ttoolResults: ToolResultMessage[];\n\t/* Context after appending the turn's assistant message and tool results. /\n\tcontext: AgentContext;\n\t/* Messages returned by this invocation; prompts include initial prompts, continuations exclude prior context. /\n\tnewMessages: AgentMessage[];\n}\n\n/* The finalized loop decision, not a guess from the rendered message tail. /\nexport interface GetTurnOutcomeContext extends ShouldStopAfterTurnContext {\n\thasMoreToolCalls: boolean;\n}\n\n/* Control before queue polling; proceed keeps the ordinary loop policy. /\nexport type AgentTurnOutcome = { kind: \"proceed\" \| \"finish\" \| \"checkpoint_then_continue\" \| \"cancelled\" };\n\nexport type GetContinuationMessagesContext = ShouldStopAfterTurnContext;\n\n/* Runtime control at a natural turn boundary; message payload does not decide whether to restart. /\nexport type AgentContinuationOutcome =\n\t\| { kind: \"continue\"; messages: AgentMessage[] }\n\t\| { kind: \"finish\" \| \"wait_for_owned_work\" \| \"cancelled\" };\n\nexport interface AgentLoopConfig extends SimpleStreamOptions {\n\t/* Opt-in bounded finalized results. Native sinks must join their message_end job. /\n\toutputPolicy?: AgentOutputPolicy;\n\tmodel: Model<any>;\n\n\t/* Native owner barrier before transform/convert. Rejection stops context construction. /\n\tbeforeContextBuild?: () => Promise<AgentContextBuildResult>;\n\n\t/* Internal state mirror for adopted working sets. Awaited and excluded from provider options. /\n\tonContextAdopted?: (messages: AgentMessage[]) => void \| Promise<void>;\n\n\t/* Native owner recovery after an unsent request's projection has been released. /\n\trecoverRequestPreparation?: (error: unknown, signal?: AbortSignal) => Promise<boolean>;\n\n\t/* Retry a settled provider failure within this invocation and its output allowance. /\n\trecoverProviderFailure?: (message: AssistantMessage, signal?: AbortSignal) => Promise<boolean>;\n\n\t/* Copied native owner callback; excluded from configured/provider stream options. /\n\townedStreamFn?: AgentOwnedStreamFn;\n\n\t/\n\t Converts AgentMessage[] to LLM-compatible Message[] before each LLM call.\n\t \n\t Each AgentMessage must be converted to a UserMessage, AssistantMessage, or ToolResultMessage\n\t * that the LLM can understand. AgentMessages that cannot be converted (e.g., UI-only notifications,\n\t * status messages) should be filtered out.\n\t \n\t Contract: must not throw or reject. Return a safe fallback value instead.\n\t * Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t \n\t @example\n\t * ```typescript\n\t * convertToLlm: (messages) => messages.flatMap(m => {\n\t * if (m.role === \"custom\") {\n\t * // Convert custom message to user message\n\t * return [{ role: \"user\", content: m.content, timestamp: m.timestamp }];\n\t * }\n\t * if (m.role === \"notification\") {\n\t * // Filter out UI-only messages\n\t * return [];\n\t * }\n\t * // Pass through standard LLM messages\n\t * return [m];\n\t * })\n\t * ```\n\t /\n\tconvertToLlm: (messages: AgentMessage[]) => Message[] \| Promise<Message[]>;\n\n\t/\n\t Optional transform applied to the context before `convertToLlm`.\n\t \n\t Use this for operations that work at the AgentMessage level:\n\t * - Context window management (pruning old messages)\n\t * - Injecting context from external sources\n\t \n\t Contract: must not throw or reject. Return the original messages or another\n\t * safe fallback value instead.\n\t \n\t @example\n\t * ```typescript\n\t * transformContext: async (messages) => {\n\t * if (estimateTokens(messages) > MAX_TOKENS) {\n\t * return pruneOldMessages(messages);\n\t * }\n\t * return messages;\n\t * }\n\t * ```\n\t /\n\ttransformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/* Resolves the system prompt immediately before each LLM call. /\n\tgetSystemPrompt?: () => string;\n\n\t/\n\t Resolves an API key dynamically for each LLM call.\n\t \n\t Useful for short-lived OAuth tokens (e.g., GitHub Copilot) that may expire\n\t * during long-running tool execution phases.\n\t \n\t Contract: must not throw or reject. Return undefined when no key is available.\n\t /\n\tgetApiKey?: (provider: string) => Promise<string \| undefined> \| string \| undefined;\n\n\t/\n\t Called after each turn fully completes and `turn_end` has been emitted.\n\t \n\t If it returns true, the loop emits `agent_end` and exits before polling steering or follow-up queues,\n\t * without starting another LLM call. The current assistant response and any tool executions finish normally.\n\t \n\t Use this to request a graceful stop after the current turn, e.g. before context gets too full.\n\t \n\t Contract: must not throw or reject. Throwing interrupts the low-level agent loop without producing a normal event sequence.\n\t /\n\tshouldStopAfterTurn?: (context: ShouldStopAfterTurnContext) => boolean \| Promise<boolean>;\n\n\t/* When present, this typed owner replaces shouldStopAfterTurn; it does not replace natural continuation. /\n\tgetTurnOutcome?: (\n\t\tcontext: GetTurnOutcomeContext,\n\t\tsignal?: AbortSignal,\n\t) => AgentTurnOutcome \| Promise<AgentTurnOutcome>;\n\n\t/\n\t Called synchronously after a completed turn and before polling work for another turn.\n\t * Return true to emit `agent_end` without starting another provider call. Work returned by\n\t * an asynchronous poll owns that boundary; queue owners must suppress stale continuation\n\t * results if their higher-level stop condition changes while generating them.\n\t * The hook is never checked before the initial assistant turn.\n\t /\n\tshouldStopBeforeTurn?: () => boolean;\n\n\t/\n\t Returns steering messages to inject into the conversation mid-run.\n\t \n\t Called after the current assistant turn finishes executing its tool calls, unless `shouldStopAfterTurn` exits first.\n\t * If messages are returned, they are added to the context before the next LLM call.\n\t * Tool calls from the current assistant message are not skipped.\n\t \n\t Use this for \"steering\" the agent while it's working.\n\t \n\t Contract: must not throw or reject. Return [] when no steering messages are available.\n\t /\n\tgetSteeringMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns follow-up messages to process after the agent would otherwise stop.\n\t \n\t Called when the agent has no more tool calls and no steering messages.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for follow-up messages that should wait until the agent finishes.\n\t \n\t Contract: must not throw or reject. Return [] when no follow-up messages are available.\n\t /\n\tgetFollowUpMessages?: () => Promise<AgentMessage[]>;\n\n\t/\n\t Returns continuation messages when the agent would otherwise stop.\n\t \n\t Called after follow-up messages have been polled and none are available.\n\t * If messages are returned, they're added to the context and the agent\n\t * continues with another turn.\n\t \n\t Use this for host-owned continuation policies such as long-running goals.\n\t * Explicit follow-up messages always take precedence over continuation messages.\n\t \n\t Contract: must not throw or reject. Return [] when no continuation should run.\n\t /\n\tgetContinuationMessages?: (context: GetContinuationMessagesContext, signal?: AbortSignal) => Promise<AgentMessage[]>;\n\n\t/\n\t Authoritative runtime continuation control, after steering and explicit follow-ups.\n\t * When present, only this callback is called; getContinuationMessages is not polled.\n\t * Only continue restarts this invocation. Waiting leaves future work with its existing owner.\n\t /\n\tgetContinuationOutcome?: (\n\t\tcontext: GetContinuationMessagesContext,\n\t\tsignal?: AbortSignal,\n\t) => Promise<AgentContinuationOutcome>;\n\n\t/\n\t Tool execution mode. Defaults to `\"parallel\"`.\n\t * Parallel mode preflights calls sequentially, executes allowed calls concurrently, emits\n\t * `tool_execution_end` in completion order, then emits tool-result messages in assistant source order.\n\t /\n\ttoolExecution?: ToolExecutionMode;\n\n\t/\n\t Awaited before invoking the tool. Rejection prevents execution and stops the loop.\n\t * The owner records intent here; admission is not proof that an external effect occurred.\n\t /\n\tonToolInvocationStarting?: (\n\t\tinvocation: ToolInvocation,\n\t\tsignal: AbortSignal \| undefined,\n\t\ttool: AgentTool,\n\t\texecute: AgentTool[\"execute\"],\n\t\tassistantMessage?: AssistantMessage,\n\t) => void \| BoundToolExecution \| Promise<void> \| Promise<BoundToolExecution \| undefined>;\n\n\t/\n\t Native execution owner, awaited after final middleware and before observer/result events.\n\t * Persist source evidence here. Rejection stops publication; this is not an observer hook.\n\t * Cancellation does not skip settlement. The owner must bound its own persistence work.\n\t /\n\tonToolExchangeFinalized?: (\n\t\texchange: FinalizedToolExchange,\n\t\tsignal?: AbortSignal,\n\t\towner?: BoundToolExecution,\n\t) => void \| Promise<void>;\n\n\t/\n\t Called before a tool is executed, after arguments have been validated.\n\t \n\t Return `{ block: true }` to prevent execution. The loop emits an error tool result instead.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tbeforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult \| undefined>;\n\n\t/\n\t Called after a tool finishes executing, before `tool_execution_end` and tool-result message events are emitted.\n\t \n\t Return an `AfterToolCallResult` to override parts of the executed tool result:\n\t * - `content` replaces the full content array\n\t * - `details` replaces the full details payload\n\t * - `isError` replaces the error flag\n\t * - `terminate` replaces the early-termination hint\n\t \n\t Any omitted fields keep their original values. No deep merge is performed.\n\t * The hook receives the agent abort signal and is responsible for honoring it.\n\t /\n\tafterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult \| undefined>;\n}\n\n/\n Thinking/reasoning level for models that support it.\n * Note: \"xhigh\" and \"max\" are only supported by selected model families. Use model\n * thinking-level metadata from @ponythewhite/base-context-ai to detect support for a concrete model.\n /\nexport type ThinkingLevel = \"off\" \| \"minimal\" \| \"low\" \| \"medium\" \| \"high\" \| \"xhigh\" \| \"max\";\n\n/\n Extensible interface for custom app messages.\n * Apps can extend via declaration merging:\n \n @example\n * ```typescript\n * declare module \"@mariozechner/agent\" {\n * interface CustomAgentMessages {\n * artifact: ArtifactMessage;\n * notification: NotificationMessage;\n * }\n * }\n * ```\n /\nexport interface CustomAgentMessages {}\n\nexport type AgentMessage = Message \| CustomAgentMessages[keyof CustomAgentMessages];\n\n/\n Public agent state.\n \n `tools` and `messages` use accessor properties so implementations can copy\n * assigned arrays before storing them.\n /\nexport interface AgentState {\n\t/* System prompt sent with each model request. /\n\tsystemPrompt: string;\n\t/* Model used for future turns. /\n\tmodel: Model<any> \| undefined;\n\t/* Requested reasoning level for future turns. /\n\tthinkingLevel: ThinkingLevel;\n\t/* Requested provider service tier for future turns. /\n\tserviceTier: ServiceTier;\n\t/* Available tools. Assigning a new array copies its top-level array. /\n\tset tools(tools: AgentTool<any>[]);\n\tget tools(): AgentTool<any>[];\n\t/* Conversation transcript. Assigning a new array copies its top-level array. /\n\tset messages(messages: AgentMessage[]);\n\tget messages(): AgentMessage[];\n\t/* True while processing a prompt or continuation, including awaited `agent_end` listeners. /\n\treadonly isStreaming: boolean;\n\t/* Partial assistant message for the active streamed response, if any. /\n\treadonly streamingMessage?: AgentMessage;\n\t/* Tool-call IDs currently executing. /\n\treadonly pendingToolCalls: ReadonlySet<string>;\n\t/* Error from the most recent failed or aborted assistant turn, if any. /\n\treadonly errorMessage?: string;\n}\n\n/* Final or partial result produced by a tool. /\nexport interface AgentToolResult<T> {\n\t/* Text or image content returned to the model. /\n\tcontent: (TextContent \| ImageContent)[];\n\t/* Structured details for logs or UI rendering. /\n\tdetails: T;\n\t/\n\t Hint that the agent should stop after the current tool batch.\n\t * Early termination only happens when every finalized tool result in the batch sets this to true.\n\t /\n\tterminate?: boolean;\n}\n\n/* Callback used by tools to publish partial execution updates. /\nexport type AgentToolUpdateCallback<T = any> = (partialResult: AgentToolResult<T>) => void;\n\n/* Tool definition used by the agent runtime. /\nexport interface AgentTool<TParameters extends TSchema = TSchema, TDetails = any> extends Tool<TParameters> {\n\t/* Human-readable label for UI display. /\n\tlabel: string;\n\t/\n\t Optional compatibility shim for raw tool-call arguments before schema validation.\n\t * Must return an object that matches `TParameters`.\n\t /\n\tprepareArguments?: (args: unknown) => Static<TParameters>;\n\t/* Execute the tool call. Throw on failure instead of encoding errors in `content`. /\n\texecute: (\n\t\ttoolCallId: string,\n\t\tparams: Static<TParameters>,\n\t\tsignal?: AbortSignal,\n\t\tonUpdate?: AgentToolUpdateCallback<TDetails>,\n\t) => Promise<AgentToolResult<TDetails>>;\n\t/\n\t Per-tool execution mode override.\n\t * - \"sequential\": this tool must execute one at a time with other tool calls.\n\t * - \"parallel\": this tool can execute concurrently with other tool calls.\n\t \n\t If omitted, the default execution mode applies.\n\t /\n\texecutionMode?: ToolExecutionMode;\n}\n\n/* Context snapshot passed to the low-level agent loop and tool hooks. /\nexport interface AgentContext {\n\t/* System prompt included with the request. /\n\tsystemPrompt: string;\n\t/* Transcript visible to the model. /\n\tmessages: AgentMessage[];\n\t/* Tools available for this run. /\n\ttools?: AgentTool<any>[];\n}\n\n/\n Events emitted by the Agent for UI updates.\n \n `agent_end` is the last event emitted for a run, but awaited `Agent.subscribe()`\n * listeners for that event are still part of run settlement. The agent becomes\n * idle only after those listeners finish.\n /\nexport type AgentEvent =\n\t/* Starts and ends one agent run; `agent_end` carries all messages produced by that run. /\n\t\| { type: \"agent_start\" }\n\t\| { type: \"agent_end\"; messages: AgentMessage[]; refusal?: never }\n\t\| { type: \"agent_end\"; refusal: AgentOutputRefusal; messages?: never }\n\t/* One assistant response and its resulting tool calls. /\n\t\| { type: \"turn_start\" }\n\t\| {\n\t\t\ttype: \"turn_end\";\n\t\t\tmessage: AgentMessage;\n\t\t\ttoolResults: ToolResultMessage[];\n\t\t\t/* Always populated by native execution; historical observer events may omit it. /\n\t\t\ttoolExecution?: ToolExecutionMode;\n\t\t\t/* Settled calls in source order. Absent historical evidence is not reconstructed. /\n\t\t\texchanges?: readonly FinalizedToolExchange[];\n\t }\n\t/* Lifecycle events for user, assistant, and tool-result messages. /\n\t\| { type: \"message_start\"; message: AgentMessage }\n\t/* Only emitted for assistant messages during streaming. /\n\t\| { type: \"message_update\"; message: AgentMessage; assistantMessageEvent: AssistantMessageEvent }\n\t\| { type: \"message_end\"; message: AgentMessage }\n\t/* Tool execution events; parallel calls may end in completion rather than source order. /\n\t\| { type: \"tool_execution_start\"; toolCallId: string; toolName: string; args: any }\n\t\| { type: \"tool_execution_update\"; toolCallId: string; toolName: string; args: any; partialResult: any }\n\t\| {\n\t\t\ttype: \"tool_execution_end\";\n\t\t\ttoolCallId: string;\n\t\t\ttoolName: string;\n\t\t\tresult: any;\n\t\t\tisError: boolean;\n\t\t\t/* Always populated by native execution; absent for older observer events. */\n\t\t\texchange?: FinalizedToolExchange;\n\t };\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
 	"name": "@ponythewhite/base-context-agent",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "Synerise base-context agent runtime with context management and native recovery",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -19,7 +19,7 @@
 		"prepublishOnly": "npm --prefix ../.. run build:source"
 	},
 	"dependencies": {
-		"@ponythewhite/base-context-ai": "1.0.0",
+		"@ponythewhite/base-context-ai": "1.0.2",
 		"typebox": "^1.3.9"
 	},
 	"keywords": [