@syntrologie/runtime-sdk 2.12.0 → 2.14.0

package/dist/smart-canvas.js

@@ -12802,6 +12802,7 @@ var SyntrologieSDK = (() => {
     HighlightZ: () => HighlightZ,
     InsertHtmlZ: () => InsertHtmlZ,
     InsertPositionZ: () => InsertPositionZ,
+    InterventionTracker: () => InterventionTracker,
     MAX_VISIBLE_TOASTS: () => MAX_VISIBLE_TOASTS,
     MatchOpZ: () => MatchOpZ,
     ModalContentZ: () => ModalContentZ,
@@ -20608,7 +20609,13 @@ Please report this to https://github.com/markedjs/marked.`, e2) {
   }
 
   // src/fetchers/mergeConfigs.ts
-  function resolveVariantConfigs(client, keys, _strategy = "first-match") {
+  function resolveVariantConfigs(client, keys, strategy = "merge") {
+    if (strategy === "first-match") {
+      return resolveFirstMatch(client, keys);
+    }
+    return resolveMerge(client, keys);
+  }
+  function resolveFirstMatch(client, keys) {
     for (const key of keys) {
       const value = client.getFeatureValue?.(key, null);
       if (!value || typeof value !== "object") continue;
@@ -20616,20 +20623,59 @@ Please report this to https://github.com/markedjs/marked.`, e2) {
       const hasTiles = variant.tiles && variant.tiles.length > 0;
       const hasActions = variant.actions && variant.actions.length > 0;
       if (hasTiles || hasActions) {
-        return {
-          tiles: variant.tiles ?? [],
-          actions: variant.actions ?? [],
-          fetchedAt: variant.fetchedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-          ...variant.schemaVersion && { schemaVersion: variant.schemaVersion },
-          ...variant.configVersion && { configVersion: variant.configVersion },
-          ...variant.canvasTitle && { canvasTitle: variant.canvasTitle },
-          ...variant.theme && { theme: variant.theme },
-          ...variant.launcher && { launcher: variant.launcher }
-        };
+        return buildConfig([variant]);
       }
     }
     return null;
   }
+  function resolveMerge(client, keys) {
+    const variants = [];
+    for (const key of keys) {
+      const value = client.getFeatureValue?.(key, null);
+      if (!value || typeof value !== "object") continue;
+      const variant = value;
+      const hasTiles = variant.tiles && variant.tiles.length > 0;
+      const hasActions = variant.actions && variant.actions.length > 0;
+      if (hasTiles || hasActions) {
+        variants.push(variant);
+      }
+    }
+    if (variants.length === 0) return null;
+    return buildConfig(variants);
+  }
+  function buildConfig(variants) {
+    const allTiles = [];
+    const allActions = [];
+    let fetchedAt;
+    let schemaVersion;
+    let configVersion;
+    let canvasTitle;
+    let theme;
+    let launcher;
+    let meta;
+    for (const variant of variants) {
+      if (variant.tiles) allTiles.push(...variant.tiles);
+      if (variant.actions) allActions.push(...variant.actions);
+      fetchedAt ?? (fetchedAt = variant.fetchedAt);
+      schemaVersion ?? (schemaVersion = variant.schemaVersion);
+      configVersion ?? (configVersion = variant.configVersion);
+      canvasTitle ?? (canvasTitle = variant.canvasTitle);
+      theme ?? (theme = variant.theme);
+      launcher ?? (launcher = variant.launcher);
+      meta ?? (meta = variant.meta);
+    }
+    return {
+      tiles: allTiles,
+      actions: allActions,
+      fetchedAt: fetchedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+      ...schemaVersion && { schemaVersion },
+      ...configVersion && { configVersion },
+      ...canvasTitle && { canvasTitle },
+      ...theme && { theme },
+      ...launcher && { launcher },
+      ...meta && { meta }
+    };
+  }
 
   // src/logger.ts
   var debugEnabled = false;
@@ -20677,7 +20723,7 @@ Please report this to https://github.com/markedjs/marked.`, e2) {
   }
 
   // src/version.ts
-  var SDK_VERSION = "2.12.0";
+  var SDK_VERSION = "2.14.0";
 
   // src/types.ts
   var SDK_SCHEMA_VERSION = "2.0";
@@ -20761,9 +20807,8 @@ Please report this to https://github.com/markedjs/marked.`, e2) {
     featureKey
   }) => {
     if (configUri) return configUri;
-    if (experiments) {
-      const key = featureKey ?? "smart-canvas-config";
-      const fromFeature = experiments.getFeatureValue?.(key, null);
+    if (experiments && featureKey) {
+      const fromFeature = experiments.getFeatureValue?.(featureKey, null);
       if (fromFeature) return fromFeature;
     }
     return void 0;
@@ -20795,9 +20840,8 @@ Please report this to https://github.com/markedjs/marked.`, e2) {
     variantFlagPrefix,
     sdkVersion
   }) => async () => {
-    const effectiveConfigKey = configFeatureKey ?? "smart-canvas-config";
-    if (experiments) {
-      const directConfig = experiments.getFeatureValue?.(effectiveConfigKey, null);
+    if (experiments && configFeatureKey) {
+      const directConfig = experiments.getFeatureValue?.(configFeatureKey, null);
       if (directConfig && typeof directConfig === "object") {
         debug("SmartCanvas Config", "Resolved config directly from feature flag", directConfig);
         return directConfig;
@@ -21846,6 +21890,36 @@ Please report this to https://github.com/markedjs/marked.`, e2) {
     return eventName.replace("$", "posthog.");
   }
   var INTERACTIVE_TAGS = /* @__PURE__ */ new Set(["a", "button", "input", "select", "textarea"]);
+  function parseElementsChain(chain) {
+    if (!chain)
+      return void 0;
+    return chain.split(";").map((segment) => {
+      const el = {};
+      const colonIdx = segment.indexOf(":");
+      const tagPart = colonIdx >= 0 ? segment.slice(0, colonIdx) : segment;
+      const attrPart = colonIdx >= 0 ? segment.slice(colonIdx + 1) : "";
+      const dotIdx = tagPart.indexOf(".");
+      if (dotIdx >= 0) {
+        el.tag_name = tagPart.slice(0, dotIdx);
+        el.attr__class = tagPart.slice(dotIdx + 1).replace(/\./g, " ");
+      } else {
+        el.tag_name = tagPart;
+      }
+      const attrRegex = /([\w$]+)="([^"]*)"/g;
+      let match;
+      while ((match = attrRegex.exec(attrPart)) !== null) {
+        const [, key, value] = match;
+        if (key === "nth-child" || key === "nth-of-type")
+          continue;
+        el[key] = value;
+      }
+      if (el.text) {
+        el.$el_text = el.text;
+        delete el.text;
+      }
+      return el;
+    });
+  }
   function resolveInteractiveTag(elements2, directTag) {
     if (directTag && INTERACTIVE_TAGS.has(directTag))
       return directTag;
@@ -21861,7 +21935,7 @@ Please report this to https://github.com/markedjs/marked.`, e2) {
   function extractProps(phEvent) {
     const props = {};
     const phProps = phEvent.properties || {};
-    const elements2 = phProps.$elements;
+    const elements2 = phProps.$elements ?? (typeof phProps.$elements_chain === "string" ? parseElementsChain(phProps.$elements_chain) : void 0);
     const directTag = phProps.$tag_name ?? elements2?.[0]?.tag_name;
     const isClickEvent = phEvent.event === "$autocapture" || phEvent.event === "$click";
     props.tagName = isClickEvent ? resolveInteractiveTag(elements2, directTag) : directTag;
@@ -21869,6 +21943,9 @@ Please report this to https://github.com/markedjs/marked.`, e2) {
       props.elementText = phProps.$el_text;
     if (elements2)
       props.elements = elements2;
+    if (isClickEvent && !elements2) {
+      console.warn(`[PostHogNormalizer] $autocapture click has no element chain. PostHog may have changed wire format. Properties: $elements=${!!phProps.$elements}, $elements_chain=${typeof phProps.$elements_chain}`);
+    }
     if (phProps.$current_url)
       props.url = phProps.$current_url;
     if (phProps.$pathname)
@@ -23454,6 +23531,19 @@ ${cssRules}
     }
     return /* @__PURE__ */ (0, import_jsx_runtime12.jsx)("div", { ref: parentRef });
   }
+  var INTERACTION_PATTERNS = [
+    ":toggled",
+    ":clicked",
+    ":feedback",
+    ":navigate",
+    ":expanded",
+    ":collapsed",
+    ":dismissed",
+    ":submitted",
+    ":interacted",
+    ":tip_clicked",
+    ":tip_focused"
+  ];
   function TileCard({
     config,
     surface: _surface,
@@ -23462,10 +23552,35 @@ ${cssRules}
   }) {
     const { title, subtitle, widget, props, icon } = config;
     const [, setTick] = (0, import_react13.useState)(0);
+    const articleRef = (0, import_react13.useRef)(null);
     const runtime7 = useRuntime();
     (0, import_react13.useEffect)(() => {
       if (runtime7) setTick((t2) => t2 + 1);
     }, [runtime7]);
+    (0, import_react13.useEffect)(() => {
+      const tracker = typeof window !== "undefined" ? window.SynOS?.interventionTracker : null;
+      if (!articleRef.current || !tracker) return;
+      const observer2 = new IntersectionObserver(
+        ([entry]) => {
+          if (entry.isIntersecting) {
+            tracker.trackSeen(config.id, config.widget ?? "unknown");
+            observer2.disconnect();
+          }
+        },
+        { threshold: 0.5 }
+      );
+      observer2.observe(articleRef.current);
+      return () => observer2.disconnect();
+    }, [config.id, config.widget]);
+    (0, import_react13.useEffect)(() => {
+      const tracker = typeof window !== "undefined" ? window.SynOS?.interventionTracker : null;
+      if (!runtime7?.events || !tracker) return;
+      return runtime7.events.subscribe((event) => {
+        if (!INTERACTION_PATTERNS.some((p2) => event.name?.includes(p2))) return;
+        if (event.props?.instanceId !== config.id) return;
+        tracker.trackInteracted(config.id, config.widget ?? "unknown", event.name);
+      });
+    }, [runtime7?.events, config.id, config.widget]);
     const registration = (0, import_react13.useMemo)(
       () => runtime7?.widgets?.getRegistration?.(widget),
       [runtime7?.widgets, widget]
@@ -23514,6 +23629,7 @@ ${cssRules}
     return /* @__PURE__ */ (0, import_jsx_runtime12.jsxs)(
       "article",
       {
+        ref: articleRef,
         "data-shadow-canvas-id": `tile-${config.id}`,
         style: cardStyle,
         onMouseEnter,
@@ -23584,7 +23700,6 @@ ${cssRules}
     onToggle,
     telemetry,
     launcherLabel: _launcherLabel = "Adaptives",
-    launcherIcon,
     launcherAnimate = false,
     launcherAnimationStyle: _launcherAnimationStyle = "pulse",
     notificationCount: _notificationCount,
@@ -23989,10 +24104,10 @@ ${cssRules}
                           /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("path", { d: "M6 6l12 12" })
                         ]
                       }
-                    ) : launcherIcon ? /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+                    ) : config.launcher?.icon ? /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
                       "img",
                       {
-                        src: launcherIcon,
+                        src: config.launcher.icon,
                         alt: "",
                         "aria-hidden": "true",
                         style: {
@@ -24085,6 +24200,13 @@ ${cssRules}
   // src/hooks/useShadowCanvasConfig.ts
   var import_react15 = __toESM(require_react(), 1);
   var sortTiles = (tiles) => [...tiles].sort((a2, b3) => (b3.priority ?? 0) - (a2.priority ?? 0));
+  function fireTriggeredForTiles(tiles) {
+    const tracker = typeof window !== "undefined" ? window.SynOS?.interventionTracker : null;
+    if (!tracker) return;
+    for (const tile of tiles) {
+      tracker.trackTriggered(tile.id, tile.widget ?? "unknown");
+    }
+  }
   function useShadowCanvasConfig({
     fetcher,
     experiments,
@@ -24107,6 +24229,7 @@ ${cssRules}
       if (experiments) {
         tiles = tiles.filter((tile) => experiments.shouldRenderRectangle(tile));
       }
+      fireTriggeredForTiles(tiles);
       setState((prev) => ({ ...prev, tiles: sortTiles(tiles) }));
     }, [runtime7, experiments]);
     const load = (0, import_react15.useCallback)(async () => {
@@ -24124,6 +24247,7 @@ ${cssRules}
         } else if (experiments) {
           tiles = tiles.filter((tile) => experiments.shouldRenderRectangle(tile));
         }
+        fireTriggeredForTiles(tiles);
         debug("SmartCanvas Config", `Tile count after filtering: ${tiles.length}`);
         const newActions = response.actions || [];
         const newActionsJson = JSON.stringify(newActions);
@@ -24328,6 +24452,7 @@ ${cssRules}
     const batchHandleRef = (0, import_react16.useRef)(initialBatchHandle ?? null);
     const adoptedInitialRef = (0, import_react16.useRef)(!!initialBatchHandle);
     const runVersionRef = (0, import_react16.useRef)(0);
+    const pendingRevertRef = (0, import_react16.useRef)(null);
     (0, import_react16.useEffect)(() => {
       if (!runtime7?.actions) return;
       if (adoptedInitialRef.current) {
@@ -24339,6 +24464,10 @@ ${cssRules}
       const version = ++runVersionRef.current;
       const stale = () => version !== runVersionRef.current;
       const run = async () => {
+        if (pendingRevertRef.current) {
+          await pendingRevertRef.current;
+          pendingRevertRef.current = null;
+        }
         if (batchHandleRef.current) {
           try {
             await batchHandleRef.current.revertAll();
@@ -24366,7 +24495,7 @@ ${cssRules}
       run();
       return () => {
         if (batchHandleRef.current) {
-          batchHandleRef.current.revertAll().catch((err) => {
+          pendingRevertRef.current = batchHandleRef.current.revertAll().catch((err) => {
             console.error("[SmartCanvasApp] Failed to revert actions on cleanup:", err);
           });
           batchHandleRef.current = null;
@@ -24397,7 +24526,6 @@ ${cssRules}
             canvasTitle: configState.canvasTitle,
             telemetry,
             launcherLabel: launcherLabel ?? configState.launcher?.label,
-            launcherIcon: configState.launcher?.icon,
             launcherAnimate: configState.launcher?.animate,
             launcherAnimationStyle: configState.launcher?.animationStyle,
             notificationCount: configState.launcher?.notificationCount ?? configState.tiles.length,
@@ -36991,32 +37119,7 @@ ${cssRules}
         // Capture performance metrics
         capture_performance: true,
         // Enable web vitals
-        enable_recording_console_log: true,
-        // Bootstrap callback for when flags are loaded
-        loaded: (ph) => {
-          if (enableFeatureFlags && this.featureFlagsCallback) {
-            ph.onFeatureFlags(() => {
-              const allFlags = this.getAllFeatureFlags();
-              if (allFlags && this.featureFlagsCallback) {
-                this.featureFlagsCallback(allFlags);
-              }
-            });
-            const existingFlags = this.getAllFeatureFlags();
-            if (existingFlags && Object.keys(existingFlags).length > 0) {
-              this.featureFlagsCallback(existingFlags);
-            }
-          }
-          if (this.captureCallback) {
-            ph.on("eventCaptured", (...args) => {
-              const data = args[0];
-              const eventName = typeof data === "string" ? data : data?.event;
-              const properties = typeof data === "string" ? void 0 : data?.properties;
-              if (typeof eventName === "string") {
-                this.captureCallback?.(eventName, properties);
-              }
-            });
-          }
-        }
+        enable_recording_console_log: true
       };
       const result = Jo.init(
         options.apiKey,
@@ -37026,6 +37129,28 @@ ${cssRules}
       if (result) {
         this.client = result;
       }
+      if (this.captureCallback && this.client) {
+        this.client.on("eventCaptured", (...args) => {
+          const data = args[0];
+          const eventName = typeof data === "string" ? data : data?.event;
+          const properties = typeof data === "string" ? void 0 : data?.properties;
+          if (typeof eventName === "string") {
+            this.captureCallback?.(eventName, properties);
+          }
+        });
+      }
+      if (enableFeatureFlags && this.featureFlagsCallback && this.client) {
+        this.client.onFeatureFlags(() => {
+          const allFlags = this.getAllFeatureFlags();
+          if (allFlags && this.featureFlagsCallback) {
+            this.featureFlagsCallback(allFlags);
+          }
+        });
+        const existingFlags = this.getAllFeatureFlags();
+        if (existingFlags && Object.keys(existingFlags).length > 0) {
+          this.featureFlagsCallback(existingFlags);
+        }
+      }
       if (this.rrwebCallback && this.client) {
         this.setupRRWebIntercept();
       }
@@ -37150,6 +37275,55 @@ ${cssRules}
     return new PostHogAdapter(options);
   }
 
+  // src/telemetry/InterventionTracker.ts
+  var InterventionTracker = class {
+    constructor(telemetry, variantId) {
+      __publicField(this, "telemetry");
+      __publicField(this, "variantId");
+      __publicField(this, "seenSet", /* @__PURE__ */ new Set());
+      __publicField(this, "triggeredSet", /* @__PURE__ */ new Set());
+      this.telemetry = telemetry;
+      this.variantId = variantId;
+    }
+    trackServed(tiles, actions) {
+      this.telemetry.track?.("syntro_config_served", {
+        variant_id: this.variantId,
+        tiles,
+        actions
+      });
+    }
+    trackSeen(interventionId, interventionKind) {
+      if (this.seenSet.has(interventionId)) return;
+      this.seenSet.add(interventionId);
+      this.telemetry.track?.("syntro_intervention_seen", {
+        variant_id: this.variantId,
+        intervention_id: interventionId,
+        intervention_kind: interventionKind
+      });
+    }
+    trackTriggered(interventionId, interventionKind) {
+      if (this.triggeredSet.has(interventionId)) return;
+      this.triggeredSet.add(interventionId);
+      this.telemetry.track?.("syntro_intervention_triggered", {
+        variant_id: this.variantId,
+        intervention_id: interventionId,
+        intervention_kind: interventionKind
+      });
+    }
+    trackInteracted(interventionId, interventionKind, interactionType) {
+      this.telemetry.track?.("syntro_intervention_interacted", {
+        variant_id: this.variantId,
+        intervention_id: interventionId,
+        intervention_kind: interventionKind,
+        interaction_type: interactionType
+      });
+    }
+    resetPage() {
+      this.seenSet.clear();
+      this.triggeredSet.clear();
+    }
+  };
+
   // src/actions/executors/core-flow.ts
   var executeSequence = async (action, context) => {
     const handles = [];
@@ -38298,15 +38472,30 @@ ${cssRules}
       const handles = [];
       const appliedHandles = [];
       try {
-        for (const action of actions) {
-          const handle = await apply(action);
-          handles.push(handle);
-          appliedHandles.push(handle);
+        const results = await Promise.allSettled(actions.map((action) => apply(action)));
+        const errors = [];
+        for (const result of results) {
+          if (result.status === "fulfilled") {
+            handles.push(result.value);
+            appliedHandles.push(result.value);
+          } else {
+            errors.push(
+              result.reason instanceof Error ? result.reason : new Error(String(result.reason))
+            );
+          }
+        }
+        if (errors.length > 0 && appliedHandles.length === 0) {
+          throw errors[0];
+        }
+        if (errors.length > 0) {
+          console.warn(
+            `[ActionEngine] ${errors.length}/${actions.length} action(s) failed in batch:`,
+            errors.map((e2) => e2.message).join("; ")
+          );
         }
       } catch (error2) {
         console.error(
-          `[ActionEngine] Batch apply FAILED at action ${appliedHandles.length + 1}/${actions.length}.`,
-          `Successfully applied: ${appliedHandles.length}. Rolling back...`,
+          `[ActionEngine] Batch apply FAILED. Successfully applied: ${appliedHandles.length}. Rolling back...`,
           error2
         );
         for (const handle of appliedHandles) {
@@ -38382,74 +38571,97 @@ ${cssRules}
     selector: external_exports.string(),
     route: external_exports.union([external_exports.string(), external_exports.array(external_exports.string())])
   }).strict();
+  var COUNTABLE_EVENTS = [
+    // User interactions (from PostHog autocapture normalization)
+    "ui.click",
+    "ui.scroll",
+    "ui.input",
+    "ui.change",
+    "ui.submit",
+    // Behavioral detectors (from event-processor)
+    "ui.hover",
+    "ui.idle",
+    "ui.scroll_thrash",
+    "ui.focus_bounce",
+    // Navigation
+    "nav.page_view",
+    "nav.page_leave",
+    // Derived behavioral signals
+    "behavior.rage_click",
+    "behavior.hesitation",
+    "behavior.confusion"
+  ];
+  var CountableEventZ = external_exports.enum(COUNTABLE_EVENTS).describe("Event name to count. ui.* = user interactions and behavioral detectors, nav.* = page navigation, behavior.* = derived behavioral signals.");
+  var SESSION_METRIC_KEYS = ["time_on_page", "page_views", "scroll_depth"];
+  var SessionMetricKeyZ = external_exports.enum(SESSION_METRIC_KEYS).describe("Session metric key. time_on_page = seconds on current page, page_views = pages visited this session, scroll_depth = 0-100 percentage.");
   var PageUrlConditionZ = external_exports.object({
     type: external_exports.literal("page_url"),
-    url: external_exports.string()
-  });
+    url: external_exports.string().describe('URL path to match (e.g. "/pricing", "/dashboard")')
+  }).describe('Fires when the current page URL matches. Use for page-specific actions. Example: {"type": "page_url", "url": "/pricing"}');
   var RouteConditionZ = external_exports.object({
     type: external_exports.literal("route"),
-    routeId: external_exports.string()
-  });
+    routeId: external_exports.string().describe("Named route ID from the route filter")
+  }).describe("Fires when the current route matches a named route ID.");
   var AnchorVisibleConditionZ = external_exports.object({
     type: external_exports.literal("anchor_visible"),
-    anchorId: external_exports.string(),
-    state: external_exports.enum(["visible", "present", "absent"])
-  });
+    anchorId: external_exports.string().describe("CSS selector of the anchor element"),
+    state: external_exports.enum(["visible", "present", "absent"]).describe('"visible" = in viewport, "present" = in DOM, "absent" = not in DOM')
+  }).describe(`Fires based on a DOM element's visibility state. Example: {"type": "anchor_visible", "anchorId": "#cta-button", "state": "visible"}`);
   var EventOccurredConditionZ = external_exports.object({
     type: external_exports.literal("event_occurred"),
-    eventName: external_exports.string(),
-    withinMs: external_exports.number().optional()
-  });
+    eventName: external_exports.string().describe('Event name (e.g. "ui.click", "$pageview")'),
+    withinMs: external_exports.number().optional().describe("Time window in ms. Omit = any time this session.")
+  }).describe('Fires when a specific event has occurred during this session. Example: {"type": "event_occurred", "eventName": "ui.click", "withinMs": 5000}');
   var StateEqualsConditionZ = external_exports.object({
     type: external_exports.literal("state_equals"),
-    key: external_exports.string(),
-    value: external_exports.unknown()
-  });
+    key: external_exports.string().describe("Key in the SDK persistent state store (localStorage). Only valid for keys the host app explicitly sets via syntro.state.set()."),
+    value: external_exports.unknown().describe("Expected value to match against")
+  }).describe("Checks the SDK persistent state store (localStorage). ONLY for host-app state set via syntro.state.set() \u2014 NOT for user attributes like region, device, or UTM params (those are handled by segment targeting). Do NOT use this for targeting. If you do not know the valid state keys, do not use this condition type.");
   var ViewportConditionZ = external_exports.object({
     type: external_exports.literal("viewport"),
-    minWidth: external_exports.number().optional(),
-    maxWidth: external_exports.number().optional(),
-    minHeight: external_exports.number().optional(),
-    maxHeight: external_exports.number().optional()
-  });
+    minWidth: external_exports.number().optional().describe("Minimum viewport width in pixels"),
+    maxWidth: external_exports.number().optional().describe("Maximum viewport width in pixels"),
+    minHeight: external_exports.number().optional().describe("Minimum viewport height in pixels"),
+    maxHeight: external_exports.number().optional().describe("Maximum viewport height in pixels")
+  }).describe('Fires based on viewport (screen) size. Use for responsive behavior. Example: {"type": "viewport", "minWidth": 768} \u2014 fires on tablet and larger.');
   var SessionMetricConditionZ = external_exports.object({
     type: external_exports.literal("session_metric"),
-    key: external_exports.string(),
+    key: SessionMetricKeyZ,
     operator: external_exports.enum(["gte", "lte", "eq", "gt", "lt"]),
-    threshold: external_exports.number()
-  });
+    threshold: external_exports.number().describe("Numeric threshold to compare against")
+  }).describe('Fires when a session metric crosses a threshold. Valid keys: "time_on_page" (seconds), "page_views" (count), "scroll_depth" (0-100). Example: {"type": "session_metric", "key": "time_on_page", "operator": "gte", "threshold": 30}');
   var DismissedConditionZ = external_exports.object({
     type: external_exports.literal("dismissed"),
-    key: external_exports.string(),
-    inverted: external_exports.boolean().optional()
-  });
+    key: external_exports.string().describe("Dismissal key (usually a tile or action ID)"),
+    inverted: external_exports.boolean().optional().describe("When true, fires if NOT dismissed (default behavior)")
+  }).describe("Checks if an item has been dismissed by the user. Use with inverted: true to show only if not dismissed.");
   var CooldownActiveConditionZ = external_exports.object({
     type: external_exports.literal("cooldown_active"),
-    key: external_exports.string(),
-    inverted: external_exports.boolean().optional()
-  });
+    key: external_exports.string().describe("Cooldown key"),
+    inverted: external_exports.boolean().optional().describe("When true, fires if cooldown is NOT active")
+  }).describe("Checks if a cooldown timer is currently active. Use to prevent showing the same intervention too frequently.");
   var FrequencyLimitConditionZ = external_exports.object({
     type: external_exports.literal("frequency_limit"),
-    key: external_exports.string(),
-    limit: external_exports.number(),
-    inverted: external_exports.boolean().optional()
-  });
+    key: external_exports.string().describe("Frequency counter key"),
+    limit: external_exports.number().describe("Maximum allowed count"),
+    inverted: external_exports.boolean().optional().describe("When true, fires if limit NOT reached")
+  }).describe("Checks if a frequency limit has been reached. Use to cap how many times an action fires per session.");
   var MatchOpZ = external_exports.object({
     equals: external_exports.union([external_exports.string(), external_exports.number(), external_exports.boolean()]).optional(),
     contains: external_exports.string().optional()
-  });
+  }).describe("Match operator for counter filters. Exactly one of equals or contains must be specified.");
   var CounterDefZ = external_exports.object({
-    events: external_exports.array(external_exports.string()).min(1),
-    match: external_exports.record(external_exports.string(), MatchOpZ).optional()
-  });
+    events: external_exports.array(CountableEventZ).min(1).describe("Event names to count. Use values from the countable events enum."),
+    match: external_exports.record(external_exports.string(), MatchOpZ).optional().describe("Property filters. Keys are event prop names or element-chain fields (tag_name, $el_text, attr__*). All entries AND together.")
+  }).describe("Defines what events to count. Registered as an accumulator predicate at config-load time.");
   var EventCountConditionZ = external_exports.object({
     type: external_exports.literal("event_count"),
-    key: external_exports.string(),
+    key: external_exports.string().describe("Unique key for this counter (used for accumulator registration)"),
     operator: external_exports.enum(["gte", "lte", "eq", "gt", "lt"]),
-    count: external_exports.number().int().min(0),
-    withinMs: external_exports.number().positive().optional(),
-    counter: CounterDefZ.optional()
-  });
+    count: external_exports.number().int().min(0).describe("Target count threshold"),
+    withinMs: external_exports.number().positive().optional().describe("Time window in ms. Omit = count across entire session."),
+    counter: CounterDefZ.optional().describe("Inline counter definition. Defines what events to count.")
+  }).describe('Fires when accumulated event count crosses a threshold. Most powerful trigger type. Example: {"type": "event_count", "key": "pricing-clicks", "operator": "gte", "count": 3, "counter": {"events": ["ui.click"], "match": {"attr__data-cta": {"contains": "pricing"}}}}');
   var ConditionZ = external_exports.discriminatedUnion("type", [
     PageUrlConditionZ,
     RouteConditionZ,
@@ -38464,35 +38676,35 @@ ${cssRules}
     EventCountConditionZ
   ]);
   var RuleZ = external_exports.object({
-    conditions: external_exports.array(ConditionZ),
-    value: external_exports.unknown()
-  });
+    conditions: external_exports.array(ConditionZ).describe("Array of conditions \u2014 ALL must match (AND logic) for this rule to fire."),
+    value: external_exports.unknown().describe("Value returned when all conditions match. For triggerWhen: true = fire the action.")
+  }).describe("A single rule. ALL conditions must match (AND logic). Rules in a strategy are evaluated top-to-bottom \u2014 first rule where all conditions match wins and returns its value.");
   var RuleStrategyZ = external_exports.object({
     type: external_exports.literal("rules"),
-    rules: external_exports.array(RuleZ),
-    default: external_exports.unknown()
-  });
+    rules: external_exports.array(RuleZ).describe("Ordered list of rules. Evaluated top-to-bottom \u2014 first match wins."),
+    default: external_exports.unknown().describe("Fallback value when no rule matches. For triggerWhen: false = do not fire by default.")
+  }).describe("Rule-based strategy. Evaluates rules top-to-bottom. First rule where ALL conditions match returns its value. If no rule matches, returns default. For triggerWhen: set value=true on matching rules, default=false.");
   var ScoreStrategyZ = external_exports.object({
     type: external_exports.literal("score"),
     field: external_exports.string(),
     threshold: external_exports.number(),
     above: external_exports.unknown(),
     below: external_exports.unknown()
-  });
+  }).describe("Score-based strategy. Compares a field value against a threshold.");
   var ModelStrategyZ = external_exports.object({
     type: external_exports.literal("model"),
     modelId: external_exports.string(),
     inputs: external_exports.array(external_exports.string()),
     outputMapping: external_exports.record(external_exports.string(), external_exports.unknown()),
     default: external_exports.unknown()
-  });
+  }).describe("ML model strategy. Sends inputs to a model and maps outputs.");
   var ExternalStrategyZ = external_exports.object({
     type: external_exports.literal("external"),
     endpoint: external_exports.string(),
     method: external_exports.enum(["GET", "POST"]).optional(),
     default: external_exports.unknown(),
     timeoutMs: external_exports.number().optional()
-  });
+  }).describe("External API strategy. Calls an endpoint to determine the value.");
   var DecisionStrategyZ = external_exports.discriminatedUnion("type", [
     RuleStrategyZ,
     ScoreStrategyZ,
@@ -38588,7 +38800,8 @@ ${cssRules}
     color: external_exports.string().optional(),
     size: external_exports.string().optional(),
     shadow: external_exports.string().optional(),
-    borderRadius: external_exports.string().optional()
+    borderRadius: external_exports.string().optional(),
+    icon: external_exports.string().optional()
   });
   var TileElementConfigZ = external_exports.object({
     background: external_exports.string().optional(),
@@ -38668,7 +38881,6 @@ ${cssRules}
   var LauncherConfigZ = external_exports.object({
     enabled: external_exports.boolean().optional(),
     label: external_exports.string().optional(),
-    icon: external_exports.string().optional(),
     position: external_exports.string().optional(),
     animate: external_exports.boolean().optional(),
     animationStyle: external_exports.enum(["pulse", "bounce", "glow"]).optional(),
@@ -41489,7 +41701,7 @@ ${cssRules}
       __publicField(this, "manifestKey");
       __publicField(this, "variantFlagPrefix");
       this.client = options.client;
-      this.featureKey = options.featureKey ?? "smart-canvas-config";
+      this.featureKey = options.featureKey;
       this.manifestKey = options.manifestKey;
       this.variantFlagPrefix = options.variantFlagPrefix;
     }
@@ -41906,6 +42118,26 @@ ${cssRules}
     const warnedAppFailures = /* @__PURE__ */ new Set();
     const appLoadingFetcher = baseFetcher ? async () => {
       const config = await baseFetcher();
+      const tileCount = config.tiles?.length ?? 0;
+      const actionCount = config.actions?.length ?? 0;
+      const variantId = config.meta?.variant_id;
+      if (tileCount > 0 || actionCount > 0) {
+        if (!variantId) {
+          console.warn(
+            "[Syntro] Config has content but no meta.variant_id \u2014 intervention tracking disabled"
+          );
+        }
+      }
+      if (telemetry && variantId) {
+        const tracker = new InterventionTracker(telemetry, variantId);
+        tracker.trackServed(tileCount, actionCount);
+        if (typeof window !== "undefined") {
+          window.SynOS.interventionTracker = tracker;
+        }
+        runtime7.navigation.subscribe(() => {
+          tracker.resetPage();
+        });
+      }
       console.log(
         "[Syntro Bootstrap] Config fetched:",
         `tiles=${config.tiles?.length ?? 0},`,
@@ -42005,7 +42237,7 @@ ${cssRules}
   }
 
   // src/index.ts
-  var RUNTIME_SDK_BUILD = true ? `${"2026-04-09T18:44:05.229Z"} (${"f5d1ea4ae30"})` : "dev";
+  var RUNTIME_SDK_BUILD = true ? `${"2026-04-15T20:50:41.408Z"} (${"acd804e29d3"})` : "dev";
   if (typeof window !== "undefined") {
     console.log(`[Syntro Runtime] Build: ${RUNTIME_SDK_BUILD}`);
     const existing = window.SynOS;