@plusplusoneplusplus/coc 1.0.0

package/node_modules/@plusplusoneplusplus/forge/dist/utils/pipeline-template.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Template Engine
+ *
+ * Simple template substitution for pipeline prompts.
+ * Replaces {{column}} placeholders with values from pipeline items.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import type { PromptItem } from '../ai/types';
+import { PipelineCoreError } from '../errors';
+/**
+ * Error thrown when a template variable is missing
+ */
+export declare class TemplateError extends PipelineCoreError {
+    /** Name of the variable that caused the error */
+    readonly variableName?: string;
+    constructor(message: string, variableName?: string);
+}
+/**
+ * Options for template substitution
+ */
+export interface SubstituteTemplateOptions {
+    /** If true, throws on missing variables; if false, leaves as empty string */
+    strict?: boolean;
+    /** All items in the input (for {{ITEMS}} template variable) */
+    allItems?: PromptItem[];
+}
+/**
+ * Substitute template variables with values from a pipeline item
+ *
+ * Supports special variable {{ITEMS}} which is replaced with JSON array of all items.
+ * This allows prompts to reference the full context of all items being processed.
+ *
+ * @param template Template string with {{variable}} placeholders
+ * @param item Pipeline item containing values
+ * @param strictOrOptions If boolean, strict mode; if object, full options
+ * @returns Substituted string
+ */
+export declare function substituteTemplate(template: string, item: PromptItem, strictOrOptions?: boolean | SubstituteTemplateOptions): string;
+/**
+ * Extract all variable names from a template
+ * @param template Template string
+ * @param excludeSpecial If true, excludes special system variables (ITEMS, RESULTS, etc.)
+ * @returns Array of unique variable names
+ */
+export declare function extractVariables(template: string, excludeSpecial?: boolean): string[];
+/**
+ * Validate that a pipeline item has all required template variables
+ * @param template Template string
+ * @param item Pipeline item to validate
+ * @returns Object with validation result and missing variables
+ */
+export declare function validateItemForTemplate(template: string, item: PromptItem): {
+    valid: boolean;
+    missingVariables: string[];
+};
+/**
+ * Build the full prompt for AI by appending output field instructions
+ * @param userPrompt User's prompt template (already substituted)
+ * @param outputFields Field names expected in AI response
+ * @returns Full prompt with JSON output instruction
+ */
+export declare function buildFullPrompt(userPrompt: string, outputFields: string[]): string;
+/**
+ * Build a complete prompt from template, item, and output fields
+ * Combines template substitution and output instruction appending
+ * @param template Prompt template with {{variable}} placeholders
+ * @param item Pipeline item with values
+ * @param outputFields Expected output field names
+ * @param strict Strict mode for variable validation
+ * @returns Complete prompt ready for AI
+ */
+export declare function buildPromptFromTemplate(template: string, item: PromptItem, outputFields: string[], strict?: boolean): string;
+/**
+ * Parse JSON response from AI, extracting only the declared fields
+ * Wrapper that adds TemplateError for backward compatibility
+ * @param response AI response string
+ * @param outputFields Expected field names
+ * @returns Object with extracted fields (missing fields become null)
+ */
+export declare function parseAIResponse(response: string, outputFields: string[]): Record<string, unknown>;
+/**
+ * Extract JSON from a response string
+ * Re-exported from shared utilities
+ * @param response Response string
+ * @returns Extracted JSON string or null
+ */
+export declare function extractJSON(response: string): string | null;
+/**
+ * Escape special characters in a value for safe template use
+ * @param value Value to escape
+ * @returns Escaped value
+ */
+export declare function escapeTemplateValue(value: string): string;
+/**
+ * Preview how a template will render with sample values
+ * @param template Template string
+ * @param item Sample item
+ * @param maxLength Maximum output length
+ * @param allItems Optional array of all items (for {{ITEMS}} variable preview)
+ * @returns Preview string
+ */
+export declare function previewTemplate(template: string, item: PromptItem, maxLength?: number, allItems?: PromptItem[]): string;
+//# sourceMappingURL=pipeline-template.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/pipeline-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-template.d.ts","sourceRoot":"","sources":["../../src/utils/pipeline-template.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAY9C,OAAO,EAAE,iBAAiB,EAAa,MAAM,WAAW,CAAC;AAEzD;;GAEG;AACH,qBAAa,aAAc,SAAQ,iBAAiB;IAChD,iDAAiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG3B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM;CAS5B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,eAAe,GAAE,OAAO,GAAG,yBAAiC,GAC7D,MAAM,CAsCR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,GAAE,OAAc,GAAG,MAAM,EAAE,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,GACjB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CASlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,GAAE,OAAe,GACxB,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,SAAS,GAAE,MAAY,EACvB,QAAQ,CAAC,EAAE,UAAU,EAAE,GACxB,MAAM,CAUR"}

package/node_modules/@plusplusoneplusplus/forge/dist/utils/pipeline-template.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Template Engine
+ *
+ * Simple template substitution for pipeline prompts.
+ * Replaces {{column}} placeholders with values from pipeline items.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateError = void 0;
+exports.substituteTemplate = substituteTemplate;
+exports.extractVariables = extractVariables;
+exports.validateItemForTemplate = validateItemForTemplate;
+exports.buildFullPrompt = buildFullPrompt;
+exports.buildPromptFromTemplate = buildPromptFromTemplate;
+exports.parseAIResponse = parseAIResponse;
+exports.extractJSON = extractJSON;
+exports.escapeTemplateValue = escapeTemplateValue;
+exports.previewTemplate = previewTemplate;
+const ai_response_parser_1 = require("../utils/ai-response-parser");
+const template_engine_1 = require("../utils/template-engine");
+const errors_1 = require("../errors");
+/**
+ * Error thrown when a template variable is missing
+ */
+class TemplateError extends errors_1.PipelineCoreError {
+    constructor(message, variableName) {
+        super(message, {
+            code: errors_1.ErrorCode.TEMPLATE_ERROR,
+            meta: variableName ? { variableName } : undefined,
+        });
+        this.name = 'TemplateError';
+        this.variableName = variableName;
+    }
+}
+exports.TemplateError = TemplateError;
+/**
+ * Substitute template variables with values from a pipeline item
+ *
+ * Supports special variable {{ITEMS}} which is replaced with JSON array of all items.
+ * This allows prompts to reference the full context of all items being processed.
+ *
+ * @param template Template string with {{variable}} placeholders
+ * @param item Pipeline item containing values
+ * @param strictOrOptions If boolean, strict mode; if object, full options
+ * @returns Substituted string
+ */
+function substituteTemplate(template, item, strictOrOptions = false) {
+    // Handle backward compatibility: boolean for strict mode
+    const options = typeof strictOrOptions === 'boolean'
+        ? { strict: strictOrOptions }
+        : strictOrOptions;
+    const { strict = false, allItems } = options;
+    // Create a fresh regex instance to avoid issues with global flag and lastIndex
+    const regex = new RegExp(template_engine_1.TEMPLATE_VARIABLE_REGEX.source, 'g');
+    return template.replace(regex, (match, variableName) => {
+        // Handle special {{ITEMS}} variable - returns JSON array of all items
+        if (variableName === 'ITEMS' && allItems) {
+            return JSON.stringify(allItems, null, 2);
+        }
+        // Handle special system variables that are not in item (don't error in strict mode)
+        if (template_engine_1.SPECIAL_VARIABLES.has(variableName)) {
+            // In non-strict mode, return placeholder; in strict mode, also return placeholder
+            // since these are system-provided at runtime
+            return match;
+        }
+        if (variableName in item) {
+            return item[variableName];
+        }
+        if (strict) {
+            throw new TemplateError(`Missing variable "${variableName}" in template`, variableName);
+        }
+        // Non-strict: replace with empty string
+        return '';
+    });
+}
+/**
+ * Extract all variable names from a template
+ * @param template Template string
+ * @param excludeSpecial If true, excludes special system variables (ITEMS, RESULTS, etc.)
+ * @returns Array of unique variable names
+ */
+function extractVariables(template, excludeSpecial = true) {
+    return (0, template_engine_1.extractVariables)(template, excludeSpecial);
+}
+/**
+ * Validate that a pipeline item has all required template variables
+ * @param template Template string
+ * @param item Pipeline item to validate
+ * @returns Object with validation result and missing variables
+ */
+function validateItemForTemplate(template, item) {
+    return (0, template_engine_1.validateVariables)(template, item);
+}
+/**
+ * Build the full prompt for AI by appending output field instructions
+ * @param userPrompt User's prompt template (already substituted)
+ * @param outputFields Field names expected in AI response
+ * @returns Full prompt with JSON output instruction
+ */
+function buildFullPrompt(userPrompt, outputFields) {
+    if (outputFields.length === 0) {
+        return userPrompt;
+    }
+    const fieldsStr = outputFields.join(', ');
+    return `${userPrompt}
+
+Return JSON with these fields: ${fieldsStr}`;
+}
+/**
+ * Build a complete prompt from template, item, and output fields
+ * Combines template substitution and output instruction appending
+ * @param template Prompt template with {{variable}} placeholders
+ * @param item Pipeline item with values
+ * @param outputFields Expected output field names
+ * @param strict Strict mode for variable validation
+ * @returns Complete prompt ready for AI
+ */
+function buildPromptFromTemplate(template, item, outputFields, strict = false) {
+    const substituted = substituteTemplate(template, item, strict);
+    return buildFullPrompt(substituted, outputFields);
+}
+/**
+ * Parse JSON response from AI, extracting only the declared fields
+ * Wrapper that adds TemplateError for backward compatibility
+ * @param response AI response string
+ * @param outputFields Expected field names
+ * @returns Object with extracted fields (missing fields become null)
+ */
+function parseAIResponse(response, outputFields) {
+    try {
+        return (0, ai_response_parser_1.parseAIResponse)(response, outputFields);
+    }
+    catch (error) {
+        throw new TemplateError(error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Extract JSON from a response string
+ * Re-exported from shared utilities
+ * @param response Response string
+ * @returns Extracted JSON string or null
+ */
+function extractJSON(response) {
+    return (0, ai_response_parser_1.extractJSON)(response);
+}
+/**
+ * Escape special characters in a value for safe template use
+ * @param value Value to escape
+ * @returns Escaped value
+ */
+function escapeTemplateValue(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/\{/g, '\\{')
+        .replace(/\}/g, '\\}');
+}
+/**
+ * Preview how a template will render with sample values
+ * @param template Template string
+ * @param item Sample item
+ * @param maxLength Maximum output length
+ * @param allItems Optional array of all items (for {{ITEMS}} variable preview)
+ * @returns Preview string
+ */
+function previewTemplate(template, item, maxLength = 200, allItems) {
+    try {
+        const result = substituteTemplate(template, item, { strict: false, allItems });
+        if (result.length > maxLength) {
+            return result.substring(0, maxLength) + '...';
+        }
+        return result;
+    }
+    catch {
+        return `[Error rendering template]`;
+    }
+}
+//# sourceMappingURL=pipeline-template.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/pipeline-template.js.map

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

package/node_modules/@plusplusoneplusplus/forge/dist/utils/process-monitor.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Process Monitor
+ *
+ * Monitors external terminal processes to detect when they terminate.
+ * Uses platform-specific commands to check if processes are still running.
+ *
+ * Platform-specific checks:
+ * - Windows: tasklist /FI "PID eq X"
+ * - macOS/Linux: ps -p X (exit code 0 = running)
+ */
+import { execSync } from 'child_process';
+/**
+ * Disposable interface for cleanup
+ * Compatible with VS Code's Disposable interface
+ */
+export interface Disposable {
+    dispose(): void;
+}
+/**
+ * Result of checking if a process is running
+ */
+export interface ProcessCheckResult {
+    /** Whether the process is currently running */
+    isRunning: boolean;
+    /** Error message if the check failed */
+    error?: string;
+}
+/**
+ * Configuration options for ProcessMonitor
+ */
+export interface ProcessMonitorOptions {
+    /** Poll interval in milliseconds (default: 5000) */
+    pollIntervalMs?: number;
+    /** Platform override for testing (default: process.platform) */
+    platform?: NodeJS.Platform;
+    /** Custom exec function for testing */
+    execSyncFn?: typeof execSync;
+}
+export { DEFAULT_POLL_INTERVAL_MS } from '../config/defaults';
+/**
+ * ProcessMonitor
+ *
+ * Monitors external terminal processes and notifies when they terminate.
+ * Uses polling with platform-specific commands to check process status.
+ */
+export declare class ProcessMonitor implements Disposable {
+    private checkInterval?;
+    private monitoredSessions;
+    private readonly pollIntervalMs;
+    private readonly platform;
+    private readonly execSyncFn;
+    private isDisposed;
+    constructor(options?: ProcessMonitorOptions);
+    /**
+     * Check if a process is currently running
+     *
+     * @param pid Process ID to check
+     * @returns ProcessCheckResult indicating if the process is running
+     */
+    isProcessRunning(pid: number): ProcessCheckResult;
+    /**
+     * Check if a process is running on Windows
+     */
+    private checkWindowsProcess;
+    /**
+     * Check if a process is running on Unix (macOS/Linux)
+     */
+    private checkUnixProcess;
+    /**
+     * Start monitoring a session's process
+     *
+     * @param sessionId Unique identifier for the session
+     * @param pid Process ID to monitor
+     * @param onTerminated Callback to invoke when the process terminates
+     */
+    startMonitoring(sessionId: string, pid: number, onTerminated: () => void): void;
+    /**
+     * Stop monitoring a session's process
+     *
+     * @param sessionId Session ID to stop monitoring
+     */
+    stopMonitoring(sessionId: string): void;
+    /**
+     * Get the number of sessions currently being monitored
+     */
+    getMonitoredSessionCount(): number;
+    /**
+     * Check if a specific session is being monitored
+     */
+    isMonitoring(sessionId: string): boolean;
+    /**
+     * Start the polling interval
+     */
+    private startPolling;
+    /**
+     * Stop the polling interval
+     */
+    private stopPolling;
+    /**
+     * Check all monitored processes and invoke callbacks for terminated ones
+     */
+    private checkAllProcesses;
+    /**
+     * Force an immediate check of all processes (useful for testing)
+     */
+    checkNow(): void;
+    /**
+     * Dispose of resources
+     */
+    dispose(): void;
+}
+/**
+ * Get the default ProcessMonitor instance
+ */
+export declare function getProcessMonitor(): ProcessMonitor;
+/**
+ * Reset the default monitor (useful for testing)
+ */
+export declare function resetProcessMonitor(): void;
+//# sourceMappingURL=process-monitor.d.ts.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/process-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-monitor.d.ts","sourceRoot":"","sources":["../../src/utils/process-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACvB,OAAO,IAAI,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,QAAQ,CAAC;CAChC;AAaD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAK9D;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,UAAU,CAAkB;gBAExB,OAAO,GAAE,qBAA0B;IAM/C;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB;IAmBjD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;OAMG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,IAAI,GAAG,IAAI;IAmB/E;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IASvC;;OAEG;IACH,wBAAwB,IAAI,MAAM;IAIlC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKlB;AAOD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAK1C"}

package/node_modules/@plusplusoneplusplus/forge/dist/utils/process-monitor.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * Process Monitor
+ *
+ * Monitors external terminal processes to detect when they terminate.
+ * Uses platform-specific commands to check if processes are still running.
+ *
+ * Platform-specific checks:
+ * - Windows: tasklist /FI "PID eq X"
+ * - macOS/Linux: ps -p X (exit code 0 = running)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessMonitor = exports.DEFAULT_POLL_INTERVAL_MS = void 0;
+exports.getProcessMonitor = getProcessMonitor;
+exports.resetProcessMonitor = resetProcessMonitor;
+const child_process_1 = require("child_process");
+const logger_1 = require("../logger");
+// Re-export for backward compatibility
+var defaults_1 = require("../config/defaults");
+Object.defineProperty(exports, "DEFAULT_POLL_INTERVAL_MS", { enumerable: true, get: function () { return defaults_1.DEFAULT_POLL_INTERVAL_MS; } });
+// Import for internal use
+const defaults_2 = require("../config/defaults");
+/**
+ * ProcessMonitor
+ *
+ * Monitors external terminal processes and notifies when they terminate.
+ * Uses polling with platform-specific commands to check process status.
+ */
+class ProcessMonitor {
+    constructor(options = {}) {
+        this.monitoredSessions = new Map();
+        this.isDisposed = false;
+        this.pollIntervalMs = options.pollIntervalMs ?? defaults_2.DEFAULT_POLL_INTERVAL_MS;
+        this.platform = options.platform ?? process.platform;
+        this.execSyncFn = options.execSyncFn ?? child_process_1.execSync;
+    }
+    /**
+     * Check if a process is currently running
+     *
+     * @param pid Process ID to check
+     * @returns ProcessCheckResult indicating if the process is running
+     */
+    isProcessRunning(pid) {
+        if (pid <= 0) {
+            return { isRunning: false, error: 'Invalid PID' };
+        }
+        try {
+            if (this.platform === 'win32') {
+                return this.checkWindowsProcess(pid);
+            }
+            else {
+                return this.checkUnixProcess(pid);
+            }
+        }
+        catch (error) {
+            return {
+                isRunning: false,
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * Check if a process is running on Windows
+     */
+    checkWindowsProcess(pid) {
+        try {
+            // tasklist returns exit code 0 if process found, non-zero if not found
+            // We use /FI to filter by PID and /NH to skip headers
+            const output = this.execSyncFn(`tasklist /FI "PID eq ${pid}" /NH`, {
+                encoding: 'utf8',
+                windowsHide: true,
+                timeout: 5000
+            });
+            // If the output contains the PID, the process is running
+            // tasklist returns "INFO: No tasks are running which match the specified criteria."
+            // when no process is found
+            const isRunning = !output.includes('No tasks are running') &&
+                output.includes(String(pid));
+            return { isRunning };
+        }
+        catch (error) {
+            // If tasklist fails, assume process is not running
+            return { isRunning: false };
+        }
+    }
+    /**
+     * Check if a process is running on Unix (macOS/Linux)
+     */
+    checkUnixProcess(pid) {
+        try {
+            // ps -p returns exit code 0 if process exists, 1 if not
+            this.execSyncFn(`ps -p ${pid}`, {
+                encoding: 'utf8',
+                timeout: 5000,
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+            // If we get here without error, the process is running
+            return { isRunning: true };
+        }
+        catch {
+            // ps -p returns non-zero exit code if process doesn't exist
+            return { isRunning: false };
+        }
+    }
+    /**
+     * Start monitoring a session's process
+     *
+     * @param sessionId Unique identifier for the session
+     * @param pid Process ID to monitor
+     * @param onTerminated Callback to invoke when the process terminates
+     */
+    startMonitoring(sessionId, pid, onTerminated) {
+        if (this.isDisposed) {
+            return;
+        }
+        if (pid <= 0) {
+            // Invalid PID, don't monitor
+            return;
+        }
+        // Store the session for monitoring
+        this.monitoredSessions.set(sessionId, { pid, onTerminated });
+        // Start the polling interval if not already running
+        if (!this.checkInterval && this.monitoredSessions.size > 0) {
+            this.startPolling();
+        }
+    }
+    /**
+     * Stop monitoring a session's process
+     *
+     * @param sessionId Session ID to stop monitoring
+     */
+    stopMonitoring(sessionId) {
+        this.monitoredSessions.delete(sessionId);
+        // Stop polling if no more sessions to monitor
+        if (this.monitoredSessions.size === 0 && this.checkInterval) {
+            this.stopPolling();
+        }
+    }
+    /**
+     * Get the number of sessions currently being monitored
+     */
+    getMonitoredSessionCount() {
+        return this.monitoredSessions.size;
+    }
+    /**
+     * Check if a specific session is being monitored
+     */
+    isMonitoring(sessionId) {
+        return this.monitoredSessions.has(sessionId);
+    }
+    /**
+     * Start the polling interval
+     */
+    startPolling() {
+        if (this.checkInterval || this.isDisposed) {
+            return;
+        }
+        this.checkInterval = setInterval(() => {
+            this.checkAllProcesses();
+        }, this.pollIntervalMs);
+    }
+    /**
+     * Stop the polling interval
+     */
+    stopPolling() {
+        if (this.checkInterval) {
+            clearInterval(this.checkInterval);
+            this.checkInterval = undefined;
+        }
+    }
+    /**
+     * Check all monitored processes and invoke callbacks for terminated ones
+     */
+    checkAllProcesses() {
+        const terminatedSessions = [];
+        for (const [sessionId, { pid, onTerminated }] of this.monitoredSessions.entries()) {
+            const result = this.isProcessRunning(pid);
+            if (!result.isRunning) {
+                terminatedSessions.push(sessionId);
+                // Invoke the callback
+                try {
+                    onTerminated();
+                }
+                catch (error) {
+                    // Log but don't throw - we want to continue checking other processes
+                    (0, logger_1.getLogger)().error(logger_1.LogCategory.UTILS, `Error in termination callback for session ${sessionId}`, error instanceof Error ? error : undefined);
+                }
+            }
+        }
+        // Remove terminated sessions from monitoring
+        for (const sessionId of terminatedSessions) {
+            this.monitoredSessions.delete(sessionId);
+        }
+        // Stop polling if no more sessions to monitor
+        if (this.monitoredSessions.size === 0 && this.checkInterval) {
+            this.stopPolling();
+        }
+    }
+    /**
+     * Force an immediate check of all processes (useful for testing)
+     */
+    checkNow() {
+        this.checkAllProcesses();
+    }
+    /**
+     * Dispose of resources
+     */
+    dispose() {
+        this.isDisposed = true;
+        this.stopPolling();
+        this.monitoredSessions.clear();
+    }
+}
+exports.ProcessMonitor = ProcessMonitor;
+/**
+ * Singleton instance for convenience
+ */
+let defaultMonitor;
+/**
+ * Get the default ProcessMonitor instance
+ */
+function getProcessMonitor() {
+    if (!defaultMonitor) {
+        defaultMonitor = new ProcessMonitor();
+    }
+    return defaultMonitor;
+}
+/**
+ * Reset the default monitor (useful for testing)
+ */
+function resetProcessMonitor() {
+    if (defaultMonitor) {
+        defaultMonitor.dispose();
+        defaultMonitor = undefined;
+    }
+}
+//# sourceMappingURL=process-monitor.js.map

package/node_modules/@plusplusoneplusplus/forge/dist/utils/process-monitor.js.map

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