@astralbeam/sdk 0.22.0 → 0.23.0

package/README.md

@@ -14,22 +14,27 @@ One component in React, one function everywhere else. Full setup, including the
 import { AstralBeamChat } from "@astralbeam/sdk/react"
 
 export function Sidebar() {
-  return <AstralBeamChat />
+  return (
+    <aside style={{ height: "100dvh" }}>
+      <AstralBeamChat />
+    </aside>
+  )
 }
 ```
 
 ```ts
 import { mountAstralBeamChat } from "@astralbeam/sdk/client"
 
-const handle = mountAstralBeamChat(document.getElementById("sidebar"), {})
+const handle = mountAstralBeamChat(document.getElementById("sidebar")!, {})
 // Update with handle.update({ colorScheme: "dark" }), then clean up with handle.unmount().
 ```
 
 Without npm or a bundler, import the same entry from jsDelivr in a module script. Pin an exact version and the full `/dist/client.js` path, because the loader imports its lazy chunks relative to itself. See [Script tag](https://astralbeam.ai/docs/sdk/script-tag).
 
 ```html
+<div id="sidebar" style="height:100dvh"></div>
 <script type="module">
-  import { mountAstralBeamChat } from "https://cdn.jsdelivr.net/npm/@astralbeam/sdk@0.22.0/dist/client.js"
+  import { mountAstralBeamChat } from "https://cdn.jsdelivr.net/npm/@astralbeam/sdk@0.23.0/dist/client.js"
 
   mountAstralBeamChat(document.getElementById("sidebar"), {})
 </script>
@@ -86,28 +91,7 @@ After acquiring a token, components call `POST /api/v1/me` and renew before expi
 
 ## Options
 
-Every option is also a prop on `<AstralBeamChat>`. `handle.update(options)` applies any subset in place, and no option is fixed at mount. Details in [Configuration](https://astralbeam.ai/docs/sdk/configuration).
-
-| Option | Default | Meaning |
-| --- | --- | --- |
-| `agentId` | organization's default | `agent_<orgId>_<id>`, copied from the dashboard |
-| `threadId` | `"auto"` | Restore this tab's selection, use `"new"` for a fresh chat, or pass a saved thread UUID |
-| `apiUrl` | `https://astralbeam.ai/api` | Base URL of the AstralBeam API. The widget calls `/v1/chat` there |
-| `fetchAstralBeamToken` | `{ url: "/api/astralbeam/token" }` | Chat auth token endpoint as `{ url, ...RequestInit }`, or a minter |
-| `title`, `showHeader` | `"AstralBeam"`, `true` | Header text, and whether the header with its chat history and new chat buttons shows |
-| `onClose` | none | Adds an X button and fullscreen chat at widths up to 900px. The host hides or unmounts chat in this callback |
-| `resizable` | `true` | Enables the resize edge and keyboard resizing |
-| `defaultWidth` | host's initial width | Width in pixels, or `"100%"` for available width, when no saved override exists |
-| `resizeContainer` | mount's parent | `() => HTMLElement \| null` returning the stable container that limits available width |
-| `showConversationTitle` | `false` | Bar with a titled conversation's title and a rename, delete, and Copy Markdown menu |
-| `emptyHeadline`, `emptyDescription` | generic copy | Headline and subtitle of the empty transcript |
-| `colorScheme`, `theme` | `"system"`, built-in palette | Light/dark/system, and shadcn token overrides |
-| `customCss` | None | Trusted CSS inside the widget's Shadow DOM |
-| `attachments` | `true` | `false` hides the feature, or pass limits |
-| `tools`, `widgets` | none | What the agent can do and draw in your app |
-| `sandboxPanel` | `false` | Collected sandbox panel: files with downloads, command log |
-| `header`, `headerActions`, `empty`, `composerActions` | widget's own chrome | Host-rendered replacements (React props. `slots` on the handle) |
-| `debug` | `false` | Log SDK actions in the browser, with server logs in development only |
+Pass options as React props or apply a subset with `handle.update(options)`. Presentation changes preserve chat. Changing `threadId` selects a conversation, and changing `apiUrl` clears the previous deployment's state. See [Configuration](https://astralbeam.ai/docs/sdk/configuration) for all options, defaults, layout, and chrome slots.
 
 A `ref` on `<AstralBeamChat>` (and the vanilla handle) exposes `reset()` and `stop()` for hosts that draw their own controls.
 
@@ -145,14 +129,16 @@ widgets: {
 - Only a Standard Schema validates input in the browser. With plain JSON Schema, treat input as untrusted.
 - Return plain JSON values from tools, with no `undefined` fields. If a result cannot be sent, the action may still have happened.
 
-## Documentation
+## MCP connections
 
-Remote tools appear under **MCP connections** in the authenticated Tenant widget. Organization admins configure the available MCP servers. Each TenantUser creates their own connection to a server. Public endpoints, static headers and OAuth are supported. Tool results follow the conversation's visibility and retention rules. Disconnect clears credentials locally.
+Remote tools appear under **MCP connections** in the authenticated Tenant widget. Organization admins configure the available MCP servers. Each TenantUser creates their own connection to a server. Public endpoints, static headers and OAuth are supported. Tool results follow the conversation's visibility and retention rules. Disconnect removes the saved connection and its credentials from AstralBeam.
 
 Headless consumers can use `chat.getMcpCatalog()`, `chat.manageMcpConnection(operation)` and `chat.authorizeMcpConnection({ mcpServerId, id? })`. Start OAuth from a user gesture to open its popup. Browser binding and completion use the authenticated session. Server tool titles arrive in `state.serverToolTitles`, independently of host tool execution.
 
 Reuse the dashboard's server list and form with `AstralBeamMcpServers` from `/react` or `mountAstralBeamMcpServers` from `/client`. Supply the server list and authorized write callbacks. See [MCP server management](https://astralbeam.ai/docs/sdk/configuration#mcp-server-management).
 
+## Documentation
+
 | Guide | Covers |
 | --- | --- |
 | [API client](https://astralbeam.ai/docs/sdk/api) | Typed resource and chat requests with API keys or JWTs. |
@@ -173,17 +159,13 @@ Reuse the dashboard's server list and form with `AstralBeamMcpServers` from `/re
 
 Read-only Tenant, TenantUser and conversation widgets are available from `/client` and `/react`. See [Tenant directories](https://astralbeam.ai/docs/sdk/listings) for setup and embedding examples.
 
-Directory results stay fresh for 30 seconds, then refresh when the tab becomes visible or the network reconnects. Unused data expires after five minutes. The optional `cacheKey` is an opaque host-session object for remount reuse. Keep it stable during the session and replace it on sign-out or account changes. Changing it clears authentication and the view. Each mount owns its authentication, requests, cancellation, and refresh, independently of concurrent directories.
-
-Directory `refresh()` and `reset()` return `Promise<void>` and wait for renderer loading, authentication, and the current directory rows or open conversation messages. Attachment previews load independently. Refresh may reuse the JWT. Reset clears this mount's state and retained data for its key, then reacquires authentication from a ready host session. Unmount during sign-out. See the <a href="https://astralbeam.ai/docs/sdk/listings#account-changes-and-lifecycle" target="_blank" rel="noopener noreferrer">lifecycle contract</a> for remount reuse, failure, and cancellation.
-
-**Breaking migration**: React directory refs now expose only `refresh()` and `reset()`. Replace the removed `/react` `*ListHandle` exports with `AstralBeamTenantListRef`, `AstralBeamTenantUserListRef`, or `AstralBeamThreadListRef`. Use props for updates and conditional rendering to unmount. Vanilla `/client` handles retain `update()` and `unmount()`. Await or handle rejection from refresh/reset calls that previously returned `void`.
+React directory refs expose `refresh()` and `reset()`, both returning `Promise<void>`. Use props for updates and conditional rendering to unmount. Vanilla handles also expose `update()` and `unmount()`. Unmount during sign-out or identity changes. See the <a href="https://astralbeam.ai/docs/sdk/listings#account-changes-and-lifecycle" target="_blank" rel="noopener noreferrer">lifecycle contract</a> for authentication, caching, remount reuse, and action completion.
 
 There is no root export.
 
 | Entry point              | Contents                                     | Peer dependency      |
 | ------------------------ | -------------------------------------------- | -------------------- |
-| `@astralbeam/sdk/client` | Chat and Tenant directory mounts             | none                 |
+| `@astralbeam/sdk/client` | Chat, directory, and MCP server mounts       | none                 |
 | `@astralbeam/sdk/core`   | `createAstralBeamChat`, the headless session | none                 |
 | `@astralbeam/sdk/react`  | Chat hooks and isolated UI wrappers          | `react`, `react-dom` |
 | `@astralbeam/sdk/server` | Tenant and organization token minters        | none                 |

package/dist/client.d.ts

@@ -110,14 +110,8 @@ type AstralBeamChatThemeVariables = Record<`--${string}`, string>;
 interface AstralBeamTokenRequest extends RequestInit {
   url: string;
 }
-/**
- * Where the widget's short-lived chat auth token comes from: an endpoint to POST, or a function that
- * mints the token in the host page and returns `{ token }`, optionally as a promise.
- *
- * Either form runs again on every renewal — near expiry and after a token is rejected — so a
- * rotating credential stays current rather than being captured once. A function that returns
- * `undefined`, or throws, fails authentication closed; the composer's retry link asks again.
- */
+/** Retrieves a server-minted token on acquisition and renewal, including after a token rejection.
+ * Returning undefined or throwing fails authentication closed. The composer's retry link asks again. */
 type AstralBeamTokenSource = AstralBeamTokenRequest | (() => {
   token: string;
 } | undefined | Promise<{
@@ -177,12 +171,8 @@ interface MountAstralBeamChatOptions {
    * hosted cloud; self-hosted deployments must set their own origin.
    */
   apiUrl?: string | undefined;
-  /**
-   * Where the short-lived chat auth token comes from: `{ url, ...RequestInit }` for a token
-   * endpoint, or a function that mints `{ token }` in the host page. Read for every token, so a
-   * change applies to the next one, which is minted when the cached token nears expiry. Default
-   * `{ url: "/api/astralbeam/token" }`, posted with the page's cookies.
-   */
+  /** Endpoint or callback retrieving a server-minted token, read on each acquisition and renewal.
+   * Defaults to POST /api/astralbeam/token with the page's cookies. Never expose API keys here. */
   fetchAstralBeamToken?: AstralBeamTokenSource | undefined;
   /** Host-defined tools the agent can call, executed in the host page, keyed by tool name. */
   tools?: Record<string, ToolDefinition> | undefined;
@@ -213,20 +203,15 @@ interface MountAstralBeamChatOptions {
    */
   debug?: boolean | undefined;
 }
-/**
- * What the handle's `update` takes: every mount option, none of them fixed. The transport options
- * are re-read per request rather than captured, so changing them keeps the transcript and the
- * chat session instead of forcing a fresh mount.
- */
+/** Updates only supplied options. Presentation changes preserve chat.
+ * Changing apiUrl clears the previous session, while threadId selects a conversation. */
 type AstralBeamChatUpdate = Partial<MountAstralBeamChatOptions>;
 interface AstralBeamChatHandle {
   unmount: () => void;
-  /**
-   * Merges option changes into the live mount options and applies them in place, keeping the
-   * transcript, the chat session, and live widget renders. Only the keys given are replaced.
-   */
+  /** Applies supplied options in place. Presentation changes preserve chat.
+   * Changing apiUrl clears the previous session, while threadId selects a conversation. */
   update: (options: AstralBeamChatUpdate) => void;
-  /** Clears the conversation: transcript, drafts, attachments, and live widget renders. */
+  /** Starts a fresh conversation and clears its draft, preserving saved conversations and their drafts. */
   reset: () => void;
   /** Stops the in-flight generation, if any; the transcript keeps what already streamed. */
   stop: () => void;

package/dist/client.js

@@ -1 +1 @@
-import{s as e}from"./constants-C-Yp0Vhg.js";import{t}from"./debug-DLDY8CZb.js";import{t as n}from"./abort-_ZeHSwUG.js";function r(e,t,n,r){let i=n.colorScheme??`system`,a=i===`dark`||i===`system`&&r;e.classList.toggle(`dark`,a);for(let n of t)e.style.removeProperty(n);t.clear();let o={...n.theme?.light,...a?n.theme?.dark:void 0};for(let[n,r]of Object.entries(o))n.startsWith(`--`)&&(e.style.setProperty(n,r),t.add(n));return{colorScheme:i,dark:a}}function i(e){return e}function a(e){return e}function o(e,t){return l(e,t,`tenants`)}function s(e,t){return l(e,t,`users`)}function c(e,t){return l(e,t,`threads`)}function l(t,n,r){let i=t.shadowRoot??t.attachShadow({mode:`open`}),a=document.createElement(`div`);a.className=`${e} bg-transparent`,a.style.height=`100%`,i.append(a);let o=matchMedia(`(prefers-color-scheme: dark)`),s={options:{...n},kind:r,shadow:i,container:a,media:o,variables:/* @__PURE__ */ new Set,disposed:!1},c=()=>u(s);return c(),o.addEventListener(`change`,c),d(s).catch(()=>{}),{update:e=>m(s,e),refresh:()=>p(s,!1),reset:()=>p(s,!0),unmount:()=>h(s,c)}}function u({options:e,media:t,container:n,variables:i}){r(n,i,e,t.matches)}function d(e){return e.loading??=f(e)}async function f(e){e.retryLoad?.remove();try{if(e.runtime=await import(`./listings-CyliP2E5.js`),e.disposed)return;e.renderer=e.runtime.renderListing(e.shadow,e.container,e.options,e.kind,()=>p(e,!1))}catch(t){throw e.loading=void 0,e.disposed||(e.retryLoad=document.createElement(`button`),e.retryLoad.textContent=`Could not load directory. Retry`,e.retryLoad.onclick=()=>void d(e).catch(()=>{}),e.container.append(e.retryLoad)),t}}async function p(e,t){if(e.disposed)throw new DOMException(`Directory unmounted`,`AbortError`);e.action?.abort();let r=new AbortController;e.action=r;try{e.renderer||await n(d(e),r.signal),r.signal.throwIfAborted(),await e.runtime.refreshListing(e.renderer,r.signal,t)}finally{e.action===r&&(e.action=void 0)}}function m(e,t){if(e.disposed)return;let n={...e.options,...t};(n.apiUrl!==e.options.apiUrl||n.cacheKey!==e.options.cacheKey||n.scope!==e.options.scope||n.tenantId!==e.options.tenantId||n.tenantExternalId!==e.options.tenantExternalId)&&e.action?.abort(),e.options=n,u(e),e.renderer&&e.runtime.updateListing(e.renderer,e.options)}function h(e,t){e.disposed||(e.disposed=!0,e.action?.abort(),e.media.removeEventListener(`change`,t),e.renderer&&e.runtime.disposeListing(e.renderer),e.container.remove())}function g(t,n){let i=t.shadowRoot??t.attachShadow({mode:`open`}),a=document.createElement(`div`);a.className=e,i.append(a);let o=matchMedia(`(prefers-color-scheme: dark)`),s=/* @__PURE__ */ new Set,c=n,l=!1,u,d=()=>r(a,s,c,o.matches);d(),o.addEventListener(`change`,d);let f=async()=>{a.replaceChildren();try{let{renderMcpServers:e}=await import(`./mcp-servers-DvCu1KuJ.js`);l||(u=e(a,c))}catch{if(l)return;let e=document.createElement(`button`);e.textContent=`Could not load MCP servers. Retry`,e.onclick=()=>void f(),a.replaceChildren(e)}};return f(),{update(e){l||(c={...c,...e},d(),u?.update(c))},unmount(){l=!0,o.removeEventListener(`change`,d),u?.unmount(),a.remove()}}}function _(n,i){let a={...i},o=t(a.debug);o?.(`mount`,`mounting chat widget`,{agentId:a.agentId??`(organization default)`,title:a.title??`AstralBeam`,showHeader:a.showHeader??!0,emptyHeadline:a.emptyHeadline??`Ask the assistant`,emptyDescription:a.emptyDescription??`Ask a question or describe what you want to do in this app.`,apiUrl:a.apiUrl??`https://astralbeam.ai/api`,authentication:`configured`,colorScheme:a.colorScheme??`system`,theme:a.theme,tools:Object.keys(a.tools??{}),widgets:Object.keys(a.widgets??{}),attachments:a.attachments??!0});let s=n.shadowRoot??n.attachShadow({mode:`open`}),c=document.createElement(`div`);c.className=e,c.style.height=`100%`,s.append(c);let l=document.createElement(`div`);l.style.cssText=`display:flex;align-items:center;justify-content:space-between;gap:16px;padding:16px;font:14px system-ui`;let u=document.createElement(`span`);u.setAttribute(`role`,`status`),u.textContent=`Loading chat…`;let d=document.createElement(`button`);d.type=`button`,d.textContent=`Close chat`,d.style.cssText=`min-width:44px;min-height:44px;padding:8px;font:inherit;cursor:pointer`,d.hidden=!a.onClose,d.onclick=e=>{e.detail<2&&a.onClose?.()},l.append(u,d),c.append(l);let f=matchMedia(`(prefers-color-scheme: dark)`),p=/* @__PURE__ */ new Set,m=()=>{let{colorScheme:e,dark:t}=r(c,p,a,f.matches);o?.(`theme`,`color scheme "${e}" resolved to ${t?`dark`:`light`}`,{themeVariables:[...p]})};m(),f.addEventListener(`change`,m);let h=!1,g;return import(`./widget-BOdanf0E.js`).then(({renderChat:e})=>{o?.(`mount`,`chat chunk loaded`),h||(g=e(s,c,a))}).catch(()=>{h||(u.textContent=`Could not load chat. Reload this page to try again.`)}),{update:e=>{a={...a,...e},o=t(a.debug),o?.(`mount`,`options updated`,{changed:Object.keys(e)}),m(),d.hidden=!a.onClose,g?.update(a)},reset:()=>g?.reset(),stop:()=>g?.stop(),unmount:()=>{o?.(`mount`,`unmounting chat widget`),h=!0,f.removeEventListener(`change`,m),g?.dispose(),g=void 0,c.remove()}}}export{i as defineTool,a as defineWidget,_ as mountAstralBeamChat,g as mountAstralBeamMcpServers,o as mountAstralBeamTenantList,s as mountAstralBeamTenantUserList,c as mountAstralBeamThreadList};
+import{s as e}from"./constants-C-Yp0Vhg.js";import{t}from"./debug-DLDY8CZb.js";import{t as n}from"./abort-_ZeHSwUG.js";function r(e,t,n,r){let i=n.colorScheme??`system`,a=i===`dark`||i===`system`&&r;e.classList.toggle(`dark`,a);for(let n of t)e.style.removeProperty(n);t.clear();let o={...n.theme?.light,...a?n.theme?.dark:void 0};for(let[n,r]of Object.entries(o))n.startsWith(`--`)&&(e.style.setProperty(n,r),t.add(n));return{colorScheme:i,dark:a}}function i(e){return e}function a(e){return e}function o(e,t){return l(e,t,`tenants`)}function s(e,t){return l(e,t,`users`)}function c(e,t){return l(e,t,`threads`)}function l(t,n,r){let i=t.shadowRoot??t.attachShadow({mode:`open`}),a=document.createElement(`div`);a.className=`${e} bg-transparent`,a.style.height=`100%`,i.append(a);let o=matchMedia(`(prefers-color-scheme: dark)`),s={options:{...n},kind:r,shadow:i,container:a,media:o,variables:/* @__PURE__ */ new Set,disposed:!1},c=()=>u(s);return c(),o.addEventListener(`change`,c),d(s).catch(()=>{}),{update:e=>m(s,e),refresh:()=>p(s,!1),reset:()=>p(s,!0),unmount:()=>h(s,c)}}function u({options:e,media:t,container:n,variables:i}){r(n,i,e,t.matches)}function d(e){return e.loading??=f(e)}async function f(e){e.retryLoad?.remove();try{if(e.runtime=await import(`./listings-CyliP2E5.js`),e.disposed)return;e.renderer=e.runtime.renderListing(e.shadow,e.container,e.options,e.kind,()=>p(e,!1))}catch(t){throw e.loading=void 0,e.disposed||(e.retryLoad=document.createElement(`button`),e.retryLoad.textContent=`Could not load directory. Retry`,e.retryLoad.onclick=()=>void d(e).catch(()=>{}),e.container.append(e.retryLoad)),t}}async function p(e,t){if(e.disposed)throw new DOMException(`Directory unmounted`,`AbortError`);e.action?.abort();let r=new AbortController;e.action=r;try{e.renderer||await n(d(e),r.signal),r.signal.throwIfAborted(),await e.runtime.refreshListing(e.renderer,r.signal,t)}finally{e.action===r&&(e.action=void 0)}}function m(e,t){if(e.disposed)return;let n={...e.options,...t};(n.apiUrl!==e.options.apiUrl||n.cacheKey!==e.options.cacheKey||n.scope!==e.options.scope||n.tenantId!==e.options.tenantId||n.tenantExternalId!==e.options.tenantExternalId)&&e.action?.abort(),e.options=n,u(e),e.renderer&&e.runtime.updateListing(e.renderer,e.options)}function h(e,t){e.disposed||(e.disposed=!0,e.action?.abort(),e.media.removeEventListener(`change`,t),e.renderer&&e.runtime.disposeListing(e.renderer),e.container.remove())}function g(t,n){let i=t.shadowRoot??t.attachShadow({mode:`open`}),a=document.createElement(`div`);a.className=e,i.append(a);let o=matchMedia(`(prefers-color-scheme: dark)`),s=/* @__PURE__ */ new Set,c=n,l=!1,u,d=()=>r(a,s,c,o.matches);d(),o.addEventListener(`change`,d);let f=async()=>{a.replaceChildren();try{let{renderMcpServers:e}=await import(`./mcp-servers-DvCu1KuJ.js`);l||(u=e(a,c))}catch{if(l)return;let e=document.createElement(`button`);e.textContent=`Could not load MCP servers. Retry`,e.onclick=()=>void f(),a.replaceChildren(e)}};return f(),{update(e){l||(c={...c,...e},d(),u?.update(c))},unmount(){l=!0,o.removeEventListener(`change`,d),u?.unmount(),a.remove()}}}function _(n,i){let a={...i},o=t(a.debug);o?.(`mount`,`mounting chat widget`,{agentId:a.agentId??`(organization default)`,title:a.title??`AstralBeam`,showHeader:a.showHeader??!0,emptyHeadline:a.emptyHeadline??`Ask the assistant`,emptyDescription:a.emptyDescription??`Ask a question or describe what you want to do in this app.`,apiUrl:a.apiUrl??`https://astralbeam.ai/api`,authentication:`configured`,colorScheme:a.colorScheme??`system`,theme:a.theme,tools:Object.keys(a.tools??{}),widgets:Object.keys(a.widgets??{}),attachments:a.attachments??!0});let s=n.shadowRoot??n.attachShadow({mode:`open`}),c=document.createElement(`div`);c.className=e,c.style.height=`100%`,s.append(c);let l=document.createElement(`div`);l.style.cssText=`display:flex;align-items:center;justify-content:space-between;gap:16px;padding:16px;font:14px system-ui`;let u=document.createElement(`span`);u.setAttribute(`role`,`status`),u.textContent=`Loading chat…`;let d=document.createElement(`button`);d.type=`button`,d.textContent=`Close chat`,d.style.cssText=`min-width:44px;min-height:44px;padding:8px;font:inherit;cursor:pointer`,d.hidden=!a.onClose,d.onclick=e=>{e.detail<2&&a.onClose?.()},l.append(u,d),c.append(l);let f=matchMedia(`(prefers-color-scheme: dark)`),p=/* @__PURE__ */ new Set,m=()=>{let{colorScheme:e,dark:t}=r(c,p,a,f.matches);o?.(`theme`,`color scheme "${e}" resolved to ${t?`dark`:`light`}`,{themeVariables:[...p]})};m(),f.addEventListener(`change`,m);let h=!1,g;return import(`./widget-BYZdWupG.js`).then(({renderChat:e})=>{o?.(`mount`,`chat chunk loaded`),h||(g=e(s,c,a))}).catch(()=>{h||(u.textContent=`Could not load chat. Reload this page to try again.`)}),{update:e=>{a={...a,...e},o=t(a.debug),o?.(`mount`,`options updated`,{changed:Object.keys(e)}),m(),d.hidden=!a.onClose,g?.update(a)},reset:()=>g?.reset(),stop:()=>g?.stop(),unmount:()=>{o?.(`mount`,`unmounting chat widget`),h=!0,f.removeEventListener(`change`,m),g?.dispose(),g=void 0,c.remove()}}}export{i as defineTool,a as defineWidget,_ as mountAstralBeamChat,g as mountAstralBeamMcpServers,o as mountAstralBeamTenantList,s as mountAstralBeamTenantUserList,c as mountAstralBeamThreadList};

package/dist/{core-CWFT6Db_.js → core-Bn3w2Q44.js}

@@ -11184,7 +11184,7 @@ function buildAskQuestionnaireTool() {
 		}
 	}).client();
 }
-/** Wraps the host's mount-time tools as client tools the agent can call. */
+/** Wraps declared host tools, resolving current callbacks through the session's execution guard. */
 function buildHostTools(tools, debug, guardHostExecution) {
 	return Object.entries(tools).map(([name, tool]) => toolDefinition({
 		name,
@@ -11917,6 +11917,21 @@ function createAstralBeamChat(options, deferStart = false) {
 	let threadKey;
 	let startWithNewThread = false;
 	let threadRecords = [];
+	const messagePresentation = /* @__PURE__ */ new Map();
+	let presentationVersion = 0;
+	let projectedMessages = /* @__PURE__ */ new WeakMap();
+	const rememberAttachments = (messages) => {
+		for (const message of messages) {
+			if (message.role !== "user" || messagePresentation.get(message.id)?.attachmentParts || !message.parts.some((part) => "fileId" in part)) continue;
+			const parts = message.parts.map((part) => Object.freeze({ ...part }));
+			Object.freeze(parts);
+			messagePresentation.set(message.id, {
+				...messagePresentation.get(message.id),
+				attachmentParts: parts
+			});
+			presentationVersion++;
+		}
+	};
 	const clientId = newUuid();
 	const acceptSubmission = () => {
 		if (!submission || !settle(submission, "accepted")) return;
@@ -11927,11 +11942,13 @@ function createAstralBeamChat(options, deferStart = false) {
 		submission.callbacks?.onAccepted?.();
 	};
 	const replaceAcceptedMessage = (record) => {
-		const messages = [...client.getMessages()];
+		const messages = [...client.getSnapshot().messages];
 		const index = messages.findLastIndex((message) => message.role === "user");
 		if (index !== -1) {
 			messages[index] = projectThreadMessages([record])[0];
+			rememberAttachments([messages[index]]);
 			client.setMessagesManually(messages);
+			if (unsubscribeSnapshot) observeSnapshot();
 		}
 	};
 	const liveToolCalls = /* @__PURE__ */ new Set();
@@ -12056,22 +12073,52 @@ function createAstralBeamChat(options, deferStart = false) {
 			rendered: true
 		};
 	};
-	const restoreCompletedWidgets = (messages) => {
-		if (state.thread?.role === "viewer") return;
-		const renderIds = /* @__PURE__ */ new Map();
-		for (const message of state.messages) for (const part of message.parts) {
-			if (part.type !== "tool-call" || part.name !== "render_widget") continue;
+	const projectMessages = (messages) => Object.freeze(messages.map((message) => {
+		let presentation = messagePresentation.get(message.id);
+		const cached = projectedMessages.get(message);
+		if (cached && cached.presentation === presentation) return cached.message;
+		let parts = presentation?.attachmentParts ?? message.parts;
+		let renderIds = presentation?.renderIds;
+		const nextParts = parts.map((part) => {
+			if (part.type !== "tool-call" || part.name !== "render_widget" || part.state !== "complete" || !part.input) return part;
 			const stored = part;
-			if (!stored.widgetRenderId) continue;
-			renderIds.set(savedToolCallId(message.id, part.id), stored.widgetRenderId);
-			if (stored.applicationPartId) renderIds.set(savedToolCallId(message.id, stored.applicationPartId, stored.responseTargetId), stored.widgetRenderId);
+			const alias = savedToolCallId(message.id, part.id);
+			const canonical = stored.applicationPartId ? savedToolCallId(message.id, stored.applicationPartId, stored.responseTargetId) : alias;
+			const upstream = stored.upstreamToolCallId;
+			const renderId = stored.widgetRenderId ?? renderIds?.get(alias) ?? renderIds?.get(canonical) ?? (upstream && liveToolMessageIds.get(upstream) === message.id && restoredWidgets.has(upstream) ? upstream : part.id);
+			if (renderIds?.get(alias) !== renderId || renderIds.get(canonical) !== renderId) renderIds = new Map(renderIds).set(alias, renderId).set(canonical, renderId);
+			return stored.widgetRenderId === renderId ? part : Object.freeze({
+				...part,
+				widgetRenderId: renderId
+			});
+		});
+		if (nextParts.some((part, index) => part !== parts[index])) {
+			Object.freeze(nextParts);
+			parts = nextParts;
+		}
+		if (renderIds && renderIds !== presentation?.renderIds) {
+			presentation = {
+				...presentation,
+				renderIds
+			};
+			messagePresentation.set(message.id, presentation);
+			presentationVersion++;
 		}
+		const projected = parts === message.parts ? message : Object.freeze({
+			...message,
+			parts
+		});
+		projectedMessages.set(message, {
+			presentation,
+			message: projected
+		});
+		return projected;
+	}));
+	const restoreCompletedWidgets = (messages) => {
+		if (state.thread?.role === "viewer") return;
 		for (const message of messages) for (const part of message.parts) {
 			if (part.type !== "tool-call" || part.name !== "render_widget" || part.state !== "complete" || !part.input) continue;
-			const stored = part;
-			const upstream = stored.upstreamToolCallId;
-			const renderId = stored.widgetRenderId ?? renderIds.get(savedToolCallId(message.id, part.id)) ?? (stored.applicationPartId ? renderIds.get(savedToolCallId(message.id, stored.applicationPartId, stored.responseTargetId)) : void 0) ?? (upstream && liveToolMessageIds.get(upstream) === message.id && restoredWidgets.has(upstream) ? upstream : part.id);
-			stored.widgetRenderId = renderId;
+			const renderId = part.widgetRenderId ?? part.id;
 			if (restoredWidgets.has(renderId) || restoringWidgets.has(renderId)) continue;
 			restoringWidgets.add(renderId);
 			const generation = selectionGeneration;
@@ -12297,7 +12344,10 @@ function createAstralBeamChat(options, deferStart = false) {
 					});
 					const older = options?.before !== void 0;
 					const readGeneration = older ? historyGeneration : ++historyGeneration;
-					if (!options?.before) update({ history: state.messages.length > 0 || state.thread?.hasMessages === false ? "refreshing" : "loading" });
+					if (!options?.before) update({
+						olderMessagesLoading: false,
+						history: state.messages.length > 0 || state.thread?.hasMessages === false ? "refreshing" : "loading"
+					});
 					const read = (async () => {
 						let history = await loadThreadMessages(threadId, await requestOptions(), options?.before, liveToolMessageIds);
 						while (options?.before && history.messages.every((message) => message.role === "tool") && history.page_after) {
@@ -12312,6 +12362,7 @@ function createAstralBeamChat(options, deferStart = false) {
 						threadRecords = older ? [...history.messages, ...threadRecords] : history.messages;
 						const pageIds = new Set(history.messages.map((message) => message.id));
 						const messages = projectThreadMessages(threadRecords, older ? state.pendingInteractions : history.pendingInteractions, liveToolMessageIds).filter((message) => pageIds.has(message.id));
+						rememberAttachments(messages);
 						if (older) update({ messagesCursor: history.page_after ?? void 0 });
 						else {
 							if (history.thread.role === "viewer") disposeRenders();
@@ -12324,7 +12375,6 @@ function createAstralBeamChat(options, deferStart = false) {
 							if (agentChanged) resolveCapabilities();
 							if (messages.length === 0) next.setMessagesManually([]);
 						}
-						restoreCompletedWidgets(messages);
 						return {
 							messages,
 							activeRun: null,
@@ -12337,7 +12387,10 @@ function createAstralBeamChat(options, deferStart = false) {
 					})();
 					if (!older) {
 						hydration = read.then(() => "idle", () => "failed").then((history) => new Promise((resolve) => queueMicrotask(() => {
-							if (client === next && readGeneration === historyGeneration) update({ history });
+							if (client === next && readGeneration === historyGeneration) {
+								if (unsubscribeSnapshot) observeSnapshot();
+								update({ history });
+							}
 							resolve();
 						}))).then(() => read);
 						hydration.catch(() => void 0);
@@ -12351,25 +12404,6 @@ function createAstralBeamChat(options, deferStart = false) {
 			queue: "drop",
 			tools: declareTools(),
 			forwardedProps: forwardedProps(),
-			onMessagesChange: (messages) => {
-				if (client !== next) return;
-				restoreCompletedWidgets(messages);
-				const savedMessages = new Map(state.messages.map((message) => [message.id, message]));
-				for (const message of messages) {
-					if (message.role !== "user") continue;
-					const saved = savedMessages.get(message.id);
-					if (saved?.parts.some((part) => "fileId" in part)) message.parts = saved.parts;
-				}
-				update({
-					messages,
-					sandbox: collectSandboxActivity(messages)
-				});
-			},
-			onStatusChange: (status) => {
-				if (client !== next) return;
-				clientStatus = status;
-				update(status === "submitted" ? { usageLimitReached: void 0 } : {});
-			},
 			onInterruptStateChange: (interrupts) => {
 				if (client === next) debug?.("tool", "interrupt state changed", interrupts);
 			},
@@ -12444,21 +12478,55 @@ function createAstralBeamChat(options, deferStart = false) {
 	};
 	let selectedId;
 	let client = createClient();
-	const replaceClient = () => {
+	let unsubscribeSnapshot;
+	let snapshotMessages;
+	let projectedPresentationVersion = -1;
+	const observeSnapshot = () => {
+		const snapshot = client.getSnapshot();
+		const messagesChanged = snapshotMessages !== snapshot.messages || projectedPresentationVersion !== presentationVersion;
+		if (!messagesChanged && clientStatus === snapshot.status) return;
+		const next = {};
+		if (clientStatus !== snapshot.status && snapshot.status === "submitted") next.usageLimitReached = void 0;
+		clientStatus = snapshot.status;
+		if (messagesChanged) {
+			next.messages = projectMessages(snapshot.messages);
+			next.sandbox = collectSandboxActivity(next.messages);
+			snapshotMessages = snapshot.messages;
+			projectedPresentationVersion = presentationVersion;
+		}
+		update(next);
+		if (messagesChanged) restoreCompletedWidgets(state.messages);
+	};
+	const attachClient = () => {
+		if (!unsubscribeSnapshot) {
+			const observed = client;
+			const generation = selectionGeneration;
+			unsubscribeSnapshot = observed.subscribeSnapshot(() => {
+				if (client === observed && generation === selectionGeneration) observeSnapshot();
+			});
+			observeSnapshot();
+			restoreCompletedWidgets(state.messages);
+		}
+		client.attach();
+	};
+	const replaceClient = (messages) => {
 		const previous = client;
+		unsubscribeSnapshot?.();
+		unsubscribeSnapshot = void 0;
+		snapshotMessages = void 0;
 		client = createClient();
+		if (messages) client.setMessagesManually(messages);
 		clientStatus = "ready";
 		previous.stop();
 		previous.detach();
 		liveToolCalls.clear();
-		liveToolMessageIds.clear();
 		update({ activeToolCallIds: [] });
-		if (started) client.attach();
+		if (started) attachClient();
 		previous.dispose();
 	};
 	const scopeCompletedToolCalls = () => {
 		historicalToolIds.clear();
-		client.setMessagesManually(state.messages.map((message) => {
+		client.setMessagesManually(client.getSnapshot().messages.map((message) => {
 			const aliases = /* @__PURE__ */ new Map();
 			const parts = message.parts.map((part) => {
 				if (part.type !== "tool-call" || webPartMetadata(part).providerExecuted) return part;
@@ -12471,7 +12539,7 @@ function createAstralBeamChat(options, deferStart = false) {
 					...part,
 					upstreamToolCallId,
 					id,
-					...part.name === "render_widget" && liveToolMessageIds.get(upstreamToolCallId) === message.id ? { widgetRenderId: stored.widgetRenderId ?? part.id } : {}
+					...part.name === "render_widget" && liveToolMessageIds.get(upstreamToolCallId) === message.id ? { widgetRenderId: stored.widgetRenderId ?? messagePresentation.get(message.id)?.renderIds?.get(savedToolCallId(message.id, part.id)) ?? part.id } : {}
 				};
 			});
 			if (aliases.size) historicalToolIds.set(message.id, aliases);
@@ -12495,7 +12563,11 @@ function createAstralBeamChat(options, deferStart = false) {
 		requestController = new AbortController();
 		toolResults = threadToolResults.get(threadId ?? "") ?? /* @__PURE__ */ new Map();
 		historicalToolIds.clear();
+		liveToolMessageIds.clear();
 		threadRecords = [];
+		messagePresentation.clear();
+		projectedMessages = /* @__PURE__ */ new WeakMap();
+		presentationVersion++;
 		disposeRenders();
 		update({
 			thread: void 0,
@@ -12523,7 +12595,7 @@ function createAstralBeamChat(options, deferStart = false) {
 		submission = submissions.get(id);
 		if (submission) update({ submission: project(submission) });
 		try {
-			if (!started) client.attach();
+			if (!started) attachClient();
 			await hydration;
 			if (generation !== selectionGeneration) return;
 			if (threadKey) selectedThread(threadKey, id);
@@ -12561,10 +12633,9 @@ function createAstralBeamChat(options, deferStart = false) {
 	const refreshThread = async (explicit = true) => {
 		if (!state.thread) return;
 		const generation = selectionGeneration;
-		update({ olderMessagesLoading: false });
 		try {
 			client.detach();
-			client.attach();
+			attachClient();
 			await hydration;
 			if (explicit && generation === selectionGeneration) update({ error: void 0 });
 		} catch (error) {
@@ -12579,6 +12650,7 @@ function createAstralBeamChat(options, deferStart = false) {
 		update({ olderMessagesLoading: true });
 		try {
 			await client.loadOlderMessages();
+			if (generation === selectionGeneration && unsubscribeSnapshot) observeSnapshot();
 		} catch (error) {
 			if (generation === selectionGeneration) reportError(error);
 		} finally {
@@ -12745,12 +12817,14 @@ function createAstralBeamChat(options, deferStart = false) {
 	const start = () => {
 		if (started) return;
 		started = true;
+		const interruptedHydration = requestController.signal.aborted && client.getIsHydrating();
 		client.updateOptions({ tools: declareTools() });
-		client.attach();
 		if (requestController.signal.aborted) requestController = new AbortController();
 		unsubscribeAuthentication = subscribeAuthentication(authentication, observeAuthentication);
 		observeAuthentication();
 		stopAuthentication = startAuthentication(authentication);
+		if (interruptedHydration) replaceClient(client.getSnapshot().messages);
+		else attachClient();
 	};
 	if (!deferStart) start();
 	return {
@@ -12878,12 +12952,13 @@ function createAstralBeamChat(options, deferStart = false) {
 		},
 		dispose: () => {
 			releaseSubmission("The chat closed before this was sent.");
+			unsubscribeSnapshot?.();
+			unsubscribeSnapshot = void 0;
 			client.detach();
 			disposeRenders();
 			client.stop();
 			requestController.abort();
 			selectionGeneration++;
-			threadKey = void 0;
 			capabilitiesGeneration++;
 			capabilityIdentity = void 0;
 			stopAuthentication?.();
@@ -12891,7 +12966,12 @@ function createAstralBeamChat(options, deferStart = false) {
 			disposeChatAuthentication(authentication);
 			started = false;
 			queueMicrotask(() => {
-				if (!started) client.dispose();
+				if (!started) {
+					client.dispose();
+					threadKey = void 0;
+					messagePresentation.clear();
+					projectedMessages = /* @__PURE__ */ new WeakMap();
+				}
 			});
 			listeners.clear();
 		}

package/dist/core.d.ts

@@ -1,2 +1,2 @@
-import { A as ChatSubmissionCallbacks, B as RenderWidgetInput, C as lastPartInProgress, D as AstralBeamChatState, E as AstralBeamChatCoreOptions, F as McpCatalog, G as SandboxStatus, H as SandboxArtifact, I as McpConnectionOperation, J as ParametersSchema, K as InferParameters, L as ChatAuthenticationState, M as createAstralBeamChat, N as ChatPendingInteraction, O as ChatStreamCallbacks, P as ChatThread, R as WidgetDeclaration, S as isSettledToolCall, T as AstralBeamChatCore, U as SandboxCommandRun, V as SandboxActivity, W as SandboxFileWrite, X as ToolDefinition, Y as StandardSchemaV1, _ as readSandboxArtifact, a as defineTool, b as sandboxRefusal, c as SANDBOX_LIST_FILES_TOOL, d as SANDBOX_RUN_COMMAND_TOOL, f as SANDBOX_STATUS_EVENT, g as isSandboxTool, h as describeSandboxCommandRun, i as WebSource, j as WidgetRenderRequest, k as ChatSubmission, l as SANDBOX_PUBLISH_ARTIFACT_TOOL, m as collectSandboxActivity, n as WebEvidence, o as ASK_QUESTIONNAIRE_TOOL, p as SANDBOX_WRITE_FILE_TOOL, q as JsonSchemaObject, r as WebPartMetadata, s as RENDER_WIDGET_TOOL, t as WebCitation, u as SANDBOX_READ_FILE_TOOL, v as readSandboxCommandRun, w as AgentToolInfo, x as hasPendingToolRun, y as readSandboxFileWrite, z as buildAgentTools } from "./index-DatxwZpZ.js";
+import { A as ChatSubmissionCallbacks, B as RenderWidgetInput, C as lastPartInProgress, D as AstralBeamChatState, E as AstralBeamChatCoreOptions, F as McpCatalog, G as SandboxStatus, H as SandboxArtifact, I as McpConnectionOperation, J as ParametersSchema, K as InferParameters, L as ChatAuthenticationState, M as createAstralBeamChat, N as ChatPendingInteraction, O as ChatStreamCallbacks, P as ChatThread, R as WidgetDeclaration, S as isSettledToolCall, T as AstralBeamChatCore, U as SandboxCommandRun, V as SandboxActivity, W as SandboxFileWrite, X as ToolDefinition, Y as StandardSchemaV1, _ as readSandboxArtifact, a as defineTool, b as sandboxRefusal, c as SANDBOX_LIST_FILES_TOOL, d as SANDBOX_RUN_COMMAND_TOOL, f as SANDBOX_STATUS_EVENT, g as isSandboxTool, h as describeSandboxCommandRun, i as WebSource, j as WidgetRenderRequest, k as ChatSubmission, l as SANDBOX_PUBLISH_ARTIFACT_TOOL, m as collectSandboxActivity, n as WebEvidence, o as ASK_QUESTIONNAIRE_TOOL, p as SANDBOX_WRITE_FILE_TOOL, q as JsonSchemaObject, r as WebPartMetadata, s as RENDER_WIDGET_TOOL, t as WebCitation, u as SANDBOX_READ_FILE_TOOL, v as readSandboxCommandRun, w as AgentToolInfo, x as hasPendingToolRun, y as readSandboxFileWrite, z as buildAgentTools } from "./index-DGfDkU_f.js";
 export { ASK_QUESTIONNAIRE_TOOL, type AgentToolInfo, type AstralBeamChatCore, type AstralBeamChatCoreOptions, type AstralBeamChatState, type ChatAuthenticationState, type ChatPendingInteraction, type ChatStreamCallbacks, type ChatSubmission, type ChatSubmissionCallbacks, type ChatThread, type InferParameters, type JsonSchemaObject, type McpCatalog, type McpConnectionOperation, type ParametersSchema, RENDER_WIDGET_TOOL, type RenderWidgetInput, SANDBOX_LIST_FILES_TOOL, SANDBOX_PUBLISH_ARTIFACT_TOOL, SANDBOX_READ_FILE_TOOL, SANDBOX_RUN_COMMAND_TOOL, SANDBOX_STATUS_EVENT, SANDBOX_WRITE_FILE_TOOL, type SandboxActivity, type SandboxArtifact, type SandboxCommandRun, type SandboxFileWrite, type SandboxStatus, type StandardSchemaV1, type ToolDefinition, type WebCitation, type WebEvidence, type WebPartMetadata, type WebSource, type WidgetDeclaration, type WidgetRenderRequest, buildAgentTools, collectSandboxActivity, createAstralBeamChat, defineTool, describeSandboxCommandRun, hasPendingToolRun, isSandboxTool, isSettledToolCall, lastPartInProgress, readSandboxArtifact, readSandboxCommandRun, readSandboxFileWrite, sandboxRefusal };

package/dist/core.js

@@ -1 +1 @@
-export { h as ASK_QUESTIONNAIRE_TOOL, g as RENDER_WIDGET_TOOL, _ as SANDBOX_LIST_FILES_TOOL, v as SANDBOX_PUBLISH_ARTIFACT_TOOL, y as SANDBOX_READ_FILE_TOOL, b as SANDBOX_RUN_COMMAND_TOOL, x as SANDBOX_STATUS_EVENT, S as SANDBOX_WRITE_FILE_TOOL, m as buildAgentTools, i as collectSandboxActivity, r as createAstralBeamChat, t as defineTool, a as describeSandboxCommandRun, d as hasPendingToolRun, o as isSandboxTool, f as isSettledToolCall, p as lastPartInProgress, s as readSandboxArtifact, c as readSandboxCommandRun, l as readSandboxFileWrite, u as sandboxRefusal } from "./core-CWFT6Db_.js";
+export { h as ASK_QUESTIONNAIRE_TOOL, g as RENDER_WIDGET_TOOL, _ as SANDBOX_LIST_FILES_TOOL, v as SANDBOX_PUBLISH_ARTIFACT_TOOL, y as SANDBOX_READ_FILE_TOOL, b as SANDBOX_RUN_COMMAND_TOOL, x as SANDBOX_STATUS_EVENT, S as SANDBOX_WRITE_FILE_TOOL, m as buildAgentTools, i as collectSandboxActivity, r as createAstralBeamChat, t as defineTool, a as describeSandboxCommandRun, d as hasPendingToolRun, o as isSandboxTool, f as isSettledToolCall, p as lastPartInProgress, s as readSandboxArtifact, c as readSandboxCommandRun, l as readSandboxFileWrite, u as sandboxRefusal } from "./core-Bn3w2Q44.js";

package/dist/{index-DatxwZpZ.d.ts → index-DGfDkU_f.d.ts}

@@ -6132,14 +6132,8 @@ type AstralBeamChatThemeVariables = Record<`--${string}`, string>;
 interface AstralBeamTokenRequest extends RequestInit {
   url: string;
 }
-/**
- * Where the widget's short-lived chat auth token comes from: an endpoint to POST, or a function that
- * mints the token in the host page and returns `{ token }`, optionally as a promise.
- *
- * Either form runs again on every renewal — near expiry and after a token is rejected — so a
- * rotating credential stays current rather than being captured once. A function that returns
- * `undefined`, or throws, fails authentication closed; the composer's retry link asks again.
- */
+/** Retrieves a server-minted token on acquisition and renewal, including after a token rejection.
+ * Returning undefined or throwing fails authentication closed. The composer's retry link asks again. */
 type AstralBeamTokenSource = AstralBeamTokenRequest | (() => {
   token: string;
 } | undefined | Promise<{
@@ -6199,12 +6193,8 @@ interface MountAstralBeamChatOptions {
    * hosted cloud; self-hosted deployments must set their own origin.
    */
   apiUrl?: string | undefined;
-  /**
-   * Where the short-lived chat auth token comes from: `{ url, ...RequestInit }` for a token
-   * endpoint, or a function that mints `{ token }` in the host page. Read for every token, so a
-   * change applies to the next one, which is minted when the cached token nears expiry. Default
-   * `{ url: "/api/astralbeam/token" }`, posted with the page's cookies.
-   */
+  /** Endpoint or callback retrieving a server-minted token, read on each acquisition and renewal.
+   * Defaults to POST /api/astralbeam/token with the page's cookies. Never expose API keys here. */
   fetchAstralBeamToken?: AstralBeamTokenSource | undefined;
   /** Host-defined tools the agent can call, executed in the host page, keyed by tool name. */
   tools?: Record<string, ToolDefinition> | undefined;
@@ -6610,7 +6600,7 @@ interface ChatSubmission {
   error?: Error | undefined;
 }
 interface AstralBeamChatState {
-  messages: UIMessage[];
+  messages: ChatClientSnapshot["messages"];
   /** The run status: "ready", "submitted", "streaming", or "error". */
   status: ChatClientState;
   /** The latest failure outside a submission, such as history loading or a failed reply. */
@@ -6708,8 +6698,8 @@ declare function isSettledToolCall(part: {
   state: string;
   output?: unknown;
 }): boolean;
-declare function lastPartInProgress(messages: UIMessage[]): boolean;
-declare function hasPendingToolRun(messages: UIMessage[], toolNames: ReadonlySet<string>): boolean;
+declare function lastPartInProgress(messages: readonly UIMessage[]): boolean;
+declare function hasPendingToolRun(messages: readonly UIMessage[], toolNames: ReadonlySet<string>): boolean;
 //#endregion
 //#region src/core/sandbox.d.ts
 /**
@@ -6734,7 +6724,7 @@ declare function readSandboxCommandRun(part: ToolCallPart): SandboxCommandRun |
  * The whole conversation's sandbox work, for the panel. A path written more than once appears
  * once, holding its latest content, because the panel answers "what is in the sandbox now".
  */
-declare function collectSandboxActivity(messages: UIMessage[]): SandboxActivity;
+declare function collectSandboxActivity(messages: readonly UIMessage[]): SandboxActivity;
 /** The one-line summary a finished command carries, in its row's label and under its log. */
 declare function describeSandboxCommandRun(run: SandboxCommandRun): string;
 //#endregion

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { D as AstralBeamChatState, E as AstralBeamChatCoreOptions, T as AstralBeamChatCore } from "./index-DatxwZpZ.js";
+import { D as AstralBeamChatState, E as AstralBeamChatCoreOptions, T as AstralBeamChatCore } from "./index-DGfDkU_f.js";
 import { CSSProperties, ReactNode } from "react";
 import { AstralBeamChatAttachmentOptions, AstralBeamChatColorScheme, AstralBeamChatTheme, AstralBeamListingHandle, AstralBeamTokenRequest, AstralBeamTokenSource, InferParameters, JsonSchemaObject, MountAstralBeamChatOptions, MountAstralBeamMcpServersOptions, MountAstralBeamTenantListOptions, MountAstralBeamTenantUserListOptions, MountAstralBeamThreadListOptions, ParametersSchema, ToolDefinition, WidgetDefinition as WidgetDefinition$1, defineTool } from "@astralbeam/sdk/client";
 //#region src/react/listings.d.ts
@@ -58,7 +58,7 @@ export interface UseAstralBeamChatResult extends AstralBeamChatState {
 export declare function useAstralBeamChat(options: AstralBeamChatCoreOptions): UseAstralBeamChatResult;
 /** Imperative surface of a mounted `<AstralBeamChat>`, for hosts that draw their own controls. */
 export interface AstralBeamChatRef {
-  /** Clears the conversation: transcript, drafts, attachments, and live widget renders. */
+  /** Starts a fresh conversation and clears its draft, preserving saved conversations and their drafts. */
   reset: () => void;
   /** Stops the in-flight generation, if any; the transcript keeps what already streamed. */
   stop: () => void;

package/dist/react.js

@@ -1,4 +1,4 @@
-import { n as CORE_OPTION_KEYS, r as createAstralBeamChat } from "./core-CWFT6Db_.js";
+import { n as CORE_OPTION_KEYS, r as createAstralBeamChat } from "./core-Bn3w2Q44.js";
 import { Ut as DEFAULT_COLOR_SCHEME } from "./api-SpkUzEv3.js";
 import { forwardRef, useEffect, useImperativeHandle, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";