@syntrologie/adapt-chatbot 2.25.2 → 2.26.0

package/dist/ChatAssistantLit.d.ts

@@ -2,11 +2,33 @@
  * 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. When `TURNSTILE_SITEKEY` is set
+ *    (hardcoded at the top of this file — operator updates after running
+ *    terraform apply on cloudflare/turnstile in the infra repo), the
+ *    widget dynamically loads Cloudflare's Turnstile JS, renders an
+ *    invisible widget, and acquires a token before the first message.
+ *    The token is forwarded via `CF-Turnstile-Token` header.
+ *    If sitekey is empty (default), 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 +37,21 @@ export interface ChatAssistantLitProps {
     runtime: ChatbotWidgetRuntime;
     tileId?: string;
 }
+/**
+ * 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)
+ *
+ * When null is returned, the widget proceeds WITHOUT a Turnstile token.
+ * If backend enforcement is on, the request 403s and the fallback card
+ * renders via the existing failure-detection path. If enforcement is off,
+ * the request succeeds.
+ *
+ * Exported for tests; the production code path goes through `mount()`.
+ */
+export declare function acquireTurnstileToken(): 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;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;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkDpE;AAiGD,eAAO,MAAM,yBAAyB;qBACnB,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA2LpE,CAAC"}

package/dist/ChatAssistantLit.js

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