@astralbeam/sdk 0.16.0 → 0.17.0

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

@@ -1,4 +1,4 @@
-import { F as CurrentUser } from "./index-CH3RVjha.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.64.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.64.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.64.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
  */
@@ -3082,6 +3082,14 @@ interface ThinkingPart$1 {
    */
   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
  * `partial` type on a streaming structured-output part since the progressive
@@ -3096,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. */
@@ -3154,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.
  */
@@ -3168,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;
@@ -3181,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. */
@@ -3443,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>;
@@ -3582,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. */
@@ -3624,7 +3661,7 @@ interface SubagentErrorEvent extends SubagentErrorEvent$1 {}
  */
 type StreamChunk = AGUIEvent;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai@0.64.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;
@@ -3666,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.64.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
@@ -3747,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.64.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.64.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.64.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.1/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 {
@@ -3807,7 +3844,7 @@ interface KeyringStorage {
   clear: () => void | Promise<void>;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.1/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';
 } | {
@@ -3862,7 +3899,7 @@ declare class ByokClient {
   unlock(): Promise<void>;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.1/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;
@@ -3882,7 +3919,7 @@ interface ChatClientToolFixtureAppliedEvent {
   execute?: boolean;
   message?: {
     id: string;
-    role: 'system' | 'user' | 'assistant';
+    role: UIMessage['role'];
     parts: Array<unknown>;
     createdAt?: number | string;
   };
@@ -3982,7 +4019,7 @@ declare abstract class ChatClientEventEmitter {
   toolFixtureApplied(fixture: ChatClientToolFixtureAppliedEvent): void;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.1/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;
 }
@@ -4150,10 +4187,10 @@ declare class ChatDevtoolsBridge extends ClientDevtoolsBridge<AIDevtoolsChatSnap
   private findClientTool;
 }
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.1/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.1/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;
@@ -4625,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.
@@ -4642,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;
@@ -4843,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
@@ -4924,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.1/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
@@ -5087,7 +5130,7 @@ interface SubscribeConnectionAdapter {
  */
 type ConnectionAdapter = ConnectConnectionAdapter | SubscribeConnectionAdapter;
 //#endregion
-//#region node_modules/.deno/@tanstack+ai-client@0.36.1/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. */
@@ -5105,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;
   /**
@@ -5199,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;
@@ -5224,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;
@@ -5363,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;
   /**
@@ -5662,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
    */
@@ -5944,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. */
@@ -6240,6 +6304,11 @@ 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;
@@ -6287,6 +6356,12 @@ interface AstralBeamChatCore {
   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;
@@ -6321,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;
@@ -6354,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 { ChatAuthenticationState as A, AstralBeamChatTheme as B, AstralBeamChatState as C, createAstralBeamChat as D, WidgetRenderRequest as E, SandboxArtifact as F, StandardSchemaV1 as G, InferParameters as H, SandboxCommandRun as I, ToolDefinition as K, SandboxFileWrite as L, buildAgentTools as M, RenderWidgetInput as N, ChatPendingInteraction as O, SandboxActivity as P, SandboxStatus as R, AstralBeamChatCoreOptions as S, ChatSubmissionCallbacks as T, JsonSchemaObject as U, AstralBeamTokenSource as V, ParametersSchema as W, 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, WidgetDeclaration as j, ChatThread 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, AstralBeamChatColorScheme 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 };