@perfbase/mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,309 @@
+#!/usr/bin/env node
+/**
+ * PerfBase MCP Server
+ *
+ * Provides tools for analyzing PerfBase profiler data through the
+ * Model Context Protocol (MCP).
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ErrorCode, McpError, } from '@modelcontextprotocol/sdk/types.js';
+// Tools
+import { slowestFunctionsSchema, getSlowestFunctions, formatSlowestFunctionsOutput, } from './tools/slowest-functions.js';
+import { mostCalledSchema, getMostCalledFunctions, formatMostCalledOutput, } from './tools/most-called.js';
+import { cpuIntensiveSchema, getCpuIntensiveFunctions, formatCpuIntensiveOutput, } from './tools/cpu-intensive.js';
+import { memoryHogsSchema, getMemoryHogs, formatMemoryHogsOutput, } from './tools/memory-hogs.js';
+import { databaseQueriesSchema, getDatabaseQueries, formatDatabaseQueriesOutput, } from './tools/database-queries.js';
+import { nPlusOneSchema, detectNPlusOne, formatNPlusOneOutput, } from './tools/n-plus-one.js';
+import { summarySchema, getProfileSummary, formatSummaryOutput, } from './tools/summary.js';
+// Resources
+import { getProfileMetadata, formatMetadataAsJson, } from './resources/profile-metadata.js';
+// Tool definitions for MCP
+const TOOLS = [
+    {
+        name: 'get_slowest_functions',
+        description: 'Get the slowest functions by total wall time from a PerfBase profile. Useful for identifying performance bottlenecks.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: {
+                    type: 'string',
+                    description: 'Absolute path to the PerfBase profile file (.bin)',
+                },
+                span: {
+                    type: 'string',
+                    description: 'Optional: filter to a specific span name',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results (default: 20)',
+                    default: 20,
+                },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'get_most_called_functions',
+        description: 'Get the most frequently called functions from a PerfBase profile. Useful for finding hot paths.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: {
+                    type: 'string',
+                    description: 'Absolute path to the PerfBase profile file (.bin)',
+                },
+                span: {
+                    type: 'string',
+                    description: 'Optional: filter to a specific span name',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results (default: 20)',
+                    default: 20,
+                },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'get_cpu_intensive_functions',
+        description: 'Get functions with highest CPU time from a PerfBase profile. Useful for identifying compute-bound code.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: {
+                    type: 'string',
+                    description: 'Absolute path to the PerfBase profile file (.bin)',
+                },
+                span: {
+                    type: 'string',
+                    description: 'Optional: filter to a specific span name',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results (default: 20)',
+                    default: 20,
+                },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'get_memory_hogs',
+        description: 'Get functions with highest memory allocation from a PerfBase profile. Useful for finding memory-intensive code.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: {
+                    type: 'string',
+                    description: 'Absolute path to the PerfBase profile file (.bin)',
+                },
+                span: {
+                    type: 'string',
+                    description: 'Optional: filter to a specific span name',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results (default: 20)',
+                    default: 20,
+                },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'get_database_queries',
+        description: 'Extract and analyze database operations (PDO, mysqli, MongoDB, Redis, etc.) from a PerfBase profile.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: {
+                    type: 'string',
+                    description: 'Absolute path to the PerfBase profile file (.bin)',
+                },
+                span: {
+                    type: 'string',
+                    description: 'Optional: filter to a specific span name',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results (default: 50)',
+                    default: 50,
+                },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'detect_n_plus_one',
+        description: 'Detect N+1 query patterns in a PerfBase profile. Finds repeated similar queries that could be optimized.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: {
+                    type: 'string',
+                    description: 'Absolute path to the PerfBase profile file (.bin)',
+                },
+                span: {
+                    type: 'string',
+                    description: 'Optional: filter to a specific span name',
+                },
+                minRepetitions: {
+                    type: 'number',
+                    description: 'Minimum number of similar queries to flag as N+1 (default: 5)',
+                    default: 5,
+                },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'get_profile_summary',
+        description: 'Get an overall summary of a PerfBase profile including spans, totals, and top functions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filePath: {
+                    type: 'string',
+                    description: 'Absolute path to the PerfBase profile file (.bin)',
+                },
+            },
+            required: ['filePath'],
+        },
+    },
+];
+// Create server instance
+const server = new Server({
+    name: 'perfbase',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// Handle list tools request
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'get_slowest_functions': {
+                const input = slowestFunctionsSchema.parse(args);
+                const result = await getSlowestFunctions(input);
+                return {
+                    content: [
+                        { type: 'text', text: formatSlowestFunctionsOutput(result) },
+                    ],
+                };
+            }
+            case 'get_most_called_functions': {
+                const input = mostCalledSchema.parse(args);
+                const result = await getMostCalledFunctions(input);
+                return {
+                    content: [{ type: 'text', text: formatMostCalledOutput(result) }],
+                };
+            }
+            case 'get_cpu_intensive_functions': {
+                const input = cpuIntensiveSchema.parse(args);
+                const result = await getCpuIntensiveFunctions(input);
+                return {
+                    content: [{ type: 'text', text: formatCpuIntensiveOutput(result) }],
+                };
+            }
+            case 'get_memory_hogs': {
+                const input = memoryHogsSchema.parse(args);
+                const result = await getMemoryHogs(input);
+                return {
+                    content: [{ type: 'text', text: formatMemoryHogsOutput(result) }],
+                };
+            }
+            case 'get_database_queries': {
+                const input = databaseQueriesSchema.parse(args);
+                const result = await getDatabaseQueries(input);
+                return {
+                    content: [
+                        { type: 'text', text: formatDatabaseQueriesOutput(result) },
+                    ],
+                };
+            }
+            case 'detect_n_plus_one': {
+                const input = nPlusOneSchema.parse(args);
+                const result = await detectNPlusOne(input);
+                return {
+                    content: [{ type: 'text', text: formatNPlusOneOutput(result) }],
+                };
+            }
+            case 'get_profile_summary': {
+                const input = summarySchema.parse(args);
+                const result = await getProfileSummary(input);
+                return {
+                    content: [{ type: 'text', text: formatSummaryOutput(result) }],
+                };
+            }
+            default:
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof McpError) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new McpError(ErrorCode.InternalError, `Tool error: ${message}`);
+    }
+});
+// Handle list resources request
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return {
+        resources: [
+            {
+                uri: 'perfbase://profile/{path}/metadata',
+                name: 'Profile Metadata',
+                description: 'Get metadata about a PerfBase profile including spans, system stats, and attributes',
+                mimeType: 'application/json',
+            },
+        ],
+    };
+});
+// Handle read resource request
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    // Parse perfbase://profile/{path}/metadata
+    const match = uri.match(/^perfbase:\/\/profile\/(.+)\/metadata$/);
+    if (match) {
+        const filePath = decodeURIComponent(match[1]);
+        try {
+            const metadata = await getProfileMetadata(filePath);
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: formatMetadataAsJson(metadata),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new McpError(ErrorCode.InternalError, `Failed to read profile: ${message}`);
+        }
+    }
+    throw new McpError(ErrorCode.InvalidRequest, `Unknown resource URI: ${uri}`);
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('PerfBase MCP server started');
+}
+main().catch((error) => {
+    console.error('Failed to start server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/resources/profile-metadata.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resource: profile metadata
+ * Exposes profile metadata via MCP resources
+ */
+import type { ProfileMetadata } from '../decoder/types.js';
+/**
+ * Get metadata for a profile file
+ */
+export declare function getProfileMetadata(filePath: string): Promise<ProfileMetadata>;
+/**
+ * Format metadata as JSON for resource response
+ */
+export declare function formatMetadataAsJson(metadata: ProfileMetadata): string;
+//# sourceMappingURL=profile-metadata.d.ts.map

package/dist/resources/profile-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-metadata.d.ts","sourceRoot":"","sources":["../../src/resources/profile-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAUnF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAoBtE"}

package/dist/resources/profile-metadata.js

@@ -0,0 +1,41 @@
+/**
+ * Resource: profile metadata
+ * Exposes profile metadata via MCP resources
+ */
+import { loadProfile } from '../decoder/decompress.js';
+import { getSpanNames, countFunctions } from '../decoder/trie-walker.js';
+import { formatBytes } from '../utils/formatting.js';
+/**
+ * Get metadata for a profile file
+ */
+export async function getProfileMetadata(filePath) {
+    const data = await loadProfile(filePath);
+    return {
+        spans: getSpanNames(data),
+        systemStats: data.s,
+        attributes: data.a,
+        functionCount: countFunctions(data),
+        files: data.f,
+    };
+}
+/**
+ * Format metadata as JSON for resource response
+ */
+export function formatMetadataAsJson(metadata) {
+    return JSON.stringify({
+        spans: metadata.spans,
+        functionCount: metadata.functionCount,
+        filesCount: metadata.files.length,
+        systemStats: metadata.systemStats
+            ? {
+                peakMemory: metadata.systemStats.peak_memory
+                    ? formatBytes(metadata.systemStats.peak_memory)
+                    : undefined,
+                cpuPercent: metadata.systemStats.cpu_percent,
+                loadAvg1m: metadata.systemStats.load_avg_1m,
+            }
+            : undefined,
+        attributes: metadata.attributes,
+    }, null, 2);
+}
+//# sourceMappingURL=profile-metadata.js.map

package/dist/resources/profile-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-metadata.js","sourceRoot":"","sources":["../../src/resources/profile-metadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEzC,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC;QACzB,WAAW,EAAE,IAAI,CAAC,CAAC;QACnB,UAAU,EAAE,IAAI,CAAC,CAAC;QAClB,aAAa,EAAE,cAAc,CAAC,IAAI,CAAC;QACnC,KAAK,EAAE,IAAI,CAAC,CAAC;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAyB;IAC5D,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;QACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;YAC/B,CAAC,CAAC;gBACE,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW;oBAC1C,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,CAAC;oBAC/C,CAAC,CAAC,SAAS;gBACb,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW;gBAC5C,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW;aAC5C;YACH,CAAC,CAAC,SAAS;QACb,UAAU,EAAE,QAAQ,CAAC,UAAU;KAChC,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/cpu-intensive.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Tool: get_cpu_intensive_functions
+ * Returns functions sorted by CPU time
+ */
+import { z } from 'zod';
+export declare const cpuIntensiveSchema: 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 CpuIntensiveInput = z.infer<typeof cpuIntensiveSchema>;
+export interface CpuIntensiveResult {
+    functions: Array<{
+        rank: number;
+        name: string;
+        callPath: string;
+        location?: string;
+        callCount: number;
+        totalCpuTime: string;
+        avgCpuTime: string;
+        percentOfCpu: string;
+        wallVsCpuRatio: string;
+    }>;
+    totalCpuTime: string;
+    totalFunctions: number;
+}
+export declare function getCpuIntensiveFunctions(input: CpuIntensiveInput): Promise<CpuIntensiveResult>;
+export declare function formatCpuIntensiveOutput(result: CpuIntensiveResult): string;
+//# sourceMappingURL=cpu-intensive.d.ts.map

package/dist/tools/cpu-intensive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu-intensive.d.ts","sourceRoot":"","sources":["../../src/tools/cpu-intensive.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAI7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,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,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,CAAC,CA6B7B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA0B3E"}

package/dist/tools/cpu-intensive.js

@@ -0,0 +1,64 @@
+/**
+ * Tool: get_cpu_intensive_functions
+ * Returns functions sorted by CPU 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 cpuIntensiveSchema = 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 getCpuIntensiveFunctions(input) {
+    const data = await loadProfile(input.filePath);
+    const allFunctions = walkTrie(data, input.span);
+    // Calculate total CPU time
+    const totalCpu = allFunctions.reduce((sum, f) => sum + f.totalCpuTime, 0);
+    // Sort by total CPU time
+    const sorted = sortByField(allFunctions, 'totalCpuTime', 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,
+            totalCpuTime: formatTime(f.totalCpuTime),
+            avgCpuTime: formatTime(f.avgCpuTime),
+            percentOfCpu: totalCpu > 0 ? `${((f.totalCpuTime / totalCpu) * 100).toFixed(2)}%` : '0%',
+            wallVsCpuRatio: f.totalCpuTime > 0
+                ? `${(f.totalWallTime / f.totalCpuTime).toFixed(2)}x`
+                : 'N/A',
+        })),
+        totalCpuTime: formatTime(totalCpu),
+        totalFunctions: allFunctions.length,
+    };
+}
+export function formatCpuIntensiveOutput(result) {
+    const lines = [
+        `# CPU-Intensive Functions`,
+        ``,
+        `Total CPU time: ${result.totalCpuTime}`,
+        `Total functions analyzed: ${formatNumber(result.totalFunctions)}`,
+        ``,
+        `> **Wall vs CPU ratio**: Higher values indicate I/O-bound operations (waiting).`,
+        `> A ratio close to 1.0 indicates CPU-bound operations.`,
+        ``,
+    ];
+    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 CPU Time**: ${f.totalCpuTime} (${f.percentOfCpu})`);
+        lines.push(`- **Avg CPU Time**: ${f.avgCpuTime}`);
+        lines.push(`- **Wall/CPU Ratio**: ${f.wallVsCpuRatio}`);
+        lines.push(``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cpu-intensive.js.map

package/dist/tools/cpu-intensive.js.map

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

package/dist/tools/database-queries.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tool: get_database_queries
+ * Extracts and analyzes database operations from the profile
+ */
+import { z } from 'zod';
+import type { DatabaseQuery } from '../decoder/types.js';
+export declare const databaseQueriesSchema: 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 DatabaseQueriesInput = z.infer<typeof databaseQueriesSchema>;
+export interface DatabaseQueriesResult {
+    queries: DatabaseQuery[];
+    totalQueries: number;
+    totalTime: string;
+    avgTimePerQuery: string;
+    byType: Record<string, {
+        count: number;
+        totalTime: string;
+    }>;
+}
+export declare function getDatabaseQueries(input: DatabaseQueriesInput): Promise<DatabaseQueriesResult>;
+export declare function formatDatabaseQueriesOutput(result: DatabaseQueriesResult): string;
+//# sourceMappingURL=database-queries.d.ts.map

package/dist/tools/database-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-queries.d.ts","sourceRoot":"","sources":["../../src/tools/database-queries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEvE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AA4CzE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9D;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CA2ChC;AAaD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CA4BjF"}