@syntrologie/adapt-chatbot 2.27.0 → 2.29.0

package/dist/AdaptiveChipsStrip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveChipsStrip.d.ts","sourceRoot":"","sources":["../src/AdaptiveChipsStrip.ts"],"names":[],"mappings":"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"}

package/dist/AdaptiveChipsStrip.js

@@ -0,0 +1,11 @@
+import {
+  AdaptiveChipsStrip,
+  SuggestionChipSchema
+} from "./chunk-OIGVZGSX.js";
+import "./chunk-EACGDSJI.js";
+import "./chunk-UVKRO5ER.js";
+export {
+  AdaptiveChipsStrip,
+  SuggestionChipSchema
+};
+//# sourceMappingURL=AdaptiveChipsStrip.js.map

package/dist/AdaptiveChipsStrip.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/AdaptiveChipsStripMountable.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AdaptiveChipsStripMountable — `MountableWidget` adapter for
+ * `<adaptive-chips-strip>`. Registered as widget id
+ * `adaptive-chatbot:chips-strip`.
+ *
+ * Mirrors `AdaptiveChatBarMountable`: creates the Lit element, forwards
+ * props, bridges DOM events → prop callbacks, cleans up on unmount.
+ *
+ * Props (passed via mountConfig):
+ *   - `chips: SuggestionChip[]` — the strip's contents (required)
+ *   - `onChipRevealed?: ({id, payload}) => void` — fires when a chip
+ *     is opened
+ *   - `onChipDismissed?: ({id}) => void` — fires when × is clicked
+ *
+ * The runtime registry injects `runtime` into mountConfig (see
+ * `WidgetRegistry.mount`). We forward it as `runtimeRef` on the strip
+ * so it can mount chip payload widgets through the same registry.
+ */
+import './AdaptiveChipsStrip';
+export declare const AdaptiveChipsStripMountable: {
+    mount(container: HTMLElement, mountConfig?: Record<string, unknown>): () => void;
+    update(container: HTMLElement, mountConfig?: Record<string, unknown>): void;
+};
+//# sourceMappingURL=AdaptiveChipsStripMountable.d.ts.map

package/dist/AdaptiveChipsStripMountable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveChipsStripMountable.d.ts","sourceRoot":"","sources":["../src/AdaptiveChipsStripMountable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,sBAAsB,CAAC;AA0C9B,eAAO,MAAM,2BAA2B;qBACrB,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,IAAI;sBAqC9D,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAqB5E,CAAC"}

package/dist/ChatAssistantLit.d.ts

@@ -11,20 +11,22 @@
  *    `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.
+ * 2. Cloudflare Turnstile bot-check token. When `TURNSTILE_SITEKEY` is
+ *    set, render a single `size: 'flexible'` widget with
+ *    `appearance: 'interaction-only'` against a `managed`-mode sitekey:
+ *      • Clean traffic: CF passive-grades silently, token resolves in
+ *        ~100ms, no UI is ever shown.
+ *      • Flagged traffic (datacenter IP, automation, strict-privacy):
+ *        CF renders an "I am human" checkbox inside the in-chat verify
+ *        panel; on solve, swap to the chat UI.
+ *      • Total failure (CSP blocks CF, network error, user dismisses):
+ *        fall through with no token; backend enforcement 403s and the
+ *        existing fallback card renders.
+ *    The widget mode MUST be `managed` on the CF side — see
+ *    cloudflare/turnstile/main.tf in syntro-infra. (`mode = 'invisible'`
+ *    rejects any `size` other than `invisible`, and `size: 'invisible'`
+ *    against `mode = 'managed'` fails with a synchronous TurnstileError —
+ *    don't mix.)
  *    If sitekey is empty, this step is skipped entirely.
  *
  * 3. Fallback card. If the first agent run fails (Cloudflare Turnstile
@@ -39,49 +41,19 @@
  *    inside the chat surface.
  */
 import '@syntrologie/chat';
-import type { ChatbotConfig, ChatbotWidgetRuntime } from './types.js';
+import type { ChatbotConfig, ChatbotFallback, ChatbotWidgetRuntime } from './types.js';
 export interface ChatAssistantLitProps {
     config: ChatbotConfig;
     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()`.
+ * Build the inline HTML for the fallback card. Customer-supplied copy wins;
+ * everything else falls back to generic copy. The card avoids any reference
+ * to Cloudflare or Turnstile so the end-user is never confronted with our
+ * implementation details.
  */
-export declare function acquireTurnstileToken(opts?: AcquireTurnstileOptions): Promise<string | null>;
+export declare function renderFallbackHtml(fallback: ChatbotFallback | undefined): string;
 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"ChatAssistantLit.d.ts","sourceRoot":"","sources":["../src/ChatAssistantLit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,OAAO,mBAAmB,CAAC;AAa3B,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,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;AA8CD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAiEhF;AAED,eAAO,MAAM,yBAAyB;qBACnB,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAqdpE,CAAC"}

package/dist/ChatAssistantLit.js

@@ -1,10 +1,13 @@
 import {
   ChatAssistantLitMountable,
-  acquireTurnstileToken
-} from "./chunk-W457NMGD.js";
+  renderFallbackHtml
+} from "./chunk-ZXV4GXMO.js";
+import "./chunk-EWPPVPJ4.js";
+import "./chunk-VZIUXXAM.js";
+import "./chunk-EACGDSJI.js";
 import "./chunk-UVKRO5ER.js";
 export {
   ChatAssistantLitMountable,
-  acquireTurnstileToken
+  renderFallbackHtml
 };
 //# sourceMappingURL=ChatAssistantLit.js.map

package/dist/ChatSession.d.ts

@@ -0,0 +1,239 @@
+/**
+ * ChatSession — singleton holder of the chat conversation state.
+ *
+ * The chat is conceptually one thing. Whether it's rendered in the
+ * mini-canvas's lid, the drawer's lid, or as a tile inside any slot,
+ * they're all VIEWS of the same conversation. This module owns that
+ * shared state.
+ *
+ * Why a module-level singleton (not on `runtime`):
+ *   - Per-page scope is the right granularity for a chat (one user,
+ *     one conversation, however many canvas instances on the page).
+ *   - Avoids a new SmartCanvasRuntime API surface for now. Easy to
+ *     promote to `runtime.chat` later without breaking the widget API.
+ *   - Module identity is stable per page; multiple imports return the
+ *     same instance.
+ *
+ * Separation of concerns:
+ *   - `ChatSession` owns state: messages, inFlight.
+ *   - Views (AdaptiveChatBar via AdaptiveChatBarMountable) subscribe
+ *     to state changes and dispatch user actions back via send() /
+ *     interrupt().
+ *   - Transports (the LLM call, SSE pipeline, stub timers) listen
+ *     for "send" / "interrupt" events and eventually call receive()
+ *     with the assistant's reply. Transports are NOT owned by this
+ *     module — adapters live separately.
+ *
+ * No persistence in this slice. Future: snapshot to runtime.state
+ * for cross-session continuity.
+ */
+import type { TrailMessage, TrailToolCall } from './AdaptiveChatTrail';
+export interface ChatSessionState {
+    readonly messages: readonly TrailMessage[];
+    readonly inFlight: boolean;
+    /**
+     * Latest reasoning narration from the model, streamed via the
+     * AG-UI `THINKING_TEXT_MESSAGE_CONTENT` channel. Empty string when
+     * no thinking turn is active. Consumers render this in place of
+     * the silent loading dots while the model decides what to do
+     * between tool calls. Cleared the moment a real text or tool-call
+     * event lands — at that point the model has switched to producing
+     * visible output and the narration is over.
+     */
+    readonly thinkingText: string;
+}
+export interface ToolResultEvent {
+    toolCallId: string;
+    result: unknown;
+    approved: boolean;
+}
+export type ChatSessionSubscriber = (state: ChatSessionState) => void;
+export type SendListener = (event: {
+    text: string;
+    id: string;
+    activeLidSlot?: string;
+    forwardedProps?: Record<string, unknown>;
+}) => void;
+export type InterruptListener = () => void;
+export type ToolResultListener = (event: ToolResultEvent) => void;
+/** Optional per-send envelope. */
+export interface SendOptions {
+    /**
+     * The slot the calling chat-bar lives in (e.g. ``"drawer"``,
+     * ``"adaptive-chat"``). Forwarded to transport listeners so the
+     * outbound request can tag the correct ``X-Active-Lid-Slot`` regardless
+     * of which bar most recently configured the singleton transport.
+     * Without per-send threading, two coexisting chat-bars race over the
+     * transport's cached ``activeLidSlot`` and the user-facing routing
+     * silently follows whichever bar configured last.
+     */
+    activeLidSlot?: string;
+    /**
+     * Merged into THIS request's forwardedProps only — never sticky. The
+     * transport spreads it over the config-level forwardedProps for the one
+     * AG-UI request this send produces (see ChatTransport). Used for turn
+     * provenance (`{ origin: TurnOrigin }`): a later typed message must not
+     * inherit it, or every message would look synthetic.
+     */
+    forwardedProps?: Record<string, unknown>;
+}
+export type Unsubscribe = () => void;
+export declare class ChatSession {
+    private _messages;
+    private _inFlight;
+    private _runActive;
+    private _thinkingText;
+    private _nextId;
+    private subscribers;
+    private sendListeners;
+    private interruptListeners;
+    private toolResultListeners;
+    /** Snapshot the current state. Always returns a fresh immutable view. */
+    getState(): ChatSessionState;
+    /**
+     * Append a delta to the active thinking turn's narration buffer.
+     * Forwarded from the AG-UI THINKING_TEXT_MESSAGE_CONTENT event so
+     * the chat trail can render the model's own reasoning instead of
+     * silent loading dots between turns.
+     */
+    appendThinkingDelta(delta: string): void;
+    /**
+     * Replace the active thinking narration outright (vs. appendThinkingDelta's
+     * streaming accumulation). Used to surface tool-call progress — e.g.
+     * "Searching…" while the agent works a tool — so a long tool phase shows
+     * what's happening instead of silent dots. No-op if unchanged.
+     */
+    setThinkingText(text: string): void;
+    /**
+     * End the active thinking turn — drop any narration so the trail
+     * stops showing it. Fires on real text-message-start and on
+     * tool-call-start, the moment the model switches from reasoning
+     * to visible output.
+     */
+    clearThinking(): void;
+    setRunActive(active: boolean): void;
+    /**
+     * Subscribe to state changes. Called immediately with the current
+     * state, then again on every change. Returns an unsubscribe function.
+     */
+    subscribe(cb: ChatSessionSubscriber): Unsubscribe;
+    /**
+     * User submitted a message. Appends a user-role message, sets
+     * inFlight=true, notifies state subscribers, and fires a "send"
+     * event so transports can pick it up. Empty/whitespace text is a
+     * no-op (matches the chat bar's local guard).
+     */
+    send(text: string, opts?: SendOptions): void;
+    /**
+     * Single-shot assistant reply (no streaming). Equivalent to
+     * receiveStart + receiveDelta + receiveEnd in one call. Useful for
+     * stub transports and tests that don't model streaming.
+     */
+    receive(text: string): void;
+    /**
+     * Begin a streaming assistant message. Appends an empty assistant
+     * message with status='streaming'. Caller (transport adapter) feeds
+     * deltas via receiveDelta(id, text) and signals completion via
+     * receiveEnd(id). `inFlight` stays true through the stream.
+     */
+    receiveStart(id: string): void;
+    /**
+     * Append a delta to a streaming message. No-op when the id is
+     * unknown (race between transport events and reset, etc.) — never
+     * throws so transports can fire-and-forget.
+     */
+    receiveDelta(id: string, delta: string): void;
+    /**
+     * Mark a streaming message complete and clear inFlight. No-op when
+     * the id is unknown (defensive against transport double-fires).
+     */
+    receiveEnd(id: string): void;
+    /**
+     * Transport reports a fatal error. Marks any in-flight streaming
+     * message as 'error' (so the trail can render a styled error chip
+     * instead of pretending the partial text was a complete answer),
+     * appends a system-role message with the error text for visibility,
+     * and clears inFlight. Also drops any pending thinking narration
+     * — leaving stale "Let me check…" alongside an error chip reads
+     * as if the assistant is still working when it isn't.
+     */
+    error(message: string): void;
+    /**
+     * User clicked the in-flight stop button. Clears inFlight and
+     * fires an "interrupt" event so transports can cancel their
+     * in-flight request. No-op if not in-flight (idempotent). Drops
+     * any pending thinking narration for the same reason as error():
+     * the visitor explicitly asked the assistant to stop, so it
+     * shouldn't keep narrating in the trail.
+     */
+    interrupt(): void;
+    /**
+     * Wipe state. Used by the canvas-close path (start a fresh
+     * conversation next time) and by tests.
+     */
+    reset(): void;
+    /** Register a transport's send listener. Returns unsubscribe. */
+    onSend(listener: SendListener): Unsubscribe;
+    /**
+     * True when at least one transport has wired itself to the session's
+     * send pipeline. Views can use this to surface "no chat backend
+     * connected" affordances instead of hanging in `inFlight` after a
+     * send fires into the void.
+     */
+    hasTransport(): boolean;
+    /** Register a transport's interrupt listener. Returns unsubscribe. */
+    onInterrupt(listener: InterruptListener): Unsubscribe;
+    /**
+     * Register a transport's tool-result listener. The transport
+     * forwards `tool-result` actions back to the agent after the user
+     * approves or rejects a client-tool call. Returns unsubscribe.
+     */
+    onToolResult(listener: ToolResultListener): Unsubscribe;
+    /**
+     * Attach a tool call to a streaming assistant message. No-op when
+     * the message id is unknown (race between transport events and
+     * reset / late mount).
+     */
+    addToolCall(messageId: string | number, toolCall: TrailToolCall): void;
+    /**
+     * Partially update a tool call by id. Used by the transport to
+     * advance status (args-streaming → running → done) as AG-UI events
+     * arrive. No-op when the id is unknown.
+     */
+    updateToolCall(toolCallId: string, patch: Partial<TrailToolCall>): void;
+    /**
+     * Resolve a (client-) tool call. Marks the call done, persists, and
+     * fires onToolResult so the transport can forward the result + the
+     * user's approve/reject decision back to the agent. No-op when the
+     * id is unknown.
+     */
+    resolveToolCall(toolCallId: string, result: unknown, approved: boolean): void;
+    /**
+     * Hydrate from the server transcript (the /session SSE's
+     * messages-snapshot) — the server is the transcript of record
+     * (FEAT-1783701440). Snapshot order is truth: shared ids keep the
+     * LOCAL object (it may carry richer live tool-call state) but take the
+     * snapshot's position; snapshot-only messages (history on reload, a
+     * nudge missed during an SSE gap) are inserted; local-only messages
+     * (an in-flight turn, the greeting) float after in local order.
+     *
+     * Deploy-boundary guard: a user message persisted under a pre-Phase-2
+     * transport id (before ids were threaded) would arrive as
+     * "snapshot-only" next to its local twin — skip snapshot USER messages
+     * whose exact text already exists locally under a different id.
+     */
+    hydrate(snapshotMessages: TrailMessage[]): void;
+    private notify;
+}
+/**
+ * The module-level singleton. Every `<adaptive-chat-bar>` (regardless
+ * of which slot it lives in) reads from and writes to this instance.
+ * Multiple imports of this module return the same object.
+ *
+ * Scope: per-page. Correct for the canonical case (one user, one
+ * conversation, however many canvas views surface it). Multiple
+ * `<smart-canvas>` instances on the same page will share state —
+ * tracked in project_future_work.md for per-runtime scoping.
+ */
+export declare const chatSession: ChatSession;
+//# sourceMappingURL=ChatSession.d.ts.map

package/dist/ChatSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSession.d.ts","sourceRoot":"","sources":["../src/ChatSession.ts"],"names":[],"mappings":"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"}