@astralbeam/sdk 0.0.2 → 0.0.4

package/dist/client.d.ts

@@ -32,6 +32,11 @@ interface WidgetDefinition {
 interface ToolDefinition {
   /** Tells the agent what the tool does so it can decide when to call it. */
   description: string;
+  /**
+   * Forwarded verbatim as the tool definition's metadata. A string `title` labels the tool's
+   * transcript entry instead of its registry name (`refresh_invoices` reads as "Refresh invoices").
+   */
+  metadata?: Record<string, unknown> | undefined;
   /**
    * Forwarded to the agent as JSON Schema. Only a Standard Schema also validates the
    * input before `execute` runs; with a plain JSON Schema, treat the input as untrusted.
@@ -83,6 +88,11 @@ interface AstralBeamChatTheme {
 interface MountAstralBeamChatOptions {
   /** 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`.
+   */
+  showHeader?: boolean | undefined;
   /** URL of the AstralBeam chat endpoint the widget streams from. Fixed at mount. Default `"/api/chat"`. */
   chatEndpoint?: string | undefined;
   /** Application endpoint that mints a short-lived chat JWT. Fixed at mount; omit for guest chat. */

package/dist/client.js

@@ -1 +1 @@
-import{a as e,t}from"./client-utils-DyEcBInP.js";function n(n,r={}){let i={...r},a=t(i.debug);a?.(`mount`,`mounting chat widget`,{title:i.title??`AstralBeam`,chatEndpoint:i.chatEndpoint??`/api/chat`,authentication:i.authEndpoint?`configured`:`guest`,colorScheme:i.colorScheme??`system`,theme:i.theme,systemPrompt:i.systemPrompt,tools:Object.keys(i.tools??{}),widgets:Object.keys(i.widgets??{}),attachments:i.attachments??!0});let o=n.shadowRoot??n.attachShadow({mode:`open`}),s=document.createElement(`div`);s.className=e,s.style.height=`100%`,o.append(s);let c=matchMedia(`(prefers-color-scheme: dark)`),l=new Set,u=e=>{for(let e of l)s.style.removeProperty(e);l.clear();let t={...i.theme?.light,...e?i.theme?.dark:void 0};for(let[e,n]of Object.entries(t))e.startsWith(`--`)&&(s.style.setProperty(e,n),l.add(e))},d=()=>{let e=i.colorScheme??`system`,t=e===`dark`||e===`system`&&c.matches;s.classList.toggle(`dark`,t),u(t),a?.(`theme`,`color scheme "${e}" resolved to ${t?`dark`:`light`}`,{themeVariables:[...l]})};d(),c.addEventListener(`change`,d);let f=!1,p;return import(`./chat-DdU0uj9s.js`).then(({renderChat:e})=>{a?.(`mount`,`chat chunk loaded`),f||(p=e(o,s,i))}),{update:e=>{i={...i,...e},a=t(i.debug),a?.(`mount`,`options updated`,{changed:Object.keys(e)}),d(),p?.update(i)},unmount:()=>{a?.(`mount`,`unmounting chat widget`),f=!0,c.removeEventListener(`change`,d),p?.dispose(),p=void 0,s.remove()}}}export{n as mountAstralBeamChat};
+import{a as e,t}from"./client-utils-DyEcBInP.js";function n(n,r={}){let i={...r},a=t(i.debug);a?.(`mount`,`mounting chat widget`,{title:i.title??`AstralBeam`,showHeader:i.showHeader??!0,chatEndpoint:i.chatEndpoint??`/api/chat`,authentication:i.authEndpoint?`configured`:`guest`,colorScheme:i.colorScheme??`system`,theme:i.theme,systemPrompt:i.systemPrompt,tools:Object.keys(i.tools??{}),widgets:Object.keys(i.widgets??{}),attachments:i.attachments??!0});let o=n.shadowRoot??n.attachShadow({mode:`open`}),s=document.createElement(`div`);s.className=e,s.style.height=`100%`,o.append(s);let c=matchMedia(`(prefers-color-scheme: dark)`),l=new Set,u=e=>{for(let e of l)s.style.removeProperty(e);l.clear();let t={...i.theme?.light,...e?i.theme?.dark:void 0};for(let[e,n]of Object.entries(t))e.startsWith(`--`)&&(s.style.setProperty(e,n),l.add(e))},d=()=>{let e=i.colorScheme??`system`,t=e===`dark`||e===`system`&&c.matches;s.classList.toggle(`dark`,t),u(t),a?.(`theme`,`color scheme "${e}" resolved to ${t?`dark`:`light`}`,{themeVariables:[...l]})};d(),c.addEventListener(`change`,d);let f=!1,p;return import(`./chat-DPX4FOaL.js`).then(({renderChat:e})=>{a?.(`mount`,`chat chunk loaded`),f||(p=e(o,s,i))}),{update:e=>{i={...i,...e},a=t(i.debug),a?.(`mount`,`options updated`,{changed:Object.keys(e)}),d(),p?.update(i)},unmount:()=>{a?.(`mount`,`unmounting chat widget`),f=!0,c.removeEventListener(`change`,d),p?.dispose(),p=void 0,s.remove()}}}export{n as mountAstralBeamChat};

package/dist/react.d.ts

@@ -9,6 +9,11 @@ interface WidgetDefinition extends Omit<WidgetDefinition$1, "render"> {
 interface AstralBeamChatProps {
   /** Name shown in the widget's header; prop changes apply immediately. Default `"AstralBeam"`. */
   title?: string;
+  /**
+   * Shows the widget's header with the title and the reset button; `false` hides both and gives
+   * the transcript the full height. Prop changes apply immediately. Default `true`.
+   */
+  showHeader?: boolean;
   /** URL of the AstralBeam chat endpoint the widget streams from. Default `"/api/chat"`. */
   chatEndpoint?: string;
   /** Application endpoint that mints a short-lived chat JWT; omit for guest chat. */
@@ -33,6 +38,7 @@ interface AstralBeamChatProps {
 }
 declare function AstralBeamChat({
   title,
+  showHeader,
   chatEndpoint,
   authEndpoint,
   systemPrompt,

package/dist/react.js

@@ -7,7 +7,7 @@ import { jsx } from "react/jsx-runtime";
 const DEFAULT_COLOR_SCHEME = "system";
 //#endregion
 //#region src/react.tsx
-function AstralBeamChat({ title, chatEndpoint, authEndpoint, systemPrompt, tools, widgets = {}, colorScheme = DEFAULT_COLOR_SCHEME, theme, attachments, debug }) {
+function AstralBeamChat({ title, showHeader, chatEndpoint, authEndpoint, systemPrompt, tools, widgets = {}, colorScheme = DEFAULT_COLOR_SCHEME, theme, attachments, debug }) {
 	const targetRef = useRef(null);
 	const handleRef = useRef(null);
 	const [activeRenders, setActiveRenders] = useState(/* @__PURE__ */ new Map());
@@ -44,6 +44,7 @@ function AstralBeamChat({ title, chatEndpoint, authEndpoint, systemPrompt, tools
 	}])), [widgets]);
 	const live = useMemo(() => ({
 		title,
+		showHeader,
 		systemPrompt,
 		colorScheme,
 		theme,
@@ -53,6 +54,7 @@ function AstralBeamChat({ title, chatEndpoint, authEndpoint, systemPrompt, tools
 		widgets: hostWidgets
 	}), [
 		title,
+		showHeader,
 		systemPrompt,
 		colorScheme,
 		theme,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astralbeam/sdk",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Frontend SDK for AstralBeam: drop-in agent UI, chat streaming, and server helpers",
   "license": "MIT",
   "type": "module",
@@ -74,6 +74,7 @@
     "@tanstack/ai": "^0.49.1",
     "@tanstack/ai-client": "^0.28.0",
     "@tanstack/ai-react": "^0.22.1",
+    "@tanstack/markdown": "^0.0.13",
     "@types/react": "^19.2.13",
     "@types/react-dom": "^19.2.3",
     "class-variance-authority": "^0.7.1",