@syntrologie/runtime-sdk 0.2.20 → 1.0.1-canary.0

package/CAPABILITIES.md

@@ -8,6 +8,7 @@ This document describes all available operations and capabilities of the SmartCa
 - [Anchor Selectors](#anchor-selectors)
 - [Operations](#operations)
 - [Overlays](#overlays)
+- [Runtime v2 Providers](#runtime-v2-providers)
 - [Best Practices](#best-practices)
 
 ## Overview
@@ -319,6 +320,216 @@ Overlays are defined in `overlayRecipe`:
 - `routes`: URL paths where this recipe applies (optional)
 - `steps`: Array of tooltip and highlight steps
 
+## Runtime v2 Providers
+
+The v2 runtime provides adaptives with a unified interface for context, events, state, and decisions.
+
+### SmartCanvasRuntime
+
+Every adaptive receives a `runtime` object:
+
+```typescript
+type SmartCanvasRuntime = {
+  telemetry: TelemetryClient;   // Emit events to PostHog
+  context: ContextManager;       // Subscribe to page/session state
+  events: EventBus;              // Subscribe to normalized events
+  state: StateStore;             // Persist dismissals, cooldowns
+  version: string;
+  mode: "production" | "development";
+};
+```
+
+### Usage
+
+```typescript
+const { canvas, runtime } = await Syntro.init({
+  token: "syn_..."
+});
+
+// Access runtime providers
+runtime.telemetry?.trackAction(...);
+runtime.context.subscribe((ctx, prev) => { ... });
+runtime.events.subscribe({ names: ['ui.click'] }, (event) => { ... });
+runtime.state.dismissals.mark('my-tile');
+```
+
+### Context Manager
+
+Subscribe to runtime context changes:
+
+```typescript
+const unsubscribe = runtime.context.subscribe((ctx, prev) => {
+  if (ctx.page.url !== prev.page.url) {
+    // Handle route change
+  }
+});
+
+const ctx = runtime.context.get();
+console.log(ctx.page.url, ctx.session.sessionId);
+```
+
+**Available Context:**
+| Field | Type | Description |
+|-------|------|-------------|
+| `page.url` | string | Current page URL |
+| `page.routeId` | string? | Matched route pattern |
+| `page.title` | string? | Document title |
+| `session.sessionId` | string | PostHog session ID |
+| `session.startTs` | number | Session start timestamp |
+| `viewport.width` | number | Viewport width in pixels |
+| `viewport.height` | number | Viewport height in pixels |
+| `anchors` | AnchorState[]? | Tracked anchor visibility |
+
+### Event Bus
+
+Subscribe to normalized events:
+
+```typescript
+const unsubscribe = runtime.events.subscribe(
+  { names: ["ui.click", "nav.page_view"] },
+  (event) => {
+    console.log(event.name, event.props);
+  }
+);
+```
+
+**Event Schema:**
+```typescript
+type NormalizedEvent = {
+  ts: number;           // Timestamp
+  name: string;         // e.g., "ui.click", "canvas.opened"
+  source: "posthog" | "canvas" | "derived";
+  props?: Record<string, any>;
+  schemaVersion: string;
+};
+```
+
+**Standard Events:**
+| Event | Source | Description |
+|-------|--------|-------------|
+| `ui.click` | posthog | User clicked element |
+| `ui.scroll` | posthog | User scrolled |
+| `nav.page_view` | posthog | Page navigation |
+| `canvas.opened` | canvas | Smart Canvas opened |
+| `canvas.closed` | canvas | Smart Canvas closed |
+| `tile.viewed` | canvas | Tile became visible |
+| `tile.action` | canvas | User clicked tile action |
+
+### State Store
+
+Persist state across sessions:
+
+```typescript
+// Session storage (cleared on close)
+runtime.state.session.set("lastTileViewed", "tile-123");
+const last = runtime.state.session.get<string>("lastTileViewed");
+
+// User storage (persists across sessions)
+runtime.state.user.set("onboardingComplete", true);
+
+// Namespace by adaptive
+const ns = runtime.state.ns("my-adaptive");
+ns.session.set("step", 3);
+```
+
+**Built-in Helpers:**
+```typescript
+// Track dismissals
+runtime.state.dismissals.mark("tooltip-1");
+if (runtime.state.dismissals.isDismissed("tooltip-1")) { ... }
+
+// Cooldowns (don't show again for X ms)
+runtime.state.cooldowns.set("promo-banner", 86400000); // 24h
+if (runtime.state.cooldowns.isActive("promo-banner")) { ... }
+
+// Frequency caps
+runtime.state.frequency.increment("upsell-shown");
+if (runtime.state.frequency.count("upsell-shown") >= 3) { ... }
+```
+
+### Decision Strategies
+
+Tile activation uses `DecisionStrategy` for conditional rendering:
+
+```json
+{
+  "id": "promo-tile",
+  "title": "Limited Offer",
+  "activation": {
+    "routes": { "include": ["/pricing", "/upgrade"] },
+    "strategy": {
+      "type": "rules",
+      "rules": [
+        {
+          "conditions": [
+            { "type": "viewport", "minWidth": 768 },
+            { "type": "dismissed", "key": "promo-tile", "inverted": true }
+          ],
+          "value": true
+        }
+      ],
+      "default": false
+    }
+  }
+}
+```
+
+**Strategy Types:**
+| Type | Description |
+|------|-------------|
+| `rules` | Condition-based matching (if/then) |
+| `score` | Threshold on augmented field |
+| `model` | ML model prediction (future) |
+| `external` | Remote decision endpoint (future) |
+
+**Condition Types:**
+| Condition | Parameters | Description |
+|-----------|------------|-------------|
+| `page_url` | `url` (pattern) | URL matches pattern |
+| `route` | `routeId` | Route ID matches |
+| `anchor_visible` | `anchorId`, `state` | Anchor visibility state |
+| `event_occurred` | `eventName`, `withinMs?` | Event happened recently |
+| `state_equals` | `key`, `value` | State value matches |
+| `viewport` | `minWidth?`, `maxWidth?` | Viewport size range |
+| `session_metric` | `key`, `operator`, `threshold` | Session metric comparison |
+| `dismissed` | `key`, `inverted?` | Item has been dismissed |
+| `cooldown_active` | `key`, `inverted?` | Cooldown is active |
+| `frequency_limit` | `key`, `limit`, `inverted?` | Frequency cap reached |
+
+### Migration from v1
+
+The new `activation` field replaces the deprecated `experiment` field:
+
+**Before (v1):**
+```json
+{
+  "experiment": {
+    "featureKey": "my-feature",
+    "variationId": 1
+  }
+}
+```
+
+**After (v2):**
+```json
+{
+  "activation": {
+    "strategy": {
+      "type": "rules",
+      "rules": [
+        {
+          "conditions": [
+            { "type": "route", "routeId": "/dashboard" }
+          ],
+          "value": true
+        }
+      ],
+      "default": false
+    }
+  }
+}
+```
+
 ## Best Practices
 
 ### 1. Element Selection

package/dist/SmartCanvasElement.js

@@ -36,7 +36,17 @@ const ensureOverlayRoot = () => {
         root = document.createElement("div");
         root.id = id;
         root.setAttribute("data-smart-canvas-overlay", "true");
-        document.body.appendChild(root);
+        // Guard against body not existing yet (script in <head>)
+        if (document.body) {
+            document.body.appendChild(root);
+        }
+        else {
+            document.addEventListener('DOMContentLoaded', () => {
+                if (!root.parentNode) {
+                    document.body.appendChild(root);
+                }
+            }, { once: true });
+        }
     }
     return root;
 };

package/dist/SmartCanvasElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"SmartCanvasElement.js","sourceRoot":"","sources":["../src/SmartCanvasElement.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"SmartCanvasElement.js","sourceRoot":"","sources":["../src/SmartCanvasElement.tsx"],"names":[],"mappings":"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"}

package/dist/api.js

@@ -2,9 +2,9 @@ import { registerSmartCanvasElement } from "./SmartCanvasElement";
 import { createCanvasConfigFetcher } from "./configFetcher";
 import { initAntiFlicker } from "./antiFlicker";
 import { applyPatchesEarly, extractPatchesFromConfig, revertAllPatches } from "./earlyPatcher";
-import { loadEditorSdk, shouldLoadEditor } from "./editorLoader";
+import { loadEditorSdk, getActiveSdkMode } from "./editorLoader";
 export const createSmartCanvas = async (config = {}) => {
-    var _a, _b, _c, _d;
+    var _a, _b, _c;
     if (typeof window === "undefined" || typeof document === "undefined") {
         throw new Error("SmartCanvas can only be created in a browser-like environment");
     }
@@ -45,8 +45,10 @@ export const createSmartCanvas = async (config = {}) => {
     if (removeAntiFlicker) {
         removeAntiFlicker();
     }
-    // Check if we should load the editor
-    if (shouldLoadEditor()) {
+    // Check if we should load the editor (for editor mode or audit mode)
+    const sdkMode = getActiveSdkMode();
+    if (sdkMode) {
+        console.log(`[SmartCanvas] Loading editor SDK for ${sdkMode} mode`);
         // We don't await this so the runtime SDK can continue initializing
         loadEditorSdk(config.editorUrl).catch(console.error);
     }
@@ -57,11 +59,24 @@ export const createSmartCanvas = async (config = {}) => {
             host.style.setProperty(key, value);
         }
     }
-    const target = (_a = config.target) !== null && _a !== void 0 ? _a : document.body;
-    target.appendChild(host);
-    const experiments = (_b = config.integrations) === null || _b === void 0 ? void 0 : _b.experiments;
-    const telemetry = (_c = config.integrations) === null || _c === void 0 ? void 0 : _c.telemetry;
-    const fetcher = (_d = config.fetcher) !== null && _d !== void 0 ? _d : createCanvasConfigFetcher({
+    // Wait for body to exist if running in <head>
+    const appendToTarget = () => {
+        var _a;
+        const target = (_a = config.target) !== null && _a !== void 0 ? _a : document.body;
+        if (target) {
+            target.appendChild(host);
+        }
+    };
+    if (document.body) {
+        appendToTarget();
+    }
+    else {
+        // Script running before body exists - wait for DOMContentLoaded
+        document.addEventListener('DOMContentLoaded', appendToTarget, { once: true });
+    }
+    const experiments = (_a = config.integrations) === null || _a === void 0 ? void 0 : _a.experiments;
+    const telemetry = (_b = config.integrations) === null || _b === void 0 ? void 0 : _b.telemetry;
+    const fetcher = (_c = config.fetcher) !== null && _c !== void 0 ? _c : createCanvasConfigFetcher({
         configUri: config.configUri,
         experiments,
         featureKey: config.configUriFeatureKey,
@@ -153,13 +168,12 @@ export const createSmartCanvas = async (config = {}) => {
         },
     };
     // Expose handle for editor SDK access
-    // In editor mode: always expose (editor needs it to inject tiles and save config)
+    // In editor/audit mode: always expose (editor needs it to inject tiles and save config)
     // In dev mode: always expose (for debugging)
     // In production: never expose (security)
     if (typeof window !== "undefined") {
-        const isEditorMode = new URLSearchParams(window.location.search).has('editor_token');
         const isDev = process.env.NODE_ENV === 'development';
-        if (isEditorMode || isDev) {
+        if (sdkMode || isDev) {
             window.__smartCanvasHandle = handle;
         }
     }

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.tsx"],"names":[],"mappings":"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"}

package/dist/bootstrap.d.ts

@@ -5,14 +5,21 @@
  * ```typescript
  * import { Syntro } from '@syntrologie/runtime-sdk';
  *
- * const { canvas, experiments, telemetry } = await Syntro.init({
+ * const { canvas, runtime } = await Syntro.init({
  *   token: "syn_eyJ2IjoxLCJleHAiOnsiayI6InNkay14eHgiLCJwIjoiZ3Jvd3RoYm9vayJ9fQ"
  * });
+ *
+ * // Access runtime providers
+ * runtime.telemetry?.trackAction(...);
+ * runtime.context.subscribe((ctx, prev) => { ... });
+ * runtime.events.subscribe({ names: ['ui.click'] }, (event) => { ... });
+ * runtime.state.dismissals.mark('my-tile');
  * ```
  */
 import { decodeToken, encodeToken } from "./token";
 import { SmartCanvasConfig, SmartCanvasHandle } from "./api";
 import { SessionMetricTracker } from "./metrics";
+import { SmartCanvasRuntime } from "./runtime";
 import type { ExperimentClient } from "./experiments/types";
 import type { TelemetryClient } from "./telemetry/types";
 import type { CanvasConfigFetcher } from "./types";
@@ -50,17 +57,24 @@ export interface SyntroInitResult {
      * The SmartCanvas handle for controlling the canvas.
      */
     canvas: SmartCanvasHandle;
+    /**
+     * The unified v2 runtime with all providers.
+     * Use this to access telemetry, context, events, and state.
+     */
+    runtime: SmartCanvasRuntime;
     /**
      * The experiment client, if experiments are configured in the token.
+     * @deprecated Access via runtime.telemetry or use DecisionStrategy instead
      */
     experiments?: ExperimentClient;
     /**
      * The telemetry client, if telemetry is configured in the token.
+     * @deprecated Access via runtime.telemetry instead
      */
     telemetry?: TelemetryClient;
     /**
      * The session metric tracker, if enableSessionMetrics is true.
-     * Use this to track session-based metrics for real-time targeting.
+     * @deprecated Access via runtime.sessionMetrics instead
      */
     sessionMetrics?: SessionMetricTracker;
 }

package/dist/bootstrap.js

@@ -5,9 +5,15 @@
  * ```typescript
  * import { Syntro } from '@syntrologie/runtime-sdk';
  *
- * const { canvas, experiments, telemetry } = await Syntro.init({
+ * const { canvas, runtime } = await Syntro.init({
  *   token: "syn_eyJ2IjoxLCJleHAiOnsiayI6InNkay14eHgiLCJwIjoiZ3Jvd3RoYm9vayJ9fQ"
  * });
+ *
+ * // Access runtime providers
+ * runtime.telemetry?.trackAction(...);
+ * runtime.context.subscribe((ctx, prev) => { ... });
+ * runtime.events.subscribe({ names: ['ui.click'] }, (event) => { ... });
+ * runtime.state.dismissals.mark('my-tile');
  * ```
  */
 import { decodeToken, encodeToken } from "./token";
@@ -17,6 +23,8 @@ import { createConfigFetcher } from "./fetchers/registry";
 import { createCanvasConfigFetcher } from "./configFetcher";
 import { createSmartCanvas } from "./api";
 import { createSessionMetricTracker } from "./metrics";
+import { createSmartCanvasRuntime } from "./runtime";
+import { initLogger, debug, warn, error as logError } from "./logger";
 /**
  * Get environment variable, supporting both Vite and Next.js patterns.
  */
@@ -42,12 +50,12 @@ function getEnvVar(name) {
  */
 function isEditorMode() {
     if (typeof window === "undefined") {
-        console.log('[Syntro Bootstrap] isEditorMode: not in browser');
+        debug('Syntro Bootstrap', 'isEditorMode: not in browser');
         return false;
     }
     const params = new URLSearchParams(window.location.search);
     const hasToken = params.has("editor_token");
-    console.log('[Syntro Bootstrap] isEditorMode check:', {
+    debug('Syntro Bootstrap', 'isEditorMode check:', {
         url: window.location.href,
         search: window.location.search,
         hasEditorToken: hasToken,
@@ -55,6 +63,25 @@ function isEditorMode() {
     });
     return hasToken;
 }
+/**
+ * Check if we're in audit mode (syntro_audit in URL params).
+ * Audit mode enables element marking for product touring.
+ */
+function isAuditMode() {
+    var _a;
+    if (typeof window === "undefined") {
+        debug('Syntro Bootstrap', 'isAuditMode: not in browser');
+        return false;
+    }
+    const params = new URLSearchParams(window.location.search);
+    const hasAuditFlag = params.has("syntro_audit");
+    debug('Syntro Bootstrap', 'isAuditMode check:', {
+        url: window.location.href,
+        hasAuditFlag,
+        auditSessionId: (_a = params.get("audit_session_id")) !== null && _a !== void 0 ? _a : 'none',
+    });
+    return hasAuditFlag;
+}
 // ============================================================================
 // Segment Attribute Caching (localStorage)
 // ============================================================================
@@ -70,12 +97,12 @@ function loadCachedSegmentAttributes() {
         const cached = localStorage.getItem(SEGMENT_CACHE_KEY);
         if (cached) {
             const attrs = JSON.parse(cached);
-            console.log('[Syntro Bootstrap] Loaded cached segment attributes:', attrs);
+            debug('Syntro Bootstrap', 'Loaded cached segment attributes:', attrs);
             return attrs;
         }
     }
     catch (err) {
-        console.warn('[Syntro Bootstrap] Failed to load cached segment attributes:', err);
+        warn('Syntro Bootstrap', 'Failed to load cached segment attributes:', err);
     }
     return {};
 }
@@ -87,10 +114,10 @@ function cacheSegmentAttributes(attrs) {
         return;
     try {
         localStorage.setItem(SEGMENT_CACHE_KEY, JSON.stringify(attrs));
-        console.log('[Syntro Bootstrap] Cached segment attributes:', attrs);
+        debug('Syntro Bootstrap', 'Cached segment attributes:', attrs);
     }
     catch (err) {
-        console.warn('[Syntro Bootstrap] Failed to cache segment attributes:', err);
+        warn('Syntro Bootstrap', 'Failed to cache segment attributes:', err);
     }
 }
 /**
@@ -122,40 +149,46 @@ function extractSegmentFlags(allFlags) {
  */
 async function init(options) {
     var _a, _b, _c;
-    console.log('[Syntro Bootstrap] ====== INIT ======');
-    console.log('[Syntro Bootstrap] Options:', {
+    // Initialize logger early (URL param works without token)
+    initLogger();
+    debug('Syntro Bootstrap', '====== INIT ======');
+    debug('Syntro Bootstrap', 'Options:', {
         hasToken: !!options.token,
         tokenPrefix: ((_a = options.token) === null || _a === void 0 ? void 0 : _a.slice(0, 15)) + '...',
         hasCanvasOptions: !!options.canvas,
     });
-    // In editor mode, token is optional - editor SDK handles auth
+    // In editor or audit mode, token is optional - SDK handles auth differently
     const editorMode = isEditorMode();
-    console.log('[Syntro Bootstrap] Editor mode:', editorMode);
+    const auditMode = isAuditMode();
+    const sdkMode = editorMode ? 'editor' : auditMode ? 'audit' : null;
+    debug('Syntro Bootstrap', 'SDK mode:', sdkMode !== null && sdkMode !== void 0 ? sdkMode : 'normal');
     let payload;
     if (options.token) {
         // If token is provided and starts with syn_, decode it
         if (options.token.startsWith("syn_")) {
-            console.log('[Syntro Bootstrap] Token starts with syn_, decoding...');
+            debug('Syntro Bootstrap', 'Token starts with syn_, decoding...');
             payload = decodeToken(options.token);
+            // Re-init logger with token's debug flag
+            initLogger(payload.d);
         }
-        else if (!editorMode) {
-            // Not a syn_ token and not in editor mode - error
-            console.error('[Syntro Bootstrap] ❌ Token does not start with syn_ and NOT in editor mode!');
-            console.error('[Syntro Bootstrap] Token received:', options.token);
+        else if (!sdkMode) {
+            // Not a syn_ token and not in special mode - error
+            logError('Syntro Bootstrap', '❌ Token does not start with syn_ and NOT in editor/audit mode!');
+            logError('Syntro Bootstrap', 'Token received:', options.token);
             throw new Error("Invalid Syntro token: must start with 'syn_'");
         }
         else {
-            console.log('[Syntro Bootstrap] ✓ Non-syn_ token allowed (editor mode)');
+            debug('Syntro Bootstrap', `✓ Non-syn_ token allowed (${sdkMode} mode)`);
         }
-        // If in editor mode with non-syn_ token, skip token decoding
+        // If in editor/audit mode with non-syn_ token, skip token decoding
     }
-    else if (!editorMode) {
-        // No token and not in editor mode - error
-        console.error('[Syntro Bootstrap] ❌ No token provided and NOT in editor mode!');
-        throw new Error("Syntro token is required (unless in editor mode)");
+    else if (!sdkMode) {
+        // No token and not in special mode - error
+        logError('Syntro Bootstrap', '❌ No token provided and NOT in editor/audit mode!');
+        throw new Error("Syntro token is required (unless in editor or audit mode)");
     }
     else {
-        console.log('[Syntro Bootstrap] ✓ No token, but editor mode - proceeding');
+        debug('Syntro Bootstrap', `✓ No token, but ${sdkMode} mode - proceeding`);
     }
     // Host resolution priority: env var > token > default
     // Env vars are checked at build time by bundlers (Next.js/Vite)
@@ -173,16 +206,16 @@ async function init(options) {
     // PHASE 1: Load cached segment attributes for instant evaluation
     // ============================================================================
     const cachedSegmentAttrs = loadCachedSegmentAttributes();
-    console.log('[Syntro Bootstrap] Phase 1: Using cached segment attributes:', cachedSegmentAttrs);
+    debug('Syntro Bootstrap', 'Phase 1: Using cached segment attributes:', cachedSegmentAttrs);
     // Will be set when experiments client is created
     let experiments;
     // Callback for when PostHog feature flags are loaded (Phase 2)
     const onFeatureFlagsLoaded = (allFlags) => {
         var _a, _b, _c;
-        console.log('[Syntro Bootstrap] Phase 2: PostHog feature flags loaded');
+        debug('Syntro Bootstrap', 'Phase 2: PostHog feature flags loaded');
         // Extract segment flags (in_segment_*)
         const segmentFlags = extractSegmentFlags(allFlags);
-        console.log('[Syntro Bootstrap] Segment flags from PostHog:', segmentFlags);
+        debug('Syntro Bootstrap', 'Segment flags from PostHog:', segmentFlags);
         // Cache for next page load
         cacheSegmentAttributes(segmentFlags);
         // Update GrowthBook with fresh segment attributes
@@ -191,7 +224,7 @@ async function init(options) {
             const sessionAttrs = (_b = (_a = sessionMetrics === null || sessionMetrics === void 0 ? void 0 : sessionMetrics.getAll) === null || _a === void 0 ? void 0 : _a.call(sessionMetrics)) !== null && _b !== void 0 ? _b : {};
             // Merge session metrics + segment flags and update GrowthBook
             const updatedAttrs = { ...sessionAttrs, ...segmentFlags };
-            console.log('[Syntro Bootstrap] Updating GrowthBook with attributes:', updatedAttrs);
+            debug('Syntro Bootstrap', 'Updating GrowthBook with attributes:', updatedAttrs);
             (_c = experiments.setAttributes) === null || _c === void 0 ? void 0 : _c.call(experiments, updatedAttrs);
         }
     };
@@ -254,10 +287,10 @@ async function init(options) {
         sessionMetrics = createSessionMetricTracker({
             experiments,
             onMetricChange: (key, value) => {
-                console.log(`[Syntro Bootstrap] Session metric changed: ${key} = ${value}`);
+                debug('Syntro Bootstrap', `Session metric changed: ${key} = ${value}`);
             },
         });
-        console.log('[Syntro Bootstrap] SessionMetricTracker created');
+        debug('Syntro Bootstrap', 'SessionMetricTracker created');
     }
     // Create canvas with integrations
     const canvas = await createSmartCanvas({
@@ -266,7 +299,28 @@ async function init(options) {
         integrations: { experiments, telemetry },
         editorUrl,
     });
-    return { canvas, experiments, telemetry, sessionMetrics };
+    // Determine runtime mode
+    let runtimeMode = 'production';
+    if (editorMode)
+        runtimeMode = 'editor';
+    else if (auditMode)
+        runtimeMode = 'audit';
+    else if (getEnvVar('NODE_ENV') === 'development')
+        runtimeMode = 'development';
+    // Create the unified v2 runtime
+    const runtime = createSmartCanvasRuntime({
+        telemetry,
+        sessionMetrics,
+        mode: runtimeMode,
+    });
+    debug('Syntro Bootstrap', 'Runtime created:', {
+        version: runtime.version,
+        mode: runtime.mode,
+        hasContext: !!runtime.context,
+        hasEvents: !!runtime.events,
+        hasState: !!runtime.state,
+    });
+    return { canvas, runtime, experiments, telemetry, sessionMetrics };
 }
 /**
  * The Syntro namespace for single-token initialization.