@dabalabs/agent 0.0.2-beta → 0.0.4-beta

package/dist/react.cjs

@@ -1,21 +1,48 @@
 'use strict';
 
-var chunkJQMJMSFT_cjs = require('./chunk-JQMJMSFT.cjs');
-require('./chunk-IMPMGYCG.cjs');
+var chunkVAIC5ACS_cjs = require('./chunk-VAIC5ACS.cjs');
+var React = require('react');
 
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
+var React__default = /*#__PURE__*/_interopDefault(React);
 
-Object.defineProperty(exports, "DabaAgent", {
-  enumerable: true,
-  get: function () { return chunkJQMJMSFT_cjs.DabaAgentComponent; }
-});
-Object.defineProperty(exports, "DabaAgentComponent", {
-  enumerable: true,
-  get: function () { return chunkJQMJMSFT_cjs.DabaAgentComponent; }
-});
-Object.defineProperty(exports, "DabaAgentReact", {
-  enumerable: true,
-  get: function () { return chunkJQMJMSFT_cjs.DabaAgentComponent; }
-});
+function DabaAgentComponent(props) {
+  const containerRef = React.useRef(null);
+  const agentRef = React.useRef(null);
+  const propsRef = React.useRef(props);
+  propsRef.current = props;
+  const configKey = JSON.stringify(
+    props,
+    (_key, value) => typeof value === "function" ? void 0 : value
+  );
+  React.useEffect(() => {
+    if (!containerRef.current) return;
+    const agent = new chunkVAIC5ACS_cjs.DabaAgent({
+      ...propsRef.current,
+      // After the spread: this component owns where the widget mounts.
+      container: containerRef.current,
+      onStatusChange: (status) => propsRef.current.onStatusChange?.(status),
+      onTranscript: (role, text, isFinal) => propsRef.current.onTranscript?.(role, text, isFinal),
+      onChatToggle: (isOpen) => propsRef.current.onChatToggle?.(isOpen),
+      onCards: (cards) => propsRef.current.onCards?.(cards),
+      onError: (error) => propsRef.current.onError?.(error)
+    });
+    agentRef.current = agent;
+    return () => {
+      agent.destroy();
+      agentRef.current = null;
+    };
+  }, [configKey]);
+  return React__default.default.createElement("div", {
+    ref: containerRef,
+    style: { display: "contents" },
+    "data-daba-agent-react-container": "true"
+  });
+}
+
+exports.DabaAgent = DabaAgentComponent;
+exports.DabaAgentComponent = DabaAgentComponent;
+exports.DabaAgentReact = DabaAgentComponent;
 //# sourceMappingURL=react.cjs.map
 //# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"react.cjs"}
+{"version":3,"sources":["../src/components/react.ts"],"names":["useRef","useEffect","DabaAgent","React"],"mappings":";;;;;;;;;AAMO,SAAS,mBAAmB,KAAA,EAA2C;AAC5E,EAAA,MAAM,YAAA,GAAeA,aAAuB,IAAI,CAAA;AAChD,EAAA,MAAM,QAAA,GAAWA,aAAyB,IAAI,CAAA;AAK9C,EAAA,MAAM,QAAA,GAAWA,aAAO,KAAK,CAAA;AAC7B,EAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AAiBnB,EAAA,MAAM,YAAY,IAAA,CAAK,SAAA;AAAA,IAAU,KAAA;AAAA,IAAO,CAAC,IAAA,EAAM,KAAA,KAC7C,OAAO,KAAA,KAAU,aAAa,MAAA,GAAY;AAAA,GAC5C;AAEA,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,aAAa,OAAA,EAAS;AAE3B,IAAA,MAAM,KAAA,GAAQ,IAAIC,2BAAA,CAAU;AAAA,MAC1B,GAAG,QAAA,CAAS,OAAA;AAAA;AAAA,MAEZ,WAAW,YAAA,CAAa,OAAA;AAAA,MACxB,gBAAgB,CAAC,MAAA,KAAW,QAAA,CAAS,OAAA,CAAQ,iBAAiB,MAAM,CAAA;AAAA,MACpE,YAAA,EAAc,CAAC,IAAA,EAAM,IAAA,EAAM,OAAA,KACzB,SAAS,OAAA,CAAQ,YAAA,GAAe,IAAA,EAAM,IAAA,EAAM,OAAO,CAAA;AAAA,MACrD,cAAc,CAAC,MAAA,KAAW,QAAA,CAAS,OAAA,CAAQ,eAAe,MAAM,CAAA;AAAA,MAChE,SAAS,CAAC,KAAA,KAAU,QAAA,CAAS,OAAA,CAAQ,UAAU,KAAK,CAAA;AAAA,MACpD,SAAS,CAAC,KAAA,KAAU,QAAA,CAAS,OAAA,CAAQ,UAAU,KAAK;AAAA,KACrD,CAAA;AACD,IAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AAEnB,IAAA,OAAO,MAAM;AACX,MAAA,KAAA,CAAM,OAAA,EAAQ;AACd,MAAA,QAAA,CAAS,OAAA,GAAU,IAAA;AAAA,IACrB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,SAAS,CAAC,CAAA;AAEd,EAAA,OAAOC,sBAAA,CAAM,cAAc,KAAA,EAAO;AAAA,IAChC,GAAA,EAAK,YAAA;AAAA,IACL,KAAA,EAAO,EAAE,OAAA,EAAS,UAAA,EAAW;AAAA,IAC7B,iCAAA,EAAmC;AAAA,GACpC,CAAA;AACH","file":"react.cjs","sourcesContent":["import React, { useEffect, useRef } from \"react\";\nimport { DabaAgent } from \"../agent\";\nimport type { DabaAgentOptions } from \"../types\";\n\nexport type DabaAgentProps = Omit<DabaAgentOptions, \"container\">;\n\nexport function DabaAgentComponent(props: DabaAgentProps): React.ReactElement {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const agentRef = useRef<DabaAgent | null>(null);\n\n  // The agent reads its handlers back out of this ref at call time, which\n  // is what keeps an inline `onCards={(c) => setCards(c)}` current without\n  // its per-render identity forcing a rebuild below.\n  const propsRef = useRef(props);\n  propsRef.current = props;\n\n  /**\n   * The effect keys on the configuration's VALUE, not on the prop objects.\n   *\n   * `theme={{ accentColor: \"#0c8c5e\" }}` is a fresh object on every render\n   * of the parent, so listing it as a dependency would destroy and rebuild\n   * the widget — closing the panel, dropping the conversation, restarting\n   * a voice session — every time an unrelated piece of the host page's\n   * state changed. Serialising compares the way the integrator meant it.\n   *\n   * Functions are stripped rather than compared: callbacks are re-created\n   * on every render too, and they reach the live agent through `propsRef`\n   * instead. Serialising also means a newly added option is covered here\n   * the moment it exists, which the hand-listed dependency array this\n   * replaces was already out of step with (`env` never made it in).\n   */\n  const configKey = JSON.stringify(props, (_key, value) =>\n    typeof value === \"function\" ? undefined : value,\n  );\n\n  useEffect(() => {\n    if (!containerRef.current) return;\n\n    const agent = new DabaAgent({\n      ...propsRef.current,\n      // After the spread: this component owns where the widget mounts.\n      container: containerRef.current,\n      onStatusChange: (status) => propsRef.current.onStatusChange?.(status),\n      onTranscript: (role, text, isFinal) =>\n        propsRef.current.onTranscript?.(role, text, isFinal),\n      onChatToggle: (isOpen) => propsRef.current.onChatToggle?.(isOpen),\n      onCards: (cards) => propsRef.current.onCards?.(cards),\n      onError: (error) => propsRef.current.onError?.(error),\n    });\n    agentRef.current = agent;\n\n    return () => {\n      agent.destroy();\n      agentRef.current = null;\n    };\n  }, [configKey]);\n\n  return React.createElement(\"div\", {\n    ref: containerRef,\n    style: { display: \"contents\" },\n    \"data-daba-agent-react-container\": \"true\",\n  });\n}\n\nexport { DabaAgentComponent as DabaAgentReact, DabaAgentComponent as DabaAgent };\n"]}

package/dist/react.d.cts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { a as DabaAgentOptions } from './types-hdR_wQ1B.cjs';
+import { D as DabaAgentOptions } from './types-BQRgqD4n.cjs';
 
 type DabaAgentProps = Omit<DabaAgentOptions, "container">;
 declare function DabaAgentComponent(props: DabaAgentProps): React.ReactElement;

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { a as DabaAgentOptions } from './types-hdR_wQ1B.js';
+import { D as DabaAgentOptions } from './types-BQRgqD4n.js';
 
 type DabaAgentProps = Omit<DabaAgentOptions, "container">;
 declare function DabaAgentComponent(props: DabaAgentProps): React.ReactElement;

package/dist/react.js

@@ -1,4 +1,40 @@
-export { DabaAgentComponent as DabaAgent, DabaAgentComponent, DabaAgentComponent as DabaAgentReact } from './chunk-GCU5OBSZ.js';
-import './chunk-CMHPVBEF.js';
+import { DabaAgent } from './chunk-ETI4LRM7.js';
+import React, { useRef, useEffect } from 'react';
+
+function DabaAgentComponent(props) {
+  const containerRef = useRef(null);
+  const agentRef = useRef(null);
+  const propsRef = useRef(props);
+  propsRef.current = props;
+  const configKey = JSON.stringify(
+    props,
+    (_key, value) => typeof value === "function" ? void 0 : value
+  );
+  useEffect(() => {
+    if (!containerRef.current) return;
+    const agent = new DabaAgent({
+      ...propsRef.current,
+      // After the spread: this component owns where the widget mounts.
+      container: containerRef.current,
+      onStatusChange: (status) => propsRef.current.onStatusChange?.(status),
+      onTranscript: (role, text, isFinal) => propsRef.current.onTranscript?.(role, text, isFinal),
+      onChatToggle: (isOpen) => propsRef.current.onChatToggle?.(isOpen),
+      onCards: (cards) => propsRef.current.onCards?.(cards),
+      onError: (error) => propsRef.current.onError?.(error)
+    });
+    agentRef.current = agent;
+    return () => {
+      agent.destroy();
+      agentRef.current = null;
+    };
+  }, [configKey]);
+  return React.createElement("div", {
+    ref: containerRef,
+    style: { display: "contents" },
+    "data-daba-agent-react-container": "true"
+  });
+}
+
+export { DabaAgentComponent as DabaAgent, DabaAgentComponent, DabaAgentComponent as DabaAgentReact };
 //# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"react.js"}
+{"version":3,"sources":["../src/components/react.ts"],"names":[],"mappings":";;;AAMO,SAAS,mBAAmB,KAAA,EAA2C;AAC5E,EAAA,MAAM,YAAA,GAAe,OAAuB,IAAI,CAAA;AAChD,EAAA,MAAM,QAAA,GAAW,OAAyB,IAAI,CAAA;AAK9C,EAAA,MAAM,QAAA,GAAW,OAAO,KAAK,CAAA;AAC7B,EAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AAiBnB,EAAA,MAAM,YAAY,IAAA,CAAK,SAAA;AAAA,IAAU,KAAA;AAAA,IAAO,CAAC,IAAA,EAAM,KAAA,KAC7C,OAAO,KAAA,KAAU,aAAa,MAAA,GAAY;AAAA,GAC5C;AAEA,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,aAAa,OAAA,EAAS;AAE3B,IAAA,MAAM,KAAA,GAAQ,IAAI,SAAA,CAAU;AAAA,MAC1B,GAAG,QAAA,CAAS,OAAA;AAAA;AAAA,MAEZ,WAAW,YAAA,CAAa,OAAA;AAAA,MACxB,gBAAgB,CAAC,MAAA,KAAW,QAAA,CAAS,OAAA,CAAQ,iBAAiB,MAAM,CAAA;AAAA,MACpE,YAAA,EAAc,CAAC,IAAA,EAAM,IAAA,EAAM,OAAA,KACzB,SAAS,OAAA,CAAQ,YAAA,GAAe,IAAA,EAAM,IAAA,EAAM,OAAO,CAAA;AAAA,MACrD,cAAc,CAAC,MAAA,KAAW,QAAA,CAAS,OAAA,CAAQ,eAAe,MAAM,CAAA;AAAA,MAChE,SAAS,CAAC,KAAA,KAAU,QAAA,CAAS,OAAA,CAAQ,UAAU,KAAK,CAAA;AAAA,MACpD,SAAS,CAAC,KAAA,KAAU,QAAA,CAAS,OAAA,CAAQ,UAAU,KAAK;AAAA,KACrD,CAAA;AACD,IAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AAEnB,IAAA,OAAO,MAAM;AACX,MAAA,KAAA,CAAM,OAAA,EAAQ;AACd,MAAA,QAAA,CAAS,OAAA,GAAU,IAAA;AAAA,IACrB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,SAAS,CAAC,CAAA;AAEd,EAAA,OAAO,KAAA,CAAM,cAAc,KAAA,EAAO;AAAA,IAChC,GAAA,EAAK,YAAA;AAAA,IACL,KAAA,EAAO,EAAE,OAAA,EAAS,UAAA,EAAW;AAAA,IAC7B,iCAAA,EAAmC;AAAA,GACpC,CAAA;AACH","file":"react.js","sourcesContent":["import React, { useEffect, useRef } from \"react\";\nimport { DabaAgent } from \"../agent\";\nimport type { DabaAgentOptions } from \"../types\";\n\nexport type DabaAgentProps = Omit<DabaAgentOptions, \"container\">;\n\nexport function DabaAgentComponent(props: DabaAgentProps): React.ReactElement {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const agentRef = useRef<DabaAgent | null>(null);\n\n  // The agent reads its handlers back out of this ref at call time, which\n  // is what keeps an inline `onCards={(c) => setCards(c)}` current without\n  // its per-render identity forcing a rebuild below.\n  const propsRef = useRef(props);\n  propsRef.current = props;\n\n  /**\n   * The effect keys on the configuration's VALUE, not on the prop objects.\n   *\n   * `theme={{ accentColor: \"#0c8c5e\" }}` is a fresh object on every render\n   * of the parent, so listing it as a dependency would destroy and rebuild\n   * the widget — closing the panel, dropping the conversation, restarting\n   * a voice session — every time an unrelated piece of the host page's\n   * state changed. Serialising compares the way the integrator meant it.\n   *\n   * Functions are stripped rather than compared: callbacks are re-created\n   * on every render too, and they reach the live agent through `propsRef`\n   * instead. Serialising also means a newly added option is covered here\n   * the moment it exists, which the hand-listed dependency array this\n   * replaces was already out of step with (`env` never made it in).\n   */\n  const configKey = JSON.stringify(props, (_key, value) =>\n    typeof value === \"function\" ? undefined : value,\n  );\n\n  useEffect(() => {\n    if (!containerRef.current) return;\n\n    const agent = new DabaAgent({\n      ...propsRef.current,\n      // After the spread: this component owns where the widget mounts.\n      container: containerRef.current,\n      onStatusChange: (status) => propsRef.current.onStatusChange?.(status),\n      onTranscript: (role, text, isFinal) =>\n        propsRef.current.onTranscript?.(role, text, isFinal),\n      onChatToggle: (isOpen) => propsRef.current.onChatToggle?.(isOpen),\n      onCards: (cards) => propsRef.current.onCards?.(cards),\n      onError: (error) => propsRef.current.onError?.(error),\n    });\n    agentRef.current = agent;\n\n    return () => {\n      agent.destroy();\n      agentRef.current = null;\n    };\n  }, [configKey]);\n\n  return React.createElement(\"div\", {\n    ref: containerRef,\n    style: { display: \"contents\" },\n    \"data-daba-agent-react-container\": \"true\",\n  });\n}\n\nexport { DabaAgentComponent as DabaAgentReact, DabaAgentComponent as DabaAgent };\n"]}

package/dist/{types-hdR_wQ1B.d.cts → types-BQRgqD4n.d.cts}

@@ -89,7 +89,7 @@ interface ChatMessage {
 }
 /**
  * Colour and shape overrides. Every field is optional and every absent
- * field falls back to the Dabalabs brand kit, so `{}` is a complete,
+ * field falls back to the DabaLabs brand kit, so `{}` is a complete,
  * correct theme rather than an empty one.
  */
 interface DabaTheme {
@@ -124,8 +124,46 @@ interface DabaLauncher {
     shape?: DabaLauncherShape;
     /** Replaces the shipped mark entirely. Use for a customer's own logo. */
     iconUrl?: string | null;
+    /**
+     * The mark as inline SVG markup rather than a URL.
+     *
+     * Wins over `iconUrl`. Worth preferring on a site with a strict
+     * Content-Security-Policy, where `img-src 'self'` blocks an <img> at
+     * someone else's CDN and the launcher would render empty; inline markup
+     * has no such dependency and can inherit `currentColor`. Script, event
+     * handlers and external references are stripped before it is inserted.
+     */
+    iconSvg?: string | null;
+    /** An emoji or a letter or two, drawn as the mark. Wins over `iconUrl`,
+     * loses to `iconSvg`. */
+    iconText?: string | null;
     /** Text beside the icon, turning the badge into a labelled pill. */
     label?: string | null;
+    /** The launcher button itself, as any CSS length. Default "56px" — or
+     * "52px" below 480px wide, which an explicit value overrides on phones
+     * too. */
+    size?: string | number;
+    /** The mark inside the button, as any CSS length. Default "100%", so it
+     * fills the button; a wordmark with its own whitespace usually wants
+     * less. */
+    iconSize?: string | number;
+}
+/**
+ * The chat panel's own box.
+ *
+ * Separate from `launcher` because "width and height" is ambiguous
+ * between the two, and an integrator who meant the panel and got the
+ * button has no way to tell from the option name.
+ *
+ * Ignored below 480px wide, where the panel goes full-screen: a fixed
+ * width on a phone either overflows the viewport or leaves a gutter.
+ */
+interface DabaPanel {
+    /** Any CSS length. Default "400px". */
+    width?: string | number;
+    /** Any CSS length. Default "740px". Still clamped to the viewport, so a
+     * value taller than the window does not push the launcher off-screen. */
+    height?: string | number;
 }
 interface DabaAgentOptions {
     projectId: string;
@@ -133,7 +171,7 @@ interface DabaAgentOptions {
     /** Overrides `env` when both are given — the only option that can name
      * a host neither tier covers (self-hosted, a local gateway). */
     gatewayUrl?: string;
-    /** Which Dabalabs tier to talk to. Omit for production; pass "staging"
+    /** Which DabaLabs tier to talk to. Omit for production; pass "staging"
      * to point the agent at the staging gateway. */
     env?: DabaEnvironment;
     /** Where to mount the widget. Defaults to a fixed-position element
@@ -158,8 +196,12 @@ interface DabaAgentOptions {
     theme?: DabaTheme;
     intro?: DabaIntro;
     launcher?: DabaLauncher;
+    panel?: DabaPanel;
     /** Brand logo shown in the panel header. */
     logoUrl?: string | null;
+    /** The header logo as inline SVG markup. Wins over `logoUrl`; same CSP
+     * reasoning as `launcher.iconSvg`. */
+    logoSvg?: string | null;
     /** BCP-47 code for the widget's own chrome, or "auto" to follow the
      * host page's `lang`. Independent of what the assistant replies in —
      * it always answers in the visitor's language regardless. */
@@ -177,7 +219,31 @@ interface DabaAgentOptions {
     placeholder?: string;
     /** Whether the chat popover starts open. */
     initialOpen?: boolean;
-    /** Defaults to "ctrl+space". Set to `null` to disable the hotkey. */
+    /**
+     * Keep past conversations in this browser, so a visitor can go back to
+     * one — a history button appears in the panel header once there is
+     * something in it.
+     *
+     * OFF unless you pass `true`. The live transcript is sessionStorage and
+     * dies with the tab on purpose ("a conversation is a visit, not an
+     * identity"); an archive is localStorage and outlives it, which on a
+     * shared or public machine is a decision an embed has to make
+     * deliberately rather than inherit. Nothing is sent to the gateway, and
+     * the visitor can delete any thread or clear the lot from the panel.
+     */
+    historyEnabled?: boolean;
+    /**
+     * Keyboard shortcut that opens and closes the assistant.
+     *
+     * A combination — `"ctrl+space"`, `"alt+k"` — or a modifier held on its
+     * own: `"hold:ctrl"`, and likewise `hold:alt`, `hold:shift`, `hold:meta`.
+     * A held modifier fires after about half a second and is abandoned the
+     * moment another key joins it, so `Ctrl+C` never opens the widget.
+     *
+     * Defaults per platform: `alt+space` on macOS, where the OS binds
+     * Ctrl+Space to the input-source switcher, and `ctrl+space` elsewhere.
+     * `null` disables the shortcut entirely.
+     */
     hotkey?: string | null;
     onError?: (error: DabaError) => void;
     onStatusChange?: (status: DabaAgentStatus) => void;
@@ -236,4 +302,4 @@ interface DabaChatReply {
     conversationId: string;
 }
 
-export type { ChatMessage as C, DabaAgentMode as D, DabaAgentOptions as a, DabaAgentPosition as b, DabaAgentStatus as c, DabaCard as d, DabaCardKind as e, DabaCardMeta as f, DabaChatReply as g, DabaDirection as h, DabaError as i, DabaIntro as j, DabaLauncher as k, DabaLauncherShape as l, DabaRemoteConfig as m, DabaTheme as n, DabaThemePreference as o };
+export type { ChatMessage as C, DabaAgentOptions as D, DabaAgentStatus as a, DabaAgentMode as b, DabaAgentPosition as c, DabaCard as d, DabaCardKind as e, DabaCardMeta as f, DabaChatReply as g, DabaDirection as h, DabaError as i, DabaIntro as j, DabaLauncher as k, DabaLauncherShape as l, DabaPanel as m, DabaRemoteConfig as n, DabaTheme as o, DabaThemePreference as p, DabaVoiceEngine as q };

package/dist/{types-hdR_wQ1B.d.ts → types-BQRgqD4n.d.ts}

@@ -89,7 +89,7 @@ interface ChatMessage {
 }
 /**
  * Colour and shape overrides. Every field is optional and every absent
- * field falls back to the Dabalabs brand kit, so `{}` is a complete,
+ * field falls back to the DabaLabs brand kit, so `{}` is a complete,
  * correct theme rather than an empty one.
  */
 interface DabaTheme {
@@ -124,8 +124,46 @@ interface DabaLauncher {
     shape?: DabaLauncherShape;
     /** Replaces the shipped mark entirely. Use for a customer's own logo. */
     iconUrl?: string | null;
+    /**
+     * The mark as inline SVG markup rather than a URL.
+     *
+     * Wins over `iconUrl`. Worth preferring on a site with a strict
+     * Content-Security-Policy, where `img-src 'self'` blocks an <img> at
+     * someone else's CDN and the launcher would render empty; inline markup
+     * has no such dependency and can inherit `currentColor`. Script, event
+     * handlers and external references are stripped before it is inserted.
+     */
+    iconSvg?: string | null;
+    /** An emoji or a letter or two, drawn as the mark. Wins over `iconUrl`,
+     * loses to `iconSvg`. */
+    iconText?: string | null;
     /** Text beside the icon, turning the badge into a labelled pill. */
     label?: string | null;
+    /** The launcher button itself, as any CSS length. Default "56px" — or
+     * "52px" below 480px wide, which an explicit value overrides on phones
+     * too. */
+    size?: string | number;
+    /** The mark inside the button, as any CSS length. Default "100%", so it
+     * fills the button; a wordmark with its own whitespace usually wants
+     * less. */
+    iconSize?: string | number;
+}
+/**
+ * The chat panel's own box.
+ *
+ * Separate from `launcher` because "width and height" is ambiguous
+ * between the two, and an integrator who meant the panel and got the
+ * button has no way to tell from the option name.
+ *
+ * Ignored below 480px wide, where the panel goes full-screen: a fixed
+ * width on a phone either overflows the viewport or leaves a gutter.
+ */
+interface DabaPanel {
+    /** Any CSS length. Default "400px". */
+    width?: string | number;
+    /** Any CSS length. Default "740px". Still clamped to the viewport, so a
+     * value taller than the window does not push the launcher off-screen. */
+    height?: string | number;
 }
 interface DabaAgentOptions {
     projectId: string;
@@ -133,7 +171,7 @@ interface DabaAgentOptions {
     /** Overrides `env` when both are given — the only option that can name
      * a host neither tier covers (self-hosted, a local gateway). */
     gatewayUrl?: string;
-    /** Which Dabalabs tier to talk to. Omit for production; pass "staging"
+    /** Which DabaLabs tier to talk to. Omit for production; pass "staging"
      * to point the agent at the staging gateway. */
     env?: DabaEnvironment;
     /** Where to mount the widget. Defaults to a fixed-position element
@@ -158,8 +196,12 @@ interface DabaAgentOptions {
     theme?: DabaTheme;
     intro?: DabaIntro;
     launcher?: DabaLauncher;
+    panel?: DabaPanel;
     /** Brand logo shown in the panel header. */
     logoUrl?: string | null;
+    /** The header logo as inline SVG markup. Wins over `logoUrl`; same CSP
+     * reasoning as `launcher.iconSvg`. */
+    logoSvg?: string | null;
     /** BCP-47 code for the widget's own chrome, or "auto" to follow the
      * host page's `lang`. Independent of what the assistant replies in —
      * it always answers in the visitor's language regardless. */
@@ -177,7 +219,31 @@ interface DabaAgentOptions {
     placeholder?: string;
     /** Whether the chat popover starts open. */
     initialOpen?: boolean;
-    /** Defaults to "ctrl+space". Set to `null` to disable the hotkey. */
+    /**
+     * Keep past conversations in this browser, so a visitor can go back to
+     * one — a history button appears in the panel header once there is
+     * something in it.
+     *
+     * OFF unless you pass `true`. The live transcript is sessionStorage and
+     * dies with the tab on purpose ("a conversation is a visit, not an
+     * identity"); an archive is localStorage and outlives it, which on a
+     * shared or public machine is a decision an embed has to make
+     * deliberately rather than inherit. Nothing is sent to the gateway, and
+     * the visitor can delete any thread or clear the lot from the panel.
+     */
+    historyEnabled?: boolean;
+    /**
+     * Keyboard shortcut that opens and closes the assistant.
+     *
+     * A combination — `"ctrl+space"`, `"alt+k"` — or a modifier held on its
+     * own: `"hold:ctrl"`, and likewise `hold:alt`, `hold:shift`, `hold:meta`.
+     * A held modifier fires after about half a second and is abandoned the
+     * moment another key joins it, so `Ctrl+C` never opens the widget.
+     *
+     * Defaults per platform: `alt+space` on macOS, where the OS binds
+     * Ctrl+Space to the input-source switcher, and `ctrl+space` elsewhere.
+     * `null` disables the shortcut entirely.
+     */
     hotkey?: string | null;
     onError?: (error: DabaError) => void;
     onStatusChange?: (status: DabaAgentStatus) => void;
@@ -236,4 +302,4 @@ interface DabaChatReply {
     conversationId: string;
 }
 
-export type { ChatMessage as C, DabaAgentMode as D, DabaAgentOptions as a, DabaAgentPosition as b, DabaAgentStatus as c, DabaCard as d, DabaCardKind as e, DabaCardMeta as f, DabaChatReply as g, DabaDirection as h, DabaError as i, DabaIntro as j, DabaLauncher as k, DabaLauncherShape as l, DabaRemoteConfig as m, DabaTheme as n, DabaThemePreference as o };
+export type { ChatMessage as C, DabaAgentOptions as D, DabaAgentStatus as a, DabaAgentMode as b, DabaAgentPosition as c, DabaCard as d, DabaCardKind as e, DabaCardMeta as f, DabaChatReply as g, DabaDirection as h, DabaError as i, DabaIntro as j, DabaLauncher as k, DabaLauncherShape as l, DabaPanel as m, DabaRemoteConfig as n, DabaTheme as o, DabaThemePreference as p, DabaVoiceEngine as q };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dabalabs/agent",
-  "version": "0.0.2-beta",
+  "version": "0.0.4-beta",
   "description": "Embeddable voice AI website assistant widget for dabalabs projects — press Ctrl+Space, talk to your site.",
   "author": "dabalabs",
   "license": "MIT",

package/dist/chunk-7ENX2QZK.js

@@ -1,193 +0,0 @@
-import { DabaAgent } from './chunk-CMHPVBEF.js';
-
-// src/components/custom-element.ts
-var VALID_POSITIONS = [
-  "bottom-right",
-  "bottom-left",
-  "top-right",
-  "top-left"
-];
-var VALID_MODES = ["voice", "chat", "hybrid"];
-var VALID_DIRECTIONS = ["auto", "ltr", "rtl"];
-var VALID_THEMES = ["auto", "light", "dark"];
-var VALID_LAUNCHER_SHAPES = ["rounded", "circle", "pill"];
-var VALID_MEDIA_TYPES = ["video", "image", "none"];
-var PROMPT_SEPARATOR = "|";
-function readAttr(el, name) {
-  for (const attr of [name, `data-${name}`]) {
-    const raw = el.getAttribute(attr);
-    if (raw === null) continue;
-    const value = raw.trim();
-    if (value === "") continue;
-    return { attr, value };
-  }
-  return void 0;
-}
-function stringAttr(el, name) {
-  return readAttr(el, name)?.value;
-}
-function enumAttr(el, name, allowed) {
-  const found = readAttr(el, name);
-  if (!found) return void 0;
-  if (allowed.includes(found.value)) return found.value;
-  console.error(
-    `daba-agent: invalid ${found.attr} "${found.value}" on <daba-agent>. Expected one of ${allowed.join(
-      ", "
-    )} \u2014 ignoring it.`,
-    el
-  );
-  return void 0;
-}
-function flagAttr(el, name) {
-  for (const attr of [name, `data-${name}`]) {
-    const raw = el.getAttribute(attr);
-    if (raw === null) continue;
-    const value = raw.trim().toLowerCase();
-    return value !== "false" && value !== "0" && value !== "no";
-  }
-  return void 0;
-}
-function promptsAttr(el, name) {
-  const found = readAttr(el, name);
-  if (!found) return void 0;
-  const prompts = found.value.split(PROMPT_SEPARATOR).map((prompt) => prompt.trim()).filter((prompt) => prompt !== "");
-  return prompts.length > 0 ? prompts : void 0;
-}
-function group(fields) {
-  return Object.values(fields).some((value) => value !== void 0) ? fields : void 0;
-}
-var DabaAgentElement = class extends HTMLElement {
-  constructor() {
-    super(...arguments);
-    this.agent = null;
-  }
-  connectedCallback() {
-    if (this.agent) return;
-    const projectId = stringAttr(this, "project-id");
-    const apiKey = stringAttr(this, "api-key");
-    if (!projectId || !apiKey) {
-      console.error(
-        "daba-agent: <daba-agent> custom element requires project-id and api-key attributes.",
-        this
-      );
-      return;
-    }
-    const position = enumAttr(this, "position", VALID_POSITIONS);
-    const accentColor = stringAttr(this, "accent-color");
-    const mode = enumAttr(this, "mode", VALID_MODES);
-    const title = stringAttr(this, "title");
-    const placeholder = stringAttr(this, "placeholder");
-    const initialOpen = flagAttr(this, "initial-open");
-    const hotkey = stringAttr(this, "hotkey");
-    const gatewayUrl = stringAttr(this, "gateway-url");
-    const env = stringAttr(this, "env");
-    const theme = group({
-      accentColor,
-      accentContrast: stringAttr(this, "accent-contrast"),
-      surfaceColor: stringAttr(this, "surface-color"),
-      textColor: stringAttr(this, "text-color"),
-      radius: stringAttr(this, "radius"),
-      fontFamily: stringAttr(this, "font-family"),
-      theme: enumAttr(this, "theme", VALID_THEMES)
-    });
-    const introDisabled = flagAttr(this, "intro-disabled");
-    const intro = group({
-      enabled: introDisabled === void 0 ? void 0 : !introDisabled,
-      headline: stringAttr(this, "intro-headline"),
-      subheadline: stringAttr(this, "intro-subheadline"),
-      mediaUrl: stringAttr(this, "intro-media-url"),
-      mediaType: enumAttr(this, "intro-media-type", VALID_MEDIA_TYPES),
-      suggestedPrompts: promptsAttr(this, "suggested-prompts")
-    });
-    const launcher = group({
-      shape: enumAttr(this, "launcher-shape", VALID_LAUNCHER_SHAPES),
-      iconUrl: stringAttr(this, "launcher-icon-url"),
-      label: stringAttr(this, "launcher-label")
-    });
-    this.agent = new DabaAgent({
-      container: this,
-      projectId,
-      apiKey,
-      position,
-      accentColor,
-      mode,
-      title,
-      placeholder,
-      initialOpen,
-      hotkey,
-      gatewayUrl,
-      env,
-      theme,
-      intro,
-      launcher,
-      logoUrl: stringAttr(this, "logo-url"),
-      uiLanguage: stringAttr(this, "ui-language"),
-      direction: enumAttr(this, "direction", VALID_DIRECTIONS),
-      onStatusChange: (status) => {
-        this.dispatchEvent(
-          new CustomEvent("daba-status-change", { detail: { status }, bubbles: true, composed: true })
-        );
-      },
-      onTranscript: (role, text, isFinal) => {
-        this.dispatchEvent(
-          new CustomEvent("daba-transcript", {
-            detail: { role, text, isFinal },
-            bubbles: true,
-            composed: true
-          })
-        );
-      },
-      onError: (error) => {
-        this.dispatchEvent(
-          new CustomEvent("daba-error", { detail: { error }, bubbles: true, composed: true })
-        );
-      },
-      onChatToggle: (isOpen) => {
-        this.dispatchEvent(
-          new CustomEvent("daba-chat-toggle", { detail: { isOpen }, bubbles: true, composed: true })
-        );
-      },
-      // Cards arrive once per reply that carried structured items, so a
-      // host page can render them in its own layout instead of (or as well
-      // as) the panel's — a listing site putting event cards on the page.
-      onCards: (cards) => {
-        this.dispatchEvent(
-          new CustomEvent("daba-cards", { detail: { cards }, bubbles: true, composed: true })
-        );
-      }
-    });
-  }
-  disconnectedCallback() {
-    if (this.agent) {
-      this.agent.destroy();
-      this.agent = null;
-    }
-  }
-  get dabaAgent() {
-    return this.agent;
-  }
-  sendText(text) {
-    return this.agent?.sendText(text);
-  }
-  openChat() {
-    this.agent?.openChat();
-  }
-  closeChat() {
-    this.agent?.closeChat();
-  }
-  toggleChat() {
-    this.agent?.toggleChat();
-  }
-};
-function defineDabaAgentElement(tagName = "daba-agent") {
-  if (typeof window !== "undefined" && typeof customElements !== "undefined") {
-    if (!customElements.get(tagName)) {
-      customElements.define(tagName, DabaAgentElement);
-    }
-  }
-}
-defineDabaAgentElement();
-
-export { DabaAgentElement, defineDabaAgentElement };
-//# sourceMappingURL=chunk-7ENX2QZK.js.map
-//# sourceMappingURL=chunk-7ENX2QZK.js.map

package/dist/chunk-7ENX2QZK.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/custom-element.ts"],"names":[],"mappings":"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","file":"chunk-7ENX2QZK.js","sourcesContent":["import { DabaAgent } from \"../agent\";\nimport type {\n  DabaAgentMode,\n  DabaAgentOptions,\n  DabaAgentPosition,\n  DabaDirection,\n  DabaIntro,\n  DabaLauncher,\n  DabaLauncherShape,\n  DabaTheme,\n  DabaThemePreference,\n} from \"../types\";\n\nconst VALID_POSITIONS: readonly DabaAgentPosition[] = [\n  \"bottom-right\",\n  \"bottom-left\",\n  \"top-right\",\n  \"top-left\",\n];\nconst VALID_MODES: readonly DabaAgentMode[] = [\"voice\", \"chat\", \"hybrid\"];\nconst VALID_DIRECTIONS: readonly DabaDirection[] = [\"auto\", \"ltr\", \"rtl\"];\nconst VALID_THEMES: readonly DabaThemePreference[] = [\"auto\", \"light\", \"dark\"];\nconst VALID_LAUNCHER_SHAPES: readonly DabaLauncherShape[] = [\"rounded\", \"circle\", \"pill\"];\nconst VALID_MEDIA_TYPES = [\"video\", \"image\", \"none\"] as const;\n\n/** Same separator as the script-tag embed's data-daba-suggested-prompts —\n * a pipe, because starter prompts are sentences and sentences contain\n * commas. See src/auto-init.ts for the reasoning. */\nconst PROMPT_SEPARATOR = \"|\";\n\n/**\n * Reads `<name>`, then the `data-<name>` alias this element has always\n * accepted, and reports which spelling was found so a warning can quote\n * what the integrator actually typed.\n *\n * Absent AND blank both read as \"not set\", because an option left\n * `undefined` is what tells the agent to use the project's dashboard\n * configuration. A framework binding that renders `radius=\"\"` must leave\n * the served radius alone rather than override it with nothing.\n *\n * These readers deliberately mirror src/auto-init.ts: the two embeds spell\n * their attributes differently but must accept exactly the same values.\n */\nfunction readAttr(el: HTMLElement, name: string): { attr: string; value: string } | undefined {\n  for (const attr of [name, `data-${name}`]) {\n    const raw = el.getAttribute(attr);\n    if (raw === null) continue;\n    const value = raw.trim();\n    if (value === \"\") continue;\n    return { attr, value };\n  }\n  return undefined;\n}\n\nfunction stringAttr(el: HTMLElement, name: string): string | undefined {\n  return readAttr(el, name)?.value;\n}\n\n/** A value outside the allowed set is dropped rather than forwarded, which\n * leaves the option `undefined` and so degrades a typo to the project's own\n * setting instead of letting garbage reach the DOM. */\nfunction enumAttr<T extends string>(\n  el: HTMLElement,\n  name: string,\n  allowed: readonly T[],\n): T | undefined {\n  const found = readAttr(el, name);\n  if (!found) return undefined;\n  if ((allowed as readonly string[]).includes(found.value)) return found.value as T;\n  console.error(\n    `daba-agent: invalid ${found.attr} \"${found.value}\" on <daba-agent>. Expected one of ${allowed.join(\n      \", \",\n    )} — ignoring it.`,\n    el,\n  );\n  return undefined;\n}\n\n/** Present with no value is true, the way HTML spells a boolean, but an\n * explicit \"false\" still means false so a bound attribute\n * (`:intro-disabled=\"hideIntro\"`) does not disable the intro everywhere. */\nfunction flagAttr(el: HTMLElement, name: string): boolean | undefined {\n  for (const attr of [name, `data-${name}`]) {\n    const raw = el.getAttribute(attr);\n    if (raw === null) continue;\n    const value = raw.trim().toLowerCase();\n    return value !== \"false\" && value !== \"0\" && value !== \"no\";\n  }\n  return undefined;\n}\n\n/** A list that separates into nothing is unset, not empty — far likelier a\n * binding that rendered nothing than a deliberate clearing of the\n * project's prompts. */\nfunction promptsAttr(el: HTMLElement, name: string): string[] | undefined {\n  const found = readAttr(el, name);\n  if (!found) return undefined;\n  const prompts = found.value\n    .split(PROMPT_SEPARATOR)\n    .map((prompt) => prompt.trim())\n    .filter((prompt) => prompt !== \"\");\n  return prompts.length > 0 ? prompts : undefined;\n}\n\n/** Grouped options exist only when one of their fields was configured;\n * an empty group would read downstream as an intentional override. */\nfunction group<T extends object>(fields: T): T | undefined {\n  return Object.values(fields).some((value) => value !== undefined) ? fields : undefined;\n}\n\nexport class DabaAgentElement extends HTMLElement {\n  private agent: DabaAgent | null = null;\n\n  connectedCallback(): void {\n    if (this.agent) return;\n\n    const projectId = stringAttr(this, \"project-id\");\n    const apiKey = stringAttr(this, \"api-key\");\n\n    if (!projectId || !apiKey) {\n      console.error(\n        \"daba-agent: <daba-agent> custom element requires project-id and api-key attributes.\",\n        this,\n      );\n      return;\n    }\n\n    const position = enumAttr(this, \"position\", VALID_POSITIONS);\n    const accentColor = stringAttr(this, \"accent-color\");\n    const mode = enumAttr(this, \"mode\", VALID_MODES);\n    const title = stringAttr(this, \"title\");\n    const placeholder = stringAttr(this, \"placeholder\");\n    const initialOpen = flagAttr(this, \"initial-open\");\n    const hotkey = stringAttr(this, \"hotkey\");\n    const gatewayUrl = stringAttr(this, \"gateway-url\");\n    // env=\"staging\" points the element at the staging gateway, the same\n    // way data-daba-env does for the script-tag embed. Absent means\n    // production — see environment.ts.\n    const env = stringAttr(this, \"env\") as DabaAgentOptions[\"env\"];\n\n    // The accent is offered under both names it has on the option surface:\n    // the flat `accentColor` the badge already reads, and the grouped\n    // `theme.accentColor` that sits with the rest of the appearance\n    // overrides. Same value either way.\n    const theme = group<DabaTheme>({\n      accentColor,\n      accentContrast: stringAttr(this, \"accent-contrast\"),\n      surfaceColor: stringAttr(this, \"surface-color\"),\n      textColor: stringAttr(this, \"text-color\"),\n      radius: stringAttr(this, \"radius\"),\n      fontFamily: stringAttr(this, \"font-family\"),\n      theme: enumAttr(this, \"theme\", VALID_THEMES),\n    });\n\n    // The attribute names the state an integrator wants to force — an\n    // intro is on unless switched off — while the option carries the state\n    // itself, so the flag is inverted here rather than in the agent.\n    const introDisabled = flagAttr(this, \"intro-disabled\");\n    const intro = group<DabaIntro>({\n      enabled: introDisabled === undefined ? undefined : !introDisabled,\n      headline: stringAttr(this, \"intro-headline\"),\n      subheadline: stringAttr(this, \"intro-subheadline\"),\n      mediaUrl: stringAttr(this, \"intro-media-url\"),\n      mediaType: enumAttr(this, \"intro-media-type\", VALID_MEDIA_TYPES),\n      suggestedPrompts: promptsAttr(this, \"suggested-prompts\"),\n    });\n\n    const launcher = group<DabaLauncher>({\n      shape: enumAttr(this, \"launcher-shape\", VALID_LAUNCHER_SHAPES),\n      iconUrl: stringAttr(this, \"launcher-icon-url\"),\n      label: stringAttr(this, \"launcher-label\"),\n    });\n\n    this.agent = new DabaAgent({\n      container: this,\n      projectId,\n      apiKey,\n      position,\n      accentColor,\n      mode,\n      title,\n      placeholder,\n      initialOpen,\n      hotkey,\n      gatewayUrl,\n      env,\n      theme,\n      intro,\n      launcher,\n      logoUrl: stringAttr(this, \"logo-url\"),\n      uiLanguage: stringAttr(this, \"ui-language\"),\n      direction: enumAttr(this, \"direction\", VALID_DIRECTIONS),\n      onStatusChange: (status) => {\n        this.dispatchEvent(\n          new CustomEvent(\"daba-status-change\", { detail: { status }, bubbles: true, composed: true }),\n        );\n      },\n      onTranscript: (role, text, isFinal) => {\n        this.dispatchEvent(\n          new CustomEvent(\"daba-transcript\", {\n            detail: { role, text, isFinal },\n            bubbles: true,\n            composed: true,\n          }),\n        );\n      },\n      onError: (error) => {\n        this.dispatchEvent(\n          new CustomEvent(\"daba-error\", { detail: { error }, bubbles: true, composed: true }),\n        );\n      },\n      onChatToggle: (isOpen) => {\n        this.dispatchEvent(\n          new CustomEvent(\"daba-chat-toggle\", { detail: { isOpen }, bubbles: true, composed: true }),\n        );\n      },\n      // Cards arrive once per reply that carried structured items, so a\n      // host page can render them in its own layout instead of (or as well\n      // as) the panel's — a listing site putting event cards on the page.\n      onCards: (cards) => {\n        this.dispatchEvent(\n          new CustomEvent(\"daba-cards\", { detail: { cards }, bubbles: true, composed: true }),\n        );\n      },\n    });\n  }\n\n  disconnectedCallback(): void {\n    if (this.agent) {\n      this.agent.destroy();\n      this.agent = null;\n    }\n  }\n\n  public get dabaAgent(): DabaAgent | null {\n    return this.agent;\n  }\n\n  public sendText(text: string): Promise<void> | undefined {\n    return this.agent?.sendText(text);\n  }\n\n  public openChat(): void {\n    this.agent?.openChat();\n  }\n\n  public closeChat(): void {\n    this.agent?.closeChat();\n  }\n\n  public toggleChat(): void {\n    this.agent?.toggleChat();\n  }\n}\n\nexport function defineDabaAgentElement(tagName = \"daba-agent\"): void {\n  if (typeof window !== \"undefined\" && typeof customElements !== \"undefined\") {\n    if (!customElements.get(tagName)) {\n      customElements.define(tagName, DabaAgentElement);\n    }\n  }\n}\n\ndefineDabaAgentElement();\n"]}