@syntrologie/runtime-sdk 2.13.0 → 2.15.0

package/dist/actions/schema.js

@@ -31,9 +31,10 @@ import {
   WaitZ,
   WidgetConfigZ,
   coreActionStepSchemas
-} from "../chunk-L6RJMBR2.js";
-import "../chunk-XDYJ64IN.js";
-import "../chunk-BU4Z6PD7.js";
+} from "../chunk-XVRDKBYF.js";
+import "../chunk-GX7BBYX6.js";
+import "../chunk-4HXPGXUC.js";
+import "../chunk-JMHRHAEL.js";
 export {
   AddClassZ,
   AnchorIdZ,

package/dist/actions/types.d.ts

@@ -341,6 +341,12 @@ export interface ActionEngineOptions {
         accumulator?: {
             subscribe: (cb: () => void) => () => void;
         };
+        sessionMetrics?: {
+            subscribe: (cb: () => void) => () => void;
+        };
+        events?: {
+            subscribe: (cb: () => void) => () => void;
+        };
     };
 }
 /** The ActionEngine interface */
@@ -353,8 +359,8 @@ export interface ActionEngine {
     validate: (action: ActionStep) => ValidationResult;
     /** Get all currently active actions */
     getActive: () => ActiveAction[];
-    /** Clean up all active actions and resources */
-    destroy: () => void;
+    /** Clean up all active actions and resources. Awaits async cleanup (animated reverts). */
+    destroy: () => Promise<void>;
 }
 /** Renderable content types for surfaces */
 export type RenderableContent = {

package/dist/anchor/AnchorResolver.d.ts

@@ -11,6 +11,7 @@ export interface AnchorResolverOptions {
 export interface AnchorResolver {
     resolve(selector: string): HTMLElement | null;
     waitFor(selector: string, timeoutMs?: number): Promise<HTMLElement>;
+    /** One-shot: fires callback once when element appears, then auto-removes the watcher. */
     onAppear(selector: string, cb: (el: HTMLElement) => void): () => void;
     pendingCount(): number;
     destroy(): void;

package/dist/api-lit.d.ts

@@ -0,0 +1,84 @@
+/**
+ * SmartCanvas API (Lit variant)
+ *
+ * Entry point for the SmartCanvas SDK using LitElement instead of React.
+ * Creates and manages the canvas element, handles configuration, and
+ * coordinates between the ActionEngine and UI.
+ *
+ * The public API (SmartCanvasHandle, SmartCanvasConfig, createSmartCanvas)
+ * is identical to api.tsx — only the internal mounting uses mountLitApp()
+ * instead of mountReactApp().
+ */
+import type { ExperimentClient } from './experiments/types';
+import type { OverlayRecipeFetcher } from './overlays/fetcher';
+import type { ActionHandler, AppearanceConfig, RenderProps } from './render/types';
+import type { SmartCanvasRuntime } from './runtime';
+import { type SmartCanvasElementLit } from './SmartCanvasElementLit';
+import type { TelemetryClient } from './telemetry/types';
+import type { CanvasThemeConfig } from './theme';
+import type { CanvasConfigFetcher, CanvasConfigResponse } from './types';
+export interface SmartCanvasIntegrations {
+    experiments?: ExperimentClient;
+    telemetry?: TelemetryClient;
+}
+export interface SmartCanvasConfig {
+    target?: HTMLElement;
+    defaultOpen?: boolean;
+    tokens?: Record<string, string>;
+    fetcher?: CanvasConfigFetcher;
+    configUri?: string;
+    configUriFeatureKey?: string;
+    fetchCredentials?: RequestCredentials;
+    overlayFetcher?: OverlayRecipeFetcher;
+    overlayConfigUri?: string;
+    overlayConfigFeatureKey?: string;
+    overlayFetchCredentials?: RequestCredentials;
+    pollIntervalMs?: number;
+    integrations?: SmartCanvasIntegrations;
+    antiFlicker?: boolean | {
+        timeout?: number;
+        className?: string;
+    };
+    editorUrl?: string;
+    /**
+     * v2 Runtime instance.
+     * Required for action execution. If not provided, actions will not be applied.
+     */
+    runtime?: SmartCanvasRuntime;
+    appearance?: AppearanceConfig;
+    renderProps?: RenderProps;
+    actionHandlers?: ActionHandler;
+    /** Workspace-level theme for 3-layer inheritance (defaults → workspace → config) */
+    workspaceTheme?: CanvasThemeConfig;
+}
+/**
+ * Handle for interacting with a SmartCanvas instance.
+ */
+export interface SmartCanvasHandle {
+    el: SmartCanvasElementLit;
+    open(): void;
+    close(): void;
+    destroy(): void;
+    setTokens(tokens: Record<string, string>): void;
+    /**
+     * Get the current config.
+     */
+    getConfig(): Promise<CanvasConfigResponse>;
+    /**
+     * Enable or disable the canvas.
+     * When disabled, all actions are reverted.
+     */
+    setEnabled(enabled: boolean): Promise<void>;
+    setOverrideFetcher(fetcher: CanvasConfigFetcher): void;
+    registerTelemetryProperties(properties: Record<string, unknown>): void;
+    getSessionId(): string | undefined;
+    startSessionRecording(): void;
+    /** Track a custom event. Returns true if telemetry is available and event was sent. */
+    track(eventName: string, properties?: Record<string, unknown>): boolean;
+    /**
+     * v2 Runtime instance for context, events, state, and decisions.
+     */
+    runtime?: SmartCanvasRuntime;
+}
+export declare const createSmartCanvas: (config?: SmartCanvasConfig) => Promise<SmartCanvasHandle>;
+export { getAntiFlickerSnippet } from './antiFlicker';

package/dist/apps/builtinRuntimeModules-lit.d.ts

@@ -0,0 +1,20 @@
+export declare const builtinAdaptiveManifestsLit: {
+    id: any;
+    version: any;
+    name: any;
+    description: any;
+    runtime: {
+        actions: any;
+        widgets: any;
+        notifyWatchers: any;
+        events: any;
+    };
+    editor: undefined;
+    metadata: {
+        isBuiltIn: boolean;
+    };
+}[];
+export declare function registerBuiltinRuntimeModulesLit(registry: {
+    has: (id: string) => boolean;
+    register: (manifest: any) => void;
+}): void;

package/dist/bootstrap-types.d.ts

@@ -56,6 +56,16 @@ export interface SyntroInitOptions {
      * @default false
      */
     testMode?: boolean;
+    /**
+     * App-provided signal values set at init time. Merged into SDK attributes
+     * alongside auto-collected browser/geo signals for local flag evaluation.
+     *
+     * Use this when the host environment (MCP server, agent, etc.) provides
+     * signal values that the SDK can't auto-collect from the browser.
+     *
+     * Tracked as a discrete PostHog event (app_signals_init) on init.
+     */
+    appSignalsInit?: Record<string, string>;
 }
 export interface SyntroInitResult {
     /**