@syntrologie/adapt-chatbot 2.8.0-canary.43 → 2.8.0-canary.431

package/dist/AdaptiveChatBar.d.ts

@@ -0,0 +1,175 @@
+/**
+ * AdaptiveChatBar — the canvas lid composition for the chat-canvas
+ * experience. Renders the bubble-up trail on top and an always-visible
+ * input row below.
+ *
+ * Wiring contract (events out):
+ *   - `chat-message-sent` ({ text }): the user submitted text via Enter
+ *     or the send button. The owning code is responsible for pushing
+ *     this into the conversation history and producing a reply.
+ *
+ * Wiring contract (props in):
+ *   - `messages`: the conversation trail, passed straight through to
+ *     `<adaptive-chat-trail>`.
+ *   - `placeholder`: input placeholder copy. Defaults to a generic
+ *     "Ask, find, or navigate…" — the host (typically the slot's lid
+ *     widget mount) can override to a context-specific string.
+ *
+ * Light DOM. Glassmorphism is applied at the input-row level so the
+ * trail above floats over the host page without chrome. See PRD §4.4.
+ */
+import { LitElement } from 'lit';
+import './AdaptiveChatTrail.js';
+import type { InlineTrailWidget, InlineWidgetMounter, TileReceipt, TrailMessage } from './AdaptiveChatTrail.js';
+export declare class AdaptiveChatBar extends LitElement {
+    static properties: {
+        messages: {
+            attribute: boolean;
+        };
+        placeholder: {
+            type: StringConstructor;
+        };
+        assistantName: {
+            type: StringConstructor;
+        };
+        greeting: {
+            type: StringConstructor;
+        };
+        inFlight: {
+            type: BooleanConstructor;
+            reflect: boolean;
+        };
+        thinkingText: {
+            attribute: boolean;
+        };
+        introSuggestion: {
+            attribute: boolean;
+        };
+        forceExpanded: {
+            type: BooleanConstructor;
+            reflect: boolean;
+        };
+        maximized: {
+            type: BooleanConstructor;
+        };
+        tileReceipts: {
+            attribute: boolean;
+        };
+        inlineWidgets: {
+            attribute: boolean;
+        };
+        mountInlineWidget: {
+            attribute: boolean;
+        };
+        _input: {
+            state: boolean;
+        };
+    };
+    messages: TrailMessage[];
+    maximized: boolean;
+    tileReceipts: TileReceipt[];
+    /** Widgets rendered inline in the trail (reco carousel), sourced from
+     *  the store's `chat-inline` slot mounts. Forwarded to the trail. */
+    inlineWidgets: InlineTrailWidget[];
+    /** Registry-backed mounter for inline widgets whose id is not their
+     *  custom-element tag (product card, comparison, FAQ). Set by the
+     *  mountable from `runtime.widgets`; forwarded to the trail. */
+    mountInlineWidget: InlineWidgetMounter | undefined;
+    /**
+     * Live reasoning narration from the model — streamed in via
+     * AG-UI THINKING_TEXT_MESSAGE_CONTENT events and forwarded by
+     * the ChatSession subscription on the host (mountable).
+     * Forwarded verbatim to the trail, which renders it in place of
+     * the silent loading dots between turns. Empty string when no
+     * thinking turn is active.
+     */
+    thinkingText: string;
+    /**
+     * Pre-conversation suggestion button — forwarded to the trail's
+     * empty-state pane. When the visitor clicks it the trail emits
+     * `trail-intro-suggestion`; we catch that here and submit the
+     * configured prompt through the normal send path.
+     */
+    introSuggestion: {
+        label: string;
+        prompt: string;
+    } | undefined;
+    /** Pass-through to {@link AdaptiveChatTrail}'s ``forceExpanded`` prop.
+     *  Hosts that mount the chat-bar in a full-screen surface (mobile
+     *  panel, agent app, etc.) set this to skip the collapse affordance
+     *  — there is no smaller state to fall back to. */
+    forceExpanded: boolean;
+    placeholder: string;
+    /**
+     * Name shown in the (forceExpanded) header. Defaults to a generic
+     * "Assistant". Hosts can override per-workspace (e.g. Vela sets
+     * "Vela Concierge") without inventing new SDK surface — it threads
+     * through the same mount config the placeholder does.
+     */
+    assistantName: string;
+    /**
+     * Initial assistant message shown before any real conversation
+     * starts. Renders inside the trail as a phantom assistant chip
+     * when messages.length === 0; auto-disappears as soon as the
+     * first user message lands. Mirrors ChatAssistantLit's greeting.
+     */
+    greeting: string | undefined;
+    /**
+     * Whether a chat round-trip is in flight (request sent, awaiting
+     * reply). The single send/stop button morphs accordingly: ↑ when
+     * ready, ⏹ when in-flight. Parent owns this state — set true after
+     * `chat-message-sent` fires, false when the reply lands or the
+     * request is aborted. Enter is inert while in-flight.
+     */
+    inFlight: boolean;
+    _input: string;
+    createRenderRoot(): HTMLElement;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _onInput;
+    private _onKeyDown;
+    private _onSendOrInterrupt;
+    private _onTileReceiptActivate;
+    private _onAlertReceiptActivate;
+    private _onMaximizeToggle;
+    private _send;
+    /**
+     * Visitor tapped the intro suggestion button in the empty-state
+     * trail. Submit the configured prompt through the same channel as
+     * a typed message so listeners (mountable → chatSession.send) see
+     * a uniform shape — no need for a parallel "suggestion-sent" path.
+     * The trail's intro pane auto-disappears the moment the first
+     * message lands, so this also closes the empty state in one go.
+     */
+    private _onIntroSuggestion;
+    /**
+     * Reply-chip tap that arrived during the run TAIL. Chips render the
+     * moment the reply text lands, but `inFlight` (which includes
+     * `runActive` — typing events, tool tail, RUN_FINISHED) can lag for
+     * seconds. The old `if (this.inFlight) return;` guard silently ATE
+     * those taps — the visitor's chosen reply never appeared as their
+     * message (live repro, deployed vela 2026-07-08). Now the tap queues
+     * (latest wins) and dispatches when `inFlight` clears.
+     */
+    private _queuedSuggestedReply;
+    protected willUpdate(changed: Map<string, unknown>): void;
+    /**
+     * Visitor tapped an inline `suggest_replies` chip in the trail. Submit
+     * the chip text through the SAME `chat-message-sent` channel a typed
+     * message uses, so the reply rides the existing send path (mountable →
+     * chatSession.send → transport) — no fabricated AG-UI events. The
+     * trail clears the chips on its own once the reply lands and a newer
+     * assistant turn becomes the latest.
+     *
+     * A tap while the previous run is still closing is QUEUED, never
+     * dropped — see `_queuedSuggestedReply`.
+     */
+    private _onSuggestedReply;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'adaptive-chat-bar': AdaptiveChatBar;
+    }
+}
+//# sourceMappingURL=AdaptiveChatBar.d.ts.map

package/dist/AdaptiveChatBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveChatBar.d.ts","sourceRoot":"","sources":["../src/AdaptiveChatBar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAGhD,OAAO,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,YAAY,EACb,MAAM,wBAAwB,CAAC;AAMhC,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,OAAgB,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAcxB;IAEF,QAAQ,EAAE,YAAY,EAAE,CAAM;IAC9B,SAAS,UAAS;IAClB,YAAY,EAAE,WAAW,EAAE,CAAM;IACjC;yEACqE;IACrE,aAAa,EAAE,iBAAiB,EAAE,CAAM;IACxC;;oEAEgE;IAChE,iBAAiB,EAAE,mBAAmB,GAAG,SAAS,CAAa;IAE/D;;;;;;;OAOG;IACH,YAAY,SAAM;IAClB;;;;;OAKG;IACH,eAAe,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAa;IAE3E;;;uDAGmD;IACnD,aAAa,UAAS;IACtB,WAAW,SAAuB;IAClC;;;;;OAKG;IACH,aAAa,SAA0B;IACvC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAa;IACzC;;;;;;OAMG;IACH,QAAQ,UAAS;IACjB,MAAM,SAAM;IAEH,gBAAgB,IAAI,WAAW;IAI/B,iBAAiB,IAAI,IAAI;IASzB,oBAAoB,IAAI,IAAI;IAYrC,OAAO,CAAC,QAAQ,CAEd;IAEF,OAAO,CAAC,UAAU,CAShB;IAKF,OAAO,CAAC,kBAAkB,CAUxB;IAEF,OAAO,CAAC,sBAAsB,CAM5B;IAEF,OAAO,CAAC,uBAAuB,CAK7B;IAEF,OAAO,CAAC,iBAAiB,CAEvB;IAEF,OAAO,CAAC,KAAK;IAwBb;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB,CAmBxB;IAEF;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB,CAAuB;cAEjC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAsBlE;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB,CAoBvB;IAEO,MAAM;CAkDhB;AA8OD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,eAAe,CAAC;KACtC;CACF"}

package/dist/AdaptiveChatBar.js

@@ -0,0 +1,11 @@
+import {
+  AdaptiveChatBar
+} from "./chunk-5W75LR6M.js";
+import "./chunk-EWPPVPJ4.js";
+import "./chunk-HVGQJZMP.js";
+import "./chunk-7WSMNAKW.js";
+import "./chunk-UVKRO5ER.js";
+export {
+  AdaptiveChatBar
+};
+//# sourceMappingURL=AdaptiveChatBar.js.map

package/dist/AdaptiveChatBar.js.map

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

package/dist/AdaptiveChatBarMountable.d.ts

@@ -0,0 +1,80 @@
+/**
+ * AdaptiveChatBarMountable — `MountableWidget` adapter that turns the
+ * standalone `<adaptive-chat-bar>` Lit element into something the
+ * runtime widget registry can mount.
+ *
+ * Registered as widget id `adaptive-chatbot:chat-bar`. Customers
+ * reference it from canvas config — either as a slot's `lid` widget
+ * (replaces the launcher when referenced from `slots.drawer.lid`) or
+ * as a regular tile widget.
+ *
+ * The bar is a VIEW. State lives in the singleton `chatSession` —
+ * whether the bar mounts in the mini-canvas lid, the drawer lid, or
+ * both, they're all views of the same conversation. The mountable:
+ *   - subscribes to chatSession.subscribe() and pushes state into
+ *     the bar's `messages` + `inFlight` props on every change
+ *   - routes the bar's `chat-message-sent` event → chatSession.send()
+ *   - routes the bar's `chat-interrupt` event → chatSession.interrupt()
+ *   - bubbles the bar's `canvas-close` event → optional onClose
+ *     callback (canvas-level concern, not session-level)
+ *
+ * Props (passed via mountConfig):
+ *   - `placeholder?: string` — input placeholder copy
+ *   - `onClose?: () => void` — fires on ✕ click (canvas-level)
+ *
+ * Note: messages and inFlight are NOT props. They flow from chatSession.
+ * A canvas-config author who wants to pre-seed messages should do so
+ * via the session directly (e.g. via a startup action) — but typical
+ * use is to let the conversation start empty.
+ */
+import './AdaptiveChatBar';
+import { type ProductIdentityExtractor } from '@syntrologie/sdk-contracts';
+import type { ObservationEvent, RawEvent } from './observer/allowlist';
+import type { ChatbotWidgetRuntime } from './types.js';
+/**
+ * Test-only: drop the warm store singleton (and its hydration latch) so each
+ * test can wire a fresh store to its own event bus / registry. Without this,
+ * the first test in a file permanently binds the store to ITS bus and the
+ * per-instance version dedup silently drops every later test's re-mounts.
+ * Mirrors `observer/index.ts` `_resetObserverForTests`.
+ */
+export declare function _resetElementStoreForTests(): void;
+export declare function resolveTileWidget(templateId: string): string | undefined;
+export declare function refreshTemplateWidgetMap(uiTemplates: Record<string, unknown> | undefined): void;
+/**
+ * Observation enrichment (exported for direct testing).
+ *
+ * Two passes through the SAME platform-adapter extractor:
+ *   1. clicks — resolve product identity from the clicked element chain
+ *      (original behavior, unchanged);
+ *   2. page-level signals (view/scroll/idle/hesitation/hover/nav) with no
+ *      product — resolve the CURRENT page's product by feeding the extractor
+ *      a synthetic chain element carrying `location.pathname`. Live-verified
+ *      gap (FEAT-1783640628): a visitor ON a PDP produces section views with
+ *      no product identity, which starved every product-shaped downstream
+ *      (nudge ping-pong detection, the agent's "viewed <product>" context).
+ */
+export declare function buildObserverEnrich(runtimeRef: {
+    getProductIdentity?: ProductIdentityExtractor;
+}): (ev: ObservationEvent, raw: RawEvent) => ObservationEvent;
+/**
+ * Surface reaction to a proactive nudge (FEAT-1783640628). The transport
+ * settles the nudge message into the trail and emits `syntro:nudge`; this
+ * layer owns what the VISITOR notices on top of that:
+ *   1. refresh persisted mounts — the headless turn's mount landed server-side
+ *      in `mounted_elements`; re-running the replay fetch applies it live
+ *      through the same hydrate path boot uses (no parallel mount wire shape);
+ *   2. a toast via the canvas overlay's notification primitive, so a visitor
+ *      with the chat closed learns the agent spoke.
+ *
+ * Exported for direct testing (real DOM listener, fetch-stubbed network).
+ */
+export declare function wireNudgeSurface(runtime: ChatbotWidgetRuntime, backendUrl: string): void;
+/** Test seam: reset the nudge-surface once-guard AND detach the listener. */
+export declare function _resetNudgeSurfaceForTests(): void;
+export declare function _resetMountableObserverForTests(): void;
+export declare const AdaptiveChatBarMountable: {
+    mount(container: HTMLElement, mountConfig?: Record<string, unknown>): () => void;
+    update(container: HTMLElement, mountConfig?: Record<string, unknown>): void;
+};
+//# sourceMappingURL=AdaptiveChatBarMountable.d.ts.map

package/dist/AdaptiveChatBarMountable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveChatBarMountable.d.ts","sourceRoot":"","sources":["../src/AdaptiveChatBarMountable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,mBAAmB,CAAC;AAC3B,OAAO,EAIL,KAAK,wBAAwB,EAG9B,MAAM,4BAA4B,CAAC;AAiBpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,KAAK,EAAmB,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAyHxE;;;;;;GAMG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAIjD;AA6BD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAgB/F;AA+DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE;IAC9C,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CAC/C,GAAG,CAAC,EAAE,EAAE,gBAAgB,EAAE,GAAG,EAAE,QAAQ,KAAK,gBAAgB,CAkC5D;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CA0CxF;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,IAAI,IAAI,CAMjD;AAiHD,wBAAgB,+BAA+B,IAAI,IAAI,CAUtD;AAsID,eAAO,MAAM,wBAAwB;qBAClB,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,IAAI;sBA8F9D,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAQ5E,CAAC"}

package/dist/AdaptiveChatTrail.anchor-scroll.test.d.ts

@@ -0,0 +1,2 @@
+import './AdaptiveChatTrail';
+//# sourceMappingURL=AdaptiveChatTrail.anchor-scroll.test.d.ts.map

package/dist/AdaptiveChatTrail.anchor-scroll.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdaptiveChatTrail.anchor-scroll.test.d.ts","sourceRoot":"","sources":["../src/AdaptiveChatTrail.anchor-scroll.test.ts"],"names":[],"mappings":"AA0BA,OAAO,qBAAqB,CAAC"}