librechat-data-provider 0.8.522 → 0.8.523

package/dist/types/svg.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DOMPurify policy for user-provided SVG icons, shared by the browser uploader and
+ * the server trust boundary so a preview and the persisted icon cannot disagree.
+ * `use` is re-added for self-contained `<defs>` references (targets restricted by
+ * `restrictSvgReferences`); every SMIL element is forbidden so a stored icon
+ * cannot animate forever wherever it renders.
+ */
+export declare const SVG_SANITIZE_CONFIG: {
+    USE_PROFILES: {
+        svg: boolean;
+        svgFilters: boolean;
+    };
+    ADD_TAGS: string[];
+    ADD_ATTR: string[];
+    FORBID_TAGS: string[];
+    FORBID_ATTR: string[];
+};
+/** Element surface shared by the browser DOM and the server's jsdom. */
+export interface SvgAttributeHost {
+    attributes: ArrayLike<{
+        name: string;
+    }>;
+    getAttribute(name: string): string | null;
+    removeAttribute(name: string): void;
+}
+/** DOMPurify hook that drops every attribute referencing outside the document. */
+export declare function restrictSvgReferences(node: SvgAttributeHost): void;
+/**
+ * Makes HTML-mode sanitizer output valid as a standalone `image/svg+xml`
+ * document: restores camelCase element names the HTML parser lowercased and
+ * declares the SVG namespace on the root, without which an XML parser puts the
+ * root in no namespace and the icon renders blank.
+ */
+export declare function finalizeSvgMarkup(markup: string): string;

package/dist/types/types/agents.d.ts

@@ -75,11 +75,15 @@ export declare namespace Agents {
             taskId: string;
             toolName: string;
             status: 'completed' | 'error';
+            /** Additive rolling-deploy-compatible cancellation discriminator. */
+            cancelled?: true;
             settledAt: Date;
             resultClaim?: {
                 kind: 'manual' | 'wakeup';
                 claimId: string;
                 claimedAt: Date;
+                /** Response generation that owns a manual delivery claim. */
+                generationId?: string;
             };
         };
         /** The tool call was rejected before execution because its input failed schema validation. */
@@ -383,6 +387,8 @@ export declare namespace Agents {
         tool_call_id: string;
         /** Optional human-readable description shown alongside the prompt */
         description?: string;
+        /** Server-authored provenance. Absent for user, MCP, action, and older tool calls. */
+        source?: 'librechat_code';
     }
     /**
      * Per-call review configuration: which decisions the user is allowed to make.
@@ -485,6 +491,8 @@ export declare namespace Agents {
          * so the id check can't.
          */
         requestFingerprint?: string;
+        /** Current-version fingerprint; server-only and omitted from client projections. */
+        requestFingerprintV2?: string;
         /**
          * Graph-determining request fields (endpoint, agent_id, model, spec, promptPrefix,
          * ephemeralAgent) captured at pause. The resume route REPLAYS these onto the request
@@ -492,6 +500,22 @@ export declare namespace Agents {
          * no longer reconstruct the ephemeral config — still rebuilds the same agent/graph.
          */
         resumeContext?: Record<string, unknown>;
+        /**
+         * Opaque, server-only identity of the stateful code targets selected when a
+         * tool approval paused. Resume rejects a changed target before provider or
+         * tool execution so an approval cannot migrate to another VM or workspace.
+         */
+        codeExecutionBinding?: CodeExecutionApprovalBinding;
+    }
+    interface CodeExecutionApprovalTargetBinding {
+        /** Agent identity when available; anonymous ephemeral agents use null. */
+        agentId: string | null;
+        /** SHA-256 of the resolved route, worker and runtime-session identity. */
+        targetHash: string;
+    }
+    interface CodeExecutionApprovalBinding {
+        version: 1;
+        targets: CodeExecutionApprovalTargetBinding[];
     }
     /**
      * Scope of a tool-approval decision — drives the "remember this" persistence

package/dist/types/types/assistants.d.ts

@@ -1,8 +1,9 @@
+import { z } from 'zod';
 import type { OpenAPIV3 } from 'openapi-types';
 import type { AssistantsEndpoint, AgentProvider, MemoryScope, SkillsScope } from 'src/schemas';
 import type { StatefulCodeEnvironment } from '../stateful-code';
+import type { ContentTypes, SubagentIdentity } from './runs';
 import type { Agents, GraphEdge } from './agents';
-import type { ContentTypes } from './runs';
 import type { TFile } from './files';
 import { ArtifactModes } from 'src/artifacts';
 export { STATEFUL_CODE_ENVIRONMENTS, resolveStatefulCodeEnvironment, resolveAllowedStatefulCodeEnvironments, } from '../stateful-code';
@@ -267,11 +268,20 @@ export type AgentSubagentsConfig = {
     enabled?: boolean;
     /** When true (default), the agent may spawn itself in an isolated context. */
     allowSelf?: boolean;
+    /** Share current-turn files with authorized descendants. Off unless explicitly enabled. */
+    shareFiles?: boolean;
     /** Specific agents that may be spawned as subagents. */
     agent_ids?: string[];
     /** Explicit saved-agent teams that may be spawned as bounded child graphs. */
     graphs?: AgentSubagentGraph[];
 };
+export type AgentGitIdentity = {
+    /** Commit author and committer display name. */
+    name: string;
+    /** Commit author and committer email address. */
+    email: string;
+};
+export declare const agentGitIdentitySchema: z.ZodType<AgentGitIdentity | undefined>;
 export type Agent = {
     _id?: string;
     id: string;
@@ -304,6 +314,10 @@ export type Agent = {
     stateful_code_environment?: StatefulCodeEnvironment;
     /** Operator-configured managed or attached stateful execution environment. */
     code_environment_id?: string | null;
+    /** Default attached workspace for new chats; empty means no agent default. */
+    code_workspace_id?: string;
+    /** Non-secret Git authorship injected into this agent's sandboxed commands. */
+    git_identity?: AgentGitIdentity | null;
     artifacts?: ArtifactModes;
     recursion_limit?: number;
     isPublic?: boolean;
@@ -344,6 +358,7 @@ export type Agent = {
 };
 export type TAgentsMap = Record<string, Agent | undefined>;
 export type AgentCreateParams = {
+    git_identity?: AgentGitIdentity;
     name?: string | null;
     description?: string | null;
     avatar?: AgentAvatar | null;
@@ -353,7 +368,7 @@ export type AgentCreateParams = {
     provider: AgentProvider;
     model: string | null;
     model_parameters: AgentModelParameters;
-} & Pick<Agent, 'agent_ids' | 'edges' | 'end_after_tools' | 'hide_sequential_outputs' | 'stateful_code_sessions' | 'stateful_code_environment' | 'code_environment_id' | 'artifacts' | 'recursion_limit' | 'category' | 'support_contact' | 'tool_options' | 'skills' | 'skills_enabled' | 'skill_authoring_enabled' | 'skills_scope' | 'subagents' | 'memory_scope'>;
+} & Pick<Agent, 'agent_ids' | 'edges' | 'end_after_tools' | 'hide_sequential_outputs' | 'stateful_code_sessions' | 'stateful_code_environment' | 'code_environment_id' | 'code_workspace_id' | 'artifacts' | 'recursion_limit' | 'category' | 'support_contact' | 'tool_options' | 'skills' | 'skills_enabled' | 'skill_authoring_enabled' | 'skills_scope' | 'subagents' | 'memory_scope'>;
 export type AgentUpdateParams = {
     name?: string | null;
     description?: string | null;
@@ -365,7 +380,7 @@ export type AgentUpdateParams = {
     provider?: AgentProvider;
     model?: string | null;
     model_parameters?: AgentModelParameters;
-} & Pick<Agent, 'agent_ids' | 'edges' | 'end_after_tools' | 'hide_sequential_outputs' | 'stateful_code_sessions' | 'stateful_code_environment' | 'code_environment_id' | 'artifacts' | 'recursion_limit' | 'category' | 'support_contact' | 'tool_options' | 'skills' | 'skills_enabled' | 'skill_authoring_enabled' | 'skills_scope' | 'subagents' | 'memory_scope'>;
+} & Pick<Agent, 'agent_ids' | 'edges' | 'end_after_tools' | 'hide_sequential_outputs' | 'stateful_code_sessions' | 'stateful_code_environment' | 'code_environment_id' | 'git_identity' | 'code_workspace_id' | 'artifacts' | 'recursion_limit' | 'category' | 'support_contact' | 'tool_options' | 'skills' | 'skills_enabled' | 'skill_authoring_enabled' | 'skills_scope' | 'subagents' | 'memory_scope'>;
 export type AgentListParams = {
     limit?: number;
     requiredPermission: number;
@@ -513,6 +528,8 @@ export declare enum RunStatus {
     EXPIRED = "expired"
 }
 export type PartMetadata = {
+    /** Host-resolved execution identity for a saved subagent invocation. */
+    subagentIdentity?: SubagentIdentity;
     progress?: number;
     asset_pointer?: string;
     status?: string;
@@ -575,6 +592,13 @@ export type SummaryContentPart = {
     }>;
     tokenCount?: number;
     summarizing?: boolean;
+    /** A summarize round that ended in error. Partial deltas already streamed
+     *  into this slot are kept, so the renderer needs this to avoid presenting
+     *  truncated text under the "Conversation summarized" label. */
+    failed?: boolean;
+    /** Set when the user compacted the context manually rather than the
+     *  automatic detour firing on context pressure. */
+    initiatedBy?: 'user';
     summaryVersion?: number;
     model?: string;
     provider?: string;

package/dist/types/types/files.d.ts

@@ -1,3 +1,4 @@
+import type { TDefaultLLMDeliveryPathConfig } from '../file-config';
 import type { CodeEnvRef, CodeEnvRefMap } from '../codeEnvRef';
 import { EToolResources } from './assistants';
 export declare enum FileSources {
@@ -26,6 +27,7 @@ export declare enum FileContext {
     image_generation = "image_generation",
     assistants_output = "assistants_output",
     message_attachment = "message_attachment",
+    run_artifact = "run_artifact",
     skill_file = "skill_file",
     filename = "filename",
     updatedAt = "updatedAt",
@@ -44,6 +46,8 @@ export type EndpointFileConfig = {
     fileSizeLimit?: number;
     totalSizeLimit?: number;
     supportedMimeTypes?: RegexLike[];
+    defaultLLMDeliveryPath?: TDefaultLLMDeliveryPathConfig;
+    legacyFileUploadUX?: boolean;
 };
 export type FileConfig = {
     endpoints: {
@@ -53,6 +57,10 @@ export type FileConfig = {
         fileSizeLimit?: number;
     };
     fileTokenLimit?: number;
+    /** Maximum aggregate model-bound attachment bytes admitted into one agent turn. */
+    fileContextSizeLimit?: number;
+    /** Maximum aggregate extracted-text characters admitted into one agent turn. */
+    fileContextCharLimit?: number;
     serverFileSizeLimit?: number;
     avatarSizeLimit?: number;
     clientImageResize?: {
@@ -73,6 +81,8 @@ export type FileConfig = {
         supportedMimeTypes?: RegexLike[];
     };
     checkType?: (fileType: string, supportedTypes: RegexLike[]) => boolean;
+    defaultLLMDeliveryPath?: TDefaultLLMDeliveryPathConfig;
+    legacyFileUploadUX?: boolean;
 };
 export type FileConfigInput = {
     endpoints?: {
@@ -83,6 +93,8 @@ export type FileConfigInput = {
     };
     serverFileSizeLimit?: number;
     avatarSizeLimit?: number;
+    fileContextSizeLimit?: number;
+    fileContextCharLimit?: number;
     clientImageResize?: {
         enabled?: boolean;
         maxWidth?: number;
@@ -99,6 +111,20 @@ export type FileConfigInput = {
         supportedMimeTypes?: string[];
     };
     checkType?: (fileType: string, supportedTypes: RegexLike[]) => boolean;
+    defaultLLMDeliveryPath?: TDefaultLLMDeliveryPathConfig;
+    legacyFileUploadUX?: boolean;
+};
+/** The immutable origin of a file explicitly published from an agent execution. */
+export type RunFileProvenance = {
+    runId: string;
+    executionId: string;
+    agentId: string;
+    parentExecutionId?: string;
+    parentAgentId?: string;
+    recipientAgentIds?: string[];
+    sourceFileId: string;
+    publishedAt: string;
+    inputFileIds: string[];
 };
 export type TFile = {
     _id?: string;
@@ -150,6 +176,7 @@ export type TFile = {
      */
     previewError?: string;
     metadata?: {
+        runFile?: RunFileProvenance;
         fileIdentifier?: string;
         /**
          * Structured form of `fileIdentifier`. Persisted alongside the
@@ -160,7 +187,14 @@ export type TFile = {
         codeEnvRefs?: CodeEnvRefMap;
         /** Dispatch-order stamp for the current source artifact generation. */
         sourceDispatchedAt?: number;
+        /** Vector namespaces this file has been embedded into. */
+        embeddedEntities?: string[];
+        /** The user named this destination, so absent ones were declined. */
+        destinationChosen?: boolean;
+        /** The type the delivery route was resolved against, when conversion changed it. */
+        routingMimeType?: string;
     };
+    llmDeliveryPath?: 'provider' | 'text' | 'none';
     createdAt?: string | Date;
     updatedAt?: string | Date;
 };

package/dist/types/types/insights.d.ts

@@ -2,15 +2,21 @@ export type InsightsRange = '24h' | '7d' | '30d' | 'custom';
 export declare const INSIGHTS_MAX_RANGE_DAYS = 30;
 export declare const INSIGHTS_SEARCH_MIN_LENGTH = 3;
 export declare const INSIGHTS_SEARCH_MAX_LENGTH = 200;
+export declare const INSIGHTS_AGENT_ID_MAX_LENGTH = 256;
 export type TInsightsParams = {
     range?: InsightsRange;
     fromTimestamp?: string;
     toTimestamp?: string;
     timeZone?: string;
     search?: string;
+    agentIds?: string[];
     page?: number;
     pageSize?: number;
 };
+export type TInsightsAgent = {
+    id: string;
+    name: string;
+};
 export type TInsightsDailyPoint = {
     date: string;
     conversations: number;
@@ -31,6 +37,8 @@ export type TInsightsChurnedUser = TInsightsUser & {
 };
 export type TInsightsConversation = {
     conversationId: string;
+    agentId: string;
+    agentName: string;
     date: string;
     userId: string;
     name: string;
@@ -46,6 +54,7 @@ export type TInsightsSummary = {
     totalTokens: number;
 };
 export type TInsightsResponse = {
+    agents: TInsightsAgent[];
     summary: TInsightsSummary;
     daily: TInsightsDailyPoint[];
     topUsers: TInsightsUser[];

package/dist/types/types/queries.d.ts

@@ -22,7 +22,7 @@ export type ConversationListParams = {
     search?: string;
     projectId?: string;
 };
-export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'archivedAt' | 'user' | 'chatProjectId' | 'pinned'>;
+export type MinimalConversation = Pick<s.TConversation, 'conversationId' | 'endpoint' | 'title' | 'createdAt' | 'updatedAt' | 'archivedAt' | 'isArchived' | 'user' | 'chatProjectId' | 'pinned'>;
 export type ConversationListResponse = {
     conversations: MinimalConversation[];
     nextCursor: string | null;
@@ -103,6 +103,10 @@ export type MCPServer = {
     name: string;
     icon: string;
     authenticated: boolean;
+    /** Passive discovery found that stored OAuth authorization must be renewed. */
+    authorizationState?: 'reauth_required';
+    /** Shared credential/catalog generation observed by passive discovery. */
+    authorizationGeneration?: string;
     authConfig: s.TPluginAuthConfig[];
     tools: MCPTool[];
 };
@@ -194,6 +198,8 @@ export interface MCPServerStatus {
     configurationState?: 'configured' | 'needs_configuration';
     connectionState: 'disconnected' | 'connecting' | 'connected' | 'error';
     authorizationState?: 'not_required' | 'authorizing' | 'authorized' | 'needs_authorization' | 'error';
+    /** Shared credential/catalog generation observed by the status endpoint. */
+    authorizationGeneration?: string;
 }
 export interface MCPConnectionStatusResponse {
     success: boolean;
@@ -209,6 +215,7 @@ export interface MCPServerConnectionStatusResponse {
     configurationState?: MCPServerStatus['configurationState'];
     connectionStatus: 'disconnected' | 'connecting' | 'connected' | 'error';
     authorizationState?: MCPServerStatus['authorizationState'];
+    authorizationGeneration?: string;
 }
 export interface MCPAuthValuesResponse {
     success: boolean;

package/dist/types/types/queuedTurns.d.ts

@@ -62,9 +62,9 @@ export declare const enqueueAgentQueuedTurnSchema: z.ZodObject<{
     priority: z.ZodOptional<z.ZodBoolean>;
     expectedPredecessorCreatedAt: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    text: string;
     conversationId: string;
     parentMessageId: string;
-    text: string;
     clientRequestId: string;
     manualSkills?: string[] | undefined;
     quotes?: string[] | undefined;
@@ -80,9 +80,9 @@ export declare const enqueueAgentQueuedTurnSchema: z.ZodObject<{
     }[] | undefined;
     priority?: boolean | undefined;
 }, {
+    text: string;
     conversationId: string;
     parentMessageId: string;
-    text: string;
     clientRequestId: string;
     manualSkills?: string[] | undefined;
     quotes?: string[] | undefined;
@@ -177,11 +177,11 @@ export declare const agentQueuedTurnReceiptSchema: z.ZodObject<{
     updatedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+    text: string;
     conversationId: string;
     parentMessageId: string;
     createdAt: string;
     updatedAt: string;
-    text: string;
     clientRequestId: string;
     queuedTurnId: string;
     revision: number;
@@ -207,11 +207,11 @@ export declare const agentQueuedTurnReceiptSchema: z.ZodObject<{
     } | undefined;
 }, {
     status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+    text: string;
     conversationId: string;
     parentMessageId: string;
     createdAt: string;
     updatedAt: string;
-    text: string;
     clientRequestId: string;
     queuedTurnId: string;
     revision: number;
@@ -314,11 +314,11 @@ export declare const enqueueAgentQueuedTurnResponseSchema: z.ZodObject<{
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -344,11 +344,11 @@ export declare const enqueueAgentQueuedTurnResponseSchema: z.ZodObject<{
         } | undefined;
     }, {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -392,11 +392,11 @@ export declare const enqueueAgentQueuedTurnResponseSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     receipt: {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -430,11 +430,11 @@ export declare const enqueueAgentQueuedTurnResponseSchema: z.ZodObject<{
 }, {
     receipt: {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -527,11 +527,11 @@ export declare const listAgentQueuedTurnsResponseSchema: z.ZodObject<{
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -557,11 +557,11 @@ export declare const listAgentQueuedTurnsResponseSchema: z.ZodObject<{
         } | undefined;
     }, {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -613,11 +613,11 @@ export declare const listAgentQueuedTurnsResponseSchema: z.ZodObject<{
     };
     queuedTurns: {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -652,11 +652,11 @@ export declare const listAgentQueuedTurnsResponseSchema: z.ZodObject<{
     };
     queuedTurns: {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -743,11 +743,11 @@ export declare const cancelAgentQueuedTurnResponseSchema: z.ZodObject<{
         updatedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -773,11 +773,11 @@ export declare const cancelAgentQueuedTurnResponseSchema: z.ZodObject<{
         } | undefined;
     }, {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -805,11 +805,11 @@ export declare const cancelAgentQueuedTurnResponseSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     receipt: {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;
@@ -837,11 +837,11 @@ export declare const cancelAgentQueuedTurnResponseSchema: z.ZodObject<{
 }, {
     receipt: {
         status: "cancelled" | "queued" | "claimed" | "admitted" | "dead";
+        text: string;
         conversationId: string;
         parentMessageId: string;
         createdAt: string;
         updatedAt: string;
-        text: string;
         clientRequestId: string;
         queuedTurnId: string;
         revision: number;

package/dist/types/types/runs.d.ts

@@ -234,6 +234,10 @@ export type TTokenBudgetBreakdown = {
     toolTokenCounts?: Record<string, number>;
     /** Names of counted tools that are deferred (`defer_loading`) and discovered */
     deferredToolNames?: string[];
+    /** Calibrated retained tool traffic: tool results plus assistant turns made only of tool calls, inline provider tool results and reasoning. A subset of messageTokens, not an additional budget category. */
+    toolMessageTokens?: number;
+    /** Per-tool result-message share; excludes assistant invocation overhead. */
+    toolMessageTokenCounts?: Record<string, number>;
 };
 /** Per-model-call context snapshot, dispatched after pruning and before the LLM call. */
 export type TContextUsageEvent = {
@@ -249,12 +253,21 @@ export type TContextUsageEvent = {
     /** Tokens still free after instructions + pruned messages */
     remainingContextTokens?: number;
     calibrationRatio?: number;
+    /** Model and provider of the reconciling primary call, retained across reloads. */
+    model?: string;
+    provider?: string;
+    /** Cache portions of that call's prompt, in normalized display units. */
+    cacheRead?: number;
+    cacheWrite?: number;
     /** Output tokens of the response's final model call (the call this pre-invoke
-     *  snapshot precedes). Populated only on the persisted `metadata.contextUsage`
-     *  blob so a reloaded multi-call turn adds the same post-snapshot delta the
+     *  snapshot precedes). Saved in message metadata and used by the client so a
+     *  reloaded multi-call turn adds the same post-snapshot delta the
      *  live finalizer did — not the full response `tokenCount`, which the snapshot
      *  already includes for earlier steps. */
     completedOutputTokens?: number;
+    /** Completed output in a resumable job. Separate from the saved-message field
+     * so older clients do not add it alongside their trailing-text estimate. */
+    resumedOutputTokens?: number;
 };
 /**
  * Per-response usage rollup persisted on `responseMessage.metadata.usage`, in
@@ -310,14 +323,19 @@ export declare const promptTokensFromUsage: (event: TTokenUsageEvent) => number;
 /**
  * Reconciles a pre-invoke context snapshot's CALIBRATED estimate to a call's
  * ACTUAL prompt tokens. The SDK's calibration multiplier scales only
- * `messageTokens` (instructions/summary are raw tiktoken counts), and it can
+ * `messageTokens` (instructions/summary are raw tiktoken counts) and can
  * over-shoot badly when a provider injects server-side content the SDK never
  * counted (e.g. Anthropic web search) — pinning the gauge several× too high and
  * persisting it. Trust the provider's own prompt count: keep the raw
- * instruction/summary rows, set `messageTokens` to the remainder, and recompute
- * the free space. No-op when `promptTokens` is unusable.
+ * instruction/summary rows, set `messageTokens` to the remainder, recompute the
+ * free space, and rescale the `toolMessageTokens` share to the new message
+ * total. No-op when `promptTokens` is unusable.
  */
 export declare const reconcileContextUsage: (snapshot: TContextUsageEvent, promptTokens: number) => TContextUsageEvent;
+/** Provider output, including reasoning omitted from an under-reported output count. */
+export declare const outputTokensFromUsage: (event: TTokenUsageEvent) => number;
+/** Reconcile and retain the primary call details on live, saved, and resumable snapshots. */
+export declare const reconcileContextUsageFromEvent: (snapshot: TContextUsageEvent, event: TTokenUsageEvent) => TContextUsageEvent;
 /** Lifecycle phase carried on subagent-progress envelopes (mirrors SDK SubagentUpdatePhase). */
 export type SubagentUpdatePhase = 'start' | 'run_step' | 'run_step_delta' | 'run_step_completed' | 'run_step_closed' | 'message_delta' | 'reasoning_delta' | 'stop' | 'error';
 /** Structured root-to-leaf identity for one nested subagent execution. */
@@ -331,6 +349,7 @@ export interface SubagentAncestryEntry {
     readonly parentAgentId?: string;
     readonly parentToolCallId?: string;
 }
+export type SubagentIdentity = Pick<SubagentAncestryEntry, 'subagentKind' | 'subagentAgentId'>;
 /** Single streamed subagent update forwarded by the SDK's SubagentExecutor. */
 export interface SubagentUpdateEvent {
     runId: string;