@aikaara/chat-sdk 0.8.0 → 0.8.2

package/dist/headless.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./MountTenant-DHxy8WY9.cjs");class r extends i.EventEmitter{registration=null;pendingEdits=[];constructor(e){super(),this.setupListeners(e)}registerForm(e){this.registration=e;const t=this.pendingEdits.filter(s=>s.entity_type===e.entityType&&String(s.entity_id)===String(e.entityId));if(t.length>0){for(const s of t)e.onFieldUpdate(s.fields),this.emit("edit:applied",{entityType:s.entity_type,entityId:s.entity_id,fields:s.fields});this.pendingEdits=this.pendingEdits.filter(s=>!(s.entity_type===e.entityType&&String(s.entity_id)===String(e.entityId)))}}unregisterForm(e,t){this.registration?.entityType===e&&String(this.registration?.entityId)===String(t)&&(this.registration=null)}get currentForm(){return this.registration}pushFieldUpdates(e,t,s){this.registration&&this.registration.entityType===e&&String(this.registration.entityId)===String(t)?(this.registration.onFieldUpdate(s),this.emit("edit:applied",{entityType:e,entityId:t,fields:s})):(this.pendingEdits.push({action:"edit_entity",entity_type:e,entity_id:t,fields:s}),this.emit("edit:pending",{entityType:e,entityId:t,fields:s}))}async requestSave(){if(!this.registration)return{success:!1,error:"No form registered"};try{return await this.registration.onSave(),this.emit("save:success",{entityType:this.registration.entityType,entityId:this.registration.entityId}),{success:!0}}catch(e){const t=e instanceof Error?e.message:"Save failed";return this.emit("save:error",{entityType:this.registration.entityType,entityId:this.registration.entityId,error:t}),{success:!1,error:t}}}async requestTest(e){if(!this.registration?.onTest)return{success:!1,error:"Current form does not support testing"};try{return await this.registration.onTest(e),{success:!0}}catch(t){return{success:!1,error:t instanceof Error?t.message:"Test failed"}}}setupListeners(e){e.on("action:edit_entity",t=>{this.pushFieldUpdates(t.entity_type,t.entity_id,t.fields)}),e.on("action:save_entity",t=>{this.requestSave()}),e.on("action:test_tool",t=>{this.emit("test:triggered",{toolId:t.tool_id,parameters:t.parameters}),this.requestTest(t.parameters)})}}exports.ActionCableClient=i.ActionCableClient;exports.AikaaraChatClient=i.AikaaraChatClient;exports.ApiClient=i.ApiClient;exports.ChannelSubscription=i.ChannelSubscription;exports.ConnectionManager=i.ConnectionManager;exports.ConversationManager=i.ConversationManager;exports.EventEmitter=i.EventEmitter;exports.MessageStore=i.MessageStore;exports.SessionAuthAdapter=i.SessionAuthAdapter;exports.SsoExchangeAdapter=i.SsoExchangeAdapter;exports.TiledeskTransport=i.TiledeskTransport;exports.clearPersistedConversationId=i.clearPersistedConversationId;exports.collectSsoCredentials=i.collectSsoCredentials;exports.createFetchUploadAdapter=i.createFetchUploadAdapter;exports.createPresigned3StepUploadAdapter=i.createPresigned3StepUploadAdapter;exports.createTiledeskHistoryAdapter=i.createTiledeskHistoryAdapter;exports.extractTiledeskFileEnvelope=i.extractTiledeskFileEnvelope;exports.inferTiledeskRole=i.inferTiledeskRole;exports.isTiledeskSelfEcho=i.isTiledeskSelfEcho;exports.mountFromSlug=i.mountFromSlug;exports.mountTenantWidget=i.mount;exports.parseTiledeskTemplate=i.parseTiledeskTemplate;exports.FormBridge=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./MountTenant-DvmiAoZ_.cjs");class r extends i.EventEmitter{registration=null;pendingEdits=[];constructor(e){super(),this.setupListeners(e)}registerForm(e){this.registration=e;const t=this.pendingEdits.filter(s=>s.entity_type===e.entityType&&String(s.entity_id)===String(e.entityId));if(t.length>0){for(const s of t)e.onFieldUpdate(s.fields),this.emit("edit:applied",{entityType:s.entity_type,entityId:s.entity_id,fields:s.fields});this.pendingEdits=this.pendingEdits.filter(s=>!(s.entity_type===e.entityType&&String(s.entity_id)===String(e.entityId)))}}unregisterForm(e,t){this.registration?.entityType===e&&String(this.registration?.entityId)===String(t)&&(this.registration=null)}get currentForm(){return this.registration}pushFieldUpdates(e,t,s){this.registration&&this.registration.entityType===e&&String(this.registration.entityId)===String(t)?(this.registration.onFieldUpdate(s),this.emit("edit:applied",{entityType:e,entityId:t,fields:s})):(this.pendingEdits.push({action:"edit_entity",entity_type:e,entity_id:t,fields:s}),this.emit("edit:pending",{entityType:e,entityId:t,fields:s}))}async requestSave(){if(!this.registration)return{success:!1,error:"No form registered"};try{return await this.registration.onSave(),this.emit("save:success",{entityType:this.registration.entityType,entityId:this.registration.entityId}),{success:!0}}catch(e){const t=e instanceof Error?e.message:"Save failed";return this.emit("save:error",{entityType:this.registration.entityType,entityId:this.registration.entityId,error:t}),{success:!1,error:t}}}async requestTest(e){if(!this.registration?.onTest)return{success:!1,error:"Current form does not support testing"};try{return await this.registration.onTest(e),{success:!0}}catch(t){return{success:!1,error:t instanceof Error?t.message:"Test failed"}}}setupListeners(e){e.on("action:edit_entity",t=>{this.pushFieldUpdates(t.entity_type,t.entity_id,t.fields)}),e.on("action:save_entity",t=>{this.requestSave()}),e.on("action:test_tool",t=>{this.emit("test:triggered",{toolId:t.tool_id,parameters:t.parameters}),this.requestTest(t.parameters)})}}exports.ActionCableClient=i.ActionCableClient;exports.AikaaraChatClient=i.AikaaraChatClient;exports.ApiClient=i.ApiClient;exports.ChannelSubscription=i.ChannelSubscription;exports.ConnectionManager=i.ConnectionManager;exports.ConversationManager=i.ConversationManager;exports.EventEmitter=i.EventEmitter;exports.MessageStore=i.MessageStore;exports.SessionAuthAdapter=i.SessionAuthAdapter;exports.SsoExchangeAdapter=i.SsoExchangeAdapter;exports.TiledeskTransport=i.TiledeskTransport;exports.clearPersistedConversationId=i.clearPersistedConversationId;exports.collectSsoCredentials=i.collectSsoCredentials;exports.createFetchUploadAdapter=i.createFetchUploadAdapter;exports.createPresigned3StepUploadAdapter=i.createPresigned3StepUploadAdapter;exports.createTiledeskHistoryAdapter=i.createTiledeskHistoryAdapter;exports.extractTiledeskFileEnvelope=i.extractTiledeskFileEnvelope;exports.inferTiledeskRole=i.inferTiledeskRole;exports.isTiledeskSelfEcho=i.isTiledeskSelfEcho;exports.mountFromSlug=i.mountFromSlug;exports.mountTenantWidget=i.mount;exports.parseTiledeskTemplate=i.parseTiledeskTemplate;exports.FormBridge=r;

package/dist/headless.d.ts

@@ -222,7 +222,7 @@ export declare class ApiClient {
     private baseUrl;
     private apiKey?;
     private authToken?;
-    private userToken;
+    protected userToken: string;
     constructor(baseUrl: string, userToken: string, apiKey?: string, authToken?: string);
     createConversation(params: {
         systemPromptId?: number;
@@ -948,6 +948,61 @@ export declare interface Presigned3StepAdapterConfig {
     extraHeaders?: Record<string, string>;
 }
 
+/**
+ * One slot's component pointer. The `kind` discriminator picks which
+ * loader runs. Both kinds resolve to a `Promise<HTMLElement>` after load,
+ * which the runtime appends into the slot anchor.
+ */
+declare type RemoteComponent = {
+    kind: 'iife-element';
+    /** URL of an IIFE bundle that calls `customElements.define(tag, …)`. */
+    scriptUrl: string;
+    /** Custom-element tag the bundle registers. */
+    tag: string;
+    /** Optional method-call map: `{ setLayout: "stacked" }` becomes
+     *  `el.setLayout("stacked")` after mount. */
+    props?: Record<string, unknown>;
+} | {
+    kind: 'remote-dom';
+    /** URL of an IIFE bundle that, when executed, leaves a global at
+     *  `globalName` exposing `mount({ target, ctx, complete, props })`.
+     *  Authored via `@aikaara/chat-sdk/remote-author`. */
+    scriptUrl: string;
+    /** Optional global name; defaults to the slot id with non-alphanumeric
+     *  chars replaced by underscores (e.g. "screen:login" → "screen_login"). */
+    globalName?: string;
+    /** Sandbox kind. Today only `iframe`; `worker` reserved for later. */
+    sandbox?: 'iframe' | 'worker';
+    /** Forwarded to the bundle's `mount({ props })` call. */
+    props?: Record<string, unknown>;
+};
+
+/**
+ * One route in `descriptor.app.routes`.
+ *
+ * `path` is matched against the URL pathname AFTER the tenant's slug
+ * prefix is stripped (in subpath mode). Supports trailing wildcards (`/*`)
+ * and named params (`/:id`) — the parser is intentionally tiny.
+ *
+ * `component` references a slot in `descriptor.components`.
+ *
+ * `guards` are simple predicate names the shell evaluates against runtime
+ * session state. Today: `'sso'` (SSO exchange done), `'authed'` (user
+ * has any session), `'panVerified'` (PAN flow finished). Tenants can
+ * extend by exposing flags via `complete(payload)` from preceding screens.
+ *
+ * `redirectIfFails` lets a guard send the user to another route id
+ * instead of erroring. Useful for `'authed'` failing → redirect to login.
+ */
+declare interface RouteDef {
+    path: string;
+    component: string;
+    guards?: string[];
+    redirectIfFails?: string;
+    /** Optional layout slot wrapping this route's component. */
+    layout?: string;
+}
+
 export declare interface SaveEntityAction {
     action: 'save_entity';
 }
@@ -1685,6 +1740,7 @@ export declare interface WidgetConfig extends ChatClientConfig {
         attachPosition?: 'left' | 'right';
         sendButtonShape?: 'circle' | 'square';
     };
+    templateLayout?: 'inside' | 'outside';
     showBubble?: boolean;
     bubbleText?: string;
     bubbleIcon?: string;
@@ -1745,6 +1801,17 @@ export declare interface WidgetConfigDescriptor {
         /** Round (default) or filled square send button. */
         sendButtonShape?: 'circle' | 'square';
     };
+    /**
+     * Where contentType=300 templates render relative to the bubble carrying
+     * the message text.
+     *   - `inside` (default): template UI nested inside the bot bubble — the
+     *     option chips share the bubble's background colour. Matches the
+     *     pre-bandhan look.
+     *   - `outside`: template UI is a sibling below the bubble (UAT bandhan
+     *     style). Lets option chips inherit the chat surface background and
+     *     wrap freely, no max-width clamp.
+     */
+    templateLayout?: 'inside' | 'outside';
     /**
      * Full theme token set. Mirrored as CSS variables (`--aikaara-*`) on the
      * widget root so any inner web-component can style itself by referencing
@@ -1880,6 +1947,43 @@ export declare interface WidgetConfigDescriptor {
         scriptUrl?: string;
         props?: Record<string, unknown>;
     }>;
+    /**
+     * Multi-screen app definition. When present, the hosted-shell renders a
+     * History-API router rooted at the tenant's mount path. Each route
+     * names a slot key that resolves to a `components[slot]` entry.
+     *
+     * When absent, behaviour is the today's single-screen mount (chat
+     * widget at root). No breaking change for existing tenants.
+     */
+    app?: {
+        /** Route id rendered when path matches `/` (or `/<slug>/` in subpath). */
+        defaultRoute: string;
+        /** Map of route id → definition. */
+        routes: Record<string, RouteDef>;
+    };
+    /**
+     * Unified slot map. Supersedes `templates` and the bespoke
+     * `linkHandlers[].render` mechanism. Each key is a slot id that some
+     * piece of the runtime knows to look up:
+     *
+     *   "template:<contentTypeOrTemplateId>"  — Tiledesk contentType=300 templates
+     *   "screen:login" | "screen:prechat" | "screen:chat" | …  — full screens
+     *   "panel:header" | "panel:left-rail" | …                — chat-shell side panels
+     *   "viewer:file" | "viewer:compare-plans" | …            — link-modal renderers
+     *
+     * Two component kinds today:
+     *   - `iife-element`  : tenant ships an IIFE that calls customElements.define;
+     *                       SDK loads the script + creates `<tag>` and dispatches.
+     *   - `remote-dom`    : tenant ships a remote-dom bundle (React/Preact/Svelte
+     *                       JSX); SDK lazy-loads `@aikaara/chat-sdk/remote-host`,
+     *                       creates a hidden iframe with DOMRemoteReceiver, and
+     *                       mirrors the tenant's tree into the host slot.
+     *
+     * Backwards compat: at mount time, every entry in `templates` is mirrored
+     * into `components['template:'+id]` as kind:'iife-element' if a matching
+     * key isn't already present. Tenants on the old shape see no change.
+     */
+    components?: Record<string, RemoteComponent>;
 }
 
 /**

package/dist/headless.mjs

@@ -1,5 +1,5 @@
-import { E as s } from "./MountTenant-CdaBBA2O.mjs";
-import { A as p, b as l, k as g, C as h, l as c, m as y, M as u, S as m, n as f, T as S, o as T, p as _, q as E, s as v, t as C, u as F, v as A, w as k, x as I, y as x, z as U } from "./MountTenant-CdaBBA2O.mjs";
+import { E as s } from "./MountTenant-DzNgBTiU.mjs";
+import { A as p, b as l, k as g, C as h, l as c, m as y, M as u, S as m, n as f, T as S, o as T, p as _, q as E, s as v, t as C, u as F, v as A, w as k, x as I, y as x, z as U } from "./MountTenant-DzNgBTiU.mjs";
 class a extends s {
   registration = null;
   pendingEdits = [];

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./MountTenant-DHxy8WY9.cjs"),s=require("./headless.cjs");function l(a){e.registerComponents();const t=document.createElement("aikaara-chat-widget"),i={baseUrl:"base-url",userToken:"user-token",apiKey:"api-key",title:"title",subtitle:"subtitle",theme:"theme",primaryColor:"primary-color",position:"position",width:"width",height:"height",placeholder:"placeholder",welcomeMessage:"welcome-message",avatarUrl:"avatar-url"};for(const[n,o]of Object.entries(i)){const r=a[n];r!=null&&t.setAttribute(o,String(r))}return t.configure(a),document.body.appendChild(t),t}function d(){const a=document.querySelector("aikaara-chat-widget");a&&a.remove()}exports.ActionCableClient=e.ActionCableClient;exports.AikaaraChatBubble=e.AikaaraChatBubble;exports.AikaaraChatClient=e.AikaaraChatClient;exports.AikaaraChatHeader=e.AikaaraChatHeader;exports.AikaaraChatInput=e.AikaaraChatInput;exports.AikaaraChatWidget=e.AikaaraChatWidget;exports.AikaaraErrorBanner=e.AikaaraErrorBanner;exports.AikaaraMessageBubble=e.AikaaraMessageBubble;exports.AikaaraMessageList=e.AikaaraMessageList;exports.AikaaraStreamingMessage=e.AikaaraStreamingMessage;exports.AikaaraTypingIndicator=e.AikaaraTypingIndicator;exports.ApiClient=e.ApiClient;exports.ChannelSubscription=e.ChannelSubscription;exports.ConnectionManager=e.ConnectionManager;exports.ConversationManager=e.ConversationManager;exports.EventEmitter=e.EventEmitter;exports.MessageStore=e.MessageStore;exports.SessionAuthAdapter=e.SessionAuthAdapter;exports.SsoExchangeAdapter=e.SsoExchangeAdapter;exports.TiledeskTransport=e.TiledeskTransport;exports.clearPersistedConversationId=e.clearPersistedConversationId;exports.collectSsoCredentials=e.collectSsoCredentials;exports.createFetchUploadAdapter=e.createFetchUploadAdapter;exports.createPresigned3StepUploadAdapter=e.createPresigned3StepUploadAdapter;exports.createTiledeskHistoryAdapter=e.createTiledeskHistoryAdapter;exports.extractTiledeskFileEnvelope=e.extractTiledeskFileEnvelope;exports.inferTiledeskRole=e.inferTiledeskRole;exports.isTiledeskSelfEcho=e.isTiledeskSelfEcho;exports.mountFromSlug=e.mountFromSlug;exports.mountTenantWidget=e.mount;exports.parseTiledeskTemplate=e.parseTiledeskTemplate;exports.registerComponents=e.registerComponents;exports.FormBridge=s.FormBridge;exports.mount=l;exports.unmount=d;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./MountTenant-DvmiAoZ_.cjs"),s=require("./headless.cjs");function l(a){e.registerComponents();const t=document.createElement("aikaara-chat-widget"),i={baseUrl:"base-url",userToken:"user-token",apiKey:"api-key",title:"title",subtitle:"subtitle",theme:"theme",primaryColor:"primary-color",position:"position",width:"width",height:"height",placeholder:"placeholder",welcomeMessage:"welcome-message",avatarUrl:"avatar-url"};for(const[n,o]of Object.entries(i)){const r=a[n];r!=null&&t.setAttribute(o,String(r))}return t.configure(a),document.body.appendChild(t),t}function d(){const a=document.querySelector("aikaara-chat-widget");a&&a.remove()}exports.ActionCableClient=e.ActionCableClient;exports.AikaaraChatBubble=e.AikaaraChatBubble;exports.AikaaraChatClient=e.AikaaraChatClient;exports.AikaaraChatHeader=e.AikaaraChatHeader;exports.AikaaraChatInput=e.AikaaraChatInput;exports.AikaaraChatWidget=e.AikaaraChatWidget;exports.AikaaraErrorBanner=e.AikaaraErrorBanner;exports.AikaaraMessageBubble=e.AikaaraMessageBubble;exports.AikaaraMessageList=e.AikaaraMessageList;exports.AikaaraStreamingMessage=e.AikaaraStreamingMessage;exports.AikaaraTypingIndicator=e.AikaaraTypingIndicator;exports.ApiClient=e.ApiClient;exports.ChannelSubscription=e.ChannelSubscription;exports.ConnectionManager=e.ConnectionManager;exports.ConversationManager=e.ConversationManager;exports.EventEmitter=e.EventEmitter;exports.MessageStore=e.MessageStore;exports.SessionAuthAdapter=e.SessionAuthAdapter;exports.SsoExchangeAdapter=e.SsoExchangeAdapter;exports.TiledeskTransport=e.TiledeskTransport;exports.clearPersistedConversationId=e.clearPersistedConversationId;exports.collectSsoCredentials=e.collectSsoCredentials;exports.createFetchUploadAdapter=e.createFetchUploadAdapter;exports.createPresigned3StepUploadAdapter=e.createPresigned3StepUploadAdapter;exports.createTiledeskHistoryAdapter=e.createTiledeskHistoryAdapter;exports.extractTiledeskFileEnvelope=e.extractTiledeskFileEnvelope;exports.inferTiledeskRole=e.inferTiledeskRole;exports.isTiledeskSelfEcho=e.isTiledeskSelfEcho;exports.mountFromSlug=e.mountFromSlug;exports.mountTenantWidget=e.mount;exports.parseTiledeskTemplate=e.parseTiledeskTemplate;exports.registerComponents=e.registerComponents;exports.FormBridge=s.FormBridge;exports.mount=l;exports.unmount=d;

package/dist/index.d.ts

@@ -234,6 +234,8 @@ export declare class AikaaraMessageList extends HTMLElement {
     private getLinkBearer;
     setHideSystemMessages(items: string[]): void;
     setTimestampFormat(fmt: 'time' | 'datetime' | 'date' | 'none'): void;
+    private templateLayout;
+    setTemplateLayout(layout: 'inside' | 'outside'): void;
     /** Returns true when a message should be hidden by the descriptor's
      *  `hideSystemMessages` filter. Matches the trimmed content
      *  case-insensitively against any configured needle (substring match). */
@@ -290,7 +292,7 @@ export declare class ApiClient {
     private baseUrl;
     private apiKey?;
     private authToken?;
-    private userToken;
+    protected userToken: string;
     constructor(baseUrl: string, userToken: string, apiKey?: string, authToken?: string);
     createConversation(params: {
         systemPromptId?: number;
@@ -851,6 +853,61 @@ export declare interface Presigned3StepAdapterConfig {
 
 export declare function registerComponents(): void;
 
+/**
+ * One slot's component pointer. The `kind` discriminator picks which
+ * loader runs. Both kinds resolve to a `Promise<HTMLElement>` after load,
+ * which the runtime appends into the slot anchor.
+ */
+declare type RemoteComponent = {
+    kind: 'iife-element';
+    /** URL of an IIFE bundle that calls `customElements.define(tag, …)`. */
+    scriptUrl: string;
+    /** Custom-element tag the bundle registers. */
+    tag: string;
+    /** Optional method-call map: `{ setLayout: "stacked" }` becomes
+     *  `el.setLayout("stacked")` after mount. */
+    props?: Record<string, unknown>;
+} | {
+    kind: 'remote-dom';
+    /** URL of an IIFE bundle that, when executed, leaves a global at
+     *  `globalName` exposing `mount({ target, ctx, complete, props })`.
+     *  Authored via `@aikaara/chat-sdk/remote-author`. */
+    scriptUrl: string;
+    /** Optional global name; defaults to the slot id with non-alphanumeric
+     *  chars replaced by underscores (e.g. "screen:login" → "screen_login"). */
+    globalName?: string;
+    /** Sandbox kind. Today only `iframe`; `worker` reserved for later. */
+    sandbox?: 'iframe' | 'worker';
+    /** Forwarded to the bundle's `mount({ props })` call. */
+    props?: Record<string, unknown>;
+};
+
+/**
+ * One route in `descriptor.app.routes`.
+ *
+ * `path` is matched against the URL pathname AFTER the tenant's slug
+ * prefix is stripped (in subpath mode). Supports trailing wildcards (`/*`)
+ * and named params (`/:id`) — the parser is intentionally tiny.
+ *
+ * `component` references a slot in `descriptor.components`.
+ *
+ * `guards` are simple predicate names the shell evaluates against runtime
+ * session state. Today: `'sso'` (SSO exchange done), `'authed'` (user
+ * has any session), `'panVerified'` (PAN flow finished). Tenants can
+ * extend by exposing flags via `complete(payload)` from preceding screens.
+ *
+ * `redirectIfFails` lets a guard send the user to another route id
+ * instead of erroring. Useful for `'authed'` failing → redirect to login.
+ */
+declare interface RouteDef {
+    path: string;
+    component: string;
+    guards?: string[];
+    redirectIfFails?: string;
+    /** Optional layout slot wrapping this route's component. */
+    layout?: string;
+}
+
 export declare interface SaveEntityAction {
     action: 'save_entity';
 }
@@ -1445,6 +1502,7 @@ export declare interface WidgetConfig extends ChatClientConfig {
         attachPosition?: 'left' | 'right';
         sendButtonShape?: 'circle' | 'square';
     };
+    templateLayout?: 'inside' | 'outside';
     showBubble?: boolean;
     bubbleText?: string;
     bubbleIcon?: string;
@@ -1505,6 +1563,17 @@ export declare interface WidgetConfigDescriptor {
         /** Round (default) or filled square send button. */
         sendButtonShape?: 'circle' | 'square';
     };
+    /**
+     * Where contentType=300 templates render relative to the bubble carrying
+     * the message text.
+     *   - `inside` (default): template UI nested inside the bot bubble — the
+     *     option chips share the bubble's background colour. Matches the
+     *     pre-bandhan look.
+     *   - `outside`: template UI is a sibling below the bubble (UAT bandhan
+     *     style). Lets option chips inherit the chat surface background and
+     *     wrap freely, no max-width clamp.
+     */
+    templateLayout?: 'inside' | 'outside';
     /**
      * Full theme token set. Mirrored as CSS variables (`--aikaara-*`) on the
      * widget root so any inner web-component can style itself by referencing
@@ -1640,6 +1709,43 @@ export declare interface WidgetConfigDescriptor {
         scriptUrl?: string;
         props?: Record<string, unknown>;
     }>;
+    /**
+     * Multi-screen app definition. When present, the hosted-shell renders a
+     * History-API router rooted at the tenant's mount path. Each route
+     * names a slot key that resolves to a `components[slot]` entry.
+     *
+     * When absent, behaviour is the today's single-screen mount (chat
+     * widget at root). No breaking change for existing tenants.
+     */
+    app?: {
+        /** Route id rendered when path matches `/` (or `/<slug>/` in subpath). */
+        defaultRoute: string;
+        /** Map of route id → definition. */
+        routes: Record<string, RouteDef>;
+    };
+    /**
+     * Unified slot map. Supersedes `templates` and the bespoke
+     * `linkHandlers[].render` mechanism. Each key is a slot id that some
+     * piece of the runtime knows to look up:
+     *
+     *   "template:<contentTypeOrTemplateId>"  — Tiledesk contentType=300 templates
+     *   "screen:login" | "screen:prechat" | "screen:chat" | …  — full screens
+     *   "panel:header" | "panel:left-rail" | …                — chat-shell side panels
+     *   "viewer:file" | "viewer:compare-plans" | …            — link-modal renderers
+     *
+     * Two component kinds today:
+     *   - `iife-element`  : tenant ships an IIFE that calls customElements.define;
+     *                       SDK loads the script + creates `<tag>` and dispatches.
+     *   - `remote-dom`    : tenant ships a remote-dom bundle (React/Preact/Svelte
+     *                       JSX); SDK lazy-loads `@aikaara/chat-sdk/remote-host`,
+     *                       creates a hidden iframe with DOMRemoteReceiver, and
+     *                       mirrors the tenant's tree into the host slot.
+     *
+     * Backwards compat: at mount time, every entry in `templates` is mirrored
+     * into `components['template:'+id]` as kind:'iife-element' if a matching
+     * key isn't already present. Tenants on the old shape see no change.
+     */
+    components?: Record<string, RemoteComponent>;
 }
 
 /**

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { r as o } from "./MountTenant-CdaBBA2O.mjs";
-import { A as u, a as m, b as g, c as h, d as k, e as A, f as C, g as b, h as f, i as S, j as T, k as v, C as y, l as w, m as M, E, M as x, S as B, n as F, T as U, o as I, p as j, q, s as H, t as P, u as W, v as z, w as K, x as L, y as O, z as R } from "./MountTenant-CdaBBA2O.mjs";
+import { r as o } from "./MountTenant-DzNgBTiU.mjs";
+import { A as u, a as m, b as g, c as h, d as k, e as A, f as C, g as b, h as f, i as S, j as T, k as v, C as y, l as w, m as M, E, M as x, S as B, n as F, T as U, o as I, p as j, q, s as H, t as P, u as W, v as z, w as K, x as L, y as O, z as R } from "./MountTenant-DzNgBTiU.mjs";
 import { FormBridge as G } from "./headless.mjs";
 function l(e) {
   o();

package/dist/remote-author.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=1;function p(s){let n=!1,t=null;const c=o=>{window.parent?.postMessage({aikaara:r,type:"complete",payload:o},"*")},i=o=>{window.parent?.postMessage({aikaara:r,type:"error",message:o},"*")};window.addEventListener("message",o=>{const e=o.data;!e||e.aikaara!==r||(e.type==="bootstrap"&&!n?(n=!0,t={target:document.body,ctx:e.ctx,props:e.props??{},complete:c,fail:i},Promise.resolve(s(t)).catch(a=>i(a?.message??String(a)))):e.type==="update"&&t&&(t={...t,props:{...t.props,...e.props}},Promise.resolve(s(t)).catch(a=>i(a?.message??String(a)))))}),window.parent?.postMessage({aikaara:r,type:"ready"},"*")}function d(s){p(s)}exports.initRemoteAuthor=p;exports.mount=d;

package/dist/remote-author.d.ts

@@ -0,0 +1,62 @@
+export declare interface AuthorMountArgs {
+    /** DOM node to render into — the iframe's `document.body`. */
+    target: HTMLElement;
+    /** Snapshot of host state at bootstrap time. */
+    ctx: RemoteAuthorContext | undefined;
+    /** Tenant-supplied props from `descriptor.components[slot].props`. */
+    props: Record<string, unknown>;
+    /** Signal flow completion. Host receives via its `onComplete` callback. */
+    complete: (payload: unknown) => void;
+    /** Surface a tenant error to the host. */
+    fail: (message: string) => void;
+}
+
+/**
+ * Wire up the host protocol and call `render` once bootstrap arrives.
+ * Subsequent host `update` messages re-invoke `render` so the bundle can
+ * re-render with new props (or just accept the changes if React-managed).
+ */
+export declare function initRemoteAuthor(render: Renderer): void;
+
+/** Convenience wrapper for the common "render once, ignore updates" case. */
+export declare function mount(render: Renderer): void;
+
+/**
+ * `@aikaara/chat-sdk/remote-author` — tiny tenant-side helper.
+ *
+ * Pull this into a tenant component bundle. The bundle, when loaded by the
+ * shell's RemoteComponentLoader (kind: 'remote-dom'), runs inside a
+ * sandboxed iframe. It needs to:
+ *
+ *   1. Tell the host it's ready.
+ *   2. Receive a `bootstrap` message carrying `ctx` + `props`.
+ *   3. Render whatever it wants into `document.body`.
+ *   4. Optionally call `complete(payload)` to signal the flow finished.
+ *
+ * This module wraps that protocol so tenants don't have to write
+ * postMessage boilerplate. They write a `mount(target, ctx, complete, props)`
+ * function (or just call `init(...)` with a render callback).
+ *
+ * Framework-agnostic: works with React, Preact, Svelte, Vue, vanilla JS.
+ *
+ * @example  React
+ *   import { initRemoteAuthor } from '@aikaara/chat-sdk/remote-author';
+ *   import { createRoot } from 'react-dom/client';
+ *   import LoginScreen from './LoginScreen';
+ *
+ *   initRemoteAuthor(({ target, ctx, complete, props }) => {
+ *     createRoot(target).render(
+ *       <LoginScreen ctx={ctx} complete={complete} {...props} />
+ *     );
+ *   });
+ */
+export declare interface RemoteAuthorContext {
+    slug: string;
+    theme?: Record<string, unknown>;
+    identity?: Record<string, unknown>;
+    extras?: Record<string, unknown>;
+}
+
+declare type Renderer = (args: AuthorMountArgs) => void | Promise<void>;
+
+export { }

package/dist/remote-author.mjs

@@ -0,0 +1,31 @@
+function n(s) {
+  let r = !1, t = null;
+  const i = (a) => {
+    window.parent?.postMessage(
+      { aikaara: 1, type: "complete", payload: a },
+      "*"
+    );
+  }, p = (a) => {
+    window.parent?.postMessage(
+      { aikaara: 1, type: "error", message: a },
+      "*"
+    );
+  };
+  window.addEventListener("message", (a) => {
+    const e = a.data;
+    !e || e.aikaara !== 1 || (e.type === "bootstrap" && !r ? (r = !0, t = {
+      target: document.body,
+      ctx: e.ctx,
+      props: e.props ?? {},
+      complete: i,
+      fail: p
+    }, Promise.resolve(s(t)).catch((o) => p(o?.message ?? String(o)))) : e.type === "update" && t && (t = { ...t, props: { ...t.props, ...e.props } }, Promise.resolve(s(t)).catch((o) => p(o?.message ?? String(o)))));
+  }), window.parent?.postMessage({ aikaara: 1, type: "ready" }, "*");
+}
+function O(s) {
+  n(s);
+}
+export {
+  n as initRemoteAuthor,
+  O as mount
+};

package/dist/remote-host.cjs

@@ -0,0 +1,3 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=new Map;async function d(e,r){switch(e.kind){case"iife-element":return p(e,r);case"remote-dom":return w(e,r);default:{const t=e;throw new Error(`loadRemoteComponent: unknown kind ${JSON.stringify(t)}`)}}}async function p(e,r){customElements.get(e.tag)||(await f(e.scriptUrl),await h(e.tag));const t=document.createElement(e.tag);return c(t,e.props),c(t,r.props),r.ctx&&c(t,{setCtx:r.ctx}),r.onComplete&&t.addEventListener("complete",n=>r.onComplete?.(n.detail)),r.onError&&t.addEventListener("error",n=>r.onError?.(n.error??new Error("component error"))),r.target.appendChild(t),{el:t,unmount(){t.remove()},update(n){c(t,n)}}}function c(e,r){if(r)for(const[t,n]of Object.entries(r)){const s=e[t];if(typeof s=="function")try{s.call(e,n)}catch(o){console.warn(`[RemoteComponentLoader] ${t}() threw`,o)}}}function f(e){const r=u.get(e);if(r)return r;const t=new Promise((n,s)=>{const o=document.createElement("script");o.src=e,o.async=!0,o.onload=()=>n(),o.onerror=()=>s(new Error(`Failed to load script ${e}`)),document.head.appendChild(o)});return u.set(e,t),t}function h(e,r=5e3){return customElements.get(e)?Promise.resolve():Promise.race([customElements.whenDefined(e).then(()=>{}),new Promise((t,n)=>{setTimeout(()=>n(new Error(`Custom element <${e}> never registered`)),r)})])}const l=1;function w(e,r){const t=document.createElement("iframe");t.setAttribute("sandbox","allow-scripts allow-same-origin allow-forms allow-popups"),t.style.cssText="width:100%;height:100%;border:0;display:block;background:transparent;",t.setAttribute("title",`aikaara-remote:${e.globalName??e.scriptUrl}`);const n=[],s=a=>t.contentWindow?.postMessage(a,"*");let o=!1;const m=a=>{if(a.source!==t.contentWindow)return;const i=a.data;!i||i.aikaara!==l||(i.type==="ready"?s({aikaara:l,type:"bootstrap",ctx:r.ctx,props:{...e.props??{},...r.props??{}}}):i.type==="complete"?r.onComplete?.(i.payload):i.type==="error"&&r.onError?.(new Error(i.message)))};return window.addEventListener("message",m),n.push(()=>window.removeEventListener("message",m)),t.srcdoc=`<!doctype html><html><head><meta charset="utf-8">
+    <style>html,body{margin:0;padding:0;height:100%;background:transparent;}</style>
+  </head><body><script src="${g(e.scriptUrl)}" defer><\/script></body></html>`,r.target.appendChild(t),{el:t,unmount(){if(!o){o=!0;for(const a of n)try{a()}catch{}t.remove()}},update(a){s({aikaara:l,type:"update",props:a})}}}function g(e){return e.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;")}exports.loadRemoteComponent=d;

package/dist/remote-host.d.ts

@@ -0,0 +1,68 @@
+export declare interface LoadOptions {
+    /** Where the rendered element should be inserted. */
+    target: HTMLElement;
+    /** Forwarded to the tenant component. */
+    props?: Record<string, unknown>;
+    /** Forwarded as the `ctx` payload (read-only state from host). */
+    ctx?: RemoteHostContext;
+    /** Tenant components call this to signal a flow step finished
+     *  (e.g. screen:login → onComplete({ext_uid, token})). */
+    onComplete?: (payload: unknown) => void;
+    /** Tenant component error → host can show a banner / fall back. */
+    onError?: (err: Error) => void;
+}
+
+/** Load + mount one slot's component. Returns a handle for tear-down. */
+export declare function loadRemoteComponent(def: RemoteComponent, opts: LoadOptions): Promise<MountedComponent>;
+
+export declare interface MountedComponent {
+    /** The DOM node added to `target` (custom element or iframe). */
+    el: HTMLElement;
+    /** Tear down + remove from DOM. Idempotent. */
+    unmount(): void;
+    /** Push a new `props` payload to the mounted component. */
+    update(props: Record<string, unknown>): void;
+}
+
+/**
+ * One slot's component pointer. The `kind` discriminator picks which
+ * loader runs. Both kinds resolve to a `Promise<HTMLElement>` after load,
+ * which the runtime appends into the slot anchor.
+ */
+export declare type RemoteComponent = {
+    kind: 'iife-element';
+    /** URL of an IIFE bundle that calls `customElements.define(tag, …)`. */
+    scriptUrl: string;
+    /** Custom-element tag the bundle registers. */
+    tag: string;
+    /** Optional method-call map: `{ setLayout: "stacked" }` becomes
+     *  `el.setLayout("stacked")` after mount. */
+    props?: Record<string, unknown>;
+} | {
+    kind: 'remote-dom';
+    /** URL of an IIFE bundle that, when executed, leaves a global at
+     *  `globalName` exposing `mount({ target, ctx, complete, props })`.
+     *  Authored via `@aikaara/chat-sdk/remote-author`. */
+    scriptUrl: string;
+    /** Optional global name; defaults to the slot id with non-alphanumeric
+     *  chars replaced by underscores (e.g. "screen:login" → "screen_login"). */
+    globalName?: string;
+    /** Sandbox kind. Today only `iframe`; `worker` reserved for later. */
+    sandbox?: 'iframe' | 'worker';
+    /** Forwarded to the bundle's `mount({ props })` call. */
+    props?: Record<string, unknown>;
+};
+
+export declare interface RemoteHostContext {
+    /** Project slug currently mounted. */
+    slug: string;
+    /** Theme tokens from descriptor.theme — passed for tenant components
+     *  to render in-brand without re-fetching the descriptor. */
+    theme?: Record<string, unknown>;
+    /** Identity bag (already-resolved user info). */
+    identity?: Record<string, unknown>;
+    /** Free-form: descriptor block(s) the tenant component might need. */
+    extras?: Record<string, unknown>;
+}
+
+export { }

package/dist/remote-host.mjs

@@ -0,0 +1,104 @@
+const u = /* @__PURE__ */ new Map();
+async function g(e, r) {
+  switch (e.kind) {
+    case "iife-element":
+      return p(e, r);
+    case "remote-dom":
+      return h(e, r);
+    default: {
+      const t = e;
+      throw new Error(`loadRemoteComponent: unknown kind ${JSON.stringify(t)}`);
+    }
+  }
+}
+async function p(e, r) {
+  customElements.get(e.tag) || (await d(e.scriptUrl), await f(e.tag));
+  const t = document.createElement(e.tag);
+  return i(t, e.props), i(t, r.props), r.ctx && i(t, { setCtx: r.ctx }), r.onComplete && t.addEventListener("complete", (n) => r.onComplete?.(n.detail)), r.onError && t.addEventListener("error", (n) => r.onError?.(n.error ?? new Error("component error"))), r.target.appendChild(t), {
+    el: t,
+    unmount() {
+      t.remove();
+    },
+    update(n) {
+      i(t, n);
+    }
+  };
+}
+function i(e, r) {
+  if (r)
+    for (const [t, n] of Object.entries(r)) {
+      const s = e[t];
+      if (typeof s == "function")
+        try {
+          s.call(e, n);
+        } catch (o) {
+          console.warn(`[RemoteComponentLoader] ${t}() threw`, o);
+        }
+    }
+}
+function d(e) {
+  const r = u.get(e);
+  if (r) return r;
+  const t = new Promise((n, s) => {
+    const o = document.createElement("script");
+    o.src = e, o.async = !0, o.onload = () => n(), o.onerror = () => s(new Error(`Failed to load script ${e}`)), document.head.appendChild(o);
+  });
+  return u.set(e, t), t;
+}
+function f(e, r = 5e3) {
+  return customElements.get(e) ? Promise.resolve() : Promise.race([
+    customElements.whenDefined(e).then(() => {
+    }),
+    new Promise((t, n) => {
+      setTimeout(() => n(new Error(`Custom element <${e}> never registered`)), r);
+    })
+  ]);
+}
+const l = 1;
+function h(e, r) {
+  const t = document.createElement("iframe");
+  t.setAttribute(
+    "sandbox",
+    // Restrictive set: scripts (run the bundle), same-origin (so the
+    // bundle can use localStorage/cookies on its own srcdoc origin),
+    // forms (login submits), popups (when tenant code opens external
+    // links). NOT allow-top-navigation — the bundle can't break out.
+    "allow-scripts allow-same-origin allow-forms allow-popups"
+  ), t.style.cssText = "width:100%;height:100%;border:0;display:block;background:transparent;", t.setAttribute("title", `aikaara-remote:${e.globalName ?? e.scriptUrl}`);
+  const n = [], s = (a) => t.contentWindow?.postMessage(a, "*");
+  let o = !1;
+  const m = (a) => {
+    if (a.source !== t.contentWindow) return;
+    const c = a.data;
+    !c || c.aikaara !== l || (c.type === "ready" ? s({
+      aikaara: l,
+      type: "bootstrap",
+      ctx: r.ctx,
+      props: { ...e.props ?? {}, ...r.props ?? {} }
+    }) : c.type === "complete" ? r.onComplete?.(c.payload) : c.type === "error" && r.onError?.(new Error(c.message)));
+  };
+  return window.addEventListener("message", m), n.push(() => window.removeEventListener("message", m)), t.srcdoc = `<!doctype html><html><head><meta charset="utf-8">
+    <style>html,body{margin:0;padding:0;height:100%;background:transparent;}</style>
+  </head><body><script src="${w(e.scriptUrl)}" defer><\/script></body></html>`, r.target.appendChild(t), {
+    el: t,
+    unmount() {
+      if (!o) {
+        o = !0;
+        for (const a of n) try {
+          a();
+        } catch {
+        }
+        t.remove();
+      }
+    },
+    update(a) {
+      s({ aikaara: l, type: "update", props: a });
+    }
+  };
+}
+function w(e) {
+  return e.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}
+export {
+  g as loadRemoteComponent
+};

package/dist/ui.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./MountTenant-DHxy8WY9.cjs");exports.AikaaraChat=a.AikaaraChat;exports.AikaaraChatBubble=a.AikaaraChatBubble;exports.AikaaraChatHeader=a.AikaaraChatHeader;exports.AikaaraChatInput=a.AikaaraChatInput;exports.AikaaraChatWidget=a.AikaaraChatWidget;exports.AikaaraComparePlans=a.AikaaraComparePlans;exports.AikaaraErrorBanner=a.AikaaraErrorBanner;exports.AikaaraLinkModal=a.AikaaraLinkModal;exports.AikaaraMessageBubble=a.AikaaraMessageBubble;exports.AikaaraMessageList=a.AikaaraMessageList;exports.AikaaraModalAction=a.AikaaraModalAction;exports.AikaaraOptionList=a.AikaaraOptionList;exports.AikaaraStreamingMessage=a.AikaaraStreamingMessage;exports.AikaaraSubmitAction=a.AikaaraSubmitAction;exports.AikaaraSystemPill=a.AikaaraSystemPill;exports.AikaaraTemplateRenderer=a.AikaaraTemplateRenderer;exports.AikaaraTypingIndicator=a.AikaaraTypingIndicator;exports.registerComponents=a.registerComponents;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("./MountTenant-DvmiAoZ_.cjs");exports.AikaaraChat=a.AikaaraChat;exports.AikaaraChatBubble=a.AikaaraChatBubble;exports.AikaaraChatHeader=a.AikaaraChatHeader;exports.AikaaraChatInput=a.AikaaraChatInput;exports.AikaaraChatWidget=a.AikaaraChatWidget;exports.AikaaraComparePlans=a.AikaaraComparePlans;exports.AikaaraErrorBanner=a.AikaaraErrorBanner;exports.AikaaraLinkModal=a.AikaaraLinkModal;exports.AikaaraMessageBubble=a.AikaaraMessageBubble;exports.AikaaraMessageList=a.AikaaraMessageList;exports.AikaaraModalAction=a.AikaaraModalAction;exports.AikaaraOptionList=a.AikaaraOptionList;exports.AikaaraStreamingMessage=a.AikaaraStreamingMessage;exports.AikaaraSubmitAction=a.AikaaraSubmitAction;exports.AikaaraSystemPill=a.AikaaraSystemPill;exports.AikaaraTemplateRenderer=a.AikaaraTemplateRenderer;exports.AikaaraTypingIndicator=a.AikaaraTypingIndicator;exports.registerComponents=a.registerComponents;

package/dist/ui.d.ts

@@ -292,6 +292,8 @@ export declare class AikaaraMessageList extends HTMLElement {
     private getLinkBearer;
     setHideSystemMessages(items: string[]): void;
     setTimestampFormat(fmt: 'time' | 'datetime' | 'date' | 'none'): void;
+    private templateLayout;
+    setTemplateLayout(layout: 'inside' | 'outside'): void;
     /** Returns true when a message should be hidden by the descriptor's
      *  `hideSystemMessages` filter. Matches the trimmed content
      *  case-insensitively against any configured needle (substring match). */
@@ -1170,6 +1172,7 @@ declare interface WidgetConfig extends ChatClientConfig {
         attachPosition?: 'left' | 'right';
         sendButtonShape?: 'circle' | 'square';
     };
+    templateLayout?: 'inside' | 'outside';
     showBubble?: boolean;
     bubbleText?: string;
     bubbleIcon?: string;

package/dist/ui.mjs

@@ -1,4 +1,4 @@
-import { B as i, a as s, c as e, d as t, e as A, D as k, f as n, F as o, g, h as l, G as d, H as m, i as p, I as C, J as h, K as b, j as M, r as c } from "./MountTenant-CdaBBA2O.mjs";
+import { B as i, a as s, c as e, d as t, e as A, D as k, f as n, F as o, g, h as l, G as d, H as m, i as p, I as C, J as h, K as b, j as M, r as c } from "./MountTenant-DzNgBTiU.mjs";
 export {
   i as AikaaraChat,
   s as AikaaraChatBubble,