@syntrologie/adapt-chatbot 2.8.0-canary.31 → 2.8.0-canary.310

package/dist/elements/ItemHandler.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Item element handler — translates `parent_tile`-placed mount/patch/
+ * unmount mutations into pub/sub events that container widgets subscribe
+ * to.
+ *
+ * Container widgets (chips strip, FAQ accordion, nav tips) declare
+ * themselves participants by implementing the `CompositionalContainer`
+ * contract and subscribing to `runtime.events` with
+ * `element.compositional_append` / `element.compositional_patch` /
+ * `element.compositional_remove`. Each container filters by
+ * `props.tile_id === this.tileId`.
+ *
+ * Why pub/sub rather than DOM lookup? The runtime's event bus is
+ * domain-agnostic and already exists. Container widgets that aren't
+ * mounted yet (slow inline-slot wrapper hydration) miss the event,
+ * but the next subscribe-then-replay pass at container mount time picks
+ * up the durable session state from the LLM's `mounted_elements`. No
+ * DOM crawling, no MutationObserver wiring, no ordering assumption.
+ *
+ * The handler is dumb: it forwards the wire `content` as the `item`
+ * payload. The backend wrote that content as a fully-formed
+ * compositional-item envelope (`{kind, config: {id, title, payload}}`)
+ * so the receiving container can append it verbatim.
+ */
+import type { ElementHandlerContext, ElementTypeHandler, ValidateResult } from './ElementTypeHandler';
+import type { MountedElement } from './types';
+/** Event names. Kept as module constants so subscribers can import them
+ *  instead of memorizing strings. */
+export declare const COMPOSITIONAL_APPEND_EVENT = "element.compositional_append";
+export declare const COMPOSITIONAL_PATCH_EVENT = "element.compositional_patch";
+export declare const COMPOSITIONAL_REMOVE_EVENT = "element.compositional_remove";
+export interface CompositionalAppendEvent {
+    /** Parent tile id from the mount's placement. Receivers filter on this. */
+    tile_id: string;
+    /** Unique id of the mounted item — the receiving container should also
+     *  set this on the item's DOM as `data-syntro-element-id`. */
+    instance_id: string;
+    /** Wire shape constructed by the backend — `{kind, config: {…}}`. */
+    item: Record<string, unknown>;
+    /** Insertion position — receivers honor this when appending. */
+    position: 'append' | 'prepend';
+}
+export interface CompositionalPatchEvent {
+    tile_id: string;
+    instance_id: string;
+    item: Record<string, unknown>;
+}
+export interface CompositionalRemoveEvent {
+    tile_id: string;
+    instance_id: string;
+}
+export declare class ItemHandler implements ElementTypeHandler {
+    readonly typeName: "item";
+    readonly lifecycle: "stateful";
+    validate(instance: MountedElement, _ctx: ElementHandlerContext): ValidateResult;
+    mount(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+    patch(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+    unmount(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+}
+//# sourceMappingURL=ItemHandler.d.ts.map

package/dist/elements/ItemHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemHandler.d.ts","sourceRoot":"","sources":["../../src/elements/ItemHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,SAAS,CAAC;AAEnE;qCACqC;AACrC,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AACzE,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AACvE,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB;kEAC8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,gEAAgE;IAChE,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAY,YAAW,kBAAkB;IACpD,QAAQ,CAAC,QAAQ,EAAG,MAAM,CAAU;IACpC,QAAQ,CAAC,SAAS,EAAG,UAAU,CAAU;IAEzC,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,qBAAqB,GAAG,cAAc;IAqBzE,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1E,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1E,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CAQnF"}

package/dist/elements/ItemHandler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ItemHandler.test.d.ts.map

package/dist/elements/ItemHandler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ItemHandler.test.d.ts","sourceRoot":"","sources":["../../src/elements/ItemHandler.test.ts"],"names":[],"mappings":""}

package/dist/elements/TileHandler.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Tile element handler — translates `slot`-placed mount/patch/unmount
+ * mutations into pub/sub events that the runtime SDK subscribes to.
+ *
+ * The runtime SDK's `SmartCanvasElementLit` already routes config-driven
+ * tiles to inline slots via `tile.slot === slotName`. LLM-authored tiles
+ * use the same path: we publish a TileConfig-shaped envelope and the
+ * runtime merges it into its tile array, then existing routing renders
+ * it inside the slot's `<syntro-tile-stack>` alongside any config tiles.
+ *
+ * Why pub/sub instead of `core:mountWidget` via ActionEngine?
+ *
+ *   - `Surfaces.mount` is exclusive per slot — a second LLM tile to the
+ *     same slot would displace the first.
+ *   - `Surfaces` only knows built-in slot names; inline slots resolve
+ *     anchors via SyntroInlineSlot, not via Surfaces.
+ *   - Tiles need the SyntroTileCard chrome (chromeless handling, theme
+ *     overrides, dismiss control) that `core:mountWidget` skips.
+ *
+ * Container widgets stay dumb: the runtime owns one tile array per slot
+ * and renders it the same way regardless of provenance. Subscribers
+ * filter on `slot === this.name`.
+ *
+ * Event names + payload types live in `@syntrologie/sdk-contracts` so
+ * both packages share the contract. Renaming a field there is a TS
+ * error here and in the runtime subscriber — no silent drift.
+ */
+import type { ElementHandlerContext, ElementTypeHandler, ValidateResult } from './ElementTypeHandler';
+import type { MountedElement } from './types';
+export { TILE_MOUNTED_EVENT, TILE_PATCHED_EVENT, TILE_UNMOUNTED_EVENT, } from '@syntrologie/sdk-contracts';
+/**
+ * Optional template→widget resolver. ``uiTemplates`` declares both
+ * the LLM-facing ``id`` (e.g. ``"product-card"``) and the runtime
+ * widget the chrome should render (e.g. ``"adaptive-product:card"``).
+ * Without this resolver, the handler falls back to ``template_id`` as
+ * the widget id — which only works when the admin chose ids matching
+ * the widget registry, and silently mounts to "Widget not available"
+ * when they don't.
+ */
+export type TileTemplateWidgetResolver = (templateId: string) => string | undefined;
+export declare class TileHandler implements ElementTypeHandler {
+    private readonly resolveWidget?;
+    readonly typeName: "tile";
+    readonly lifecycle: "stateful";
+    constructor(resolveWidget?: TileTemplateWidgetResolver | undefined);
+    private _widgetFor;
+    validate(instance: MountedElement, _ctx: ElementHandlerContext): ValidateResult;
+    mount(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+    patch(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+    unmount(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+}
+//# sourceMappingURL=TileHandler.d.ts.map

package/dist/elements/TileHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TileHandler.d.ts","sourceRoot":"","sources":["../../src/elements/TileHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAUH,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,SAAS,CAAC;AAE7D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;GAQG;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAEpF,qBAAa,WAAY,YAAW,kBAAkB;IAIxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAH3C,QAAQ,CAAC,QAAQ,EAAG,MAAM,CAAU;IACpC,QAAQ,CAAC,SAAS,EAAG,UAAU,CAAU;gBAEZ,aAAa,CAAC,EAAE,0BAA0B,YAAA;IAEvE,OAAO,CAAC,UAAU;IAIlB,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,qBAAqB,GAAG,cAAc;IAiBzE,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1E,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1E,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;CASnF"}

package/dist/elements/blockRenderer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Portable Text block renderer — Phase 7 of the LLM-authored UI element
+ * instantiation work.
+ *
+ * `renderBlocks(blocks)` walks a Portable Text tree and produces a
+ * `DocumentFragment` of known-safe DOM. Calling code attaches the
+ * fragment via `target.appendChild(fragment)` /
+ * `target.insertAdjacentElement(...)` — **never** via `innerHTML`.
+ *
+ * The safety story:
+ *
+ * 1. **No `innerHTML` from agent data, ever.** Every text reaches the
+ *    DOM through `document.createTextNode` or `element.textContent`.
+ *    Even if an agent slips a `<script>` tag into a span's text, it's
+ *    rendered as the literal characters `<script>` inside a text node,
+ *    never parsed as HTML.
+ * 2. **Closed mark vocabulary.** Only `bold` / `italic` / `code` / `link`
+ *    are honored. Unknown marks are dropped at render time.
+ * 3. **Closed block vocabulary.** Only `paragraph` / `heading` / `list` /
+ *    `list_item` / `code` are honored. Unknown block types are dropped.
+ * 4. **Link href validation.** Backend already rejects `javascript:` /
+ *    `data:` / `vbscript:` etc., but the renderer re-checks for defense
+ *    in depth. Rejected links render as plain text spans.
+ * 5. **No inline styles, no event handlers, no custom attributes.**
+ *    Every attribute set on the output DOM is hard-coded in this file.
+ *
+ * Forward-compat: unknown block / mark types drop silently rather than
+ * throw — a future schema bump can add types without breaking today's
+ * renderer.
+ */
+import type { BlockNode } from './blocks';
+export interface RenderOptions {
+    /** Override the document used for `createElement` / `createTextNode`.
+     *  Tests inject jsdom's document; SSR contexts can pass a custom impl
+     *  if needed. Defaults to `globalThis.document`. */
+    doc?: Document;
+}
+/**
+ * Render an array of blocks into a `DocumentFragment` of safe DOM.
+ *
+ * Unknown / malformed entries are silently dropped — the caller has
+ * already validated server-side; the renderer is the last line of
+ * defense and stays fault-tolerant.
+ */
+export declare function renderBlocks(blocks: BlockNode[], options?: RenderOptions): DocumentFragment;
+//# sourceMappingURL=blockRenderer.d.ts.map

package/dist/elements/blockRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockRenderer.d.ts","sourceRoot":"","sources":["../../src/elements/blockRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,SAAS,EAQV,MAAM,UAAU,CAAC;AAQlB,MAAM,WAAW,aAAa;IAC5B;;wDAEoD;IACpD,GAAG,CAAC,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,gBAAgB,CAiB/F"}

package/dist/elements/blockRenderer.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Tests for the Portable Text block renderer — Phase 7.
+ *
+ * The bulk of this file is a hostile-input corpus. The point of the
+ * renderer is that **agent-authored text cannot produce script execution
+ * or unsafe DOM**, by construction, regardless of what the agent
+ * sends. Each test below pumps a different attack shape through
+ * `renderBlocks` and asserts that the resulting DOM contains no
+ * dangerous nodes, no live script content, and no `javascript:` /
+ * `data:` URIs on anchor tags.
+ */
+export {};
+//# sourceMappingURL=blockRenderer.test.d.ts.map

package/dist/elements/blockRenderer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockRenderer.test.d.ts","sourceRoot":"","sources":["../../src/elements/blockRenderer.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/elements/blocks.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Portable Text block + mark types — Phase 7 of the LLM-authored UI
+ * element instantiation work.
+ *
+ * Mirror of `platform/common/syntrologie_common/sdk/blocks.py`. Closed
+ * vocabulary (block types + mark types) the LLM may author in
+ * `rich_text_blocks` fields. The renderer walks this tree and produces
+ * DOM via `document.createElement` + `textContent` — **agent never
+ * writes HTML strings**. XSS-class attacks have no surface because
+ * there's no HTML on the wire.
+ *
+ * Forward-compat: unknown block types and unknown marks are dropped at
+ * render time (not thrown). A future protocol bump can add new types
+ * without breaking today's renderer.
+ */
+/**
+ * The closed inline-mark vocabulary. Adding a mark is a deliberate
+ * code change with review, never an allowlist tweak.
+ */
+export type MarkType = 'bold' | 'italic' | 'code' | 'link';
+export type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+export type ListStyle = 'bullet' | 'numbered';
+export interface LinkMark {
+    /** Validated server-side; renderer revalidates for defense in depth. */
+    href: string;
+}
+export interface TextSpan {
+    text: string;
+    marks?: MarkType[];
+    link?: LinkMark;
+}
+export interface ParagraphBlock {
+    type: 'paragraph';
+    spans: TextSpan[];
+}
+export interface HeadingBlock {
+    type: 'heading';
+    level: HeadingLevel;
+    spans: TextSpan[];
+}
+export interface ListItemBlock {
+    type: 'list_item';
+    spans: TextSpan[];
+}
+export interface ListBlock {
+    type: 'list';
+    style: ListStyle;
+    items: ListItemBlock[];
+}
+export interface CodeBlock {
+    type: 'code';
+    /** Raw code text. Rendered inside `<pre><code>` via `textContent` —
+     *  no HTML interpretation, no syntax-highlight injection. */
+    text: string;
+    language?: string;
+}
+export type BlockNode = ParagraphBlock | HeadingBlock | ListBlock | CodeBlock;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/elements/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/elements/blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9C,MAAM,WAAW,QAAQ;IACvB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb;iEAC6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC"}

package/dist/elements/envelope.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Helpers for decoding AG-UI custom event payloads — Phase 6b.
+ *
+ * `AgUiTransport.onA2UIEvent` historically forwarded the raw `event.value`
+ * payload as an `ActionStep` directly to `runtime.actions.applyBatch`.
+ * Phase 5's backend now also emits `syntro.element.mutation` envelopes
+ * (mounts/patches/unmounts authored by the LLM via `mount_element` &c.),
+ * which the SDK routes to `ElementInstanceStore.apply` instead.
+ *
+ * Discrimination is by the envelope's `type` field. Non-element payloads
+ * (raw ActionStep, A2UI `createSurface` / `updateDataModel` envelopes
+ * from any A2UI integration) fall through to the legacy path.
+ */
+import type { ElementMutation } from './types';
+/**
+ * Returns the mutations array if `payload` is a well-formed
+ * `syntro.element.mutation` envelope, otherwise `null`.
+ *
+ * Validates only the discriminator + the structural shape needed to
+ * route to the store. Per-mutation validation lives in the store / its
+ * type handlers (defense in depth), so this stays small.
+ */
+export declare function decodeMutationEnvelope(payload: unknown): ElementMutation[] | null;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/elements/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/elements/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,SAAS,CAAC;AAEjE;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,GAAG,IAAI,CAOjF"}

package/dist/elements/fetcher.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Boot-time fetcher for `GET /api/adaptive/mounted_elements`.
+ *
+ * Follows the SDK's vanilla-fetch convention (see
+ * `packages/runtime-sdk/src/overlays/fetcher.ts` for the sibling pattern
+ * — no shared HTTP client, no axios, no fetch wrapper).
+ *
+ * Auth: forwards the SDK token from `window.__SYNTRO_CONFIG__.token`
+ * as a Bearer header. Cookies (`syntro_chat_session`) are sent via
+ * `credentials: 'include'` so the backend can scope to the same Redis
+ * session the chat uses.
+ *
+ * 404 contract: the backend returns 404 only when the workspace's SDK
+ * token doesn't resolve to a workspace. The SDK treats 404 as
+ * "feature unavailable" — no error UI, no retries — per the design doc.
+ * Network errors are logged + swallowed so the SDK boot path stays
+ * resilient to backend hiccups.
+ */
+import type { MountedElementsResponse } from './types';
+export interface FetchMountedElementsOptions {
+    /** Override the endpoint URL (defaults to same-origin
+     *  `/api/adaptive/mounted_elements`). Tests + multi-environment
+     *  deploys use this. */
+    endpoint?: string;
+    /** SDK token. Defaults to `window.__SYNTRO_CONFIG__.token`. */
+    token?: string;
+    /** Custom fetch implementation — used by tests to mock the network. */
+    fetchImpl?: typeof fetch;
+    /** Logger — used by tests to capture log output. */
+    logger?: Pick<Console, 'warn'>;
+}
+/**
+ * Fetch the visitor's currently-mounted elements + session expiry.
+ *
+ * Returns `null` on any failure (404, network error, malformed JSON,
+ * etc.). The caller treats `null` as "feature unavailable, no
+ * rehydrate" — boot continues normally with an empty element store.
+ */
+export declare function fetchMountedElements(options?: FetchMountedElementsOptions): Promise<MountedElementsResponse | null>;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/elements/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/elements/fetcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAIvD,MAAM,WAAW,2BAA2B;IAC1C;;4BAEwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,oDAAoD;IACpD,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CA+CzC"}

package/dist/elements/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Element-instantiation machinery for the adaptive chatbot.
+ *
+ * Originally added in runtime-sdk; moved here in two passes:
+ *  - Phase 6c: store / handlers / fetcher / envelope / wire types
+ *    (every consumer was the chat surface).
+ *  - Phase 6c.1: Portable Text vocab + safe renderer (`renderBlocks`,
+ *    `BlockNode`, etc.). Generic by shape but zero non-chat consumers
+ *    in practice, so leaving it in the universal CDN bundle made every
+ *    non-chat customer pay the bundle cost for nothing — the
+ *    runtime-as-OS principle says don't ship interfaces with no
+ *    consumers in the universal bundle.
+ *
+ * If a second adaptive ever needs Portable Text rendering, promote
+ * `blocks.ts` + `blockRenderer.ts` to a leaf shared package
+ * (`@syntrologie/portable-text`) and have both consumers depend on it.
+ * Do NOT push it back into runtime-sdk.
+ */
+export { ActionHandler } from './ActionHandler';
+export type { RenderOptions } from './blockRenderer';
+export { renderBlocks } from './blockRenderer';
+export type { BlockNode, CodeBlock, HeadingBlock, HeadingLevel, LinkMark, ListBlock, ListItemBlock, ListStyle, MarkType, ParagraphBlock, TextSpan, } from './blocks';
+export { ElementInstanceStore } from './ElementInstanceStore';
+export type { ElementHandlerContext, ElementLifecycle, ElementMutationContext, ElementTypeHandler, ValidateResult, } from './ElementTypeHandler';
+export { decodeMutationEnvelope } from './envelope';
+export type { FetchMountedElementsOptions } from './fetcher';
+export { fetchMountedElements } from './fetcher';
+export type { CompositionalAppendEvent, CompositionalPatchEvent, CompositionalRemoveEvent, } from './ItemHandler';
+export { COMPOSITIONAL_APPEND_EVENT, COMPOSITIONAL_PATCH_EVENT, COMPOSITIONAL_REMOVE_EVENT, ItemHandler, } from './ItemHandler';
+export { TileHandler } from './TileHandler';
+export type { AgentProvenance, ElementMutation, ElementState, MountedElement, MountedElementsResponse, MountMutation, Mutation, MutationEnvelope, NoPlacement, ParentTilePlacement, PatchMutation, Placement, SelectorPlacement, SlotPlacement, UnmountMutation, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/elements/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,aAAa,EACb,SAAS,EACT,QAAQ,EACR,cAAc,EACd,QAAQ,GACT,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,2BAA2B,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EACV,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,0BAA0B,EAC1B,WAAW,GACZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/elements/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Wire types for LLM-authored UI element instantiation — Phase 6.
+ *
+ * These mirror the backend Pydantic models in
+ * `platform/backend/app/services/agents/elements_models.py`. Kept as
+ * plain TypeScript types (no Zod validators) for v1 — the SDK trusts
+ * what it fetches from the workspace's own backend per the design doc's
+ * "backend is the sole enforcer" stance. Add Zod here if defence-in-depth
+ * ever becomes a real concern.
+ *
+ * Wire format documented in
+ * `docs/plans/current/2026-05-24-adaptive-chatbot-action-triggers-design.md`.
+ */
+export type ElementState = 'active' | 'applied' | 'reverted' | 'expired';
+export interface AgentProvenance {
+    agent_id: string;
+    turn_id: string;
+}
+export interface Mutation {
+    op: 'mount' | 'patch' | 'unmount';
+    at: string;
+    by: AgentProvenance;
+    paths?: string[];
+}
+export interface SlotPlacement {
+    type: 'slot';
+    slot: string;
+}
+export interface SelectorPlacement {
+    type: 'selector';
+    selector: string;
+    position: 'beforebegin' | 'afterbegin' | 'beforeend' | 'afterend' | 'replace' | 'modify';
+}
+export interface NoPlacement {
+    type: 'none';
+}
+/**
+ * Compositional-item placement — for chips, FAQ items, nav tips that
+ * mount INSIDE an existing tile's compositional-actions list rather
+ * than occupying their own slot. `tile_id` references a tile by its
+ * config-time id (e.g. `hero-chips`); `position` controls insertion
+ * order in the parent's items array.
+ *
+ * Backend mirror: `ParentTilePlacement` in
+ * `platform/backend/app/services/agents/elements_models.py`.
+ */
+export interface ParentTilePlacement {
+    type: 'parent_tile';
+    tile_id: string;
+    position: 'append' | 'prepend';
+}
+export type Placement = SlotPlacement | SelectorPlacement | NoPlacement | ParentTilePlacement;
+export interface MountedElement {
+    instance_id: string;
+    element_type: 'tile' | 'action' | 'item';
+    template_id: string;
+    placement: Placement;
+    content: Record<string, unknown>;
+    state: ElementState;
+    mounted_by: AgentProvenance;
+    mounted_at: string;
+    version: number;
+    mutation_log?: Mutation[];
+}
+/**
+ * Live-mutation envelope carried on the `syntro.element.mutation`
+ * AG-UI custom event.
+ */
+export interface MutationEnvelope {
+    type: 'syntro.element.mutation';
+    schema_version: 'v0';
+    mutations: ElementMutation[];
+}
+export type ElementMutation = MountMutation | PatchMutation | UnmountMutation;
+export interface MountMutation {
+    op: 'mount';
+    instance: MountedElement;
+}
+export interface PatchMutation {
+    op: 'patch';
+    instance_id: string;
+    patches: {
+        path: string;
+        value: unknown;
+    }[];
+    expected_version: number;
+    /** New version after patch, sent by the backend. SDK uses this for dedup. */
+    resulting_version: number;
+    /** Full content snapshot after patch — saves the SDK from having to
+     *  apply patches client-side. */
+    resulting_content: Record<string, unknown>;
+}
+export interface UnmountMutation {
+    op: 'unmount';
+    instance_id: string;
+}
+/**
+ * Response shape from `GET /api/adaptive/mounted_elements`. Matches the
+ * backend `MountedElementsResponse` (Phase 4).
+ */
+export interface MountedElementsResponse {
+    mounted_elements: MountedElement[];
+    session_expires_at: string | null;
+    schema_version: 'v0';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/elements/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/elements/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,eAAe,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC1F;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,iBAAiB,GAAG,WAAW,GAAG,mBAAmB,CAAC;AAE9F,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,yBAAyB,CAAC;IAChC,cAAc,EAAE,IAAI,CAAC;IACrB,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,aAAa,GAAG,eAAe,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAC;IAC1B;qCACiC;IACjC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,SAAS,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,IAAI,CAAC;CACtB"}

package/dist/observer/__tests__/allowlist.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tests for the pure event-allowlist module.
+ *
+ * Each PostHog autocapture event shape maps to either:
+ *   - a templated ObservationEvent ready for transport, or
+ *   - null (drop — not significant).
+ */
+export {};
+//# sourceMappingURL=allowlist.test.d.ts.map

package/dist/observer/__tests__/allowlist.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.test.d.ts","sourceRoot":"","sources":["../../../src/observer/__tests__/allowlist.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/observer/__tests__/observer-isolation.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Isolation tests for the observer.
+ *
+ * The observer must never include host-page PII in observation text.
+ * PostHog autocapture strips sensitive properties from $elements before
+ * delivery, but we add a belt-and-suspenders check here against text
+ * fields that look like emails, phones, or credit-card patterns.
+ *
+ * If this test ever fails, the templates in allowlist.ts have regressed
+ * — fix there, not by suppressing this test.
+ */
+export {};
+//# sourceMappingURL=observer-isolation.test.d.ts.map

package/dist/observer/__tests__/observer-isolation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer-isolation.test.d.ts","sourceRoot":"","sources":["../../../src/observer/__tests__/observer-isolation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/observer/__tests__/queue.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue.test.d.ts.map

package/dist/observer/__tests__/queue.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.test.d.ts","sourceRoot":"","sources":["../../../src/observer/__tests__/queue.test.ts"],"names":[],"mappings":""}

package/dist/observer/__tests__/transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.test.d.ts.map

package/dist/observer/__tests__/transport.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.test.d.ts","sourceRoot":"","sources":["../../../src/observer/__tests__/transport.test.ts"],"names":[],"mappings":""}

package/dist/observer/allowlist.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pure mapping from raw PostHog events to ObservationEvents.
+ *
+ * One function: matchEvent(raw, opts) → ObservationEvent | null. Null means
+ * "drop, not significant." This module is the single source of truth for what
+ * the chat agent sees on the in-session timeline; the SDK observer never
+ * forwards anything matchEvent returns null for.
+ *
+ * Kept dependency-free (no DOM access, no PostHog SDK imports) so the
+ * Vitest unit tests run without any browser shim.
+ */
+export type ObservationKind = 'nav' | 'click' | 'form' | 'rage' | 'dead' | 'scroll' | 'view' | 'idle' | 'hover' | 'hesitation' | 'custom';
+export interface ObservationEvent {
+    ts: number;
+    kind: ObservationKind;
+    text: string;
+    ref?: string;
+}
+/** Shape of a raw event reaching matchEvent. Loose by design — PostHog's
+ *  event shape evolves, and we want matchEvent to be resilient to extra
+ *  properties. */
+export interface RawEvent {
+    event: string;
+    timestamp: number;
+    properties: Record<string, unknown>;
+}
+export interface MatchOptions {
+    /** Workspace-configured custom event names to forward as kind="custom". */
+    observableEvents?: readonly string[];
+}
+export declare function matchEvent(raw: RawEvent, opts?: MatchOptions): ObservationEvent | null;
+//# sourceMappingURL=allowlist.d.ts.map

package/dist/observer/allowlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist.d.ts","sourceRoot":"","sources":["../../src/observer/allowlist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,eAAe,GACvB,KAAK,GACL,OAAO,GACP,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;kBAEkB;AAClB,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AA0ED,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,GAAE,YAAiB,GAAG,gBAAgB,GAAG,IAAI,CA4I1F"}

package/dist/observer/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Observer entry point.
+ *
+ * startObserver wires the four pieces — allowlist filter + queue +
+ * transport + PostHog subscription — into a single lifecycle controlled
+ * via the returned handle. The handle is reference-counted: multiple
+ * call sites (e.g. multiple chatbot widgets on the same page) share
+ * one observer.
+ *
+ * Idempotent: calling startObserver twice with equivalent options
+ * returns the same instance. Calling stop() decrements the ref count;
+ * the observer tears down only when the count reaches zero.
+ */
+import { type RawEvent } from './allowlist';
+import { type ObserverStats } from './queue';
+import { type Transport } from './transport';
+export interface StartObserverOptions {
+    url: string;
+    token: () => string;
+    getDistinctId: () => string | null;
+    observableEvents?: readonly string[];
+    /** Test seam: override fetch/timer behavior by injecting a custom transport. */
+    transport?: Transport;
+}
+export interface ObserverHandle {
+    stop(): void;
+    stats(): ObserverStats;
+    /** Test seam: ingest a raw event directly without depending on PostHog being loaded. */
+    ingest(raw: RawEvent): void;
+    flushNow(): Promise<void>;
+}
+export declare function startObserver(opts: StartObserverOptions): ObserverHandle;
+/** Test-only: reset module singleton state. */
+export declare function _resetObserverForTests(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/observer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,aAAa,CAAC;IACvB,wFAAwF;IACxF,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAoDD,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,cAAc,CAoCxE;AAoCD,+CAA+C;AAC/C,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C"}