@perfbase/mcp 1.0.0

package/README.md

@@ -0,0 +1,76 @@
+# @perfbase/mcp
+
+Model Context Protocol (MCP) server for analyzing PerfBase PHP profiler data.
+
+## Installation
+
+```bash
+claude mcp add perfbase -- npx -y @perfbase/mcp
+```
+
+That's it! Restart Claude Code and you can analyze profiles:
+
+```
+Analyze the profile at /path/to/profile.bin
+```
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_slowest_functions` | Functions sorted by total wall time |
+| `get_most_called_functions` | Functions sorted by call count |
+| `get_cpu_intensive_functions` | Functions sorted by CPU time |
+| `get_memory_hogs` | Functions sorted by memory allocation |
+| `get_database_queries` | Extract and analyze database operations |
+| `detect_n_plus_one` | Find N+1 query patterns |
+| `get_profile_summary` | Overall profile statistics |
+
+## Profile Data Format
+
+The MCP server expects PerfBase profile files which are:
+1. MessagePack encoded
+2. Brotli compressed
+3. Base64 encoded
+
+This is the format produced by `perfbase_get_data()`.
+
+## Development
+
+```bash
+# Clone and install
+git clone <repo>
+cd mcp
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run tests
+npm test
+```
+
+### Local Testing
+
+To test locally before publishing:
+
+```bash
+claude mcp add perfbase -- node /path/to/extension/mcp/dist/index.js
+```
+
+### Generate a Test Profile
+
+```php
+<?php
+perfbase_enable('test', PERFBASE_FLAG_ALL);
+// ... your code ...
+perfbase_disable('test');
+file_put_contents('profile.bin', perfbase_get_data());
+```
+
+## License
+
+MIT

package/dist/decoder/decompress.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Decompression and decoding utilities for PerfBase profile data.
+ * Handles base64 decoding, Brotli decompression, and MessagePack unpacking.
+ */
+import { ProfilingData } from './types.js';
+/**
+ * Load and decode a PerfBase profile from a file path
+ * @param filePath Path to the profile file (base64-encoded, Brotli-compressed, MessagePack)
+ */
+export declare function loadProfile(filePath: string): Promise<ProfilingData>;
+/**
+ * Decode a PerfBase profile from base64 string
+ * @param base64Data Base64-encoded, Brotli-compressed, MessagePack data
+ */
+export declare function decodeProfile(base64Data: string): Promise<ProfilingData>;
+/**
+ * Encode a ProfilingData object to base64 (for testing)
+ * @param data ProfilingData to encode
+ */
+export declare function encodeProfile(data: ProfilingData): Promise<string>;
+/**
+ * Validate that the data has the expected structure
+ */
+export declare function validateProfilingData(data: unknown): data is ProfilingData;
+//# sourceMappingURL=decompress.d.ts.map

package/dist/decoder/decompress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompress.d.ts","sourceRoot":"","sources":["../../src/decoder/decompress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA0B3C;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAI1E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAW9E;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CASxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAa1E"}

package/dist/decoder/decompress.js

@@ -0,0 +1,79 @@
+/**
+ * Decompression and decoding utilities for PerfBase profile data.
+ * Handles base64 decoding, Brotli decompression, and MessagePack unpacking.
+ */
+import { promisify } from 'node:util';
+import { brotliDecompress, brotliCompress } from 'node:zlib';
+import { decode as msgpackDecode, encode as msgpackEncode } from '@msgpack/msgpack';
+const brotliDecompressAsync = promisify(brotliDecompress);
+const brotliCompressAsync = promisify(brotliCompress);
+/**
+ * Decode base64 string to Buffer
+ */
+function base64Decode(base64) {
+    return Buffer.from(base64, 'base64');
+}
+/**
+ * Decompress Brotli-compressed data
+ */
+async function decompressBrotli(compressed) {
+    return brotliDecompressAsync(compressed);
+}
+/**
+ * Decode MessagePack data to ProfilingData
+ */
+function decodeMessagePack(data) {
+    return msgpackDecode(data);
+}
+/**
+ * Load and decode a PerfBase profile from a file path
+ * @param filePath Path to the profile file (base64-encoded, Brotli-compressed, MessagePack)
+ */
+export async function loadProfile(filePath) {
+    const fs = await import('node:fs/promises');
+    const content = await fs.readFile(filePath, 'utf-8');
+    return decodeProfile(content.trim());
+}
+/**
+ * Decode a PerfBase profile from base64 string
+ * @param base64Data Base64-encoded, Brotli-compressed, MessagePack data
+ */
+export async function decodeProfile(base64Data) {
+    // Step 1: Base64 decode
+    const compressed = base64Decode(base64Data);
+    // Step 2: Brotli decompress
+    const decompressed = await decompressBrotli(compressed);
+    // Step 3: MessagePack decode
+    const data = decodeMessagePack(decompressed);
+    return data;
+}
+/**
+ * Encode a ProfilingData object to base64 (for testing)
+ * @param data ProfilingData to encode
+ */
+export async function encodeProfile(data) {
+    // Step 1: MessagePack encode
+    const msgpacked = Buffer.from(msgpackEncode(data));
+    // Step 2: Brotli compress
+    const compressed = await brotliCompressAsync(msgpacked);
+    // Step 3: Base64 encode
+    return compressed.toString('base64');
+}
+/**
+ * Validate that the data has the expected structure
+ */
+export function validateProfilingData(data) {
+    if (typeof data !== 'object' || data === null) {
+        return false;
+    }
+    const obj = data;
+    // Required fields
+    if (!Array.isArray(obj.g))
+        return false; // glossary
+    if (!Array.isArray(obj.f))
+        return false; // files
+    if (typeof obj.t !== 'object' || obj.t === null)
+        return false; // trie
+    return true;
+}
+//# sourceMappingURL=decompress.js.map

package/dist/decoder/decompress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompress.js","sourceRoot":"","sources":["../../src/decoder/decompress.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGpF,MAAM,qBAAqB,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAC1D,MAAM,mBAAmB,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,UAAkB;IAChD,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,aAAa,CAAC,IAAI,CAAkB,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,wBAAwB;IACxB,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAE5C,4BAA4B;IAC5B,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAExD,6BAA6B;IAC7B,MAAM,IAAI,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAE7C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAmB;IACrD,6BAA6B;IAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAEnD,0BAA0B;IAC1B,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAExD,wBAAwB;IACxB,OAAO,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,IAA+B,CAAC;IAE5C,kBAAkB;IAClB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,CAAE,WAAW;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,CAAE,QAAQ;IAClD,IAAI,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,CAAE,OAAO;IAEvE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/decoder/trie-walker.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Trie traversal utilities for reconstructing function call paths
+ * from the compressed trie structure.
+ */
+import { ProfilingData, FunctionInfo } from './types.js';
+/**
+ * Walk the trie and collect all function info with reconstructed paths
+ */
+export declare function walkTrie(data: ProfilingData, spanName?: string): FunctionInfo[];
+/**
+ * Get all unique function names from the glossary
+ */
+export declare function getAllFunctionNames(data: ProfilingData): string[];
+/**
+ * Get all span names from the profile
+ */
+export declare function getSpanNames(data: ProfilingData): string[];
+/**
+ * Count total number of function entries in the trie
+ */
+export declare function countFunctions(data: ProfilingData): number;
+/**
+ * Filter functions by name pattern (case-insensitive)
+ */
+export declare function filterByName(functions: FunctionInfo[], pattern: string): FunctionInfo[];
+/**
+ * Filter functions that look like database queries
+ */
+export declare function filterDatabaseFunctions(functions: FunctionInfo[]): FunctionInfo[];
+/**
+ * Sort functions by a numeric field in descending order
+ */
+export declare function sortByField<K extends keyof FunctionInfo>(functions: FunctionInfo[], field: K, limit?: number): FunctionInfo[];
+//# sourceMappingURL=trie-walker.d.ts.map

package/dist/decoder/trie-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trie-walker.d.ts","sourceRoot":"","sources":["../../src/decoder/trie-walker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EAGb,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,aAAa,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,EAAE,CAmBhB;AA4ED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAqB1D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,YAAY,EAAE,EACzB,OAAO,EAAE,MAAM,GACd,YAAY,EAAE,CAOhB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAoBjF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,YAAY,EACtD,SAAS,EAAE,YAAY,EAAE,EACzB,KAAK,EAAE,CAAC,EACR,KAAK,CAAC,EAAE,MAAM,GACb,YAAY,EAAE,CAWhB"}

package/dist/decoder/trie-walker.js

@@ -0,0 +1,159 @@
+/**
+ * Trie traversal utilities for reconstructing function call paths
+ * from the compressed trie structure.
+ */
+/**
+ * Walk the trie and collect all function info with reconstructed paths
+ */
+export function walkTrie(data, spanName) {
+    const results = [];
+    const glossary = data.g;
+    const files = data.f;
+    // Get spans to process
+    const spansToProcess = spanName
+        ? { [spanName]: data.t[spanName] }
+        : data.t;
+    for (const [span, roots] of Object.entries(spansToProcess)) {
+        if (!roots)
+            continue;
+        for (const root of roots) {
+            walkNode(root, [], glossary, files, results);
+        }
+    }
+    return results;
+}
+/**
+ * Recursively walk a trie node and collect function info
+ */
+function walkNode(node, pathIndices, glossary, files, results) {
+    const keys = node.k;
+    const children = node.h;
+    const value = node.v;
+    // Process each key at this level
+    for (let i = 0; i < keys.length; i++) {
+        const glossaryIdx = keys[i];
+        const currentPath = [...pathIndices, glossaryIdx];
+        // If there's a child node at this index, recurse
+        if (children && children[i]) {
+            walkNode(children[i], currentPath, glossary, files, results);
+        }
+    }
+    // If this node has function data, add it to results
+    if (value) {
+        const entry = glossary[value.g];
+        if (entry) {
+            const info = buildFunctionInfo(value, entry, pathIndices, glossary, files);
+            results.push(info);
+        }
+    }
+}
+/**
+ * Build a FunctionInfo from FunctionData and path
+ */
+function buildFunctionInfo(data, entry, pathIndices, glossary, files) {
+    // Reconstruct call path from indices
+    const pathNames = pathIndices.map((idx) => glossary[idx]?.n ?? `<unknown:${idx}>`);
+    const callPath = pathNames.length > 0
+        ? `${pathNames.join(' > ')} > ${entry.n}`
+        : entry.n;
+    // Get file path if available
+    const file = entry.f !== undefined ? files[entry.f] : undefined;
+    return {
+        callPath,
+        name: entry.n,
+        file,
+        line: entry.l,
+        callCount: data.c,
+        totalWallTime: data.w,
+        avgWallTime: data.c > 0 ? data.w / data.c : 0,
+        minWallTime: data.wn,
+        maxWallTime: data.wx,
+        totalCpuTime: data.u,
+        avgCpuTime: data.c > 0 ? data.u / data.c : 0,
+        minCpuTime: data.un,
+        maxCpuTime: data.ux,
+        memoryAllocated: data.mt,
+        memoryPeak: data.mp,
+        memoryNet: data.m,
+    };
+}
+/**
+ * Get all unique function names from the glossary
+ */
+export function getAllFunctionNames(data) {
+    return data.g.map((entry) => entry.n);
+}
+/**
+ * Get all span names from the profile
+ */
+export function getSpanNames(data) {
+    return Object.keys(data.t);
+}
+/**
+ * Count total number of function entries in the trie
+ */
+export function countFunctions(data) {
+    let count = 0;
+    function countNode(node) {
+        if (node.v)
+            count++;
+        if (node.h) {
+            for (const child of node.h) {
+                if (child)
+                    countNode(child);
+            }
+        }
+    }
+    for (const roots of Object.values(data.t)) {
+        if (roots) {
+            for (const root of roots) {
+                countNode(root);
+            }
+        }
+    }
+    return count;
+}
+/**
+ * Filter functions by name pattern (case-insensitive)
+ */
+export function filterByName(functions, pattern) {
+    const lowerPattern = pattern.toLowerCase();
+    return functions.filter((f) => f.name.toLowerCase().includes(lowerPattern) ||
+        f.callPath.toLowerCase().includes(lowerPattern));
+}
+/**
+ * Filter functions that look like database queries
+ */
+export function filterDatabaseFunctions(functions) {
+    const dbPatterns = [
+        /^pdo/i,
+        /^mysqli/i,
+        /^pg_/i,
+        /^mongo/i,
+        /^redis/i,
+        /^memcache/i,
+        /query/i,
+        /execute/i,
+        /prepare/i,
+        /fetch/i,
+        /->query\(/i,
+        /->execute\(/i,
+        /->prepare\(/i,
+    ];
+    return functions.filter((f) => dbPatterns.some((pattern) => pattern.test(f.name) || pattern.test(f.callPath)));
+}
+/**
+ * Sort functions by a numeric field in descending order
+ */
+export function sortByField(functions, field, limit) {
+    const sorted = [...functions].sort((a, b) => {
+        const aVal = a[field];
+        const bVal = b[field];
+        if (typeof aVal === 'number' && typeof bVal === 'number') {
+            return bVal - aVal;
+        }
+        return 0;
+    });
+    return limit ? sorted.slice(0, limit) : sorted;
+}
+//# sourceMappingURL=trie-walker.js.map

package/dist/decoder/trie-walker.js.map

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

package/dist/decoder/types.d.ts

@@ -0,0 +1,188 @@
+/**
+ * TypeScript interfaces matching the PerfBase Rust serialization structs.
+ * Field names use short keys to minimize serialized size.
+ */
+/**
+ * Glossary entry for function names
+ * Matches Rust: GlossaryEntry { name, file_idx, line }
+ */
+export interface GlossaryEntry {
+    /** Function name */
+    n: string;
+    /** File index into files array (optional) */
+    f?: number;
+    /** Line number (optional) */
+    l?: number;
+}
+/**
+ * Function timing and memory data
+ * Matches Rust: FunctionData
+ * All times are in microseconds
+ */
+export interface FunctionData {
+    /** Call count */
+    c: number;
+    /** Total wall time (microseconds) */
+    w: number;
+    /** Min wall time (microseconds) */
+    wn: number;
+    /** Max wall time (microseconds) */
+    wx: number;
+    /** Total CPU time (microseconds) */
+    u: number;
+    /** Min CPU time (microseconds) */
+    un: number;
+    /** Max CPU time (microseconds) */
+    ux: number;
+    /** Memory total allocated */
+    mt: number;
+    /** Memory total current (at end of call) */
+    mc: number;
+    /** Memory min */
+    mn: number;
+    /** Memory peak */
+    mp: number;
+    /** Memory freed */
+    mf: number;
+    /** Memory net change */
+    m: number;
+    /** Glossary index for function name */
+    g: number;
+}
+/**
+ * Trie node representing a call stack path
+ * Matches Rust: TrieNode
+ */
+export interface TrieNode {
+    /** Keys (glossary indices) for child paths */
+    k: number[];
+    /** Children trie nodes (optional, same length as k) */
+    h?: TrieNode[];
+    /** Function data for this node (optional, leaf data) */
+    v?: FunctionData;
+}
+/**
+ * System statistics captured during profiling
+ * Matches Rust: SystemStats
+ */
+export interface SystemStats {
+    /** Peak memory usage in bytes */
+    peak_memory?: number;
+    /** CPU usage percentage */
+    cpu_percent?: number;
+    /** Load average (1 minute) */
+    load_avg_1m?: number;
+    /** Total execution time (microseconds) */
+    total_time_us?: number;
+}
+/**
+ * Histogram bucket for timing distribution
+ */
+export interface HistogramBucket {
+    /** Lower bound (microseconds) */
+    min: number;
+    /** Upper bound (microseconds) */
+    max: number;
+    /** Count of samples in this bucket */
+    count: number;
+}
+/**
+ * Top-level profiling data structure
+ * Matches Rust: ProfilingData (serialized form)
+ */
+export interface ProfilingData {
+    /** Glossary of function names */
+    g: GlossaryEntry[];
+    /** File paths array */
+    f: string[];
+    /** Trie structure keyed by span name */
+    t: Record<string, TrieNode[]>;
+    /** System statistics (optional) */
+    s?: SystemStats;
+    /** Timing histogram (optional) */
+    h?: HistogramBucket[];
+    /** Custom attributes */
+    a?: Record<string, string>;
+}
+/**
+ * Reconstructed function info with full path
+ * Used after trie traversal
+ */
+export interface FunctionInfo {
+    /** Full call path (e.g., "main > process > query") */
+    callPath: string;
+    /** Function name only */
+    name: string;
+    /** File path (if available) */
+    file?: string;
+    /** Line number (if available) */
+    line?: number;
+    /** Call count */
+    callCount: number;
+    /** Total wall time (microseconds) */
+    totalWallTime: number;
+    /** Average wall time (microseconds) */
+    avgWallTime: number;
+    /** Min wall time (microseconds) */
+    minWallTime: number;
+    /** Max wall time (microseconds) */
+    maxWallTime: number;
+    /** Total CPU time (microseconds) */
+    totalCpuTime: number;
+    /** Average CPU time (microseconds) */
+    avgCpuTime: number;
+    /** Min CPU time (microseconds) */
+    minCpuTime: number;
+    /** Max CPU time (microseconds) */
+    maxCpuTime: number;
+    /** Total memory allocated */
+    memoryAllocated: number;
+    /** Peak memory usage */
+    memoryPeak: number;
+    /** Net memory change */
+    memoryNet: number;
+}
+/**
+ * Profile metadata for resources
+ */
+export interface ProfileMetadata {
+    /** Span names in the profile */
+    spans: string[];
+    /** System statistics */
+    systemStats?: SystemStats;
+    /** Custom attributes */
+    attributes?: Record<string, string>;
+    /** Total function count */
+    functionCount: number;
+    /** File paths referenced */
+    files: string[];
+}
+/**
+ * N+1 query detection result
+ */
+export interface NPlusOnePattern {
+    /** The repeated query pattern */
+    queryPattern: string;
+    /** Number of similar queries */
+    count: number;
+    /** Total time spent (microseconds) */
+    totalTime: number;
+    /** Call paths where this pattern occurs */
+    callPaths: string[];
+}
+/**
+ * Database query info extracted from profile
+ */
+export interface DatabaseQuery {
+    /** Query or operation name */
+    query: string;
+    /** Call count */
+    callCount: number;
+    /** Total time (microseconds) */
+    totalTime: number;
+    /** Average time (microseconds) */
+    avgTime: number;
+    /** Call path where query occurs */
+    callPath: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/decoder/types.js

@@ -0,0 +1,6 @@
+/**
+ * TypeScript interfaces matching the PerfBase Rust serialization structs.
+ * Field names use short keys to minimize serialized size.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/decoder/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/decoder/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * PerfBase MCP Server
+ *
+ * Provides tools for analyzing PerfBase profiler data through the
+ * Model Context Protocol (MCP).
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}