@perfbase/mcp 1.0.0

package/dist/tools/database-queries.js

@@ -0,0 +1,133 @@
+/**
+ * Tool: get_database_queries
+ * Extracts and analyzes database operations from the profile
+ */
+import { z } from 'zod';
+import { loadProfile } from '../decoder/decompress.js';
+import { walkTrie, sortByField } from '../decoder/trie-walker.js';
+import { formatTime, formatNumber } from '../utils/formatting.js';
+export const databaseQueriesSchema = z.object({
+    filePath: z.string().describe('Path to the PerfBase profile file'),
+    span: z.string().optional().describe('Filter to a specific span name'),
+    limit: z.number().int().positive().default(50).describe('Maximum number of results'),
+});
+// Patterns to identify database functions
+const DB_PATTERNS = [
+    // PDO
+    /^PDO::query$/i,
+    /^PDO::exec$/i,
+    /^PDO::prepare$/i,
+    /^PDOStatement::execute$/i,
+    /^PDOStatement::fetch/i,
+    // mysqli
+    /^mysqli::query$/i,
+    /^mysqli::prepare$/i,
+    /^mysqli_query$/i,
+    /^mysqli_stmt::execute$/i,
+    // PostgreSQL
+    /^pg_query/i,
+    /^pg_execute/i,
+    /^pg_prepare/i,
+    // MongoDB
+    /^MongoDB\\/i,
+    // Redis
+    /^Redis::/i,
+    /^Predis\\/i,
+    // Memcached
+    /^Memcached::/i,
+    /^Memcache::/i,
+    // Elasticsearch
+    /^Elasticsearch\\/i,
+    // Generic patterns
+    /->query\(/,
+    /->execute\(/,
+    /->find\(/,
+    /->findOne\(/,
+    /->insert\(/,
+    /->update\(/,
+    /->delete\(/,
+    /->select\(/,
+];
+function isDatabaseFunction(name) {
+    return DB_PATTERNS.some((pattern) => pattern.test(name));
+}
+export async function getDatabaseQueries(input) {
+    const data = await loadProfile(input.filePath);
+    const allFunctions = walkTrie(data, input.span);
+    // Filter to database functions
+    const dbFunctions = allFunctions.filter((f) => isDatabaseFunction(f.name));
+    // Calculate totals
+    const totalTime = dbFunctions.reduce((sum, f) => sum + f.totalWallTime, 0);
+    const totalCalls = dbFunctions.reduce((sum, f) => sum + f.callCount, 0);
+    // Group by type
+    const byType = {};
+    for (const f of dbFunctions) {
+        const type = categorizeDbFunction(f.name);
+        if (!byType[type]) {
+            byType[type] = { count: 0, totalTime: 0 };
+        }
+        byType[type].count += f.callCount;
+        byType[type].totalTime += f.totalWallTime;
+    }
+    // Sort by total time
+    const sorted = sortByField(dbFunctions, 'totalWallTime', input.limit);
+    return {
+        queries: sorted.map((f) => ({
+            query: f.name,
+            callCount: f.callCount,
+            totalTime: f.totalWallTime,
+            avgTime: f.avgWallTime,
+            callPath: f.callPath,
+        })),
+        totalQueries: totalCalls,
+        totalTime: formatTime(totalTime),
+        avgTimePerQuery: totalCalls > 0 ? formatTime(totalTime / totalCalls) : '0µs',
+        byType: Object.fromEntries(Object.entries(byType).map(([type, data]) => [
+            type,
+            { count: data.count, totalTime: formatTime(data.totalTime) },
+        ])),
+    };
+}
+function categorizeDbFunction(name) {
+    if (/pdo/i.test(name))
+        return 'PDO';
+    if (/mysqli/i.test(name))
+        return 'MySQLi';
+    if (/pg_/i.test(name))
+        return 'PostgreSQL';
+    if (/mongodb/i.test(name))
+        return 'MongoDB';
+    if (/redis/i.test(name) || /predis/i.test(name))
+        return 'Redis';
+    if (/memcache/i.test(name))
+        return 'Memcached';
+    if (/elasticsearch/i.test(name))
+        return 'Elasticsearch';
+    return 'Other';
+}
+export function formatDatabaseQueriesOutput(result) {
+    const lines = [
+        `# Database Queries Analysis`,
+        ``,
+        `**Total Queries**: ${formatNumber(result.totalQueries)}`,
+        `**Total Time**: ${result.totalTime}`,
+        `**Avg Time/Query**: ${result.avgTimePerQuery}`,
+        ``,
+        `## By Database Type`,
+        ``,
+    ];
+    for (const [type, data] of Object.entries(result.byType)) {
+        lines.push(`- **${type}**: ${formatNumber(data.count)} queries, ${data.totalTime}`);
+    }
+    lines.push(``, `## Slowest Queries`, ``);
+    for (const q of result.queries.slice(0, 20)) {
+        lines.push(`### ${q.query}`);
+        lines.push(`- **Calls**: ${formatNumber(q.callCount)}`);
+        lines.push(`- **Total Time**: ${formatTime(q.totalTime)}`);
+        lines.push(`- **Avg Time**: ${formatTime(q.avgTime)}`);
+        lines.push(`- **Path**: ${q.callPath}`);
+        lines.push(``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=database-queries.js.map

package/dist/tools/database-queries.js.map

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

package/dist/tools/memory-hogs.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Tool: get_memory_hogs
+ * Returns functions sorted by memory allocation
+ */
+import { z } from 'zod';
+export declare const memoryHogsSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    span: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    limit: number;
+    span?: string | undefined;
+}, {
+    filePath: string;
+    span?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type MemoryHogsInput = z.infer<typeof memoryHogsSchema>;
+export interface MemoryHogsResult {
+    functions: Array<{
+        rank: number;
+        name: string;
+        callPath: string;
+        location?: string;
+        callCount: number;
+        memoryAllocated: string;
+        memoryPeak: string;
+        memoryNet: string;
+        avgMemoryPerCall: string;
+        percentOfTotal: string;
+    }>;
+    totalMemoryAllocated: string;
+    totalFunctions: number;
+}
+export declare function getMemoryHogs(input: MemoryHogsInput): Promise<MemoryHogsResult>;
+export declare function formatMemoryHogsOutput(result: MemoryHogsResult): string;
+//# sourceMappingURL=memory-hogs.d.ts.map

package/dist/tools/memory-hogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-hogs.d.ts","sourceRoot":"","sources":["../../src/tools/memory-hogs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAgC3B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAwBvE"}

package/dist/tools/memory-hogs.js

@@ -0,0 +1,65 @@
+/**
+ * Tool: get_memory_hogs
+ * Returns functions sorted by memory allocation
+ */
+import { z } from 'zod';
+import { loadProfile } from '../decoder/decompress.js';
+import { walkTrie, sortByField } from '../decoder/trie-walker.js';
+import { formatBytes, formatNumber, formatLocation } from '../utils/formatting.js';
+export const memoryHogsSchema = z.object({
+    filePath: z.string().describe('Path to the PerfBase profile file'),
+    span: z.string().optional().describe('Filter to a specific span name'),
+    limit: z.number().int().positive().default(20).describe('Maximum number of results'),
+});
+export async function getMemoryHogs(input) {
+    const data = await loadProfile(input.filePath);
+    const allFunctions = walkTrie(data, input.span);
+    // Calculate total memory allocated
+    const totalMemory = allFunctions.reduce((sum, f) => sum + f.memoryAllocated, 0);
+    // Sort by memory allocated
+    const sorted = sortByField(allFunctions, 'memoryAllocated', input.limit);
+    return {
+        functions: sorted.map((f, i) => ({
+            rank: i + 1,
+            name: f.name,
+            callPath: f.callPath,
+            location: f.file ? formatLocation(f.file, f.line) : undefined,
+            callCount: f.callCount,
+            memoryAllocated: formatBytes(f.memoryAllocated),
+            memoryPeak: formatBytes(f.memoryPeak),
+            memoryNet: formatBytes(f.memoryNet),
+            avgMemoryPerCall: f.callCount > 0
+                ? formatBytes(f.memoryAllocated / f.callCount)
+                : '0B',
+            percentOfTotal: totalMemory > 0
+                ? `${((f.memoryAllocated / totalMemory) * 100).toFixed(2)}%`
+                : '0%',
+        })),
+        totalMemoryAllocated: formatBytes(totalMemory),
+        totalFunctions: allFunctions.length,
+    };
+}
+export function formatMemoryHogsOutput(result) {
+    const lines = [
+        `# Memory-Heavy Functions`,
+        ``,
+        `Total memory allocated: ${result.totalMemoryAllocated}`,
+        `Total functions analyzed: ${formatNumber(result.totalFunctions)}`,
+        ``,
+    ];
+    for (const f of result.functions) {
+        lines.push(`## ${f.rank}. ${f.name}`);
+        lines.push(`- **Call Path**: ${f.callPath}`);
+        if (f.location) {
+            lines.push(`- **Location**: ${f.location}`);
+        }
+        lines.push(`- **Calls**: ${formatNumber(f.callCount)}`);
+        lines.push(`- **Total Allocated**: ${f.memoryAllocated} (${f.percentOfTotal})`);
+        lines.push(`- **Peak**: ${f.memoryPeak}`);
+        lines.push(`- **Net Change**: ${f.memoryNet}`);
+        lines.push(`- **Avg/Call**: ${f.avgMemoryPerCall}`);
+        lines.push(``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=memory-hogs.js.map

package/dist/tools/memory-hogs.js.map

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

package/dist/tools/most-called.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tool: get_most_called_functions
+ * Returns functions sorted by call count
+ */
+import { z } from 'zod';
+export declare const mostCalledSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    span: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    limit: number;
+    span?: string | undefined;
+}, {
+    filePath: string;
+    span?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type MostCalledInput = z.infer<typeof mostCalledSchema>;
+export interface MostCalledResult {
+    functions: Array<{
+        rank: number;
+        name: string;
+        callPath: string;
+        location?: string;
+        callCount: number;
+        totalWallTime: string;
+        avgWallTime: string;
+        percentOfCalls: string;
+    }>;
+    totalCalls: number;
+    totalFunctions: number;
+}
+export declare function getMostCalledFunctions(input: MostCalledInput): Promise<MostCalledResult>;
+export declare function formatMostCalledOutput(result: MostCalledResult): string;
+//# sourceMappingURL=most-called.d.ts.map

package/dist/tools/most-called.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"most-called.d.ts","sourceRoot":"","sources":["../../src/tools/most-called.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAsBvE"}

package/dist/tools/most-called.js

@@ -0,0 +1,59 @@
+/**
+ * Tool: get_most_called_functions
+ * Returns functions sorted by call count
+ */
+import { z } from 'zod';
+import { loadProfile } from '../decoder/decompress.js';
+import { walkTrie, sortByField } from '../decoder/trie-walker.js';
+import { formatTime, formatNumber, formatLocation } from '../utils/formatting.js';
+export const mostCalledSchema = z.object({
+    filePath: z.string().describe('Path to the PerfBase profile file'),
+    span: z.string().optional().describe('Filter to a specific span name'),
+    limit: z.number().int().positive().default(20).describe('Maximum number of results'),
+});
+export async function getMostCalledFunctions(input) {
+    const data = await loadProfile(input.filePath);
+    const allFunctions = walkTrie(data, input.span);
+    // Calculate total calls
+    const totalCalls = allFunctions.reduce((sum, f) => sum + f.callCount, 0);
+    // Sort by call count
+    const sorted = sortByField(allFunctions, 'callCount', input.limit);
+    return {
+        functions: sorted.map((f, i) => ({
+            rank: i + 1,
+            name: f.name,
+            callPath: f.callPath,
+            location: f.file ? formatLocation(f.file, f.line) : undefined,
+            callCount: f.callCount,
+            totalWallTime: formatTime(f.totalWallTime),
+            avgWallTime: formatTime(f.avgWallTime),
+            percentOfCalls: totalCalls > 0
+                ? `${((f.callCount / totalCalls) * 100).toFixed(2)}%`
+                : '0%',
+        })),
+        totalCalls,
+        totalFunctions: allFunctions.length,
+    };
+}
+export function formatMostCalledOutput(result) {
+    const lines = [
+        `# Most Called Functions`,
+        ``,
+        `Total calls: ${formatNumber(result.totalCalls)}`,
+        `Total functions analyzed: ${formatNumber(result.totalFunctions)}`,
+        ``,
+    ];
+    for (const f of result.functions) {
+        lines.push(`## ${f.rank}. ${f.name}`);
+        lines.push(`- **Call Path**: ${f.callPath}`);
+        if (f.location) {
+            lines.push(`- **Location**: ${f.location}`);
+        }
+        lines.push(`- **Calls**: ${formatNumber(f.callCount)} (${f.percentOfCalls})`);
+        lines.push(`- **Total Time**: ${f.totalWallTime}`);
+        lines.push(`- **Avg Time**: ${f.avgWallTime}`);
+        lines.push(``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=most-called.js.map

package/dist/tools/most-called.js.map

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

package/dist/tools/n-plus-one.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tool: detect_n_plus_one
+ * Detects N+1 query patterns in the profile
+ */
+import { z } from 'zod';
+import type { NPlusOnePattern } from '../decoder/types.js';
+export declare const nPlusOneSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    span: z.ZodOptional<z.ZodString>;
+    minRepetitions: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    minRepetitions: number;
+    span?: string | undefined;
+}, {
+    filePath: string;
+    span?: string | undefined;
+    minRepetitions?: number | undefined;
+}>;
+export type NPlusOneInput = z.infer<typeof nPlusOneSchema>;
+export interface NPlusOneResult {
+    patterns: NPlusOnePattern[];
+    totalPatterns: number;
+    estimatedWastedTime: string;
+    recommendations: string[];
+}
+export declare function detectNPlusOne(input: NPlusOneInput): Promise<NPlusOneResult>;
+export declare function formatNPlusOneOutput(result: NPlusOneResult): string;
+//# sourceMappingURL=n-plus-one.d.ts.map

package/dist/tools/n-plus-one.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n-plus-one.d.ts","sourceRoot":"","sources":["../../src/tools/n-plus-one.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,eAAO,MAAM,cAAc;;;;;;;;;;;;EASzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAsB3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,cAAc,CAAC,CA6DzB;AAuCD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA+BnE"}

package/dist/tools/n-plus-one.js

@@ -0,0 +1,137 @@
+/**
+ * Tool: detect_n_plus_one
+ * Detects N+1 query patterns in the profile
+ */
+import { z } from 'zod';
+import { loadProfile } from '../decoder/decompress.js';
+import { walkTrie } from '../decoder/trie-walker.js';
+import { formatTime, formatNumber } from '../utils/formatting.js';
+export const nPlusOneSchema = z.object({
+    filePath: z.string().describe('Path to the PerfBase profile file'),
+    span: z.string().optional().describe('Filter to a specific span name'),
+    minRepetitions: z
+        .number()
+        .int()
+        .positive()
+        .default(5)
+        .describe('Minimum number of similar queries to flag as N+1'),
+});
+// Database operation patterns
+const DB_OPERATION_PATTERNS = [
+    /^PDO::query$/i,
+    /^PDO::exec$/i,
+    /^PDOStatement::execute$/i,
+    /^mysqli::query$/i,
+    /^mysqli_query$/i,
+    /^mysqli_stmt::execute$/i,
+    /^pg_query/i,
+    /^pg_execute/i,
+    /->query\(/,
+    /->execute\(/,
+    /->find\(/,
+    /->findOne\(/,
+];
+function isQueryOperation(name) {
+    return DB_OPERATION_PATTERNS.some((pattern) => pattern.test(name));
+}
+export async function detectNPlusOne(input) {
+    const data = await loadProfile(input.filePath);
+    const allFunctions = walkTrie(data, input.span);
+    // Find database query functions
+    const queryFunctions = allFunctions.filter((f) => isQueryOperation(f.name));
+    // Group by similar call paths (parent context)
+    const pathGroups = new Map();
+    for (const f of queryFunctions) {
+        // Extract parent path (everything before the query function)
+        const parentPath = extractParentPath(f.callPath);
+        const key = `${f.name}|${parentPath}`;
+        if (!pathGroups.has(key)) {
+            pathGroups.set(key, []);
+        }
+        pathGroups.get(key).push(f);
+    }
+    // Identify N+1 patterns
+    const patterns = [];
+    let totalWastedTime = 0;
+    for (const [key, functions] of pathGroups) {
+        // Sum up all calls from this pattern
+        const totalCalls = functions.reduce((sum, f) => sum + f.callCount, 0);
+        if (totalCalls >= input.minRepetitions) {
+            const totalTime = functions.reduce((sum, f) => sum + f.totalWallTime, 0);
+            const [queryPattern] = key.split('|');
+            patterns.push({
+                queryPattern,
+                count: totalCalls,
+                totalTime,
+                callPaths: [...new Set(functions.map((f) => f.callPath))].slice(0, 5),
+            });
+            // Estimate wasted time (assuming 1 query would be enough)
+            // The "wasted" time is the time spent on N-1 extra queries
+            if (totalCalls > 1) {
+                const avgTime = totalTime / totalCalls;
+                totalWastedTime += avgTime * (totalCalls - 1);
+            }
+        }
+    }
+    // Sort by count descending
+    patterns.sort((a, b) => b.count - a.count);
+    // Generate recommendations
+    const recommendations = generateRecommendations(patterns);
+    return {
+        patterns: patterns.slice(0, 20),
+        totalPatterns: patterns.length,
+        estimatedWastedTime: formatTime(totalWastedTime),
+        recommendations,
+    };
+}
+function extractParentPath(callPath) {
+    const parts = callPath.split(' > ');
+    // Return all but the last element (the query function itself)
+    return parts.slice(0, -1).join(' > ');
+}
+function generateRecommendations(patterns) {
+    const recommendations = [];
+    if (patterns.length === 0) {
+        recommendations.push('No N+1 patterns detected in this profile.');
+        return recommendations;
+    }
+    const topPattern = patterns[0];
+    recommendations.push(`Found ${patterns.length} potential N+1 query pattern(s).`);
+    if (topPattern.count >= 100) {
+        recommendations.push(`Critical: "${topPattern.queryPattern}" is called ${topPattern.count} times. Consider using eager loading or batch queries.`);
+    }
+    else if (topPattern.count >= 20) {
+        recommendations.push(`Warning: "${topPattern.queryPattern}" is called ${topPattern.count} times. Consider optimizing with JOINs or preloading.`);
+    }
+    recommendations.push('Common solutions: Use eager loading (e.g., Eloquent with(), Doctrine JOIN FETCH), batch queries, or query caching.');
+    return recommendations;
+}
+export function formatNPlusOneOutput(result) {
+    const lines = [
+        `# N+1 Query Detection`,
+        ``,
+        `**Patterns Found**: ${result.totalPatterns}`,
+        `**Estimated Wasted Time**: ${result.estimatedWastedTime}`,
+        ``,
+        `## Recommendations`,
+        ``,
+    ];
+    for (const rec of result.recommendations) {
+        lines.push(`- ${rec}`);
+    }
+    if (result.patterns.length > 0) {
+        lines.push(``, `## Detected Patterns`, ``);
+        for (const pattern of result.patterns) {
+            lines.push(`### ${pattern.queryPattern}`);
+            lines.push(`- **Repeated**: ${formatNumber(pattern.count)} times`);
+            lines.push(`- **Total Time**: ${formatTime(pattern.totalTime)}`);
+            lines.push(`- **Example Paths**:`);
+            for (const path of pattern.callPaths) {
+                lines.push(`  - ${path}`);
+            }
+            lines.push(``);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=n-plus-one.js.map

package/dist/tools/n-plus-one.js.map

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

package/dist/tools/slowest-functions.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Tool: get_slowest_functions
+ * Returns functions sorted by total wall time
+ */
+import { z } from 'zod';
+export declare const slowestFunctionsSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    span: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    limit: number;
+    span?: string | undefined;
+}, {
+    filePath: string;
+    span?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type SlowestFunctionsInput = z.infer<typeof slowestFunctionsSchema>;
+export interface SlowestFunctionsResult {
+    functions: Array<{
+        rank: number;
+        name: string;
+        callPath: string;
+        location?: string;
+        callCount: number;
+        totalWallTime: string;
+        avgWallTime: string;
+        percentOfTotal: string;
+    }>;
+    totalWallTime: string;
+    totalFunctions: number;
+}
+export declare function getSlowestFunctions(input: SlowestFunctionsInput): Promise<SlowestFunctionsResult>;
+export declare function formatSlowestFunctionsOutput(result: SlowestFunctionsResult): string;
+//# sourceMappingURL=slowest-functions.d.ts.map

package/dist/tools/slowest-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slowest-functions.d.ts","sourceRoot":"","sources":["../../src/tools/slowest-functions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CA2BjC;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAsBnF"}

package/dist/tools/slowest-functions.js

@@ -0,0 +1,59 @@
+/**
+ * Tool: get_slowest_functions
+ * Returns functions sorted by total wall time
+ */
+import { z } from 'zod';
+import { loadProfile } from '../decoder/decompress.js';
+import { walkTrie, sortByField } from '../decoder/trie-walker.js';
+import { formatTime, formatNumber, formatLocation } from '../utils/formatting.js';
+export const slowestFunctionsSchema = z.object({
+    filePath: z.string().describe('Path to the PerfBase profile file'),
+    span: z.string().optional().describe('Filter to a specific span name'),
+    limit: z.number().int().positive().default(20).describe('Maximum number of results'),
+});
+export async function getSlowestFunctions(input) {
+    const data = await loadProfile(input.filePath);
+    const allFunctions = walkTrie(data, input.span);
+    // Calculate total wall time
+    const totalTime = allFunctions.reduce((sum, f) => sum + f.totalWallTime, 0);
+    // Sort by total wall time
+    const sorted = sortByField(allFunctions, 'totalWallTime', input.limit);
+    return {
+        functions: sorted.map((f, i) => ({
+            rank: i + 1,
+            name: f.name,
+            callPath: f.callPath,
+            location: f.file ? formatLocation(f.file, f.line) : undefined,
+            callCount: f.callCount,
+            totalWallTime: formatTime(f.totalWallTime),
+            avgWallTime: formatTime(f.avgWallTime),
+            percentOfTotal: totalTime > 0
+                ? `${((f.totalWallTime / totalTime) * 100).toFixed(2)}%`
+                : '0%',
+        })),
+        totalWallTime: formatTime(totalTime),
+        totalFunctions: allFunctions.length,
+    };
+}
+export function formatSlowestFunctionsOutput(result) {
+    const lines = [
+        `# Slowest Functions (by wall time)`,
+        ``,
+        `Total wall time: ${result.totalWallTime}`,
+        `Total functions analyzed: ${formatNumber(result.totalFunctions)}`,
+        ``,
+    ];
+    for (const f of result.functions) {
+        lines.push(`## ${f.rank}. ${f.name}`);
+        lines.push(`- **Call Path**: ${f.callPath}`);
+        if (f.location) {
+            lines.push(`- **Location**: ${f.location}`);
+        }
+        lines.push(`- **Calls**: ${formatNumber(f.callCount)}`);
+        lines.push(`- **Total Time**: ${f.totalWallTime} (${f.percentOfTotal})`);
+        lines.push(`- **Avg Time**: ${f.avgWallTime}`);
+        lines.push(``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=slowest-functions.js.map

package/dist/tools/slowest-functions.js.map

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