@specforge/mcp 2.5.1 → 3.0.0

package/dist/ai-provider/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/ai-provider/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAO/D;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,UAAU,CAAC,CAYrB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAQrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,EAAE,CAmC1E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,CAOnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,gBAAgB,CAelB"}

package/dist/ai-provider/factory.js

@@ -0,0 +1,100 @@
+/**
+ * AI Provider Factory
+ *
+ * Creates configured AI provider instances.
+ */
+import { createClaudeCodeProvider } from './providers/claude-code.js';
+import { createLogger } from './logger.js';
+const logger = createLogger('AIProviderFactory');
+/**
+ * Create an AI provider based on configuration.
+ *
+ * @param config - The provider configuration
+ * @returns An initialized AI provider
+ * @throws {NotConfiguredError} If mode is not supported
+ */
+export async function createAIProvider(config) {
+    logger.info('Creating AI provider', { mode: config.mode });
+    if (config.mode !== 'claude_code') {
+        throw new Error(`Unsupported mode: ${config.mode}. Only claude_code is supported.`);
+    }
+    const provider = createClaudeCodeProvider(config);
+    await provider.initialize();
+    logger.info('AI provider created successfully', { mode: config.mode });
+    return provider;
+}
+/**
+ * Create a provider with defaults for quick usage.
+ */
+export async function createDefaultProvider(workingDirectory) {
+    return createAIProvider({
+        mode: 'claude_code',
+        maxParallelProcesses: 5,
+        requestTimeoutSeconds: 300,
+        maxRetries: 3,
+        workingDirectory: workingDirectory || process.cwd(),
+    });
+}
+/**
+ * Validate configuration before creating provider.
+ */
+export function validateConfig(config) {
+    const errors = [];
+    if (config.mode && config.mode !== 'claude_code') {
+        errors.push(`Invalid mode: ${config.mode}. Only 'claude_code' is supported.`);
+    }
+    if (config.maxParallelProcesses !== undefined) {
+        if (!Number.isInteger(config.maxParallelProcesses) || config.maxParallelProcesses < 1) {
+            errors.push('maxParallelProcesses must be a positive integer');
+        }
+        if (config.maxParallelProcesses > 20) {
+            errors.push('maxParallelProcesses cannot exceed 20');
+        }
+    }
+    if (config.requestTimeoutSeconds !== undefined) {
+        if (!Number.isInteger(config.requestTimeoutSeconds) || config.requestTimeoutSeconds < 1) {
+            errors.push('requestTimeoutSeconds must be a positive integer');
+        }
+        if (config.requestTimeoutSeconds > 3600) {
+            errors.push('requestTimeoutSeconds cannot exceed 3600 (1 hour)');
+        }
+    }
+    if (config.maxRetries !== undefined) {
+        if (!Number.isInteger(config.maxRetries) || config.maxRetries < 0) {
+            errors.push('maxRetries must be a non-negative integer');
+        }
+        if (config.maxRetries > 10) {
+            errors.push('maxRetries cannot exceed 10');
+        }
+    }
+    return errors;
+}
+/**
+ * Get default configuration values.
+ */
+export function getDefaultConfig() {
+    return {
+        mode: 'claude_code',
+        maxParallelProcesses: 5,
+        requestTimeoutSeconds: 300,
+        maxRetries: 3,
+    };
+}
+/**
+ * Merge partial config with defaults.
+ */
+export function mergeWithDefaults(partial) {
+    const defaults = getDefaultConfig();
+    if (!partial) {
+        return defaults;
+    }
+    return {
+        mode: partial.mode ?? defaults.mode,
+        maxParallelProcesses: partial.maxParallelProcesses ?? defaults.maxParallelProcesses,
+        requestTimeoutSeconds: partial.requestTimeoutSeconds ?? defaults.requestTimeoutSeconds,
+        maxRetries: partial.maxRetries ?? defaults.maxRetries,
+        workingDirectory: partial.workingDirectory ?? defaults.workingDirectory,
+        circuitBreakerThreshold: partial.circuitBreakerThreshold ?? defaults.circuitBreakerThreshold,
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/ai-provider/factory.js.map

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

package/dist/ai-provider/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * AI Provider Module
+ *
+ * Public exports for the AI Provider module.
+ */
+export type { AIProvider, AIResponse, ProviderStatus, ProviderMode, RunOptions, TestOptions, TestResult, AIProviderConfig, AIProviderConfigInput, ProcessManagerConfig, ProcessResult, ProcessStatus, SpawnResult, ErrorType, CircuitState, CircuitBreakerConfig, RetryConfig, CLIVersionInfo, MetricStats, LogLevel, LogEntry, Span, InstanceState, InstanceInfo, AIProviderAPIResponse, GetConfigResponse, GetStatusResponse, UpdateConfigResponse, TestProviderResponse, } from './types.js';
+export { createAIProvider, createDefaultProvider, validateConfig, getDefaultConfig, mergeWithDefaults, } from './factory.js';
+export { ClaudeCodeProvider, createClaudeCodeProvider, } from './providers/claude-code.js';
+export { ClaudeCodeProcessManager, createProcessManager, } from './process-manager.js';
+export { AIProviderError, NotConfiguredError, AuthenticationError, RateLimitError, TimeoutError, CLINotFoundError, CircuitOpenError, InputValidationError, ProcessSpawnError, isRetryableError, getErrorSuggestion, getErrorCode, } from './errors.js';
+export { aiProviderEvents, onRateLimitHit, onAuthFailed, onProcessEvent, onCircuitBreakerChange, } from './events.js';
+export type { AIProviderEvents, RateLimitHitPayload, AuthFailedPayload, ProcessSpawnedPayload, ProcessCompletedPayload, ProcessFailedPayload, CircuitStateChangePayload, } from './events.js';
+export { Semaphore, } from './semaphore.js';
+export { CircuitBreaker, createCircuitBreaker, } from './circuit-breaker.js';
+export { RetryExecutor, createRetryExecutor, withRetry, } from './retry-executor.js';
+export { InstanceCoordinator, createInstanceCoordinator, } from './instance-coordinator.js';
+export { SafeArgumentBuilder, buildSafeArgs, isValidWorkingDirectory, } from './safe-args.js';
+export { CLIVersionDetector, getCLIVersionDetector, detectCLIVersion, isCLIInstalled, } from './cli-version.js';
+export { ConfigLoader, getConfigLoader, createConfigLoader, } from './config-loader.js';
+export { Logger, createLogger, } from './logger.js';
+export { Metrics, getMetrics, createMetrics, METRIC_NAMES, } from './metrics.js';
+export { Tracer, getTracer, createTracer, } from './tracer.js';
+export { ProcessLifecycleManager, getLifecycleManager, createLifecycleManager, onShutdown, } from './lifecycle.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai-provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-provider/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAKpB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAKtB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GACb,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,SAAS,GACV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,MAAM,EACN,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,OAAO,EACP,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,MAAM,EACN,SAAS,EACT,YAAY,GACb,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/ai-provider/index.js

@@ -0,0 +1,46 @@
+/**
+ * AI Provider Module
+ *
+ * Public exports for the AI Provider module.
+ */
+// ============================================================================
+// Factory
+// ============================================================================
+export { createAIProvider, createDefaultProvider, validateConfig, getDefaultConfig, mergeWithDefaults, } from './factory.js';
+// ============================================================================
+// Provider
+// ============================================================================
+export { ClaudeCodeProvider, createClaudeCodeProvider, } from './providers/claude-code.js';
+// ============================================================================
+// Process Manager
+// ============================================================================
+export { ClaudeCodeProcessManager, createProcessManager, } from './process-manager.js';
+// ============================================================================
+// Errors
+// ============================================================================
+export { AIProviderError, NotConfiguredError, AuthenticationError, RateLimitError, TimeoutError, CLINotFoundError, CircuitOpenError, InputValidationError, ProcessSpawnError, isRetryableError, getErrorSuggestion, getErrorCode, } from './errors.js';
+// ============================================================================
+// Events
+// ============================================================================
+export { aiProviderEvents, onRateLimitHit, onAuthFailed, onProcessEvent, onCircuitBreakerChange, } from './events.js';
+// ============================================================================
+// Utilities
+// ============================================================================
+export { Semaphore, } from './semaphore.js';
+export { CircuitBreaker, createCircuitBreaker, } from './circuit-breaker.js';
+export { RetryExecutor, createRetryExecutor, withRetry, } from './retry-executor.js';
+export { InstanceCoordinator, createInstanceCoordinator, } from './instance-coordinator.js';
+export { SafeArgumentBuilder, buildSafeArgs, isValidWorkingDirectory, } from './safe-args.js';
+export { CLIVersionDetector, getCLIVersionDetector, detectCLIVersion, isCLIInstalled, } from './cli-version.js';
+export { ConfigLoader, getConfigLoader, createConfigLoader, } from './config-loader.js';
+// ============================================================================
+// Observability
+// ============================================================================
+export { Logger, createLogger, } from './logger.js';
+export { Metrics, getMetrics, createMetrics, METRIC_NAMES, } from './metrics.js';
+export { Tracer, getTracer, createTracer, } from './tracer.js';
+// ============================================================================
+// Lifecycle
+// ============================================================================
+export { ProcessLifecycleManager, getLifecycleManager, createLifecycleManager, onShutdown, } from './lifecycle.js';
+//# sourceMappingURL=index.js.map

package/dist/ai-provider/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai-provider/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqCH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAC/E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAEpC,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAC/E,OAAO,EACL,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAC/E,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAC/E,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAYrB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAC/E,OAAO,EACL,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,SAAS,GACV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAC/E,OAAO,EACL,MAAM,EACN,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,OAAO,EACP,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,MAAM,EACN,SAAS,EACT,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAC/E,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/ai-provider/instance-coordinator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Instance Coordinator
+ *
+ * Cross-process file lock coordination for limiting global process count.
+ */
+export declare class InstanceCoordinator {
+    private maxGlobalProcesses;
+    private lockFile;
+    private instanceId;
+    private currentProcessCount;
+    constructor(maxGlobalProcesses?: number);
+    /**
+     * Try to acquire a global process slot.
+     */
+    tryAcquire(): Promise<boolean>;
+    /**
+     * Release a global process slot.
+     */
+    release(): void;
+    /**
+     * Release all slots for this instance (e.g., during shutdown).
+     */
+    releaseAll(): void;
+    /**
+     * Get global status across all instances.
+     */
+    getGlobalStatus(): {
+        totalProcesses: number;
+        maxProcesses: number;
+        instanceCount: number;
+        thisInstanceProcesses: number;
+    };
+    /**
+     * Clean up stale entries.
+     */
+    cleanup(): void;
+    /**
+     * Update max global processes.
+     */
+    setMaxGlobalProcesses(max: number): void;
+    /**
+     * Read state from lock file.
+     */
+    private readState;
+    /**
+     * Write state to lock file.
+     */
+    private writeState;
+}
+/**
+ * Create an instance coordinator with default configuration.
+ */
+export declare function createInstanceCoordinator(maxGlobalProcesses?: number): InstanceCoordinator;
+//# sourceMappingURL=instance-coordinator.d.ts.map

package/dist/ai-provider/instance-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-coordinator.d.ts","sourceRoot":"","sources":["../../src/ai-provider/instance-coordinator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,qBAAa,mBAAmB;IAKlB,OAAO,CAAC,kBAAkB;IAJtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,mBAAmB,CAAa;gBAEpB,kBAAkB,GAAE,MAAW;IAKnD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAyDpC;;OAEG;IACH,OAAO,IAAI,IAAI;IAuCf;;OAEG;IACH,UAAU,IAAI,IAAI;IAmBlB;;OAEG;IACH,eAAe,IAAI;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,qBAAqB,EAAE,MAAM,CAAC;KAC/B;IAgCD;;OAEG;IACH,OAAO,IAAI,IAAI;IAqBf;;OAEG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,kBAAkB,CAAC,EAAE,MAAM,GAC1B,mBAAmB,CAErB"}

package/dist/ai-provider/instance-coordinator.js

@@ -0,0 +1,199 @@
+/**
+ * Instance Coordinator
+ *
+ * Cross-process file lock coordination for limiting global process count.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { createLogger } from './logger.js';
+const logger = createLogger('InstanceCoordinator');
+const DEFAULT_LOCK_FILE = 'specforge-ai-provider.lock';
+const STALE_THRESHOLD_MS = 5 * 60 * 1000; // 5 minutes
+export class InstanceCoordinator {
+    maxGlobalProcesses;
+    lockFile;
+    instanceId;
+    currentProcessCount = 0;
+    constructor(maxGlobalProcesses = 10) {
+        this.maxGlobalProcesses = maxGlobalProcesses;
+        this.lockFile = path.join(os.tmpdir(), DEFAULT_LOCK_FILE);
+        this.instanceId = `${process.pid}-${Date.now()}`;
+    }
+    /**
+     * Try to acquire a global process slot.
+     */
+    async tryAcquire() {
+        try {
+            const state = this.readState();
+            // Clean up stale entries (older than 5 minutes)
+            const now = Date.now();
+            const activeInstances = state.instances.filter(i => now - i.timestamp < STALE_THRESHOLD_MS);
+            const totalProcesses = activeInstances.reduce((sum, i) => sum + i.processCount, 0);
+            if (totalProcesses >= this.maxGlobalProcesses) {
+                logger.debug('Global process limit reached', {
+                    totalProcesses,
+                    maxGlobalProcesses: this.maxGlobalProcesses,
+                });
+                return false;
+            }
+            // Update or add this instance
+            const existingIndex = activeInstances.findIndex(i => i.instanceId === this.instanceId);
+            if (existingIndex >= 0) {
+                activeInstances[existingIndex].processCount++;
+                activeInstances[existingIndex].timestamp = now;
+            }
+            else {
+                activeInstances.push({
+                    instanceId: this.instanceId,
+                    processCount: 1,
+                    timestamp: now,
+                });
+            }
+            this.currentProcessCount++;
+            this.writeState({ instances: activeInstances });
+            logger.debug('Acquired global process slot', {
+                instanceId: this.instanceId,
+                processCount: this.currentProcessCount,
+                totalGlobalProcesses: totalProcesses + 1,
+            });
+            return true;
+        }
+        catch (error) {
+            // If locking fails, allow the request (fail open)
+            logger.warn('Failed to acquire lock, allowing request', {
+                error: error.message,
+            });
+            return true;
+        }
+    }
+    /**
+     * Release a global process slot.
+     */
+    release() {
+        if (this.currentProcessCount <= 0) {
+            return;
+        }
+        try {
+            const state = this.readState();
+            const instance = state.instances.find(i => i.instanceId === this.instanceId);
+            if (instance) {
+                instance.processCount = Math.max(0, instance.processCount - 1);
+                instance.timestamp = Date.now();
+                // Remove instance if no more processes
+                if (instance.processCount === 0) {
+                    state.instances = state.instances.filter(i => i.instanceId !== this.instanceId);
+                }
+                this.writeState(state);
+            }
+            this.currentProcessCount = Math.max(0, this.currentProcessCount - 1);
+            logger.debug('Released global process slot', {
+                instanceId: this.instanceId,
+                processCount: this.currentProcessCount,
+            });
+        }
+        catch (error) {
+            // Ignore release errors
+            logger.warn('Failed to release lock', {
+                error: error.message,
+            });
+        }
+    }
+    /**
+     * Release all slots for this instance (e.g., during shutdown).
+     */
+    releaseAll() {
+        try {
+            const state = this.readState();
+            state.instances = state.instances.filter(i => i.instanceId !== this.instanceId);
+            this.writeState(state);
+            this.currentProcessCount = 0;
+            logger.debug('Released all process slots', {
+                instanceId: this.instanceId,
+            });
+        }
+        catch (error) {
+            logger.warn('Failed to release all locks', {
+                error: error.message,
+            });
+        }
+    }
+    /**
+     * Get global status across all instances.
+     */
+    getGlobalStatus() {
+        try {
+            const state = this.readState();
+            const now = Date.now();
+            const activeInstances = state.instances.filter(i => now - i.timestamp < STALE_THRESHOLD_MS);
+            const totalProcesses = activeInstances.reduce((sum, i) => sum + i.processCount, 0);
+            const thisInstance = activeInstances.find(i => i.instanceId === this.instanceId);
+            return {
+                totalProcesses,
+                maxProcesses: this.maxGlobalProcesses,
+                instanceCount: activeInstances.length,
+                thisInstanceProcesses: thisInstance?.processCount ?? 0,
+            };
+        }
+        catch {
+            return {
+                totalProcesses: this.currentProcessCount,
+                maxProcesses: this.maxGlobalProcesses,
+                instanceCount: 1,
+                thisInstanceProcesses: this.currentProcessCount,
+            };
+        }
+    }
+    /**
+     * Clean up stale entries.
+     */
+    cleanup() {
+        try {
+            const state = this.readState();
+            const now = Date.now();
+            const activeInstances = state.instances.filter(i => now - i.timestamp < STALE_THRESHOLD_MS);
+            if (activeInstances.length !== state.instances.length) {
+                this.writeState({ instances: activeInstances });
+                logger.debug('Cleaned up stale instances', {
+                    removed: state.instances.length - activeInstances.length,
+                });
+            }
+        }
+        catch (error) {
+            logger.warn('Failed to cleanup stale instances', {
+                error: error.message,
+            });
+        }
+    }
+    /**
+     * Update max global processes.
+     */
+    setMaxGlobalProcesses(max) {
+        this.maxGlobalProcesses = max;
+    }
+    /**
+     * Read state from lock file.
+     */
+    readState() {
+        try {
+            const content = fs.readFileSync(this.lockFile, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return { instances: [] };
+        }
+    }
+    /**
+     * Write state to lock file.
+     */
+    writeState(state) {
+        fs.writeFileSync(this.lockFile, JSON.stringify(state), { flag: 'w' });
+    }
+}
+/**
+ * Create an instance coordinator with default configuration.
+ */
+export function createInstanceCoordinator(maxGlobalProcesses) {
+    return new InstanceCoordinator(maxGlobalProcesses);
+}
+//# sourceMappingURL=instance-coordinator.js.map

package/dist/ai-provider/instance-coordinator.js.map

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

package/dist/ai-provider/jsonl-parser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * JSONL Parser for Claude Code Session Logs
+ *
+ * Parses Claude Code JSONL log files to extract actual token usage.
+ * JSONL files are stored at ~/.claude/projects/<encoded-path>/<sessionId>.jsonl
+ */
+/**
+ * Parsed token usage from JSONL logs
+ */
+export interface ParsedTokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    costUSD: number;
+    durationMs: number;
+}
+/**
+ * Parse a single JSONL line for token usage
+ */
+export declare function parseJSONLLine(line: string): ParsedTokenUsage | null;
+/**
+ * Parse JSONL content and sum token usage across all assistant messages
+ */
+export declare function parseJSONLContent(content: string): ParsedTokenUsage;
+/**
+ * Encode project path for Claude Code directory structure.
+ * Claude encodes paths like: /Users/agent/myproject -> Users-agent-myproject
+ */
+export declare function encodeProjectPath(path: string): string;
+/**
+ * Parse token usage from a session's JSONL file.
+ *
+ * @param sessionId - The session ID used when running Claude Code
+ * @param projectPath - The working directory used for the session
+ * @returns Parsed token usage or null if file not found/parse error
+ */
+export declare function parseSessionTokens(sessionId: string, projectPath: string): Promise<ParsedTokenUsage | null>;
+/**
+ * Create a default (zero) token usage object
+ */
+export declare function createEmptyTokenUsage(): ParsedTokenUsage;
+//# sourceMappingURL=jsonl-parser.d.ts.map

package/dist/ai-provider/jsonl-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-parser.d.ts","sourceRoot":"","sources":["../../src/ai-provider/jsonl-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAgCD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CA0BpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA2BnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAalC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,CASxD"}

package/dist/ai-provider/jsonl-parser.js

@@ -0,0 +1,107 @@
+/**
+ * JSONL Parser for Claude Code Session Logs
+ *
+ * Parses Claude Code JSONL log files to extract actual token usage.
+ * JSONL files are stored at ~/.claude/projects/<encoded-path>/<sessionId>.jsonl
+ */
+import { readFile } from 'fs/promises';
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Parse a single JSONL line for token usage
+ */
+export function parseJSONLLine(line) {
+    try {
+        const record = JSON.parse(line);
+        if (record.type !== 'assistant') {
+            return null;
+        }
+        const assistantRecord = record;
+        const usage = assistantRecord.message?.usage;
+        if (!usage) {
+            return null;
+        }
+        return {
+            inputTokens: usage.input_tokens || 0,
+            outputTokens: usage.output_tokens || 0,
+            cacheCreationTokens: usage.cache_creation_input_tokens || 0,
+            cacheReadTokens: usage.cache_read_input_tokens || 0,
+            costUSD: assistantRecord.costUSD || 0,
+            durationMs: assistantRecord.durationMs || 0,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse JSONL content and sum token usage across all assistant messages
+ */
+export function parseJSONLContent(content) {
+    const lines = content.trim().split('\n');
+    const total = {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheCreationTokens: 0,
+        cacheReadTokens: 0,
+        costUSD: 0,
+        durationMs: 0,
+    };
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        const parsed = parseJSONLLine(line);
+        if (parsed) {
+            total.inputTokens += parsed.inputTokens;
+            total.outputTokens += parsed.outputTokens;
+            total.cacheCreationTokens += parsed.cacheCreationTokens;
+            total.cacheReadTokens += parsed.cacheReadTokens;
+            total.costUSD += parsed.costUSD;
+            total.durationMs += parsed.durationMs;
+        }
+    }
+    return total;
+}
+/**
+ * Encode project path for Claude Code directory structure.
+ * Claude encodes paths like: /Users/agent/myproject -> Users-agent-myproject
+ */
+export function encodeProjectPath(path) {
+    // Replace slashes with dashes and remove leading dash
+    return path.replace(/\//g, '-').replace(/^-/, '');
+}
+/**
+ * Parse token usage from a session's JSONL file.
+ *
+ * @param sessionId - The session ID used when running Claude Code
+ * @param projectPath - The working directory used for the session
+ * @returns Parsed token usage or null if file not found/parse error
+ */
+export async function parseSessionTokens(sessionId, projectPath) {
+    // JSONL file location: ~/.claude/projects/<encoded-path>/<sessionId>.jsonl
+    const claudeDir = join(homedir(), '.claude', 'projects');
+    const encodedProject = encodeProjectPath(projectPath);
+    const jsonlPath = join(claudeDir, encodedProject, `${sessionId}.jsonl`);
+    try {
+        const content = await readFile(jsonlPath, 'utf-8');
+        return parseJSONLContent(content);
+    }
+    catch {
+        // File not found or read error
+        return null;
+    }
+}
+/**
+ * Create a default (zero) token usage object
+ */
+export function createEmptyTokenUsage() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheCreationTokens: 0,
+        cacheReadTokens: 0,
+        costUSD: 0,
+        durationMs: 0,
+    };
+}
+//# sourceMappingURL=jsonl-parser.js.map

package/dist/ai-provider/jsonl-parser.js.map

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