@astralbeam/sdk 0.4.2 → 0.6.0

package/dist/react.d.ts

@@ -1,6 +1,6 @@
-import { C as AstralBeamChatState, S as AstralBeamChatCoreOptions, x as AstralBeamChatCore } from "./index-DJWIt_VP.js";
+import { C as AstralBeamChatState, S as AstralBeamChatCoreOptions, x as AstralBeamChatCore } from "./index-TbZxlv54.js";
 import { ReactNode } from "react";
-import { AstralBeamChatAttachmentOptions, AstralBeamChatAuthTokenHeaders, AstralBeamChatColorScheme, AstralBeamChatTheme, InferParameters, JsonSchemaObject, ParametersSchema, ToolDefinition, WidgetDefinition as WidgetDefinition$1, defineTool } from "@astralbeam/sdk/client";
+import { AstralBeamChatAttachmentOptions, AstralBeamChatAuthTokenRequest, AstralBeamChatAuthTokenSource, AstralBeamChatColorScheme, AstralBeamChatTheme, InferParameters, JsonSchemaObject, ParametersSchema, ToolDefinition, WidgetDefinition as WidgetDefinition$1, defineTool } from "@astralbeam/sdk/client";
 
 //#region src/react/index.d.ts
 interface WidgetDefinition extends Omit<WidgetDefinition$1, "render"> {
@@ -26,11 +26,9 @@ interface UseAstralBeamChatResult extends AstralBeamChatState {
 }
 /**
  * The headless chat session as a React hook: authentication, transport, tools, and transcript
- * state with no markup, for hosts that own their whole chat UI. Transport identity (endpoints,
- * agent) and the declared tool/widget set are fixed for the component's lifetime — remount with
- * a React `key` to change them — but `execute` and `onRenderWidget` read the latest render, so
- * ordinary closures over props and state stay live. Whether a widget renderer exists at all is
- * part of the declared surface and is read at mount.
+ * state with no markup, for hosts that own their whole chat UI. Every option follows the props it
+ * is given, keeping the transcript and the chat session, so ordinary closures over props and
+ * state stay live and nothing needs a remount.
  */
 declare function useAstralBeamChat(options: AstralBeamChatCoreOptions): UseAstralBeamChatResult;
 /** Imperative surface of a mounted `<AstralBeamChat>`, for hosts that draw their own controls. */
@@ -42,15 +40,16 @@ interface AstralBeamChatRef {
 }
 interface AstralBeamChatProps {
   /**
-   * Public ID of the organization-owned agent, fixed for this mounted chat. Omit it to use the
-   * organization's default agent, which the dashboard's agents page selects.
+   * 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.
    */
   agentId?: string;
-  /** Name shown in the widget's header; prop changes apply immediately. Default `"AstralBeam"`. */
+  /** Name shown in the widget's header. 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`.
+   * the transcript the full height. Default `true`.
    */
   showHeader?: boolean;
   /** Replaces the header's content with the host's own React content; `showHeader` still applies. */
@@ -59,28 +58,29 @@ interface AstralBeamChatProps {
   empty?: ReactNode;
   /** Extra host controls at the end of the composer's button row, next to send. */
   composerActions?: ReactNode;
-  /** Headline shown on the empty transcript; prop changes apply immediately. Default `"Ask the assistant"`. */
+  /** Headline shown on the empty transcript. Default `"Ask the assistant"`. */
   emptyTitle?: string;
-  /** Subtitle under the empty transcript's headline; prop changes apply immediately. */
+  /** Subtitle under the empty transcript's headline. */
   emptyDescription?: string;
-  /** Base URL of the AstralBeam API; the widget calls `/chat` under it. Default the hosted cloud. */
+  /**
+   * Base URL of the AstralBeam API; the widget calls `/chat` under it. Read per request, so a
+   * change moves the next one. Default the hosted cloud.
+   */
   apiUrl?: string;
-  /** Application endpoint that mints a short-lived chat JWT. Default `"/api/astralbeam/token"`. */
-  authTokenUrl?: string;
   /**
-   * Extra headers for the token request, for a backend on another origin that authenticates with a
-   * bearer token or custom header instead of cookies. Always read from the latest render, so an
-   * inline object or callback over current auth state is fine, needs no memoization, and may
-   * start out undefined while the host's own credential loads.
+   * Where the short-lived chat JWT comes from: `{ url, ...RequestInit }` for a token endpoint, or
+   * a function minting `{ token }`, optionally a promise, in the host app. Read per token, and
+   * the function form runs in the host's React tree, so an inline closure over current auth state
+   * is fine and needs no memoization. Default `{ url: "/api/astralbeam/token" }`.
    */
-  authTokenHeaders?: AstralBeamChatAuthTokenHeaders;
+  fetchChatAuthToken?: AstralBeamChatAuthTokenSource;
   /** Host-defined tools the agent can call, executed in the host's React app, keyed by name. */
   tools?: Record<string, ToolDefinition>;
   /** Host-defined widgets the agent can render inline in the conversation, keyed by identifier. */
   widgets?: Record<string, WidgetDefinition>;
-  /** Color scheme of the chat widget; prop changes apply immediately. Default `"system"`. */
+  /** Color scheme of the chat widget. Default `"system"`. */
   colorScheme?: AstralBeamChatColorScheme;
-  /** Custom values for the widget's theming CSS variables, per color scheme; changes apply immediately. */
+  /** Custom values for the widget's theming CSS variables, per color scheme. */
   theme?: AstralBeamChatTheme | undefined;
   /** File attachments in the composer, on by default; `false` turns them off. */
   attachments?: boolean | AstralBeamChatAttachmentOptions;
@@ -88,10 +88,10 @@ interface AstralBeamChatProps {
   sandboxPanel?: boolean;
   /**
    * Logs every SDK action to the browser console with UTC timestamps and full payloads,
-   * and asks the endpoint to log its side of the run too; prop changes apply immediately.
+   * and asks the endpoint to log its side of the run too.
    */
   debug?: boolean;
 }
 declare const AstralBeamChat: import("react").ForwardRefExoticComponent<AstralBeamChatProps & import("react").RefAttributes<AstralBeamChatRef>>;
 //#endregion
-export { AstralBeamChat, type AstralBeamChatAttachmentOptions, type AstralBeamChatAuthTokenHeaders, type AstralBeamChatColorScheme, type AstralBeamChatCore, type AstralBeamChatCoreOptions, AstralBeamChatProps, AstralBeamChatRef, type AstralBeamChatState, type AstralBeamChatTheme, type InferParameters, type ParametersSchema, type ToolDefinition, TypedReactWidgetDefinition, UseAstralBeamChatResult, WidgetDefinition, defineTool, defineWidget, useAstralBeamChat };
+export { AstralBeamChat, type AstralBeamChatAttachmentOptions, type AstralBeamChatAuthTokenRequest, type AstralBeamChatAuthTokenSource, type AstralBeamChatColorScheme, type AstralBeamChatCore, type AstralBeamChatCoreOptions, AstralBeamChatProps, AstralBeamChatRef, type AstralBeamChatState, type AstralBeamChatTheme, type InferParameters, type ParametersSchema, type ToolDefinition, TypedReactWidgetDefinition, UseAstralBeamChatResult, WidgetDefinition, defineTool, defineWidget, useAstralBeamChat };

package/dist/react.js

@@ -1,4 +1,4 @@
-import { C as DEFAULT_COLOR_SCHEME, r as createAstralBeamChat } from "./core-2LtbAqiQ.js";
+import { C as DEFAULT_COLOR_SCHEME, r as createAstralBeamChat } from "./core-DYXxodYg.js";
 import { forwardRef, useEffect, useImperativeHandle, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { createPortal } from "react-dom";
 import { defineTool, mountAstralBeamChat } from "@astralbeam/sdk/client";
@@ -10,27 +10,24 @@ function defineWidget(widget) {
 }
 /**
 * The headless chat session as a React hook: authentication, transport, tools, and transcript
-* state with no markup, for hosts that own their whole chat UI. Transport identity (endpoints,
-* agent) and the declared tool/widget set are fixed for the component's lifetime — remount with
-* a React `key` to change them — but `execute` and `onRenderWidget` read the latest render, so
-* ordinary closures over props and state stay live. Whether a widget renderer exists at all is
-* part of the declared surface and is read at mount.
+* state with no markup, for hosts that own their whole chat UI. Every option follows the props it
+* is given, keeping the transcript and the chat session, so ordinary closures over props and
+* state stay live and nothing needs a remount.
 */
 function useAstralBeamChat(options) {
-	const optionsRef = useRef(options);
-	optionsRef.current = options;
-	const [core] = useState(() => createAstralBeamChat({
-		...options,
-		tools: Object.fromEntries(Object.entries(options.tools ?? {}).map(([name, definition]) => [name, {
-			...definition,
-			execute: (input) => {
-				const current = optionsRef.current.tools?.[name];
-				if (!current) throw new Error(`Tool "${name}" is no longer registered`);
-				return current.execute(input);
-			}
-		}])),
-		onRenderWidget: options.onRenderWidget === void 0 ? void 0 : (request) => optionsRef.current.onRenderWidget?.(request)
-	}));
+	const [core] = useState(() => createAstralBeamChat(options));
+	useEffect(() => {
+		core.updateOptions(options);
+	}, [
+		core,
+		options.agentId,
+		options.apiUrl,
+		options.fetchChatAuthToken,
+		options.tools,
+		options.widgets,
+		options.onRenderWidget,
+		options.debug
+	]);
 	useEffect(() => () => core.dispose(), [core]);
 	return {
 		...useSyncExternalStore(core.subscribe, core.getState, core.getState),
@@ -42,7 +39,7 @@ function useAstralBeamChat(options) {
 		core
 	};
 }
-const AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, showHeader, header, empty, composerActions, emptyTitle, emptyDescription, apiUrl, authTokenUrl, authTokenHeaders, tools, widgets = {}, colorScheme = DEFAULT_COLOR_SCHEME, theme, attachments, sandboxPanel, debug }, ref) {
+const AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, showHeader, header, empty, composerActions, emptyTitle, emptyDescription, apiUrl, fetchChatAuthToken, tools, widgets = {}, colorScheme = DEFAULT_COLOR_SCHEME, theme, attachments, sandboxPanel, debug }, ref) {
 	const targetRef = useRef(null);
 	const handleRef = useRef(null);
 	const [activeRenders, setActiveRenders] = useState(/* @__PURE__ */ new Map());
@@ -54,10 +51,6 @@ const AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, show
 	useEffect(() => {
 		toolsRef.current = tools;
 	});
-	const authTokenHeadersRef = useRef(authTokenHeaders);
-	useEffect(() => {
-		authTokenHeadersRef.current = authTokenHeaders;
-	});
 	const nextRenderKey = useRef(0);
 	const hostTools = useMemo(() => Object.fromEntries(Object.entries(tools ?? {}).map(([name, definition]) => [name, {
 		...definition,
@@ -111,6 +104,9 @@ const AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, show
 		hasComposerActions
 	]);
 	const live = useMemo(() => ({
+		agentId,
+		apiUrl,
+		fetchChatAuthToken,
 		title,
 		showHeader,
 		emptyTitle,
@@ -124,6 +120,9 @@ const AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, show
 		widgets: hostWidgets,
 		slots: chromeSlots
 	}), [
+		agentId,
+		apiUrl,
+		fetchChatAuthToken,
 		title,
 		showHeader,
 		emptyTitle,
@@ -141,16 +140,7 @@ const AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, show
 	liveRef.current = live;
 	useEffect(() => {
 		if (!targetRef.current) return;
-		const handle = mountAstralBeamChat(targetRef.current, {
-			...liveRef.current,
-			agentId,
-			apiUrl,
-			authTokenUrl,
-			authTokenHeaders: () => {
-				const current = authTokenHeadersRef.current;
-				return typeof current === "function" ? current() : current ?? {};
-			}
-		});
+		const handle = mountAstralBeamChat(targetRef.current, liveRef.current);
 		handleRef.current = handle;
 		return () => {
 			handleRef.current = null;

package/dist/server.d.ts

@@ -1,11 +1,11 @@
 import * as Schema from "effect/Schema";
 
 //#region src/server/index.d.ts
-declare const ASTRALBEAM_TOKEN_AUDIENCE = "astralbeam";
-declare const ASTRALBEAM_CHAT_TOKEN_TYPE = "astralbeam+jwt";
-declare const ASTRALBEAM_CHAT_TOKEN_VERSION = 4;
-declare const ASTRALBEAM_CHAT_TOKEN_LIFETIME_SECONDS = 300;
-declare const ASTRALBEAM_CHAT_TOKEN_MAX_LIFETIME_SECONDS = 600;
+declare const CHAT_AUTH_TOKEN_AUDIENCE = "astralbeam";
+declare const CHAT_AUTH_TOKEN_TYPE = "astralbeam+jwt";
+declare const CHAT_AUTH_TOKEN_VERSION = 4;
+declare const CHAT_AUTH_TOKEN_LIFETIME_SECONDS = 300;
+declare const CHAT_AUTH_TOKEN_MAX_LIFETIME_SECONDS = 600;
 declare const TenantSchema: Schema.Struct<{
   readonly id: Schema.String;
   readonly name: Schema.optional<Schema.String>;
@@ -21,37 +21,18 @@ declare const TenantUserSchema: Schema.Struct<{
 type Tenant = typeof TenantSchema.Type;
 /** User of an Organization's Tenant who interacts with AstralBeam. */
 type TenantUser = typeof TenantUserSchema.Type;
-interface CreateAstralBeamChatTokenOptions<TTenantUser extends TenantUser = TenantUser, TTenant extends Tenant = Tenant> {
+interface CreateChatAuthTokenOptions<TTenantUser extends TenantUser = TenantUser, TTenant extends Tenant = Tenant> {
   readonly apiKey: string;
   readonly user: TTenantUser;
   readonly tenant: TTenant;
   readonly expiresInSeconds?: number | undefined;
 }
-interface CreateAstralBeamTokenRouteOptions<TSession extends object = object, TTenantUser extends TenantUser = TenantUser, TTenant extends Tenant = Tenant> {
-  /** The full API key, or a thunk read per request; missing or empty answers 503. */
-  readonly apiKey: string | undefined | (() => string | undefined);
-  /**
-   * Authenticates the request against the application's own session. Returning nothing, or
-   * throwing, answers 401.
-   */
-  readonly authenticate: (request: Request) => TSession | null | undefined | Promise<TSession | null | undefined>;
-  /** Maps the authenticated session to the tenant user minted into the token. */
-  readonly user: (session: TSession) => TTenantUser;
-  /** Maps the same authenticated session to the tenant minted into the token. */
-  readonly tenant: (session: TSession) => TTenant;
-  readonly expiresInSeconds?: number | undefined;
-}
-/**
- * Builds the fetch-standard `POST` handler for an application's token endpoint, owning the
- * method check, the unconfigured-key 503, the unauthenticated 401, and the `no-store` header.
- */
-declare function createAstralBeamTokenRoute<TSession extends object, TTenantUser extends TenantUser = TenantUser, TTenant extends Tenant = Tenant>(options: CreateAstralBeamTokenRouteOptions<TSession, TTenantUser, TTenant>): (request: Request) => Promise<Response>;
 /** Creates the short-lived bearer token returned by an application's server auth endpoint. */
-declare function createAstralBeamChatToken<TTenantUser extends TenantUser = TenantUser, TTenant extends Tenant = Tenant>({
+declare function createChatAuthToken<TTenantUser extends TenantUser = TenantUser, TTenant extends Tenant = Tenant>({
   apiKey,
   user,
   tenant,
   expiresInSeconds
-}: CreateAstralBeamChatTokenOptions<TTenantUser, TTenant>): Promise<string>;
+}: CreateChatAuthTokenOptions<TTenantUser, TTenant>): Promise<string>;
 //#endregion
-export { ASTRALBEAM_CHAT_TOKEN_LIFETIME_SECONDS, ASTRALBEAM_CHAT_TOKEN_MAX_LIFETIME_SECONDS, ASTRALBEAM_CHAT_TOKEN_TYPE, ASTRALBEAM_CHAT_TOKEN_VERSION, ASTRALBEAM_TOKEN_AUDIENCE, CreateAstralBeamChatTokenOptions, CreateAstralBeamTokenRouteOptions, Tenant, TenantSchema, TenantUser, TenantUserSchema, createAstralBeamChatToken, createAstralBeamTokenRoute };
+export { CHAT_AUTH_TOKEN_AUDIENCE, CHAT_AUTH_TOKEN_LIFETIME_SECONDS, CHAT_AUTH_TOKEN_MAX_LIFETIME_SECONDS, CHAT_AUTH_TOKEN_TYPE, CHAT_AUTH_TOKEN_VERSION, CreateChatAuthTokenOptions, Tenant, TenantSchema, TenantUser, TenantUserSchema, createChatAuthToken };

package/dist/server.js

@@ -638,12 +638,12 @@ var SignJWT = class {
 };
 //#endregion
 //#region src/server/index.ts
-const ASTRALBEAM_TOKEN_AUDIENCE = "astralbeam";
-const ASTRALBEAM_CHAT_TOKEN_TYPE = "astralbeam+jwt";
-const ASTRALBEAM_CHAT_TOKEN_VERSION = 4;
-const ASTRALBEAM_CHAT_TOKEN_LIFETIME_SECONDS = 300;
-const ASTRALBEAM_CHAT_TOKEN_MAX_LIFETIME_SECONDS = 600;
-const CHAT_TOKEN_MAX_BYTES = 16384;
+const CHAT_AUTH_TOKEN_AUDIENCE = "astralbeam";
+const CHAT_AUTH_TOKEN_TYPE = "astralbeam+jwt";
+const CHAT_AUTH_TOKEN_VERSION = 4;
+const CHAT_AUTH_TOKEN_LIFETIME_SECONDS = 300;
+const CHAT_AUTH_TOKEN_MAX_LIFETIME_SECONDS = 600;
+const CHAT_AUTH_TOKEN_MAX_BYTES = 16384;
 const IDENTITY_MAX_BYTES = 8192;
 const textEncoder = new TextEncoder();
 const SlugSchema = Schema.String.pipe(Schema.check(Schema.isPattern(/^[0-9a-z-]{1,63}$/)));
@@ -701,43 +701,9 @@ async function signingKey(secret) {
 	const digest = await crypto.subtle.digest("SHA-256", textEncoder.encode(secret));
 	return textEncoder.encode(encode(new Uint8Array(digest)));
 }
-function tokenRouteResponse(body, status) {
-	return Response.json(body, {
-		status,
-		headers: { "cache-control": "no-store" }
-	});
-}
-/**
-* Builds the fetch-standard `POST` handler for an application's token endpoint, owning the
-* method check, the unconfigured-key 503, the unauthenticated 401, and the `no-store` header.
-*/
-function createAstralBeamTokenRoute(options) {
-	return async (request) => {
-		if (request.method !== "POST") return tokenRouteResponse({ error: "Use POST" }, 405);
-		const apiKey = typeof options.apiKey === "function" ? options.apiKey() : options.apiKey;
-		if (!apiKey) return tokenRouteResponse({ error: "The AstralBeam API key is not configured" }, 503);
-		let session;
-		try {
-			session = await options.authenticate(request);
-		} catch {
-			session = void 0;
-		}
-		if (!session) return tokenRouteResponse({ error: "The session could not be verified" }, 401);
-		try {
-			return tokenRouteResponse({ token: await createAstralBeamChatToken({
-				apiKey,
-				user: options.user(session),
-				tenant: options.tenant(session),
-				...options.expiresInSeconds === void 0 ? {} : { expiresInSeconds: options.expiresInSeconds }
-			}) }, 200);
-		} catch {
-			return tokenRouteResponse({ error: "The chat token could not be created" }, 500);
-		}
-	};
-}
 /** Creates the short-lived bearer token returned by an application's server auth endpoint. */
-async function createAstralBeamChatToken({ apiKey, user, tenant, expiresInSeconds = 300 }) {
-	if (!Number.isInteger(expiresInSeconds) || expiresInSeconds < 60 || expiresInSeconds > 600) throw new Error("AstralBeam chat tokens must live for 60-600 seconds");
+async function createChatAuthToken({ apiKey, user, tenant, expiresInSeconds = 300 }) {
+	if (!Number.isInteger(expiresInSeconds) || expiresInSeconds < 60 || expiresInSeconds > 600) throw new Error("chat auth tokens must live for 60-600 seconds");
 	const { keyId, organizationSlug, keySecret } = parseApiKey(apiKey);
 	const identity = validatedIdentity(user, tenant);
 	const now = Math.floor(Date.now() / 1e3);
@@ -747,11 +713,11 @@ async function createAstralBeamChatToken({ apiKey, user, tenant, expiresInSecond
 		tenant: identity.tenant
 	}).setProtectedHeader({
 		alg: "HS256",
-		typ: ASTRALBEAM_CHAT_TOKEN_TYPE,
+		typ: CHAT_AUTH_TOKEN_TYPE,
 		kid: keyId
-	}).setIssuer(organizationSlug).setAudience(ASTRALBEAM_TOKEN_AUDIENCE).setIssuedAt(now).setExpirationTime(now + expiresInSeconds).sign(await signingKey(keySecret));
-	if (textEncoder.encode(token).byteLength > CHAT_TOKEN_MAX_BYTES) throw new Error(`AstralBeam chat tokens must not exceed ${CHAT_TOKEN_MAX_BYTES} bytes`);
+	}).setIssuer(organizationSlug).setAudience(CHAT_AUTH_TOKEN_AUDIENCE).setIssuedAt(now).setExpirationTime(now + expiresInSeconds).sign(await signingKey(keySecret));
+	if (textEncoder.encode(token).byteLength > CHAT_AUTH_TOKEN_MAX_BYTES) throw new Error(`chat auth tokens must not exceed ${CHAT_AUTH_TOKEN_MAX_BYTES} bytes`);
 	return token;
 }
 //#endregion
-export { ASTRALBEAM_CHAT_TOKEN_LIFETIME_SECONDS, ASTRALBEAM_CHAT_TOKEN_MAX_LIFETIME_SECONDS, ASTRALBEAM_CHAT_TOKEN_TYPE, ASTRALBEAM_CHAT_TOKEN_VERSION, ASTRALBEAM_TOKEN_AUDIENCE, TenantSchema, TenantUserSchema, createAstralBeamChatToken, createAstralBeamTokenRoute };
+export { CHAT_AUTH_TOKEN_AUDIENCE, CHAT_AUTH_TOKEN_LIFETIME_SECONDS, CHAT_AUTH_TOKEN_MAX_LIFETIME_SECONDS, CHAT_AUTH_TOKEN_TYPE, CHAT_AUTH_TOKEN_VERSION, TenantSchema, TenantUserSchema, createChatAuthToken };