@syntrologie/adapt-chatbot 2.25.2 → 2.27.0

package/dist/ChatAssistantLit.d.ts

@@ -2,11 +2,41 @@
  * Adaptive Chatbot — Lit Mountable
  *
  * Thin wrapper that mounts <syntro-chat> from @syntrologie/chat with an
- * SsePostTransport pointed at the adaptive SSE backend.
+ * AgUiTransport pointed at the adaptive AG-UI streaming endpoint.
  *
- * The old hand-rolled ChatAssistantElement (Lit component with inline
- * styles, message management, and action parsing) is fully replaced by
- * the shared @syntrologie/chat package.
+ * Four pieces this mountable owns:
+ *
+ * 1. SDK token plumbing. The chat backend (`/api/adaptive/*`) is identified
+ *    by the workspace's `syn_*` SDK token. The token lives on
+ *    `window.__SYNTRO_CONFIG__.token` (set by runtime-config.js) — we read
+ *    it at mount time and forward it via `Authorization: Bearer` header.
+ *
+ * 2. Cloudflare Turnstile bot-check token (two-phase). When
+ *    `TURNSTILE_SITEKEY` is set:
+ *      a. Try invisible first — passive fingerprints, no UI. Clean
+ *         traffic resolves in milliseconds. Token forwarded via
+ *         `CF-Turnstile-Token`.
+ *      b. If CF declines to grant silently (datacenter IP, automation
+ *         signals, strict-privacy browser), render a visible managed
+ *         widget inside the chat container so CF can present the
+ *         "I am human" checkbox. On solve, swap to the chat UI.
+ *      c. If both phases fail, fall through with no token; backend
+ *         enforcement returns 403 and the existing fallback card
+ *         renders. The widget mode must be `managed` on the CF side
+ *         for the visible escalation to work — see
+ *         cloudflare/turnstile/main.tf in syntro-infra.
+ *    If sitekey is empty, this step is skipped entirely.
+ *
+ * 3. Fallback card. If the first agent run fails (Cloudflare Turnstile
+ *    bot-check failure, CORS / network error, or a server-side rejection),
+ *    swap the chat UI for a per-customer fallback card built from
+ *    `props.fallback`. The end-user is redirected to the customer's normal
+ *    support path instead of seeing a raw error.
+ *
+ * 4. A2UI passthrough. AG-UI CUSTOM events carrying A2UI payloads
+ *    (createSurface, updateDataModel, …) get forwarded to
+ *    `runtime.actions.applyBatch` so tiles can render server-driven UI
+ *    inside the chat surface.
  */
 import '@syntrologie/chat';
 import type { ChatbotConfig, ChatbotWidgetRuntime } from './types.js';
@@ -15,6 +45,43 @@ export interface ChatAssistantLitProps {
     runtime: ChatbotWidgetRuntime;
     tileId?: string;
 }
+export interface AcquireTurnstileOptions {
+    /**
+     * Widget size. `invisible` for the silent first attempt; `flexible`
+     * (or `normal`) for the visible managed checkbox after silent failure.
+     */
+    size: 'invisible' | 'flexible' | 'normal' | 'compact';
+    /**
+     * Where to mount the widget. For `invisible` this is an off-screen
+     * host; for the visible sizes it must be a container that's actually
+     * in the layout so CF can render the challenge UI. When omitted, an
+     * off-screen div is created and removed automatically (suitable for
+     * `invisible` only — visible sizes need a real host).
+     */
+    host?: HTMLElement;
+    /**
+     * Cancels an in-flight acquisition. On abort, the promise resolves to
+     * `null`, the CF widget is removed from the registry, and any owned
+     * host is torn down. Required for cleanup-during-challenge — without
+     * it, a user dismissing the tile mid-checkbox leaks the widget.
+     */
+    signal?: AbortSignal;
+}
+/**
+ * Acquire a Cloudflare Turnstile token. Returns null when:
+ *   • TURNSTILE_SITEKEY is empty (Turnstile disabled at build time)
+ *   • the script fails to load (customer CSP blocks Cloudflare, etc.)
+ *   • the render callback doesn't fire within TURNSTILE_ACQUIRE_TIMEOUT_MS
+ *   • Cloudflare returns an error-callback (e.g., rate-limited, bad sitekey)
+ *
+ * Calls `turnstile.remove(widgetId)` on settle so CF's internal widget
+ * registry doesn't leak across re-mounts (CF will otherwise log
+ * `Cannot find Widget ...` when subsequent renders look up the old
+ * widget by id and find the host gone).
+ *
+ * Exported for tests; the production code path goes through `mount()`.
+ */
+export declare function acquireTurnstileToken(opts?: AcquireTurnstileOptions): Promise<string | null>;
 export declare const ChatAssistantLitMountable: {
     mount(container: HTMLElement, mountConfig?: Record<string, unknown>): () => void;
 };

package/dist/ChatAssistantLit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatAssistantLit.d.ts","sourceRoot":"","sources":["../src/ChatAssistantLit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,mBAAmB,CAAC;AAI3B,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEtE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,yBAAyB;qBACnB,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAsDpE,CAAC"}
+{"version":3,"file":"ChatAssistantLit.d.ts","sourceRoot":"","sources":["../src/ChatAssistantLit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,aAAa,EAAmB,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAqGD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtD;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,GAAE,uBAA+C,GACpD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkFxB;AAqGD,eAAO,MAAM,yBAAyB;qBACnB,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAwPpE,CAAC"}

package/dist/ChatAssistantLit.js

@@ -1,8 +1,10 @@
 import {
-  ChatAssistantLitMountable
-} from "./chunk-FI7F22ED.js";
-import "./chunk-V6TY7KAL.js";
+  ChatAssistantLitMountable,
+  acquireTurnstileToken
+} from "./chunk-W457NMGD.js";
+import "./chunk-UVKRO5ER.js";
 export {
-  ChatAssistantLitMountable
+  ChatAssistantLitMountable,
+  acquireTurnstileToken
 };
 //# sourceMappingURL=ChatAssistantLit.js.map

package/dist/{chunk-V6TY7KAL.js → chunk-UVKRO5ER.js}

@@ -1,8 +1,13 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 export {
+  __export,
   __publicField
 };
-//# sourceMappingURL=chunk-V6TY7KAL.js.map
+//# sourceMappingURL=chunk-UVKRO5ER.js.map