agentic-qe 1.0.0 → 1.0.2

package/dist/cli/commands/agent/detach.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Agent Detach Command
+ *
+ * Detaches from an active agent console session, cleaning up resources
+ * and saving session data. Supports graceful detachment with statistics.
+ *
+ * @module cli/commands/agent/detach
+ */
+export interface DetachOptions {
+    agentId: string;
+    saveSession?: boolean;
+    showStats?: boolean;
+    force?: boolean;
+}
+export interface DetachResult {
+    agentId: string;
+    sessionId: string;
+    detachedAt: Date;
+    duration: number;
+    stats: {
+        logsReceived: number;
+        eventsReceived: number;
+        metricsReceived: number;
+    };
+    sessionSaved: boolean;
+}
+/**
+ * Agent Detach Command Implementation
+ */
+export declare class AgentDetachCommand {
+    private static readonly SESSIONS_DIR;
+    private static readonly ARCHIVE_DIR;
+    /**
+     * Execute agent detach
+     *
+     * @param options - Detach options
+     * @returns Detach result
+     */
+    static execute(options: DetachOptions): Promise<DetachResult>;
+    /**
+     * Stop monitoring activities
+     */
+    private static stopMonitoring;
+    /**
+     * Display session statistics
+     */
+    private static displaySessionStats;
+    /**
+     * Archive session data
+     */
+    private static archiveSession;
+    /**
+     * Cleanup session metadata
+     */
+    private static cleanupSession;
+    /**
+     * Create force detach result
+     */
+    private static createForceDetachResult;
+    /**
+     * Detach all active sessions
+     */
+    static detachAll(options: {
+        saveSession?: boolean;
+        showStats?: boolean;
+    }): Promise<DetachResult[]>;
+    /**
+     * Get archived sessions
+     */
+    static getArchivedSessions(limit?: number): Promise<any[]>;
+    /**
+     * Clean up old archived sessions
+     */
+    static cleanupOldSessions(olderThanDays: number): Promise<number>;
+}
+//# sourceMappingURL=detach.d.ts.map

package/dist/cli/commands/agent/detach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/agent/detach.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAgD;IACpF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA2C;IAE9E;;;;;OAKG;WACU,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA0EnE;;OAEG;mBACkB,cAAc;IAkBnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAalC;;OAEG;mBACkB,cAAc;IAoBnC;;OAEG;mBACkB,cAAc;IAanC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAetC;;OAEG;WACU,SAAS,CAAC,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwBxG;;OAEG;WACU,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAqBhE;;OAEG;WACU,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA0BxE"}

package/dist/cli/commands/agent/detach.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Agent Detach Command
+ *
+ * Detaches from an active agent console session, cleaning up resources
+ * and saving session data. Supports graceful detachment with statistics.
+ *
+ * @module cli/commands/agent/detach
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentDetachCommand = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const attach_1 = require("./attach");
+const Logger_1 = require("../../../utils/Logger");
+const logger = Logger_1.Logger.getInstance();
+/**
+ * Agent Detach Command Implementation
+ */
+class AgentDetachCommand {
+    /**
+     * Execute agent detach
+     *
+     * @param options - Detach options
+     * @returns Detach result
+     */
+    static async execute(options) {
+        const { agentId, saveSession = true, showStats = true, force = false } = options;
+        logger.info(`Detaching from agent: ${agentId}`, { saveSession, force });
+        try {
+            // Get active session
+            const session = attach_1.AgentAttachCommand.getActiveSession(agentId);
+            if (!session) {
+                if (force) {
+                    logger.warn(`No active session found for agent: ${agentId}, force detaching`);
+                    return this.createForceDetachResult(agentId);
+                }
+                throw new Error(`Not attached to agent: ${agentId}`);
+            }
+            // Calculate session duration
+            const duration = Date.now() - session.attachedAt.getTime();
+            // Stop monitoring
+            await this.stopMonitoring(session);
+            // Update session status
+            session.status = 'detached';
+            // Display stats if requested
+            if (showStats) {
+                this.displaySessionStats(session, duration);
+            }
+            // Save session data
+            let sessionSaved = false;
+            if (saveSession) {
+                await this.archiveSession(session, duration);
+                sessionSaved = true;
+            }
+            // Clean up session metadata
+            await this.cleanupSession(session);
+            const result = {
+                agentId,
+                sessionId: session.sessionId,
+                detachedAt: new Date(),
+                duration,
+                stats: { ...session.stats },
+                sessionSaved
+            };
+            logger.info(`Detached from agent: ${agentId}`, {
+                sessionId: session.sessionId,
+                duration: `${(duration / 1000).toFixed(2)}s`
+            });
+            return result;
+        }
+        catch (error) {
+            logger.error(`Failed to detach from agent ${agentId}:`, error);
+            if (force) {
+                logger.warn('Force detaching despite error');
+                return this.createForceDetachResult(agentId);
+            }
+            throw new Error(`Agent detach failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Stop monitoring activities
+     */
+    static async stopMonitoring(session) {
+        // Clear all intervals
+        const intervals = ['logInterval', 'metricsInterval', 'eventsInterval'];
+        for (const intervalName of intervals) {
+            const interval = session[intervalName];
+            if (interval) {
+                clearInterval(interval);
+                delete session[intervalName];
+            }
+        }
+        // Remove all event listeners
+        session.events.removeAllListeners();
+        logger.debug(`Stopped monitoring for session: ${session.sessionId}`);
+    }
+    /**
+     * Display session statistics
+     */
+    static displaySessionStats(session, duration) {
+        console.log('\n' + '='.repeat(60));
+        console.log('📊 Session Statistics');
+        console.log('='.repeat(60));
+        console.log(`Agent ID: ${session.agentId}`);
+        console.log(`Session ID: ${session.sessionId}`);
+        console.log(`Duration: ${(duration / 1000).toFixed(2)}s`);
+        console.log(`Logs Received: ${session.stats.logsReceived}`);
+        console.log(`Events Received: ${session.stats.eventsReceived}`);
+        console.log(`Metrics Received: ${session.stats.metricsReceived}`);
+        console.log('='.repeat(60) + '\n');
+    }
+    /**
+     * Archive session data
+     */
+    static async archiveSession(session, duration) {
+        await fs.ensureDir(this.ARCHIVE_DIR);
+        const archivePath = path.join(this.ARCHIVE_DIR, `${session.sessionId}.json`);
+        const archiveData = {
+            sessionId: session.sessionId,
+            agentId: session.agentId,
+            attachedAt: session.attachedAt.toISOString(),
+            detachedAt: new Date().toISOString(),
+            duration,
+            stats: session.stats,
+            status: 'completed'
+        };
+        await fs.writeJson(archivePath, archiveData, { spaces: 2 });
+        logger.debug(`Session archived: ${archivePath}`);
+    }
+    /**
+     * Cleanup session metadata
+     */
+    static async cleanupSession(session) {
+        const sessionPath = path.join(this.SESSIONS_DIR, `${session.sessionId}.json`);
+        if (await fs.pathExists(sessionPath)) {
+            await fs.remove(sessionPath);
+            logger.debug(`Session metadata cleaned: ${sessionPath}`);
+        }
+        // Remove from active sessions
+        // This assumes access to the private activeSessions map
+        // In production, would need proper API access
+    }
+    /**
+     * Create force detach result
+     */
+    static createForceDetachResult(agentId) {
+        return {
+            agentId,
+            sessionId: 'unknown',
+            detachedAt: new Date(),
+            duration: 0,
+            stats: {
+                logsReceived: 0,
+                eventsReceived: 0,
+                metricsReceived: 0
+            },
+            sessionSaved: false
+        };
+    }
+    /**
+     * Detach all active sessions
+     */
+    static async detachAll(options) {
+        const activeSessions = attach_1.AgentAttachCommand.getAllActiveSessions();
+        logger.info(`Detaching from all active sessions (${activeSessions.length})`);
+        const results = [];
+        for (const session of activeSessions) {
+            try {
+                const result = await this.execute({
+                    agentId: session.agentId,
+                    saveSession: options.saveSession,
+                    showStats: options.showStats,
+                    force: false
+                });
+                results.push(result);
+            }
+            catch (error) {
+                logger.error(`Failed to detach from agent ${session.agentId}:`, error);
+            }
+        }
+        return results;
+    }
+    /**
+     * Get archived sessions
+     */
+    static async getArchivedSessions(limit) {
+        await fs.ensureDir(this.ARCHIVE_DIR);
+        const files = await fs.readdir(this.ARCHIVE_DIR);
+        const jsonFiles = files.filter(f => f.endsWith('.json'));
+        const sessions = await Promise.all(jsonFiles.map(async (file) => {
+            const filePath = path.join(this.ARCHIVE_DIR, file);
+            return await fs.readJson(filePath);
+        }));
+        // Sort by detached time descending
+        sessions.sort((a, b) => new Date(b.detachedAt).getTime() - new Date(a.detachedAt).getTime());
+        return limit ? sessions.slice(0, limit) : sessions;
+    }
+    /**
+     * Clean up old archived sessions
+     */
+    static async cleanupOldSessions(olderThanDays) {
+        await fs.ensureDir(this.ARCHIVE_DIR);
+        const files = await fs.readdir(this.ARCHIVE_DIR);
+        const cutoffTime = Date.now() - (olderThanDays * 24 * 60 * 60 * 1000);
+        let cleaned = 0;
+        for (const file of files) {
+            if (!file.endsWith('.json'))
+                continue;
+            const filePath = path.join(this.ARCHIVE_DIR, file);
+            const session = await fs.readJson(filePath);
+            const detachedAt = new Date(session.detachedAt).getTime();
+            if (detachedAt < cutoffTime) {
+                await fs.remove(filePath);
+                cleaned++;
+            }
+        }
+        logger.info(`Cleaned up ${cleaned} old archived sessions`);
+        return cleaned;
+    }
+}
+exports.AgentDetachCommand = AgentDetachCommand;
+_a = AgentDetachCommand;
+AgentDetachCommand.SESSIONS_DIR = path.join(process.cwd(), '.aqe', 'sessions');
+AgentDetachCommand.ARCHIVE_DIR = path.join(_a.SESSIONS_DIR, 'archive');
+//# sourceMappingURL=detach.js.map

package/dist/cli/commands/agent/detach.js.map

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

package/dist/cli/commands/agent/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Agent Commands Index
+ *
+ * Exports all agent management commands for CLI integration.
+ * Complete suite of 10+ agent lifecycle and monitoring commands.
+ *
+ * @module cli/commands/agent
+ */
+export { AgentRestartCommand, RestartOptions, RestartResult } from './restart';
+export { AgentInspectCommand, InspectOptions, InspectResult } from './inspect';
+export { AgentAssignCommand, AssignOptions, AssignResult } from './assign';
+export { AgentAttachCommand, AttachOptions, AttachSession } from './attach';
+export { AgentDetachCommand, DetachOptions, DetachResult } from './detach';
+/**
+ * Command Categories
+ */
+export declare const AGENT_COMMANDS: {
+    readonly lifecycle: readonly ["spawn", "kill", "restart"];
+    readonly monitoring: readonly ["list", "metrics", "logs", "inspect"];
+    readonly tasks: readonly ["assign"];
+    readonly interactive: readonly ["attach", "detach"];
+};
+/**
+ * Get all available agent commands
+ */
+export declare function getAvailableCommands(): string[];
+/**
+ * Get commands by category
+ */
+export declare function getCommandsByCategory(category: keyof typeof AGENT_COMMANDS): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAM/E,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG/E,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,OAAO,cAAc,GAAG,MAAM,EAAE,CAErF"}

package/dist/cli/commands/agent/index.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Agent Commands Index
+ *
+ * Exports all agent management commands for CLI integration.
+ * Complete suite of 10+ agent lifecycle and monitoring commands.
+ *
+ * @module cli/commands/agent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_COMMANDS = exports.AgentDetachCommand = exports.AgentAttachCommand = exports.AgentAssignCommand = exports.AgentInspectCommand = exports.AgentRestartCommand = void 0;
+exports.getAvailableCommands = getAvailableCommands;
+exports.getCommandsByCategory = getCommandsByCategory;
+// Core lifecycle commands
+// export { AgentSpawnCommand } from './spawn';
+// export { AgentKillCommand } from './kill';
+var restart_1 = require("./restart");
+Object.defineProperty(exports, "AgentRestartCommand", { enumerable: true, get: function () { return restart_1.AgentRestartCommand; } });
+// Information and monitoring commands
+// export { AgentListCommand } from './list';
+// export { AgentMetricsCommand } from './metrics';
+// export { AgentLogsCommand } from './logs';
+var inspect_1 = require("./inspect");
+Object.defineProperty(exports, "AgentInspectCommand", { enumerable: true, get: function () { return inspect_1.AgentInspectCommand; } });
+// Task management commands
+var assign_1 = require("./assign");
+Object.defineProperty(exports, "AgentAssignCommand", { enumerable: true, get: function () { return assign_1.AgentAssignCommand; } });
+// Interactive monitoring commands
+var attach_1 = require("./attach");
+Object.defineProperty(exports, "AgentAttachCommand", { enumerable: true, get: function () { return attach_1.AgentAttachCommand; } });
+var detach_1 = require("./detach");
+Object.defineProperty(exports, "AgentDetachCommand", { enumerable: true, get: function () { return detach_1.AgentDetachCommand; } });
+/**
+ * Command Categories
+ */
+exports.AGENT_COMMANDS = {
+    lifecycle: ['spawn', 'kill', 'restart'],
+    monitoring: ['list', 'metrics', 'logs', 'inspect'],
+    tasks: ['assign'],
+    interactive: ['attach', 'detach']
+};
+/**
+ * Get all available agent commands
+ */
+function getAvailableCommands() {
+    return Object.values(exports.AGENT_COMMANDS).flatMap(arr => [...arr]);
+}
+/**
+ * Get commands by category
+ */
+function getCommandsByCategory(category) {
+    return [...exports.AGENT_COMMANDS[category]];
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/agent/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAiCH,oDAEC;AAKD,sDAEC;AAxCD,0BAA0B;AAC1B,+CAA+C;AAC/C,6CAA6C;AAC7C,qCAA+E;AAAtE,8GAAA,mBAAmB,OAAA;AAE5B,sCAAsC;AACtC,6CAA6C;AAC7C,mDAAmD;AACnD,6CAA6C;AAC7C,qCAA+E;AAAtE,8GAAA,mBAAmB,OAAA;AAE5B,2BAA2B;AAC3B,mCAA2E;AAAlE,4GAAA,kBAAkB,OAAA;AAE3B,kCAAkC;AAClC,mCAA4E;AAAnE,4GAAA,kBAAkB,OAAA;AAC3B,mCAA2E;AAAlE,4GAAA,kBAAkB,OAAA;AAE3B;;GAEG;AACU,QAAA,cAAc,GAAG;IAC5B,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;IACvC,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC;IAClD,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,WAAW,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;CACzB,CAAC;AAEX;;GAEG;AACH,SAAgB,oBAAoB;IAClC,OAAO,MAAM,CAAC,MAAM,CAAC,sBAAc,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,QAAqC;IACzE,OAAO,CAAC,GAAG,sBAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/cli/commands/agent/inspect.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Agent Inspect Command
+ *
+ * Provides detailed inspection of agent configuration, state, metrics,
+ * and history. Supports multiple output formats and filtering options.
+ *
+ * @module cli/commands/agent/inspect
+ */
+export interface InspectOptions {
+    agentId: string;
+    includeHistory?: boolean;
+    includeMetrics?: boolean;
+    includeLogs?: boolean;
+    format?: 'json' | 'yaml' | 'table' | 'detailed';
+    depth?: 'shallow' | 'deep';
+}
+export interface InspectResult {
+    id: string;
+    type: string;
+    mcpType: string;
+    status: string;
+    configuration: {
+        name?: string;
+        description?: string;
+        capabilities: string[];
+        resources?: any;
+    };
+    lifecycle: {
+        spawnedAt: Date;
+        lastActivity: Date;
+        uptime: number;
+        restartCount?: number;
+        lastRestart?: string;
+    };
+    metrics?: {
+        tasksCompleted: number;
+        tasksActive: number;
+        tasksFailed: number;
+        averageExecutionTime: number;
+        totalExecutionTime: number;
+        successRate: number;
+    };
+    history?: Array<{
+        timestamp: Date;
+        event: string;
+        details: any;
+    }>;
+    logs?: string[];
+    health: {
+        status: 'healthy' | 'degraded' | 'unhealthy';
+        issues: string[];
+        lastCheck: Date;
+    };
+}
+/**
+ * Agent Inspect Command Implementation
+ */
+export declare class AgentInspectCommand {
+    private static readonly AGENT_DIR;
+    private static readonly LOGS_DIR;
+    private static readonly HISTORY_DIR;
+    /**
+     * Execute agent inspection
+     *
+     * @param options - Inspect options
+     * @returns Detailed agent information
+     */
+    static execute(options: InspectOptions): Promise<InspectResult>;
+    /**
+     * Read agent configuration
+     */
+    private static readAgentConfig;
+    /**
+     * Get agent metrics
+     */
+    private static getMetrics;
+    /**
+     * Count failed tasks
+     */
+    private static countFailedTasks;
+    /**
+     * Get agent history
+     */
+    private static getHistory;
+    /**
+     * Get agent logs
+     */
+    private static getLogs;
+    /**
+     * Check agent health
+     */
+    private static checkHealth;
+    /**
+     * Format output
+     */
+    private static formatOutput;
+    /**
+     * Format as table
+     */
+    private static formatAsTable;
+    /**
+     * Format as YAML
+     */
+    private static formatAsYAML;
+    /**
+     * Format detailed
+     */
+    private static formatDetailed;
+}
+//# sourceMappingURL=inspect.d.ts.map

package/dist/cli/commands/agent/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/agent/inspect.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAChD,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,SAAS,CAAC,EAAE,GAAG,CAAC;KACjB,CAAC;IACF,SAAS,EAAE;QACT,SAAS,EAAE,IAAI,CAAC;QAChB,YAAY,EAAE,IAAI,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,SAAS,EAAE,IAAI,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,GAAG,CAAC;KACd,CAAC,CAAC;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE;QACN,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;QAC7C,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,SAAS,EAAE,IAAI,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAA8C;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IAC5E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAA+C;IAElF;;;;;OAKG;WACU,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwErE;;OAEG;mBACkB,eAAe;IAOpC;;OAEG;mBACkB,UAAU;IAsB/B;;OAEG;mBACkB,gBAAgB;IAWrC;;OAEG;mBACkB,UAAU;IAe/B;;OAEG;mBACkB,OAAO;IAc5B;;OAEG;mBACkB,WAAW;IA8BhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAsB3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAqB5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAmB3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;CAG9B"}