@astralbeam/sdk 0.7.0 → 0.10.1

package/dist/api.d.ts

@@ -0,0 +1,333 @@
+//#region src/api/api.d.ts
+interface ApiRequestOptions extends RequestInit {
+  apiUrl?: string | undefined;
+  fetchClient?: typeof globalThis.fetch;
+}
+type ApiKeyOptions = ApiRequestOptions & {
+  apiKey: string;
+  astralBeamToken?: never;
+};
+type JwtOptions = ApiRequestOptions & {
+  astralBeamToken: string;
+  apiKey?: never;
+};
+type ApiOptions = ApiKeyOptions | JwtOptions;
+type FileOptions = ApiRequestOptions & {
+  apiKey?: never;
+  astralBeamToken?: never;
+};
+interface AstralBeamApiError extends Error {
+  name: "AstralBeamApiError";
+  status: number;
+  headers: Headers;
+  body?: AstralBeamApiError$1;
+}
+declare function isAstralBeamApiError(error: unknown): error is AstralBeamApiError;
+declare function astralBeamApiFetch<T>(path: string, options: ApiOptions): Promise<T>;
+declare function astralBeamJwtFetch<T>(path: string, options: JwtOptions): Promise<T>;
+declare function astralBeamChatFetch<_T>(path: string, options: JwtOptions): Promise<Response>;
+declare function astralBeamFileFetch<_T>(path: string, options?: FileOptions): Promise<Response>;
+//#endregion
+//#region src/api/generated/api.d.ts
+/**
+ * Customer-defined JSON object; keys are preserved.
+ */
+type TenantRecordEncodedMetadata = {
+  [key: string]: unknown;
+};
+/**
+ * Persisted Tenant; id is internal, external_id is the customer's exact identity.
+ */
+interface TenantRecordEncoded {
+  id: string;
+  external_id: string;
+  name: string | null;
+  /** Customer-defined JSON object; keys are preserved. */
+  metadata: TenantRecordEncodedMetadata;
+  created_at: string;
+  updated_at: string;
+}
+/**
+ * Live keyset page. Pass either non-null continuation value as the same-named request parameter.
+ */
+interface TenantPage {
+  items: TenantRecordEncoded[];
+  /** Pass as page_after to fetch the next page; null means no next page. */
+  page_after: string | null;
+  /** Pass as page_before to fetch the previous page; null means no previous page. */
+  page_before: string | null;
+}
+type AstralBeamApiErrorIssuesItem = {
+  path: string;
+  message: string;
+};
+interface AstralBeamApiError$1 {
+  type: string;
+  title: string;
+  status: number;
+  detail: string;
+  issues?: AstralBeamApiErrorIssuesItem[];
+}
+/**
+ * Customer-defined JSON object; keys are preserved. Defaults to {} on creation. Updates replace the entire object.
+ */
+type CreateTenantInputMetadata = {
+  [key: string]: unknown;
+};
+interface CreateTenantInput {
+  /**
+   * Your stable external identity. Exact and case-sensitive; whitespace is preserved. Immutable after creation.
+   * @minLength 1
+   * @maxLength 255
+   */
+  external_id: string;
+  /** Defaults to null on creation. Send null to clear the name. */
+  name?: string | null;
+  /** Customer-defined JSON object; keys are preserved. Defaults to {} on creation. Updates replace the entire object. */
+  metadata?: CreateTenantInputMetadata;
+}
+/**
+ * Customer-defined JSON object; keys are preserved. Defaults to {} on creation. Updates replace the entire object.
+ */
+type UpdateTenantInputMetadata = {
+  [key: string]: unknown;
+};
+interface UpdateTenantInput {
+  /** Defaults to null on creation. Send null to clear the name. */
+  name?: string | null;
+  /** Customer-defined JSON object; keys are preserved. Defaults to {} on creation. Updates replace the entire object. */
+  metadata?: UpdateTenantInputMetadata;
+}
+/**
+ * Customer-defined JSON object; keys are preserved.
+ */
+type TenantUserRecordEncodedMetadata = {
+  [key: string]: unknown;
+};
+/**
+ * Persisted TenantUser. Stored admin does not grant or revoke signed JWT authority.
+ */
+interface TenantUserRecordEncoded {
+  id: string;
+  external_id: string;
+  name: string | null;
+  /** Customer-defined JSON object; keys are preserved. */
+  metadata: TenantUserRecordEncodedMetadata;
+  created_at: string;
+  updated_at: string;
+  tenant_id: string;
+  admin: boolean;
+}
+/**
+ * Live keyset page in ascending ID order within one Tenant. Pass either non-null continuation value as the same-named request parameter.
+ */
+interface TenantUserPage {
+  items: TenantUserRecordEncoded[];
+  /** Pass as page_after to fetch the next page; null means no next page. */
+  page_after: string | null;
+  /** Pass as page_before to fetch the previous page; null means no previous page. */
+  page_before: string | null;
+}
+/**
+ * Customer-defined JSON object; keys are preserved. Defaults to {} on creation. Updates replace the entire object.
+ */
+type CreateTenantUserInputMetadata = {
+  [key: string]: unknown;
+};
+interface CreateTenantUserInput {
+  /**
+   * Your stable external identity. Exact and case-sensitive; whitespace is preserved. Immutable after creation.
+   * @minLength 1
+   * @maxLength 255
+   */
+  external_id: string;
+  /** Defaults to null on creation. Send null to clear the name. */
+  name?: string | null;
+  /** Customer-defined JSON object; keys are preserved. Defaults to {} on creation. Updates replace the entire object. */
+  metadata?: CreateTenantUserInputMetadata;
+  /** Defaults to false on creation. Stored admin does not change signed JWT authority. */
+  admin?: boolean;
+}
+/**
+ * Customer-defined JSON object; keys are preserved. Defaults to {} on creation. Updates replace the entire object.
+ */
+type UpdateTenantUserInputMetadata = {
+  [key: string]: unknown;
+};
+interface UpdateTenantUserInput {
+  /** Defaults to null on creation. Send null to clear the name. */
+  name?: string | null;
+  /** Customer-defined JSON object; keys are preserved. Defaults to {} on creation. Updates replace the entire object. */
+  metadata?: UpdateTenantUserInputMetadata;
+  /** Defaults to false on creation. Stored admin does not change signed JWT authority. */
+  admin?: boolean;
+}
+type ChatRunInputForwardedProps = {
+  [key: string]: unknown;
+};
+/**
+ * Legacy mirror of forwardedProps sent by TanStack AI clients.
+ */
+type ChatRunInputData = {
+  [key: string]: unknown;
+};
+/**
+ * AG-UI RunAgentInput, validated by TanStack AI. Messages, tools, context, and resume entries follow AG-UI. forwardedProps accepts agentId and development-only debug. systemPrompt is rejected. Maximum request size: 32 MiB.
+ */
+interface ChatRunInput {
+  threadId: string;
+  runId: string;
+  messages: unknown[];
+  tools: unknown[];
+  context: unknown[];
+  forwardedProps?: ChatRunInputForwardedProps;
+  /** Legacy mirror of forwardedProps sent by TanStack AI clients. */
+  data?: ChatRunInputData;
+  state?: unknown;
+  parentRunId?: string;
+  resume?: unknown[];
+}
+type ChatConfigurationCapabilities = {
+  attachments: boolean;
+};
+interface ChatConfiguration {
+  capabilities: ChatConfigurationCapabilities;
+}
+type ListTenantsParams = {
+  /**
+   * Case-insensitive literal substring of name or external_id. Trimmed, blank means no search.
+   * @maxLength 255
+   * @pattern ^[^\u0000]*$
+   */
+  q?: string;
+  /**
+   * Exact, case-sensitive external ID; whitespace is preserved. Returns zero or one item.
+   * @minLength 1
+   * @maxLength 255
+   */
+  "filter[external_id]"?: string;
+  /**
+   * Positive integer, default 20. Values above 100 are accepted and capped. page_after and page_before are mutually exclusive.
+   * @minimum 1
+   */
+  page_size?: number;
+  /**
+   * @minLength 1
+   * @maxLength 2048
+   */
+  page_after?: string;
+  /**
+   * @minLength 1
+   * @maxLength 2048
+   */
+  page_before?: string;
+};
+type ListUsersForTenantParams = {
+  /**
+   * Case-insensitive literal substring of name or external_id. Trimmed, blank means no search.
+   * @maxLength 255
+   * @pattern ^[^\u0000]*$
+   */
+  q?: string;
+  /**
+   * Exact, case-sensitive external ID; whitespace is preserved. Returns zero or one item.
+   * @minLength 1
+   * @maxLength 255
+   */
+  "filter[external_id]"?: string;
+  /**
+   * Positive integer, default 20. Values above 100 are accepted and capped. page_after and page_before are mutually exclusive.
+   * @minimum 1
+   */
+  page_size?: number;
+  /**
+   * @minLength 1
+   * @maxLength 2048
+   */
+  page_after?: string;
+  /**
+   * @minLength 1
+   * @maxLength 2048
+   */
+  page_before?: string;
+  "filter[admin]"?: ListUsersForTenantFilterAdmin;
+};
+type ListUsersForTenantFilterAdmin = typeof ListUsersForTenantFilterAdmin[keyof typeof ListUsersForTenantFilterAdmin];
+declare const ListUsersForTenantFilterAdmin: {
+  readonly true: "true";
+  readonly false: "false";
+};
+type GetChatConfigParams = {
+  agentId?: string;
+};
+type GetChatFileParams = {
+  ticket: string;
+};
+declare const getListTenantsUrl: (params: ListTenantsParams) => string;
+/**
+ * List Tenants in internal ID order. q searches name or external ID as a case-insensitive literal substring. filter[external_id] adds an exact match. Organization keys and organization-management JWTs see their organization; admin tenant JWTs see only their signed Tenant. Keep filters unchanged when reusing cursors. Live listing, not a snapshot.
+ * @summary List Tenants
+ */
+declare const listTenants: (params: ListTenantsParams, options: Parameters<typeof astralBeamApiFetch>[1]) => Promise<TenantPage>;
+declare const getCreateTenantUrl: () => string;
+/**
+ * Create a Tenant with an exact customer-provided external_id. Requires an organization API key or organization-management JWT with a current owner/developer role. An external_id already used in this organization returns 409; creation never upserts.
+ * @summary Create a Tenant
+ */
+declare const createTenant: (createTenantInput: CreateTenantInput, options: Parameters<typeof astralBeamApiFetch>[1]) => Promise<TenantRecordEncoded>;
+declare const getGetTenantUrl: (id: string) => string;
+/**
+ * Get a Tenant by internal UUID, not external_id.
+ * @summary Get a Tenant
+ */
+declare const getTenant: (id: string, options: Parameters<typeof astralBeamApiFetch>[1]) => Promise<TenantRecordEncoded>;
+declare const getUpdateTenantUrl: (id: string) => string;
+/**
+ * Update supplied name/metadata fields only. Requires an organization API key or organization-management JWT with a current owner/developer role. name:null clears the name; metadata replaces the object. Last-write-wins; no upsert.
+ * @summary Update a Tenant
+ */
+declare const updateTenant: (id: string, updateTenantInput: UpdateTenantInput, options: Parameters<typeof astralBeamApiFetch>[1]) => Promise<TenantRecordEncoded>;
+declare const getListUsersForTenantUrl: (tenantId: string, params: ListUsersForTenantParams) => string;
+/**
+ * List users of one Tenant in internal ID order. q searches name or external ID as a case-insensitive literal substring. Exact filter[external_id] and filter[admin] combine with AND. No matching user returns an empty page; missing and out-of-scope Tenants return 404. Cursors cannot be reused for another Tenant or filter. Live listing, not a snapshot.
+ * @summary List TenantUsers
+ */
+declare const listUsersForTenant: (tenantId: string, params: ListUsersForTenantParams, options: Parameters<typeof astralBeamApiFetch>[1]) => Promise<TenantUserPage>;
+declare const getCreateTenantUserUrl: (tenantId: string) => string;
+/**
+ * Create a TenantUser under the internal tenant_id path identifier, with a customer-provided tenant-local external_id. An external_id already used in this Tenant returns 409; the same external_id in another Tenant is allowed. Stored admin does not change signed JWT authority.
+ * @summary Create a TenantUser
+ */
+declare const createTenantUser: (tenantId: string, createTenantUserInput: CreateTenantUserInput, options: Parameters<typeof astralBeamApiFetch>[1]) => Promise<TenantUserRecordEncoded>;
+declare const getGetTenantUserUrl: (tenantId: string, id: string) => string;
+/**
+ * Get a TenantUser by the internal tenant_id and id pair within the authorized scope. No identity upsert.
+ * @summary Get a TenantUser
+ */
+declare const getTenantUser: (tenantId: string, id: string, options: Parameters<typeof astralBeamApiFetch>[1]) => Promise<TenantUserRecordEncoded>;
+declare const getUpdateTenantUserUrl: (tenantId: string, id: string) => string;
+/**
+ * Update supplied name/metadata/admin fields only. Stored admin does not grant or revoke JWT authority. name:null clears the name; metadata replaces the object.
+ * @summary Update a TenantUser
+ */
+declare const updateTenantUser: (tenantId: string, id: string, updateTenantUserInput: UpdateTenantUserInput, options: Parameters<typeof astralBeamApiFetch>[1]) => Promise<TenantUserRecordEncoded>;
+declare const getRunChatUrl: () => string;
+/**
+ * Stream an AG-UI agent run using a tenant user JWT. No admin claim required. HTTP failures before streaming use AstralBeamApiError. Once streaming starts, failures use RUN_ERROR events. Tool results continue in a subsequent request. Disconnecting cancels the run. Limited to 20 requests per minute per organization, tenant, and user.
+ * @summary Run chat
+ */
+declare const runChat: (chatRunInput: ChatRunInput, options: Parameters<typeof astralBeamChatFetch>[1]) => Promise<Response>;
+declare const getGetChatConfigUrl: (params: GetChatConfigParams) => string;
+/**
+ * Read the selected agent's attachment grant using a tenant user JWT. Omit agentId to use the organization's default agent. Client settings may narrow this grant, never widen it.
+ * @summary Get chat capabilities
+ */
+declare const getChatConfig: (params: GetChatConfigParams, options: Parameters<typeof astralBeamJwtFetch>[1]) => Promise<ChatConfiguration>;
+declare const getGetChatFileUrl: (params: GetChatFileParams) => string;
+/**
+ * Use the signed ticket returned when chat publishes an artifact. No bearer token is required. Returns the original bytes with a content-sniffed Content-Type and Content-Disposition filename. Invalid or expired tickets, a missing sandbox, and rejected artifact checks return 404. Provider or file-read failures return 500.
+ * @summary Download a chat artifact
+ */
+declare const getChatFile: (params: GetChatFileParams, options?: Parameters<typeof astralBeamFileFetch>[1]) => Promise<Response>;
+//#endregion
+export { type ApiKeyOptions, type ApiOptions, type ApiRequestOptions, AstralBeamApiError, type AstralBeamApiError$1 as AstralBeamApiErrorBody, AstralBeamApiErrorIssuesItem, ChatConfiguration, ChatConfigurationCapabilities, ChatRunInput, ChatRunInputData, ChatRunInputForwardedProps, CreateTenantInput, CreateTenantInputMetadata, CreateTenantUserInput, CreateTenantUserInputMetadata, type FileOptions, GetChatConfigParams, GetChatFileParams, type JwtOptions, ListTenantsParams, ListUsersForTenantFilterAdmin, ListUsersForTenantParams, TenantPage, TenantRecordEncoded, TenantRecordEncodedMetadata, TenantUserPage, TenantUserRecordEncoded, TenantUserRecordEncodedMetadata, UpdateTenantInput, UpdateTenantInputMetadata, UpdateTenantUserInput, UpdateTenantUserInputMetadata, createTenant, createTenantUser, getChatConfig, getChatFile, getCreateTenantUrl, getCreateTenantUserUrl, getGetChatConfigUrl, getGetChatFileUrl, getGetTenantUrl, getGetTenantUserUrl, getListTenantsUrl, getListUsersForTenantUrl, getRunChatUrl, getTenant, getTenantUser, getUpdateTenantUrl, getUpdateTenantUserUrl, isAstralBeamApiError, listTenants, listUsersForTenant, runChat, updateTenant, updateTenantUser };

package/dist/api.js

@@ -0,0 +1,2 @@
+import { C as updateTenantUser, S as updateTenant, T as isAstralBeamApiError, _ as getUpdateTenantUrl, a as getChatFile, b as listUsersForTenant, c as getGetChatConfigUrl, d as getGetTenantUserUrl, f as getListTenantsUrl, g as getTenantUser, h as getTenant, i as getChatConfig, l as getGetChatFileUrl, m as getRunChatUrl, n as createTenant, o as getCreateTenantUrl, p as getListUsersForTenantUrl, r as createTenantUser, s as getCreateTenantUserUrl, t as ListUsersForTenantFilterAdmin, u as getGetTenantUrl, v as getUpdateTenantUserUrl, x as runChat, y as listTenants } from "./api-CaNIR6Af.js";
+export { ListUsersForTenantFilterAdmin, createTenant, createTenantUser, getChatConfig, getChatFile, getCreateTenantUrl, getCreateTenantUserUrl, getGetChatConfigUrl, getGetChatFileUrl, getGetTenantUrl, getGetTenantUserUrl, getListTenantsUrl, getListUsersForTenantUrl, getRunChatUrl, getTenant, getTenantUser, getUpdateTenantUrl, getUpdateTenantUserUrl, isAstralBeamApiError, listTenants, listUsersForTenant, runChat, updateTenant, updateTenantUser };

package/dist/client.d.ts

@@ -104,7 +104,7 @@ type AstralBeamChatThemeVariables = Record<`--${string}`, string>;
  * `credentials: "include"`, `cache: "no-store"`, and an `accept: application/json` header, each
  * overridable here, and the response is expected to carry `{ token }` as JSON.
  */
-interface AstralBeamChatAuthTokenRequest extends RequestInit {
+interface AstralBeamTokenRequest extends RequestInit {
   url: string;
 }
 /**
@@ -115,7 +115,7 @@ interface AstralBeamChatAuthTokenRequest extends RequestInit {
  * 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.
  */
-type AstralBeamChatAuthTokenSource = AstralBeamChatAuthTokenRequest | (() => {
+type AstralBeamTokenSource = AstralBeamTokenRequest | (() => {
   token: string;
 } | undefined | Promise<{
   token: string;
@@ -154,7 +154,7 @@ interface MountAstralBeamChatOptions {
   /** Subtitle shown under the empty transcript's headline. Default describes the app's tools and widgets. */
   emptyDescription?: string | undefined;
   /**
-   * Base URL of the AstralBeam API; the widget calls `/chat` and its subroutes under it. Read for
+   * Base URL of the AstralBeam API; the widget calls `/v1/chat` and its subroutes under it. Read for
    * every request, so a change moves the next one. Default `"https://app.astralbeam.ai/api"`, the
    * hosted cloud; self-hosted deployments must set their own origin.
    */
@@ -165,7 +165,7 @@ interface MountAstralBeamChatOptions {
    * 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.
    */
-  fetchChatAuthToken?: AstralBeamChatAuthTokenSource | undefined;
+  fetchAstralBeamToken?: AstralBeamTokenSource | undefined;
   /** Host-defined tools the agent can call, executed in the host page, keyed by tool name. */
   tools?: Record<string, ToolDefinition> | undefined;
   /** Host-defined widgets the agent can render inline in the conversation, keyed by identifier. */
@@ -232,4 +232,4 @@ declare function defineWidget<const S extends ParametersSchema = JsonSchemaObjec
 //#region src/client/index.d.ts
 declare function mountAstralBeamChat(target: HTMLElement, options: MountAstralBeamChatOptions): AstralBeamChatHandle;
 //#endregion
-export { type AstralBeamChatAttachmentOptions, type AstralBeamChatAuthTokenRequest, type AstralBeamChatAuthTokenSource, type AstralBeamChatColorScheme, type AstralBeamChatHandle, type AstralBeamChatSlotRenderer, type AstralBeamChatSlots, type AstralBeamChatTheme, type AstralBeamChatThemeVariables, type AstralBeamChatUpdate, type InferParameters, type JsonSchemaObject, type MountAstralBeamChatOptions, type ParametersSchema, type StandardSchemaV1, type ToolDefinition, type TypedToolDefinition, type TypedWidgetDefinition, type WidgetDefinition, defineTool, defineWidget, mountAstralBeamChat };
+export { type AstralBeamChatAttachmentOptions, type AstralBeamChatColorScheme, type AstralBeamChatHandle, type AstralBeamChatSlotRenderer, type AstralBeamChatSlots, type AstralBeamChatTheme, type AstralBeamChatThemeVariables, type AstralBeamChatUpdate, type AstralBeamTokenRequest, type AstralBeamTokenSource, type InferParameters, type JsonSchemaObject, type MountAstralBeamChatOptions, type ParametersSchema, type StandardSchemaV1, type ToolDefinition, type TypedToolDefinition, type TypedWidgetDefinition, type WidgetDefinition, defineTool, defineWidget, mountAstralBeamChat };

package/dist/client.js

@@ -1 +1 @@
-import{c as e,t}from"./debug-DyjRg3e0.js";function n(e){return e}function r(e){return e}function i(n,r){let i={...r},a=t(i.debug);a?.(`mount`,`mounting chat widget`,{agentId:i.agentId??`(organization default)`,title:i.title??`AstralBeam`,showHeader:i.showHeader??!0,emptyTitle:i.emptyTitle??`Ask the assistant`,emptyDescription:i.emptyDescription??`It can answer questions and act through this app's own tools and widgets.`,apiUrl:i.apiUrl??`https://app.astralbeam.ai/api`,authentication:`configured`,colorScheme:i.colorScheme??`system`,theme:i.theme,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(`./widget-PZ-6BF36.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)},reset:()=>p?.reset(),stop:()=>p?.stop(),unmount:()=>{a?.(`mount`,`unmounting chat widget`),f=!0,c.removeEventListener(`change`,d),p?.dispose(),p=void 0,s.remove()}}}export{n as defineTool,r as defineWidget,i as mountAstralBeamChat};
+import{c as e,t}from"./debug-BSzSiibd.js";function n(e){return e}function r(e){return e}function i(n,r){let i={...r},a=t(i.debug);a?.(`mount`,`mounting chat widget`,{agentId:i.agentId??`(organization default)`,title:i.title??`AstralBeam`,showHeader:i.showHeader??!0,emptyTitle:i.emptyTitle??`Ask the assistant`,emptyDescription:i.emptyDescription??`It can answer questions and act through this app's own tools and widgets.`,apiUrl:i.apiUrl??`https://app.astralbeam.ai/api`,authentication:`configured`,colorScheme:i.colorScheme??`system`,theme:i.theme,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(`./widget-B6YT3G1i.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)},reset:()=>p?.reset(),stop:()=>p?.stop(),unmount:()=>{a?.(`mount`,`unmounting chat widget`),f=!0,c.removeEventListener(`change`,d),p?.dispose(),p=void 0,s.remove()}}}export{n as defineTool,r as defineWidget,i as mountAstralBeamChat};

package/dist/{core-BF1G1dLe.js → core-Dr2IDA6j.js}

@@ -1,19 +1,6 @@
+import { E as resolveApiUrl, T as isAstralBeamApiError, i as getChatConfig, m as getRunChatUrl, w as astralBeamChatFetch } from "./api-CaNIR6Af.js";
 //#region \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
-/**
-* The chat API's URLs under an API base: the stream itself, the agent capability handshake,
-* and artifact downloads. Chat is one API under the base; others will sit beside it.
-*/
-function chatApiUrls(apiUrl) {
-	const chat = `${(apiUrl ?? "https://app.astralbeam.ai/api").replace(/\/+$/, "")}/chat`;
-	return {
-		chat,
-		config: `${chat}/config`,
-		files: `${chat}/files`
-	};
-}
-/** Color scheme used when the mount options and the React prop give none. */
-const DEFAULT_COLOR_SCHEME = "system";
 //#endregion
 //#region node_modules/.deno/@tanstack+ai-client@0.28.0/node_modules/@tanstack/ai-client/dist/esm/response-stream.js
 var UnsupportedResponseStreamError = class extends Error {
@@ -7862,9 +7849,9 @@ function bearerToken(headers) {
 	return authorization?.startsWith("Bearer ") ? authorization.slice(7) : void 0;
 }
 async function requestChatAuthToken(options, signal) {
-	const { fetchChatAuthToken, fetchClient } = options;
-	if (typeof fetchChatAuthToken === "function") return (await fetchChatAuthToken())?.token;
-	const { url, ...init } = fetchChatAuthToken;
+	const { fetchAstralBeamToken, fetchClient } = options;
+	if (typeof fetchAstralBeamToken === "function") return (await fetchAstralBeamToken())?.token;
+	const { url, ...init } = fetchAstralBeamToken;
 	const headers = new Headers(init.headers);
 	if (!headers.has("accept")) headers.set("accept", "application/json");
 	const response = await fetchClient(url, {
@@ -7881,7 +7868,7 @@ async function requestChatAuthToken(options, signal) {
 async function loadChatAuthToken(options) {
 	const { session, onStateChange, debug } = options;
 	const { signal } = session.abortController;
-	const source = typeof options.fetchChatAuthToken === "function" ? "fetchChatAuthToken" : "Authentication endpoint";
+	const source = typeof options.fetchAstralBeamToken === "function" ? "fetchAstralBeamToken" : "Authentication endpoint";
 	try {
 		const token = await requestChatAuthToken(options, signal);
 		if (typeof token !== "string" || !token) throw new Error(`${source} did not return a token`);
@@ -8079,7 +8066,7 @@ function describeSandboxCommandRun(run) {
 const CORE_OPTION_KEYS = Object.keys({
 	agentId: true,
 	apiUrl: true,
-	fetchChatAuthToken: true,
+	fetchAstralBeamToken: true,
 	tools: true,
 	widgets: true,
 	onRenderWidget: true,
@@ -8119,7 +8106,7 @@ function createAstralBeamChat(options) {
 		for (const listener of listeners) listener();
 	};
 	const authentication = {
-		fetchChatAuthToken: live.fetchChatAuthToken ?? { url: "/api/astralbeam/token" },
+		fetchAstralBeamToken: live.fetchAstralBeamToken ?? { url: "/api/astralbeam/token" },
 		session: {
 			cached: void 0,
 			refreshPromise: void 0,
@@ -8134,12 +8121,11 @@ function createAstralBeamChat(options) {
 	const resolveCapabilities = async () => {
 		const generation = ++capabilitiesGeneration;
 		try {
-			const url = new URL(chatApiUrls(live.apiUrl).config, globalThis.location?.href);
-			if (live.agentId) url.searchParams.set("agentId", live.agentId);
 			const token = await getValidChatAuthToken(authentication);
-			const response = await fetch(url, { headers: { authorization: `Bearer ${token}` } });
-			if (!response.ok) throw new Error(`The config request answered ${response.status}`);
-			const body = await response.json();
+			const body = await getChatConfig(live.agentId ? { agentId: live.agentId } : {}, {
+				apiUrl: live.apiUrl,
+				astralBeamToken: token
+			});
 			if (generation !== capabilitiesGeneration) return;
 			const attachments = body.capabilities?.attachments !== false;
 			update({ capabilities: { attachments } });
@@ -8198,15 +8184,29 @@ function createAstralBeamChat(options) {
 		...live.agentId ? { agentId: live.agentId } : {},
 		...live.debug ? { debug: true } : {}
 	});
-	const client = new ChatClient({
-		connection: fetchServerSentEvents(() => chatApiUrls(live.apiUrl).chat, async () => ({
-			headers: { authorization: `Bearer ${await getValidChatAuthToken(authentication)}` },
-			fetchClient: (input, init) => fetchAuthenticatedChat({
+	const connection = fetchServerSentEvents(() => resolveApiUrl(getRunChatUrl(), live.apiUrl), async () => {
+		const token = await getValidChatAuthToken(authentication);
+		return { fetchClient: (_input, init) => astralBeamChatFetch(getRunChatUrl(), {
+			...init,
+			apiUrl: live.apiUrl,
+			astralBeamToken: token,
+			fetchClient: (input, request) => fetchAuthenticatedChat({
 				...authentication,
 				input,
-				init
+				init: request
 			})
-		})),
+		}) };
+	});
+	const connect = connection.connect;
+	connection.connect = async function* (...args) {
+		try {
+			yield* connect(...args);
+		} catch (error) {
+			throw error instanceof Error && isAstralBeamApiError(error.cause) ? error.cause : error;
+		}
+	};
+	const client = new ChatClient({
+		connection,
 		tools: declareTools(),
 		forwardedProps: forwardedProps(),
 		onMessagesChange: (messages) => {
@@ -8273,7 +8273,7 @@ function createAstralBeamChat(options) {
 				...next
 			};
 			debug = createDebugLogger(live.debug);
-			authentication.fetchChatAuthToken = live.fetchChatAuthToken ?? { url: "/api/astralbeam/token" };
+			authentication.fetchAstralBeamToken = live.fetchAstralBeamToken ?? { url: "/api/astralbeam/token" };
 			authentication.debug = debug;
 			client.updateOptions({
 				tools: declareTools(),
@@ -8323,4 +8323,4 @@ function defineTool(tool) {
 	return tool;
 }
 //#endregion
-export { DEFAULT_COLOR_SCHEME as C, SANDBOX_WRITE_FILE_TOOL as S, SANDBOX_LIST_FILES_TOOL as _, describeSandboxCommandRun as a, SANDBOX_RUN_COMMAND_TOOL as b, readSandboxCommandRun as c, hasPendingToolRun as d, isSettledToolCall as f, RENDER_WIDGET_TOOL as g, ASK_QUESTIONNAIRE_TOOL as h, collectSandboxActivity as i, readSandboxFileWrite as l, buildAgentTools as m, CORE_OPTION_KEYS as n, isSandboxTool as o, lastPartInProgress as p, createAstralBeamChat as r, readSandboxArtifact as s, defineTool as t, sandboxRefusal as u, SANDBOX_PUBLISH_ARTIFACT_TOOL as v, SANDBOX_STATUS_EVENT as x, SANDBOX_READ_FILE_TOOL as y };
+export { SANDBOX_WRITE_FILE_TOOL as S, SANDBOX_LIST_FILES_TOOL as _, describeSandboxCommandRun as a, SANDBOX_RUN_COMMAND_TOOL as b, readSandboxCommandRun as c, hasPendingToolRun as d, isSettledToolCall as f, RENDER_WIDGET_TOOL as g, ASK_QUESTIONNAIRE_TOOL as h, collectSandboxActivity as i, readSandboxFileWrite as l, buildAgentTools as m, CORE_OPTION_KEYS as n, isSandboxTool as o, lastPartInProgress as p, createAstralBeamChat as r, readSandboxArtifact as s, defineTool as t, sandboxRefusal as u, SANDBOX_PUBLISH_ARTIFACT_TOOL as v, SANDBOX_STATUS_EVENT as x, SANDBOX_READ_FILE_TOOL as y };

package/dist/core.d.ts

@@ -1,2 +1,2 @@
-import { A as RenderWidgetInput, B as ToolDefinition, C as AstralBeamChatState, D as ChatAuthenticationState, E as createAstralBeamChat, F as SandboxStatus, I as InferParameters, L as JsonSchemaObject, M as SandboxArtifact, N as SandboxCommandRun, O as WidgetDeclaration, P as SandboxFileWrite, R as ParametersSchema, S as AstralBeamChatCoreOptions, T as WidgetRenderRequest, _ as hasPendingToolRun, a as SANDBOX_PUBLISH_ARTIFACT_TOOL, b as AgentToolInfo, c as SANDBOX_STATUS_EVENT, d as describeSandboxCommandRun, f as isSandboxTool, g as sandboxRefusal, h as readSandboxFileWrite, i as SANDBOX_LIST_FILES_TOOL, j as SandboxActivity, k as buildAgentTools, l as SANDBOX_WRITE_FILE_TOOL, m as readSandboxCommandRun, n as ASK_QUESTIONNAIRE_TOOL, o as SANDBOX_READ_FILE_TOOL, p as readSandboxArtifact, r as RENDER_WIDGET_TOOL, s as SANDBOX_RUN_COMMAND_TOOL, t as defineTool, u as collectSandboxActivity, v as isSettledToolCall, w as ChatStreamCallbacks, x as AstralBeamChatCore, y as lastPartInProgress, z as StandardSchemaV1 } from "./index-CudekMKM.js";
+import { A as RenderWidgetInput, B as ToolDefinition, C as AstralBeamChatState, D as ChatAuthenticationState, E as createAstralBeamChat, F as SandboxStatus, I as InferParameters, L as JsonSchemaObject, M as SandboxArtifact, N as SandboxCommandRun, O as WidgetDeclaration, P as SandboxFileWrite, R as ParametersSchema, S as AstralBeamChatCoreOptions, T as WidgetRenderRequest, _ as hasPendingToolRun, a as SANDBOX_PUBLISH_ARTIFACT_TOOL, b as AgentToolInfo, c as SANDBOX_STATUS_EVENT, d as describeSandboxCommandRun, f as isSandboxTool, g as sandboxRefusal, h as readSandboxFileWrite, i as SANDBOX_LIST_FILES_TOOL, j as SandboxActivity, k as buildAgentTools, l as SANDBOX_WRITE_FILE_TOOL, m as readSandboxCommandRun, n as ASK_QUESTIONNAIRE_TOOL, o as SANDBOX_READ_FILE_TOOL, p as readSandboxArtifact, r as RENDER_WIDGET_TOOL, s as SANDBOX_RUN_COMMAND_TOOL, t as defineTool, u as collectSandboxActivity, v as isSettledToolCall, w as ChatStreamCallbacks, x as AstralBeamChatCore, y as lastPartInProgress, z as StandardSchemaV1 } from "./index-BQBdZKyB.js";
 export { ASK_QUESTIONNAIRE_TOOL, type AgentToolInfo, type AstralBeamChatCore, type AstralBeamChatCoreOptions, type AstralBeamChatState, type ChatAuthenticationState, type ChatStreamCallbacks, type InferParameters, type JsonSchemaObject, 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 WidgetDeclaration, type WidgetRenderRequest, buildAgentTools, collectSandboxActivity, createAstralBeamChat, defineTool, describeSandboxCommandRun, hasPendingToolRun, isSandboxTool, isSettledToolCall, lastPartInProgress, readSandboxArtifact, readSandboxCommandRun, readSandboxFileWrite, sandboxRefusal };

package/dist/core.js

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

package/dist/debug-BSzSiibd.js

@@ -0,0 +1 @@
+const e=`AstralBeam`,t=`Ask the assistant`,n=`It can answer questions and act through this app's own tools and widgets.`,r=`https://app.astralbeam.ai/api`,i=`/api/astralbeam/token`,a=`system`,o=`astralbeam-root`,s=e=>`background:${e};color:#fff;border-radius:3px;padding:1px 5px`,c=`${s(`#7c3aed`)};font-weight:600`,l={mount:`#7c3aed`,auth:`#be185d`,theme:`#8b5cf6`,send:`#2563eb`,run:`#0891b2`,stream:`#0e7490`,text:`#16a34a`,reasoning:`#64748b`,tool:`#d97706`,widget:`#db2777`,attachment:`#0d9488`,sandbox:`#0369a1`,questionnaire:`#9333ea`,status:`#475569`,error:`#dc2626`};function u(e){if(e)return(e,t,n)=>{console.log(`%cAstralBeam%c ${new Date().toISOString().slice(11,19)} %c${e}%c ${t}`,c,`color:#94a3b8;font-weight:400`,s(l[e]),``,...n===void 0?[]:[n])}}export{n as a,o as c,a as i,r as n,t as o,i as r,e as s,u as t};

package/dist/{index-CudekMKM.d.ts → index-BQBdZKyB.d.ts}

@@ -3352,7 +3352,7 @@ type AstralBeamChatThemeVariables = Record<`--${string}`, string>;
  * `credentials: "include"`, `cache: "no-store"`, and an `accept: application/json` header, each
  * overridable here, and the response is expected to carry `{ token }` as JSON.
  */
-interface AstralBeamChatAuthTokenRequest extends RequestInit {
+interface AstralBeamTokenRequest extends RequestInit {
   url: string;
 }
 /**
@@ -3363,7 +3363,7 @@ interface AstralBeamChatAuthTokenRequest extends RequestInit {
  * 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.
  */
-type AstralBeamChatAuthTokenSource = AstralBeamChatAuthTokenRequest | (() => {
+type AstralBeamTokenSource = AstralBeamTokenRequest | (() => {
   token: string;
 } | undefined | Promise<{
   token: string;
@@ -3402,7 +3402,7 @@ interface MountAstralBeamChatOptions {
   /** Subtitle shown under the empty transcript's headline. Default describes the app's tools and widgets. */
   emptyDescription?: string | undefined;
   /**
-   * Base URL of the AstralBeam API; the widget calls `/chat` and its subroutes under it. Read for
+   * Base URL of the AstralBeam API; the widget calls `/v1/chat` and its subroutes under it. Read for
    * every request, so a change moves the next one. Default `"https://app.astralbeam.ai/api"`, the
    * hosted cloud; self-hosted deployments must set their own origin.
    */
@@ -3413,7 +3413,7 @@ interface MountAstralBeamChatOptions {
    * 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.
    */
-  fetchChatAuthToken?: AstralBeamChatAuthTokenSource | undefined;
+  fetchAstralBeamToken?: AstralBeamTokenSource | undefined;
   /** Host-defined tools the agent can call, executed in the host page, keyed by tool name. */
   tools?: Record<string, ToolDefinition> | undefined;
   /** Host-defined widgets the agent can render inline in the conversation, keyed by identifier. */
@@ -3742,7 +3742,7 @@ interface ChatStreamCallbacks {
  * The transport and tool options of the drop-in widget, minus everything about its UI, plus this
  * session's own rendering hooks. The shared options are documented on `MountAstralBeamChatOptions`.
  */
-interface AstralBeamChatCoreOptions extends Pick<MountAstralBeamChatOptions, "agentId" | "apiUrl" | "fetchChatAuthToken" | "tools" | "debug"> {
+interface AstralBeamChatCoreOptions extends Pick<MountAstralBeamChatOptions, "agentId" | "apiUrl" | "fetchAstralBeamToken" | "tools" | "debug"> {
   /** Widgets declared to the agent, without a `render`; `onRenderWidget` is asked to draw them. */
   widgets?: Record<string, WidgetDeclaration> | undefined;
   /** Draws an agent-requested widget however the host wants; may return a cleanup. */

package/dist/react.d.ts

@@ -1,6 +1,6 @@
-import { C as AstralBeamChatState, S as AstralBeamChatCoreOptions, x as AstralBeamChatCore } from "./index-CudekMKM.js";
+import { C as AstralBeamChatState, S as AstralBeamChatCoreOptions, x as AstralBeamChatCore } from "./index-BQBdZKyB.js";
 import { ReactNode } from "react";
-import { AstralBeamChatAttachmentOptions, AstralBeamChatAuthTokenRequest, AstralBeamChatAuthTokenSource, AstralBeamChatColorScheme, AstralBeamChatTheme, InferParameters, JsonSchemaObject, MountAstralBeamChatOptions, ParametersSchema, ToolDefinition, WidgetDefinition as WidgetDefinition$1, defineTool } from "@astralbeam/sdk/client";
+import { AstralBeamChatAttachmentOptions, AstralBeamChatColorScheme, AstralBeamChatTheme, AstralBeamTokenRequest, AstralBeamTokenSource, InferParameters, JsonSchemaObject, MountAstralBeamChatOptions, ParametersSchema, ToolDefinition, WidgetDefinition as WidgetDefinition$1, defineTool } from "@astralbeam/sdk/client";
 
 //#region src/react/index.d.ts
 interface WidgetDefinition extends Omit<WidgetDefinition$1, "render"> {
@@ -55,4 +55,4 @@ interface AstralBeamChatProps extends Omit<MountAstralBeamChatOptions, "widgets"
 }
 declare const AstralBeamChat: import("react").ForwardRefExoticComponent<AstralBeamChatProps & import("react").RefAttributes<AstralBeamChatRef>>;
 //#endregion
-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 };
+export { AstralBeamChat, type AstralBeamChatAttachmentOptions, type AstralBeamChatColorScheme, type AstralBeamChatCore, type AstralBeamChatCoreOptions, AstralBeamChatProps, AstralBeamChatRef, type AstralBeamChatState, type AstralBeamChatTheme, type AstralBeamTokenRequest, type AstralBeamTokenSource, type InferParameters, type ParametersSchema, type ToolDefinition, TypedReactWidgetDefinition, UseAstralBeamChatResult, WidgetDefinition, defineTool, defineWidget, useAstralBeamChat };

package/dist/react.js

@@ -1,4 +1,5 @@
-import { C as DEFAULT_COLOR_SCHEME, n as CORE_OPTION_KEYS, r as createAstralBeamChat } from "./core-BF1G1dLe.js";
+import { n as CORE_OPTION_KEYS, r as createAstralBeamChat } from "./core-Dr2IDA6j.js";
+import { O as DEFAULT_COLOR_SCHEME } from "./api-CaNIR6Af.js";
 import { forwardRef, useEffect, useImperativeHandle, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { createPortal } from "react-dom";
 import { defineTool, mountAstralBeamChat } from "@astralbeam/sdk/client";
@@ -32,7 +33,7 @@ function useAstralBeamChat(options) {
 		core
 	};
 }
-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 AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, showHeader, header, empty, composerActions, emptyTitle, emptyDescription, apiUrl, fetchAstralBeamToken, 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());
@@ -99,7 +100,7 @@ const AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, show
 	const live = useMemo(() => ({
 		agentId,
 		apiUrl,
-		fetchChatAuthToken,
+		fetchAstralBeamToken,
 		title,
 		showHeader,
 		emptyTitle,
@@ -115,7 +116,7 @@ const AstralBeamChat = forwardRef(function AstralBeamChat({ agentId, title, show
 	}), [
 		agentId,
 		apiUrl,
-		fetchChatAuthToken,
+		fetchAstralBeamToken,
 		title,
 		showHeader,
 		emptyTitle,