@xctrace-analyzer/mcp-server 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+/**
+ * Xcode Instruments Trace Analyzer MCP Server
+ *
+ * Provides intelligent analysis of Xcode Instruments traces via Model Context Protocol
+ */
+import { analyzeTraceFile as defaultAnalyzeTraceFile, compareTraceFiles as defaultCompareTraceFiles, getXCTraceVersion as defaultGetXCTraceVersion, getXCTraceCapabilities as defaultGetXCTraceCapabilities, isXCTraceAvailable as defaultIsXCTraceAvailable, listDevices as defaultListDevices, listTemplates as defaultListTemplates, recordTrace as defaultRecordTrace, symbolicateTrace as defaultSymbolicateTrace } from '@xctrace-analyzer/core';
+export interface XCTraceAnalyzerDependencies {
+    analyzeTraceFile: typeof defaultAnalyzeTraceFile;
+    compareTraceFiles: typeof defaultCompareTraceFiles;
+    listTemplates: typeof defaultListTemplates;
+    listDevices: typeof defaultListDevices;
+    isXCTraceAvailable: typeof defaultIsXCTraceAvailable;
+    getXCTraceVersion: typeof defaultGetXCTraceVersion;
+    getXCTraceCapabilities?: typeof defaultGetXCTraceCapabilities;
+    recordTrace: typeof defaultRecordTrace;
+    symbolicateTrace?: typeof defaultSymbolicateTrace;
+    openTrace?: (tracePath: string) => Promise<void>;
+}
+export type RedactionMode = 'balanced' | 'strict' | 'off';
+export interface XCTraceAnalyzerSecurityOptions {
+    allowLaunchProfiling?: boolean;
+    allowAllProcessesProfiling?: boolean;
+    allowExternalTraceOutput?: boolean;
+    allowExternalTraceCleanup?: boolean;
+    traceRoot?: string;
+    maxDurationSeconds?: number;
+    redaction?: RedactionMode;
+}
+/**
+ * MCP Server for Xcode Instruments trace analysis
+ */
+export declare class XCTraceAnalyzerServer {
+    private server;
+    private deps;
+    private security;
+    private recordedTracePaths;
+    constructor(deps?: XCTraceAnalyzerDependencies, securityOptions?: XCTraceAnalyzerSecurityOptions);
+    private setupHandlers;
+    /**
+     * Define available MCP tools
+     */
+    private getTools;
+    /**
+     * Handle tool calls
+     */
+    callTool(toolName: string, args: any): Promise<any>;
+    private formatToolError;
+    /**
+     * Analyze a trace file
+     */
+    private analyzeTrace;
+    /**
+     * Compare two trace files
+     */
+    private compareTraces;
+    /**
+     * Record a running app and optionally analyze the captured trace.
+     */
+    private trackRunningApp;
+    /**
+     * Record a running app with a preset of Instruments templates and return one report.
+     */
+    private profileRunningApp;
+    /**
+     * List available templates
+     */
+    private listTemplates;
+    /**
+     * List available devices
+     */
+    private listDevices;
+    /**
+     * Check xctrace availability
+     */
+    private checkXCTrace;
+    /**
+     * Preview or delete generated .trace bundles.
+     */
+    private cleanupTraces;
+    private requiredString;
+    private optionalString;
+    private optionalPositiveNumber;
+    private optionalNonNegativeNumber;
+    private optionalPositiveInteger;
+    private assertDurationWithinLimit;
+    private optionalStringArray;
+    private optionalTimeRangeMs;
+    private outputFormat;
+    private formatToolOutput;
+    private safeDisplayValue;
+    private sanitizeReportText;
+    private safeInlineText;
+    private redactStructuredValue;
+    private structuredAnalysis;
+    private prepareTraceForAnalysis;
+    private recordTargetOptions;
+    private optionalStringMap;
+    private optionalBoolean;
+    private openTraceInInstruments;
+    private fallbackCapabilities;
+    private profileCapabilityWarnings;
+    private includesCaseInsensitive;
+    private discoverTraceBundles;
+    private cleanupTraceCandidate;
+    private tracePathSizeBytes;
+    private rememberRecordedTrace;
+    private traceOutputPath;
+    private assertTraceOutputPathAllowed;
+    private assertTraceDirectoryAllowed;
+    private assertStreamPathAllowed;
+    private assertCleanupDirectoryAllowed;
+    private canDeleteTracePath;
+    private isWithinTraceRoot;
+    private profilePresetForName;
+    private profileTraceOutputPath;
+    private safeFileName;
+    private formatTrackingHeader;
+    private formatInstrumentsOpenLine;
+    private formatProfileReport;
+    private profileStatus;
+    private profileSectionTitle;
+    private formatTraceCleanupOutput;
+    private formatTraceCleanupEntry;
+    private formatBytes;
+    private instrumentSectionTitle;
+    private appendCpuHighlights;
+    private appendTimeProfilerStatus;
+    private appendUserFrameSection;
+    private appendAnalysisWindow;
+    private appendHangsSection;
+    private hasHangExportSignal;
+    private hangSourceSchemas;
+    private appendInstrumentSections;
+    private appendSupportStatus;
+    private supportStatusLabel;
+    private appendExportDiagnostics;
+    private appendTraceExportFailureNextSteps;
+    private isTraceTocExportFailure;
+    private traceExportFailureNextSteps;
+    private profileRecommendations;
+    /**
+     * Format analysis output for human readability
+     */
+    private formatAnalysisOutput;
+    /**
+     * Format comparison output
+     */
+    private formatComparisonOutput;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+}
+export interface XCTraceAnalyzerCliIo {
+    stdout: {
+        write(chunk: string): unknown;
+    };
+    stderr: {
+        write(chunk: string): unknown;
+    };
+}
+export declare function runCli(argv?: string[], io?: XCTraceAnalyzerCliIo, deps?: XCTraceAnalyzerDependencies): Promise<number>;
+export declare function getDefaultTraceRoot(): string;
+//# 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":"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"}