perfgraph 0.1.0

package/dist/mcp/server.js

@@ -0,0 +1,452 @@
+/**
+ * PerfGraph MCP Server.
+ *
+ * Exposes PerfGraph's full performance diagnostic pipeline through
+ * the Model Context Protocol. Primary usage is the `perfgraph_run` tool
+ * (one-shot URL → report). Advanced users can invoke individual pipeline
+ * steps via dedicated tools.
+ *
+ * Resources are available at `perfgraph://artifacts/{encoded-path}/{filename}`
+ * for reading collected data and generated reports.
+ *
+ * Usage (AI client config):
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "perfgraph": {
+ *       "command": "node",
+ *       "args": ["dist/index.js", "mcp"]
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { McpServer, ResourceTemplate, } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { RunArgsSchema, CollectArgsSchema, NormalizeArgsSchema, ExtractArgsSchema, AnalyzeArgsSchema, ReportArgsSchema, ToonArgsSchema, } from './types.js';
+import { handleRun, handleCollect, handleNormalize, handleExtract, handleAnalyze, handleReport, } from './handlers.js';
+import { readResource, listArtifacts, encodePath, toon as toonResource, } from './resources.js';
+import { createProgressReporter } from './progress.js';
+import { buildLcpAnalysisPrompt, LcpAnalysisArgsSchema, buildAuditPrompt, AuditArgsSchema, buildSummarizePrompt, SummarizeArgsSchema, } from './prompts.js';
+// ---------------------------------------------------------------------------
+// Server entry point
+// ---------------------------------------------------------------------------
+/**
+ * Start the MCP stdio server.
+ *
+ * Registers all tools and resources, then listens for JSON-RPC messages
+ * on stdin/stdout. Never resolves — the server runs until the process
+ * is killed.
+ */
+export async function startMcpServer() {
+    const server = new McpServer({
+        name: 'perfgraph',
+        version: '1.0.0',
+    });
+    // -----------------------------------------------------------------------
+    // Primary shortcut: full pipeline in one call
+    // -----------------------------------------------------------------------
+    server.registerTool('perfgraph_run', {
+        description: `Run the full PerfGraph pipeline on a URL: collect trace data, normalize, extract diagnostic features, build a causal degradation graph, and generate a performance report.
+
+Returns a structured result with report file paths, performance score, issue counts, and a severity map of detected problems.
+
+After calling this tool, you can read the full report via the perfgraph:// resource URIs returned in the 'files' field.
+
+EXAMPLE:
+  agent calls perfgraph_run with url = "https://example.com"
+  → receives summary + file paths to report.json, features.json, graph.json
+  → reads report.json via perfgraph://artifacts/<path>/report.json for full details
+
+This is the PRIMARY tool — use this for most performance analysis tasks.`,
+        inputSchema: RunArgsSchema,
+    }, async (args, extra) => {
+        try {
+            const progress = createProgressReporter(extra.sendNotification, extra._meta?.progressToken);
+            const result = await handleRun(args.url, args.outputDir, args.runs, progress, args.mobile);
+            // Enrich result with resource URIs
+            const encodedPath = encodePath(result.outputDir);
+            const enriched = {
+                ...result,
+                resourceUris: {
+                    report: `perfgraph://artifacts/${encodedPath}/report.json`,
+                    features: `perfgraph://artifacts/${encodedPath}/features.json`,
+                    graph: `perfgraph://artifacts/${encodedPath}/graph.json`,
+                },
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(enriched, null, 2) }],
+            };
+        }
+        catch (err) {
+            const message = err.message;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // -----------------------------------------------------------------------
+    // Advanced tools: individual pipeline steps
+    // -----------------------------------------------------------------------
+    server.registerTool('perfgraph_collect', {
+        description: `[Advanced] Collect raw performance data from a URL without running the full pipeline.
+
+Use this when you only need the raw CDP data (trace, network, lighthouse, etc.)
+without normalization or analysis. The collected data is written to a local
+output directory.
+
+ADVANCED TOOL: For most use cases, prefer perfgraph_run which runs the full pipeline.`,
+        inputSchema: CollectArgsSchema,
+    }, async (args, extra) => {
+        try {
+            const progress = createProgressReporter(extra.sendNotification, extra._meta?.progressToken);
+            const result = await handleCollect(args.url, args.outputDir, args.runs, progress, args.mobile);
+            if (!result.success) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: result.error }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: err.message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('perfgraph_normalize', {
+        description: `[Advanced] Normalize collected CDP data into a validated Intermediate Representation (IRBundle).
+
+Accepts a run directory path (from perfgraph_collect) and produces a typed,
+validated IRBundle with normalized timestamps across all clock domains.
+
+ADVANCED TOOL: Usually called automatically by perfgraph_run. Use this when
+you need to inspect or debug the normalization step.`,
+        inputSchema: NormalizeArgsSchema,
+    }, async (args) => {
+        try {
+            const result = await handleNormalize(args.runDir);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: err.message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('perfgraph_extract', {
+        description: `[Advanced] Extract diagnostic features from a normalized IRBundle.
+
+Computes 7 feature metrics: LCP breakdown, critical path analysis, main thread
+blocking, JS execution hotspots, layout shifts, third-party overhead, and
+render-blocking resource score.
+
+ADVANCED TOOL: Usually called automatically by perfgraph_run. Use this when
+you want to inspect the raw feature set before causal analysis.`,
+        inputSchema: ExtractArgsSchema,
+    }, async (args) => {
+        try {
+            const result = await handleExtract(args.irFile);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: err.message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('perfgraph_analyze', {
+        description: `[Advanced] Build a causal degradation graph from extracted features.
+
+Applies 30+ causal rules from 4 rule sets (LCP, JS, Network, Layout) and
+produces a deterministic DAG where each edge has a confidence level
+(strong/medium/weak).
+
+ADVANCED TOOL: Usually called automatically by perfgraph_run. Use this when
+you need to inspect the causal graph structure directly.`,
+        inputSchema: AnalyzeArgsSchema,
+    }, async (args) => {
+        try {
+            const result = await handleAnalyze(args.featuresFile);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: err.message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('perfgraph_report', {
+        description: `[Advanced] Generate a comprehensive performance report from extracted features.
+
+Produces a self-contained JSON report with: issues sorted by severity, causal
+chains from root cause to impact, prioritized recommendations with remediation
+texts (in Russian), and raw features for cross-referencing.
+
+ADVANCED TOOL: Usually called automatically by perfgraph_run. Use this when
+you have already extracted features and want to generate a report separately.`,
+        inputSchema: ReportArgsSchema,
+    }, async (args) => {
+        try {
+            const result = await handleReport(args.featuresFile);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: err.message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // -----------------------------------------------------------------------
+    // TOON format tool
+    // -----------------------------------------------------------------------
+    server.registerTool('perfgraph_toon', {
+        description: `Convert a PerfGraph run's results into TOON (Token-Oriented Object Notation) format.
+
+TOON is a compact, human-readable encoding of JSON designed to minimise token
+usage in LLM prompts. It declares array lengths and field headers once, then
+streams row values — making it ideal for AI consumption.
+
+Accepts a run directory path (from perfgraph_run or perfgraph_collect) and
+returns the run's report, features, and causal graph encoded as TOON.
+
+After calling this tool, you can also access the TOON data via the resource
+URI: webtr://runs/{encoded-runDir}/toon
+
+ADVANCED TOOL: Use when you need token-optimised performance data for
+LLM-based analysis or chaining into other AI tools.`,
+        inputSchema: ToonArgsSchema,
+    }, async (args) => {
+        try {
+            const uri = `webtr://runs/${encodePath(args.runDir)}/toon`;
+            const content = toonResource(uri);
+            return {
+                content: [{ type: 'text', text: content.text }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: err.message }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // -----------------------------------------------------------------------
+    // Resources
+    // -----------------------------------------------------------------------
+    server.registerResource('perfgraph-artifact', new ResourceTemplate('perfgraph://artifacts/{path}/{filename}', {
+        list: async () => {
+            return {
+                resources: [
+                    {
+                        uri: 'perfgraph://artifacts/<run-dir>/report.json',
+                        name: 'Full Diagnostic Report',
+                        description: 'Complete performance report with issues, causal chains, and recommendations',
+                    },
+                    {
+                        uri: 'perfgraph://artifacts/<run-dir>/features.json',
+                        name: 'Extracted Features',
+                        description: 'Raw diagnostic feature set (LCP, TBT, CLS, critical path, etc.)',
+                    },
+                    {
+                        uri: 'perfgraph://artifacts/<run-dir>/graph.json',
+                        name: 'Causal Graph',
+                        description: 'Directed acyclic graph of causal degradation relationships',
+                    },
+                    {
+                        uri: 'perfgraph://artifacts/<run-dir>/ir.json',
+                        name: 'Intermediate Representation',
+                        description: 'Normalized IRBundle with all collected performance data',
+                    },
+                ],
+            };
+        },
+    }), {
+        title: 'PerfGraph Artifact',
+        description: 'Access PerfGraph collected data and generated reports by run directory and filename. ' +
+            'The {path} segment is the filesystem path with separators replaced by underscores. ' +
+            'For example, path "C:_Users_project_perfgraph-output_example" maps to ' +
+            '"C:/Users/project/perfgraph-output/example". Use file paths returned by perfgraph_run.',
+        mimeType: 'application/json',
+    }, async (uri, { path: encodedPath, filename }) => {
+        const pathPart = Array.isArray(encodedPath) ? encodedPath.join('_') : (encodedPath ?? '');
+        const filePart = Array.isArray(filename) ? filename.join('_') : (filename ?? '');
+        const fullUri = `perfgraph://artifacts/${pathPart}/${filePart}`;
+        const content = readResource(fullUri);
+        return {
+            contents: [
+                {
+                    uri: fullUri,
+                    text: content.text,
+                    mimeType: content.mimeType,
+                },
+            ],
+        };
+    });
+    // Register a convenience resource for listing all artifacts in a run dir
+    server.registerResource('perfgraph-artifact-list', new ResourceTemplate('perfgraph://artifacts/{path}', {
+        list: async () => ({
+            resources: [
+                {
+                    uri: 'perfgraph://artifacts/<run-dir>',
+                    name: 'Run Directory Contents',
+                    description: 'Lists all available PerfGraph artifacts in a run directory',
+                },
+            ],
+        }),
+    }), {
+        title: 'PerfGraph Run Directory',
+        description: 'List all available artifacts in a PerfGraph run directory',
+        mimeType: 'application/json',
+    }, async (uri, { path: encodedPath }) => {
+        const pathPart = Array.isArray(encodedPath) ? encodedPath.join('/') : (encodedPath ?? '');
+        const fullUri = `perfgraph://artifacts/${pathPart}`;
+        const artifacts = listArtifacts(fullUri);
+        if (artifacts.length === 0) {
+            return {
+                contents: [
+                    {
+                        uri: fullUri,
+                        text: JSON.stringify({
+                            error: 'No artifacts found',
+                            path: pathPart.split('_').join('/'),
+                        }, null, 2),
+                        mimeType: 'application/json',
+                    },
+                ],
+            };
+        }
+        const listing = artifacts.map((a) => ({
+            uri: a.uri,
+            name: a.uri.split('/').pop(),
+            mimeType: a.mimeType,
+        }));
+        return {
+            contents: [
+                {
+                    uri: fullUri,
+                    text: JSON.stringify({ artifacts: listing, count: listing.length }, null, 2),
+                    mimeType: 'application/json',
+                },
+            ],
+        };
+    });
+    // -----------------------------------------------------------------------
+    // TOON resource
+    // -----------------------------------------------------------------------
+    server.registerResource('perfgraph-toon', new ResourceTemplate('webtr://runs/{runRef}/toon', {
+        list: async () => {
+            return {
+                resources: [
+                    {
+                        uri: 'webtr://runs/<encoded-runDir>/toon',
+                        name: 'Run Results (TOON)',
+                        description: 'Token-efficient TOON-encoded run results (report, features, causal graph)',
+                    },
+                ],
+            };
+        },
+    }), {
+        title: 'PerfGraph TOON Output',
+        description: 'Token-optimised TOON encoding of a PerfGraph run\'s report, features, and causal graph. ' +
+            'The {runRef} segment is the run directory path with path separators replaced by underscores, ' +
+            'matching the encoding used in perfgraph://artifacts/ URIs.',
+        mimeType: 'text/plain',
+    }, async (uri, { runRef }) => {
+        const ref = Array.isArray(runRef) ? runRef.join('_') : (runRef ?? '');
+        const fullUri = `webtr://runs/${ref}/toon`;
+        const content = toonResource(fullUri);
+        return {
+            contents: [
+                {
+                    uri: fullUri,
+                    text: content.text,
+                    mimeType: content.mimeType,
+                },
+            ],
+        };
+    });
+    // -----------------------------------------------------------------------
+    // Prompts
+    // -----------------------------------------------------------------------
+    server.registerPrompt('perfgraph_analyze_lcp', {
+        title: 'LCP Performance Analysis',
+        description: `Run a focused diagnostic analysis of Largest Contentful Paint (LCP) performance for a URL. Analyzes LCP breakdown (TTFB, resource delay, render delay, element render time), render-blocking resources, and causal chains. Provides prioritized remediation steps.`,
+        argsSchema: LcpAnalysisArgsSchema.shape,
+    }, (args) => buildLcpAnalysisPrompt(args));
+    server.registerPrompt('perfgraph_audit', {
+        title: 'Full Site Performance Audit',
+        description: `Run a comprehensive performance audit covering all diagnostic dimensions: LCP, JavaScript, Network, Layout, and Third-party. Optionally focus on a specific category. Produces a structured report with all issues, causal chains, and prioritized recommendations.`,
+        argsSchema: AuditArgsSchema.shape,
+    }, (args) => buildAuditPrompt(args));
+    server.registerPrompt('perfgraph_summarize_report', {
+        title: 'Summarize Performance Report',
+        description: `Read an existing PerfGraph report (by resource URI) and produce a natural-language summary. Supports brief, normal, and detailed verbosity levels. Use this when you already have a report and want a human-readable overview.`,
+        argsSchema: SummarizeArgsSchema.shape,
+    }, (args) => buildSummarizePrompt(args));
+    // -----------------------------------------------------------------------
+    // Transport
+    // -----------------------------------------------------------------------
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * MCP-specific types and Zod schemas.
+ *
+ * Shared input schemas for MCP tool handlers and result types.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/** Schema for the primary shortcut tool — full pipeline URL→report */
+export declare const RunArgsSchema: z.ZodObject<{
+    url: z.ZodString;
+    outputDir: z.ZodOptional<z.ZodString>;
+    runs: z.ZodOptional<z.ZodNumber>;
+    mobile: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Schema for the collect tool (advanced) */
+export declare const CollectArgsSchema: z.ZodObject<{
+    url: z.ZodString;
+    outputDir: z.ZodOptional<z.ZodString>;
+    runs: z.ZodOptional<z.ZodNumber>;
+    noLighthouse: z.ZodOptional<z.ZodBoolean>;
+    noCoverage: z.ZodOptional<z.ZodBoolean>;
+    noConsole: z.ZodOptional<z.ZodBoolean>;
+    noDom: z.ZodOptional<z.ZodBoolean>;
+    mobile: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Schema for the normalize tool (advanced) */
+export declare const NormalizeArgsSchema: z.ZodObject<{
+    runDir: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the extract tool (advanced) */
+export declare const ExtractArgsSchema: z.ZodObject<{
+    irFile: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the analyze tool (advanced) */
+export declare const AnalyzeArgsSchema: z.ZodObject<{
+    featuresFile: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the report tool (advanced) */
+export declare const ReportArgsSchema: z.ZodObject<{
+    featuresFile: z.ZodString;
+}, z.core.$strip>;
+/** Schema for the toon tool — encodes run results in TOON format */
+export declare const ToonArgsSchema: z.ZodObject<{
+    runDir: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,sEAAsE;AACtE,eAAO,MAAM,aAAa;;;;;iBASxB,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB;;;;;;;;;iBAiB5B,CAAC;AAEH,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB;;iBAG9B,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB;;iBAG5B,CAAC;AAEH,6CAA6C;AAC7C,eAAO,MAAM,iBAAiB;;iBAG5B,CAAC;AAEH,4CAA4C;AAC5C,eAAO,MAAM,gBAAgB;;iBAG3B,CAAC;AAEH,oEAAoE;AACpE,eAAO,MAAM,cAAc;;iBAGzB,CAAC"}

package/dist/mcp/types.js

@@ -0,0 +1,67 @@
+/**
+ * MCP-specific types and Zod schemas.
+ *
+ * Shared input schemas for MCP tool handlers and result types.
+ *
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Tool input schemas
+// ---------------------------------------------------------------------------
+/** Schema for the primary shortcut tool — full pipeline URL→report */
+export const RunArgsSchema = z.object({
+    /** Target URL to analyze (required) */
+    url: z.string().min(1, 'url is required'),
+    /** Base output directory (default: ./perfgraph-output) */
+    outputDir: z.string().optional(),
+    /** Number of collection runs (default: 1) */
+    runs: z.number().int().min(1).max(10).optional(),
+    /** Device name for emulation (e.g. "iPhone 13", "Pixel 7"). Empty/omitted = desktop */
+    mobile: z.string().optional(),
+});
+/** Schema for the collect tool (advanced) */
+export const CollectArgsSchema = z.object({
+    /** Target URL to collect data from (required) */
+    url: z.string().min(1, 'url is required'),
+    /** Base output directory (default: ./perfgraph-output) */
+    outputDir: z.string().optional(),
+    /** Number of collection runs (default: 1) */
+    runs: z.number().int().min(1).max(10).optional(),
+    /** Skip Lighthouse audit */
+    noLighthouse: z.boolean().optional(),
+    /** Skip JS/CSS coverage */
+    noCoverage: z.boolean().optional(),
+    /** Skip console log capture */
+    noConsole: z.boolean().optional(),
+    /** Skip DOM snapshot */
+    noDom: z.boolean().optional(),
+    /** Device name for emulation (e.g. "iPhone 13", "Pixel 7"). Empty/omitted = desktop */
+    mobile: z.string().optional(),
+});
+/** Schema for the normalize tool (advanced) */
+export const NormalizeArgsSchema = z.object({
+    /** Path to the run directory containing collected data */
+    runDir: z.string().min(1, 'runDir is required'),
+});
+/** Schema for the extract tool (advanced) */
+export const ExtractArgsSchema = z.object({
+    /** Path to a normalized IR JSON file */
+    irFile: z.string().min(1, 'irFile is required'),
+});
+/** Schema for the analyze tool (advanced) */
+export const AnalyzeArgsSchema = z.object({
+    /** Path to a FeatureSet JSON file */
+    featuresFile: z.string().min(1, 'featuresFile is required'),
+});
+/** Schema for the report tool (advanced) */
+export const ReportArgsSchema = z.object({
+    /** Path to a FeatureSet JSON file */
+    featuresFile: z.string().min(1, 'featuresFile is required'),
+});
+/** Schema for the toon tool — encodes run results in TOON format */
+export const ToonArgsSchema = z.object({
+    /** Path to the run directory containing perfgraph output files */
+    runDir: z.string().min(1, 'runDir is required'),
+});
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

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

package/dist/normalize/clock.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Clock domain normalization utilities.
+ *
+ * Raw data from different CDP domains arrives on different clock domains.
+ * This module converts all timestamps to a common epoch: milliseconds
+ * relative to the navigation start (navigationStart).
+ *
+ * Supported clock domains:
+ *   - cdp-monotonic-us  : Chromium Tracing microsecond monotonic clock
+ *   - cdp-monotonic-ms  : CDP millisecond monotonic clock
+ *   - epoch-ms          : Standard Unix epoch in milliseconds
+ *   - epoch-s           : Standard Unix epoch in seconds
+ *   - network-monotonic-s : Network domain monotonic seconds (with wall-time offset)
+ *   - lighthouse-ms     : Lighthouse-reported relative milliseconds
+ */
+import type { RawDataBundle } from '../collect/types.js';
+/** The clock domain a raw timestamp originated from */
+export type ClockDomain = 'cdp-monotonic-us' | 'cdp-monotonic-ms' | 'epoch-ms' | 'epoch-s' | 'network-monotonic-s' | 'lighthouse-ms';
+/** Anchors used to convert each clock domain to relative ms */
+export interface ClockAnchor {
+    /** navigationStart timestamp in ms epoch (from Performance.getMetrics or trace) */
+    navigationStart: number;
+    /** Wall time of the first network request (seconds since epoch), used for network clock sync */
+    firstRequestWallTime?: number;
+}
+/**
+ * Convert a raw timestamp to milliseconds relative to navigationStart.
+ *
+ * NaN / Infinity guard: if the result is not a finite number, return 0.
+ */
+export declare function toRelativeMs(raw: number, domain: ClockDomain, anchor: ClockAnchor): number;
+/**
+ * Resolve a ClockAnchor from a RawDataBundle.
+ *
+ * navigationStart is extracted from the performance metrics (Timestamp metric)
+ * or falls back to 0. firstRequestWallTime is taken from the first network
+ * request's wallTime field if available.
+ */
+export declare function resolveClockAnchor(raw: RawDataBundle): ClockAnchor;
+//# sourceMappingURL=clock.d.ts.map

package/dist/normalize/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/normalize/clock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,uDAAuD;AACvD,MAAM,MAAM,WAAW,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,UAAU,GACV,SAAS,GACT,qBAAqB,GACrB,eAAe,CAAC;AAEpB,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,GAClB,MAAM,CAoDR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,WAAW,CA8BlE"}