@astralbeam/sdk 0.15.2 → 0.17.0

package/dist/{index-DUznpmNz.d.ts → index-NT05_Yw_.d.ts}

@@ -1,4 +1,4 @@
-import { f as CurrentUser } from "./api-DUe8JSVU.js";
+import { H as CurrentUser, kt as UploadedChatFile } from "./index-CfGnT6Od.js";
 
 //#region node_modules/.deno/@standard-schema+spec@1.1.0/node_modules/@standard-schema/spec/dist/index.d.ts
 /** The Standard Typed interface. This is a base type extended by other specs. */
@@ -117,7 +117,7 @@ declare namespace StandardJSONSchemaV1 {
   type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.63.0/node_modules/@tanstack/ai/dist/esm/interrupts.d.ts
+//#region node_modules/.deno/@tanstack+ai@0.68.0/node_modules/@tanstack/ai/dist/esm/interrupts.d.ts
 interface InterruptCorrelation {
   threadId: string;
   interruptedRunId: string;
@@ -198,7 +198,7 @@ declare global {
   var __TANSTACK_EVENT_TARGET__: EventTarget | null;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-event-client@0.13.0/node_modules/@tanstack/ai-event-client/dist/esm/envelope.d.ts
+//#region node_modules/.deno/@tanstack+ai-event-client@0.13.1/node_modules/@tanstack/ai-event-client/dist/esm/envelope.d.ts
 type AIDevtoolsEventSource = 'client' | 'server' | 'devtools';
 type AIDevtoolsEventVisibility = 'user-visible' | 'client-state' | 'server-internal' | 'devtools-action';
 interface AIDevtoolsEventEnvelope {
@@ -224,7 +224,7 @@ declare global {
   var __TANSTACK_AI_DEVTOOLS_RUNTIME_ID__: string | undefined;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-event-client@0.13.0/node_modules/@tanstack/ai-event-client/dist/esm/index.d.ts
+//#region node_modules/.deno/@tanstack+ai-event-client@0.13.1/node_modules/@tanstack/ai-event-client/dist/esm/index.d.ts
 /**
  * Detailed breakdown of prompt/input token usage.
  * Fields are populated based on provider support.
@@ -2838,11 +2838,11 @@ type SubagentInfo = {
  * pick one.
  */
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.63.0/node_modules/@tanstack/ai/dist/esm/utilities/ag-ui-usage.d.ts
+//#region node_modules/.deno/@tanstack+ai@0.68.0/node_modules/@tanstack/ai/dist/esm/utilities/ag-ui-usage.d.ts
 /** TokenUsage fields that have no AG-UI `usage[]` equivalent. */
 type TokenUsageLeftover = Omit<TokenUsage$1, 'promptTokens' | 'completionTokens' | 'totalTokens'>;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.63.0/node_modules/@tanstack/ai/dist/esm/types.d.ts
+//#region node_modules/.deno/@tanstack+ai@0.68.0/node_modules/@tanstack/ai/dist/esm/types.d.ts
 /**
  * Tool call states - track the lifecycle of a tool call
  */
@@ -2978,9 +2978,15 @@ interface ModelMessage<TContent extends string | null | Array<ContentPart> = str
   name?: string;
   toolCalls?: Array<ToolCall>;
   toolCallId?: string;
+  /**
+   * Signed thinking to send back to the provider. `redacted: true` marks a
+   * block the provider encrypted: `content` is empty and `signature` holds its
+   * opaque data. See `ThinkingPart.signature` for the planned rename.
+   */
   thinking?: Array<{
     content: string;
     signature?: string;
+    redacted?: boolean;
   }>;
   /** Error reported by an AG-UI tool message. */
   error?: string;
@@ -3061,7 +3067,28 @@ interface ThinkingPart$1 {
   type: 'thinking';
   content: string;
   stepId?: string;
+  /**
+   * The provider's opaque reasoning artefact, sent back unchanged: an
+   * Anthropic signature, Anthropic redacted data, or OpenAI encrypted content.
+   * TODO(#1581): rename to `encryptedValue` to match AG-UI's `ReasoningMessage`.
+   * Renaming breaks stored messages, so it needs a read shim for `signature`.
+   */
   signature?: string;
+  /**
+   * The provider encrypted this thinking block (Anthropic `redacted_thinking`).
+   * `content` is empty, and `signature` holds the opaque data that goes back
+   * to the provider unchanged. On the AG-UI wire, the reasoning message id
+   * starts with `redacted_thinking-` instead.
+   */
+  redacted?: boolean;
+}
+/**
+ * Frontend-only AG-UI activity. Never converted into ModelMessage input.
+ * Mirrors {@link https://docs.ag-ui.com/concepts/messages | ActivityMessage}:
+ * `activityType` selects a renderer; `content` is the structured payload.
+ */
+interface ActivityPart extends Pick<ActivityMessage, 'activityType' | 'content' | 'subagentRunId'> {
+  type: 'activity';
 }
 /**
  * Recursive `Partial` — every nested field becomes optional. Used as the
@@ -3077,14 +3104,21 @@ type DeepPartial<T> = T extends ReadonlyArray<infer U> ? Array<DeepPartial<U>> :
  * consumers can thread `useChat({ outputSchema })`'s schema all the way down
  * to `messages[i].parts[j].data`. Defaults to `unknown` so untyped consumers
  * (e.g. internal codepaths that don't know about TSchema) keep working.
- */
-interface StructuredOutputPart<TData = unknown> {
+ *
+ * Discriminated on `status`: checking `status === 'complete'` narrows `data`
+ * to `TData`.
+ */
+type StructuredOutputPart<TData = unknown> = (StructuredOutputPartBase<TData> & {
+  status: 'streaming' | 'error'; /** Not set until `status === 'complete'`. */
+  data?: undefined;
+}) | (StructuredOutputPartBase<TData> & {
+  status: 'complete'; /** Validated final object. */
+  data: TData;
+});
+interface StructuredOutputPartBase<TData> {
   type: 'structured-output';
-  status: 'streaming' | 'complete' | 'error';
   /** Progressive parse of `raw` via parsePartialJSON — populated while streaming and after complete. */
   partial?: DeepPartial<TData>;
-  /** Validated final object — only set when `status === 'complete'`. */
-  data?: TData;
   /** Accumulating JSON buffer. Source of truth for wire round-trip. */
   raw: string;
   /** Optional chain-of-thought surfaced by reasoning models alongside the structured output. */
@@ -3135,7 +3169,7 @@ interface UIResourcePart {
    *  Currently always `undefined` — nothing populates this field yet. */
   meta?: Record<string, unknown>;
 }
-type MessagePart$1<TData = unknown> = TextPart$1 | ImagePart | AudioPart | VideoPart | DocumentPart | ToolCallPart$2 | ToolResultPart$1 | ThinkingPart$1 | StructuredOutputPart<TData> | UIResourcePart | SubagentPart$1;
+type MessagePart$1<TData = unknown> = TextPart$1 | ImagePart | AudioPart | VideoPart | DocumentPart | ToolCallPart$2 | ToolResultPart$1 | ThinkingPart$1 | ActivityPart | StructuredOutputPart<TData> | UIResourcePart | SubagentPart$1;
 /**
  * Shape of `metadata.tanstack` on run events.
  */
@@ -3149,6 +3183,8 @@ interface TanStackRunMetadata {
   runId?: string;
   sessionId?: string;
   index?: number;
+  /** On a `RUN_ERROR`. See `RunErrorEvent.retryAfterMs`. */
+  retryAfterMs?: number;
   state?: ToolOutputState;
   /** Parsed `TOOL_CALL_END` input. Spec `TOOL_CALL_END` has no top-level `input`. */
   input?: unknown;
@@ -3162,7 +3198,7 @@ interface TanStackRunMetadata {
  */
 interface UIMessage$1<TData = unknown> {
   id: string;
-  role: 'system' | 'user' | 'assistant';
+  role: 'system' | 'user' | 'assistant' | 'activity';
   parts: Array<MessagePart$1<TData>>;
   createdAt?: Date;
   /** Optional AG-UI sender name. Converters preserve it across wire and persist. */
@@ -3424,6 +3460,12 @@ interface RunErrorEvent extends Pick<RunErrorEvent$1, 'message' | 'code' | 'time
     message: string;
     code?: string;
   };
+  /**
+   * How long the provider asks you to wait before a retry, in milliseconds.
+   * Adapters read it from the `retry-after-ms` or `retry-after` header.
+   * `chat()` moves it to `metadata.tanstack.retryAfterMs`.
+   */
+  retryAfterMs?: number;
   metadata?: {
     tanstack?: TanStackRunMetadata;
   } & Record<string, any>;
@@ -3563,10 +3605,24 @@ interface ReasoningEndEvent extends ReasoningEndEvent$1 {}
  * @ag-ui/core provides: `subtype`, `entityId`, `encryptedValue`
  */
 interface ReasoningEncryptedValueEvent extends ReasoningEncryptedValueEvent$1 {}
-/** AG-UI 1.0 ActivitySnapshotEvent shape. */
-interface ActivitySnapshotEvent extends ActivitySnapshotEvent$1 {}
-/** AG-UI 1.0 ActivityDeltaEvent shape. */
-interface ActivityDeltaEvent extends ActivityDeltaEvent$1 {}
+/**
+ * Full activity state for an `ActivityMessage`.
+ *
+ * @ag-ui/core provides: `messageId`, `activityType`, `content`, `replace?`,
+ * `metadata?`, `subagentRunId?`. When `replace` is omitted it means `true`.
+ */
+interface ActivitySnapshotEvent extends Omit<ActivitySnapshotEvent$1, 'type'> {
+  type: 'ACTIVITY_SNAPSHOT';
+}
+/**
+ * RFC 6902 JSON Patch against an existing activity's `content`.
+ *
+ * @ag-ui/core provides: `messageId`, `activityType`, `patch`, `metadata?`,
+ * `subagentRunId?`
+ */
+interface ActivityDeltaEvent extends Omit<ActivityDeltaEvent$1, 'type'> {
+  type: 'ACTIVITY_DELTA';
+}
 /** AG-UI 1.0 RawEvent shape. */
 interface RawEvent extends RawEvent$1 {}
 /** AG-UI 1.0 TextMessageChunkEvent shape. */
@@ -3605,7 +3661,7 @@ interface SubagentErrorEvent extends SubagentErrorEvent$1 {}
  */
 type StreamChunk = AGUIEvent;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.63.0/node_modules/@tanstack/ai/dist/esm/interrupt-definition.d.ts
+//#region node_modules/.deno/@tanstack+ai@0.68.0/node_modules/@tanstack/ai/dist/esm/interrupt-definition.d.ts
 type PortableSchema = StandardJSONSchemaV1<any, any> | StandardSchemaV1$1<any, any>;
 type InterruptInput<TPayloadSchema extends PortableSchema | undefined, TPayload = unknown> = {
   key: string;
@@ -3647,7 +3703,7 @@ interface InterruptDefinition<TId extends string, TPayloadSchema extends Portabl
   interrupt: InterruptRequestMethod<TId, TPayloadSchema, TResponseSchema, TPayload, TPayloadInput>;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.63.0/node_modules/@tanstack/ai/dist/esm/activities/chat/tools/tool-definition.d.ts
+//#region node_modules/.deno/@tanstack+ai@0.68.0/node_modules/@tanstack/ai/dist/esm/activities/chat/tools/tool-definition.d.ts
 /**
  * Type-level brand key for {@link ToolApprovalCapabilityMarker}. Only ever used
  * in type positions, but it must stay exported: a `unique symbol` referenced by
@@ -3728,52 +3784,52 @@ type InferToolOutput<T> = T extends {
   outputSchema?: infer TOutput;
 } ? TOutput extends StandardJSONSchemaV1<any, any> ? InferSchemaType<TOutput> : TOutput extends StandardSchemaV1$1<any, any> ? InferSchemaType<TOutput> : TOutput extends JSONSchema ? unknown : InferSchemaType<TOutput> : unknown;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.63.0/node_modules/@tanstack/ai/dist/esm/activities/chat/stream/types.d.ts
+//#region node_modules/.deno/@tanstack+ai@0.68.0/node_modules/@tanstack/ai/dist/esm/byok/define-provider.d.ts
 /**
- * Strategy for determining when to emit text updates
+ * A BYOK provider declared by an adapter. `id` is the `x-byok-<id>` slug and
+ * is required — `{ id?: string }` is not a {@link ByokProvider}.
  */
-interface ChunkStrategy {
+interface ByokProvider<TId extends string = string> {
+  readonly id: TId;
+  readonly label: string;
   /**
-   * Called for each text chunk received
-   * @param chunk - The new chunk of text (delta)
-   * @param accumulated - All text accumulated so far
-   * @returns true if an update should be emitted now
+   * Env var names the relay may read. Names only — never put `process.env`
+   * values here. This object is imported on the client.
    */
-  shouldEmit: (chunk: string, accumulated: string) => boolean;
+  readonly env?: ReadonlyArray<string>;
   /**
-   * Optional: Reset strategy state (called when streaming starts)
+   * Other descriptors this credential needs. A send for this provider also
+   * carries their headers and prompts for each one that is missing.
    */
-  reset?: () => void;
+  readonly with?: ReadonlyArray<ByokProvider>;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.63.0/node_modules/@tanstack/ai/dist/esm/byok/providers.d.ts
+//#region node_modules/.deno/@tanstack+ai@0.68.0/node_modules/@tanstack/ai/dist/esm/byok/providers.d.ts
 /**
  * Provider ids are open slugs, not a closed catalog. `@tanstack/ai` does not
  * list adapters. Any matching string is a valid id and becomes `x-byok-<id>`.
  */
 type ProviderId = string;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.63.0/node_modules/@tanstack/ai/dist/esm/byok/define-provider.d.ts
+//#region node_modules/.deno/@tanstack+ai@0.68.0/node_modules/@tanstack/ai/dist/esm/activities/chat/stream/types.d.ts
 /**
- * A BYOK provider declared by an adapter. `id` is the `x-byok-<id>` slug and
- * is required — `{ id?: string }` is not a {@link ByokProvider}.
+ * Strategy for determining when to emit text updates
  */
-interface ByokProvider<TId extends string = string> {
-  readonly id: TId;
-  readonly label: string;
+interface ChunkStrategy {
   /**
-   * Env var names the relay may read. Names only — never put `process.env`
-   * values here. This object is imported on the client.
+   * Called for each text chunk received
+   * @param chunk - The new chunk of text (delta)
+   * @param accumulated - All text accumulated so far
+   * @returns true if an update should be emitted now
    */
-  readonly env?: ReadonlyArray<string>;
+  shouldEmit: (chunk: string, accumulated: string) => boolean;
   /**
-   * Other descriptors this credential needs. A send for this provider also
-   * carries their headers and prompts for each one that is missing.
+   * Optional: Reset strategy state (called when streaming starts)
    */
-  readonly with?: ReadonlyArray<ByokProvider>;
+  reset?: () => void;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.0/node_modules/@tanstack/ai-client/dist/esm/byok/storage.d.ts
+//#region node_modules/.deno/@tanstack+ai-client@0.39.2/node_modules/@tanstack/ai-client/dist/esm/byok/storage.d.ts
 type Keyring = Partial<Record<ProviderId, string>>;
 type KeyPreview = Partial<Record<ProviderId, string>>;
 interface KeyringStorage {
@@ -3788,7 +3844,7 @@ interface KeyringStorage {
   clear: () => void | Promise<void>;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.0/node_modules/@tanstack/ai-client/dist/esm/byok/client.d.ts
+//#region node_modules/.deno/@tanstack+ai-client@0.39.2/node_modules/@tanstack/ai-client/dist/esm/byok/client.d.ts
 type KeyStatus = {
   state: 'empty';
 } | {
@@ -3843,7 +3899,7 @@ declare class ByokClient {
   unlock(): Promise<void>;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.0/node_modules/@tanstack/ai-client/dist/esm/events.d.ts
+//#region node_modules/.deno/@tanstack+ai-client@0.39.2/node_modules/@tanstack/ai-client/dist/esm/events.d.ts
 interface ChatClientRunEventContext {
   threadId: string;
   runId: string;
@@ -3863,7 +3919,7 @@ interface ChatClientToolFixtureAppliedEvent {
   execute?: boolean;
   message?: {
     id: string;
-    role: 'system' | 'user' | 'assistant';
+    role: UIMessage['role'];
     parts: Array<unknown>;
     createdAt?: number | string;
   };
@@ -3963,7 +4019,7 @@ declare abstract class ChatClientEventEmitter {
   toolFixtureApplied(fixture: ChatClientToolFixtureAppliedEvent): void;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.0/node_modules/@tanstack/ai-client/dist/esm/devtools.d.ts
+//#region node_modules/.deno/@tanstack+ai-client@0.39.2/node_modules/@tanstack/ai-client/dist/esm/devtools.d.ts
 interface AIDevtoolsDisplayOptions {
   name?: string;
 }
@@ -4131,10 +4187,10 @@ declare class ChatDevtoolsBridge extends ClientDevtoolsBridge<AIDevtoolsChatSnap
   private findClientTool;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.0/node_modules/@tanstack/ai-client/dist/esm/devtools-noop.d.ts
+//#region node_modules/.deno/@tanstack+ai-client@0.39.2/node_modules/@tanstack/ai-client/dist/esm/devtools-noop.d.ts
 type ChatDevtoolsBridgeFactory = (options: ChatDevtoolsBridgeOptions) => ChatDevtoolsBridge;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.0/node_modules/@tanstack/ai-client/dist/esm/types.d.ts
+//#region node_modules/.deno/@tanstack+ai-client@0.39.2/node_modules/@tanstack/ai-client/dist/esm/types.d.ts
 interface ChatResumeState {
   threadId: string;
   runId: string;
@@ -4606,7 +4662,7 @@ type SubagentPartOf<TAgents extends ReadonlyArray<SubagentClientAgent> | undefin
 };
 type MessagePart<TTools extends ReadonlyArray<{
   name: string;
-}> = any, TData = unknown, TSubagents extends ReadonlyArray<SubagentClientAgent> | undefined = undefined> = TextPart | ImagePart | AudioPart | VideoPart | DocumentPart | ToolCallPart$1<TTools> | ToolResultPart | ThinkingPart | StructuredOutputPart<TData> | UIResourcePart | SubagentPartOf<TSubagents>;
+}> = any, TData = unknown, TSubagents extends ReadonlyArray<SubagentClientAgent> | undefined = undefined> = TextPart | ImagePart | AudioPart | VideoPart | DocumentPart | ToolCallPart$1<TTools> | ToolResultPart | ThinkingPart | ActivityPart | StructuredOutputPart<TData> | UIResourcePart | SubagentPartOf<TSubagents>;
 /**
  * UIMessage - Domain-specific message format optimized for building chat UIs
  * Contains parts that can be text, tool calls, or tool results.
@@ -4623,7 +4679,7 @@ interface UIMessage<TTools extends ReadonlyArray<{
   name: string;
 }> = any, TData = unknown, TSubagents extends ReadonlyArray<SubagentClientAgent> | undefined = undefined> {
   id: string;
-  role: 'system' | 'user' | 'assistant';
+  role: 'system' | 'user' | 'assistant' | 'activity';
   name?: string;
   parts: Array<MessagePart<TTools, TData, TSubagents>>;
   createdAt?: Date;
@@ -4824,6 +4880,12 @@ interface ChatClientBaseOptions<TTools extends ReadonlyArray<AnyClientTool> = an
    * activity visible to all subscribers (e.g. across tabs/devices).
    */
   onSessionGeneratingChange?: (isGenerating: boolean) => void;
+  /**
+   * Callback when the client starts or stops rebuilding the chat from
+   * persistence (the server hydrate, or an async storage adapter). It turns
+   * false once the transcript is applied and any in-flight run is re-joined.
+   */
+  onHydratingChange?: (isHydrating: boolean) => void;
   /**
    * Policy for messages sent while the client is busy (streaming, claiming
    * a send, or draining the queue). Accepts a `WhenBusy` string, a
@@ -4905,7 +4967,7 @@ interface ChatClientBaseOptions<TTools extends ReadonlyArray<AnyClientTool> = an
  */
 type ChatClientOptions<TTools extends ReadonlyArray<AnyClientTool> = any, TContext = InferredClientContext<TTools>, TInterrupts extends ReadonlyArray<InterruptDefinition<any, any, any, any>> = readonly []> = DistributedOmit<ChatClientBaseOptions<TTools, TContext, TInterrupts>, 'context'> & ClientContextOptionFromTools<TTools, TContext> & ChatTransport & ChatPersistenceOptions<TTools>;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.0/node_modules/@tanstack/ai-client/dist/esm/connection-adapters.d.ts
+//#region node_modules/.deno/@tanstack+ai-client@0.39.2/node_modules/@tanstack/ai-client/dist/esm/connection-adapters.d.ts
 /**
  * Per-send context provided by the chat client to the connection adapter.
  * The adapter combines this with serialized messages to build a full
@@ -5068,7 +5130,7 @@ interface SubscribeConnectionAdapter {
  */
 type ConnectionAdapter = ConnectConnectionAdapter | SubscribeConnectionAdapter;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.0/node_modules/@tanstack/ai-client/dist/esm/chat-client.d.ts
+//#region node_modules/.deno/@tanstack+ai-client@0.39.2/node_modules/@tanstack/ai-client/dist/esm/chat-client.d.ts
 type ChatClientUpdateOptionsWithoutContext<TTools extends ReadonlyArray<AnyClientTool>, TInterrupts extends ReadonlyArray<InterruptDefinition<any, any, any, any>> = readonly []> = {
   connection?: ConnectionAdapter;
   fetcher?: ChatFetcher; /** @deprecated Use `forwardedProps` instead. */
@@ -5086,6 +5148,7 @@ type ChatClientUpdateOptionsWithoutContext<TTools extends ReadonlyArray<AnyClien
   onSubscriptionChange?: (isSubscribed: boolean) => void;
   onConnectionStatusChange?: (status: ConnectionStatus) => void;
   onSessionGeneratingChange?: (isGenerating: boolean) => void;
+  onHydratingChange?: (isHydrating: boolean) => void;
   onQueueChange?: (queue: Array<QueuedMessage>) => void;
   onResumeStateChange?: (resumeState: ChatResumeState | null, pendingInterrupts: BoundInterrupts<TTools, TInterrupts>) => void;
   /**
@@ -5180,6 +5243,7 @@ declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = any, TCon
   private currentMessageId;
   private readonly postStreamActions;
   private readonly pendingToolExecutions;
+  private handingOverPendingToolCalls;
   private activeClientTools;
   private activeContext;
   private continuationPending;
@@ -5205,6 +5269,12 @@ declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = any, TCon
   private hydrationError;
   /** Whether a view is currently watching. See `attach` / `detach`. */
   private tailing;
+  /** `historyGeneration` of the mount hydration GET still in flight, if any. */
+  private hydrationInFlight;
+  /** An async storage adapter is still reading the persisted transcript. */
+  private storeHydrating;
+  /** See {@link getIsHydrating}. */
+  private isHydrating;
   /** Constructor inputs `attach()` needs on every re-attach, not just the first. */
   private readonly rejoinRunId;
   private readonly cachesMessages;
@@ -5344,9 +5414,16 @@ declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = any, TCon
   private interruptGeneration;
   private generateUniqueId;
   private setIsLoading;
+  /**
+   * A send or a clear now owns the transcript. A load that is still pending can
+   * no longer paint it (the generation guards drop its result), so it no longer
+   * counts as hydrating.
+   */
+  private supersedeHydration;
   private setStatus;
   private setIsSubscribed;
   private setConnectionStatus;
+  private syncIsHydrating;
   private setSessionGenerating;
   private notifyResumeStateChange;
   /**
@@ -5643,6 +5720,13 @@ declare class ChatClient<TTools extends ReadonlyArray<AnyClientTool> = any, TCon
    * activity visible to all subscribers (e.g. across tabs/devices).
    */
   getSessionGenerating(): boolean;
+  /**
+   * Whether the client is rebuilding the chat from persistence: the server
+   * hydrate (`persistence: true`) or an async storage adapter. Turns false once
+   * the transcript is applied and any in-flight run is re-joined (from then on
+   * `isLoading` covers the stream), or when the load fails.
+   */
+  getIsHydrating(): boolean;
   /**
    * Get current error
    */
@@ -5748,8 +5832,10 @@ interface AstralBeamChatAttachmentOptions {
 type AstralBeamChatSlotRenderer = (container: HTMLElement) => (() => void) | void;
 /** Host-rendered replacements for the widget's own chrome; each renders in the host page's style. */
 interface AstralBeamChatSlots {
-  /** Replaces the header's content (title and reset button); `showHeader: false` still hides the row. */
+  /** Replaces the header's title; `showHeader: false` still hides the row. */
   header?: AstralBeamChatSlotRenderer | undefined;
+  /** Extra controls at the end of the header, after the history and new chat buttons. */
+  headerActions?: AstralBeamChatSlotRenderer | undefined;
   /** Replaces the empty-transcript state (icon, headline, and subtitle). */
   empty?: AstralBeamChatSlotRenderer | undefined;
   /** Extra controls at the end of the composer's button row, next to send. */
@@ -5799,19 +5885,26 @@ interface AstralBeamChatTheme {
 interface MountAstralBeamChatOptions {
   /**
    * Public ID of the organization-owned agent. Omit it to use the organization's default agent,
-   * which the dashboard's agents page selects. A change answers the next run with the new agent
-   * and keeps the transcript, which that agent then sees as history.
+   * which the dashboard's agents page selects. Saved conversations keep their agent,
+   * and an update applies to new threads.
    */
   agentId?: string | undefined;
+  /** Defaults to `"auto"`, restoring this tab's selection. Use `"new"` for a fresh chat, or a saved thread UUID. */
+  threadId?: string | undefined;
   /** Name shown in the widget's header. Default `"AstralBeam"`. */
   title?: string | undefined;
   /**
-   * Shows the widget's header, which carries the title and the reset button. `false` hides both
-   * and gives the transcript the full height. Default `true`.
+   * Shows the widget's header, which carries the title and the chat history and new chat buttons.
+   * `false` hides it and gives the transcript the full height. Default `true`.
    */
   showHeader?: boolean | undefined;
+  /**
+   * Shows a bar under the header with the open conversation's title, once it has one, and a menu
+   * to rename, delete, or copy it as Markdown. Default `false`.
+   */
+  showConversationTitle?: boolean | undefined;
   /** Headline shown on the empty transcript. Default `"Ask the assistant"`. */
-  emptyTitle?: string | undefined;
+  emptyHeadline?: string | undefined;
   /** Subtitle shown under the empty transcript's headline. Default describes the app's tools and widgets. */
   emptyDescription?: string | undefined;
   /**
@@ -5916,15 +6009,14 @@ interface SandboxCommandRun {
   truncated: boolean;
   finished: boolean;
 }
-/** One file the agent published for the user, with the ticket its download is authorized by. */
+/** One file the agent published for the user, with its durable stored reference. */
 interface SandboxArtifact {
   toolCallId: string;
   path: string;
   label: string;
   mimeType: string | undefined;
   size: number | undefined;
-  /** Capability the files endpoint accepts in its query; the whole download authorization. */
-  ticket: string | undefined;
+  fileId: string | undefined;
   published: boolean;
 }
 /** Everything the sandbox did in this conversation, derived from the transcript. */
@@ -6131,6 +6223,28 @@ type ChatAuthenticationState = {
   error: Error;
 };
 //#endregion
+//#region src/core/threads.d.ts
+/** A saved conversation visible to the signed-in tenant user. */
+interface ChatThread {
+  id: string;
+  title: string | null;
+  agentId: string | null;
+  version: number;
+  role: "viewer" | "member" | "manager";
+  writerActive: boolean;
+  hasMessages: boolean;
+  updatedAt: string;
+}
+interface ChatPendingInteraction {
+  sourceMessageId: string;
+  sourcePartId: string;
+  responseTargetId: string;
+  toolCallId: string;
+  targetTenantUserId: string | null;
+  targetClientId: string | null;
+  executionLocation: string;
+}
+//#endregion
 //#region src/core/session.d.ts
 /** A widget render the agent requested, handed to the host's `onRenderWidget`. */
 interface WidgetRenderRequest {
@@ -6154,11 +6268,17 @@ interface ChatStreamCallbacks {
   onFinish?: ((message: UIMessage) => void) | undefined;
   onError?: ((error: Error) => void) | undefined;
 }
+interface ChatSubmissionCallbacks {
+  /** Identifies the conversation before its input is sent, including a newly created chat. */
+  onThreadReady?: ((threadId: string) => void) | undefined;
+  /** Called once after the server acknowledges input, before generation finishes. */
+  onAccepted?: (() => void) | undefined;
+}
 /**
  * The transport and tool options of the drop-in widget, minus everything about its UI, plus this
  * session's own rendering hooks. The shared options are documented on `MountAstralBeamChatOptions`.
  */
-interface AstralBeamChatCoreOptions extends Pick<MountAstralBeamChatOptions, "agentId" | "apiUrl" | "fetchAstralBeamToken" | "tools" | "debug"> {
+interface AstralBeamChatCoreOptions extends Pick<MountAstralBeamChatOptions, "agentId" | "apiUrl" | "fetchAstralBeamToken" | "tools" | "debug" | "threadId"> {
   /** Widgets declared to the agent, without a `render`; `onRenderWidget` is asked to draw them. */
   widgets?: Record<string, WidgetDeclaration> | undefined;
   /** Draws an agent-requested widget however the host wants; may return a cleanup. */
@@ -6184,7 +6304,21 @@ interface AstralBeamChatState {
   /** The tool set currently declared to the agent, in declaration order. */
   agentTools: readonly AgentToolInfo[];
   sandboxStatus: SandboxStatus | undefined;
+  /** The usage limit that ended the last run, by display name, until another run starts. */
+  usageLimitReached: {
+    name: string;
+    resetsAt: string;
+  } | undefined;
   sandbox: SandboxActivity;
+  thread: ChatThread | undefined;
+  threadLoading: boolean;
+  threadLoadFailed: boolean;
+  messagesCursor: string | undefined;
+  olderMessagesLoading: boolean;
+  /** Retained until the server acknowledges the send, including after an uncertain network failure. */
+  unsentMessage: string | MultimodalContent | undefined;
+  activeToolCallIds: readonly string[];
+  pendingInteractions: readonly ChatPendingInteraction[];
 }
 interface AstralBeamChatCore {
   /** Start browser side effects after a React commit. Vanilla sessions start automatically. */
@@ -6197,18 +6331,38 @@ interface AstralBeamChatCore {
    * the chat session. Only the keys given are replaced.
    */
   updateOptions: (options: Partial<AstralBeamChatCoreOptions>) => void;
-  /** Sends a message, first settling any dangling tool calls so the run can proceed. */
-  sendMessage: (content: string | MultimodalContent) => Promise<void>;
+  /** Sends a message, persisting it before generation begins. */
+  sendMessage: (content: string | MultimodalContent, callbacks?: ChatSubmissionCallbacks) => Promise<void>;
   /** Resolves a client tool call the host executed itself (a questionnaire, an approval). */
   addToolResult: ChatClient["addToolResult"];
   /** Stops the in-flight generation; the transcript keeps what already streamed. */
   stop: () => void;
   /** Mints a fresh chat auth token, ignoring the cached one; for a retry after a failure. */
   retryAuthentication: () => void;
-  /** Re-runs the last exchange. */
+  /** Refreshes saved history and retries delivery of retained tool results. */
   reload: () => Promise<void>;
-  /** Clears the conversation and disposes live widget renders. */
+  /** Starts an empty conversation and disposes widget renders, preserving any saved chat. */
   reset: () => void;
+  /** Searches all authorized conversation titles using server pagination. */
+  searchThreads: (q?: string, cursor?: string, signal?: AbortSignal) => Promise<{
+    items: ChatThread[];
+    page_after: string | null;
+  }>;
+  /** Loads saved history before accepting another send. */
+  openThread: (id: string) => Promise<void>;
+  renameThread: (title: string) => Promise<boolean>;
+  /** Deletes a listed conversation, the selected one by default; resolves whether it succeeded. */
+  deleteThread: (thread?: ChatThread) => Promise<boolean>;
+  refreshThread: () => Promise<void>;
+  loadOlderMessages: () => Promise<void>;
+  abandonToolCall: (toolCallId: string) => Promise<void>;
+  uploadAttachment: (file: {
+    data: string | Promise<string>;
+    filename: string;
+    mimeType: string;
+  }) => Promise<UploadedChatFile>;
+  getFile: (fileId: string) => Promise<Blob>;
+  getAttachment: (messageId: string, partId: string) => Promise<Blob>;
   /** Tears the session down: the connection, authentication, and widget renders. */
   dispose: () => void;
 }
@@ -6242,7 +6396,7 @@ declare function isSandboxTool(name: string): boolean;
 declare function sandboxRefusal(part: ToolCallPart): string | undefined;
 /** A `sandbox_write_file` call, readable while its content is still streaming in. */
 declare function readSandboxFileWrite(part: ToolCallPart): SandboxFileWrite | undefined;
-/** A `sandbox_publish_artifact` call whose output carries the download ticket. */
+/** A `sandbox_publish_artifact` call whose output carries a durable file reference. */
 declare function readSandboxArtifact(part: ToolCallPart): SandboxArtifact | undefined;
 /** A `sandbox_run_command` call. `stdout` holds combined output on providers with no stderr. */
 declare function readSandboxCommandRun(part: ToolCallPart): SandboxCommandRun | undefined;
@@ -6275,4 +6429,26 @@ interface TypedToolDefinition<S extends ParametersSchema = JsonSchemaObject> {
 /** Declares a host tool; a Standard Schema `parameters` types (and validates) `execute`'s input. */
 declare function defineTool<const S extends ParametersSchema = JsonSchemaObject>(tool: TypedToolDefinition<S>): ToolDefinition;
 //#endregion
-export { RenderWidgetInput as A, JsonSchemaObject as B, AstralBeamChatState as C, ChatAuthenticationState as D, createAstralBeamChat as E, SandboxStatus as F, StandardSchemaV1 as H, AstralBeamChatColorScheme as I, AstralBeamChatTheme as L, SandboxArtifact as M, SandboxCommandRun as N, WidgetDeclaration as O, SandboxFileWrite as P, AstralBeamTokenSource as R, AstralBeamChatCoreOptions as S, WidgetRenderRequest as T, ToolDefinition as U, ParametersSchema as V, hasPendingToolRun as _, SANDBOX_PUBLISH_ARTIFACT_TOOL as a, AgentToolInfo as b, SANDBOX_STATUS_EVENT as c, describeSandboxCommandRun as d, isSandboxTool as f, sandboxRefusal as g, readSandboxFileWrite as h, SANDBOX_LIST_FILES_TOOL as i, SandboxActivity as j, buildAgentTools as k, SANDBOX_WRITE_FILE_TOOL as l, readSandboxCommandRun as m, ASK_QUESTIONNAIRE_TOOL as n, SANDBOX_READ_FILE_TOOL as o, readSandboxArtifact as p, RENDER_WIDGET_TOOL as r, SANDBOX_RUN_COMMAND_TOOL as s, defineTool as t, collectSandboxActivity as u, isSettledToolCall as v, ChatStreamCallbacks as w, AstralBeamChatCore as x, lastPartInProgress as y, InferParameters as z };
+//#region src/core/web.d.ts
+interface WebSource {
+  url: string;
+  title: string;
+  excerpt?: string;
+}
+interface WebCitation extends WebSource {
+  /** UTF-16 offsets into the text part. The link follows endIndex. */
+  startIndex: number;
+  endIndex: number;
+  /** Response-wide citation number. */
+  number: number;
+}
+interface WebEvidence {
+  sources: WebSource[];
+  citations: WebCitation[];
+}
+interface WebPartMetadata {
+  providerExecuted?: boolean;
+  web?: WebEvidence;
+}
+//#endregion
+export { WidgetRenderRequest as A, SandboxCommandRun as B, lastPartInProgress as C, AstralBeamChatState as D, AstralBeamChatCoreOptions as E, WidgetDeclaration as F, AstralBeamTokenSource as G, SandboxStatus as H, buildAgentTools as I, ParametersSchema as J, InferParameters as K, RenderWidgetInput as L, ChatPendingInteraction as M, ChatThread as N, ChatStreamCallbacks as O, ChatAuthenticationState as P, SandboxActivity as R, isSettledToolCall as S, AstralBeamChatCore as T, AstralBeamChatColorScheme as U, SandboxFileWrite as V, AstralBeamChatTheme as W, ToolDefinition as X, StandardSchemaV1 as Y, readSandboxArtifact as _, defineTool as a, sandboxRefusal as b, SANDBOX_LIST_FILES_TOOL as c, SANDBOX_RUN_COMMAND_TOOL as d, SANDBOX_STATUS_EVENT as f, isSandboxTool as g, describeSandboxCommandRun as h, WebSource as i, createAstralBeamChat as j, ChatSubmissionCallbacks as k, SANDBOX_PUBLISH_ARTIFACT_TOOL as l, collectSandboxActivity as m, WebEvidence as n, ASK_QUESTIONNAIRE_TOOL as o, SANDBOX_WRITE_FILE_TOOL as p, JsonSchemaObject as q, WebPartMetadata as r, RENDER_WIDGET_TOOL as s, WebCitation as t, SANDBOX_READ_FILE_TOOL as u, readSandboxCommandRun as v, AgentToolInfo as w, hasPendingToolRun as x, readSandboxFileWrite as y, SandboxArtifact as z };