xdebug-mcp 1.0.0

package/dist/dbgp/connection.js

@@ -0,0 +1,362 @@
+/**
+ * DBGp Connection Handler
+ * Handles a single Xdebug connection with message parsing and command sending.
+ */
+import { EventEmitter } from 'events';
+import { XMLParser } from 'fast-xml-parser';
+import { logger } from '../utils/logger.js';
+var ParserState;
+(function (ParserState) {
+    ParserState[ParserState["DataLength"] = 0] = "DataLength";
+    ParserState[ParserState["Response"] = 1] = "Response";
+})(ParserState || (ParserState = {}));
+export class DbgpConnection extends EventEmitter {
+    socket;
+    commandTimeout;
+    buffer = Buffer.alloc(0);
+    parserState = ParserState.DataLength;
+    expectedLength = 0;
+    transactionId = 0;
+    pendingCommands = new Map();
+    commandQueue = [];
+    xmlParser;
+    closed = false;
+    initPacket = null;
+    id;
+    remoteAddress;
+    constructor(socket, commandTimeout = 30000) {
+        super();
+        this.socket = socket;
+        this.commandTimeout = commandTimeout;
+        this.id = `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+        this.remoteAddress = `${socket.remoteAddress}:${socket.remotePort}`;
+        this.xmlParser = new XMLParser({
+            ignoreAttributes: false,
+            attributeNamePrefix: '@_',
+            textNodeName: '#text',
+            parseAttributeValue: false,
+            trimValues: true,
+        });
+        this.socket.on('data', (data) => this.handleData(data));
+        this.socket.on('close', () => this.handleClose());
+        this.socket.on('error', (err) => this.emit('error', err));
+    }
+    handleData(data) {
+        this.buffer = Buffer.concat([this.buffer, data]);
+        this.processBuffer();
+    }
+    processBuffer() {
+        while (this.buffer.length > 0) {
+            if (this.parserState === ParserState.DataLength) {
+                // Look for NULL byte delimiter between length and data
+                const nullIndex = this.buffer.indexOf(0);
+                if (nullIndex === -1)
+                    return;
+                const lengthStr = this.buffer.subarray(0, nullIndex).toString('utf8');
+                this.expectedLength = parseInt(lengthStr, 10);
+                if (isNaN(this.expectedLength) || this.expectedLength <= 0) {
+                    logger.error('Invalid message length:', lengthStr);
+                    this.buffer = this.buffer.subarray(nullIndex + 1);
+                    continue;
+                }
+                this.buffer = this.buffer.subarray(nullIndex + 1);
+                this.parserState = ParserState.Response;
+            }
+            if (this.parserState === ParserState.Response) {
+                // Wait for full response + trailing NULL byte
+                if (this.buffer.length < this.expectedLength + 1)
+                    return;
+                const xmlData = this.buffer.subarray(0, this.expectedLength).toString('utf8');
+                this.buffer = this.buffer.subarray(this.expectedLength + 1);
+                this.parserState = ParserState.DataLength;
+                this.handleMessage(xmlData);
+            }
+        }
+    }
+    handleMessage(xmlData) {
+        try {
+            logger.debug('Received XML:', xmlData);
+            const parsed = this.xmlParser.parse(xmlData);
+            // Handle init packet (first message from Xdebug)
+            if (parsed.init) {
+                this.initPacket = this.parseInitPacket(parsed.init);
+                logger.info(`Debug session initialized: ${this.initPacket.fileUri}`);
+                this.emit('init', this.initPacket);
+                return;
+            }
+            // Handle regular response
+            if (parsed.response) {
+                const response = this.parseResponse(parsed.response);
+                const txId = response.transactionId;
+                const pending = this.pendingCommands.get(txId);
+                if (pending) {
+                    clearTimeout(pending.timeout);
+                    this.pendingCommands.delete(txId);
+                    pending.resolve(response);
+                }
+                this.emit('response', response);
+                this.processQueue();
+            }
+            // Handle stream output (stdout/stderr)
+            if (parsed.stream) {
+                const streamData = this.parseStream(parsed.stream);
+                this.emit('stream', streamData);
+            }
+        }
+        catch (error) {
+            logger.error('Error parsing message:', error);
+            this.emit('error', error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    parseInitPacket(init) {
+        const attrs = init;
+        return {
+            appId: attrs['@_appid'] || '',
+            ideKey: attrs['@_idekey'] || '',
+            session: attrs['@_session'] || '',
+            thread: attrs['@_thread'] || '',
+            language: attrs['@_language'] || 'PHP',
+            protocolVersion: attrs['@_protocol_version'] || '1.0',
+            fileUri: attrs['@_fileuri'] || '',
+            engine: init['engine']
+                ? {
+                    name: init['engine']['#text'] || '',
+                    version: init['engine']['@_version'] || '',
+                }
+                : undefined,
+        };
+    }
+    parseResponse(response) {
+        const attrs = response;
+        const result = {
+            command: attrs['@_command'] || '',
+            transactionId: parseInt(attrs['@_transaction_id'] || '0', 10),
+            status: attrs['@_status'],
+            reason: attrs['@_reason'],
+            success: attrs['@_success'] === '1',
+            data: {},
+        };
+        // Parse error if present
+        if (response['error']) {
+            const error = response['error'];
+            result.error = {
+                code: parseInt(error['@_code'] || '0', 10),
+                message: error['message']?.['#text'] || '',
+            };
+        }
+        // Parse message (location info after step commands)
+        const xdebugMessage = response['xdebug:message'] || response['message'];
+        if (xdebugMessage) {
+            const msg = xdebugMessage;
+            result.message = {
+                filename: msg['@_filename'] || '',
+                lineno: parseInt(msg['@_lineno'] || '0', 10),
+                exception: msg['@_exception'],
+            };
+        }
+        // Store raw data for further parsing by specific handlers
+        result.data = response;
+        return result;
+    }
+    parseStream(stream) {
+        const attrs = stream;
+        const encoding = attrs['@_encoding'] || 'base64';
+        let content = attrs['#text'] || '';
+        if (encoding === 'base64' && content) {
+            content = Buffer.from(content, 'base64').toString('utf8');
+        }
+        return {
+            type: attrs['@_type'],
+            encoding,
+            content,
+        };
+    }
+    async sendCommand(command, args, data) {
+        if (this.closed) {
+            throw new Error('Connection is closed');
+        }
+        return new Promise((resolve, reject) => {
+            const execute = () => {
+                const txId = ++this.transactionId;
+                let cmdStr = `${command} -i ${txId}`;
+                if (args) {
+                    for (const [key, value] of Object.entries(args)) {
+                        cmdStr += ` -${key} ${this.escapeArg(value)}`;
+                    }
+                }
+                if (data !== undefined) {
+                    const base64Data = Buffer.from(data).toString('base64');
+                    cmdStr += ` -- ${base64Data}`;
+                }
+                cmdStr += '\0';
+                const timeout = setTimeout(() => {
+                    this.pendingCommands.delete(txId);
+                    reject(new Error(`Command timeout: ${command}`));
+                    this.processQueue();
+                }, this.commandTimeout);
+                this.pendingCommands.set(txId, { resolve, reject, timeout });
+                logger.debug('Sending command:', cmdStr.replace('\0', '\\0'));
+                this.socket.write(cmdStr);
+            };
+            // DBGp doesn't support concurrent commands - queue them
+            if (this.pendingCommands.size > 0) {
+                this.commandQueue.push(execute);
+            }
+            else {
+                execute();
+            }
+        });
+    }
+    processQueue() {
+        if (this.commandQueue.length > 0 && this.pendingCommands.size === 0) {
+            const next = this.commandQueue.shift();
+            if (next)
+                next();
+        }
+    }
+    escapeArg(value) {
+        // If value contains spaces or special chars, quote it
+        if (/[\s"\\]/.test(value)) {
+            return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+        }
+        return value;
+    }
+    handleClose() {
+        this.closed = true;
+        // Reject all pending commands
+        for (const [txId, pending] of this.pendingCommands) {
+            clearTimeout(pending.timeout);
+            pending.reject(new Error('Connection closed'));
+        }
+        this.pendingCommands.clear();
+        this.commandQueue = [];
+        this.emit('close');
+    }
+    close() {
+        if (!this.closed) {
+            this.socket.destroy();
+        }
+    }
+    get isConnected() {
+        return !this.closed && !this.socket.destroyed;
+    }
+    // === Response Parsing Helpers ===
+    parseStackFrames(response) {
+        const data = response.data;
+        const stackData = data['stack'];
+        if (!stackData)
+            return [];
+        const frames = Array.isArray(stackData) ? stackData : [stackData];
+        return frames.map((frame) => ({
+            level: parseInt(frame['@_level'] || '0', 10),
+            type: (frame['@_type'] || 'file'),
+            filename: frame['@_filename'] || '',
+            lineno: parseInt(frame['@_lineno'] || '0', 10),
+            where: frame['@_where'],
+            cmdbegin: frame['@_cmdbegin'],
+            cmdend: frame['@_cmdend'],
+        }));
+    }
+    parseContexts(response) {
+        const data = response.data;
+        const contextData = data['context'];
+        if (!contextData)
+            return [];
+        const contexts = Array.isArray(contextData) ? contextData : [contextData];
+        return contexts.map((ctx) => ({
+            id: parseInt(ctx['@_id'] || '0', 10),
+            name: ctx['@_name'] || '',
+        }));
+    }
+    parseProperties(response) {
+        const data = response.data;
+        const propertyData = data['property'];
+        if (!propertyData)
+            return [];
+        const properties = Array.isArray(propertyData) ? propertyData : [propertyData];
+        return properties.map((prop) => this.parsePropertyNode(prop));
+    }
+    parseProperty(response) {
+        const data = response.data;
+        const propertyData = data['property'];
+        if (!propertyData)
+            return null;
+        return this.parsePropertyNode(propertyData);
+    }
+    parsePropertyNode(prop) {
+        const attrs = prop;
+        const property = {
+            name: attrs['@_name'] || '',
+            fullname: attrs['@_fullname'] || attrs['@_name'] || '',
+            type: attrs['@_type'] || 'unknown',
+        };
+        if (attrs['@_classname'])
+            property.classname = attrs['@_classname'];
+        if (attrs['@_facet'])
+            property.facet = attrs['@_facet'];
+        if (attrs['@_constant'] === '1')
+            property.constant = true;
+        if (attrs['@_children'] === '1')
+            property.children = true;
+        if (attrs['@_numchildren'])
+            property.numchildren = parseInt(attrs['@_numchildren'], 10);
+        if (attrs['@_size'])
+            property.size = parseInt(attrs['@_size'], 10);
+        if (attrs['@_page'])
+            property.page = parseInt(attrs['@_page'], 10);
+        if (attrs['@_pagesize'])
+            property.pagesize = parseInt(attrs['@_pagesize'], 10);
+        if (attrs['@_address'])
+            property.address = attrs['@_address'];
+        if (attrs['@_key'])
+            property.key = attrs['@_key'];
+        if (attrs['@_encoding'])
+            property.encoding = attrs['@_encoding'];
+        // Get value
+        const textValue = prop['#text'];
+        if (textValue !== undefined) {
+            if (attrs['@_encoding'] === 'base64') {
+                property.value = Buffer.from(textValue, 'base64').toString('utf8');
+            }
+            else {
+                property.value = textValue;
+            }
+        }
+        // Parse nested properties
+        const nestedProps = prop['property'];
+        if (nestedProps) {
+            const nested = Array.isArray(nestedProps) ? nestedProps : [nestedProps];
+            property.properties = nested.map((p) => this.parsePropertyNode(p));
+        }
+        return property;
+    }
+    parseBreakpoints(response) {
+        const data = response.data;
+        const bpData = data['breakpoint'];
+        if (!bpData)
+            return [];
+        const breakpoints = Array.isArray(bpData) ? bpData : [bpData];
+        return breakpoints.map((bp) => ({
+            id: bp['@_id'] || '',
+            type: (bp['@_type'] || 'line'),
+            state: (bp['@_state'] || 'enabled'),
+            resolved: bp['@_resolved'] === '1',
+            filename: bp['@_filename'],
+            lineno: bp['@_lineno'] ? parseInt(bp['@_lineno'], 10) : undefined,
+            function: bp['@_function'],
+            exception: bp['@_exception'],
+            expression: bp['@_expression'],
+            hitCount: bp['@_hit_count'] ? parseInt(bp['@_hit_count'], 10) : undefined,
+            hitValue: bp['@_hit_value'] ? parseInt(bp['@_hit_value'], 10) : undefined,
+            hitCondition: bp['@_hit_condition'],
+        }));
+    }
+    parseBreakpointSet(response) {
+        const data = response.data;
+        return {
+            id: data['@_id'] || '',
+            resolved: data['@_resolved'] === '1',
+        };
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/dbgp/connection.js.map

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

package/dist/dbgp/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './connection.js';
+export * from './server.js';

package/dist/dbgp/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './connection.js';
+export * from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/dbgp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dbgp/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}

package/dist/dbgp/server.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DBGp Server
+ * TCP server that listens for incoming Xdebug connections.
+ */
+import { EventEmitter } from 'events';
+import { DbgpConnection } from './connection.js';
+export interface DbgpServerConfig {
+    host: string;
+    port: number;
+    commandTimeout?: number;
+}
+export interface DbgpServerEvents {
+    connection: (connection: DbgpConnection) => void;
+    error: (error: Error) => void;
+    listening: (port: number, host: string) => void;
+    close: () => void;
+}
+export declare class DbgpServer extends EventEmitter {
+    private server;
+    private connections;
+    private config;
+    constructor(config: DbgpServerConfig);
+    start(): Promise<void>;
+    private handleConnection;
+    getConnection(id: string): DbgpConnection | undefined;
+    getAllConnections(): DbgpConnection[];
+    getConnectionCount(): number;
+    stop(): Promise<void>;
+    get isListening(): boolean;
+    get address(): {
+        host: string;
+        port: number;
+    } | null;
+}

package/dist/dbgp/server.js

@@ -0,0 +1,94 @@
+/**
+ * DBGp Server
+ * TCP server that listens for incoming Xdebug connections.
+ */
+import * as net from 'net';
+import { EventEmitter } from 'events';
+import { DbgpConnection } from './connection.js';
+import { logger } from '../utils/logger.js';
+export class DbgpServer extends EventEmitter {
+    server = null;
+    connections = new Map();
+    config;
+    constructor(config) {
+        super();
+        this.config = {
+            host: config.host,
+            port: config.port,
+            commandTimeout: config.commandTimeout ?? 30000,
+        };
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server = net.createServer((socket) => {
+                this.handleConnection(socket);
+            });
+            this.server.on('error', (err) => {
+                logger.error('DBGp server error:', err);
+                this.emit('error', err);
+                reject(err);
+            });
+            this.server.on('close', () => {
+                this.emit('close');
+            });
+            this.server.listen(this.config.port, this.config.host, () => {
+                logger.info(`DBGp server listening on ${this.config.host}:${this.config.port}`);
+                this.emit('listening', this.config.port, this.config.host);
+                resolve();
+            });
+        });
+    }
+    handleConnection(socket) {
+        const connection = new DbgpConnection(socket, this.config.commandTimeout);
+        logger.info(`New DBGp connection from ${connection.remoteAddress}`);
+        this.connections.set(connection.id, connection);
+        connection.on('init', () => {
+            this.emit('connection', connection);
+        });
+        connection.on('close', () => {
+            logger.info(`DBGp connection closed: ${connection.id}`);
+            this.connections.delete(connection.id);
+        });
+        connection.on('error', (err) => {
+            logger.error(`Connection ${connection.id} error:`, err);
+        });
+    }
+    getConnection(id) {
+        return this.connections.get(id);
+    }
+    getAllConnections() {
+        return Array.from(this.connections.values());
+    }
+    getConnectionCount() {
+        return this.connections.size;
+    }
+    async stop() {
+        // Close all connections
+        for (const conn of this.connections.values()) {
+            conn.close();
+        }
+        this.connections.clear();
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => {
+                    logger.info('DBGp server stopped');
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    get isListening() {
+        return this.server?.listening ?? false;
+    }
+    get address() {
+        const addr = this.server?.address();
+        if (addr && typeof addr === 'object') {
+            return { host: addr.address, port: addr.port };
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/dbgp/server.js.map

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

package/dist/dbgp/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * DBGp Protocol Types
+ * Based on: https://xdebug.org/docs/dbgp
+ */
+export interface InitPacket {
+    appId: string;
+    ideKey: string;
+    session: string;
+    thread: string;
+    language: string;
+    protocolVersion: string;
+    fileUri: string;
+    engine?: {
+        name: string;
+        version: string;
+    };
+}
+export type DebugStatus = 'starting' | 'break' | 'running' | 'stopping' | 'stopped';
+export type StopReason = 'ok' | 'error' | 'aborted' | 'exception';
+export interface DbgpResponse {
+    command: string;
+    transactionId: number;
+    status?: DebugStatus;
+    reason?: StopReason;
+    success?: boolean;
+    error?: DbgpError;
+    message?: {
+        filename: string;
+        lineno: number;
+        exception?: string;
+    };
+    data?: Record<string, unknown>;
+}
+export interface DbgpError {
+    code: number;
+    message: string;
+}
+export interface StackFrame {
+    level: number;
+    type: 'file' | 'eval';
+    filename: string;
+    lineno: number;
+    where?: string;
+    cmdbegin?: string;
+    cmdend?: string;
+}
+export interface Context {
+    id: number;
+    name: string;
+}
+export interface Property {
+    name: string;
+    fullname: string;
+    type: string;
+    classname?: string;
+    facet?: string;
+    constant?: boolean;
+    children?: boolean;
+    numchildren?: number;
+    size?: number;
+    page?: number;
+    pagesize?: number;
+    address?: string;
+    key?: string;
+    encoding?: string;
+    value?: string;
+    properties?: Property[];
+}
+export type BreakpointType = 'line' | 'call' | 'return' | 'exception' | 'conditional' | 'watch';
+export type BreakpointState = 'enabled' | 'disabled';
+export type HitCondition = '>=' | '==' | '%';
+export interface Breakpoint {
+    id: string;
+    type: BreakpointType;
+    state: BreakpointState;
+    resolved?: boolean;
+    filename?: string;
+    lineno?: number;
+    function?: string;
+    exception?: string;
+    expression?: string;
+    hitCount?: number;
+    hitValue?: number;
+    hitCondition?: HitCondition;
+}
+export interface StreamData {
+    type: 'stdout' | 'stderr';
+    encoding: string;
+    content: string;
+}
+export declare const DBGP_ERROR_CODES: {
+    readonly PARSE_ERROR: 1;
+    readonly DUPLICATE_ARGS: 2;
+    readonly INVALID_OPTIONS: 3;
+    readonly UNIMPLEMENTED_COMMAND: 4;
+    readonly COMMAND_NOT_AVAILABLE: 5;
+    readonly FILE_NOT_FOUND: 100;
+    readonly STREAM_REDIRECT_FAILED: 101;
+    readonly BREAKPOINT_NOT_SET: 200;
+    readonly BREAKPOINT_TYPE_NOT_SUPPORTED: 201;
+    readonly INVALID_BREAKPOINT_LINE: 202;
+    readonly NO_CODE_ON_LINE: 203;
+    readonly INVALID_BREAKPOINT_STATE: 204;
+    readonly NO_SUCH_BREAKPOINT: 205;
+    readonly EXPRESSION_ERROR: 206;
+    readonly PROPERTY_NOT_FOUND: 300;
+    readonly INVALID_STACK_DEPTH: 301;
+    readonly INVALID_CONTEXT: 302;
+    readonly ENCODING_NOT_SUPPORTED: 900;
+    readonly INTERNAL_ERROR: 998;
+    readonly UNKNOWN_ERROR: 999;
+};