@dudousxd/nestjs-agent-core 0.33.0 → 0.34.0

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { M as ModelMessage, c as ToolDefinition, d as ToolCallRequest, e as MessageUsage, f as AgentUiComponent, A as Actor, g as AiToolCtx, h as AgentStreamEvent, T as ToolSpec, Q as QuotaState, i as AgentRunInput, H as HumanReply, j as MessageAttachment, k as ToolKind, l as ToolCallStatus, m as ToolCallApproval, a as ToolHandler, n as HistoryPolicy, P as PageContext, o as AgentDefinition, p as AgentDelegation, q as AgentStore, D as DetachedDelivery, r as ToolDescribeScope, s as PromptBuilder, t as PromptContributor, u as ToolTransientRetrySetting, v as AgentIntake, w as Decision, E as ElicitationRequest, L as LlmStepEnvelope, x as ToolStepEnvelope, C as ChatQueueStore, y as CreateThreadInput, z as ThreadSummary, B as ThreadDetail, F as ToolCallApprovalState, U as UpdateThreadInput, R as RecordRunStartInput, G as EnqueueMessageInput, I as QueuedMessage, J as QueuedMessagePatch, K as QueuePause, N as AppendMessageInput, S as StoredMessage, O as ToolResult, V as MessageFeedback, W as RecordToolCallInput, X as UpdateToolCallInput, Y as RecordUsageInput } from './tool-CMTuoJ2v.cjs';
-export { Z as ALL_AGENTS, _ as ASK_TOOL_DESCRIPTION, $ as ASK_TOOL_NAME, a0 as AgentApprovalRequest, a1 as AgentApprovalSettlement, a2 as AgentAttachmentConfig, a3 as AgentCatalogEntry, a4 as AgentClientConfig, a5 as AgentHistoryWindow, a6 as AskToolInput, a7 as ChatQueueState, a8 as DEFAULT_INTAKE_PREAMBLE, a9 as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, aa as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, ab as ELICITATION_INPUT_TYPES, ac as ElicitationInput, ad as ElicitationInputType, ae as ElicitationOption, af as ElicitationOutcome, ag as ElicitationQuestion, ah as ElicitationReply, ai as ElicitationResult, aj as HistoryPolicyContext, ak as HistorySelection, al as HistorySummary, am as InvokeWithTransientRetryOptions, an as MAX_ASK_QUESTIONS, ao as MessageFeedbackValue, ap as MessageRole, aq as PromptContext, ar as QueuePauseReason, as as QueuedMessageView, at as QuotaView, au as RecordRunEndInput, av as ThreadTurnPage, aw as ThreadTurnQuery, ax as ThreadTurnReader, ay as ToolCallApprovalStatus, az as ToolCatalogEntry, aA as ToolConfirmation, aB as ToolDescription, b as ToolPresentation, aC as ToolPresentationTone, aD as ToolResultField, aE as ToolResultView, aF as ToolStepCtx, aG as ToolTransientRetryNumbers, aH as ToolTransientRetryOptions, aI as UsagePurpose, aJ as askInputSchema, aK as askToolDefinition, aL as decodeStreamEvent, aM as encodeStreamEvent, aN as invokeWithTransientRetry, aO as isChatQueueStore, aP as isTransientToolError, aQ as isTypedQuestion, aR as normalizeElicitationReply, aS as questionOptions, aT as queuedMessageView, aU as readElicitationInput, aV as readElicitationQuestions, aW as releaseThreadRun, aX as renderElicitationAnswers, aY as resolveElicitation, aZ as resolveToolTransientRetryNumbers, a_ as settleElicitation, a$ as validateElicitationAnswer, b0 as validateElicitationValue } from './tool-CMTuoJ2v.cjs';
+import { M as ModelMessage, c as ToolDefinition, d as ToolCallRequest, e as MessageUsage, f as AgentUiComponent, A as Actor, g as AiToolCtx, h as AgentStreamEvent, T as ToolSpec, Q as QuotaState, i as AgentRunInput, H as HumanReply, j as MessageAttachment, k as ToolKind, l as ToolCallStatus, m as ToolCallApproval, a as ToolHandler, n as HistoryPolicy, P as PageContext, o as AgentDefinition, p as AgentStore, q as AgentDelegation, D as DetachedDelivery, r as ToolDescribeScope, s as PromptBuilder, t as PromptContributor, u as ToolTransientRetrySetting, v as AgentIntake, w as Decision, E as ElicitationRequest, L as LlmStepEnvelope, x as ToolStepEnvelope, C as ChatQueueStore, y as CreateThreadInput, z as ThreadSummary, B as ThreadDetail, F as ToolCallApprovalState, U as UpdateThreadInput, R as RecordRunStartInput, G as EnqueueMessageInput, I as QueuedMessage, J as QueuedMessagePatch, K as QueuePause, N as AppendMessageInput, S as StoredMessage, O as ToolResult, V as MessageFeedback, W as RecordToolCallInput, X as ToolCallOutcome, Y as UpdateToolCallInput, Z as RecordUsageInput } from './tool-C128TFWw.cjs';
+export { _ as ALL_AGENTS, $ as ASK_TOOL_DESCRIPTION, a0 as ASK_TOOL_NAME, a1 as AgentApprovalRequest, a2 as AgentApprovalSettlement, a3 as AgentAttachmentConfig, a4 as AgentCatalogEntry, a5 as AgentClientConfig, a6 as AgentHistoryWindow, a7 as AgentStreamErrorCode, a8 as AskToolInput, a9 as ChatQueueState, aa as DEFAULT_INTAKE_PREAMBLE, ab as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, ac as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, ad as ELICITATION_INPUT_TYPES, ae as ElicitationInput, af as ElicitationInputType, ag as ElicitationOption, ah as ElicitationOutcome, ai as ElicitationQuestion, aj as ElicitationReply, ak as ElicitationResult, al as HistoryPolicyContext, am as HistorySelection, an as HistorySummary, ao as InvokeWithTransientRetryOptions, ap as MAX_ASK_QUESTIONS, aq as MessageFeedbackValue, ar as MessageRole, as as PromptContext, at as QueuePauseReason, au as QueuedMessageView, av as QuotaView, aw as RUN_ENDED_BEFORE_TOOL_CALL, ax as RecordRunEndInput, ay as ThreadTurnPage, az as ThreadTurnQuery, aA as ThreadTurnReader, aB as ToolCallApprovalStatus, aC as ToolCatalogEntry, aD as ToolConfirmation, aE as ToolDescription, b as ToolPresentation, aF as ToolPresentationTone, aG as ToolResultField, aH as ToolResultView, aI as ToolStepCtx, aJ as ToolTransientRetryNumbers, aK as ToolTransientRetryOptions, aL as UNFINISHED_TOOL_CALL, aM as UsagePurpose, aN as askInputSchema, aO as askToolDefinition, aP as danglingToolCallIds, aQ as decodeStreamEvent, aR as encodeStreamEvent, aS as invokeWithTransientRetry, aT as isChatQueueStore, aU as isTransientToolError, aV as isTypedQuestion, aW as normalizeElicitationReply, aX as questionOptions, aY as queuedMessageView, aZ as readElicitationInput, a_ as readElicitationQuestions, a$ as releaseThreadRun, b0 as renderElicitationAnswers, b1 as resolveElicitation, b2 as resolveToolTransientRetryNumbers, b3 as settleDanglingToolCalls, b4 as settleElicitation, b5 as validateElicitationAnswer, b6 as validateElicitationValue } from './tool-C128TFWw.cjs';
 import { StandardSchemaV1 } from '@standard-schema/spec';
-import { O as OutputProcessor, P as ProcessorContext, I as InputProcessor, a as ProcessedPrompt, M as ModelAnswer } from './processors-DvZDW5zS.cjs';
-export { D as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, b as IncrementalGating, c as OutputRejectedError, d as OutputVerdict, e as ProcessorFailedError } from './processors-DvZDW5zS.cjs';
+import { O as OutputProcessor, P as ProcessorContext, I as InputProcessor, a as ProcessedPrompt, M as ModelAnswer } from './processors-Bm2DniQ8.cjs';
+export { D as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, b as IncrementalGating, c as OutputRejectedError, d as OutputVerdict, e as ProcessorFailedError } from './processors-Bm2DniQ8.cjs';
 import { ChannelRegistry } from '@dudousxd/nestjs-diagnostics';
 
 /**
@@ -2368,6 +2368,42 @@ declare function isReplayIntegrityError(error: unknown): boolean;
  */
 declare function isControlFlowSignal(error: unknown): boolean;
 
+/** The `code` a decision answers with when the run it was for is over (`409`). */
+declare const RUN_NOT_ACTIVE_CODE = "run_not_active";
+/** What a person is told when they decide on a request whose run is over. */
+declare const RUN_NOT_ACTIVE_MESSAGE = "This request is no longer waiting for an answer: the turn it belonged to has ended. Send the message again.";
+/** What is written on the row of a run that was found over without having said so itself. */
+declare const RUN_NO_LONGER_RUNNING = "the run is no longer running";
+interface SettleDeadRunInput {
+    runId: string;
+    /** Set for a thread's own turn: the thread is released if this run still holds it. */
+    threadId?: string;
+    /**
+     * Settle the run ROW as `failed` with this. Pass it only where the caller KNOWS the run failed
+     * (the run's own body, unwinding). `recordRunEnd` is last-write-wins, so a caller that only knows
+     * the run is no longer running — it may have completed — must leave the row alone.
+     */
+    failure?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Leave nothing waiting on a run that is over and did not say so itself.
+ *
+ * A run normally settles its own row, its calls and its thread from inside its body. One that is
+ * refused a checkpoint position, or whose worker died, never gets there: a call it had put to a
+ * person stays `pending_approval` — an approval card that takes a "yes" and then does nothing, for
+ * ever — and its thread stays pointed at it. Everything here is written straight to the store,
+ * outside any checkpoint, because the callers are exactly the paths that have no journal left to
+ * write to; each write is idempotent (only still-pending calls, a release conditional on the
+ * holder), so doing it twice changes nothing.
+ *
+ * Best-effort on purpose: this runs while something else is already failing, and must not replace
+ * that failure with one of its own.
+ */
+declare function settleDeadRun(store: AgentStore, input: SettleDeadRunInput): Promise<void>;
+
 /** An agent->agent edge with its awaited-or-not resolved, whichever form it was authored in. */
 interface ResolvedDelegation {
     agent: string;
@@ -2937,6 +2973,30 @@ declare class RunCancelledError extends Error {
  * page whoever is on call for model failures.
  */
 declare function agentFailureCode(error: unknown): string;
+/**
+ * What a person is told when a run fails for a reason that is ours rather than theirs. The error's
+ * own text is for whoever operates the deployment: it names run ids, checkpoint positions and
+ * provider internals ("non-determinism at <uuid>#41 …", "No output generated. Check the stream for
+ * errors."), which mean nothing to the person reading the chat and are not theirs to see.
+ */
+declare const RUN_FAILED_MESSAGE = "The assistant could not finish this answer. Please try again.";
+/**
+ * Whether an error frame carries the error's own message. Unset → only outside production
+ * (`NODE_ENV !== 'production'`), where the person reading the stream is the one debugging it.
+ * `true`/`false` decides it outright; `undefined` returns to the default.
+ */
+declare function exposeStreamErrorDetails(expose: boolean | undefined): void;
+/**
+ * The terminal a failed run closes its stream with — what `SinkWriter.fail` takes, and what the
+ * transport sends as the `event: error` frame.
+ *
+ * The frame is what the PERSON sees. For a crash it carries a stable `code` (what a client branches
+ * on, and translates) and {@link RUN_FAILED_MESSAGE}; the error itself belongs in the log and on the
+ * run row, which is where the runners put it. Outside production the raw message rides the frame as
+ * it always did (see {@link exposeStreamErrorDetails}). A message the library words itself
+ * (`quota_exceeded`, `output_rejected`, `structured_output_invalid`) is sent as it is.
+ */
+declare function streamFailure(error: unknown): StreamError;
 /** Reject if `work` doesn't settle within `ms`. The underlying work is left to finish on its own. */
 declare function withToolTimeout<T>(work: Promise<T>, ms: number, toolName: string): Promise<T>;
 /**
@@ -2985,6 +3045,16 @@ declare function withAskTool({ tools, ask, }: {
     tools: ToolDefinition[];
     ask: boolean | undefined;
 }): ToolDefinition[];
+/**
+ * The per-CALL half of a tool's context: which call this is, and the key that stays the same for
+ * every execution of it (see {@link AiToolCtx.idempotencyKey}).
+ */
+declare function toolCallContext<T extends {
+    runId: string;
+}>(ctx: T, toolCallId: string): T & {
+    toolCallId: string;
+    idempotencyKey: string;
+};
 /** The reason an expired call is denied with — on the row, the stream frame and the result. */
 declare const APPROVAL_EXPIRED_REASON = "approval expired";
 /**
@@ -3403,6 +3473,8 @@ declare class InMemoryAgentStore implements AgentStore, ChatQueueStore {
      */
     referencedMediaIds(actorRef: string, mediaIds: readonly string[]): Promise<string[]>;
     recordToolCall(input: RecordToolCallInput): Promise<void>;
+    toolCallOutcomes(toolCallIds: readonly string[]): Promise<ToolCallOutcome[]>;
+    failUnsettledToolCalls(runId: string, error: string): Promise<number>;
     updateToolCall(input: UpdateToolCallInput): Promise<void>;
     recordUsage(input: RecordUsageInput): Promise<void>;
     quotaToday(actorRef: string, day: string): Promise<{
@@ -3454,4 +3526,4 @@ declare class InMemoryAgentStore implements AgentStore, ChatQueueStore {
     private toSummary;
 }
 
-export { AGENT_ACTOR_DIRECTORY, AGENT_ACTOR_RESOLVER, AGENT_APPROVAL_PORT, AGENT_ATTACHMENT_STAGING, AGENT_DEPS_FACTORY, AGENT_DIAGNOSTIC_EVENTS, AGENT_DURABLE_RUNNER, AGENT_EMBEDDING_PROVIDER, AGENT_GOVERNANCE_QUERIES, AGENT_MEMORY, AGENT_MODEL, AGENT_MODEL_CATALOG, AGENT_OPTIONS, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, AGENT_QUOTA_PROVIDER, AGENT_QUOTA_STORE, AGENT_REGISTRY, AGENT_RETRIEVER, AGENT_ROLES_POLICY, AGENT_RUNNER, AGENT_SINK, AGENT_SKILLS, AGENT_SKILL_SOURCES, AGENT_SPAN_EVENTS, AGENT_STORE, AGENT_TOOL_REGISTRY, APPROVAL_EXPIRED_REASON, Actor, type ActorDirectory, type ActorResolver, type ActorSpendRow, type AgentApprovalPort, AgentDefinition, type AgentDelegated, AgentDelegation, type AgentDiagnosticEvent, type AgentDiagnosticKey, type AgentFollowUpsSpan, type AgentGovernanceQueries, AgentIntake, type AgentLlmTurnSpan, type AgentLoopDeps, type AgentLoopHooks, type AgentLoopResult, type AgentMemoryResolved, type AgentMemoryWritten, type AgentMessageEvent, type AgentPricingStore, type AgentQuotaExceeded, AgentRegistry, type AgentRetrievalSpan, type AgentRetrieved, type AgentRunFailed, type AgentRunFinished, AgentRunInput, type AgentRunStartOptions, type AgentRunStarted, type AgentRunner, type AgentSkillsResolved, type AgentSpanEvent, AgentStore, AgentStreamError, AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, AppendMessageInput, type ApprovalDecisionRef, type ApprovalPolicy, type ApprovalRequirement, type ApprovalThreadRef, type ApprovalToolRef, type ApprovalWhere, type AttachmentRef, type AttachmentStagingDescription, type AttachmentStagingStore, type BufferedModelTurnResult, type BuildMemoryBlockInput, ChatQueueStore, type CostUsage, CreateThreadInput, type CurrentModelPrice, DEFAULT_HISTORY_SUMMARY_INSTRUCTION, DEFAULT_MAX_FACT_CHARS, DEFAULT_MAX_MEMORIES, DEFAULT_MAX_SKILLS, DEFAULT_REFUSAL_REASON, DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION, Decision, DefaultApprovalPolicy, DefaultRolesPolicy, type DetachedDelegationOutcome, type DetachedDelegationReceipt, DetachedDelivery, type DetailThreadRef, ElicitationRequest, type EmbeddingProvider, type EmitUi, EnqueueMessageInput, type ForgetMemoryInput, type FrameBuffer, GLOBAL_SCOPE, type GovernanceMessageRow, type GovernancePage, type GovernancePageQuery, type GovernancePendingApprovalRow, type GovernanceRange, type GovernanceRunDetail, type GovernanceRunRow, type GovernanceThreadDetail, type GovernanceThreadDetailQuery, type GovernanceThreadRow, type GovernanceToolCallRow, type GovernanceUsageInput, type GovernanceUsageRow, HistoryPolicy, HumanReply, InMemoryAgentStore, type IncrementalGate, InputProcessor, type ListMemoriesInput, type ListSkillsInput, type ListStagedAttachmentsInput, LlmStepEnvelope, type LoadSkillInput, type MemoryAuthor, type MemoryConfig, type MemoryDigest, type MemoryDigestEntry, type MemoryFact, type MemoryForgetRequest, type MemoryOrigin, type MemoryProvider, type MemoryRecord, type MemoryVerdict, type MemoryWriteOutcome, type MemoryWriteRequest, MessageAttachment, MessageFeedback, MessageUsage, ModelAnswer, type ModelCatalog, type ModelCatalogEntry, type ModelCatalogLock, type ModelCatalogProviderGroup, type ModelCatalogQuery, type ModelCatalogView, ModelMessage, type ModelPrice, type ModelPriceInput, type ModelProvider, type ModelSpendRow, type ModelTurnArgs, type ModelTurnResult, type ObservedTurnFrames, type OfferMemoriesInput, type OutputGateMode, type OutputGateResult, OutputProcessor, type OverriddenMemory, PageContext, type Passage, type PendingApprovalRow, ProcessedPrompt, ProcessorContext, PromptBuilder, PromptContributor, QueuePause, QueuedMessage, QueuedMessagePatch, type QuotaBlock, QuotaExceededError, type QuotaPeriod, type QuotaProvider, type QuotaQuery, type QuotaReport, QuotaState, type QuotaStore, type QuotaWarning, type QuotaWindow, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, REQUESTER_APPROVER, type RecentRunRow, RecordRunStartInput, RecordToolCallInput, RecordUsageInput, type RememberToolInput, type RerankOptions, type Reranker, type ResolveAttachmentInput, type ResolveMemoryDigestInput, type ResolvedDelegation, type RetrieveOptions, type Retriever, type RolesPolicy, type RunAgentBreakdownRow, RunCancelledError, type RunErrorBreakdownRow, type RunMetrics, type RunToolCallRow, type RunTrendPoint, type RunWhere, SKILL_TOOL_DESCRIPTION, SKILL_TOOL_NAME, type ScopeContext, type ScopeResolver, type SearchMemoriesInput, type SettledTask, type SinkWriter, type Skill, type SkillAuthor, type SkillCatalogEntry, type SkillContext, type SkillLoadOutcome, type SkillOffer, type SkillProvider, type SkillSummary, type SkillToolInput, type SkillWriteRequest, type SkillWriteVerdict, type SkillsConfig, type StageAttachmentInput, type StagedAttachment, type StoreMemoryInput, StoredMessage, type StreamError, type StructuredOutcome, StructuredOutputError, THREAD_DETAIL_CONTENT_CHARS, type ThreadActivityRow, ThreadDetail, type ThreadMessageRow, type ThreadMeta, type ThreadSpendRow, ThreadSummary, type ThreadUsageRollup, type ThreadWhere, type TokenStreamSink, type ToolCallActivityRow, ToolCallApproval, type ToolCallApprovalColumns, ToolCallApprovalState, ToolCallRequest, ToolCallStatus, type ToolCallWhere, ToolDefinition, ToolDescribeScope, ToolDisabledError, ToolForbiddenError, ToolHandler, ToolInputInvalidError, ToolKind, type ToolKindDeps, ToolNotFoundError, ToolRegistry, ToolResult, ToolSpec, type ToolStatRow, ToolStepEnvelope, ToolTransientRetrySetting, type TurnFrameSummary, type UiCollector, UpdateThreadInput, UpdateToolCallInput, type UsageTrendPoint, type WindowHistoryOptions, type WithMemoryToolInput, type WriteMemoryInput, actorScope, agentDiagnosticKey, agentFailureCode, bucketByActor, bucketByModel, bucketByThread, bucketUsageTrend, buildMemoryBlock, buildSkillsBlock, canActorUseTool, compositeSkillProvider, createFrameBuffer, createIncrementalGate, createNoopEmitUi, createUiCollector, dayBoundsUtc, defaultCanDecide, defaultScopeResolver, detachedDelivered, detachedStarted, detachedUnsettled, estimateCost, estimateMessageTokens, exhaustedWindow, extractJson, filterToolsByAllowList, filterToolsByCanUse, filterToolsByEnabled, filterToolsByRole, findCatalogModel, gateFollowUps, gateTail, isControlFlowSignal, isReplayIntegrityError, isToolEnabled, loadSkill, mayDecideApproval, memoryForgetVerdict, memoryWriteVerdict, mergeUi, normalizeDelegation, observeTurnFrames, offerMemories, offerSkills, publishAgentDelegated, publishAgentMemoryResolved, publishAgentMemoryWritten, publishAgentMessage, publishAgentQuotaExceeded, publishAgentRetrieved, publishAgentRunFailed, publishAgentRunFinished, publishAgentRunStarted, publishAgentSkillsResolved, publishAgentToolCall, publishAgentToolRetry, quotaPeriodRange, quotaUsedRatio, quotaWarning, releaseGatedFrames, rememberInputSchema, rememberToolDefinition, repairInstruction, resolveGateLookback, resolveMemoryDigest, resolveOutputGateMode, resolveSkillCatalog, rollupThreadUsage, runAgentLoop, runInputProcessors, runOutputProcessors, seedModelPrices, settleAll, settleUnsettledDelegation, skillInputSchema, skillToolDefinition, skillWriteVerdict, stampToolKinds, staticModelCatalog, staticSkillProvider, summarizeWithModel, tenantScope, toolCallApprovalFromRow, traceLlmTurn, traceToolExecution, truncateDetailContent, unwrapToolStepOutput, validateStructured, windowHistory, withAskTool, withMemoryTool, withSelectedModel, withSkillTool, withToolTimeout, withTurnFrames, wrapToolStepOutput, writeMemory };
+export { AGENT_ACTOR_DIRECTORY, AGENT_ACTOR_RESOLVER, AGENT_APPROVAL_PORT, AGENT_ATTACHMENT_STAGING, AGENT_DEPS_FACTORY, AGENT_DIAGNOSTIC_EVENTS, AGENT_DURABLE_RUNNER, AGENT_EMBEDDING_PROVIDER, AGENT_GOVERNANCE_QUERIES, AGENT_MEMORY, AGENT_MODEL, AGENT_MODEL_CATALOG, AGENT_OPTIONS, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, AGENT_QUOTA_PROVIDER, AGENT_QUOTA_STORE, AGENT_REGISTRY, AGENT_RETRIEVER, AGENT_ROLES_POLICY, AGENT_RUNNER, AGENT_SINK, AGENT_SKILLS, AGENT_SKILL_SOURCES, AGENT_SPAN_EVENTS, AGENT_STORE, AGENT_TOOL_REGISTRY, APPROVAL_EXPIRED_REASON, Actor, type ActorDirectory, type ActorResolver, type ActorSpendRow, type AgentApprovalPort, AgentDefinition, type AgentDelegated, AgentDelegation, type AgentDiagnosticEvent, type AgentDiagnosticKey, type AgentFollowUpsSpan, type AgentGovernanceQueries, AgentIntake, type AgentLlmTurnSpan, type AgentLoopDeps, type AgentLoopHooks, type AgentLoopResult, type AgentMemoryResolved, type AgentMemoryWritten, type AgentMessageEvent, type AgentPricingStore, type AgentQuotaExceeded, AgentRegistry, type AgentRetrievalSpan, type AgentRetrieved, type AgentRunFailed, type AgentRunFinished, AgentRunInput, type AgentRunStartOptions, type AgentRunStarted, type AgentRunner, type AgentSkillsResolved, type AgentSpanEvent, AgentStore, AgentStreamError, AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, AppendMessageInput, type ApprovalDecisionRef, type ApprovalPolicy, type ApprovalRequirement, type ApprovalThreadRef, type ApprovalToolRef, type ApprovalWhere, type AttachmentRef, type AttachmentStagingDescription, type AttachmentStagingStore, type BufferedModelTurnResult, type BuildMemoryBlockInput, ChatQueueStore, type CostUsage, CreateThreadInput, type CurrentModelPrice, DEFAULT_HISTORY_SUMMARY_INSTRUCTION, DEFAULT_MAX_FACT_CHARS, DEFAULT_MAX_MEMORIES, DEFAULT_MAX_SKILLS, DEFAULT_REFUSAL_REASON, DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION, Decision, DefaultApprovalPolicy, DefaultRolesPolicy, type DetachedDelegationOutcome, type DetachedDelegationReceipt, DetachedDelivery, type DetailThreadRef, ElicitationRequest, type EmbeddingProvider, type EmitUi, EnqueueMessageInput, type ForgetMemoryInput, type FrameBuffer, GLOBAL_SCOPE, type GovernanceMessageRow, type GovernancePage, type GovernancePageQuery, type GovernancePendingApprovalRow, type GovernanceRange, type GovernanceRunDetail, type GovernanceRunRow, type GovernanceThreadDetail, type GovernanceThreadDetailQuery, type GovernanceThreadRow, type GovernanceToolCallRow, type GovernanceUsageInput, type GovernanceUsageRow, HistoryPolicy, HumanReply, InMemoryAgentStore, type IncrementalGate, InputProcessor, type ListMemoriesInput, type ListSkillsInput, type ListStagedAttachmentsInput, LlmStepEnvelope, type LoadSkillInput, type MemoryAuthor, type MemoryConfig, type MemoryDigest, type MemoryDigestEntry, type MemoryFact, type MemoryForgetRequest, type MemoryOrigin, type MemoryProvider, type MemoryRecord, type MemoryVerdict, type MemoryWriteOutcome, type MemoryWriteRequest, MessageAttachment, MessageFeedback, MessageUsage, ModelAnswer, type ModelCatalog, type ModelCatalogEntry, type ModelCatalogLock, type ModelCatalogProviderGroup, type ModelCatalogQuery, type ModelCatalogView, ModelMessage, type ModelPrice, type ModelPriceInput, type ModelProvider, type ModelSpendRow, type ModelTurnArgs, type ModelTurnResult, type ObservedTurnFrames, type OfferMemoriesInput, type OutputGateMode, type OutputGateResult, OutputProcessor, type OverriddenMemory, PageContext, type Passage, type PendingApprovalRow, ProcessedPrompt, ProcessorContext, PromptBuilder, PromptContributor, QueuePause, QueuedMessage, QueuedMessagePatch, type QuotaBlock, QuotaExceededError, type QuotaPeriod, type QuotaProvider, type QuotaQuery, type QuotaReport, QuotaState, type QuotaStore, type QuotaWarning, type QuotaWindow, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, REQUESTER_APPROVER, RUN_FAILED_MESSAGE, RUN_NOT_ACTIVE_CODE, RUN_NOT_ACTIVE_MESSAGE, RUN_NO_LONGER_RUNNING, type RecentRunRow, RecordRunStartInput, RecordToolCallInput, RecordUsageInput, type RememberToolInput, type RerankOptions, type Reranker, type ResolveAttachmentInput, type ResolveMemoryDigestInput, type ResolvedDelegation, type RetrieveOptions, type Retriever, type RolesPolicy, type RunAgentBreakdownRow, RunCancelledError, type RunErrorBreakdownRow, type RunMetrics, type RunToolCallRow, type RunTrendPoint, type RunWhere, SKILL_TOOL_DESCRIPTION, SKILL_TOOL_NAME, type ScopeContext, type ScopeResolver, type SearchMemoriesInput, type SettleDeadRunInput, type SettledTask, type SinkWriter, type Skill, type SkillAuthor, type SkillCatalogEntry, type SkillContext, type SkillLoadOutcome, type SkillOffer, type SkillProvider, type SkillSummary, type SkillToolInput, type SkillWriteRequest, type SkillWriteVerdict, type SkillsConfig, type StageAttachmentInput, type StagedAttachment, type StoreMemoryInput, StoredMessage, type StreamError, type StructuredOutcome, StructuredOutputError, THREAD_DETAIL_CONTENT_CHARS, type ThreadActivityRow, ThreadDetail, type ThreadMessageRow, type ThreadMeta, type ThreadSpendRow, ThreadSummary, type ThreadUsageRollup, type ThreadWhere, type TokenStreamSink, type ToolCallActivityRow, ToolCallApproval, type ToolCallApprovalColumns, ToolCallApprovalState, ToolCallOutcome, ToolCallRequest, ToolCallStatus, type ToolCallWhere, ToolDefinition, ToolDescribeScope, ToolDisabledError, ToolForbiddenError, ToolHandler, ToolInputInvalidError, ToolKind, type ToolKindDeps, ToolNotFoundError, ToolRegistry, ToolResult, ToolSpec, type ToolStatRow, ToolStepEnvelope, ToolTransientRetrySetting, type TurnFrameSummary, type UiCollector, UpdateThreadInput, UpdateToolCallInput, type UsageTrendPoint, type WindowHistoryOptions, type WithMemoryToolInput, type WriteMemoryInput, actorScope, agentDiagnosticKey, agentFailureCode, bucketByActor, bucketByModel, bucketByThread, bucketUsageTrend, buildMemoryBlock, buildSkillsBlock, canActorUseTool, compositeSkillProvider, createFrameBuffer, createIncrementalGate, createNoopEmitUi, createUiCollector, dayBoundsUtc, defaultCanDecide, defaultScopeResolver, detachedDelivered, detachedStarted, detachedUnsettled, estimateCost, estimateMessageTokens, exhaustedWindow, exposeStreamErrorDetails, extractJson, filterToolsByAllowList, filterToolsByCanUse, filterToolsByEnabled, filterToolsByRole, findCatalogModel, gateFollowUps, gateTail, isControlFlowSignal, isReplayIntegrityError, isToolEnabled, loadSkill, mayDecideApproval, memoryForgetVerdict, memoryWriteVerdict, mergeUi, normalizeDelegation, observeTurnFrames, offerMemories, offerSkills, publishAgentDelegated, publishAgentMemoryResolved, publishAgentMemoryWritten, publishAgentMessage, publishAgentQuotaExceeded, publishAgentRetrieved, publishAgentRunFailed, publishAgentRunFinished, publishAgentRunStarted, publishAgentSkillsResolved, publishAgentToolCall, publishAgentToolRetry, quotaPeriodRange, quotaUsedRatio, quotaWarning, releaseGatedFrames, rememberInputSchema, rememberToolDefinition, repairInstruction, resolveGateLookback, resolveMemoryDigest, resolveOutputGateMode, resolveSkillCatalog, rollupThreadUsage, runAgentLoop, runInputProcessors, runOutputProcessors, seedModelPrices, settleAll, settleDeadRun, settleUnsettledDelegation, skillInputSchema, skillToolDefinition, skillWriteVerdict, stampToolKinds, staticModelCatalog, staticSkillProvider, streamFailure, summarizeWithModel, tenantScope, toolCallApprovalFromRow, toolCallContext, traceLlmTurn, traceToolExecution, truncateDetailContent, unwrapToolStepOutput, validateStructured, windowHistory, withAskTool, withMemoryTool, withSelectedModel, withSkillTool, withToolTimeout, withTurnFrames, wrapToolStepOutput, writeMemory };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { M as ModelMessage, c as ToolDefinition, d as ToolCallRequest, e as MessageUsage, f as AgentUiComponent, A as Actor, g as AiToolCtx, h as AgentStreamEvent, T as ToolSpec, Q as QuotaState, i as AgentRunInput, H as HumanReply, j as MessageAttachment, k as ToolKind, l as ToolCallStatus, m as ToolCallApproval, a as ToolHandler, n as HistoryPolicy, P as PageContext, o as AgentDefinition, p as AgentDelegation, q as AgentStore, D as DetachedDelivery, r as ToolDescribeScope, s as PromptBuilder, t as PromptContributor, u as ToolTransientRetrySetting, v as AgentIntake, w as Decision, E as ElicitationRequest, L as LlmStepEnvelope, x as ToolStepEnvelope, C as ChatQueueStore, y as CreateThreadInput, z as ThreadSummary, B as ThreadDetail, F as ToolCallApprovalState, U as UpdateThreadInput, R as RecordRunStartInput, G as EnqueueMessageInput, I as QueuedMessage, J as QueuedMessagePatch, K as QueuePause, N as AppendMessageInput, S as StoredMessage, O as ToolResult, V as MessageFeedback, W as RecordToolCallInput, X as UpdateToolCallInput, Y as RecordUsageInput } from './tool-CMTuoJ2v.js';
-export { Z as ALL_AGENTS, _ as ASK_TOOL_DESCRIPTION, $ as ASK_TOOL_NAME, a0 as AgentApprovalRequest, a1 as AgentApprovalSettlement, a2 as AgentAttachmentConfig, a3 as AgentCatalogEntry, a4 as AgentClientConfig, a5 as AgentHistoryWindow, a6 as AskToolInput, a7 as ChatQueueState, a8 as DEFAULT_INTAKE_PREAMBLE, a9 as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, aa as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, ab as ELICITATION_INPUT_TYPES, ac as ElicitationInput, ad as ElicitationInputType, ae as ElicitationOption, af as ElicitationOutcome, ag as ElicitationQuestion, ah as ElicitationReply, ai as ElicitationResult, aj as HistoryPolicyContext, ak as HistorySelection, al as HistorySummary, am as InvokeWithTransientRetryOptions, an as MAX_ASK_QUESTIONS, ao as MessageFeedbackValue, ap as MessageRole, aq as PromptContext, ar as QueuePauseReason, as as QueuedMessageView, at as QuotaView, au as RecordRunEndInput, av as ThreadTurnPage, aw as ThreadTurnQuery, ax as ThreadTurnReader, ay as ToolCallApprovalStatus, az as ToolCatalogEntry, aA as ToolConfirmation, aB as ToolDescription, b as ToolPresentation, aC as ToolPresentationTone, aD as ToolResultField, aE as ToolResultView, aF as ToolStepCtx, aG as ToolTransientRetryNumbers, aH as ToolTransientRetryOptions, aI as UsagePurpose, aJ as askInputSchema, aK as askToolDefinition, aL as decodeStreamEvent, aM as encodeStreamEvent, aN as invokeWithTransientRetry, aO as isChatQueueStore, aP as isTransientToolError, aQ as isTypedQuestion, aR as normalizeElicitationReply, aS as questionOptions, aT as queuedMessageView, aU as readElicitationInput, aV as readElicitationQuestions, aW as releaseThreadRun, aX as renderElicitationAnswers, aY as resolveElicitation, aZ as resolveToolTransientRetryNumbers, a_ as settleElicitation, a$ as validateElicitationAnswer, b0 as validateElicitationValue } from './tool-CMTuoJ2v.js';
+import { M as ModelMessage, c as ToolDefinition, d as ToolCallRequest, e as MessageUsage, f as AgentUiComponent, A as Actor, g as AiToolCtx, h as AgentStreamEvent, T as ToolSpec, Q as QuotaState, i as AgentRunInput, H as HumanReply, j as MessageAttachment, k as ToolKind, l as ToolCallStatus, m as ToolCallApproval, a as ToolHandler, n as HistoryPolicy, P as PageContext, o as AgentDefinition, p as AgentStore, q as AgentDelegation, D as DetachedDelivery, r as ToolDescribeScope, s as PromptBuilder, t as PromptContributor, u as ToolTransientRetrySetting, v as AgentIntake, w as Decision, E as ElicitationRequest, L as LlmStepEnvelope, x as ToolStepEnvelope, C as ChatQueueStore, y as CreateThreadInput, z as ThreadSummary, B as ThreadDetail, F as ToolCallApprovalState, U as UpdateThreadInput, R as RecordRunStartInput, G as EnqueueMessageInput, I as QueuedMessage, J as QueuedMessagePatch, K as QueuePause, N as AppendMessageInput, S as StoredMessage, O as ToolResult, V as MessageFeedback, W as RecordToolCallInput, X as ToolCallOutcome, Y as UpdateToolCallInput, Z as RecordUsageInput } from './tool-C128TFWw.js';
+export { _ as ALL_AGENTS, $ as ASK_TOOL_DESCRIPTION, a0 as ASK_TOOL_NAME, a1 as AgentApprovalRequest, a2 as AgentApprovalSettlement, a3 as AgentAttachmentConfig, a4 as AgentCatalogEntry, a5 as AgentClientConfig, a6 as AgentHistoryWindow, a7 as AgentStreamErrorCode, a8 as AskToolInput, a9 as ChatQueueState, aa as DEFAULT_INTAKE_PREAMBLE, ab as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, ac as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, ad as ELICITATION_INPUT_TYPES, ae as ElicitationInput, af as ElicitationInputType, ag as ElicitationOption, ah as ElicitationOutcome, ai as ElicitationQuestion, aj as ElicitationReply, ak as ElicitationResult, al as HistoryPolicyContext, am as HistorySelection, an as HistorySummary, ao as InvokeWithTransientRetryOptions, ap as MAX_ASK_QUESTIONS, aq as MessageFeedbackValue, ar as MessageRole, as as PromptContext, at as QueuePauseReason, au as QueuedMessageView, av as QuotaView, aw as RUN_ENDED_BEFORE_TOOL_CALL, ax as RecordRunEndInput, ay as ThreadTurnPage, az as ThreadTurnQuery, aA as ThreadTurnReader, aB as ToolCallApprovalStatus, aC as ToolCatalogEntry, aD as ToolConfirmation, aE as ToolDescription, b as ToolPresentation, aF as ToolPresentationTone, aG as ToolResultField, aH as ToolResultView, aI as ToolStepCtx, aJ as ToolTransientRetryNumbers, aK as ToolTransientRetryOptions, aL as UNFINISHED_TOOL_CALL, aM as UsagePurpose, aN as askInputSchema, aO as askToolDefinition, aP as danglingToolCallIds, aQ as decodeStreamEvent, aR as encodeStreamEvent, aS as invokeWithTransientRetry, aT as isChatQueueStore, aU as isTransientToolError, aV as isTypedQuestion, aW as normalizeElicitationReply, aX as questionOptions, aY as queuedMessageView, aZ as readElicitationInput, a_ as readElicitationQuestions, a$ as releaseThreadRun, b0 as renderElicitationAnswers, b1 as resolveElicitation, b2 as resolveToolTransientRetryNumbers, b3 as settleDanglingToolCalls, b4 as settleElicitation, b5 as validateElicitationAnswer, b6 as validateElicitationValue } from './tool-C128TFWw.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
-import { O as OutputProcessor, P as ProcessorContext, I as InputProcessor, a as ProcessedPrompt, M as ModelAnswer } from './processors-C1jir8eB.js';
-export { D as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, b as IncrementalGating, c as OutputRejectedError, d as OutputVerdict, e as ProcessorFailedError } from './processors-C1jir8eB.js';
+import { O as OutputProcessor, P as ProcessorContext, I as InputProcessor, a as ProcessedPrompt, M as ModelAnswer } from './processors-CtrfAA0B.js';
+export { D as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, b as IncrementalGating, c as OutputRejectedError, d as OutputVerdict, e as ProcessorFailedError } from './processors-CtrfAA0B.js';
 import { ChannelRegistry } from '@dudousxd/nestjs-diagnostics';
 
 /**
@@ -2368,6 +2368,42 @@ declare function isReplayIntegrityError(error: unknown): boolean;
  */
 declare function isControlFlowSignal(error: unknown): boolean;
 
+/** The `code` a decision answers with when the run it was for is over (`409`). */
+declare const RUN_NOT_ACTIVE_CODE = "run_not_active";
+/** What a person is told when they decide on a request whose run is over. */
+declare const RUN_NOT_ACTIVE_MESSAGE = "This request is no longer waiting for an answer: the turn it belonged to has ended. Send the message again.";
+/** What is written on the row of a run that was found over without having said so itself. */
+declare const RUN_NO_LONGER_RUNNING = "the run is no longer running";
+interface SettleDeadRunInput {
+    runId: string;
+    /** Set for a thread's own turn: the thread is released if this run still holds it. */
+    threadId?: string;
+    /**
+     * Settle the run ROW as `failed` with this. Pass it only where the caller KNOWS the run failed
+     * (the run's own body, unwinding). `recordRunEnd` is last-write-wins, so a caller that only knows
+     * the run is no longer running — it may have completed — must leave the row alone.
+     */
+    failure?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Leave nothing waiting on a run that is over and did not say so itself.
+ *
+ * A run normally settles its own row, its calls and its thread from inside its body. One that is
+ * refused a checkpoint position, or whose worker died, never gets there: a call it had put to a
+ * person stays `pending_approval` — an approval card that takes a "yes" and then does nothing, for
+ * ever — and its thread stays pointed at it. Everything here is written straight to the store,
+ * outside any checkpoint, because the callers are exactly the paths that have no journal left to
+ * write to; each write is idempotent (only still-pending calls, a release conditional on the
+ * holder), so doing it twice changes nothing.
+ *
+ * Best-effort on purpose: this runs while something else is already failing, and must not replace
+ * that failure with one of its own.
+ */
+declare function settleDeadRun(store: AgentStore, input: SettleDeadRunInput): Promise<void>;
+
 /** An agent->agent edge with its awaited-or-not resolved, whichever form it was authored in. */
 interface ResolvedDelegation {
     agent: string;
@@ -2937,6 +2973,30 @@ declare class RunCancelledError extends Error {
  * page whoever is on call for model failures.
  */
 declare function agentFailureCode(error: unknown): string;
+/**
+ * What a person is told when a run fails for a reason that is ours rather than theirs. The error's
+ * own text is for whoever operates the deployment: it names run ids, checkpoint positions and
+ * provider internals ("non-determinism at <uuid>#41 …", "No output generated. Check the stream for
+ * errors."), which mean nothing to the person reading the chat and are not theirs to see.
+ */
+declare const RUN_FAILED_MESSAGE = "The assistant could not finish this answer. Please try again.";
+/**
+ * Whether an error frame carries the error's own message. Unset → only outside production
+ * (`NODE_ENV !== 'production'`), where the person reading the stream is the one debugging it.
+ * `true`/`false` decides it outright; `undefined` returns to the default.
+ */
+declare function exposeStreamErrorDetails(expose: boolean | undefined): void;
+/**
+ * The terminal a failed run closes its stream with — what `SinkWriter.fail` takes, and what the
+ * transport sends as the `event: error` frame.
+ *
+ * The frame is what the PERSON sees. For a crash it carries a stable `code` (what a client branches
+ * on, and translates) and {@link RUN_FAILED_MESSAGE}; the error itself belongs in the log and on the
+ * run row, which is where the runners put it. Outside production the raw message rides the frame as
+ * it always did (see {@link exposeStreamErrorDetails}). A message the library words itself
+ * (`quota_exceeded`, `output_rejected`, `structured_output_invalid`) is sent as it is.
+ */
+declare function streamFailure(error: unknown): StreamError;
 /** Reject if `work` doesn't settle within `ms`. The underlying work is left to finish on its own. */
 declare function withToolTimeout<T>(work: Promise<T>, ms: number, toolName: string): Promise<T>;
 /**
@@ -2985,6 +3045,16 @@ declare function withAskTool({ tools, ask, }: {
     tools: ToolDefinition[];
     ask: boolean | undefined;
 }): ToolDefinition[];
+/**
+ * The per-CALL half of a tool's context: which call this is, and the key that stays the same for
+ * every execution of it (see {@link AiToolCtx.idempotencyKey}).
+ */
+declare function toolCallContext<T extends {
+    runId: string;
+}>(ctx: T, toolCallId: string): T & {
+    toolCallId: string;
+    idempotencyKey: string;
+};
 /** The reason an expired call is denied with — on the row, the stream frame and the result. */
 declare const APPROVAL_EXPIRED_REASON = "approval expired";
 /**
@@ -3403,6 +3473,8 @@ declare class InMemoryAgentStore implements AgentStore, ChatQueueStore {
      */
     referencedMediaIds(actorRef: string, mediaIds: readonly string[]): Promise<string[]>;
     recordToolCall(input: RecordToolCallInput): Promise<void>;
+    toolCallOutcomes(toolCallIds: readonly string[]): Promise<ToolCallOutcome[]>;
+    failUnsettledToolCalls(runId: string, error: string): Promise<number>;
     updateToolCall(input: UpdateToolCallInput): Promise<void>;
     recordUsage(input: RecordUsageInput): Promise<void>;
     quotaToday(actorRef: string, day: string): Promise<{
@@ -3454,4 +3526,4 @@ declare class InMemoryAgentStore implements AgentStore, ChatQueueStore {
     private toSummary;
 }
 
-export { AGENT_ACTOR_DIRECTORY, AGENT_ACTOR_RESOLVER, AGENT_APPROVAL_PORT, AGENT_ATTACHMENT_STAGING, AGENT_DEPS_FACTORY, AGENT_DIAGNOSTIC_EVENTS, AGENT_DURABLE_RUNNER, AGENT_EMBEDDING_PROVIDER, AGENT_GOVERNANCE_QUERIES, AGENT_MEMORY, AGENT_MODEL, AGENT_MODEL_CATALOG, AGENT_OPTIONS, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, AGENT_QUOTA_PROVIDER, AGENT_QUOTA_STORE, AGENT_REGISTRY, AGENT_RETRIEVER, AGENT_ROLES_POLICY, AGENT_RUNNER, AGENT_SINK, AGENT_SKILLS, AGENT_SKILL_SOURCES, AGENT_SPAN_EVENTS, AGENT_STORE, AGENT_TOOL_REGISTRY, APPROVAL_EXPIRED_REASON, Actor, type ActorDirectory, type ActorResolver, type ActorSpendRow, type AgentApprovalPort, AgentDefinition, type AgentDelegated, AgentDelegation, type AgentDiagnosticEvent, type AgentDiagnosticKey, type AgentFollowUpsSpan, type AgentGovernanceQueries, AgentIntake, type AgentLlmTurnSpan, type AgentLoopDeps, type AgentLoopHooks, type AgentLoopResult, type AgentMemoryResolved, type AgentMemoryWritten, type AgentMessageEvent, type AgentPricingStore, type AgentQuotaExceeded, AgentRegistry, type AgentRetrievalSpan, type AgentRetrieved, type AgentRunFailed, type AgentRunFinished, AgentRunInput, type AgentRunStartOptions, type AgentRunStarted, type AgentRunner, type AgentSkillsResolved, type AgentSpanEvent, AgentStore, AgentStreamError, AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, AppendMessageInput, type ApprovalDecisionRef, type ApprovalPolicy, type ApprovalRequirement, type ApprovalThreadRef, type ApprovalToolRef, type ApprovalWhere, type AttachmentRef, type AttachmentStagingDescription, type AttachmentStagingStore, type BufferedModelTurnResult, type BuildMemoryBlockInput, ChatQueueStore, type CostUsage, CreateThreadInput, type CurrentModelPrice, DEFAULT_HISTORY_SUMMARY_INSTRUCTION, DEFAULT_MAX_FACT_CHARS, DEFAULT_MAX_MEMORIES, DEFAULT_MAX_SKILLS, DEFAULT_REFUSAL_REASON, DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION, Decision, DefaultApprovalPolicy, DefaultRolesPolicy, type DetachedDelegationOutcome, type DetachedDelegationReceipt, DetachedDelivery, type DetailThreadRef, ElicitationRequest, type EmbeddingProvider, type EmitUi, EnqueueMessageInput, type ForgetMemoryInput, type FrameBuffer, GLOBAL_SCOPE, type GovernanceMessageRow, type GovernancePage, type GovernancePageQuery, type GovernancePendingApprovalRow, type GovernanceRange, type GovernanceRunDetail, type GovernanceRunRow, type GovernanceThreadDetail, type GovernanceThreadDetailQuery, type GovernanceThreadRow, type GovernanceToolCallRow, type GovernanceUsageInput, type GovernanceUsageRow, HistoryPolicy, HumanReply, InMemoryAgentStore, type IncrementalGate, InputProcessor, type ListMemoriesInput, type ListSkillsInput, type ListStagedAttachmentsInput, LlmStepEnvelope, type LoadSkillInput, type MemoryAuthor, type MemoryConfig, type MemoryDigest, type MemoryDigestEntry, type MemoryFact, type MemoryForgetRequest, type MemoryOrigin, type MemoryProvider, type MemoryRecord, type MemoryVerdict, type MemoryWriteOutcome, type MemoryWriteRequest, MessageAttachment, MessageFeedback, MessageUsage, ModelAnswer, type ModelCatalog, type ModelCatalogEntry, type ModelCatalogLock, type ModelCatalogProviderGroup, type ModelCatalogQuery, type ModelCatalogView, ModelMessage, type ModelPrice, type ModelPriceInput, type ModelProvider, type ModelSpendRow, type ModelTurnArgs, type ModelTurnResult, type ObservedTurnFrames, type OfferMemoriesInput, type OutputGateMode, type OutputGateResult, OutputProcessor, type OverriddenMemory, PageContext, type Passage, type PendingApprovalRow, ProcessedPrompt, ProcessorContext, PromptBuilder, PromptContributor, QueuePause, QueuedMessage, QueuedMessagePatch, type QuotaBlock, QuotaExceededError, type QuotaPeriod, type QuotaProvider, type QuotaQuery, type QuotaReport, QuotaState, type QuotaStore, type QuotaWarning, type QuotaWindow, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, REQUESTER_APPROVER, type RecentRunRow, RecordRunStartInput, RecordToolCallInput, RecordUsageInput, type RememberToolInput, type RerankOptions, type Reranker, type ResolveAttachmentInput, type ResolveMemoryDigestInput, type ResolvedDelegation, type RetrieveOptions, type Retriever, type RolesPolicy, type RunAgentBreakdownRow, RunCancelledError, type RunErrorBreakdownRow, type RunMetrics, type RunToolCallRow, type RunTrendPoint, type RunWhere, SKILL_TOOL_DESCRIPTION, SKILL_TOOL_NAME, type ScopeContext, type ScopeResolver, type SearchMemoriesInput, type SettledTask, type SinkWriter, type Skill, type SkillAuthor, type SkillCatalogEntry, type SkillContext, type SkillLoadOutcome, type SkillOffer, type SkillProvider, type SkillSummary, type SkillToolInput, type SkillWriteRequest, type SkillWriteVerdict, type SkillsConfig, type StageAttachmentInput, type StagedAttachment, type StoreMemoryInput, StoredMessage, type StreamError, type StructuredOutcome, StructuredOutputError, THREAD_DETAIL_CONTENT_CHARS, type ThreadActivityRow, ThreadDetail, type ThreadMessageRow, type ThreadMeta, type ThreadSpendRow, ThreadSummary, type ThreadUsageRollup, type ThreadWhere, type TokenStreamSink, type ToolCallActivityRow, ToolCallApproval, type ToolCallApprovalColumns, ToolCallApprovalState, ToolCallRequest, ToolCallStatus, type ToolCallWhere, ToolDefinition, ToolDescribeScope, ToolDisabledError, ToolForbiddenError, ToolHandler, ToolInputInvalidError, ToolKind, type ToolKindDeps, ToolNotFoundError, ToolRegistry, ToolResult, ToolSpec, type ToolStatRow, ToolStepEnvelope, ToolTransientRetrySetting, type TurnFrameSummary, type UiCollector, UpdateThreadInput, UpdateToolCallInput, type UsageTrendPoint, type WindowHistoryOptions, type WithMemoryToolInput, type WriteMemoryInput, actorScope, agentDiagnosticKey, agentFailureCode, bucketByActor, bucketByModel, bucketByThread, bucketUsageTrend, buildMemoryBlock, buildSkillsBlock, canActorUseTool, compositeSkillProvider, createFrameBuffer, createIncrementalGate, createNoopEmitUi, createUiCollector, dayBoundsUtc, defaultCanDecide, defaultScopeResolver, detachedDelivered, detachedStarted, detachedUnsettled, estimateCost, estimateMessageTokens, exhaustedWindow, extractJson, filterToolsByAllowList, filterToolsByCanUse, filterToolsByEnabled, filterToolsByRole, findCatalogModel, gateFollowUps, gateTail, isControlFlowSignal, isReplayIntegrityError, isToolEnabled, loadSkill, mayDecideApproval, memoryForgetVerdict, memoryWriteVerdict, mergeUi, normalizeDelegation, observeTurnFrames, offerMemories, offerSkills, publishAgentDelegated, publishAgentMemoryResolved, publishAgentMemoryWritten, publishAgentMessage, publishAgentQuotaExceeded, publishAgentRetrieved, publishAgentRunFailed, publishAgentRunFinished, publishAgentRunStarted, publishAgentSkillsResolved, publishAgentToolCall, publishAgentToolRetry, quotaPeriodRange, quotaUsedRatio, quotaWarning, releaseGatedFrames, rememberInputSchema, rememberToolDefinition, repairInstruction, resolveGateLookback, resolveMemoryDigest, resolveOutputGateMode, resolveSkillCatalog, rollupThreadUsage, runAgentLoop, runInputProcessors, runOutputProcessors, seedModelPrices, settleAll, settleUnsettledDelegation, skillInputSchema, skillToolDefinition, skillWriteVerdict, stampToolKinds, staticModelCatalog, staticSkillProvider, summarizeWithModel, tenantScope, toolCallApprovalFromRow, traceLlmTurn, traceToolExecution, truncateDetailContent, unwrapToolStepOutput, validateStructured, windowHistory, withAskTool, withMemoryTool, withSelectedModel, withSkillTool, withToolTimeout, withTurnFrames, wrapToolStepOutput, writeMemory };
+export { AGENT_ACTOR_DIRECTORY, AGENT_ACTOR_RESOLVER, AGENT_APPROVAL_PORT, AGENT_ATTACHMENT_STAGING, AGENT_DEPS_FACTORY, AGENT_DIAGNOSTIC_EVENTS, AGENT_DURABLE_RUNNER, AGENT_EMBEDDING_PROVIDER, AGENT_GOVERNANCE_QUERIES, AGENT_MEMORY, AGENT_MODEL, AGENT_MODEL_CATALOG, AGENT_OPTIONS, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, AGENT_QUOTA_PROVIDER, AGENT_QUOTA_STORE, AGENT_REGISTRY, AGENT_RETRIEVER, AGENT_ROLES_POLICY, AGENT_RUNNER, AGENT_SINK, AGENT_SKILLS, AGENT_SKILL_SOURCES, AGENT_SPAN_EVENTS, AGENT_STORE, AGENT_TOOL_REGISTRY, APPROVAL_EXPIRED_REASON, Actor, type ActorDirectory, type ActorResolver, type ActorSpendRow, type AgentApprovalPort, AgentDefinition, type AgentDelegated, AgentDelegation, type AgentDiagnosticEvent, type AgentDiagnosticKey, type AgentFollowUpsSpan, type AgentGovernanceQueries, AgentIntake, type AgentLlmTurnSpan, type AgentLoopDeps, type AgentLoopHooks, type AgentLoopResult, type AgentMemoryResolved, type AgentMemoryWritten, type AgentMessageEvent, type AgentPricingStore, type AgentQuotaExceeded, AgentRegistry, type AgentRetrievalSpan, type AgentRetrieved, type AgentRunFailed, type AgentRunFinished, AgentRunInput, type AgentRunStartOptions, type AgentRunStarted, type AgentRunner, type AgentSkillsResolved, type AgentSpanEvent, AgentStore, AgentStreamError, AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, AppendMessageInput, type ApprovalDecisionRef, type ApprovalPolicy, type ApprovalRequirement, type ApprovalThreadRef, type ApprovalToolRef, type ApprovalWhere, type AttachmentRef, type AttachmentStagingDescription, type AttachmentStagingStore, type BufferedModelTurnResult, type BuildMemoryBlockInput, ChatQueueStore, type CostUsage, CreateThreadInput, type CurrentModelPrice, DEFAULT_HISTORY_SUMMARY_INSTRUCTION, DEFAULT_MAX_FACT_CHARS, DEFAULT_MAX_MEMORIES, DEFAULT_MAX_SKILLS, DEFAULT_REFUSAL_REASON, DEFAULT_STRUCTURED_OUTPUT_INSTRUCTION, Decision, DefaultApprovalPolicy, DefaultRolesPolicy, type DetachedDelegationOutcome, type DetachedDelegationReceipt, DetachedDelivery, type DetailThreadRef, ElicitationRequest, type EmbeddingProvider, type EmitUi, EnqueueMessageInput, type ForgetMemoryInput, type FrameBuffer, GLOBAL_SCOPE, type GovernanceMessageRow, type GovernancePage, type GovernancePageQuery, type GovernancePendingApprovalRow, type GovernanceRange, type GovernanceRunDetail, type GovernanceRunRow, type GovernanceThreadDetail, type GovernanceThreadDetailQuery, type GovernanceThreadRow, type GovernanceToolCallRow, type GovernanceUsageInput, type GovernanceUsageRow, HistoryPolicy, HumanReply, InMemoryAgentStore, type IncrementalGate, InputProcessor, type ListMemoriesInput, type ListSkillsInput, type ListStagedAttachmentsInput, LlmStepEnvelope, type LoadSkillInput, type MemoryAuthor, type MemoryConfig, type MemoryDigest, type MemoryDigestEntry, type MemoryFact, type MemoryForgetRequest, type MemoryOrigin, type MemoryProvider, type MemoryRecord, type MemoryVerdict, type MemoryWriteOutcome, type MemoryWriteRequest, MessageAttachment, MessageFeedback, MessageUsage, ModelAnswer, type ModelCatalog, type ModelCatalogEntry, type ModelCatalogLock, type ModelCatalogProviderGroup, type ModelCatalogQuery, type ModelCatalogView, ModelMessage, type ModelPrice, type ModelPriceInput, type ModelProvider, type ModelSpendRow, type ModelTurnArgs, type ModelTurnResult, type ObservedTurnFrames, type OfferMemoriesInput, type OutputGateMode, type OutputGateResult, OutputProcessor, type OverriddenMemory, PageContext, type Passage, type PendingApprovalRow, ProcessedPrompt, ProcessorContext, PromptBuilder, PromptContributor, QueuePause, QueuedMessage, QueuedMessagePatch, type QuotaBlock, QuotaExceededError, type QuotaPeriod, type QuotaProvider, type QuotaQuery, type QuotaReport, QuotaState, type QuotaStore, type QuotaWarning, type QuotaWindow, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, REQUESTER_APPROVER, RUN_FAILED_MESSAGE, RUN_NOT_ACTIVE_CODE, RUN_NOT_ACTIVE_MESSAGE, RUN_NO_LONGER_RUNNING, type RecentRunRow, RecordRunStartInput, RecordToolCallInput, RecordUsageInput, type RememberToolInput, type RerankOptions, type Reranker, type ResolveAttachmentInput, type ResolveMemoryDigestInput, type ResolvedDelegation, type RetrieveOptions, type Retriever, type RolesPolicy, type RunAgentBreakdownRow, RunCancelledError, type RunErrorBreakdownRow, type RunMetrics, type RunToolCallRow, type RunTrendPoint, type RunWhere, SKILL_TOOL_DESCRIPTION, SKILL_TOOL_NAME, type ScopeContext, type ScopeResolver, type SearchMemoriesInput, type SettleDeadRunInput, type SettledTask, type SinkWriter, type Skill, type SkillAuthor, type SkillCatalogEntry, type SkillContext, type SkillLoadOutcome, type SkillOffer, type SkillProvider, type SkillSummary, type SkillToolInput, type SkillWriteRequest, type SkillWriteVerdict, type SkillsConfig, type StageAttachmentInput, type StagedAttachment, type StoreMemoryInput, StoredMessage, type StreamError, type StructuredOutcome, StructuredOutputError, THREAD_DETAIL_CONTENT_CHARS, type ThreadActivityRow, ThreadDetail, type ThreadMessageRow, type ThreadMeta, type ThreadSpendRow, ThreadSummary, type ThreadUsageRollup, type ThreadWhere, type TokenStreamSink, type ToolCallActivityRow, ToolCallApproval, type ToolCallApprovalColumns, ToolCallApprovalState, ToolCallOutcome, ToolCallRequest, ToolCallStatus, type ToolCallWhere, ToolDefinition, ToolDescribeScope, ToolDisabledError, ToolForbiddenError, ToolHandler, ToolInputInvalidError, ToolKind, type ToolKindDeps, ToolNotFoundError, ToolRegistry, ToolResult, ToolSpec, type ToolStatRow, ToolStepEnvelope, ToolTransientRetrySetting, type TurnFrameSummary, type UiCollector, UpdateThreadInput, UpdateToolCallInput, type UsageTrendPoint, type WindowHistoryOptions, type WithMemoryToolInput, type WriteMemoryInput, actorScope, agentDiagnosticKey, agentFailureCode, bucketByActor, bucketByModel, bucketByThread, bucketUsageTrend, buildMemoryBlock, buildSkillsBlock, canActorUseTool, compositeSkillProvider, createFrameBuffer, createIncrementalGate, createNoopEmitUi, createUiCollector, dayBoundsUtc, defaultCanDecide, defaultScopeResolver, detachedDelivered, detachedStarted, detachedUnsettled, estimateCost, estimateMessageTokens, exhaustedWindow, exposeStreamErrorDetails, extractJson, filterToolsByAllowList, filterToolsByCanUse, filterToolsByEnabled, filterToolsByRole, findCatalogModel, gateFollowUps, gateTail, isControlFlowSignal, isReplayIntegrityError, isToolEnabled, loadSkill, mayDecideApproval, memoryForgetVerdict, memoryWriteVerdict, mergeUi, normalizeDelegation, observeTurnFrames, offerMemories, offerSkills, publishAgentDelegated, publishAgentMemoryResolved, publishAgentMemoryWritten, publishAgentMessage, publishAgentQuotaExceeded, publishAgentRetrieved, publishAgentRunFailed, publishAgentRunFinished, publishAgentRunStarted, publishAgentSkillsResolved, publishAgentToolCall, publishAgentToolRetry, quotaPeriodRange, quotaUsedRatio, quotaWarning, releaseGatedFrames, rememberInputSchema, rememberToolDefinition, repairInstruction, resolveGateLookback, resolveMemoryDigest, resolveOutputGateMode, resolveSkillCatalog, rollupThreadUsage, runAgentLoop, runInputProcessors, runOutputProcessors, seedModelPrices, settleAll, settleDeadRun, settleUnsettledDelegation, skillInputSchema, skillToolDefinition, skillWriteVerdict, stampToolKinds, staticModelCatalog, staticSkillProvider, streamFailure, summarizeWithModel, tenantScope, toolCallApprovalFromRow, toolCallContext, traceLlmTurn, traceToolExecution, truncateDetailContent, unwrapToolStepOutput, validateStructured, windowHistory, withAskTool, withMemoryTool, withSelectedModel, withSkillTool, withToolTimeout, withTurnFrames, wrapToolStepOutput, writeMemory };

package/dist/index.js

@@ -2348,6 +2348,123 @@ function isControlFlowSignal(error) {
 }
 __name(isControlFlowSignal, "isControlFlowSignal");
 
+// src/dangling-tool-calls.ts
+var UNFINISHED_TOOL_CALL = "This tool call was never completed: the turn it belonged to ended unexpectedly before it was settled. Do not assume it ran, and do not assume it did not \u2014 check the current state with a read tool if one exists, tell the person plainly what is and is not confirmed, and do it again only if they still want it.";
+var RUN_ENDED_BEFORE_TOOL_CALL = "the run ended before this tool call was settled";
+var DECLINED = "The person was asked to approve this action and declined it. Nothing ran and nothing changed.";
+var EXPIRED = "This action needed approval, and the request expired before anyone decided. Nothing ran.";
+function danglingToolCallIds(messages) {
+  const ids = [];
+  for (const message of messages) {
+    const calls = message.toolCalls ?? [];
+    if (message.role !== "assistant" || calls.length === 0) {
+      continue;
+    }
+    const settled = new Set((message.toolResults ?? []).map((result) => result.id));
+    for (const call of calls) {
+      if (!settled.has(call.id)) {
+        ids.push(call.id);
+      }
+    }
+  }
+  return ids;
+}
+__name(danglingToolCallIds, "danglingToolCallIds");
+function resultFor(call, outcome) {
+  const base = {
+    id: call.id,
+    name: call.name
+  };
+  switch (outcome?.status) {
+    case "executed":
+    case "auto_executed":
+      return {
+        ...base,
+        output: outcome.output ?? null
+      };
+    case "failed":
+      return {
+        ...base,
+        output: null,
+        error: outcome.error ?? UNFINISHED_TOOL_CALL
+      };
+    case "rejected":
+      return {
+        ...base,
+        output: {
+          rejected: true
+        },
+        denied: true,
+        error: DECLINED
+      };
+    case "expired":
+      return {
+        ...base,
+        output: {
+          rejected: true,
+          expired: true
+        },
+        denied: true,
+        expired: true,
+        error: EXPIRED
+      };
+    default:
+      return {
+        ...base,
+        output: null,
+        error: UNFINISHED_TOOL_CALL
+      };
+  }
+}
+__name(resultFor, "resultFor");
+function settleDanglingToolCalls(messages, outcomes = []) {
+  const known = new Map(outcomes.map((outcome) => [
+    outcome.id,
+    outcome
+  ]));
+  return messages.map((message) => {
+    const calls = message.toolCalls ?? [];
+    if (message.role !== "assistant" || calls.length === 0) {
+      return message;
+    }
+    const results = message.toolResults ?? [];
+    const settled = new Set(results.map((result) => result.id));
+    const missing = calls.filter((call) => !settled.has(call.id));
+    if (missing.length === 0) {
+      return message;
+    }
+    return {
+      ...message,
+      toolResults: [
+        ...results,
+        ...missing.map((call) => resultFor(call, known.get(call.id)))
+      ]
+    };
+  });
+}
+__name(settleDanglingToolCalls, "settleDanglingToolCalls");
+
+// src/dead-run.ts
+var RUN_NOT_ACTIVE_CODE = "run_not_active";
+var RUN_NOT_ACTIVE_MESSAGE = "This request is no longer waiting for an answer: the turn it belonged to has ended. Send the message again.";
+var RUN_NO_LONGER_RUNNING = "the run is no longer running";
+async function settleDeadRun(store, input) {
+  const failure = input.failure;
+  if (failure !== void 0) {
+    await Promise.resolve(store.recordRunEnd?.({
+      runId: input.runId,
+      status: "failed",
+      errorCode: failure.code,
+      errorMessage: failure.message
+    })).catch(() => void 0);
+  }
+  await Promise.resolve(store.failUnsettledToolCalls?.(input.runId, RUN_ENDED_BEFORE_TOOL_CALL)).catch(() => 0);
+  if (input.threadId !== void 0) {
+    await releaseThreadRun(store, input.threadId, input.runId).catch(() => void 0);
+  }
+}
+__name(settleDeadRun, "settleDeadRun");
+
 // src/delegation.ts
 function normalizeDelegation(entry) {
   return typeof entry === "string" ? {
@@ -2812,9 +2929,46 @@ function agentFailureCode(error) {
   if (error instanceof StructuredOutputError) {
     return "structured_output_invalid";
   }
-  return "run_failed";
+  if (isReplayIntegrityError(error)) {
+    return "replay_diverged";
+  }
+  return isNoOutputError(error) ? "model_no_output" : "run_failed";
 }
 __name(agentFailureCode, "agentFailureCode");
+function isNoOutputError(error) {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+  return error.name === "AI_NoOutputGeneratedError" || error.name === "NoOutputGeneratedError" || error.message.startsWith("No output generated");
+}
+__name(isNoOutputError, "isNoOutputError");
+var RUN_FAILED_MESSAGE = "The assistant could not finish this answer. Please try again.";
+var streamErrorDetails;
+function exposeStreamErrorDetails(expose) {
+  streamErrorDetails = expose;
+}
+__name(exposeStreamErrorDetails, "exposeStreamErrorDetails");
+var WORDED_CODES = /* @__PURE__ */ new Set([
+  "quota_exceeded",
+  "output_rejected",
+  "structured_output_invalid"
+]);
+function streamFailure(error) {
+  const detail = error instanceof Error ? error.message : String(error);
+  const code = agentFailureCode(error);
+  if (WORDED_CODES.has(code)) {
+    return {
+      code,
+      message: detail
+    };
+  }
+  const exposed = streamErrorDetails ?? process.env.NODE_ENV !== "production";
+  return {
+    code,
+    message: exposed ? detail : RUN_FAILED_MESSAGE
+  };
+}
+__name(streamFailure, "streamFailure");
 var MAX_DELEGATION_DEPTH = 5;
 var DEFAULT_MAX_AGENT_APPEARANCES = 1;
 function delegationRefusal(args) {
@@ -3006,9 +3160,9 @@ function splitHistory(policy, input, messages) {
 }
 __name(splitHistory, "splitHistory");
 async function loadSelectedHistory(deps, input, hooks) {
-  return hooks.step("load:thread", async () => {
+  const recorded = await hooks.step("load:thread", async () => {
     const thread = await readThreadForTurn(deps, input.threadId);
-    const { keep, drop } = splitHistory(deps.historyPolicy, input, toModelMessages(thread.messages));
+    const { keep, drop } = splitHistory(deps.historyPolicy, input, await settleHistory(deps, toModelMessages(thread.messages)));
     return {
       messages: keep,
       dropped: deps.historyPolicy?.summarize === void 0 ? [] : drop,
@@ -3016,8 +3170,21 @@ async function loadSelectedHistory(deps, input, hooks) {
       hasAssistantMessage: thread.hasAssistantMessage
     };
   });
+  return {
+    ...recorded,
+    messages: settleDanglingToolCalls(recorded.messages)
+  };
 }
 __name(loadSelectedHistory, "loadSelectedHistory");
+async function settleHistory(deps, messages) {
+  const dangling = danglingToolCallIds(messages);
+  if (dangling.length === 0) {
+    return messages;
+  }
+  const outcomes = await Promise.resolve(deps.store.toolCallOutcomes?.(dangling) ?? []).catch(() => []);
+  return settleDanglingToolCalls(messages, outcomes);
+}
+__name(settleHistory, "settleHistory");
 async function readThreadForTurn(deps, threadId) {
   const windowing = deps.store;
   if (typeof windowing.loadThreadForTurn === "function") {
@@ -3057,7 +3224,7 @@ __name(turnMessageLimit, "turnMessageLimit");
 async function loadWholeThread(deps, input, hooks) {
   const thread = await hooks.step("load:thread", () => deps.store.getThread(input.threadId));
   const stored = thread?.messages ?? [];
-  const { keep, drop } = splitHistory(deps.historyPolicy, input, toModelMessages(stored));
+  const { keep, drop } = splitHistory(deps.historyPolicy, input, settleDanglingToolCalls(toModelMessages(stored)));
   return {
     messages: keep,
     dropped: drop,
@@ -3240,6 +3407,14 @@ async function awaitElicitation(hooks, request, ctx) {
   }, ctx));
 }
 __name(awaitElicitation, "awaitElicitation");
+function toolCallContext(ctx, toolCallId) {
+  return {
+    ...ctx,
+    toolCallId,
+    idempotencyKey: `${ctx.runId}:${toolCallId}`
+  };
+}
+__name(toolCallContext, "toolCallContext");
 function toolContext(deps, input, hooks) {
   return {
     actor: input.actor,
@@ -3679,7 +3854,7 @@ async function invokeClaimedTool(turn, claimed) {
         }, () => invokeWithTransientRetry(() => {
           ui2.restart();
           return deps.registry.invoke(call.name, call.input, {
-            ...ctx,
+            ...toolCallContext(ctx, call.id),
             emitUi: ui2.emit
           }, deps.rolesPolicy);
         }, deps.toolTransientRetry ?? {}, {
@@ -5277,6 +5452,36 @@ var InMemoryAgentStore = class {
       } : {}
     });
   }
+  async toolCallOutcomes(toolCallIds) {
+    const outcomes = [];
+    for (const id of toolCallIds) {
+      const row = this.toolCalls.get(id);
+      if (row !== void 0) {
+        outcomes.push({
+          id,
+          status: row.status,
+          ...row.output !== void 0 ? {
+            output: row.output
+          } : {},
+          ...row.error !== void 0 ? {
+            error: row.error
+          } : {}
+        });
+      }
+    }
+    return outcomes;
+  }
+  async failUnsettledToolCalls(runId, error) {
+    let settled = 0;
+    for (const row of this.toolCalls.values()) {
+      if (row.runId === runId && row.status === "pending_approval") {
+        row.status = "failed";
+        row.error = error;
+        settled += 1;
+      }
+    }
+    return settled;
+  }
   async updateToolCall(input) {
     const row = this.toolCalls.get(input.toolCallId);
     if (row === void 0) {
@@ -5603,6 +5808,11 @@ export {
   REMEMBER_TOOL_DESCRIPTION,
   REMEMBER_TOOL_NAME,
   REQUESTER_APPROVER,
+  RUN_ENDED_BEFORE_TOOL_CALL,
+  RUN_FAILED_MESSAGE,
+  RUN_NOT_ACTIVE_CODE,
+  RUN_NOT_ACTIVE_MESSAGE,
+  RUN_NO_LONGER_RUNNING,
   RunCancelledError,
   SKILL_TOOL_DESCRIPTION,
   SKILL_TOOL_NAME,
@@ -5613,6 +5823,7 @@ export {
   ToolInputInvalidError,
   ToolNotFoundError,
   ToolRegistry,
+  UNFINISHED_TOOL_CALL,
   actorScope,
   agentDiagnosticKey,
   agentFailureCode,
@@ -5630,6 +5841,7 @@ export {
   createIncrementalGate,
   createNoopEmitUi,
   createUiCollector,
+  danglingToolCallIds,
   dayBoundsUtc,
   decodeStreamEvent,
   defaultCanDecide,
@@ -5641,6 +5853,7 @@ export {
   estimateCost,
   estimateMessageTokens,
   exhaustedWindow,
+  exposeStreamErrorDetails,
   extractJson,
   filterToolsByAllowList,
   filterToolsByCanUse,
@@ -5703,6 +5916,8 @@ export {
   runOutputProcessors,
   seedModelPrices,
   settleAll,
+  settleDanglingToolCalls,
+  settleDeadRun,
   settleElicitation,
   settleUnsettledDelegation,
   skillInputSchema,
@@ -5711,9 +5926,11 @@ export {
   stampToolKinds,
   staticModelCatalog,
   staticSkillProvider,
+  streamFailure,
   summarizeWithModel,
   tenantScope,
   toolCallApprovalFromRow,
+  toolCallContext,
   traceLlmTurn,
   traceToolExecution,
   truncateDetailContent,