@farmslot/recipe-runner 0.25.0 → 0.27.0

package/CHANGELOG.md

@@ -6,6 +6,16 @@ All notable changes to `@farmslot/recipe-runner` (published as `@farmslot/recipe
 
 - Active-development baseline; add user-facing changes here before release or package publication.
 
+## 0.27.0 - 2026-10-08
+
+- Add a `lenient` option to `resolveRecipeValue(value, params, outputs, { lenient })`: only an exact reference to a parameter that exists resolves, anything else stays as written, and nothing throws. Static validation in `@farmslot/recipe-cli` resolves parameters this way.
+- Publish with protocol 0.34.0.
+
+## 0.26.0 - 2026-10-06
+
+- Add `@farmslot/recipe-runner/runtime/cdp-trace`, the CDP performance trace engine moved from mm-harness: `createCdpTraceCollector(client, { kind, platform, marker, markerPrefix })` runs one `Tracing` capture at a time and aligns it to the host clock through a marker the host writes into the trace; `parseTraceCapture(capture, kind)` turns a capture into JavaScript-task and native-frame samples with summaries. A `TraceKind` names what a trace captures (categories, renderer scoping, scope label, native source, JavaScript-task flag, `draw` or `cadence` frame timing), so the host keeps its own platform names. The marker prefix defaults to `farmslot-clock-`. `summarizeFrames` (from `@farmslot/adapter-rn`) and `summarizeJavaScriptTasks` move here too, unchanged.
+- Publish with protocol 0.34.0.
+
 ## 0.25.0 - 2026-10-06
 
 - The library digest (`digestRecipeLibrary`) covers every file under each declared adapter module's directory, not only the module file, so a plugin's helper files move it. A module at the library root contributes itself and the library's `actions/`, not the whole root. Add `libraryAdapterFiles(root, declaration)` (the module's directory plus the library's `actions/`, the files a host lets the plugin import) and `digestLibraryAdapter(root, declaration)` for one plugin. The module's directory is listed strictly (`listLibraryFiles(root, directory, { strict: true })`): dot-files are digested, and a `node_modules`, a symlinked directory, or more than `MAX_LIBRARY_ADAPTER_FILES` (1,000) files fails with `RECIPE_SOURCE_INVALID`.

package/README.md

@@ -229,6 +229,7 @@ surface and capture ids; `feedbackDraftFromDocument` is the same restore for cod
 - `/runtime/cdp`, `/runtime/react-native-bridge`, `/runtime/browser-extension`
 - `/runtime/deps-readiness`, `/runtime/log-analysis`, `/runtime/metro-probe`
 - `/runtime/decision-types`, `/runtime/orchestrate-up`
+- `/runtime/cdp-trace` (CDP performance traces, frame and JavaScript-task summaries)
 - `/cli`, `/cli/support`
 - `/visual-review`
 

package/dist/core/parameters.d.ts

@@ -1,5 +1,13 @@
 export declare function resolveRecipeParams(ref: string, recipe: Record<string, unknown>, input: Record<string, unknown>, options?: {
     allowTemplates?: boolean;
 }): Record<string, unknown>;
-export declare function resolveRecipeValue(value: unknown, params: Record<string, unknown>, outputs?: ReadonlyMap<string, unknown>): unknown;
+/**
+ * `value` with its `{{params.*}}`/`{{outputs.*}}` references resolved. Strict
+ * (the default) interpolates every reference and throws on a missing one.
+ * `lenient` is the static view before a run: only an exact reference to a
+ * parameter that exists resolves; anything else stays as written.
+ */
+export declare function resolveRecipeValue(value: unknown, params: Record<string, unknown>, outputs?: ReadonlyMap<string, unknown>, options?: {
+    lenient?: boolean;
+}): unknown;
 //# sourceMappingURL=parameters.d.ts.map

package/dist/core/parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../src/core/parameters.ts"],"names":[],"mappings":"AAKA,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAoBT"}
+{"version":3,"file":"parameters.d.ts","sourceRoot":"","sources":["../../src/core/parameters.ts"],"names":[],"mappings":"AAKA,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CA6BT"}

package/dist/core/parameters.js

@@ -11,9 +11,19 @@ export function resolveRecipeParams(ref, recipe, input, options) {
     }
     return params;
 }
-export function resolveRecipeValue(value, params, outputs) {
+/**
+ * `value` with its `{{params.*}}`/`{{outputs.*}}` references resolved. Strict
+ * (the default) interpolates every reference and throws on a missing one.
+ * `lenient` is the static view before a run: only an exact reference to a
+ * parameter that exists resolves; anything else stays as written.
+ */
+export function resolveRecipeValue(value, params, outputs, options = {}) {
     if (typeof value === 'string') {
         const exact = /^\{\{(params|outputs)\.([A-Za-z0-9_.-]+)\}\}$/u.exec(value);
+        if (options.lenient) {
+            const found = exact?.[1] === 'params' ? nestedValue(params, exact[2]) : undefined;
+            return found ? found.value : value;
+        }
         if (exact) {
             if (exact[1] === 'outputs' && !outputs)
                 return value;
@@ -23,11 +33,15 @@ export function resolveRecipeValue(value, params, outputs) {
             ? _match
             : String(getRecipeReference(source, key, params, outputs)));
     }
-    if (Array.isArray(value))
-        return value.map((entry) => resolveRecipeValue(entry, params, outputs));
+    if (Array.isArray(value)) {
+        return value.map((entry) => resolveRecipeValue(entry, params, outputs, options));
+    }
     if (!isRecord(value))
         return value;
-    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, resolveRecipeValue(entry, params, outputs)]));
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [
+        key,
+        resolveRecipeValue(entry, params, outputs, options),
+    ]));
 }
 function getRecipeReference(source, path, params, outputs) {
     if (source === 'params')
@@ -41,17 +55,24 @@ function getRecipeReference(source, path, params, outputs) {
     return getNestedValue(outputs.get(nodeId), segments.join('.'), 'output');
 }
 function getNestedValue(value, path, kind) {
-    if (!path)
-        return value;
+    const found = nestedValue(value, path);
+    if (!found) {
+        throw new RecipeResolutionError('RECIPE_PARAMS_INVALID', `Recipe ${kind} ${path} is not defined.`, kind === 'parameter'
+            ? `declare ${path} in paramsSchema or provide it before running the recipe`
+            : `inspect the producing node output before referencing ${path}`);
+    }
+    return found.value;
+}
+// The value at a dotted path, or undefined when a segment is missing.
+function nestedValue(value, path) {
     let current = value;
+    if (!path)
+        return { value: current };
     for (const segment of path.split('.')) {
-        if (!isRecord(current) || !Object.hasOwn(current, segment)) {
-            throw new RecipeResolutionError('RECIPE_PARAMS_INVALID', `Recipe ${kind} ${path} is not defined.`, kind === 'parameter'
-                ? `declare ${path} in paramsSchema or provide it before running the recipe`
-                : `inspect the producing node output before referencing ${path}`);
-        }
+        if (!isRecord(current) || !Object.hasOwn(current, segment))
+            return undefined;
         current = current[segment];
     }
-    return current;
+    return { value: current };
 }
 //# sourceMappingURL=parameters.js.map

package/dist/core/parameters.js.map

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

package/dist/core/path.d.ts

@@ -1,7 +1,7 @@
 export declare function isPathWithin(root: string, candidate: string): boolean;
 export declare function readFileWithinRoot(root: string, relativePath: string): Promise<Buffer>;
 export declare function digestFileWithinRoot(root: string, relativePath: string): Promise<string>;
-export declare function statFileWithinRoot(root: string, relativePath: string): Promise<import("fs").Stats>;
+export declare function statFileWithinRoot(root: string, relativePath: string): Promise<import("node:fs").Stats>;
 export declare function writeFileWithinRoot(root: string, relativePath: string, data: string | Uint8Array): Promise<string>;
 export declare function copyFileWithinRoots(sourceRoot: string, sourceRelativePath: string, destinationRoot: string, destinationRelativePath: string): Promise<string>;
 //# sourceMappingURL=path.d.ts.map

package/dist/core/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/core/path.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,+BAO1E;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GAAG,UAAU,GACxB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,MAAM,EACvB,uBAAuB,EAAE,MAAM,GAC9B,OAAO,CAAC,MAAM,CAAC,CAwBjB"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/core/path.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO5F;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9F;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oCAO1E;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GAAG,UAAU,GACxB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,MAAM,EACvB,uBAAuB,EAAE,MAAM,GAC9B,OAAO,CAAC,MAAM,CAAC,CAwBjB"}

package/dist/runtime/cdp-trace.d.ts

@@ -0,0 +1,92 @@
+import { type FrameMetricSummary, type FrameSample, summarizeFrames } from './frame-metrics.js';
+import { type JavaScriptTaskMetricSummary, type JavaScriptTaskSample, summarizeJavaScriptTasks } from './js-task-metrics.js';
+export { type FrameMetricSummary, type FrameSample, type JavaScriptTaskMetricSummary, type JavaScriptTaskSample, summarizeFrames, summarizeJavaScriptTasks, };
+export interface TraceKind {
+    categories: readonly string[];
+    rendererScoped: boolean;
+    scope: string;
+    nativeSource: string;
+    javascriptTasks: boolean;
+    frameTiming: 'draw' | 'cadence';
+}
+export type PerformanceSourceStatus = 'complete' | 'partial' | 'unavailable';
+interface PerformanceSourceResult<TSample, TSummary> {
+    status: PerformanceSourceStatus;
+    kind: string;
+    unavailableReasons: string[];
+    coverageGapReasons: string[];
+    samples: TSample[];
+    summary: TSummary;
+    clockSyncUncertaintyMs?: number;
+}
+type JavaScriptPerformanceSourceBase = Omit<PerformanceSourceResult<JavaScriptTaskSample, JavaScriptTaskMetricSummary>, 'summary'>;
+export type JavaScriptPerformanceSourceResult = (JavaScriptPerformanceSourceBase & {
+    applicability: 'applicable';
+    summary: JavaScriptTaskMetricSummary;
+}) | (JavaScriptPerformanceSourceBase & {
+    applicability: 'not_applicable';
+    summary: Record<string, never>;
+});
+export type NativeUiPerformanceSourceResult = PerformanceSourceResult<FrameSample, FrameMetricSummary>;
+export interface PerformanceCaptureResult<P extends string = string> {
+    platform: P;
+    javascript: JavaScriptPerformanceSourceResult;
+    nativeUi: NativeUiPerformanceSourceResult;
+    trace: TraceEvidence;
+    rawTraceEvents?: TraceEvent[];
+}
+export interface TraceEvidence {
+    beginFrameCount: number;
+    dataLossOccurred: boolean;
+    drawFrameCount: number;
+    overflow: boolean;
+    profileChunkCount: number;
+    rendererProcessId?: number;
+    runTaskCount: number;
+    scope: string;
+    totalEventCount: number;
+}
+export interface PerformanceBackend<P extends string = string> {
+    start(id: string): Promise<void>;
+    end(id: string): Promise<PerformanceCaptureResult<P>>;
+    close(): Promise<void>;
+}
+export interface CdpClient {
+    send(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    on(method: string, handler: (params: Record<string, unknown>) => void): () => void;
+    close(): void;
+}
+export interface TraceEvent {
+    name?: string;
+    cat?: string;
+    ph?: string;
+    ts?: number;
+    dur?: number;
+    pid?: number;
+    tid?: number;
+    args?: Record<string, unknown>;
+}
+export interface TraceCapture<P extends string = string> {
+    platform: P;
+    events: TraceEvent[];
+    markerName?: string;
+    markerHostEpochMs?: number;
+    markerUncertaintyMs?: number;
+    dataLossOccurred: boolean;
+    overflow: boolean;
+    unavailableReasons: string[];
+    coverageGapReasons: string[];
+}
+export interface TraceClockSync {
+    hostEpochMs: number;
+    uncertaintyMs: number;
+}
+export interface CdpTraceCollectorOptions<P extends string = string> {
+    kind: TraceKind;
+    platform: P;
+    marker(name: string): Promise<TraceClockSync>;
+    markerPrefix?: string;
+}
+export declare function createCdpTraceCollector<P extends string = string>(client: CdpClient, { kind, platform, marker, markerPrefix }: CdpTraceCollectorOptions<P>): PerformanceBackend<P>;
+export declare function parseTraceCapture<P extends string = string>(capture: TraceCapture<P>, kind: TraceKind): PerformanceCaptureResult<P>;
+//# sourceMappingURL=cdp-trace.d.ts.map

package/dist/runtime/cdp-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-trace.d.ts","sourceRoot":"","sources":["../../src/runtime/cdp-trace.ts"],"names":[],"mappings":"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"}

package/dist/runtime/cdp-trace.js

@@ -0,0 +1,385 @@
+// CDP performance traces: start and end a `Tracing` capture over a CDP
+// client, align it to the host clock through a marker written into the trace,
+// and turn it into JavaScript-task and native-frame samples with summaries.
+// The host names what a trace captures with a `TraceKind`.
+import { summarizeFrames } from './frame-metrics.js';
+import { summarizeJavaScriptTasks, } from './js-task-metrics.js';
+export { summarizeFrames, summarizeJavaScriptTasks, };
+const MAX_TRACE_BYTES = 16 * 1024 * 1024;
+const MAX_TRACE_EVENTS = 250_000;
+const DEFAULT_MARKER_PREFIX = 'farmslot-clock-';
+export function createCdpTraceCollector(client, { kind, platform, marker, markerPrefix = DEFAULT_MARKER_PREFIX }) {
+    let active;
+    const offData = client.on('Tracing.dataCollected', (params) => {
+        if (!active || !Array.isArray(params.value))
+            return;
+        for (const value of params.value) {
+            if (!value || typeof value !== 'object' || Array.isArray(value))
+                continue;
+            const event = value;
+            const bytes = Buffer.byteLength(JSON.stringify(event));
+            if (active.events.length >= MAX_TRACE_EVENTS || active.bytes + bytes > MAX_TRACE_BYTES) {
+                active.overflow = true;
+                continue;
+            }
+            active.events.push(event);
+            active.bytes += bytes;
+        }
+    });
+    const offComplete = client.on('Tracing.tracingComplete', (params) => {
+        if (!active)
+            return;
+        active.dataLossOccurred = params.dataLossOccurred === true;
+        active.complete?.();
+    });
+    return {
+        async start(id) {
+            if (active)
+                throw new Error('Only one CDP performance trace may be active.');
+            let complete;
+            const completePromise = new Promise((resolve) => {
+                complete = resolve;
+            });
+            active = {
+                id,
+                events: [],
+                bytes: 0,
+                overflow: false,
+                dataLossOccurred: false,
+                complete,
+                completePromise,
+            };
+            let tracingStarted = false;
+            try {
+                await client.send('Tracing.start', {
+                    categories: kind.categories.join(','),
+                    transferMode: 'ReportEvents',
+                }, 15_000);
+                tracingStarted = true;
+                const markerName = `${markerPrefix}${id}-${Date.now()}`;
+                const sync = await marker(markerName);
+                active.markerName = markerName;
+                active.markerHostEpochMs = sync.hostEpochMs;
+                active.markerUncertaintyMs = sync.uncertaintyMs;
+            }
+            catch (error) {
+                if (tracingStarted) {
+                    await client.send('Tracing.end', {}, 5_000).catch(() => undefined);
+                    await withTimeout(active.completePromise, 1_000, 'CDP tracing cleanup did not report tracingComplete.').catch(() => undefined);
+                }
+                active = undefined;
+                throw error;
+            }
+        },
+        async end(id) {
+            const capture = active;
+            if (!capture || capture.id !== id) {
+                throw new Error(`Performance capture is not active: ${id}`);
+            }
+            try {
+                await client.send('Tracing.end', {}, 15_000);
+                await withTimeout(capture.completePromise, 30_000, 'CDP tracing did not report tracingComplete.');
+            }
+            finally {
+                active = undefined;
+            }
+            return parseTraceCapture({
+                platform,
+                events: capture.events,
+                markerName: capture.markerName,
+                markerHostEpochMs: capture.markerHostEpochMs,
+                markerUncertaintyMs: capture.markerUncertaintyMs,
+                dataLossOccurred: capture.dataLossOccurred,
+                overflow: capture.overflow,
+                unavailableReasons: [],
+                coverageGapReasons: [],
+            }, kind);
+        },
+        async close() {
+            if (active) {
+                await client.send('Tracing.end', {}, 5_000).catch(() => undefined);
+                await withTimeout(active.completePromise, 1_000, 'CDP tracing cleanup did not report tracingComplete.').catch(() => undefined);
+                active = undefined;
+            }
+            offData();
+            offComplete();
+            client.close();
+        },
+    };
+}
+export function parseTraceCapture(capture, kind) {
+    const marker = findClockMarker(capture.events, capture.markerName);
+    if (kind.rendererScoped && !finite(marker?.pid)) {
+        const reason = 'Extension trace marker did not identify a renderer process.';
+        return {
+            platform: capture.platform,
+            javascript: unavailableJavaScriptSource('cdp-js-runtime-tasks', reason),
+            nativeUi: unavailableNativeUiSource('cdp-native-frame-timings', reason),
+            trace: traceEvidence(capture, 'unresolved'),
+        };
+    }
+    const rendererProcessId = kind.rendererScoped ? marker?.pid : undefined;
+    const scopedEvents = rendererProcessId === undefined
+        ? capture.events
+        : capture.events.filter((event) => event.pid === rendererProcessId);
+    const trace = traceEvidence({ ...capture, events: scopedEvents }, kind.scope, rendererProcessId);
+    if (!marker ||
+        !finite(marker.ts) ||
+        capture.markerHostEpochMs === undefined ||
+        capture.markerUncertaintyMs === undefined) {
+        const reason = 'CDP trace clock marker was unavailable.';
+        return {
+            platform: capture.platform,
+            javascript: unavailableJavaScriptSource('cdp-js-runtime-tasks', reason),
+            nativeUi: unavailableNativeUiSource('cdp-native-frame-timings', reason),
+            trace,
+        };
+    }
+    const markerTs = marker.ts;
+    const markerHostEpochMs = capture.markerHostEpochMs;
+    const traceToEpochMs = (timestampUs) => markerHostEpochMs + (timestampUs - markerTs) / 1000;
+    const gapReasons = [
+        ...capture.coverageGapReasons,
+        ...(capture.overflow ? ['CDP trace retention limit was reached.'] : []),
+        ...(capture.dataLossOccurred ? ['CDP reported trace data loss.'] : []),
+    ];
+    const nativeSamples = nativeFrameSamples(scopedEvents, kind.frameTiming, traceToEpochMs);
+    const javascriptSamples = javascriptTaskSamples(scopedEvents, traceToEpochMs);
+    const status = capture.overflow || capture.dataLossOccurred ? 'partial' : 'complete';
+    return {
+        platform: capture.platform,
+        javascript: javascriptSourceResult('cdp-js-runtime-tasks', javascriptSamples, status, gapReasons, traceEventNames(scopedEvents), capture.markerUncertaintyMs),
+        nativeUi: nativeUiSourceResult(kind.nativeSource, nativeSamples, status, gapReasons, traceEventNames(scopedEvents), capture.markerUncertaintyMs),
+        trace,
+        rawTraceEvents: normalizeTraceTimestamps(scopedEvents, traceToEpochMs),
+    };
+}
+function normalizeTraceTimestamps(events, traceToEpochMs) {
+    return events.map((event) => finite(event.ts) ? { ...event, ts: traceToEpochMs(event.ts) * 1000 } : { ...event });
+}
+function traceEvidence(capture, scope, rendererProcessId) {
+    const counts = new Map();
+    for (const event of capture.events) {
+        const name = String(event.name ?? '');
+        counts.set(name, (counts.get(name) ?? 0) + 1);
+    }
+    return {
+        beginFrameCount: counts.get('BeginFrame') ?? 0,
+        dataLossOccurred: capture.dataLossOccurred,
+        drawFrameCount: counts.get('DrawFrame') ?? 0,
+        overflow: capture.overflow,
+        profileChunkCount: counts.get('ProfileChunk') ?? 0,
+        ...(rendererProcessId === undefined ? {} : { rendererProcessId }),
+        runTaskCount: counts.get('RunTask') ?? 0,
+        scope,
+        totalEventCount: capture.events.length,
+    };
+}
+function nativeFrameSamples(events, frameTiming, traceToEpochMs) {
+    const begins = new Map();
+    const frames = [];
+    for (const event of events) {
+        if (event.name !== 'BeginFrame' && event.name !== 'DrawFrame')
+            continue;
+        const sequence = frameSequence(event);
+        if (!sequence || !finite(event.ts))
+            continue;
+        if (event.name === 'BeginFrame') {
+            begins.set(sequence, event);
+            continue;
+        }
+        const begin = begins.get(sequence);
+        if (!begin || !finite(begin.ts))
+            continue;
+        frames.push({ beginUs: begin.ts, endUs: event.ts });
+    }
+    frames.sort((first, second) => first.beginUs - second.beginUs);
+    const frameBudgetMs = estimateFrameBudgetMs(frames);
+    if (frameTiming === 'cadence') {
+        const samples = [];
+        for (let index = 1; index < frames.length; index += 1) {
+            const previous = frames[index - 1];
+            const current = frames[index];
+            if (!previous || !current)
+                continue;
+            const durationMs = (current.beginUs - previous.beginUs) / 1000;
+            if (durationMs <= 0)
+                continue;
+            samples.push({
+                cadenceInterval: true,
+                completedAtEpochMs: traceToEpochMs(current.beginUs),
+                durationMs,
+                ...(frameBudgetMs
+                    ? {
+                        frameBudgetMs,
+                        overBudget: durationMs > frameBudgetMs * 1.01,
+                    }
+                    : {}),
+                startedAtEpochMs: traceToEpochMs(previous.beginUs),
+            });
+        }
+        return samples;
+    }
+    return frames
+        .map((frame) => {
+        const durationMs = (frame.endUs - frame.beginUs) / 1000;
+        return {
+            completedAtEpochMs: traceToEpochMs(frame.endUs),
+            durationMs,
+            ...(frameBudgetMs
+                ? {
+                    frameBudgetMs,
+                    overBudget: durationMs > frameBudgetMs * 1.01,
+                }
+                : {}),
+            startedAtEpochMs: traceToEpochMs(frame.beginUs),
+        };
+    })
+        .filter((sample) => sample.durationMs > 0);
+}
+function estimateFrameBudgetMs(frames) {
+    const cadenceMs = [];
+    for (let index = 1; index < frames.length; index += 1) {
+        const previous = frames[index - 1];
+        const current = frames[index];
+        if (!previous || !current)
+            continue;
+        const intervalMs = (current.beginUs - previous.beginUs) / 1000;
+        if (intervalMs >= 3.5 && intervalMs <= 40)
+            cadenceMs.push(intervalMs);
+    }
+    if (cadenceMs.length < 5)
+        return undefined;
+    cadenceMs.sort((first, second) => first - second);
+    const observedBudgetMs = percentile(cadenceMs, 0.1);
+    const refreshRateHz = Math.round(1000 / observedBudgetMs);
+    return refreshRateHz >= 24 && refreshRateHz <= 240 ? 1000 / refreshRateHz : undefined;
+}
+function percentile(sorted, quantile) {
+    if (sorted.length === 1)
+        return sorted[0] ?? 0;
+    const position = (sorted.length - 1) * quantile;
+    const lower = Math.floor(position);
+    const upper = Math.ceil(position);
+    const lowerValue = sorted[lower] ?? 0;
+    const upperValue = sorted[upper] ?? lowerValue;
+    return lowerValue + (upperValue - lowerValue) * (position - lower);
+}
+function javascriptTaskSamples(events, traceToEpochMs) {
+    const samples = [];
+    for (const event of events) {
+        if (event.name !== 'RunTask' || event.ph !== 'X')
+            continue;
+        if (!finite(event.ts) || !finite(event.dur) || event.dur <= 0)
+            continue;
+        samples.push({
+            completedAtEpochMs: traceToEpochMs(event.ts + event.dur),
+            durationMs: event.dur / 1000,
+        });
+    }
+    return samples;
+}
+function findClockMarker(events, markerName) {
+    if (!markerName)
+        return undefined;
+    return events.find((candidate) => candidate.name === markerName ||
+        asRecord(candidate.args).sync_id === markerName ||
+        asRecord(asRecord(candidate.args).data).sync_id === markerName);
+}
+function frameSequence(event) {
+    const args = asRecord(event.args);
+    const value = args.frameSeqId ?? asRecord(args.data).frameSeqId;
+    return value === undefined ? undefined : String(value);
+}
+function javascriptSourceResult(kind, samples, status, coverageGapReasons, observedEventNames, clockSyncUncertaintyMs) {
+    return {
+        applicability: 'applicable',
+        status: samples.length > 0 ? status : 'partial',
+        kind,
+        unavailableReasons: [],
+        coverageGapReasons: [
+            ...coverageGapReasons,
+            ...(samples.length > 0
+                ? []
+                : [
+                    `No ${kind} samples were recorded. Observed trace events: ${observedEventNames.join(', ') || 'none'}.`,
+                ]),
+        ],
+        samples,
+        summary: summarizeJavaScriptTasks(samples),
+        clockSyncUncertaintyMs,
+    };
+}
+function nativeUiSourceResult(kind, samples, status, coverageGapReasons, observedEventNames, clockSyncUncertaintyMs) {
+    const summary = summarizeFrames(samples);
+    const hasUnclassifiedCadenceGap = (summary.cadenceGapCount ?? 0) > 0;
+    return {
+        status: samples.length === 0 ? 'partial' : hasUnclassifiedCadenceGap ? 'partial' : status,
+        kind,
+        unavailableReasons: [],
+        coverageGapReasons: [
+            ...coverageGapReasons,
+            ...(samples.length > 0
+                ? []
+                : [
+                    `No ${kind} samples were recorded. Observed trace events: ${observedEventNames.join(', ') || 'none'}.`,
+                ]),
+            ...(hasUnclassifiedCadenceGap
+                ? ['Unclassified native cadence gap prevents a complete FPS result.']
+                : []),
+        ],
+        samples,
+        summary,
+        clockSyncUncertaintyMs,
+    };
+}
+function traceEventNames(events) {
+    const counts = new Map();
+    for (const event of events) {
+        const name = String(event.name ?? 'unknown');
+        counts.set(name, (counts.get(name) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .sort((first, second) => second[1] - first[1])
+        .slice(0, 20)
+        .map(([name, count]) => `${name}(${count})`);
+}
+function unavailableJavaScriptSource(kind, reason) {
+    return {
+        applicability: 'applicable',
+        status: 'unavailable',
+        kind,
+        unavailableReasons: [reason],
+        coverageGapReasons: [],
+        samples: [],
+        summary: { taskCount: 0 },
+    };
+}
+function unavailableNativeUiSource(kind, reason) {
+    return {
+        status: 'unavailable',
+        kind,
+        unavailableReasons: [reason],
+        coverageGapReasons: [],
+        samples: [],
+        summary: { frameCount: 0 },
+    };
+}
+function withTimeout(promise, timeoutMs, message) {
+    let timer;
+    return Promise.race([
+        promise,
+        new Promise((_resolve, reject) => {
+            timer = setTimeout(() => reject(new Error(message)), timeoutMs);
+        }),
+    ]).finally(() => clearTimeout(timer));
+}
+function finite(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+//# sourceMappingURL=cdp-trace.js.map

package/dist/runtime/cdp-trace.js.map

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

package/dist/runtime/frame-metrics.d.ts

@@ -0,0 +1,26 @@
+export interface FrameSample {
+    cadenceInterval?: boolean;
+    completedAtEpochMs: number;
+    durationMs: number;
+    frameBudgetMs?: number;
+    overBudget?: boolean;
+    startedAtEpochMs?: number;
+}
+export interface FrameMetricSummary {
+    activeFps?: number;
+    cadenceGapCount?: number;
+    fpsIntervalCount?: number;
+    fpsUnavailableReason?: 'insufficient_active_frames' | 'refresh_rate_unavailable' | 'unclassified_cadence_gap';
+    frameBudgetMs?: number;
+    frameCount: number;
+    longestCadenceGapMs?: number;
+    longestFrameMs?: number;
+    overBudgetFrameCount?: number;
+    overBudgetFramePercent?: number;
+    p50FrameMs?: number;
+    p95FrameMs?: number;
+    p99FrameMs?: number;
+    refreshRateHz?: number;
+}
+export declare function summarizeFrames(samples: readonly FrameSample[]): FrameMetricSummary;
+//# sourceMappingURL=frame-metrics.d.ts.map

package/dist/runtime/frame-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-metrics.d.ts","sourceRoot":"","sources":["../../src/runtime/frame-metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EACjB,4BAA4B,GAC5B,0BAA0B,GAC1B,0BAA0B,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,kBAAkB,CAgGnF"}

package/dist/runtime/frame-metrics.js

@@ -0,0 +1,134 @@
+const MIN_ACTIVE_INTERVALS = 5;
+export function summarizeFrames(samples) {
+    const allValidSamples = samples.filter((sample) => Number.isFinite(sample.durationMs) && sample.durationMs > 0);
+    const frameBudgetMs = commonFrameBudget(allValidSamples);
+    const cadenceSamples = allValidSamples.length > 0 &&
+        allValidSamples.every((sample) => sample.cadenceInterval === true);
+    const cadenceGaps = cadenceSamples && frameBudgetMs
+        ? allValidSamples.filter((sample) => sample.durationMs > frameBudgetMs * 3.01)
+        : [];
+    const validSamples = cadenceGaps.length > 0
+        ? allValidSamples.filter((sample) => sample.durationMs <= (frameBudgetMs ?? 0) * 3.01)
+        : allValidSamples;
+    const durations = validSamples
+        .map((sample) => sample.durationMs)
+        .sort((first, second) => first - second);
+    if (durations.length === 0) {
+        return {
+            fpsUnavailableReason: frameBudgetMs
+                ? 'insufficient_active_frames'
+                : 'refresh_rate_unavailable',
+            ...(cadenceGaps.length > 0
+                ? {
+                    cadenceGapCount: cadenceGaps.length,
+                    longestCadenceGapMs: round(Math.max(...cadenceGaps.map((sample) => sample.durationMs))),
+                }
+                : {}),
+            ...(frameBudgetMs
+                ? {
+                    frameBudgetMs: round(frameBudgetMs),
+                    refreshRateHz: round(1000 / frameBudgetMs),
+                }
+                : {}),
+            frameCount: 0,
+        };
+    }
+    const frameBudgetOutcomes = validSamples
+        .map((sample) => sample.overBudget)
+        .filter((value) => value !== undefined);
+    const missedFrameBudgetCount = frameBudgetOutcomes.filter(Boolean).length;
+    const activeIntervals = frameBudgetMs
+        ? activeRenderingIntervals(validSamples, frameBudgetMs)
+        : [];
+    const activeElapsedMs = activeIntervals.reduce((total, interval) => total + interval, 0);
+    const hasActiveFps = cadenceGaps.length === 0 &&
+        activeIntervals.length >= MIN_ACTIVE_INTERVALS &&
+        activeElapsedMs > 0;
+    const refreshRateHz = frameBudgetMs ? 1000 / frameBudgetMs : undefined;
+    return {
+        ...(hasActiveFps
+            ? {
+                activeFps: round(Math.min(refreshRateHz ?? Number.POSITIVE_INFINITY, (activeIntervals.length * 1000) / activeElapsedMs)),
+                fpsIntervalCount: activeIntervals.length,
+            }
+            : {
+                fpsUnavailableReason: frameBudgetMs
+                    ? cadenceGaps.length > 0
+                        ? 'unclassified_cadence_gap'
+                        : 'insufficient_active_frames'
+                    : 'refresh_rate_unavailable',
+            }),
+        ...(cadenceGaps.length > 0
+            ? {
+                cadenceGapCount: cadenceGaps.length,
+                longestCadenceGapMs: round(Math.max(...cadenceGaps.map((sample) => sample.durationMs))),
+            }
+            : {}),
+        ...(frameBudgetMs
+            ? {
+                frameBudgetMs: round(frameBudgetMs),
+                refreshRateHz: round(1000 / frameBudgetMs),
+            }
+            : {}),
+        frameCount: durations.length,
+        ...(frameBudgetOutcomes.length === validSamples.length
+            ? {
+                overBudgetFrameCount: missedFrameBudgetCount,
+                overBudgetFramePercent: round((missedFrameBudgetCount / validSamples.length) * 100),
+            }
+            : {}),
+        longestFrameMs: round(durations.at(-1) ?? 0),
+        p50FrameMs: round(percentile(durations, 0.5)),
+        p95FrameMs: round(percentile(durations, 0.95)),
+        p99FrameMs: round(percentile(durations, 0.99)),
+    };
+}
+function commonFrameBudget(samples) {
+    const budgets = samples
+        .map((sample) => sample.frameBudgetMs)
+        .filter((value) => value !== undefined && Number.isFinite(value) && value > 0)
+        .sort((first, second) => first - second);
+    return budgets.length > 0 ? percentile(budgets, 0.5) : undefined;
+}
+function activeRenderingIntervals(samples, frameBudgetMs) {
+    if (samples.every((sample) => sample.cadenceInterval === true)) {
+        return samples
+            .map((sample) => sample.durationMs)
+            .filter((durationMs) => Number.isFinite(durationMs) && durationMs > 0 && durationMs <= frameBudgetMs * 3.01);
+    }
+    const ordered = [...samples]
+        .map((sample) => ({
+        ...sample,
+        startedAtEpochMs: sample.startedAtEpochMs ?? sample.completedAtEpochMs - sample.durationMs,
+    }))
+        .sort((first, second) => first.startedAtEpochMs - second.startedAtEpochMs);
+    const intervals = [];
+    for (let index = 1; index < ordered.length; index += 1) {
+        const previous = ordered[index - 1];
+        const current = ordered[index];
+        if (!previous || !current)
+            continue;
+        const interval = current.startedAtEpochMs - previous.startedAtEpochMs;
+        if (!Number.isFinite(interval) || interval <= 0)
+            continue;
+        const continuous = interval <= frameBudgetMs * 3.01;
+        const explainedBySlowFrame = Math.max(previous.durationMs, current.durationMs) >= interval - frameBudgetMs * 1.01;
+        if (continuous || explainedBySlowFrame)
+            intervals.push(interval);
+    }
+    return intervals;
+}
+function percentile(sorted, quantile) {
+    if (sorted.length === 1)
+        return sorted[0] ?? 0;
+    const position = (sorted.length - 1) * quantile;
+    const lower = Math.floor(position);
+    const upper = Math.ceil(position);
+    const lowerValue = sorted[lower] ?? 0;
+    const upperValue = sorted[upper] ?? lowerValue;
+    return lowerValue + (upperValue - lowerValue) * (position - lower);
+}
+function round(value) {
+    return Math.round(value * 1000) / 1000;
+}
+//# sourceMappingURL=frame-metrics.js.map

package/dist/runtime/frame-metrics.js.map

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

package/dist/runtime/js-task-metrics.d.ts

@@ -0,0 +1,16 @@
+export interface JavaScriptTaskSample {
+    completedAtEpochMs: number;
+    durationMs: number;
+}
+export interface JavaScriptTaskMetricSummary {
+    longestTaskMs?: number;
+    longTaskCount?: number;
+    longTaskPercent?: number;
+    p50TaskMs?: number;
+    p95TaskMs?: number;
+    p99TaskMs?: number;
+    taskCount: number;
+    totalTaskTimeMs?: number;
+}
+export declare function summarizeJavaScriptTasks(samples: readonly JavaScriptTaskSample[]): JavaScriptTaskMetricSummary;
+//# sourceMappingURL=js-task-metrics.d.ts.map

package/dist/runtime/js-task-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-task-metrics.d.ts","sourceRoot":"","sources":["../../src/runtime/js-task-metrics.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,oBAAoB,EAAE,GACvC,2BAA2B,CAkB7B"}

package/dist/runtime/js-task-metrics.js

@@ -0,0 +1,34 @@
+const LONG_TASK_MS = 50;
+export function summarizeJavaScriptTasks(samples) {
+    const durations = samples
+        .map((sample) => sample.durationMs)
+        .filter((duration) => Number.isFinite(duration) && duration > 0)
+        .sort((first, second) => first - second);
+    if (durations.length === 0)
+        return { taskCount: 0 };
+    const longTaskCount = durations.filter((duration) => duration >= LONG_TASK_MS).length;
+    return {
+        longestTaskMs: round(durations.at(-1) ?? 0),
+        longTaskCount,
+        longTaskPercent: round((longTaskCount / durations.length) * 100),
+        p50TaskMs: round(percentile(durations, 0.5)),
+        p95TaskMs: round(percentile(durations, 0.95)),
+        p99TaskMs: round(percentile(durations, 0.99)),
+        taskCount: durations.length,
+        totalTaskTimeMs: round(durations.reduce((total, duration) => total + duration, 0)),
+    };
+}
+function percentile(sorted, quantile) {
+    if (sorted.length === 1)
+        return sorted[0] ?? 0;
+    const position = (sorted.length - 1) * quantile;
+    const lower = Math.floor(position);
+    const upper = Math.ceil(position);
+    const lowerValue = sorted[lower] ?? 0;
+    const upperValue = sorted[upper] ?? lowerValue;
+    return lowerValue + (upperValue - lowerValue) * (position - lower);
+}
+function round(value) {
+    return Math.round(value * 1000) / 1000;
+}
+//# sourceMappingURL=js-task-metrics.js.map

package/dist/runtime/js-task-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"js-task-metrics.js","sourceRoot":"","sources":["../../src/runtime/js-task-metrics.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,EAAE,CAAC;AAkBxB,MAAM,UAAU,wBAAwB,CACtC,OAAwC;IAExC,MAAM,SAAS,GAAG,OAAO;SACtB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC;SAClC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;SAC/D,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;IAC3C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAEpD,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAC,MAAM,CAAC;IACtF,OAAO;QACL,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3C,aAAa;QACb,eAAe,EAAE,KAAK,CAAC,CAAC,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;QAChE,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC5C,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7C,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7C,SAAS,EAAE,SAAS,CAAC,MAAM;QAC3B,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,MAAyB,EAAE,QAAgB;IAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC;IAC/C,OAAO,UAAU,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACzC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/recipe-runner",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -63,6 +63,11 @@
       "import": "./dist/runtime/cdp.js",
       "default": "./dist/runtime/cdp.js"
     },
+    "./runtime/cdp-trace": {
+      "types": "./dist/runtime/cdp-trace.d.ts",
+      "import": "./dist/runtime/cdp-trace.js",
+      "default": "./dist/runtime/cdp-trace.js"
+    },
     "./runtime/react-native-bridge": {
       "types": "./dist/runtime/react-native-bridge.d.ts",
       "import": "./dist/runtime/react-native-bridge.js",