@dabalabs/agent 0.0.1-beta → 0.0.4-beta

package/dist/react.cjs

@@ -1,21 +1,48 @@
 'use strict';
 
-var chunkZXZX2D55_cjs = require('./chunk-ZXZX2D55.cjs');
-require('./chunk-N4TBGDUO.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 chunkZXZX2D55_cjs.DabaAgentComponent; }
-});
-Object.defineProperty(exports, "DabaAgentComponent", {
-  enumerable: true,
-  get: function () { return chunkZXZX2D55_cjs.DabaAgentComponent; }
-});
-Object.defineProperty(exports, "DabaAgentReact", {
-  enumerable: true,
-  get: function () { return chunkZXZX2D55_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-DYRGPzyp.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-DYRGPzyp.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-QM6HDEVV.js';
-import './chunk-G22V7GGM.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-BQRgqD4n.d.cts

@@ -0,0 +1,305 @@
+/**
+ * Which deployment tier this widget talks to.
+ *
+ * Production is the default in every direction: an embed that says
+ * nothing about its environment is a customer's live site, and the one
+ * outcome worth engineering against is a production page silently
+ * pointing at staging. So the mapping is deliberately asymmetric —
+ * "staging" must be asked for by name, and anything else resolves to
+ * production.
+ */
+type DabaEnvironment = "production" | "staging";
+
+type DabaVoiceEngine = "realtime" | "live";
+type DabaErrorKind = "invalid_key" | "origin_not_allowed" | "not_found" | "network" | "restricted";
+interface DabaError {
+    kind: DabaErrorKind;
+    message: string;
+}
+/** "listening" = mic capturing, "thinking" = waiting on a model turn,
+ * "speaking" = agent audio playing back, "idle" = session not active.
+ * Text chat uses "thinking" and "idle" only — it never opens a mic. */
+type DabaAgentStatus = "idle" | "connecting" | "listening" | "thinking" | "speaking";
+/** Which viewport corner the default floating badge is pinned to. Only
+ * applies to the default badge (no custom `container`) — a host handing
+ * in its own `container` owns that element's placement entirely. */
+type DabaAgentPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";
+/**
+ * Which media the assistant offers.
+ *
+ * - "voice"  — talk only. Badge click starts/stops a Realtime session.
+ * - "chat"   — type only. No microphone is ever requested.
+ * - "hybrid" — both, in one panel, sharing one transcript.
+ *
+ * These are genuinely independent transports, not one feature with a
+ * switch: chat is a plain HTTP turn against the gateway, voice is a
+ * Realtime WebSocket with a mic. A visitor in "chat" mode never grants
+ * microphone permission and never costs a voice minute.
+ */
+type DabaAgentMode = "hybrid" | "voice" | "chat";
+/** Text direction of the widget's own chrome. "auto" reads the host
+ * page's `dir`/`lang`, which is what makes the panel flip to RTL on an
+ * Arabic site without the integrator configuring anything. */
+type DabaDirection = "auto" | "ltr" | "rtl";
+type DabaThemePreference = "auto" | "light" | "dark";
+type DabaLauncherShape = "rounded" | "circle" | "pill";
+/** What a card is about. Drives the icon, the accent and which fields the
+ * card bothers to render — an event shows a date and a map link, an
+ * article shows a date and a read-more link. Unknown kinds render as
+ * "page", never as nothing. */
+type DabaCardKind = "article" | "event" | "news" | "page" | "contact" | "action";
+interface DabaCardMeta {
+    label: string;
+    value: string;
+}
+/**
+ * One structured item in a reply — an event, an article, a news item.
+ *
+ * The gateway builds and sanitises these (see routes/public_agents.rs::
+ * sanitize_cards): `mapUrl` is always constructed server-side from the
+ * address, and `url`/`imageUrl` are dropped unless they point at the
+ * site the widget is embedded in. So the widget can render every field
+ * here without re-validating it.
+ */
+interface DabaCard {
+    kind: DabaCardKind;
+    title: string;
+    summary?: string | null;
+    /** ISO-8601 date or datetime. Formatted for display with `Intl` in the
+     * resolved UI locale, so an Arabic panel shows an Arabic date. */
+    date?: string | null;
+    endDate?: string | null;
+    locationName?: string | null;
+    address?: string | null;
+    /** Always gateway-built from the address — never whatever the model said. */
+    mapUrl?: string | null;
+    url?: string | null;
+    imageUrl?: string | null;
+    sourcePath?: string | null;
+    meta?: DabaCardMeta[];
+}
+interface ChatMessage {
+    id: string;
+    role: "user" | "agent" | "system";
+    text: string;
+    timestamp: number;
+    isFinal?: boolean;
+    cards?: DabaCard[];
+    suggestions?: string[];
+}
+/**
+ * Colour and shape overrides. Every field is optional and every absent
+ * field falls back to the DabaLabs brand kit, so `{}` is a complete,
+ * correct theme rather than an empty one.
+ */
+interface DabaTheme {
+    accentColor?: string;
+    /** Text/icon colour drawn ON the accent. Defaults to white; a site with
+     * a pale accent needs to be able to say "ink", or its buttons are
+     * illegible. */
+    accentContrast?: string;
+    surfaceColor?: string;
+    textColor?: string;
+    mutedColor?: string;
+    borderColor?: string;
+    /** Any CSS length — "18px", "0", "1.5rem". */
+    radius?: string;
+    fontFamily?: string;
+    theme?: DabaThemePreference;
+}
+/** The panel shown on first open, before anybody has said anything. */
+interface DabaIntro {
+    enabled?: boolean;
+    headline?: string | null;
+    subheadline?: string | null;
+    /** A short looping video or a still. Same-origin or https. */
+    mediaUrl?: string | null;
+    mediaType?: "video" | "image" | "none";
+    /** Tappable starter questions. These are what turn an empty box into an
+     * obvious next action, and they are the single biggest lever on whether
+     * a visitor ever sends a first message. */
+    suggestedPrompts?: string[];
+}
+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;
+    apiKey: string;
+    /** 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"
+     * to point the agent at the staging gateway. */
+    env?: DabaEnvironment;
+    /** Where to mount the widget. Defaults to a fixed-position element
+     * appended to <body> when omitted. */
+    container?: string | HTMLElement;
+    /** Corner of the viewport the default badge is fixed to. */
+    position?: DabaAgentPosition;
+    /**
+     * Everything below is an OVERRIDE of what the project already carries.
+     *
+     * The gateway serves a project's mode, theme, intro and locale from
+     * `GET /v1/public/agents/:id`, so an owner restyles their assistant
+     * from the dashboard and every embed picks it up on next load. An
+     * option passed here wins over the served value — an integrator who
+     * hard-codes a colour means it.
+     *
+     * Undefined is not "default", it is "defer to the server". That
+     * distinction is what makes remote configuration work at all.
+     */
+    mode?: DabaAgentMode;
+    voiceEngine?: DabaVoiceEngine;
+    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. */
+    uiLanguage?: string;
+    direction?: DabaDirection;
+    accentColor?: string;
+    /** Recolour the trigger icon's background substrate (the colour under
+     * the grain/noise texture). Defaults to the icon's shipped green. */
+    iconBackgroundColor?: string;
+    /** Recolour the trigger icon's centre mark (the face/mask shape). */
+    iconMarkColor?: string;
+    /** Header title displayed in the chat window. Defaults to the project's
+     * title, then to a localised "AI Assistant". */
+    title?: string;
+    placeholder?: string;
+    /** Whether the chat popover starts open. */
+    initialOpen?: boolean;
+    /**
+     * 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;
+    /** Fired for both user speech/text and agent reply deltas. */
+    onTranscript?: (role: "user" | "agent", text: string, isFinal: boolean) => void;
+    onChatToggle?: (isOpen: boolean) => void;
+    /** Fired once per reply that carried structured items. */
+    onCards?: (cards: DabaCard[]) => void;
+}
+/**
+ * What the gateway serves for a project. Mirrors the JSON of
+ * `GET /v1/public/agents/:id` with keys camelised; every field is present
+ * because the gateway fills its own defaults before responding.
+ */
+interface DabaRemoteConfig {
+    projectId: string;
+    title: string;
+    greetingMessage: string | null;
+    mode: DabaAgentMode;
+    voiceEngine?: DabaVoiceEngine;
+    appearance: {
+        accentColor: string | null;
+        accentContrast: string | null;
+        surfaceColor: string | null;
+        textColor: string | null;
+        radius: string | null;
+        fontFamily: string | null;
+        logoUrl: string | null;
+        launcherIconUrl: string | null;
+        launcherLabel: string | null;
+        launcherShape: DabaLauncherShape;
+        position: DabaAgentPosition | null;
+        theme: DabaThemePreference;
+    };
+    intro: {
+        enabled: boolean;
+        headline: string | null;
+        subheadline: string | null;
+        mediaUrl: string | null;
+        mediaType: "video" | "image" | "none";
+        suggestedPrompts: string[];
+    };
+    locale: {
+        uiLanguage: string;
+        direction: DabaDirection;
+    };
+}
+/** One text turn, as the chat endpoint returns it. */
+interface DabaChatReply {
+    reply: string;
+    language: string;
+    cards: DabaCard[];
+    /** Follow-up questions the assistant thinks are likely next. Rendered as
+     * tappable chips under the reply; tapping one sends it. */
+    suggestions: string[];
+    conversationId: string;
+}
+
+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 };