@dudousxd/nestjs-agent-core 0.17.0 → 0.19.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as ModelMessage, a as ToolDefinition, b as ToolCallRequest, c as MessageUsage, E as ElicitationRequest, A as Actor, d as ThreadSummary, e as ThreadDetail, S as StoredMessage, f as ToolResult, g as MessageAttachment, h as ToolCallStatus, U as UsagePurpose, i as ToolSpec, Q as QuotaState, j as AgentRunInput, H as HumanReply, T as ToolHandler, k as HistoryPolicy, O as OutputProcessor, P as ProcessorContext, I as InputProcessor, l as ProcessedPrompt, m as ModelAnswer, n as PageContext, o as AgentDefinition, p as AgentDelegation, D as DetachedDelivery, q as AiToolCtx, r as PromptBuilder, s as PromptContributor, t as ToolTransientRetrySetting, u as AgentIntake, v as Decision, L as LlmStepEnvelope, w as ToolStepEnvelope } from './tool-CL9oEytW.cjs';
-export { x as ASK_TOOL_DESCRIPTION, y as ASK_TOOL_NAME, z as AgentCatalogEntry, B as AgentHistoryWindow, C as AskToolInput, F as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, G as DEFAULT_INTAKE_PREAMBLE, J as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, K as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, N as ElicitationOption, R as ElicitationOutcome, V as ElicitationQuestion, W as ElicitationReply, X as ElicitationResult, Y as HistoryPolicyContext, Z as HistorySelection, _ as HistorySummary, $ as IncrementalGating, a0 as InvokeWithTransientRetryOptions, a1 as MAX_ASK_QUESTIONS, a2 as MessageRole, a3 as OutputRejectedError, a4 as OutputVerdict, a5 as ProcessorFailedError, a6 as PromptContext, a7 as QuotaView, a8 as ToolKind, a9 as ToolStepCtx, aa as ToolTransientRetryNumbers, ab as ToolTransientRetryOptions, ac as askInputSchema, ad as askToolDefinition, ae as invokeWithTransientRetry, af as isTransientToolError, ag as normalizeElicitationReply, ah as renderElicitationAnswers, ai as resolveElicitation, aj as resolveToolTransientRetryNumbers, ak as settleElicitation } from './tool-CL9oEytW.cjs';
+import { M as ModelMessage, a as ToolDefinition, b as ToolCallRequest, c as MessageUsage, d as AgentUiComponent, A as Actor, e as ThreadSummary, f as ThreadDetail, S as StoredMessage, g as ToolResult, h as MessageAttachment, i as ToolCallStatus, U as UsagePurpose, j as ToolSpec, Q as QuotaState, k as AgentRunInput, H as HumanReply, T as ToolHandler, l as HistoryPolicy, O as OutputProcessor, P as ProcessorContext, I as InputProcessor, m as ProcessedPrompt, n as ModelAnswer, o as PageContext, p as AgentDefinition, q as AgentDelegation, D as DetachedDelivery, r as AiToolCtx, s as PromptBuilder, t as PromptContributor, u as ToolTransientRetrySetting, v as AgentIntake, w as Decision, E as ElicitationRequest, L as LlmStepEnvelope, x as ToolStepEnvelope } from './tool-Q2rmGeaG.cjs';
+export { y as ASK_TOOL_DESCRIPTION, z as ASK_TOOL_NAME, B as AgentApprovalRequest, C as AgentCatalogEntry, F as AgentHistoryWindow, G as AgentStreamEvent, J as AskToolInput, K as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, N as DEFAULT_INTAKE_PREAMBLE, R as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, V as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, W as ElicitationOption, X as ElicitationOutcome, Y as ElicitationQuestion, Z as ElicitationReply, _ as ElicitationResult, $ as HistoryPolicyContext, a0 as HistorySelection, a1 as HistorySummary, a2 as IncrementalGating, a3 as InvokeWithTransientRetryOptions, a4 as MAX_ASK_QUESTIONS, a5 as MessageRole, a6 as OutputRejectedError, a7 as OutputVerdict, a8 as ProcessorFailedError, a9 as PromptContext, aa as QuotaView, ab as ToolCatalogEntry, ac as ToolConfirmation, ad as ToolKind, ae as ToolPresentation, af as ToolPresentationTone, ag as ToolResultField, ah as ToolResultView, ai as ToolStepCtx, aj as ToolTransientRetryNumbers, ak as ToolTransientRetryOptions, al as askInputSchema, am as askToolDefinition, an as decodeStreamEvent, ao as encodeStreamEvent, ap as invokeWithTransientRetry, aq as isTransientToolError, ar as normalizeElicitationReply, as as renderElicitationAnswers, at as resolveElicitation, au as resolveToolTransientRetryNumbers, av as settleElicitation } from './tool-Q2rmGeaG.cjs';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { ChannelRegistry } from '@dudousxd/nestjs-diagnostics';
 
@@ -160,6 +160,16 @@ interface ModelTurnResult {
      * the JSON out of `text`) is always correct.
      */
     object?: unknown;
+    /**
+     * The model's thinking this turn, as streamed. Optional: the loop derives it from the `reasoning`
+     * frames the provider wrote to the sink (see `observeTurnFrames`), so a provider only sets it to
+     * override that — e.g. one that receives reasoning it does not stream.
+     */
+    reasoning?: string;
+    /** Time spent thinking this turn, in ms. Derived like {@link reasoning} when omitted. */
+    reasoningMs?: number;
+    /** Components pushed during this turn (`ui` frames). Derived like {@link reasoning} when omitted. */
+    ui?: AgentUiComponent[];
 }
 /**
  * A model turn whose live frames were HELD instead of streamed, because an output processor has to
@@ -201,187 +211,33 @@ interface ModelProvider {
     runTurn(args: ModelTurnArgs): Promise<ModelTurnResult>;
 }
 
-/**
- * The structured live-stream vocabulary carried over the {@link SinkWriter} byte channel.
- *
- * The model turn (via the AI-SDK adapter) and the agent loop write these events as NDJSON — one
- * `JSON.stringify(event)\n` per {@link SinkWriter.write}. The HTTP layer forwards each line as an
- * SSE `data:` frame, and the client transport maps them back to the AI SDK UI-message chunk
- * protocol so the browser renders text, reasoning, and tool cards (input + output) LIVE — the same
- * rich rendering a raw `streamText().toUIMessageStream()` would give, but reconstructed on the
- * client so the sink stays a format-agnostic byte buffer (durable buffering/replay is untouched).
- *
- * Keeping this vocabulary neutral (not AI-SDK `UIMessageChunk`) means core never depends on `ai`:
- * the adapter owns model-parts → event, the transport owns event → UI-chunk.
- *
- * The vocabulary is also a CONTRACT for runners that are not this library's loop: anything that
- * writes these frames (one JSON object per SSE `data:` line) gets the React transport, transcript
- * model and hooks for free. Two rules keep it evolvable:
- *  - every frame is a JSON object with a string `kind`; a reader MUST tolerate kinds it does not
- *    know (the React transport forwards them as `data-<kind>` parts rather than dropping them);
- *  - fields are only ever added, and new fields are optional.
- */
-
-/**
- * A component the server pushed into the conversation: generative UI that is NOT a tool call's
- * rendering. It is addressed by `component` (a key in the client's own component registry), never
- * by a tool name, so a runner can emit one from anywhere — a tool body, a post-processing step, a
- * sandboxed agent that renders through its own protocol.
- *
- * `id` is the component's identity within the message: a second frame with the same `id` REPLACES
- * the first (streaming props into a chart, flipping a card from "loading" to "ready"), it never
- * adds a second component.
- */
-interface AgentUiComponent {
-    id: string;
-    /** Registry key the client resolves to its own renderer, e.g. `data-table`. */
-    component: string;
-    props: Record<string, unknown>;
-    /** Schema version of `props`, so a client can keep rendering components persisted by an older server. */
-    version?: number;
-}
-/**
- * Who has to settle an action tool call, and until when. Metadata only: the call itself is still
- * settled through the tool-call approve/reject routes, by its `toolCallId`.
- */
-interface AgentApprovalRequest {
-    /** The tool call awaiting the decision — the `id` of a call already announced on this stream. */
-    id: string;
-    /**
-     * Who may decide. Open vocabulary the host defines — `'requester'` (the person chatting),
-     * `'admin'`, a role name, a team. A client uses it to say "waiting on an admin" instead of
-     * offering buttons the viewer cannot use.
-     */
-    approver: string;
-    /** ISO-8601 instant after which the request lapses. Absent → it never expires. */
-    expiresAt?: string;
-    /** Why this call needs a person, in words for that person. */
-    reason?: string;
-}
-type AgentStreamEvent = {
-    kind: 'step-start';
-}
-/**
- * Closes the step opened by the matching `step-start`. Carries the model call's token usage and
- * `costUsd` (an estimate from the bound pricing store, or `null` when unpriced/unbound — never a
- * fabricated `0`) so a live client can render running cost without waiting for a thread re-fetch.
- */
- | {
-    kind: 'step-finish';
-    usage?: MessageUsage;
-    costUsd?: number | null;
-} | {
-    kind: 'text';
-    text: string;
-} | {
-    kind: 'reasoning';
-    text: string;
-}
-/**
- * `toolKind` collapses `ToolKind`'s `'agent'` into `'read'` — delegation tools auto-execute like a read tool.
- *
- * `parentId` nests this call under another call on the same stream: the inner calls a code-mode
- * `execute` makes, the tools a delegated sub-agent runs. The parent must be announced first. A
- * call's parent is fixed by its first frame that names one; later frames may omit it.
- */
- | {
-    kind: 'tool-input-start';
-    id: string;
-    name: string;
-    toolKind: 'read' | 'action';
-    parentId?: string;
-} | {
-    kind: 'tool-input-delta';
-    id: string;
-    delta: string;
-} | {
-    kind: 'tool-input-available';
-    id: string;
-    name: string;
-    input: unknown;
-    toolKind: 'read' | 'action';
-    /** Same as on `tool-input-start`, for a runner that announces a call without streaming its input. */
-    parentId?: string;
-} | {
-    kind: 'tool-output';
-    id: string;
-    output: unknown;
-} | {
-    kind: 'tool-output-error';
-    id: string;
-    error: string;
-}
-/**
- * A person was asked to approve an action tool and declined it. Its own frame, NOT
- * `tool-output-error`: a refusal is a decision with a known outcome — nothing ran — while a
- * failure is an outcome nobody chose and whose effects are unknown. Rendering them the same way
- * tells an operator their own "no" was a malfunction. Maps onto the SDK's `output-denied` tool
- * part state, which a client reads without knowing any tool's name.
- */
- | {
-    kind: 'tool-output-denied';
-    id: string;
-    reason?: string;
-}
-/**
- * The run has put a question set to the user and is parked until someone answers it (or skips).
- * Written by the LOOP for both elicitation surfaces — the configured intake and the model's `ask`
- * tool — so a client renders one form either way rather than learning to recognise a tool name.
- * The matching `tool-output` frame, under the same `id`, carries the settled answers.
- */
- | {
-    kind: 'elicitation';
-    id: string;
-    request: ElicitationRequest;
-}
-/**
- * An action tool call (already announced by `tool-input-start`/`tool-input-available` under the
- * same `id`) is parked on a person. Optional: a client still treats an `action` call stuck at
- * its input as pending — this frame adds WHO has to decide and UNTIL WHEN, and moves the call
- * into the AI SDK's native `approval-requested` state.
- */
- | ({
-    kind: 'approval-requested';
-} & AgentApprovalRequest)
-/**
- * Server-pushed generative UI, positioned in the message where it arrives. Not tied to a tool
- * call. See {@link AgentUiComponent}.
- */
- | ({
-    kind: 'ui';
-} & AgentUiComponent)
-/**
- * The thread's title was set or changed while this run streamed (typically derived from the
- * first exchange). Thread-level, not message content: a client updates its header/sidebar and
- * does not render it in the transcript.
- */
- | {
-    kind: 'title';
-    title: string;
+/** What a model turn streamed that the persisted message keeps, beyond its text and tool calls. */
+interface TurnFrameSummary {
+    reasoning?: string;
+    reasoningMs?: number;
+    ui?: AgentUiComponent[];
+}
+interface ObservedTurnFrames {
+    /** Hand THIS to the provider: every write passes through to the wrapped writer unchanged. */
+    writer: SinkWriter;
+    /** What was seen so far. Closes an open thinking burst at the moment it is called. */
+    summary(): TurnFrameSummary;
 }
 /**
- * Someone stopped this run. The stream's LAST frame, written by the runner that settled the
- * cancel, immediately before a normal `end()` — never a `fail()`, because a cancel is not an
- * error and a client that retries on a failed stream must not retry this.
+ * Watch the frames a model turn writes, to learn what the stream showed that the provider's result
+ * does not carry: the model's thinking (text and how long it took) and any pushed UI components.
  *
- * A run that simply ends wrote everything it had; one that ends after this frame did not, and the
- * difference is the whole point: without it a reader cannot tell a truncated answer from a
- * complete one. Consumers that predate the frame ignore it and see the `end()` they always saw.
- */
- | {
-    kind: 'cancelled';
-};
-/** Encode one event as an NDJSON line (`{...}\n`) for {@link SinkWriter.write}. */
-declare function encodeStreamEvent(event: AgentStreamEvent): Uint8Array;
-/**
- * Read one NDJSON line back, or `null` when the line is not a stream event at all.
+ * Derived from the FRAMES rather than asked of each provider, so every provider that streams the
+ * vocabulary gets reasoning persisted without implementing anything. Thinking time is the sum of
+ * each burst of consecutive `reasoning` frames — from the first one to the next frame that is not
+ * reasoning (or the end of the turn) — which is what a reader watched as "thinking".
  *
- * `null` covers a genuinely opaque chunk, not just malformed JSON: the sink is a byte channel, so a
- * model provider is free to write anything into it and some write bare text. A caller that has to
- * CLASSIFY a chunk — the output gate, which may only forward what it can prove is not the answer —
- * treats an unreadable frame as unclassifiable rather than guessing.
+ * Call it inside the step that runs the model, so the summary rides that step's journaled result
+ * and a replay reads the same numbers back instead of re-measuring a turn that is not happening.
  */
-declare function decodeStreamEvent(line: string): AgentStreamEvent | null;
+declare function observeTurnFrames(writer: SinkWriter, now?: () => number): ObservedTurnFrames;
+/** Fill what a provider did not report from what its frames showed. A provider's own value wins. */
+declare function withTurnFrames<T extends ModelTurnResult>(result: T, frames: TurnFrameSummary): T;
 
 interface CreateThreadInput {
     actor: Actor;
@@ -408,6 +264,12 @@ interface AppendMessageInput {
      * run) can omit it; the store persists it as `null` when absent.
      */
     runId?: string;
+    /** The step's streamed thinking. See {@link StoredMessage.reasoning}. */
+    reasoning?: string;
+    /** Time spent thinking in this step, in ms. See {@link StoredMessage.reasoningMs}. */
+    reasoningMs?: number;
+    /** Components pushed during this step. See {@link StoredMessage.ui}. */
+    ui?: AgentUiComponent[];
 }
 interface RecordToolCallInput {
     toolCallId: string;
@@ -2583,6 +2445,12 @@ declare class ToolRegistry {
      * tool the allow-list has already excluded is a call whose answer nothing reads.
      */
     definitionsFor(actor: Actor, policy: RolesPolicy, allowedTools?: string[]): Promise<ToolDefinition[]>;
+    /**
+     * The specs {@link definitionsFor} offers the model, whole — the same four gates (allow-list,
+     * enabled, role, `canUse`) in the same order. For a surface that lists what an actor can reach
+     * (`GET <base>/tools`), which must never disagree with what the model is actually shown.
+     */
+    visibleSpecs(actor: Actor, policy: RolesPolicy, allowedTools?: string[]): Promise<ToolSpec[]>;
     /**
      * Run a tool. Re-checks that the tool is enabled and that the role allows it (defense-in-depth —
      * a call can reach here from a replayed durable step or an approval granted before the flag
@@ -3279,4 +3147,4 @@ type AgentDiagnosticKey = `agent:${AgentDiagnosticEvent}`;
  */
 declare function agentDiagnosticKey(event: AgentDiagnosticEvent): AgentDiagnosticKey;
 
-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_OPTIONS, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, 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, Actor, type ActorDirectory, type ActorResolver, type ActorSpendRow, type AgentApprovalPort, type AgentApprovalRequest, 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, type AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, type AgentUiComponent, AiToolCtx, type AppendMessageInput, type ApprovalWhere, type AttachmentRef, 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, DefaultRolesPolicy, type DetachedDelegationOutcome, type DetachedDelegationReceipt, DetachedDelivery, type DetailThreadRef, ElicitationRequest, type EmbeddingProvider, type ForgetMemoryInput, type FrameBuffer, GLOBAL_SCOPE, type GovernancePage, type GovernancePageQuery, type GovernanceRange, type GovernanceRunDetail, type GovernanceThreadDetail, type GovernanceThreadDetailQuery, type GovernanceUsageInput, HistoryPolicy, HumanReply, 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, MessageUsage, ModelAnswer, ModelMessage, type ModelPrice, type ModelPriceInput, type ModelProvider, type ModelSpendRow, type ModelTurnArgs, type ModelTurnResult, type OfferMemoriesInput, type OutputGateMode, type OutputGateResult, OutputProcessor, type OverriddenMemory, PageContext, type Passage, type PendingApprovalRow, ProcessedPrompt, ProcessorContext, PromptBuilder, PromptContributor, QuotaExceededError, QuotaState, type QuotaStore, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, 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, ToolCallRequest, ToolCallStatus, type ToolCallWhere, ToolDefinition, ToolDisabledError, ToolForbiddenError, ToolHandler, ToolInputInvalidError, type ToolKindDeps, ToolNotFoundError, ToolRegistry, ToolResult, ToolSpec, type ToolStatRow, ToolStepEnvelope, ToolTransientRetrySetting, 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, dayBoundsUtc, decodeStreamEvent, defaultScopeResolver, detachedDelivered, detachedStarted, detachedUnsettled, encodeStreamEvent, estimateCost, estimateMessageTokens, extractJson, filterToolsByAllowList, filterToolsByCanUse, filterToolsByEnabled, filterToolsByRole, gateFollowUps, gateTail, isControlFlowSignal, isReplayIntegrityError, isToolEnabled, loadSkill, memoryForgetVerdict, memoryWriteVerdict, normalizeDelegation, offerMemories, offerSkills, publishAgentDelegated, publishAgentMemoryResolved, publishAgentMemoryWritten, publishAgentMessage, publishAgentQuotaExceeded, publishAgentRetrieved, publishAgentRunFailed, publishAgentRunFinished, publishAgentRunStarted, publishAgentSkillsResolved, publishAgentToolCall, publishAgentToolRetry, releaseGatedFrames, rememberInputSchema, rememberToolDefinition, repairInstruction, resolveGateLookback, resolveMemoryDigest, resolveOutputGateMode, resolveSkillCatalog, rollupThreadUsage, runAgentLoop, runInputProcessors, runOutputProcessors, seedModelPrices, settleAll, settleUnsettledDelegation, skillInputSchema, skillToolDefinition, skillWriteVerdict, stampToolKinds, staticSkillProvider, summarizeWithModel, tenantScope, traceLlmTurn, traceToolExecution, truncateDetailContent, validateStructured, windowHistory, withAskTool, withMemoryTool, withSkillTool, withToolTimeout, 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_OPTIONS, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, 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, 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, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, type AppendMessageInput, type ApprovalWhere, type AttachmentRef, 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, DefaultRolesPolicy, type DetachedDelegationOutcome, type DetachedDelegationReceipt, DetachedDelivery, type DetailThreadRef, ElicitationRequest, type EmbeddingProvider, type ForgetMemoryInput, type FrameBuffer, GLOBAL_SCOPE, type GovernancePage, type GovernancePageQuery, type GovernanceRange, type GovernanceRunDetail, type GovernanceThreadDetail, type GovernanceThreadDetailQuery, type GovernanceUsageInput, HistoryPolicy, HumanReply, 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, MessageUsage, ModelAnswer, 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, QuotaExceededError, QuotaState, type QuotaStore, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, 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, ToolCallRequest, ToolCallStatus, type ToolCallWhere, ToolDefinition, ToolDisabledError, ToolForbiddenError, ToolHandler, ToolInputInvalidError, type ToolKindDeps, ToolNotFoundError, ToolRegistry, ToolResult, ToolSpec, type ToolStatRow, ToolStepEnvelope, ToolTransientRetrySetting, type TurnFrameSummary, 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, dayBoundsUtc, defaultScopeResolver, detachedDelivered, detachedStarted, detachedUnsettled, estimateCost, estimateMessageTokens, extractJson, filterToolsByAllowList, filterToolsByCanUse, filterToolsByEnabled, filterToolsByRole, gateFollowUps, gateTail, isControlFlowSignal, isReplayIntegrityError, isToolEnabled, loadSkill, memoryForgetVerdict, memoryWriteVerdict, normalizeDelegation, observeTurnFrames, offerMemories, offerSkills, publishAgentDelegated, publishAgentMemoryResolved, publishAgentMemoryWritten, publishAgentMessage, publishAgentQuotaExceeded, publishAgentRetrieved, publishAgentRunFailed, publishAgentRunFinished, publishAgentRunStarted, publishAgentSkillsResolved, publishAgentToolCall, publishAgentToolRetry, releaseGatedFrames, rememberInputSchema, rememberToolDefinition, repairInstruction, resolveGateLookback, resolveMemoryDigest, resolveOutputGateMode, resolveSkillCatalog, rollupThreadUsage, runAgentLoop, runInputProcessors, runOutputProcessors, seedModelPrices, settleAll, settleUnsettledDelegation, skillInputSchema, skillToolDefinition, skillWriteVerdict, stampToolKinds, staticSkillProvider, summarizeWithModel, tenantScope, traceLlmTurn, traceToolExecution, truncateDetailContent, validateStructured, windowHistory, withAskTool, withMemoryTool, withSkillTool, withToolTimeout, withTurnFrames, writeMemory };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as ModelMessage, a as ToolDefinition, b as ToolCallRequest, c as MessageUsage, E as ElicitationRequest, A as Actor, d as ThreadSummary, e as ThreadDetail, S as StoredMessage, f as ToolResult, g as MessageAttachment, h as ToolCallStatus, U as UsagePurpose, i as ToolSpec, Q as QuotaState, j as AgentRunInput, H as HumanReply, T as ToolHandler, k as HistoryPolicy, O as OutputProcessor, P as ProcessorContext, I as InputProcessor, l as ProcessedPrompt, m as ModelAnswer, n as PageContext, o as AgentDefinition, p as AgentDelegation, D as DetachedDelivery, q as AiToolCtx, r as PromptBuilder, s as PromptContributor, t as ToolTransientRetrySetting, u as AgentIntake, v as Decision, L as LlmStepEnvelope, w as ToolStepEnvelope } from './tool-CL9oEytW.js';
-export { x as ASK_TOOL_DESCRIPTION, y as ASK_TOOL_NAME, z as AgentCatalogEntry, B as AgentHistoryWindow, C as AskToolInput, F as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, G as DEFAULT_INTAKE_PREAMBLE, J as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, K as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, N as ElicitationOption, R as ElicitationOutcome, V as ElicitationQuestion, W as ElicitationReply, X as ElicitationResult, Y as HistoryPolicyContext, Z as HistorySelection, _ as HistorySummary, $ as IncrementalGating, a0 as InvokeWithTransientRetryOptions, a1 as MAX_ASK_QUESTIONS, a2 as MessageRole, a3 as OutputRejectedError, a4 as OutputVerdict, a5 as ProcessorFailedError, a6 as PromptContext, a7 as QuotaView, a8 as ToolKind, a9 as ToolStepCtx, aa as ToolTransientRetryNumbers, ab as ToolTransientRetryOptions, ac as askInputSchema, ad as askToolDefinition, ae as invokeWithTransientRetry, af as isTransientToolError, ag as normalizeElicitationReply, ah as renderElicitationAnswers, ai as resolveElicitation, aj as resolveToolTransientRetryNumbers, ak as settleElicitation } from './tool-CL9oEytW.js';
+import { M as ModelMessage, a as ToolDefinition, b as ToolCallRequest, c as MessageUsage, d as AgentUiComponent, A as Actor, e as ThreadSummary, f as ThreadDetail, S as StoredMessage, g as ToolResult, h as MessageAttachment, i as ToolCallStatus, U as UsagePurpose, j as ToolSpec, Q as QuotaState, k as AgentRunInput, H as HumanReply, T as ToolHandler, l as HistoryPolicy, O as OutputProcessor, P as ProcessorContext, I as InputProcessor, m as ProcessedPrompt, n as ModelAnswer, o as PageContext, p as AgentDefinition, q as AgentDelegation, D as DetachedDelivery, r as AiToolCtx, s as PromptBuilder, t as PromptContributor, u as ToolTransientRetrySetting, v as AgentIntake, w as Decision, E as ElicitationRequest, L as LlmStepEnvelope, x as ToolStepEnvelope } from './tool-Q2rmGeaG.js';
+export { y as ASK_TOOL_DESCRIPTION, z as ASK_TOOL_NAME, B as AgentApprovalRequest, C as AgentCatalogEntry, F as AgentHistoryWindow, G as AgentStreamEvent, J as AskToolInput, K as DEFAULT_INCREMENTAL_LOOKBACK_CHARS, N as DEFAULT_INTAKE_PREAMBLE, R as DEFAULT_TOOL_TRANSIENT_RETRY_ATTEMPTS, V as DEFAULT_TOOL_TRANSIENT_RETRY_BACKOFF_MS, W as ElicitationOption, X as ElicitationOutcome, Y as ElicitationQuestion, Z as ElicitationReply, _ as ElicitationResult, $ as HistoryPolicyContext, a0 as HistorySelection, a1 as HistorySummary, a2 as IncrementalGating, a3 as InvokeWithTransientRetryOptions, a4 as MAX_ASK_QUESTIONS, a5 as MessageRole, a6 as OutputRejectedError, a7 as OutputVerdict, a8 as ProcessorFailedError, a9 as PromptContext, aa as QuotaView, ab as ToolCatalogEntry, ac as ToolConfirmation, ad as ToolKind, ae as ToolPresentation, af as ToolPresentationTone, ag as ToolResultField, ah as ToolResultView, ai as ToolStepCtx, aj as ToolTransientRetryNumbers, ak as ToolTransientRetryOptions, al as askInputSchema, am as askToolDefinition, an as decodeStreamEvent, ao as encodeStreamEvent, ap as invokeWithTransientRetry, aq as isTransientToolError, ar as normalizeElicitationReply, as as renderElicitationAnswers, at as resolveElicitation, au as resolveToolTransientRetryNumbers, av as settleElicitation } from './tool-Q2rmGeaG.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { ChannelRegistry } from '@dudousxd/nestjs-diagnostics';
 
@@ -160,6 +160,16 @@ interface ModelTurnResult {
      * the JSON out of `text`) is always correct.
      */
     object?: unknown;
+    /**
+     * The model's thinking this turn, as streamed. Optional: the loop derives it from the `reasoning`
+     * frames the provider wrote to the sink (see `observeTurnFrames`), so a provider only sets it to
+     * override that — e.g. one that receives reasoning it does not stream.
+     */
+    reasoning?: string;
+    /** Time spent thinking this turn, in ms. Derived like {@link reasoning} when omitted. */
+    reasoningMs?: number;
+    /** Components pushed during this turn (`ui` frames). Derived like {@link reasoning} when omitted. */
+    ui?: AgentUiComponent[];
 }
 /**
  * A model turn whose live frames were HELD instead of streamed, because an output processor has to
@@ -201,187 +211,33 @@ interface ModelProvider {
     runTurn(args: ModelTurnArgs): Promise<ModelTurnResult>;
 }
 
-/**
- * The structured live-stream vocabulary carried over the {@link SinkWriter} byte channel.
- *
- * The model turn (via the AI-SDK adapter) and the agent loop write these events as NDJSON — one
- * `JSON.stringify(event)\n` per {@link SinkWriter.write}. The HTTP layer forwards each line as an
- * SSE `data:` frame, and the client transport maps them back to the AI SDK UI-message chunk
- * protocol so the browser renders text, reasoning, and tool cards (input + output) LIVE — the same
- * rich rendering a raw `streamText().toUIMessageStream()` would give, but reconstructed on the
- * client so the sink stays a format-agnostic byte buffer (durable buffering/replay is untouched).
- *
- * Keeping this vocabulary neutral (not AI-SDK `UIMessageChunk`) means core never depends on `ai`:
- * the adapter owns model-parts → event, the transport owns event → UI-chunk.
- *
- * The vocabulary is also a CONTRACT for runners that are not this library's loop: anything that
- * writes these frames (one JSON object per SSE `data:` line) gets the React transport, transcript
- * model and hooks for free. Two rules keep it evolvable:
- *  - every frame is a JSON object with a string `kind`; a reader MUST tolerate kinds it does not
- *    know (the React transport forwards them as `data-<kind>` parts rather than dropping them);
- *  - fields are only ever added, and new fields are optional.
- */
-
-/**
- * A component the server pushed into the conversation: generative UI that is NOT a tool call's
- * rendering. It is addressed by `component` (a key in the client's own component registry), never
- * by a tool name, so a runner can emit one from anywhere — a tool body, a post-processing step, a
- * sandboxed agent that renders through its own protocol.
- *
- * `id` is the component's identity within the message: a second frame with the same `id` REPLACES
- * the first (streaming props into a chart, flipping a card from "loading" to "ready"), it never
- * adds a second component.
- */
-interface AgentUiComponent {
-    id: string;
-    /** Registry key the client resolves to its own renderer, e.g. `data-table`. */
-    component: string;
-    props: Record<string, unknown>;
-    /** Schema version of `props`, so a client can keep rendering components persisted by an older server. */
-    version?: number;
-}
-/**
- * Who has to settle an action tool call, and until when. Metadata only: the call itself is still
- * settled through the tool-call approve/reject routes, by its `toolCallId`.
- */
-interface AgentApprovalRequest {
-    /** The tool call awaiting the decision — the `id` of a call already announced on this stream. */
-    id: string;
-    /**
-     * Who may decide. Open vocabulary the host defines — `'requester'` (the person chatting),
-     * `'admin'`, a role name, a team. A client uses it to say "waiting on an admin" instead of
-     * offering buttons the viewer cannot use.
-     */
-    approver: string;
-    /** ISO-8601 instant after which the request lapses. Absent → it never expires. */
-    expiresAt?: string;
-    /** Why this call needs a person, in words for that person. */
-    reason?: string;
-}
-type AgentStreamEvent = {
-    kind: 'step-start';
-}
-/**
- * Closes the step opened by the matching `step-start`. Carries the model call's token usage and
- * `costUsd` (an estimate from the bound pricing store, or `null` when unpriced/unbound — never a
- * fabricated `0`) so a live client can render running cost without waiting for a thread re-fetch.
- */
- | {
-    kind: 'step-finish';
-    usage?: MessageUsage;
-    costUsd?: number | null;
-} | {
-    kind: 'text';
-    text: string;
-} | {
-    kind: 'reasoning';
-    text: string;
-}
-/**
- * `toolKind` collapses `ToolKind`'s `'agent'` into `'read'` — delegation tools auto-execute like a read tool.
- *
- * `parentId` nests this call under another call on the same stream: the inner calls a code-mode
- * `execute` makes, the tools a delegated sub-agent runs. The parent must be announced first. A
- * call's parent is fixed by its first frame that names one; later frames may omit it.
- */
- | {
-    kind: 'tool-input-start';
-    id: string;
-    name: string;
-    toolKind: 'read' | 'action';
-    parentId?: string;
-} | {
-    kind: 'tool-input-delta';
-    id: string;
-    delta: string;
-} | {
-    kind: 'tool-input-available';
-    id: string;
-    name: string;
-    input: unknown;
-    toolKind: 'read' | 'action';
-    /** Same as on `tool-input-start`, for a runner that announces a call without streaming its input. */
-    parentId?: string;
-} | {
-    kind: 'tool-output';
-    id: string;
-    output: unknown;
-} | {
-    kind: 'tool-output-error';
-    id: string;
-    error: string;
-}
-/**
- * A person was asked to approve an action tool and declined it. Its own frame, NOT
- * `tool-output-error`: a refusal is a decision with a known outcome — nothing ran — while a
- * failure is an outcome nobody chose and whose effects are unknown. Rendering them the same way
- * tells an operator their own "no" was a malfunction. Maps onto the SDK's `output-denied` tool
- * part state, which a client reads without knowing any tool's name.
- */
- | {
-    kind: 'tool-output-denied';
-    id: string;
-    reason?: string;
-}
-/**
- * The run has put a question set to the user and is parked until someone answers it (or skips).
- * Written by the LOOP for both elicitation surfaces — the configured intake and the model's `ask`
- * tool — so a client renders one form either way rather than learning to recognise a tool name.
- * The matching `tool-output` frame, under the same `id`, carries the settled answers.
- */
- | {
-    kind: 'elicitation';
-    id: string;
-    request: ElicitationRequest;
-}
-/**
- * An action tool call (already announced by `tool-input-start`/`tool-input-available` under the
- * same `id`) is parked on a person. Optional: a client still treats an `action` call stuck at
- * its input as pending — this frame adds WHO has to decide and UNTIL WHEN, and moves the call
- * into the AI SDK's native `approval-requested` state.
- */
- | ({
-    kind: 'approval-requested';
-} & AgentApprovalRequest)
-/**
- * Server-pushed generative UI, positioned in the message where it arrives. Not tied to a tool
- * call. See {@link AgentUiComponent}.
- */
- | ({
-    kind: 'ui';
-} & AgentUiComponent)
-/**
- * The thread's title was set or changed while this run streamed (typically derived from the
- * first exchange). Thread-level, not message content: a client updates its header/sidebar and
- * does not render it in the transcript.
- */
- | {
-    kind: 'title';
-    title: string;
+/** What a model turn streamed that the persisted message keeps, beyond its text and tool calls. */
+interface TurnFrameSummary {
+    reasoning?: string;
+    reasoningMs?: number;
+    ui?: AgentUiComponent[];
+}
+interface ObservedTurnFrames {
+    /** Hand THIS to the provider: every write passes through to the wrapped writer unchanged. */
+    writer: SinkWriter;
+    /** What was seen so far. Closes an open thinking burst at the moment it is called. */
+    summary(): TurnFrameSummary;
 }
 /**
- * Someone stopped this run. The stream's LAST frame, written by the runner that settled the
- * cancel, immediately before a normal `end()` — never a `fail()`, because a cancel is not an
- * error and a client that retries on a failed stream must not retry this.
+ * Watch the frames a model turn writes, to learn what the stream showed that the provider's result
+ * does not carry: the model's thinking (text and how long it took) and any pushed UI components.
  *
- * A run that simply ends wrote everything it had; one that ends after this frame did not, and the
- * difference is the whole point: without it a reader cannot tell a truncated answer from a
- * complete one. Consumers that predate the frame ignore it and see the `end()` they always saw.
- */
- | {
-    kind: 'cancelled';
-};
-/** Encode one event as an NDJSON line (`{...}\n`) for {@link SinkWriter.write}. */
-declare function encodeStreamEvent(event: AgentStreamEvent): Uint8Array;
-/**
- * Read one NDJSON line back, or `null` when the line is not a stream event at all.
+ * Derived from the FRAMES rather than asked of each provider, so every provider that streams the
+ * vocabulary gets reasoning persisted without implementing anything. Thinking time is the sum of
+ * each burst of consecutive `reasoning` frames — from the first one to the next frame that is not
+ * reasoning (or the end of the turn) — which is what a reader watched as "thinking".
  *
- * `null` covers a genuinely opaque chunk, not just malformed JSON: the sink is a byte channel, so a
- * model provider is free to write anything into it and some write bare text. A caller that has to
- * CLASSIFY a chunk — the output gate, which may only forward what it can prove is not the answer —
- * treats an unreadable frame as unclassifiable rather than guessing.
+ * Call it inside the step that runs the model, so the summary rides that step's journaled result
+ * and a replay reads the same numbers back instead of re-measuring a turn that is not happening.
  */
-declare function decodeStreamEvent(line: string): AgentStreamEvent | null;
+declare function observeTurnFrames(writer: SinkWriter, now?: () => number): ObservedTurnFrames;
+/** Fill what a provider did not report from what its frames showed. A provider's own value wins. */
+declare function withTurnFrames<T extends ModelTurnResult>(result: T, frames: TurnFrameSummary): T;
 
 interface CreateThreadInput {
     actor: Actor;
@@ -408,6 +264,12 @@ interface AppendMessageInput {
      * run) can omit it; the store persists it as `null` when absent.
      */
     runId?: string;
+    /** The step's streamed thinking. See {@link StoredMessage.reasoning}. */
+    reasoning?: string;
+    /** Time spent thinking in this step, in ms. See {@link StoredMessage.reasoningMs}. */
+    reasoningMs?: number;
+    /** Components pushed during this step. See {@link StoredMessage.ui}. */
+    ui?: AgentUiComponent[];
 }
 interface RecordToolCallInput {
     toolCallId: string;
@@ -2583,6 +2445,12 @@ declare class ToolRegistry {
      * tool the allow-list has already excluded is a call whose answer nothing reads.
      */
     definitionsFor(actor: Actor, policy: RolesPolicy, allowedTools?: string[]): Promise<ToolDefinition[]>;
+    /**
+     * The specs {@link definitionsFor} offers the model, whole — the same four gates (allow-list,
+     * enabled, role, `canUse`) in the same order. For a surface that lists what an actor can reach
+     * (`GET <base>/tools`), which must never disagree with what the model is actually shown.
+     */
+    visibleSpecs(actor: Actor, policy: RolesPolicy, allowedTools?: string[]): Promise<ToolSpec[]>;
     /**
      * Run a tool. Re-checks that the tool is enabled and that the role allows it (defense-in-depth —
      * a call can reach here from a replayed durable step or an approval granted before the flag
@@ -3279,4 +3147,4 @@ type AgentDiagnosticKey = `agent:${AgentDiagnosticEvent}`;
  */
 declare function agentDiagnosticKey(event: AgentDiagnosticEvent): AgentDiagnosticKey;
 
-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_OPTIONS, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, 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, Actor, type ActorDirectory, type ActorResolver, type ActorSpendRow, type AgentApprovalPort, type AgentApprovalRequest, 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, type AgentStreamEvent, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, type AgentUiComponent, AiToolCtx, type AppendMessageInput, type ApprovalWhere, type AttachmentRef, 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, DefaultRolesPolicy, type DetachedDelegationOutcome, type DetachedDelegationReceipt, DetachedDelivery, type DetailThreadRef, ElicitationRequest, type EmbeddingProvider, type ForgetMemoryInput, type FrameBuffer, GLOBAL_SCOPE, type GovernancePage, type GovernancePageQuery, type GovernanceRange, type GovernanceRunDetail, type GovernanceThreadDetail, type GovernanceThreadDetailQuery, type GovernanceUsageInput, HistoryPolicy, HumanReply, 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, MessageUsage, ModelAnswer, ModelMessage, type ModelPrice, type ModelPriceInput, type ModelProvider, type ModelSpendRow, type ModelTurnArgs, type ModelTurnResult, type OfferMemoriesInput, type OutputGateMode, type OutputGateResult, OutputProcessor, type OverriddenMemory, PageContext, type Passage, type PendingApprovalRow, ProcessedPrompt, ProcessorContext, PromptBuilder, PromptContributor, QuotaExceededError, QuotaState, type QuotaStore, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, 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, ToolCallRequest, ToolCallStatus, type ToolCallWhere, ToolDefinition, ToolDisabledError, ToolForbiddenError, ToolHandler, ToolInputInvalidError, type ToolKindDeps, ToolNotFoundError, ToolRegistry, ToolResult, ToolSpec, type ToolStatRow, ToolStepEnvelope, ToolTransientRetrySetting, 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, dayBoundsUtc, decodeStreamEvent, defaultScopeResolver, detachedDelivered, detachedStarted, detachedUnsettled, encodeStreamEvent, estimateCost, estimateMessageTokens, extractJson, filterToolsByAllowList, filterToolsByCanUse, filterToolsByEnabled, filterToolsByRole, gateFollowUps, gateTail, isControlFlowSignal, isReplayIntegrityError, isToolEnabled, loadSkill, memoryForgetVerdict, memoryWriteVerdict, normalizeDelegation, offerMemories, offerSkills, publishAgentDelegated, publishAgentMemoryResolved, publishAgentMemoryWritten, publishAgentMessage, publishAgentQuotaExceeded, publishAgentRetrieved, publishAgentRunFailed, publishAgentRunFinished, publishAgentRunStarted, publishAgentSkillsResolved, publishAgentToolCall, publishAgentToolRetry, releaseGatedFrames, rememberInputSchema, rememberToolDefinition, repairInstruction, resolveGateLookback, resolveMemoryDigest, resolveOutputGateMode, resolveSkillCatalog, rollupThreadUsage, runAgentLoop, runInputProcessors, runOutputProcessors, seedModelPrices, settleAll, settleUnsettledDelegation, skillInputSchema, skillToolDefinition, skillWriteVerdict, stampToolKinds, staticSkillProvider, summarizeWithModel, tenantScope, traceLlmTurn, traceToolExecution, truncateDetailContent, validateStructured, windowHistory, withAskTool, withMemoryTool, withSkillTool, withToolTimeout, 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_OPTIONS, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, 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, 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, type AgentStructuredOutputSpan, type AgentToolCallEvent, type AgentToolExecutionSpan, type AgentToolRetry, AgentUiComponent, AiToolCtx, type AppendMessageInput, type ApprovalWhere, type AttachmentRef, 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, DefaultRolesPolicy, type DetachedDelegationOutcome, type DetachedDelegationReceipt, DetachedDelivery, type DetailThreadRef, ElicitationRequest, type EmbeddingProvider, type ForgetMemoryInput, type FrameBuffer, GLOBAL_SCOPE, type GovernancePage, type GovernancePageQuery, type GovernanceRange, type GovernanceRunDetail, type GovernanceThreadDetail, type GovernanceThreadDetailQuery, type GovernanceUsageInput, HistoryPolicy, HumanReply, 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, MessageUsage, ModelAnswer, 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, QuotaExceededError, QuotaState, type QuotaStore, REMEMBER_TOOL_DESCRIPTION, REMEMBER_TOOL_NAME, 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, ToolCallRequest, ToolCallStatus, type ToolCallWhere, ToolDefinition, ToolDisabledError, ToolForbiddenError, ToolHandler, ToolInputInvalidError, type ToolKindDeps, ToolNotFoundError, ToolRegistry, ToolResult, ToolSpec, type ToolStatRow, ToolStepEnvelope, ToolTransientRetrySetting, type TurnFrameSummary, 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, dayBoundsUtc, defaultScopeResolver, detachedDelivered, detachedStarted, detachedUnsettled, estimateCost, estimateMessageTokens, extractJson, filterToolsByAllowList, filterToolsByCanUse, filterToolsByEnabled, filterToolsByRole, gateFollowUps, gateTail, isControlFlowSignal, isReplayIntegrityError, isToolEnabled, loadSkill, memoryForgetVerdict, memoryWriteVerdict, normalizeDelegation, observeTurnFrames, offerMemories, offerSkills, publishAgentDelegated, publishAgentMemoryResolved, publishAgentMemoryWritten, publishAgentMessage, publishAgentQuotaExceeded, publishAgentRetrieved, publishAgentRunFailed, publishAgentRunFinished, publishAgentRunStarted, publishAgentSkillsResolved, publishAgentToolCall, publishAgentToolRetry, releaseGatedFrames, rememberInputSchema, rememberToolDefinition, repairInstruction, resolveGateLookback, resolveMemoryDigest, resolveOutputGateMode, resolveSkillCatalog, rollupThreadUsage, runAgentLoop, runInputProcessors, runOutputProcessors, seedModelPrices, settleAll, settleUnsettledDelegation, skillInputSchema, skillToolDefinition, skillWriteVerdict, stampToolKinds, staticSkillProvider, summarizeWithModel, tenantScope, traceLlmTurn, traceToolExecution, truncateDetailContent, validateStructured, windowHistory, withAskTool, withMemoryTool, withSkillTool, withToolTimeout, withTurnFrames, writeMemory };