@syntrologie/adapt-chatbot 2.8.0-canary.62 → 2.8.0-canary.621

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-HV52LYST.js";
+import "./chunk-4V5L7IRV.js";
+import "./chunk-LY5AGXVD.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

@@ -0,0 +1,64 @@
+/**
+ * Adaptive Chatbot — Lit Mountable
+ *
+ * Thin wrapper that mounts <syntro-chat> from @syntrologie/chat with an
+ * AgUiTransport pointed at the adaptive AG-UI streaming endpoint.
+ *
+ * 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 rides the RUNTIME
+ *    handle (`runtime.token`, populated by `Syntro.init({token})` — the
+ *    same single-source contract as `runtime.backendUrl`); we read it at
+ *    mount time and forward it via `Authorization: Bearer` header. Never
+ *    a window global (BUG-1785360157).
+ *
+ * 2. Cloudflare Turnstile bot-check token, acquired on the visitor's FIRST
+ *    SEND (never at mount) and only when the backend reports it enforces
+ *    the check (`GET /api/adaptive/bot_check`, BUG-1789605814). When it
+ *    runs, it renders 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.)
+ *    Skipped entirely when the sitekey is empty or the backend mode is `off`.
+ *
+ * 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, ChatbotFallback, ChatbotWidgetRuntime } from './types.js';
+export interface ChatAssistantLitProps {
+    config: ChatbotConfig;
+    runtime: ChatbotWidgetRuntime;
+    tileId?: string;
+}
+/**
+ * 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 renderFallbackHtml(fallback: ChatbotFallback | undefined): string;
+export declare const ChatAssistantLitMountable: {
+    mount(container: HTMLElement, mountConfig?: Record<string, unknown>): () => void;
+};
+//# sourceMappingURL=ChatAssistantLit.d.ts.map

package/dist/ChatAssistantLit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatAssistantLit.d.ts","sourceRoot":"","sources":["../src/ChatAssistantLit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,OAAO,mBAAmB,CAAC;AAQ3B,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;AAuCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CAiEhF;AA0CD,eAAO,MAAM,yBAAyB;qBACnB,WAAW,gBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAkdpE,CAAC"}

package/dist/ChatAssistantLit.js

@@ -0,0 +1,14 @@
+import {
+  ChatAssistantLitMountable,
+  renderFallbackHtml
+} from "./chunk-HD2NXGYO.js";
+import "./chunk-VIRIVP7H.js";
+import "./chunk-EWPPVPJ4.js";
+import "./chunk-YFZCMLV6.js";
+import "./chunk-4V5L7IRV.js";
+import "./chunk-LY5AGXVD.js";
+export {
+  ChatAssistantLitMountable,
+  renderFallbackHtml
+};
+//# sourceMappingURL=ChatAssistantLit.js.map

package/dist/ChatAssistantLit.js.map

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

package/dist/ChatSession.d.ts

@@ -0,0 +1,275 @@
+/**
+ * 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 { ChatSendVia } from '@syntrologie/sdk-contracts';
+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;
+    /** User sends so far in this session; the single turn counter. */
+    readonly turn: number;
+}
+export interface ToolResultEvent {
+    toolCallId: string;
+    result: unknown;
+    approved: boolean;
+}
+export type ChatSessionSubscriber = (state: ChatSessionState) => void;
+export type SendListener = (event: {
+    text: string;
+    id: string;
+    turn: number;
+    via: ChatSendVia;
+    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>;
+    /**
+     * Which affordance produced this send. Rides
+     * `syntro_chat_message_sent.via`.
+     */
+    via: ChatSendVia;
+}
+export type Unsubscribe = () => void;
+export declare class ChatSession {
+    private _messages;
+    private _inFlight;
+    private _runActive;
+    private _thinkingText;
+    private _nextId;
+    private _turn;
+    private subscribers;
+    private sendListeners;
+    private interruptListeners;
+    private toolResultListeners;
+    /** Snapshot the current state. Always returns a fresh immutable view. */
+    getState(): ChatSessionState;
+    /** User sends so far in this session; the single turn counter. */
+    get turn(): number;
+    /**
+     * 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;
+    /**
+     * Create an empty, already-settled assistant message at `id` if one
+     * doesn't already exist. Idempotent — safe to call on every tool-call
+     * sighting.
+     *
+     * Exists for TOOL-ONLY turns: pydantic-ai's AG-UI adapter mints a fresh
+     * `parent_message_id` per model response regardless of content
+     * (`before_response` → `self.new_message_id()`) and stamps it on every
+     * `TOOL_CALL_START`, even when the response has no text. When the
+     * model's entire action is one or more tool calls with no narration
+     * (a parallel `mount_*` + `suggest_replies` batch, most commonly), no
+     * `TEXT_MESSAGE_START` is ever emitted for that id, so nothing would
+     * otherwise create the host message `addToolCall` needs — and the tool
+     * call (and any chips/receipts derived from it) silently vanishes
+     * (BUG-1786654199). Call this before `addToolCall` on a tool call's
+     * first sighting so it always has a message to land on.
+     *
+     * Deliberately status:'complete' (not 'streaming' via `receiveStart`):
+     * a tool-only message has no text to stream, so there's nothing for a
+     * later `receiveEnd` to settle — leaving it 'streaming' would paint
+     * the trail's streaming/typing visual state forever.
+     */
+    ensureAssistantMessage(id: string | number): 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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"}