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

package/dist/chunk-VLJ3WOEX.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../sdk-contracts/dist/mount-plumbing.js", "../../../sdk-contracts/dist/schemas.js", "../../../../node_modules/@lit/context/src/lib/create-context.ts", "../../../sdk-contracts/dist/canvas-context.js", "../../../sdk-contracts/dist/routes.js", "../../../sdk-contracts/dist/tile-lifecycle.js"],
+  "sourcesContent": ["/**\n * Mount contract types and helper for adaptive widget mountables.\n *\n * The `WidgetRegistry` in `@syntrologie/runtime-sdk` delivers props to each\n * mountable as `{ ...tile.props, instanceId, runtime, tileId? }` spread flat\n * (see `MountableContract.test.ts` in runtime-sdk for the end-to-end lockdown).\n *\n * Adaptives that strip plumbing manually maintain private blacklists that\n * silently drift when the contract grows (PR #2234 and #2238 documented this).\n * `stripMountPlumbing` centralizes the list so adding a new plumbing key in\n * the future is a one-line change here that every adaptive picks up automatically.\n *\n * Adaptives whose widget schemas use Zod `.strict()` MUST call this before\n * validating, or strict-mode will reject the runtime-injected keys and the\n * widget will silently render its empty/error state.\n */\nexport const MOUNT_PLUMBING_KEYS = ['instanceId', 'runtime', 'tileId'];\nexport function stripMountPlumbing(config) {\n    if (!config || typeof config !== 'object') {\n        return {};\n    }\n    const out = { ...config };\n    for (const key of MOUNT_PLUMBING_KEYS) {\n        delete out[key];\n    }\n    return out;\n}\n", "/**\n * Shared Zod schemas for decision strategies, conditions, and event scoping.\n *\n * These are the canonical definitions \u2014 runtime-sdk and all adaptive packages\n * should import from here instead of duplicating.\n */\nimport { z } from 'zod';\n// =============================================================================\n// ANCHOR ID SCHEMA\n// =============================================================================\nexport const AnchorIdZ = z\n    .object({\n    selector: z.string(),\n    route: z.union([z.string(), z.array(z.string())]),\n})\n    .strict();\n// =============================================================================\n// AUTHORING FIELDS \u2014 id / title / description / validation\n//\n// Shared fields every action carries. `id` is the action identifier the\n// runtime uses to dispatch, dedupe, and drop/replace actions \u2014 it is NOT\n// stripped before serving. `title` / `description` / `validation` are\n// authoring-only metadata stripped server-side in `to_runtime_config`\n// (platform/backend/app/domains/experiments/helpers.py).\n//\n// They all appear in the JSON Schema (and therefore in the tactician's\n// prompt) because the LLM needs to know they are valid action properties \u2014\n// otherwise schema validation would reject what the prompt commands.\n//\n// Each action variant should `.extend(AuthoringFieldsZ)` alongside any\n// triggerWhen/condition extensions.\n// =============================================================================\nexport const AuthoringFieldsZ = {\n    id: z.string().optional().describe('Stable action identifier (e.g. \"act_3db6a14d2ab0\").'),\n    title: z\n        .string()\n        .max(200)\n        .optional()\n        .describe('Authoring-only: short label shown on the action plan dashboard. Stripped before serving to the runtime SDK.'),\n    description: z\n        .string()\n        .max(1000)\n        .optional()\n        .describe('Authoring-only: one-sentence explanation of what this action does and why. Stripped before serving to the runtime SDK.'),\n    validation: z\n        .array(z.string().max(500))\n        .max(10)\n        .optional()\n        .describe('Authoring-only: ordered steps a reviewer can follow to trigger this action and visually confirm it works. Each entry is one step. Stripped before serving to the runtime SDK.'),\n};\n// =============================================================================\n// TRIGGER VOCABULARY \u2014 canonical lists of valid event names, metric keys, etc.\n// These flow through to the JSON schema as enums and are used by the LLM prompt.\n// =============================================================================\n/** Events that can be counted in event_count conditions.\n *\n * Every value here must be an event the runtime actually emits \u2014 either a\n * PostHog-autocapture normalization (ui.click/scroll/input/change/submit) or\n * an event-processor detector (ui.hover/idle/scroll_thrash/focus_bounce/\n * hesitate/rage_click). Do not add aspirational names; a trigger counting an\n * event nothing emits never fires.\n */\nexport const COUNTABLE_EVENTS = [\n    // User interactions (from PostHog autocapture normalization)\n    'ui.click',\n    'ui.scroll',\n    'ui.input',\n    'ui.change',\n    'ui.submit',\n    // Behavioral detectors (from event-processor)\n    'ui.hover',\n    'ui.idle',\n    'ui.scroll_thrash',\n    'ui.focus_bounce',\n    'ui.hesitate',\n    'ui.rage_click',\n    // Navigation\n    'nav.page_view',\n    'nav.page_leave',\n];\nexport const CountableEventZ = z\n    .enum(COUNTABLE_EVENTS)\n    .describe('Event name to count. ui.* = user interactions and behavioral detectors (hesitate, rage_click, scroll_thrash, focus_bounce, idle, hover); nav.* = page navigation.');\n/** Valid session metric keys. */\nexport const SESSION_METRIC_KEYS = ['time_on_page', 'page_views', 'scroll_depth'];\nexport const SessionMetricKeyZ = z\n    .enum(SESSION_METRIC_KEYS)\n    .describe('Session metric key. time_on_page = seconds on current page, page_views = pages visited this session, scroll_depth = 0-100 percentage.');\n/** Element chain match field prefixes for counter filters. */\nexport const ELEMENT_MATCH_FIELDS = ['tag_name', '$el_text'];\n// Note: attr__* is a dynamic prefix (attr__data-id, attr__class, attr__href, etc.)\n// and cannot be enumerated. The match key is either one of ELEMENT_MATCH_FIELDS\n// or starts with \"attr__\".\n// =============================================================================\n// CONDITION SCHEMAS\n// =============================================================================\nexport const PageUrlConditionZ = z\n    .object({\n    type: z.literal('page_url'),\n    url: z.string().describe('URL path to match (e.g. \"/pricing\", \"/dashboard\")'),\n})\n    .describe('Fires when the current page URL matches. Use for page-specific actions. ' +\n    'Example: {\"type\": \"page_url\", \"url\": \"/pricing\"}');\nexport const RouteConditionZ = z\n    .object({\n    type: z.literal('route'),\n    routeId: z.string().describe('Named route ID from the route filter'),\n})\n    .describe('Fires when the current route matches a named route ID.');\nexport const AnchorVisibleConditionZ = z\n    .object({\n    type: z.literal('anchor_visible'),\n    anchorId: z.string().describe('CSS selector of the anchor element'),\n    state: z\n        .enum(['visible', 'present', 'absent'])\n        .describe('\"visible\" = in viewport, \"present\" = in DOM, \"absent\" = not in DOM'),\n})\n    .describe(\"Fires based on a DOM element's visibility state. \" +\n    'Example: {\"type\": \"anchor_visible\", \"anchorId\": \"#cta-button\", \"state\": \"visible\"}');\nexport const EventOccurredConditionZ = z\n    .object({\n    type: z.literal('event_occurred'),\n    eventName: z.string().describe('Event name (e.g. \"ui.click\", \"$pageview\")'),\n    withinMs: z.number().optional().describe('Time window in ms. Omit = any time this session.'),\n})\n    .describe('Fires when a specific event has occurred during this session. ' +\n    'Example: {\"type\": \"event_occurred\", \"eventName\": \"ui.click\", \"withinMs\": 5000}');\nexport const StateEqualsConditionZ = z\n    .object({\n    type: z.literal('state_equals'),\n    key: z\n        .string()\n        .describe('Key in the SDK persistent state store (localStorage). Only valid for keys the host app explicitly sets via syntro.state.set().'),\n    value: z.unknown().describe('Expected value to match against'),\n})\n    .describe('Checks the SDK persistent state store (localStorage). ONLY for host-app state set via syntro.state.set() \u2014 ' +\n    'NOT for user attributes like region, device, or UTM params (those are handled by segment targeting). ' +\n    'Do NOT use this for targeting. If you do not know the valid state keys, do not use this condition type.');\nexport const ViewportConditionZ = z\n    .object({\n    type: z.literal('viewport'),\n    minWidth: z.number().optional().describe('Minimum viewport width in pixels'),\n    maxWidth: z.number().optional().describe('Maximum viewport width in pixels'),\n    minHeight: z.number().optional().describe('Minimum viewport height in pixels'),\n    maxHeight: z.number().optional().describe('Maximum viewport height in pixels'),\n})\n    .describe('Fires based on viewport (screen) size. Use for responsive behavior. ' +\n    'Example: {\"type\": \"viewport\", \"minWidth\": 768} \u2014 fires on tablet and larger.');\nexport const SessionMetricConditionZ = z\n    .object({\n    type: z.literal('session_metric'),\n    key: SessionMetricKeyZ,\n    operator: z.enum(['gte', 'lte', 'eq', 'gt', 'lt']),\n    threshold: z.number().describe('Numeric threshold to compare against'),\n})\n    .describe('Fires when a session metric crosses a threshold. Valid keys: \"time_on_page\" (seconds), ' +\n    '\"page_views\" (count), \"scroll_depth\" (0-100). ' +\n    'Example: {\"type\": \"session_metric\", \"key\": \"time_on_page\", \"operator\": \"gte\", \"threshold\": 30}');\nexport const DismissedConditionZ = z\n    .object({\n    type: z.literal('dismissed'),\n    key: z.string().describe('Dismissal key (usually a tile or action ID)'),\n    inverted: z\n        .boolean()\n        .optional()\n        .describe('When true, fires if NOT dismissed (default behavior)'),\n})\n    .describe('Checks if an item has been dismissed by the user. Use with inverted: true to show only if not dismissed.');\nexport const CooldownActiveConditionZ = z\n    .object({\n    type: z.literal('cooldown_active'),\n    key: z.string().describe('Cooldown key'),\n    inverted: z.boolean().optional().describe('When true, fires if cooldown is NOT active'),\n})\n    .describe('Checks if a cooldown timer is currently active. Use to prevent showing the same intervention too frequently.');\nexport const FrequencyLimitConditionZ = z\n    .object({\n    type: z.literal('frequency_limit'),\n    key: z.string().describe('Frequency counter key'),\n    limit: z.number().describe('Maximum allowed count'),\n    inverted: z.boolean().optional().describe('When true, fires if limit NOT reached'),\n})\n    .describe('Checks if a frequency limit has been reached. Use to cap how many times an action fires per session.');\nexport const MatchOpZ = z\n    .object({\n    equals: z.union([z.string(), z.number(), z.boolean()]).optional(),\n    contains: z.string().optional(),\n})\n    .describe('Match operator for counter filters. Exactly one of equals or contains must be specified.');\nexport const CounterDefZ = z\n    .object({\n    events: z\n        .array(CountableEventZ)\n        .min(1)\n        .describe('Event names to count. Use values from the countable events enum.'),\n    match: z\n        .record(z.string(), MatchOpZ)\n        .optional()\n        .describe('Property filters. Keys are event prop names or element-chain fields ' +\n        '(tag_name, $el_text, attr__*). All entries AND together.'),\n})\n    .describe('Defines what events to count. Registered as an accumulator predicate at config-load time.');\nexport const EventCountConditionZ = z\n    .object({\n    type: z.literal('event_count'),\n    key: z.string().describe('Unique key for this counter (used for accumulator registration)'),\n    operator: z.enum(['gte', 'lte', 'eq', 'gt', 'lt']),\n    count: z.number().int().min(0).describe('Target count threshold'),\n    withinMs: z\n        .number()\n        .positive()\n        .optional()\n        .describe('Time window in ms. Omit = count across entire session.'),\n    counter: CounterDefZ.optional().describe('Inline counter definition. Defines what events to count.'),\n})\n    .describe('Fires when accumulated event count crosses a threshold. Most powerful trigger type. ' +\n    'Example: {\"type\": \"event_count\", \"key\": \"pricing-clicks\", \"operator\": \"gte\", \"count\": 3, ' +\n    '\"counter\": {\"events\": [\"ui.click\"], \"match\": {\"attr__data-cta\": {\"contains\": \"pricing\"}}}}');\nexport const ConditionZ = z.discriminatedUnion('type', [\n    PageUrlConditionZ,\n    RouteConditionZ,\n    AnchorVisibleConditionZ,\n    EventOccurredConditionZ,\n    StateEqualsConditionZ,\n    ViewportConditionZ,\n    SessionMetricConditionZ,\n    DismissedConditionZ,\n    CooldownActiveConditionZ,\n    FrequencyLimitConditionZ,\n    EventCountConditionZ,\n]);\n// =============================================================================\n// STRATEGY SCHEMAS\n// =============================================================================\nexport const RuleZ = z\n    .object({\n    conditions: z\n        .array(ConditionZ)\n        .describe('Array of conditions \u2014 ALL must match (AND logic) for this rule to fire.'),\n    value: z\n        .unknown()\n        .describe('Value returned when all conditions match. For triggerWhen: true = fire the action.'),\n})\n    .describe('A single rule. ALL conditions must match (AND logic). Rules in a strategy are evaluated ' +\n    'top-to-bottom \u2014 first rule where all conditions match wins and returns its value.');\nexport const RuleStrategyZ = z\n    .object({\n    type: z.literal('rules'),\n    rules: z\n        .array(RuleZ)\n        .describe('Ordered list of rules. Evaluated top-to-bottom \u2014 first match wins.'),\n    default: z\n        .unknown()\n        .describe('Fallback value when no rule matches. For triggerWhen: false = do not fire by default.'),\n})\n    .describe('Rule-based strategy. Evaluates rules top-to-bottom. First rule where ALL conditions match ' +\n    'returns its value. If no rule matches, returns default. ' +\n    'For triggerWhen: set value=true on matching rules, default=false.');\nexport const ScoreStrategyZ = z\n    .object({\n    type: z.literal('score'),\n    field: z.string(),\n    threshold: z.number(),\n    above: z.unknown(),\n    below: z.unknown(),\n})\n    .describe('Score-based strategy. Compares a field value against a threshold.');\nexport const ModelStrategyZ = z\n    .object({\n    type: z.literal('model'),\n    modelId: z.string(),\n    inputs: z.array(z.string()),\n    outputMapping: z.record(z.string(), z.unknown()),\n    default: z.unknown(),\n})\n    .describe('ML model strategy. Sends inputs to a model and maps outputs.');\nexport const ExternalStrategyZ = z\n    .object({\n    type: z.literal('external'),\n    endpoint: z.string(),\n    method: z.enum(['GET', 'POST']).optional(),\n    default: z.unknown(),\n    timeoutMs: z.number().optional(),\n})\n    .describe('External API strategy. Calls an endpoint to determine the value.');\nexport const DecisionStrategyZ = z.discriminatedUnion('type', [\n    RuleStrategyZ,\n    ScoreStrategyZ,\n    ModelStrategyZ,\n    ExternalStrategyZ,\n]);\n/** Canonical Zod schema for the optional triggerWhen field on actions and adaptive items. */\nexport const TriggerWhenZ = DecisionStrategyZ.nullable().optional();\n// =============================================================================\n// TRIGGER DOCUMENTATION \u2014 examples and match field docs\n// Exported as constants so the schema generator can inject them into the\n// JSON schema. The Python prompt builder reads them from the schema.\n// =============================================================================\n/** Complete triggerWhen examples showing the full rules wrapper structure. */\nexport const TRIGGER_EXAMPLES = [\n    {\n        name: 'Click count on a specific element',\n        description: 'Fire when user clicks an element with data-id=\"hero-cta\" 2+ times',\n        triggerWhen: {\n            type: 'rules',\n            rules: [\n                {\n                    conditions: [\n                        {\n                            type: 'event_count',\n                            key: 'cta-clicks',\n                            operator: 'gte',\n                            count: 2,\n                            counter: {\n                                events: ['ui.click'],\n                                match: { 'attr__data-id': { equals: 'hero-cta' } },\n                            },\n                        },\n                    ],\n                    value: true,\n                },\n            ],\n            default: false,\n        },\n    },\n    {\n        name: 'Time on page threshold',\n        description: 'Fire after user spends 30+ seconds on the page',\n        triggerWhen: {\n            type: 'rules',\n            rules: [\n                {\n                    conditions: [\n                        {\n                            type: 'session_metric',\n                            key: 'time_on_page',\n                            operator: 'gte',\n                            threshold: 30,\n                        },\n                    ],\n                    value: true,\n                },\n            ],\n            default: false,\n        },\n    },\n    {\n        name: 'Element visible in viewport',\n        description: 'Fire when a DOM element becomes visible',\n        triggerWhen: {\n            type: 'rules',\n            rules: [\n                {\n                    conditions: [\n                        {\n                            type: 'anchor_visible',\n                            anchorId: '#pricing-section',\n                            state: 'visible',\n                        },\n                    ],\n                    value: true,\n                },\n            ],\n            default: false,\n        },\n    },\n    {\n        name: 'No trigger (fire immediately)',\n        description: 'Action fires as soon as the segment matches \u2014 no in-session condition needed',\n        triggerWhen: null,\n    },\n];\n/** Documentation for counter.match field keys. */\nexport const MATCH_FIELD_DOCS = {\n    tag_name: 'HTML tag name (e.g. \"button\", \"a\", \"input\")',\n    $el_text: 'Visible text content of the element',\n    'attr__*': 'HTML attribute prefixed with attr__. Example: attr__data-id matches the data-id attribute, ' +\n        'attr__class matches the class attribute, attr__href matches the href attribute.',\n};\n// =============================================================================\n// EVENT SCOPE SCHEMA\n// =============================================================================\n/** Scopes a widget to specific events/URLs. */\nexport const EventScopeZ = z.object({\n    events: z.array(z.string()),\n    urlContains: z.string().optional(),\n    props: z.record(z.union([z.string(), z.number(), z.boolean()])).optional(),\n});\n// =============================================================================\n// NOTIFY SCHEMA\n// =============================================================================\n/** Toast notification config for triggerWhen transitions. */\nexport const NotifyZ = z\n    .object({\n    title: z.string().optional(),\n    body: z.string().optional(),\n    icon: z.string().optional(),\n})\n    .nullable()\n    .optional();\n", "/**\n * @license\n * Copyright 2021 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * The Context type defines a type brand to associate a key value with the context value type\n */\nexport type Context<KeyType, ValueType> = KeyType & {__context__: ValueType};\n\n/**\n * @deprecated use Context instead\n */\nexport type ContextKey<KeyType, ValueType> = Context<KeyType, ValueType>;\n\n/**\n * A helper type which can extract a Context value type from a Context type\n */\nexport type ContextType<Key extends Context<unknown, unknown>> =\n  Key extends Context<unknown, infer ValueType> ? ValueType : never;\n\n/**\n * Creates a typed Context.\n *\n * Contexts are compared with strict equality.\n *\n * If you want two separate `createContext()` calls to referer to the same\n * context, then use a key that will by equal under strict equality like a\n * string for `Symbol.for()`:\n *\n * ```ts\n * // true\n * createContext('my-context') === createContext('my-context')\n * // true\n * createContext(Symbol.for('my-context')) === createContext(Symbol.for('my-context'))\n * ```\n *\n * If you want a context to be unique so that it's guaranteed to not collide\n * with other contexts, use a key that's unique under strict equality, like\n * a `Symbol()` or object.:\n *\n * ```\n * // false\n * createContext({}) === createContext({})\n * // false\n * createContext(Symbol('my-context')) === createContext(Symbol('my-context'))\n * ```\n *\n * @param key a context key value\n * @template ValueType the type of value that can be provided by this context.\n * @returns the context key value cast to `Context<K, ValueType>`\n */\nexport function createContext<ValueType, K = unknown>(key: K) {\n  return key as Context<K, ValueType>;\n}\n", "/**\n * Canvas runtime context \u2014 the shared @lit/context symbol both\n * runtime-sdk (the provider) and canvas-sdk / canvas authors (the\n * consumers) use to thread a narrow runtime handle through the canvas\n * element tree.\n *\n * Living here keeps the symbol identity stable across both packages.\n * If canvas-sdk created its own symbol with `createContext(...)`, it\n * would never match the one runtime-sdk publishes, and `<sc-mount>`\n * would silently see `undefined` instead of the widget registry.\n *\n * The shape declared here is a NARROW VIEW of `SmartCanvasRuntime`.\n * Canvas-side code reads only this subset. The runtime-sdk's\n * `SmartCanvasRuntime` type is a structural superset.\n */\nimport { createContext } from '@lit/context';\n/**\n * The @lit/context symbol. Both runtime-sdk's ContextProvider and\n * canvas-sdk's ContextConsumer must import THIS exact symbol \u2014 not a\n * symbol with the same string name \u2014 for context propagation to work.\n */\nexport const canvasRuntimeContext = createContext('syntrologie:canvas-runtime');\n", "/**\n * Canonical route normalization. See `routes.md` for rules and\n * `normalize-route.cases.json` for the parity corpus shared with the\n * Python implementation in syntrologie_common/sdk/routing.py.\n *\n * Two exports \u2014 `normalizeRoute` for literal paths, `normalizeRoutePattern`\n * for activation patterns containing `*`, `**`, `:param`. Today they share\n * an implementation because the rules happen to be wildcard-safe (no\n * lowercase, unreserved-only decode, slash collapse preserves `**`).\n * The seam is preserved as separate exports so the API can diverge\n * without consumer churn if rules change.\n */\n// RFC 3986 reserved characters (gen-delims + sub-delims). When a `%XX`\n// sequence decodes to one of these bytes, we keep the percent-encoded\n// form \u2014 decoding would re-segment the path or change its meaning.\nconst RESERVED_BYTES = new Set([\n    0x21, // !\n    0x23, // #\n    0x24, // $\n    0x26, // &\n    0x27, // '\n    0x28, // (\n    0x29, // )\n    0x2a, // *\n    0x2b, // +\n    0x2c, // ,\n    0x2f, // /\n    0x3a, // :\n    0x3b, // ;\n    0x3d, // =\n    0x3f, // ?\n    0x40, // @\n    0x5b, // [\n    0x5d, // ]\n]);\nconst utf8Decoder = new TextDecoder('utf-8', { fatal: false });\n/** Decode `%XX` sequences for unreserved bytes only. Collapses\n * adjacent `%XX` runs into a UTF-8 decode so `%C3%A9` \u2192 `\u00E9`. */\nfunction decodeUnreservedOnly(input) {\n    let out = '';\n    let pending = [];\n    const flushPending = () => {\n        if (pending.length === 0)\n            return;\n        const bytes = new Uint8Array(pending);\n        out += utf8Decoder.decode(bytes);\n        pending = [];\n    };\n    let i = 0;\n    while (i < input.length) {\n        const ch = input[i];\n        if (ch === '%' && i + 2 < input.length && isHex(input[i + 1]) && isHex(input[i + 2])) {\n            const byte = parseInt(input.slice(i + 1, i + 3), 16);\n            if (RESERVED_BYTES.has(byte)) {\n                flushPending();\n                // Keep raw, but normalize hex case to uppercase so the\n                // canonical form is stable across input casing.\n                out += `%${input.slice(i + 1, i + 3).toUpperCase()}`;\n                i += 3;\n            }\n            else {\n                pending.push(byte);\n                i += 3;\n            }\n        }\n        else {\n            flushPending();\n            out += ch;\n            i += 1;\n        }\n    }\n    flushPending();\n    return out;\n}\nfunction isHex(c) {\n    return (c >= '0' && c <= '9') || (c >= 'a' && c <= 'f') || (c >= 'A' && c <= 'F');\n}\n/** Strip query string and hash fragment. */\nfunction stripQueryAndHash(s) {\n    const q = s.indexOf('?');\n    if (q !== -1)\n        s = s.slice(0, q);\n    const h = s.indexOf('#');\n    if (h !== -1)\n        s = s.slice(0, h);\n    return s;\n}\n/**\n * Normalize a literal path (e.g. `window.location.pathname`, an\n * action's `route` field, a wiki route key).\n *\n * Throws `TypeError` if the input is not an absolute path. Callers\n * that want a soft API should use {@link normalizeRouteWithChange}.\n */\nexport function normalizeRoute(path) {\n    if (typeof path !== 'string' || path.length === 0) {\n        throw new TypeError('normalizeRoute: input must be a non-empty string');\n    }\n    if (!path.startsWith('/')) {\n        throw new TypeError(`normalizeRoute: input must be absolute (start with '/'); got ${JSON.stringify(path)}`);\n    }\n    let s = stripQueryAndHash(path);\n    s = decodeUnreservedOnly(s);\n    s = s.replace(/\\/+/g, '/');\n    if (s.length > 1 && s.endsWith('/'))\n        s = s.slice(0, -1);\n    return s;\n}\n/**\n * Normalize an activation route pattern. Preserves `*`, `**`,\n * `:param` exactly. Today equivalent to {@link normalizeRoute} \u2014 kept\n * as a separate export so rules can diverge later without API churn.\n */\nexport function normalizeRoutePattern(pattern) {\n    return normalizeRoute(pattern);\n}\n/**\n * Normalize a route and report whether the input was already\n * canonical. Used by authoring tools to decide whether to emit a\n * warning to the LLM.\n */\nexport function normalizeRouteWithChange(path) {\n    const canonical = normalizeRoute(path);\n    return { canonical, changed: canonical !== path };\n}\n/** Pattern-side counterpart of {@link normalizeRouteWithChange}. */\nexport function normalizeRoutePatternWithChange(pattern) {\n    const canonical = normalizeRoutePattern(pattern);\n    return { canonical, changed: canonical !== pattern };\n}\n/**\n * Case-insensitive comparison of two already-canonical paths. Use\n * this anywhere two routes are compared for equality (wiki lookups,\n * non-pattern action route gates) \u2014 preserves casing in the inputs\n * while honoring case-insensitive routing on the customer's site.\n */\nexport function routesMatch(a, b) {\n    return a.toLowerCase() === b.toLowerCase();\n}\n", "/**\n * Shared event contract for LLM-mounted tile lifecycle.\n *\n * Producer: `adaptive-chatbot`'s `TileHandler` publishes one of three\n * events whenever the LLM mounts/patches/unmounts a tile.\n *\n * Consumer: `runtime-sdk`'s `SmartCanvasElementLit` subscribes and\n * merges the resulting tiles into its slot-routing pipeline.\n *\n * Replay: `runtime-sdk` publishes `TILE_REPLAY_REQUEST_EVENT` whenever\n * it (re)subscribes; `adaptive-chatbot`'s ElementInstanceStore catches\n * that and re-publishes `TILE_MOUNTED_EVENT` for every active tile.\n *\n * This module is the single source of truth for the event names AND\n * the payload shapes. Both packages import the constants and the\n * `parseTile{Mounted,Patched,Unmounted}EventProps` helpers. Renaming a\n * field here is a TypeScript error on both sides \u2014 no silent drift.\n */\nexport const TILE_MOUNTED_EVENT = 'element.tile_mounted';\nexport const TILE_PATCHED_EVENT = 'element.tile_patched';\nexport const TILE_UNMOUNTED_EVENT = 'element.tile_unmounted';\nexport const TILE_REPLAY_REQUEST_EVENT = 'element.tile_replay_request';\n/**\n * Defensive parser for the event payload. Returns null on missing /\n * malformed fields rather than throwing. Subscribers MUST run the\n * incoming `event.props` through this so a contract drift surfaces as\n * a no-op log line, not a render crash.\n */\nexport function parseTileMountedEventProps(raw) {\n    if (!raw || typeof raw !== 'object')\n        return null;\n    const r = raw;\n    const slot = typeof r.slot === 'string' ? r.slot : '';\n    const instance_id = typeof r.instance_id === 'string' ? r.instance_id : '';\n    const widget = typeof r.widget === 'string' ? r.widget : '';\n    if (!slot || !instance_id || !widget)\n        return null;\n    const props = r.props && typeof r.props === 'object' ? r.props : {};\n    return { slot, instance_id, widget, props };\n}\nexport function parseTileUnmountedEventProps(raw) {\n    if (!raw || typeof raw !== 'object')\n        return null;\n    const r = raw;\n    const slot = typeof r.slot === 'string' ? r.slot : '';\n    const instance_id = typeof r.instance_id === 'string' ? r.instance_id : '';\n    if (!instance_id)\n        return null;\n    return { slot, instance_id };\n}\n"],
+  "mappings": "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",
+  "names": ["createContext", "key"]
+}

package/dist/editor-lit.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Adaptive Chatbot — Editor (Lit web component).
+ *
+ * Custom element: <se-chatbot-editor>
+ *
+ * Lit port of editor.tsx. Form-based: edits backendUrl, mlflowRunId,
+ * greeting, maxHistory and emits change events. No sub-items, no list view.
+ *
+ * Properties:
+ * - `config: ChatbotConfig | undefined` — current chatbot tile props
+ * - `onChange: (updatedAppConfig) => void` — callback fired when a field changes
+ *
+ * Events (bubbling, composed):
+ * - `navigate-home` — back button
+ * - `dirty-change` (detail: { dirty: boolean }) — emit dirty=true on first edit
+ */
+import { LitElement } from 'lit';
+type AppConfig = Record<string, unknown>;
+export declare class ChatbotEditorLit extends LitElement {
+    static properties: {
+        config: {
+            attribute: boolean;
+        };
+        onChange: {
+            attribute: boolean;
+        };
+    };
+    config: AppConfig | undefined;
+    onChange: ((updated: AppConfig) => void) | undefined;
+    private _emittedDirty;
+    createRenderRoot(): this;
+    private _handleField;
+    private _navigateHome;
+    render(): import("lit-html").TemplateResult<1>;
+}
+export {};
+//# sourceMappingURL=editor-lit.d.ts.map

package/dist/editor-lit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-lit.d.ts","sourceRoot":"","sources":["../src/editor-lit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAQ,UAAU,EAAE,MAAM,KAAK,CAAC;AAIvC,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEzC,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAgB,UAAU;;;;;;;MAGxB;IAEF,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAErD,OAAO,CAAC,aAAa,CAAS;IAErB,gBAAgB;IAIzB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,aAAa;IAIZ,MAAM;CAkGhB"}

package/dist/editor-lit.js

@@ -0,0 +1,134 @@
+import "./chunk-UVKRO5ER.js";
+
+// src/editor-lit.ts
+import { html, LitElement } from "lit";
+var ChatbotEditorLit = class extends LitElement {
+  constructor() {
+    super(...arguments);
+    this._emittedDirty = false;
+  }
+  createRenderRoot() {
+    return this;
+  }
+  _handleField(field, value) {
+    if (!this.config) return;
+    const next = { ...this.config, [field]: value };
+    this.onChange?.(next);
+    if (!this._emittedDirty) {
+      this._emittedDirty = true;
+      this.dispatchEvent(
+        new CustomEvent("dirty-change", {
+          detail: { dirty: true },
+          bubbles: true,
+          composed: true
+        })
+      );
+    }
+  }
+  _navigateHome() {
+    this.dispatchEvent(new CustomEvent("navigate-home", { bubbles: true, composed: true }));
+  }
+  render() {
+    const cfg = this.config ?? {};
+    return html`
+      <div class="se-flex se-flex-col se-h-full se-font-sans">
+        <!-- Header -->
+        <div class="se-px-4 se-pt-3 se-pb-1 se-flex se-items-center se-gap-3">
+          <button
+            type="button"
+            @click=${() => this._navigateHome()}
+            class="se-py-1.5 se-px-3 se-rounded-md se-border-none se-bg-card-bg se-text-text-primary se-text-sm se-cursor-pointer"
+          >← Back</button>
+          <div class="se-flex se-flex-col">
+            <h2 class="se-m-0 se-text-base se-font-semibold se-text-text-primary">Chat Assistant</h2>
+            <p class="se-mt-0.5 se-mb-0 se-text-xs se-text-text-secondary">
+              Configure AI chat assistant
+            </p>
+          </div>
+        </div>
+
+        <div class="se-flex-1 se-overflow-auto se-px-4 se-py-3">
+          <!-- API Configuration -->
+          <div class="se-mb-6">
+            <div
+              class="se-text-xs se-font-semibold se-text-text-secondary se-uppercase se-tracking-wide se-mb-3"
+            >
+              API Configuration
+            </div>
+
+            <label class="se-block se-mb-3">
+              <span class="se-block se-text-xs se-text-text-secondary se-mb-1">Backend URL</span>
+              <input
+                type="text"
+                .value=${cfg.backendUrl ?? ""}
+                placeholder="/api/chat/message"
+                class="se-w-full se-py-2 se-px-3 se-rounded-md se-border se-border-input-field-border se-bg-input-field-bg se-text-text-primary se-text-sm focus:se-outline-none focus:se-border-input-field-border-selected"
+                @input=${(e) => this._handleField("backendUrl", e.target.value)}
+              />
+            </label>
+
+            <label class="se-block se-mb-3">
+              <span class="se-block se-text-xs se-text-text-secondary se-mb-1">
+                MLflow Run ID (optional)
+              </span>
+              <input
+                type="text"
+                .value=${cfg.mlflowRunId ?? ""}
+                placeholder="e.g., abc123"
+                class="se-w-full se-py-2 se-px-3 se-rounded-md se-border se-border-input-field-border se-bg-input-field-bg se-text-text-primary se-text-sm focus:se-outline-none focus:se-border-input-field-border-selected"
+                @input=${(e) => this._handleField("mlflowRunId", e.target.value)}
+              />
+            </label>
+          </div>
+
+          <!-- Chat Settings -->
+          <div class="se-mb-6">
+            <div
+              class="se-text-xs se-font-semibold se-text-text-secondary se-uppercase se-tracking-wide se-mb-3"
+            >
+              Chat Settings
+            </div>
+
+            <label class="se-block se-mb-3">
+              <span class="se-block se-text-xs se-text-text-secondary se-mb-1">Greeting Message</span>
+              <textarea
+                aria-label="Greeting Message"
+                .value=${cfg.greeting ?? ""}
+                placeholder="Hi! How can I help?"
+                rows="2"
+                class="se-w-full se-py-2 se-px-3 se-rounded-md se-border se-border-input-field-border se-bg-input-field-bg se-text-text-primary se-text-sm se-resize-none focus:se-outline-none focus:se-border-input-field-border-selected"
+                @input=${(e) => this._handleField("greeting", e.target.value)}
+              ></textarea>
+            </label>
+
+            <label class="se-block se-mb-3">
+              <span class="se-block se-text-xs se-text-text-secondary se-mb-1">
+                Max History (messages sent to backend)
+              </span>
+              <input
+                type="number"
+                .value=${String(cfg.maxHistory ?? 20)}
+                min="1"
+                max="100"
+                class="se-w-full se-py-2 se-px-3 se-rounded-md se-border se-border-input-field-border se-bg-input-field-bg se-text-text-primary se-text-sm focus:se-outline-none focus:se-border-input-field-border-selected"
+                @input=${(e) => {
+      const n = parseInt(e.target.value, 10);
+      if (!Number.isNaN(n)) this._handleField("maxHistory", n);
+    }}
+              />
+            </label>
+          </div>
+        </div>
+      </div>
+    `;
+  }
+};
+ChatbotEditorLit.properties = {
+  config: { attribute: false },
+  onChange: { attribute: false }
+};
+customElements.define("se-chatbot-editor", ChatbotEditorLit);
+export {
+  ChatbotEditorLit
+};
+//# sourceMappingURL=editor-lit.js.map

package/dist/editor-lit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/editor-lit.ts"],
+  "sourcesContent": ["/**\n * Adaptive Chatbot \u2014 Editor (Lit web component).\n *\n * Custom element: <se-chatbot-editor>\n *\n * Lit port of editor.tsx. Form-based: edits backendUrl, mlflowRunId,\n * greeting, maxHistory and emits change events. No sub-items, no list view.\n *\n * Properties:\n * - `config: ChatbotConfig | undefined` \u2014 current chatbot tile props\n * - `onChange: (updatedAppConfig) => void` \u2014 callback fired when a field changes\n *\n * Events (bubbling, composed):\n * - `navigate-home` \u2014 back button\n * - `dirty-change` (detail: { dirty: boolean }) \u2014 emit dirty=true on first edit\n */\n\nimport { html, LitElement } from 'lit';\n\nimport type { ChatbotConfig } from './types';\n\ntype AppConfig = Record<string, unknown>;\n\nexport class ChatbotEditorLit extends LitElement {\n  static override properties = {\n    config: { attribute: false },\n    onChange: { attribute: false },\n  };\n\n  config: AppConfig | undefined;\n  onChange: ((updated: AppConfig) => void) | undefined;\n\n  private _emittedDirty = false;\n\n  override createRenderRoot() {\n    return this;\n  }\n\n  private _handleField(field: keyof ChatbotConfig, value: string | number) {\n    if (!this.config) return;\n    const next = { ...(this.config as Partial<ChatbotConfig>), [field]: value };\n    this.onChange?.(next as AppConfig);\n\n    if (!this._emittedDirty) {\n      this._emittedDirty = true;\n      this.dispatchEvent(\n        new CustomEvent('dirty-change', {\n          detail: { dirty: true },\n          bubbles: true,\n          composed: true,\n        })\n      );\n    }\n  }\n\n  private _navigateHome() {\n    this.dispatchEvent(new CustomEvent('navigate-home', { bubbles: true, composed: true }));\n  }\n\n  override render() {\n    const cfg = (this.config ?? {}) as Partial<ChatbotConfig>;\n\n    return html`\n      <div class=\"se-flex se-flex-col se-h-full se-font-sans\">\n        <!-- Header -->\n        <div class=\"se-px-4 se-pt-3 se-pb-1 se-flex se-items-center se-gap-3\">\n          <button\n            type=\"button\"\n            @click=${() => this._navigateHome()}\n            class=\"se-py-1.5 se-px-3 se-rounded-md se-border-none se-bg-card-bg se-text-text-primary se-text-sm se-cursor-pointer\"\n          >\u2190 Back</button>\n          <div class=\"se-flex se-flex-col\">\n            <h2 class=\"se-m-0 se-text-base se-font-semibold se-text-text-primary\">Chat Assistant</h2>\n            <p class=\"se-mt-0.5 se-mb-0 se-text-xs se-text-text-secondary\">\n              Configure AI chat assistant\n            </p>\n          </div>\n        </div>\n\n        <div class=\"se-flex-1 se-overflow-auto se-px-4 se-py-3\">\n          <!-- API Configuration -->\n          <div class=\"se-mb-6\">\n            <div\n              class=\"se-text-xs se-font-semibold se-text-text-secondary se-uppercase se-tracking-wide se-mb-3\"\n            >\n              API Configuration\n            </div>\n\n            <label class=\"se-block se-mb-3\">\n              <span class=\"se-block se-text-xs se-text-text-secondary se-mb-1\">Backend URL</span>\n              <input\n                type=\"text\"\n                .value=${cfg.backendUrl ?? ''}\n                placeholder=\"/api/chat/message\"\n                class=\"se-w-full se-py-2 se-px-3 se-rounded-md se-border se-border-input-field-border se-bg-input-field-bg se-text-text-primary se-text-sm focus:se-outline-none focus:se-border-input-field-border-selected\"\n                @input=${(e: Event) =>\n                  this._handleField('backendUrl', (e.target as HTMLInputElement).value)}\n              />\n            </label>\n\n            <label class=\"se-block se-mb-3\">\n              <span class=\"se-block se-text-xs se-text-text-secondary se-mb-1\">\n                MLflow Run ID (optional)\n              </span>\n              <input\n                type=\"text\"\n                .value=${cfg.mlflowRunId ?? ''}\n                placeholder=\"e.g., abc123\"\n                class=\"se-w-full se-py-2 se-px-3 se-rounded-md se-border se-border-input-field-border se-bg-input-field-bg se-text-text-primary se-text-sm focus:se-outline-none focus:se-border-input-field-border-selected\"\n                @input=${(e: Event) =>\n                  this._handleField('mlflowRunId', (e.target as HTMLInputElement).value)}\n              />\n            </label>\n          </div>\n\n          <!-- Chat Settings -->\n          <div class=\"se-mb-6\">\n            <div\n              class=\"se-text-xs se-font-semibold se-text-text-secondary se-uppercase se-tracking-wide se-mb-3\"\n            >\n              Chat Settings\n            </div>\n\n            <label class=\"se-block se-mb-3\">\n              <span class=\"se-block se-text-xs se-text-text-secondary se-mb-1\">Greeting Message</span>\n              <textarea\n                aria-label=\"Greeting Message\"\n                .value=${cfg.greeting ?? ''}\n                placeholder=\"Hi! How can I help?\"\n                rows=\"2\"\n                class=\"se-w-full se-py-2 se-px-3 se-rounded-md se-border se-border-input-field-border se-bg-input-field-bg se-text-text-primary se-text-sm se-resize-none focus:se-outline-none focus:se-border-input-field-border-selected\"\n                @input=${(e: Event) =>\n                  this._handleField('greeting', (e.target as HTMLTextAreaElement).value)}\n              ></textarea>\n            </label>\n\n            <label class=\"se-block se-mb-3\">\n              <span class=\"se-block se-text-xs se-text-text-secondary se-mb-1\">\n                Max History (messages sent to backend)\n              </span>\n              <input\n                type=\"number\"\n                .value=${String(cfg.maxHistory ?? 20)}\n                min=\"1\"\n                max=\"100\"\n                class=\"se-w-full se-py-2 se-px-3 se-rounded-md se-border se-border-input-field-border se-bg-input-field-bg se-text-text-primary se-text-sm focus:se-outline-none focus:se-border-input-field-border-selected\"\n                @input=${(e: Event) => {\n                  const n = parseInt((e.target as HTMLInputElement).value, 10);\n                  if (!Number.isNaN(n)) this._handleField('maxHistory', n);\n                }}\n              />\n            </label>\n          </div>\n        </div>\n      </div>\n    `;\n  }\n}\n\ncustomElements.define('se-chatbot-editor', ChatbotEditorLit);\n"],
+  "mappings": ";;;AAiBA,SAAS,MAAM,kBAAkB;AAM1B,IAAM,mBAAN,cAA+B,WAAW;AAAA,EAA1C;AAAA;AASL,SAAQ,gBAAgB;AAAA;AAAA,EAEf,mBAAmB;AAC1B,WAAO;AAAA,EACT;AAAA,EAEQ,aAAa,OAA4B,OAAwB;AACvE,QAAI,CAAC,KAAK,OAAQ;AAClB,UAAM,OAAO,EAAE,GAAI,KAAK,QAAmC,CAAC,KAAK,GAAG,MAAM;AAC1E,SAAK,WAAW,IAAiB;AAEjC,QAAI,CAAC,KAAK,eAAe;AACvB,WAAK,gBAAgB;AACrB,WAAK;AAAA,QACH,IAAI,YAAY,gBAAgB;AAAA,UAC9B,QAAQ,EAAE,OAAO,KAAK;AAAA,UACtB,SAAS;AAAA,UACT,UAAU;AAAA,QACZ,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,gBAAgB;AACtB,SAAK,cAAc,IAAI,YAAY,iBAAiB,EAAE,SAAS,MAAM,UAAU,KAAK,CAAC,CAAC;AAAA,EACxF;AAAA,EAES,SAAS;AAChB,UAAM,MAAO,KAAK,UAAU,CAAC;AAE7B,WAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAMU,MAAM,KAAK,cAAc,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAwBtB,IAAI,cAAc,EAAE;AAAA;AAAA;AAAA,yBAGpB,CAAC,MACR,KAAK,aAAa,cAAe,EAAE,OAA4B,KAAK,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAU9D,IAAI,eAAe,EAAE;AAAA;AAAA;AAAA,yBAGrB,CAAC,MACR,KAAK,aAAa,eAAgB,EAAE,OAA4B,KAAK,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAiB/D,IAAI,YAAY,EAAE;AAAA;AAAA;AAAA;AAAA,yBAIlB,CAAC,MACR,KAAK,aAAa,YAAa,EAAE,OAA+B,KAAK,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAU/D,OAAO,IAAI,cAAc,EAAE,CAAC;AAAA;AAAA;AAAA;AAAA,yBAI5B,CAAC,MAAa;AACrB,YAAM,IAAI,SAAU,EAAE,OAA4B,OAAO,EAAE;AAC3D,UAAI,CAAC,OAAO,MAAM,CAAC,EAAG,MAAK,aAAa,cAAc,CAAC;AAAA,IACzD,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOf;AACF;AAtIa,iBACK,aAAa;AAAA,EAC3B,QAAQ,EAAE,WAAW,MAAM;AAAA,EAC3B,UAAU,EAAE,WAAW,MAAM;AAC/B;AAoIF,eAAe,OAAO,qBAAqB,gBAAgB;",
+  "names": []
+}

package/dist/elements/ActionHandler.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Action element handler — dispatches an ActionStep through
+ * `ActionEngine.applyBatch`.
+ *
+ * The `content` field of an action `MountedElement` carries the action's
+ * params; the executor `kind` comes from the template (which the SDK
+ * doesn't have locally yet — for v1 the template's `kind` is encoded
+ * into `content.__kind`, set by the backend tool). When proper
+ * template loading lands on the SDK side, this handler resolves the
+ * kind from the loaded template instead.
+ *
+ * **Imperative actions never re-fire on boot.** The `lifecycle` field
+ * here is `imperative` — `ElementInstanceStore` skips boot rehydrate
+ * for imperative instances with `state === 'applied'`. The backend
+ * record exists for audit; replaying a scroll/navigate on every page
+ * load would be visibly wrong.
+ *
+ * Stateful actions (e.g. `content:insertHtml`, `content:setText`,
+ * `content:addClass` once Phase 7's renderer lands) ARE re-applied on
+ * boot. v1 supports the imperative shape; stateful action handling
+ * waits on the Portable Text renderer.
+ */
+import type { ElementHandlerContext, ElementTypeHandler, ValidateResult } from './ElementTypeHandler';
+import type { MountedElement } from './types';
+export declare class ActionHandler implements ElementTypeHandler {
+    readonly typeName: "action";
+    readonly lifecycle: "imperative";
+    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>;
+    private _actionFromInstance;
+}
+//# sourceMappingURL=ActionHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionHandler.d.ts","sourceRoot":"","sources":["../../src/elements/ActionHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,qBAAa,aAAc,YAAW,kBAAkB;IACtD,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAU;IAGtC,QAAQ,CAAC,SAAS,EAAG,YAAY,CAAU;IAE3C,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,qBAAqB,GAAG,cAAc;IAWzE,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1E,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1E,OAAO,CAAC,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpF,OAAO,CAAC,mBAAmB;CAiC5B"}

package/dist/elements/ElementInstanceStore.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Type-neutral store for LLM-authored UI element instances — Phase 6.
+ *
+ * On SDK boot:
+ *   1. Caller fetches `/api/adaptive/mounted_elements` (see `fetcher.ts`).
+ *   2. Calls `store.hydrate(response.mounted_elements)`.
+ *   3. The store iterates each instance, looks up its handler, and
+ *      either mounts (stateful) or skips (imperative already-applied).
+ *
+ * During chat turns:
+ *   - AGUI `syntro.element.mutation` envelopes arrive via
+ *     `AgUiTransport.onA2UIEvent`. The transport caller decodes the
+ *     envelope and invokes `store.apply(envelope.mutations)`.
+ *
+ * Concurrency / dedup:
+ *   - Per-instance `version` is the dedup key. A mutation whose version
+ *     is `<= currentVersion` is treated as already-applied and silently
+ *     dropped — handles the SSE-during-boot-fetch race per the design
+ *     doc (the live mutation might arrive before the boot snapshot does,
+ *     and the snapshot is then a no-op).
+ *   - The store is single-threaded by Node/browser convention; no
+ *     cross-tab sync in v1.
+ *
+ * The store delegates all DOM work to per-type handlers
+ * (`ElementTypeHandler`). It owns the registry, the in-memory state,
+ * and the dispatch logic.
+ */
+import type { ActionEngine } from '../types';
+import type { ElementTypeHandler } from './ElementTypeHandler';
+import type { ElementMutation, MountedElement } from './types';
+export interface ElementInstanceStoreOptions {
+    actions: ActionEngine;
+    /** Runtime's event bus. ItemHandler publishes
+     *  `element.compositional_append` events here so container widgets
+     *  (chips strip, FAQ accordion, nav tips) can subscribe and inject
+     *  LLM-authored items into their compositional-actions lists.
+     *
+     *  When `subscribe` is also provided, the store listens for
+     *  `element.compositional_replay_request` events. A container widget
+     *  publishes this event with its `tile_id` whenever it subscribes
+     *  (e.g. on first mount AND on SPA-navigation remount); the store
+     *  responds by re-publishing `element.compositional_append` for every
+     *  matching item still in its in-memory map. This is what makes
+     *  LLM-authored items persist across navigations within the page
+     *  session — the store survives chat-bar unmount/remount, container
+     *  widgets re-pull on each fresh mount.
+     */
+    events?: {
+        publish: (name: string, props?: Record<string, unknown>) => void;
+        /**
+         * Overloaded to match the runtime SDK's `EventBus.subscribe`:
+         * pass `{names:[...]}` to filter, or a callback to receive every
+         * event. The store uses the filtered form so it doesn't fan
+         * unrelated traffic (PostHog autocapture, every action lifecycle
+         * event) into a string-compare on each delivery.
+         */
+        subscribe?: {
+            (filter: {
+                names?: string[];
+            }, handler: (event: {
+                name: string;
+                props?: Record<string, unknown>;
+            }) => void): () => void;
+            (handler: (event: {
+                name: string;
+                props?: Record<string, unknown>;
+            }) => void): () => void;
+        };
+    };
+    handlers?: ElementTypeHandler[];
+    /** Override the logger — used by tests to capture log output. */
+    logger?: Pick<Console, 'info' | 'warn' | 'error'>;
+    /**
+     * Optional template→widget resolver used by the rehydrate replay.
+     * Without this, replayed tile mounts emit ``widget: template_id``,
+     * which only works when the admin's template ids match the widget
+     * registry (e.g. ``adaptive-faq:accordion``). When an admin uses a
+     * friendly id like ``product-card`` mapping to widget
+     * ``adaptive-product:card``, the rehydrate path needs the resolver
+     * to match the live mount path.
+     *
+     * Same shape as ``TileHandler``'s resolver — pass the same function
+     * to both so live mounts and replays agree on the widget id.
+     */
+    resolveTileWidget?: (templateId: string) => string | undefined;
+}
+export declare class ElementInstanceStore {
+    private readonly _actions;
+    private readonly _events;
+    private readonly _handlers;
+    private readonly _instances;
+    private readonly _logger;
+    private readonly _resolveTileWidget?;
+    /** Active TTL timeout — replaced on each call to `scheduleClientTtl`. */
+    private _ttlTimer;
+    constructor(options: ElementInstanceStoreOptions);
+    /**
+     * Listen for `element.compositional_replay_request` from container
+     * widgets and re-publish `element.compositional_append` for every
+     * matching item still tracked in `_instances`. This keeps LLM-authored
+     * items visible across SPA navigations: the store is a module-level
+     * singleton that survives chat-bar unmount/remount, so when a fresh
+     * chips-strip mounts and subscribes, asking for a replay re-populates
+     * its chip array.
+     */
+    private _subscribeReplayRequests;
+    private _replayItems;
+    private _replayTiles;
+    registerHandler(handler: ElementTypeHandler): void;
+    /**
+     * Apply the server-provided boot snapshot. For each instance:
+     *   - stateful: validated + mounted via the type handler;
+     *   - imperative + already-applied: recorded only (no DOM action);
+     *   - any: tracked in the in-memory map for future patches.
+     *
+     * Safe to call once on SDK init. Calling again would re-mount
+     * stateful instances; callers should not.
+     */
+    hydrate(snapshot: MountedElement[]): Promise<void>;
+    /**
+     * Re-publish `element.tile_mounted` / `element.compositional_append`
+     * for every active LLM-authored instance in the store. Idempotent —
+     * receivers key by `instance_id` (tiles) or by widget identity
+     * (items via tile_id filter).
+     */
+    private _broadcastActive;
+    /**
+     * Apply a batch of mutations, atomically per-batch. Each mutation is
+     * version-checked (mount: must not conflict with existing instance;
+     * patch: resulting_version must be > current; unmount: idempotent).
+     */
+    apply(mutations: ElementMutation[]): Promise<void>;
+    /** Read-only snapshot of currently-known instances. */
+    getInstances(): MountedElement[];
+    getInstance(instance_id: string): MountedElement | undefined;
+    /**
+     * Schedule a client-side TTL that unmounts every active stateful
+     * instance when the server-side session expires. Replaces any
+     * previously-scheduled TTL.
+     *
+     * Avoids the orphan-window where session-expired tiles linger on the
+     * page until manual refresh — the server forgets at the 4h mark and
+     * the SDK tears down concurrently. Re-schedule on each boot fetch /
+     * mutation event that carries a refreshed `session_expires_at`.
+     *
+     * Pass `null` to clear the existing timer without scheduling a new one.
+     * Pass a past timestamp to trigger cleanup immediately.
+     */
+    scheduleClientTtl(session_expires_at: string | null): void;
+    private _handleSessionExpiry;
+    private _applyOne;
+    private _mount;
+    private _ctx;
+}
+//# sourceMappingURL=ElementInstanceStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElementInstanceStore.d.ts","sourceRoot":"","sources":["../../src/elements/ElementInstanceStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAyB,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK/D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,YAAY,CAAC;IACtB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;QACjE;;;;;;WAMG;QACH,SAAS,CAAC,EAAE;YACV,CACE,MAAM,EAAE;gBAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;aAAE,EAC5B,OAAO,EAAE,CAAC,KAAK,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,KAAK,IAAI,GAC1E,MAAM,IAAI,CAAC;YACd,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;SAC3F,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAClD;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAChE;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0C;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAA6C;IACjF,yEAAyE;IACzE,OAAO,CAAC,SAAS,CAA8C;gBAEnD,OAAO,EAAE,2BAA2B;IAYhD;;;;;;;;OAQG;IACH,OAAO,CAAC,wBAAwB;IAuBhC,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;IAepB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAIlD;;;;;;;;OAQG;IACG,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CxD;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxD,uDAAuD;IACvD,YAAY,IAAI,cAAc,EAAE;IAIhC,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI5D;;;;;;;;;;;;OAYG;IACH,iBAAiB,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;YAuB5C,oBAAoB;YAkBpB,SAAS;YAsGT,MAAM;IAyBpB,OAAO,CAAC,IAAI;CAGb"}

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

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

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

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

package/dist/elements/ElementTypeHandler.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Per-type handler interface for `ElementInstanceStore`.
+ *
+ * Adding a future element type (overlay / tour / form) is one new
+ * `ElementTypeHandler` implementation registered in the store —
+ * `ElementInstanceStore` itself stays type-neutral.
+ *
+ * Handlers own their per-type lifecycle. They receive the current
+ * `MountedElement` snapshot and the runtime's `ActionEngine` and either
+ * call `applyBatch` to drive DOM changes or hold on to returned
+ * `ActionHandle`s for later cleanup.
+ *
+ * Design choices the handlers MUST honor:
+ *
+ * - **Imperative actions never re-fire on boot.** When the store
+ *   hydrates an element with `lifecycle === 'imperative'` and `state ===
+ *   'applied'`, the handler's `mount()` is NOT called. The backend
+ *   records the prior invocation for audit but the SDK does not replay
+ *   it (would re-scroll, re-navigate, etc.).
+ * - **Defense-in-depth content validation.** `validate()` is called
+ *   before every mount/patch. The backend already validated, but the
+ *   handler should refuse malformed content so a buggy server can't
+ *   crash the runtime.
+ */
+import type { ActionEngine } from '../types';
+import type { ElementMutation, MountedElement } from './types';
+/** Lifecycle classification used to decide whether to apply on boot rehydrate. */
+export type ElementLifecycle = 'stateful' | 'imperative' | 'ephemeral';
+export interface ElementHandlerContext {
+    /** Runtime's ActionEngine — handlers use `applyBatch` to drive DOM
+     *  changes via existing executors (`core:mountWidget`, etc.). */
+    actions: ActionEngine;
+    /** Runtime's event bus — handlers publish typed events that container
+     *  widgets subscribe to. Used by `ItemHandler` to broadcast
+     *  `element.compositional_append` so chip-strip / FAQ / nav-tips
+     *  containers can insert LLM-authored items.
+     *  Optional so test fixtures that exercise only DOM action handlers
+     *  don't need to stub the bus.
+     */
+    events?: {
+        publish: (name: string, props?: Record<string, unknown>) => void;
+    };
+}
+export type ValidateResult = {
+    accepted: true;
+} | {
+    accepted: false;
+    reason: string;
+    detail?: string;
+};
+export interface ElementTypeHandler {
+    readonly typeName: 'tile' | 'action' | 'item';
+    /** Whether the handler's elements survive a boot rehydrate. Imperative
+     *  handlers (action handler in v1) DO NOT replay applied instances. */
+    readonly lifecycle: ElementLifecycle;
+    /** Defense-in-depth — refuse malformed content/placement before the
+     *  handler touches the DOM. The store calls this before `mount` and
+     *  `patch`; a rejection is logged but does not throw — the store
+     *  records the rejection on the instance and skips the apply. */
+    validate(instance: MountedElement, ctx: ElementHandlerContext): ValidateResult;
+    /** Apply a new mount to the DOM. Called once per mount; the store
+     *  passes the instance object so the handler can read `placement`,
+     *  `content`, `template_id`, etc. */
+    mount(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+    /** Apply a patch — typically by re-mounting the widget with merged
+     *  content. v1 has no fine-grained reactivity; full re-mount is
+     *  expected. */
+    patch(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+    /** Remove the element from the DOM. Idempotent — called for both
+     *  user-initiated unmounts and TTL-triggered cleanup. */
+    unmount(instance: MountedElement, ctx: ElementHandlerContext): Promise<void>;
+}
+export interface ElementMutationContext extends ElementHandlerContext {
+    /** Op being processed — handler-side telemetry / debug surface. */
+    mutation: ElementMutation;
+}
+//# sourceMappingURL=ElementTypeHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ElementTypeHandler.d.ts","sourceRoot":"","sources":["../../src/elements/ElementTypeHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/D,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACpC;qEACiE;IACjE,OAAO,EAAE,YAAY,CAAC;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE;QACP,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;KAClE,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,EAAE,IAAI,CAAA;CAAE,GAClB;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAE9C;2EACuE;IACvE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IAErC;;;qEAGiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,cAAc,CAAC;IAE/E;;yCAEqC;IACrC,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;oBAEgB;IAChB,KAAK,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;6DACyD;IACzD,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,mEAAmE;IACnE,QAAQ,EAAE,eAAe,CAAC;CAC3B"}