@dudousxd/nestjs-agent-core 0.29.0 → 0.30.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, i as ThreadSummary, j as ThreadDetail, S as StoredMessage, k as ToolResult, l as MessageAttachment, m as MessageFeedback, n as ToolCallStatus, U as UsagePurpose, T as ToolSpec, Q as QuotaState, o as AgentRunInput, H as HumanReply, p as ToolKind, q as ToolCallApproval, a as ToolHandler, r as HistoryPolicy, P as PageContext, s as AgentDefinition, t as AgentDelegation, D as DetachedDelivery, u as ToolDescribeScope, v as PromptBuilder, w as PromptContributor, x as ToolTransientRetrySetting, y as AgentIntake, z as Decision, E as ElicitationRequest, L as LlmStepEnvelope, B as ToolStepEnvelope } from './tool-CON4ZOrD.cjs';
-export { C as ASK_TOOL_DESCRIPTION, F as ASK_TOOL_NAME, G as AgentApprovalRequest, I as AgentApprovalSettlement, J as AgentAttachmentConfig, K as AgentCatalogEntry, N as AgentClientConfig, O as AgentHistoryWindow, R as AskToolInput, V as DEFAULT_INTAKE_PREAMBLE, W as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, X as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, Y as ELICITATION_INPUT_TYPES, Z as ElicitationInput, _ as ElicitationInputType, $ as ElicitationOption, a0 as ElicitationOutcome, a1 as ElicitationQuestion, a2 as ElicitationReply, a3 as ElicitationResult, a4 as HistoryPolicyContext, a5 as HistorySelection, a6 as HistorySummary, a7 as InvokeWithTransientRetryOptions, a8 as MAX_ASK_QUESTIONS, a9 as MessageFeedbackValue, aa as MessageRole, ab as PromptContext, ac as QuotaView, ad as ToolCallApprovalStatus, ae as ToolCatalogEntry, af as ToolConfirmation, ag as ToolDescription, b as ToolPresentation, ah as ToolPresentationTone, ai as ToolResultField, aj as ToolResultView, ak as ToolStepCtx, al as ToolTransientRetryNumbers, am as ToolTransientRetryOptions, an as askInputSchema, ao as askToolDefinition, ap as decodeStreamEvent, aq as encodeStreamEvent, ar as invokeWithTransientRetry, as as isTransientToolError, at as isTypedQuestion, au as normalizeElicitationReply, av as questionOptions, aw as readElicitationInput, ax as readElicitationQuestions, ay as renderElicitationAnswers, az as resolveElicitation, aA as resolveToolTransientRetryNumbers, aB as settleElicitation, aC as validateElicitationAnswer, aD as validateElicitationValue } from './tool-CON4ZOrD.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, i as ThreadSummary, j as ThreadDetail, S as StoredMessage, k as ToolResult, l as MessageAttachment, m as MessageFeedback, n as ToolCallStatus, U as UsagePurpose, T as ToolSpec, Q as QuotaState, o as AgentRunInput, H as HumanReply, p as ToolKind, q as ToolCallApproval, a as ToolHandler, r as HistoryPolicy, P as PageContext, s as AgentDefinition, t as AgentDelegation, D as DetachedDelivery, u as ToolDescribeScope, v as PromptBuilder, w as PromptContributor, x as ToolTransientRetrySetting, y as AgentIntake, z as Decision, E as ElicitationRequest, L as LlmStepEnvelope, B as ToolStepEnvelope } from './tool-CfnSyIQf.cjs';
+export { C as ASK_TOOL_DESCRIPTION, F as ASK_TOOL_NAME, G as AgentApprovalRequest, I as AgentApprovalSettlement, J as AgentAttachmentConfig, K as AgentCatalogEntry, N as AgentClientConfig, O as AgentHistoryWindow, R as AskToolInput, V as DEFAULT_INTAKE_PREAMBLE, W as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, X as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, Y as ELICITATION_INPUT_TYPES, Z as ElicitationInput, _ as ElicitationInputType, $ as ElicitationOption, a0 as ElicitationOutcome, a1 as ElicitationQuestion, a2 as ElicitationReply, a3 as ElicitationResult, a4 as HistoryPolicyContext, a5 as HistorySelection, a6 as HistorySummary, a7 as InvokeWithTransientRetryOptions, a8 as MAX_ASK_QUESTIONS, a9 as MessageFeedbackValue, aa as MessageRole, ab as PromptContext, ac as QuotaView, ad as ToolCallApprovalStatus, ae as ToolCatalogEntry, af as ToolConfirmation, ag as ToolDescription, b as ToolPresentation, ah as ToolPresentationTone, ai as ToolResultField, aj as ToolResultView, ak as ToolStepCtx, al as ToolTransientRetryNumbers, am as ToolTransientRetryOptions, an as askInputSchema, ao as askToolDefinition, ap as decodeStreamEvent, aq as encodeStreamEvent, ar as invokeWithTransientRetry, as as isTransientToolError, at as isTypedQuestion, au as normalizeElicitationReply, av as questionOptions, aw as readElicitationInput, ax as readElicitationQuestions, ay as renderElicitationAnswers, az as resolveElicitation, aA as resolveToolTransientRetryNumbers, aB as settleElicitation, aC as validateElicitationAnswer, aD as validateElicitationValue } from './tool-CfnSyIQf.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-3FixaBnr.cjs';
-export { D as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, b as IncrementalGating, c as OutputRejectedError, d as OutputVerdict, e as ProcessorFailedError } from './processors-3FixaBnr.cjs';
+import { O as OutputProcessor, P as ProcessorContext, I as InputProcessor, a as ProcessedPrompt, M as ModelAnswer } from './processors-DdwZ0NFG.cjs';
+export { D as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, b as IncrementalGating, c as OutputRejectedError, d as OutputVerdict, e as ProcessorFailedError } from './processors-DdwZ0NFG.cjs';
 import { ChannelRegistry } from '@dudousxd/nestjs-diagnostics';
 
 /**
@@ -244,9 +244,22 @@ interface ModelCatalogProviderGroup {
     label: string;
     models: ModelCatalogEntry[];
 }
+/** The agent always runs on one model: the picker shows it and offers no choice. */
+interface ModelCatalogLock {
+    /** The catalog id every turn runs on. */
+    model: string;
+    /** Why, in words a picker can show ("This assistant always uses GPT-5"). */
+    reason?: string;
+}
 /** What `GET <base>/models` answers. */
 interface ModelCatalogView {
     providers: ModelCatalogProviderGroup[];
+    /**
+     * Present when the agent is locked to one model. Every turn runs on `locked.model` — a send's own
+     * `model` and a thread's pin included — and a send naming another model is refused (`400`). List
+     * the other models as unavailable too, so an older client that ignores the lock cannot pick them.
+     */
+    locked?: ModelCatalogLock;
     /** The model a turn runs on when nobody picked one; `null` when the provider decides. */
     default: string | null;
 }
@@ -692,7 +705,11 @@ type QuotaPeriod = 'day' | 'month';
 /** One budget window: what was spent in it, and the ceiling when there is one. */
 interface QuotaWindow {
     period: QuotaPeriod;
-    usedTokens: number;
+    /**
+     * Tokens used in the window. Absent → the budget does not count tokens (a USD-only spend cap, such
+     * as an AI gateway's) — never a fabricated `0`.
+     */
+    usedTokens?: number;
     /** Absent → no token ceiling on this window. */
     limitTokens?: number;
     usedUsd: number;
@@ -700,6 +717,11 @@ interface QuotaWindow {
     limitUsd?: number;
     /** ISO-8601 instant the window starts over (next UTC midnight, first of next month). */
     resetsAt?: string;
+    /**
+     * The soft limit: the share of a ceiling (`0..1`, e.g. `0.8`) past which a client should warn
+     * that the budget is running out. Absent → no warning for this window.
+     */
+    warnAt?: number;
 }
 /** Which window stopped the actor, when one did. */
 interface QuotaBlock {
@@ -707,11 +729,24 @@ interface QuotaBlock {
     /** Words a client can show ("Monthly AI budget reached"). */
     reason?: string;
 }
+/** A window past its soft limit ({@link QuotaWindow.warnAt}) but not exhausted. */
+interface QuotaWarning {
+    period: QuotaPeriod;
+    /** How much of the window's ceiling is used, `0..1` (the larger of spend and tokens). */
+    ratio: number;
+    /** Words a client can show ("80% of your monthly AI budget used"). */
+    reason?: string;
+}
 /** What `GET <base>/quota` answers. */
 interface QuotaReport {
     windows: QuotaWindow[];
     /** Present when a window is exhausted — a send will be refused until it resets. */
     blocked?: QuotaBlock;
+    /**
+     * Present when a window crossed its `warnAt` and none is exhausted — the fullest one. A client
+     * may also derive it from the windows ({@link quotaWarning}); the server's wins.
+     */
+    warning?: QuotaWarning;
 }
 interface QuotaQuery {
     actor: Actor;
@@ -731,6 +766,13 @@ interface QuotaProvider {
 }
 /** The first window whose token or spend ceiling is reached, as a {@link QuotaBlock}. */
 declare function exhaustedWindow(windows: readonly QuotaWindow[]): QuotaBlock | undefined;
+/** How much of `window`'s ceilings is used, `0..1+` (the larger of spend and tokens), or `null`. */
+declare function quotaUsedRatio(window: QuotaWindow): number | null;
+/**
+ * The fullest window past its `warnAt`, as a {@link QuotaWarning} — `undefined` when none is, or
+ * when one is exhausted (that is `blocked`, not a warning).
+ */
+declare function quotaWarning(windows: readonly QuotaWindow[]): QuotaWarning | undefined;
 /** The UTC day range (`YYYY-MM-DD`, inclusive) and reset instant of `period` around `now`. */
 declare function quotaPeriodRange(period: QuotaPeriod, now: Date): {
     fromDay: string;
@@ -3702,4 +3744,4 @@ declare class InMemoryAgentStore implements AgentStore {
     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 AgentRunStarted, type AgentRunner, type AgentSkillsResolved, type AgentSpanEvent, type AgentStore, AgentStreamError, AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, type AppendMessageInput, type ApprovalDecisionRef, type ApprovalPolicy, type ApprovalRequirement, type ApprovalThreadRef, type ApprovalToolRef, type ApprovalWhere, type AttachmentRef, type AttachmentStagingDescription, type AttachmentStagingStore, type BufferedModelTurnResult, type BuildMemoryBlockInput, type CostUsage, type 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, 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 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, type QuotaBlock, QuotaExceededError, type QuotaPeriod, type QuotaProvider, type QuotaQuery, type QuotaReport, QuotaState, type QuotaStore, type QuotaWindow, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, REQUESTER_APPROVER, type RecentRunRow, type RecordRunEndInput, type RecordRunStartInput, type RecordToolCallInput, type 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 ThreadTurnPage, type ThreadTurnQuery, type ThreadTurnReader, type ThreadUsageRollup, type ThreadWhere, type TokenStreamSink, type ToolCallActivityRow, ToolCallApproval, type ToolCallApprovalColumns, type 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, type UpdateThreadInput, type UpdateToolCallInput, UsagePurpose, 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, 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 AgentRunStarted, type AgentRunner, type AgentSkillsResolved, type AgentSpanEvent, type AgentStore, AgentStreamError, AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, type AppendMessageInput, type ApprovalDecisionRef, type ApprovalPolicy, type ApprovalRequirement, type ApprovalThreadRef, type ApprovalToolRef, type ApprovalWhere, type AttachmentRef, type AttachmentStagingDescription, type AttachmentStagingStore, type BufferedModelTurnResult, type BuildMemoryBlockInput, type CostUsage, type 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, 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, 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, type RecordRunEndInput, type RecordRunStartInput, type RecordToolCallInput, type 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 ThreadTurnPage, type ThreadTurnQuery, type ThreadTurnReader, type ThreadUsageRollup, type ThreadWhere, type TokenStreamSink, type ToolCallActivityRow, ToolCallApproval, type ToolCallApprovalColumns, type 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, type UpdateThreadInput, type UpdateToolCallInput, UsagePurpose, 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 };

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, i as ThreadSummary, j as ThreadDetail, S as StoredMessage, k as ToolResult, l as MessageAttachment, m as MessageFeedback, n as ToolCallStatus, U as UsagePurpose, T as ToolSpec, Q as QuotaState, o as AgentRunInput, H as HumanReply, p as ToolKind, q as ToolCallApproval, a as ToolHandler, r as HistoryPolicy, P as PageContext, s as AgentDefinition, t as AgentDelegation, D as DetachedDelivery, u as ToolDescribeScope, v as PromptBuilder, w as PromptContributor, x as ToolTransientRetrySetting, y as AgentIntake, z as Decision, E as ElicitationRequest, L as LlmStepEnvelope, B as ToolStepEnvelope } from './tool-CON4ZOrD.js';
-export { C as ASK_TOOL_DESCRIPTION, F as ASK_TOOL_NAME, G as AgentApprovalRequest, I as AgentApprovalSettlement, J as AgentAttachmentConfig, K as AgentCatalogEntry, N as AgentClientConfig, O as AgentHistoryWindow, R as AskToolInput, V as DEFAULT_INTAKE_PREAMBLE, W as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, X as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, Y as ELICITATION_INPUT_TYPES, Z as ElicitationInput, _ as ElicitationInputType, $ as ElicitationOption, a0 as ElicitationOutcome, a1 as ElicitationQuestion, a2 as ElicitationReply, a3 as ElicitationResult, a4 as HistoryPolicyContext, a5 as HistorySelection, a6 as HistorySummary, a7 as InvokeWithTransientRetryOptions, a8 as MAX_ASK_QUESTIONS, a9 as MessageFeedbackValue, aa as MessageRole, ab as PromptContext, ac as QuotaView, ad as ToolCallApprovalStatus, ae as ToolCatalogEntry, af as ToolConfirmation, ag as ToolDescription, b as ToolPresentation, ah as ToolPresentationTone, ai as ToolResultField, aj as ToolResultView, ak as ToolStepCtx, al as ToolTransientRetryNumbers, am as ToolTransientRetryOptions, an as askInputSchema, ao as askToolDefinition, ap as decodeStreamEvent, aq as encodeStreamEvent, ar as invokeWithTransientRetry, as as isTransientToolError, at as isTypedQuestion, au as normalizeElicitationReply, av as questionOptions, aw as readElicitationInput, ax as readElicitationQuestions, ay as renderElicitationAnswers, az as resolveElicitation, aA as resolveToolTransientRetryNumbers, aB as settleElicitation, aC as validateElicitationAnswer, aD as validateElicitationValue } from './tool-CON4ZOrD.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, i as ThreadSummary, j as ThreadDetail, S as StoredMessage, k as ToolResult, l as MessageAttachment, m as MessageFeedback, n as ToolCallStatus, U as UsagePurpose, T as ToolSpec, Q as QuotaState, o as AgentRunInput, H as HumanReply, p as ToolKind, q as ToolCallApproval, a as ToolHandler, r as HistoryPolicy, P as PageContext, s as AgentDefinition, t as AgentDelegation, D as DetachedDelivery, u as ToolDescribeScope, v as PromptBuilder, w as PromptContributor, x as ToolTransientRetrySetting, y as AgentIntake, z as Decision, E as ElicitationRequest, L as LlmStepEnvelope, B as ToolStepEnvelope } from './tool-CfnSyIQf.js';
+export { C as ASK_TOOL_DESCRIPTION, F as ASK_TOOL_NAME, G as AgentApprovalRequest, I as AgentApprovalSettlement, J as AgentAttachmentConfig, K as AgentCatalogEntry, N as AgentClientConfig, O as AgentHistoryWindow, R as AskToolInput, V as DEFAULT_INTAKE_PREAMBLE, W as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, X as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, Y as ELICITATION_INPUT_TYPES, Z as ElicitationInput, _ as ElicitationInputType, $ as ElicitationOption, a0 as ElicitationOutcome, a1 as ElicitationQuestion, a2 as ElicitationReply, a3 as ElicitationResult, a4 as HistoryPolicyContext, a5 as HistorySelection, a6 as HistorySummary, a7 as InvokeWithTransientRetryOptions, a8 as MAX_ASK_QUESTIONS, a9 as MessageFeedbackValue, aa as MessageRole, ab as PromptContext, ac as QuotaView, ad as ToolCallApprovalStatus, ae as ToolCatalogEntry, af as ToolConfirmation, ag as ToolDescription, b as ToolPresentation, ah as ToolPresentationTone, ai as ToolResultField, aj as ToolResultView, ak as ToolStepCtx, al as ToolTransientRetryNumbers, am as ToolTransientRetryOptions, an as askInputSchema, ao as askToolDefinition, ap as decodeStreamEvent, aq as encodeStreamEvent, ar as invokeWithTransientRetry, as as isTransientToolError, at as isTypedQuestion, au as normalizeElicitationReply, av as questionOptions, aw as readElicitationInput, ax as readElicitationQuestions, ay as renderElicitationAnswers, az as resolveElicitation, aA as resolveToolTransientRetryNumbers, aB as settleElicitation, aC as validateElicitationAnswer, aD as validateElicitationValue } from './tool-CfnSyIQf.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-BrGKQgLf.js';
-export { D as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, b as IncrementalGating, c as OutputRejectedError, d as OutputVerdict, e as ProcessorFailedError } from './processors-BrGKQgLf.js';
+import { O as OutputProcessor, P as ProcessorContext, I as InputProcessor, a as ProcessedPrompt, M as ModelAnswer } from './processors-8c9g9J6R.js';
+export { D as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, b as IncrementalGating, c as OutputRejectedError, d as OutputVerdict, e as ProcessorFailedError } from './processors-8c9g9J6R.js';
 import { ChannelRegistry } from '@dudousxd/nestjs-diagnostics';
 
 /**
@@ -244,9 +244,22 @@ interface ModelCatalogProviderGroup {
     label: string;
     models: ModelCatalogEntry[];
 }
+/** The agent always runs on one model: the picker shows it and offers no choice. */
+interface ModelCatalogLock {
+    /** The catalog id every turn runs on. */
+    model: string;
+    /** Why, in words a picker can show ("This assistant always uses GPT-5"). */
+    reason?: string;
+}
 /** What `GET <base>/models` answers. */
 interface ModelCatalogView {
     providers: ModelCatalogProviderGroup[];
+    /**
+     * Present when the agent is locked to one model. Every turn runs on `locked.model` — a send's own
+     * `model` and a thread's pin included — and a send naming another model is refused (`400`). List
+     * the other models as unavailable too, so an older client that ignores the lock cannot pick them.
+     */
+    locked?: ModelCatalogLock;
     /** The model a turn runs on when nobody picked one; `null` when the provider decides. */
     default: string | null;
 }
@@ -692,7 +705,11 @@ type QuotaPeriod = 'day' | 'month';
 /** One budget window: what was spent in it, and the ceiling when there is one. */
 interface QuotaWindow {
     period: QuotaPeriod;
-    usedTokens: number;
+    /**
+     * Tokens used in the window. Absent → the budget does not count tokens (a USD-only spend cap, such
+     * as an AI gateway's) — never a fabricated `0`.
+     */
+    usedTokens?: number;
     /** Absent → no token ceiling on this window. */
     limitTokens?: number;
     usedUsd: number;
@@ -700,6 +717,11 @@ interface QuotaWindow {
     limitUsd?: number;
     /** ISO-8601 instant the window starts over (next UTC midnight, first of next month). */
     resetsAt?: string;
+    /**
+     * The soft limit: the share of a ceiling (`0..1`, e.g. `0.8`) past which a client should warn
+     * that the budget is running out. Absent → no warning for this window.
+     */
+    warnAt?: number;
 }
 /** Which window stopped the actor, when one did. */
 interface QuotaBlock {
@@ -707,11 +729,24 @@ interface QuotaBlock {
     /** Words a client can show ("Monthly AI budget reached"). */
     reason?: string;
 }
+/** A window past its soft limit ({@link QuotaWindow.warnAt}) but not exhausted. */
+interface QuotaWarning {
+    period: QuotaPeriod;
+    /** How much of the window's ceiling is used, `0..1` (the larger of spend and tokens). */
+    ratio: number;
+    /** Words a client can show ("80% of your monthly AI budget used"). */
+    reason?: string;
+}
 /** What `GET <base>/quota` answers. */
 interface QuotaReport {
     windows: QuotaWindow[];
     /** Present when a window is exhausted — a send will be refused until it resets. */
     blocked?: QuotaBlock;
+    /**
+     * Present when a window crossed its `warnAt` and none is exhausted — the fullest one. A client
+     * may also derive it from the windows ({@link quotaWarning}); the server's wins.
+     */
+    warning?: QuotaWarning;
 }
 interface QuotaQuery {
     actor: Actor;
@@ -731,6 +766,13 @@ interface QuotaProvider {
 }
 /** The first window whose token or spend ceiling is reached, as a {@link QuotaBlock}. */
 declare function exhaustedWindow(windows: readonly QuotaWindow[]): QuotaBlock | undefined;
+/** How much of `window`'s ceilings is used, `0..1+` (the larger of spend and tokens), or `null`. */
+declare function quotaUsedRatio(window: QuotaWindow): number | null;
+/**
+ * The fullest window past its `warnAt`, as a {@link QuotaWarning} — `undefined` when none is, or
+ * when one is exhausted (that is `blocked`, not a warning).
+ */
+declare function quotaWarning(windows: readonly QuotaWindow[]): QuotaWarning | undefined;
 /** The UTC day range (`YYYY-MM-DD`, inclusive) and reset instant of `period` around `now`. */
 declare function quotaPeriodRange(period: QuotaPeriod, now: Date): {
     fromDay: string;
@@ -3702,4 +3744,4 @@ declare class InMemoryAgentStore implements AgentStore {
     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 AgentRunStarted, type AgentRunner, type AgentSkillsResolved, type AgentSpanEvent, type AgentStore, AgentStreamError, AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, type AppendMessageInput, type ApprovalDecisionRef, type ApprovalPolicy, type ApprovalRequirement, type ApprovalThreadRef, type ApprovalToolRef, type ApprovalWhere, type AttachmentRef, type AttachmentStagingDescription, type AttachmentStagingStore, type BufferedModelTurnResult, type BuildMemoryBlockInput, type CostUsage, type 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, 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 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, type QuotaBlock, QuotaExceededError, type QuotaPeriod, type QuotaProvider, type QuotaQuery, type QuotaReport, QuotaState, type QuotaStore, type QuotaWindow, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, REQUESTER_APPROVER, type RecentRunRow, type RecordRunEndInput, type RecordRunStartInput, type RecordToolCallInput, type 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 ThreadTurnPage, type ThreadTurnQuery, type ThreadTurnReader, type ThreadUsageRollup, type ThreadWhere, type TokenStreamSink, type ToolCallActivityRow, ToolCallApproval, type ToolCallApprovalColumns, type 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, type UpdateThreadInput, type UpdateToolCallInput, UsagePurpose, 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, 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 AgentRunStarted, type AgentRunner, type AgentSkillsResolved, type AgentSpanEvent, type AgentStore, AgentStreamError, AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, type AppendMessageInput, type ApprovalDecisionRef, type ApprovalPolicy, type ApprovalRequirement, type ApprovalThreadRef, type ApprovalToolRef, type ApprovalWhere, type AttachmentRef, type AttachmentStagingDescription, type AttachmentStagingStore, type BufferedModelTurnResult, type BuildMemoryBlockInput, type CostUsage, type 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, 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, 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, type RecordRunEndInput, type RecordRunStartInput, type RecordToolCallInput, type 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 ThreadTurnPage, type ThreadTurnQuery, type ThreadTurnReader, type ThreadUsageRollup, type ThreadWhere, type TokenStreamSink, type ToolCallActivityRow, ToolCallApproval, type ToolCallApprovalColumns, type 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, type UpdateThreadInput, type UpdateToolCallInput, UsagePurpose, 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 };

package/dist/index.js

@@ -292,7 +292,7 @@ __name(mergeUi, "mergeUi");
 // src/spi/quota-provider.ts
 function exhaustedWindow(windows) {
   for (const window of windows) {
-    const tokensOut = window.limitTokens !== void 0 && window.usedTokens >= window.limitTokens;
+    const tokensOut = window.limitTokens !== void 0 && (window.usedTokens ?? 0) >= window.limitTokens;
     const spendOut = window.limitUsd !== void 0 && window.usedUsd >= window.limitUsd;
     if (tokensOut || spendOut) {
       return {
@@ -304,6 +304,34 @@ function exhaustedWindow(windows) {
   return void 0;
 }
 __name(exhaustedWindow, "exhaustedWindow");
+function quotaUsedRatio(window) {
+  const ratios = [];
+  if (window.limitUsd !== void 0 && window.limitUsd > 0) {
+    ratios.push(window.usedUsd / window.limitUsd);
+  }
+  if (window.limitTokens !== void 0 && window.limitTokens > 0 && window.usedTokens !== void 0) {
+    ratios.push(window.usedTokens / window.limitTokens);
+  }
+  return ratios.length === 0 ? null : Math.max(...ratios);
+}
+__name(quotaUsedRatio, "quotaUsedRatio");
+function quotaWarning(windows) {
+  if (exhaustedWindow(windows) !== void 0) return void 0;
+  let fullest;
+  for (const window of windows) {
+    if (window.warnAt === void 0) continue;
+    const ratio = quotaUsedRatio(window);
+    if (ratio === null || ratio < window.warnAt) continue;
+    if (fullest === void 0 || ratio > fullest.ratio) {
+      fullest = {
+        period: window.period,
+        ratio
+      };
+    }
+  }
+  return fullest;
+}
+__name(quotaWarning, "quotaWarning");
 function quotaPeriodRange(period, now) {
   const year = now.getUTCFullYear();
   const month = now.getUTCMonth();
@@ -1240,6 +1268,7 @@ function normalizeElicitationReply(reply) {
     return reply;
   }
   const answeredByRef = candidate.answeredByRef ?? candidate.executedByRef;
+  const answeredVia = candidate.answeredVia ?? candidate.decidedVia;
   return {
     answers: {},
     ...candidate.approved === false || candidate.skipped === true ? {
@@ -1247,6 +1276,9 @@ function normalizeElicitationReply(reply) {
     } : {},
     ...answeredByRef !== void 0 ? {
       answeredByRef
+    } : {},
+    ...answeredVia !== void 0 ? {
+      answeredVia
     } : {}
   };
 }
@@ -1270,7 +1302,13 @@ function resolveElicitation(request, raw) {
   return {
     answers,
     skipped: reply.skipped === true,
-    defaulted
+    defaulted,
+    ...reply.answeredByRef !== void 0 ? {
+      answeredBy: reply.answeredByRef
+    } : {},
+    ...reply.answeredVia !== void 0 ? {
+      answeredVia: reply.answeredVia
+    } : {}
   };
 }
 __name(resolveElicitation, "resolveElicitation");
@@ -5441,6 +5479,8 @@ export {
   publishAgentToolRetry,
   questionOptions,
   quotaPeriodRange,
+  quotaUsedRatio,
+  quotaWarning,
   readElicitationInput,
   readElicitationQuestions,
   releaseGatedFrames,