xdebug-mcp 1.0.0

package/dist/session/debug-config.js

@@ -0,0 +1,194 @@
+/**
+ * Debug Configuration Manager
+ * Saves and restores debug configurations (breakpoints, watches, filters, etc.)
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+export class DebugConfigManager {
+    profiles = new Map();
+    configDir;
+    activeProfileName = null;
+    constructor(configDir) {
+        this.configDir = configDir || path.join(process.cwd(), '.xdebug-mcp');
+    }
+    /**
+     * Create a new debug profile
+     */
+    createProfile(name, description) {
+        const profile = {
+            name,
+            description,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            breakpoints: [],
+            watchExpressions: [],
+            logpoints: [],
+            stepFilters: [],
+            settings: {},
+        };
+        this.profiles.set(name, profile);
+        logger.info(`Debug profile created: ${name}`);
+        return profile;
+    }
+    /**
+     * Get a profile by name
+     */
+    getProfile(name) {
+        return this.profiles.get(name);
+    }
+    /**
+     * Get all profile names
+     */
+    getProfileNames() {
+        return Array.from(this.profiles.keys());
+    }
+    /**
+     * Get all profiles
+     */
+    getAllProfiles() {
+        return Array.from(this.profiles.values());
+    }
+    /**
+     * Update a profile
+     */
+    updateProfile(name, updates) {
+        const profile = this.profiles.get(name);
+        if (!profile)
+            return false;
+        Object.assign(profile, updates, { updatedAt: new Date() });
+        return true;
+    }
+    /**
+     * Delete a profile
+     */
+    deleteProfile(name) {
+        if (this.activeProfileName === name) {
+            this.activeProfileName = null;
+        }
+        return this.profiles.delete(name);
+    }
+    /**
+     * Set the active profile
+     */
+    setActiveProfile(name) {
+        if (this.profiles.has(name)) {
+            this.activeProfileName = name;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get the active profile
+     */
+    getActiveProfile() {
+        if (this.activeProfileName) {
+            return this.profiles.get(this.activeProfileName) || null;
+        }
+        return null;
+    }
+    /**
+     * Save all profiles to disk
+     */
+    async saveAllProfiles() {
+        try {
+            await fs.mkdir(this.configDir, { recursive: true });
+            const data = {
+                activeProfile: this.activeProfileName,
+                profiles: Array.from(this.profiles.entries()).map(([, profile]) => profile),
+            };
+            const filePath = path.join(this.configDir, 'profiles.json');
+            await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf8');
+            logger.info(`Saved ${this.profiles.size} profiles to ${filePath}`);
+        }
+        catch (error) {
+            logger.error('Failed to save profiles:', error);
+            throw error;
+        }
+    }
+    /**
+     * Load profiles from disk
+     */
+    async loadProfiles() {
+        try {
+            const filePath = path.join(this.configDir, 'profiles.json');
+            const content = await fs.readFile(filePath, 'utf8');
+            const data = JSON.parse(content);
+            this.profiles.clear();
+            for (const profile of data.profiles || []) {
+                this.profiles.set(profile.name, {
+                    ...profile,
+                    createdAt: new Date(profile.createdAt),
+                    updatedAt: new Date(profile.updatedAt),
+                });
+            }
+            this.activeProfileName = data.activeProfile || null;
+            logger.info(`Loaded ${this.profiles.size} profiles from ${filePath}`);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                logger.error('Failed to load profiles:', error);
+            }
+        }
+    }
+    /**
+     * Save a single profile to its own file
+     */
+    async saveProfile(name) {
+        const profile = this.profiles.get(name);
+        if (!profile) {
+            throw new Error(`Profile not found: ${name}`);
+        }
+        await fs.mkdir(this.configDir, { recursive: true });
+        const filePath = path.join(this.configDir, `${name}.profile.json`);
+        await fs.writeFile(filePath, JSON.stringify(profile, null, 2), 'utf8');
+        logger.info(`Saved profile to ${filePath}`);
+    }
+    /**
+     * Load a profile from file
+     */
+    async loadProfile(filePath) {
+        const content = await fs.readFile(filePath, 'utf8');
+        const profile = JSON.parse(content);
+        profile.createdAt = new Date(profile.createdAt);
+        profile.updatedAt = new Date(profile.updatedAt);
+        this.profiles.set(profile.name, profile);
+        return profile;
+    }
+    /**
+     * Export profile as JSON string
+     */
+    exportProfile(name) {
+        const profile = this.profiles.get(name);
+        if (!profile)
+            return null;
+        return JSON.stringify(profile, null, 2);
+    }
+    /**
+     * Import profile from JSON string
+     */
+    importProfile(json) {
+        const profile = JSON.parse(json);
+        profile.createdAt = new Date(profile.createdAt);
+        profile.updatedAt = new Date(profile.updatedAt);
+        this.profiles.set(profile.name, profile);
+        return profile;
+    }
+    /**
+     * Clone a profile
+     */
+    cloneProfile(sourceName, newName) {
+        const source = this.profiles.get(sourceName);
+        if (!source)
+            return null;
+        const clone = {
+            ...JSON.parse(JSON.stringify(source)),
+            name: newName,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+        };
+        this.profiles.set(newName, clone);
+        return clone;
+    }
+}
+//# sourceMappingURL=debug-config.js.map

package/dist/session/debug-config.js.map

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

package/dist/session/index.d.ts

@@ -0,0 +1,10 @@
+export * from './session.js';
+export * from './manager.js';
+export * from './watch-manager.js';
+export * from './logpoint-manager.js';
+export * from './profiler.js';
+export * from './request-context.js';
+export * from './step-filter.js';
+export * from './debug-config.js';
+export * from './code-coverage.js';
+export * from './session-export.js';

package/dist/session/index.js

@@ -0,0 +1,11 @@
+export * from './session.js';
+export * from './manager.js';
+export * from './watch-manager.js';
+export * from './logpoint-manager.js';
+export * from './profiler.js';
+export * from './request-context.js';
+export * from './step-filter.js';
+export * from './debug-config.js';
+export * from './code-coverage.js';
+export * from './session-export.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

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

@@ -0,0 +1,94 @@
+/**
+ * Logpoint Manager
+ * Manages logpoints - breakpoints that log without stopping execution.
+ */
+import { EventEmitter } from 'events';
+import { DebugSession } from './session.js';
+export interface Logpoint {
+    id: string;
+    breakpointId?: string;
+    file: string;
+    line: number;
+    message: string;
+    condition?: string;
+    hitCount: number;
+    lastHitAt?: Date;
+    createdAt: Date;
+    enabled: boolean;
+    logHistory: LogEntry[];
+}
+export interface LogEntry {
+    timestamp: Date;
+    message: string;
+    variables: Record<string, unknown>;
+    stackDepth: number;
+}
+export interface LogpointHit {
+    logpoint: Logpoint;
+    entry: LogEntry;
+}
+export declare class LogpointManager extends EventEmitter {
+    private logpoints;
+    private logpointIdCounter;
+    private maxHistoryPerLogpoint;
+    constructor();
+    /**
+     * Create a logpoint
+     * @param file File path
+     * @param line Line number
+     * @param message Message template with {varName} placeholders
+     * @param condition Optional condition
+     */
+    createLogpoint(file: string, line: number, message: string, condition?: string): Logpoint;
+    removeLogpoint(id: string): boolean;
+    getLogpoint(id: string): Logpoint | undefined;
+    getAllLogpoints(): Logpoint[];
+    /**
+     * Find logpoint by file and line
+     */
+    findLogpoint(file: string, line: number): Logpoint | undefined;
+    /**
+     * Process a logpoint hit - evaluate and log the message
+     */
+    processHit(session: DebugSession, logpoint: Logpoint, stackDepth?: number): Promise<LogEntry>;
+    /**
+     * Get hit statistics for all logpoints
+     */
+    getStatistics(): {
+        totalLogpoints: number;
+        totalHits: number;
+        logpoints: Array<{
+            id: string;
+            file: string;
+            line: number;
+            hitCount: number;
+            lastHitAt?: Date;
+        }>;
+    };
+    /**
+     * Get log history for a specific logpoint
+     */
+    getLogHistory(id: string, limit?: number): LogEntry[];
+    /**
+     * Clear log history for all logpoints
+     */
+    clearHistory(): void;
+    /**
+     * Export configuration
+     */
+    exportConfig(): Array<{
+        file: string;
+        line: number;
+        message: string;
+        condition?: string;
+    }>;
+    /**
+     * Import configuration
+     */
+    importConfig(config: Array<{
+        file: string;
+        line: number;
+        message: string;
+        condition?: string;
+    }>): void;
+}

package/dist/session/logpoint-manager.js

@@ -0,0 +1,167 @@
+/**
+ * Logpoint Manager
+ * Manages logpoints - breakpoints that log without stopping execution.
+ */
+import { EventEmitter } from 'events';
+import { logger } from '../utils/logger.js';
+export class LogpointManager extends EventEmitter {
+    logpoints = new Map();
+    logpointIdCounter = 0;
+    maxHistoryPerLogpoint = 100;
+    constructor() {
+        super();
+    }
+    /**
+     * Create a logpoint
+     * @param file File path
+     * @param line Line number
+     * @param message Message template with {varName} placeholders
+     * @param condition Optional condition
+     */
+    createLogpoint(file, line, message, condition) {
+        const id = `logpoint_${++this.logpointIdCounter}`;
+        const logpoint = {
+            id,
+            file,
+            line,
+            message,
+            condition,
+            hitCount: 0,
+            createdAt: new Date(),
+            enabled: true,
+            logHistory: [],
+        };
+        this.logpoints.set(id, logpoint);
+        logger.debug(`Logpoint created: ${id} at ${file}:${line}`);
+        return logpoint;
+    }
+    removeLogpoint(id) {
+        const removed = this.logpoints.delete(id);
+        if (removed) {
+            logger.debug(`Logpoint removed: ${id}`);
+        }
+        return removed;
+    }
+    getLogpoint(id) {
+        return this.logpoints.get(id);
+    }
+    getAllLogpoints() {
+        return Array.from(this.logpoints.values());
+    }
+    /**
+     * Find logpoint by file and line
+     */
+    findLogpoint(file, line) {
+        for (const lp of this.logpoints.values()) {
+            if (lp.file === file && lp.line === line) {
+                return lp;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Process a logpoint hit - evaluate and log the message
+     */
+    async processHit(session, logpoint, stackDepth = 0) {
+        // Extract variable names from message template
+        const varPattern = /\{([^}]+)\}/g;
+        const variables = {};
+        let evaluatedMessage = logpoint.message;
+        // Find all {varName} placeholders
+        let match;
+        const varNames = [];
+        while ((match = varPattern.exec(logpoint.message)) !== null) {
+            varNames.push(match[1]);
+        }
+        // Evaluate each variable
+        for (const varName of varNames) {
+            try {
+                const result = await session.evaluate(varName, stackDepth);
+                const value = result?.value ?? result?.type ?? 'undefined';
+                variables[varName] = value;
+                evaluatedMessage = evaluatedMessage.replace(`{${varName}}`, String(value));
+            }
+            catch {
+                variables[varName] = '<error>';
+                evaluatedMessage = evaluatedMessage.replace(`{${varName}}`, '<error>');
+            }
+        }
+        const entry = {
+            timestamp: new Date(),
+            message: evaluatedMessage,
+            variables,
+            stackDepth,
+        };
+        // Update logpoint state
+        logpoint.hitCount++;
+        logpoint.lastHitAt = new Date();
+        logpoint.logHistory.push(entry);
+        // Trim history if too large
+        if (logpoint.logHistory.length > this.maxHistoryPerLogpoint) {
+            logpoint.logHistory = logpoint.logHistory.slice(-this.maxHistoryPerLogpoint);
+        }
+        this.emit('logpointHit', { logpoint, entry });
+        logger.info(`[Logpoint ${logpoint.id}] ${evaluatedMessage}`);
+        return entry;
+    }
+    /**
+     * Get hit statistics for all logpoints
+     */
+    getStatistics() {
+        const logpoints = this.getAllLogpoints();
+        const totalHits = logpoints.reduce((sum, lp) => sum + lp.hitCount, 0);
+        return {
+            totalLogpoints: logpoints.length,
+            totalHits,
+            logpoints: logpoints.map((lp) => ({
+                id: lp.id,
+                file: lp.file,
+                line: lp.line,
+                hitCount: lp.hitCount,
+                lastHitAt: lp.lastHitAt,
+            })),
+        };
+    }
+    /**
+     * Get log history for a specific logpoint
+     */
+    getLogHistory(id, limit) {
+        const logpoint = this.logpoints.get(id);
+        if (!logpoint)
+            return [];
+        const history = logpoint.logHistory;
+        if (limit && limit < history.length) {
+            return history.slice(-limit);
+        }
+        return history;
+    }
+    /**
+     * Clear log history for all logpoints
+     */
+    clearHistory() {
+        for (const lp of this.logpoints.values()) {
+            lp.logHistory = [];
+            lp.hitCount = 0;
+        }
+    }
+    /**
+     * Export configuration
+     */
+    exportConfig() {
+        return this.getAllLogpoints().map((lp) => ({
+            file: lp.file,
+            line: lp.line,
+            message: lp.message,
+            condition: lp.condition,
+        }));
+    }
+    /**
+     * Import configuration
+     */
+    importConfig(config) {
+        for (const item of config) {
+            this.createLogpoint(item.file, item.line, item.message, item.condition);
+        }
+    }
+}
+//# sourceMappingURL=logpoint-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logpoint-manager.js","sourceRoot":"","sources":["../../src/session/logpoint-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA4B5C,MAAM,OAAO,eAAgB,SAAQ,YAAY;IACvC,SAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;IAC7C,iBAAiB,GAAW,CAAC,CAAC;IAC9B,qBAAqB,GAAW,GAAG,CAAC;IAE5C;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CACZ,IAAY,EACZ,IAAY,EACZ,OAAe,EACf,SAAkB;QAElB,MAAM,EAAE,GAAG,YAAY,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAa;YACzB,EAAE;YACF,IAAI;YACJ,IAAI;YACJ,OAAO;YACP,SAAS;YACT,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,EAAE;SACf,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,OAAO,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3D,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,cAAc,CAAC,EAAU;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAY,EAAE,IAAY;QACrC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBACzC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CACd,OAAqB,EACrB,QAAkB,EAClB,aAAqB,CAAC;QAEtB,+CAA+C;QAC/C,MAAM,UAAU,GAAG,cAAc,CAAC;QAClC,MAAM,SAAS,GAA4B,EAAE,CAAC;QAC9C,IAAI,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC;QAExC,kCAAkC;QAClC,IAAI,KAAK,CAAC;QACV,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5D,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QAED,yBAAyB;QACzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBAC3D,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE,IAAI,IAAI,WAAW,CAAC;gBAC3D,SAAS,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;gBAC3B,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7E,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;gBAC/B,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,EAAE,SAAS,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAa;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,OAAO,EAAE,gBAAgB;YACzB,SAAS;YACT,UAAU;SACX,CAAC;QAEF,wBAAwB;QACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpB,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAChC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhC,4BAA4B;QAC5B,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC5D,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAiB,CAAC,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,EAAE,KAAK,gBAAgB,EAAE,CAAC,CAAC;QAE7D,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,aAAa;QAWX,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAEtE,OAAO;YACL,cAAc,EAAE,SAAS,CAAC,MAAM;YAChC,SAAS;YACT,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAChC,EAAE,EAAE,EAAE,CAAC,EAAE;gBACT,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,SAAS,EAAE,EAAE,CAAC,SAAS;aACxB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,EAAU,EAAE,KAAc;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;QAEzB,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC;QACpC,IAAI,KAAK,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YACzC,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC;YACnB,EAAE,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,OAAO,EAAE,EAAE,CAAC,OAAO;YACnB,SAAS,EAAE,EAAE,CAAC,SAAS;SACxB,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,YAAY,CACV,MAAkF;QAElF,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;CACF"}

package/dist/session/manager.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Session Manager
+ * Manages multiple concurrent PHP debug sessions.
+ */
+import { EventEmitter } from 'events';
+import { DbgpConnection } from '../dbgp/connection.js';
+import { DebugSession, SessionState } from './session.js';
+export interface SessionManagerEvents {
+    sessionCreated: (session: DebugSession) => void;
+    sessionEnded: (sessionId: string) => void;
+    sessionStateChange: (sessionId: string, state: SessionState) => void;
+}
+export declare class SessionManager extends EventEmitter {
+    private sessions;
+    private activeSessionId;
+    constructor();
+    createSession(connection: DbgpConnection): Promise<DebugSession>;
+    getSession(id: string): DebugSession | undefined;
+    getAllSessions(): DebugSession[];
+    getSessionStates(): SessionState[];
+    getActiveSession(): DebugSession | undefined;
+    setActiveSession(id: string): boolean;
+    getActiveSessionId(): string | null;
+    /**
+     * Get a session by ID or return the active session if no ID provided.
+     * This is the primary method for tools to get a session.
+     */
+    resolveSession(sessionId?: string): DebugSession | undefined;
+    closeSession(id: string): boolean;
+    closeAllSessions(): void;
+    getSessionCount(): number;
+    hasActiveSessions(): boolean;
+    /**
+     * Find sessions by file being debugged
+     */
+    findSessionsByFile(filename: string): DebugSession[];
+    /**
+     * Find sessions by IDE key
+     */
+    findSessionsByIdeKey(ideKey: string): DebugSession[];
+}

package/dist/session/manager.js

@@ -0,0 +1,135 @@
+/**
+ * Session Manager
+ * Manages multiple concurrent PHP debug sessions.
+ */
+import { EventEmitter } from 'events';
+import { DebugSession } from './session.js';
+import { logger } from '../utils/logger.js';
+export class SessionManager extends EventEmitter {
+    sessions = new Map();
+    activeSessionId = null;
+    constructor() {
+        super();
+    }
+    async createSession(connection) {
+        const session = new DebugSession(connection);
+        // Initialize the session (negotiate features)
+        await session.initialize();
+        this.sessions.set(session.id, session);
+        // Track state changes
+        session.on('stateChange', (state) => {
+            this.emit('sessionStateChange', session.id, state);
+            // Auto-select as active if it's in break state and no active session
+            if (state.status === 'break' && !this.activeSessionId) {
+                this.activeSessionId = session.id;
+            }
+        });
+        // Handle session close
+        session.on('close', () => {
+            this.sessions.delete(session.id);
+            if (this.activeSessionId === session.id) {
+                this.activeSessionId = null;
+                // Select another session if available
+                const next = this.sessions.values().next().value;
+                if (next) {
+                    this.activeSessionId = next.id;
+                }
+            }
+            this.emit('sessionEnded', session.id);
+            logger.info(`Session ended: ${session.id}`);
+        });
+        // Set as active if it's the first session
+        if (!this.activeSessionId) {
+            this.activeSessionId = session.id;
+        }
+        this.emit('sessionCreated', session);
+        logger.info(`Session created: ${session.id}`);
+        return session;
+    }
+    getSession(id) {
+        return this.sessions.get(id);
+    }
+    getAllSessions() {
+        return Array.from(this.sessions.values());
+    }
+    getSessionStates() {
+        return this.getAllSessions().map((s) => s.getState());
+    }
+    getActiveSession() {
+        if (this.activeSessionId) {
+            return this.sessions.get(this.activeSessionId);
+        }
+        // Return first session in 'break' state, or first available
+        for (const session of this.sessions.values()) {
+            if (session.status === 'break') {
+                this.activeSessionId = session.id;
+                return session;
+            }
+        }
+        // Return first available session
+        const first = this.sessions.values().next().value;
+        if (first) {
+            this.activeSessionId = first.id;
+        }
+        return first;
+    }
+    setActiveSession(id) {
+        if (this.sessions.has(id)) {
+            this.activeSessionId = id;
+            return true;
+        }
+        return false;
+    }
+    getActiveSessionId() {
+        return this.activeSessionId;
+    }
+    /**
+     * Get a session by ID or return the active session if no ID provided.
+     * This is the primary method for tools to get a session.
+     */
+    resolveSession(sessionId) {
+        if (sessionId) {
+            return this.getSession(sessionId);
+        }
+        return this.getActiveSession();
+    }
+    closeSession(id) {
+        const session = this.sessions.get(id);
+        if (session) {
+            session.close();
+            // The 'close' event handler will remove it from the map
+            return true;
+        }
+        return false;
+    }
+    closeAllSessions() {
+        for (const session of this.sessions.values()) {
+            session.close();
+        }
+        // The 'close' event handlers will clear the map
+    }
+    getSessionCount() {
+        return this.sessions.size;
+    }
+    hasActiveSessions() {
+        return this.sessions.size > 0;
+    }
+    /**
+     * Find sessions by file being debugged
+     */
+    findSessionsByFile(filename) {
+        const normalized = filename.toLowerCase();
+        return this.getAllSessions().filter((session) => {
+            const initFile = session.initPacket?.fileUri?.toLowerCase() || '';
+            const currentFile = session.currentFile?.toLowerCase() || '';
+            return initFile.includes(normalized) || currentFile.includes(normalized);
+        });
+    }
+    /**
+     * Find sessions by IDE key
+     */
+    findSessionsByIdeKey(ideKey) {
+        return this.getAllSessions().filter((session) => session.initPacket?.ideKey === ideKey);
+    }
+}
+//# sourceMappingURL=manager.js.map