xdebug-mcp 1.0.0

package/dist/session/watch-manager.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Watch Manager
+ * Manages persistent watch expressions that auto-evaluate on each break.
+ */
+import { EventEmitter } from 'events';
+import { Property } from '../dbgp/types.js';
+import { DebugSession } from './session.js';
+export interface WatchExpression {
+    id: string;
+    expression: string;
+    lastValue?: Property | null;
+    previousValue?: Property | null;
+    hasChanged: boolean;
+    errorMessage?: string;
+    evaluationCount: number;
+    createdAt: Date;
+    lastEvaluatedAt?: Date;
+}
+export interface WatchEvaluationResult {
+    id: string;
+    expression: string;
+    value: Property | null;
+    previousValue: Property | null;
+    hasChanged: boolean;
+    error?: string;
+}
+export declare class WatchManager extends EventEmitter {
+    private watches;
+    private watchIdCounter;
+    constructor();
+    addWatch(expression: string): WatchExpression;
+    removeWatch(id: string): boolean;
+    getWatch(id: string): WatchExpression | undefined;
+    getAllWatches(): WatchExpression[];
+    clearAllWatches(): void;
+    /**
+     * Evaluate all watch expressions in the current session context
+     */
+    evaluateAll(session: DebugSession, stackDepth?: number): Promise<WatchEvaluationResult[]>;
+    /**
+     * Evaluate a single watch expression
+     */
+    evaluateWatch(session: DebugSession, watch: WatchExpression, stackDepth?: number): Promise<WatchEvaluationResult>;
+    /**
+     * Compare two property values to detect changes
+     */
+    private hasValueChanged;
+    /**
+     * Get watches that have changed since last evaluation
+     */
+    getChangedWatches(): WatchExpression[];
+    /**
+     * Export watch configuration for saving
+     */
+    exportConfig(): {
+        expressions: string[];
+    };
+    /**
+     * Import watch configuration
+     */
+    importConfig(config: {
+        expressions: string[];
+    }): void;
+}

package/dist/session/watch-manager.js

@@ -0,0 +1,137 @@
+/**
+ * Watch Manager
+ * Manages persistent watch expressions that auto-evaluate on each break.
+ */
+import { EventEmitter } from 'events';
+import { logger } from '../utils/logger.js';
+export class WatchManager extends EventEmitter {
+    watches = new Map();
+    watchIdCounter = 0;
+    constructor() {
+        super();
+    }
+    addWatch(expression) {
+        const id = `watch_${++this.watchIdCounter}`;
+        const watch = {
+            id,
+            expression,
+            hasChanged: false,
+            evaluationCount: 0,
+            createdAt: new Date(),
+        };
+        this.watches.set(id, watch);
+        logger.debug(`Watch added: ${id} = ${expression}`);
+        return watch;
+    }
+    removeWatch(id) {
+        const removed = this.watches.delete(id);
+        if (removed) {
+            logger.debug(`Watch removed: ${id}`);
+        }
+        return removed;
+    }
+    getWatch(id) {
+        return this.watches.get(id);
+    }
+    getAllWatches() {
+        return Array.from(this.watches.values());
+    }
+    clearAllWatches() {
+        this.watches.clear();
+        logger.debug('All watches cleared');
+    }
+    /**
+     * Evaluate all watch expressions in the current session context
+     */
+    async evaluateAll(session, stackDepth = 0) {
+        const results = [];
+        for (const watch of this.watches.values()) {
+            const result = await this.evaluateWatch(session, watch, stackDepth);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Evaluate a single watch expression
+     */
+    async evaluateWatch(session, watch, stackDepth = 0) {
+        try {
+            const value = await session.evaluate(watch.expression, stackDepth);
+            // Track previous value for change detection
+            watch.previousValue = watch.lastValue;
+            watch.lastValue = value;
+            watch.lastEvaluatedAt = new Date();
+            watch.evaluationCount++;
+            watch.errorMessage = undefined;
+            // Detect changes
+            watch.hasChanged = this.hasValueChanged(watch.previousValue, watch.lastValue);
+            if (watch.hasChanged) {
+                this.emit('watchChanged', watch);
+            }
+            return {
+                id: watch.id,
+                expression: watch.expression,
+                value,
+                previousValue: watch.previousValue || null,
+                hasChanged: watch.hasChanged,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            watch.errorMessage = errorMessage;
+            watch.lastEvaluatedAt = new Date();
+            watch.evaluationCount++;
+            return {
+                id: watch.id,
+                expression: watch.expression,
+                value: null,
+                previousValue: watch.previousValue || null,
+                hasChanged: false,
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Compare two property values to detect changes
+     */
+    hasValueChanged(prev, curr) {
+        if (!prev && !curr)
+            return false;
+        if (!prev || !curr)
+            return true;
+        // Compare type
+        if (prev.type !== curr.type)
+            return true;
+        // Compare value
+        if (prev.value !== curr.value)
+            return true;
+        // For complex types, compare number of children
+        if (prev.numchildren !== curr.numchildren)
+            return true;
+        return false;
+    }
+    /**
+     * Get watches that have changed since last evaluation
+     */
+    getChangedWatches() {
+        return Array.from(this.watches.values()).filter((w) => w.hasChanged);
+    }
+    /**
+     * Export watch configuration for saving
+     */
+    exportConfig() {
+        return {
+            expressions: Array.from(this.watches.values()).map((w) => w.expression),
+        };
+    }
+    /**
+     * Import watch configuration
+     */
+    importConfig(config) {
+        this.clearAllWatches();
+        for (const expr of config.expressions) {
+            this.addWatch(expr);
+        }
+    }
+}
+//# sourceMappingURL=watch-manager.js.map

package/dist/session/watch-manager.js.map

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

package/dist/tools/advanced.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Advanced Debugging MCP Tools
+ * Watch expressions, logpoints, profiling, coverage, and more.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SessionManager } from '../session/manager.js';
+import { WatchManager } from '../session/watch-manager.js';
+import { LogpointManager } from '../session/logpoint-manager.js';
+import { Profiler } from '../session/profiler.js';
+import { RequestContextCapture } from '../session/request-context.js';
+import { StepFilter } from '../session/step-filter.js';
+import { DebugConfigManager } from '../session/debug-config.js';
+import { CodeCoverageTracker } from '../session/code-coverage.js';
+import { SessionExporter } from '../session/session-export.js';
+export interface AdvancedToolsContext {
+    sessionManager: SessionManager;
+    watchManager: WatchManager;
+    logpointManager: LogpointManager;
+    profiler: Profiler;
+    requestCapture: RequestContextCapture;
+    stepFilter: StepFilter;
+    configManager: DebugConfigManager;
+    coverageTracker: CodeCoverageTracker;
+    sessionExporter: SessionExporter;
+}
+export declare function registerAdvancedTools(server: McpServer, ctx: AdvancedToolsContext): void;