@specforge/mcp 2.5.1 → 3.0.0

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

@@ -0,0 +1,50 @@
+/**
+ * Semaphore for Concurrency Control
+ *
+ * Controls maximum number of parallel processes.
+ */
+export declare class Semaphore {
+    private maxPermits;
+    private permits;
+    private waiting;
+    constructor(maxPermits: number);
+    /**
+     * Acquire a permit. Returns a release function.
+     */
+    acquire(): Promise<() => void>;
+    /**
+     * Try to acquire a permit without waiting.
+     * Returns null if no permits available.
+     */
+    tryAcquire(): (() => void) | null;
+    /**
+     * Release a permit back to the pool.
+     */
+    private release;
+    /**
+     * Get number of available permits.
+     */
+    getAvailablePermits(): number;
+    /**
+     * Get maximum permits configured.
+     */
+    getMaxPermits(): number;
+    /**
+     * Get number of waiting requests.
+     */
+    getQueueLength(): number;
+    /**
+     * Check if any permits are available.
+     */
+    hasAvailablePermits(): boolean;
+    /**
+     * Update the maximum number of permits.
+     * Can be used to dynamically adjust concurrency.
+     */
+    setMaxPermits(maxPermits: number): void;
+    /**
+     * Clear all waiting requests (e.g., during shutdown).
+     */
+    clearWaiting(): void;
+}
+//# sourceMappingURL=semaphore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.d.ts","sourceRoot":"","sources":["../../src/ai-provider/semaphore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,SAAS;IAIR,OAAO,CAAC,UAAU;IAH9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;gBAEpB,UAAU,EAAE,MAAM;IAItC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC;IAcpC;;;OAGG;IACH,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI;IAQjC;;OAEG;IACH,OAAO,CAAC,OAAO;IAQf;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAcvC;;OAEG;IACH,YAAY,IAAI,IAAI;CAGrB"}

package/dist/ai-provider/semaphore.js

@@ -0,0 +1,97 @@
+/**
+ * Semaphore for Concurrency Control
+ *
+ * Controls maximum number of parallel processes.
+ */
+export class Semaphore {
+    maxPermits;
+    permits;
+    waiting = [];
+    constructor(maxPermits) {
+        this.maxPermits = maxPermits;
+        this.permits = maxPermits;
+    }
+    /**
+     * Acquire a permit. Returns a release function.
+     */
+    async acquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            return () => this.release();
+        }
+        return new Promise((resolve) => {
+            this.waiting.push(() => {
+                this.permits--;
+                resolve(() => this.release());
+            });
+        });
+    }
+    /**
+     * Try to acquire a permit without waiting.
+     * Returns null if no permits available.
+     */
+    tryAcquire() {
+        if (this.permits > 0) {
+            this.permits--;
+            return () => this.release();
+        }
+        return null;
+    }
+    /**
+     * Release a permit back to the pool.
+     */
+    release() {
+        this.permits++;
+        const next = this.waiting.shift();
+        if (next) {
+            next();
+        }
+    }
+    /**
+     * Get number of available permits.
+     */
+    getAvailablePermits() {
+        return this.permits;
+    }
+    /**
+     * Get maximum permits configured.
+     */
+    getMaxPermits() {
+        return this.maxPermits;
+    }
+    /**
+     * Get number of waiting requests.
+     */
+    getQueueLength() {
+        return this.waiting.length;
+    }
+    /**
+     * Check if any permits are available.
+     */
+    hasAvailablePermits() {
+        return this.permits > 0;
+    }
+    /**
+     * Update the maximum number of permits.
+     * Can be used to dynamically adjust concurrency.
+     */
+    setMaxPermits(maxPermits) {
+        const diff = maxPermits - this.maxPermits;
+        this.maxPermits = maxPermits;
+        this.permits = Math.max(0, this.permits + diff);
+        // Wake up waiting requests if we increased permits
+        while (this.permits > 0 && this.waiting.length > 0) {
+            const next = this.waiting.shift();
+            if (next) {
+                next();
+            }
+        }
+    }
+    /**
+     * Clear all waiting requests (e.g., during shutdown).
+     */
+    clearWaiting() {
+        this.waiting = [];
+    }
+}
+//# sourceMappingURL=semaphore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semaphore.js","sourceRoot":"","sources":["../../src/ai-provider/semaphore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,SAAS;IAIA;IAHZ,OAAO,CAAS;IAChB,OAAO,GAAsB,EAAE,CAAC;IAExC,YAAoB,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;QACpC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;gBACrB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,OAAO;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,UAAkB;QAC9B,MAAM,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QAEhD,mDAAmD;QACnD,OAAO,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,EAAE,CAAC;YACT,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACpB,CAAC;CACF"}

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

@@ -0,0 +1,67 @@
+/**
+ * Request Tracing
+ *
+ * Distributed tracing with span support.
+ */
+import type { Span } from './types.js';
+/**
+ * Tracer for creating and managing spans.
+ */
+export declare class Tracer {
+    private currentTraceId?;
+    private currentSpan?;
+    private spans;
+    /**
+     * Generate a unique request ID.
+     */
+    generateRequestId(): string;
+    /**
+     * Start a new span.
+     */
+    startSpan(name: string, attributes?: Record<string, unknown>): Span;
+    /**
+     * Start a new trace (top-level span).
+     */
+    startTrace(name: string, attributes?: Record<string, unknown>): Span;
+    /**
+     * Get current trace ID.
+     */
+    getTraceId(): string | undefined;
+    /**
+     * Set trace ID for correlation with external systems.
+     */
+    setTraceId(traceId: string): void;
+    /**
+     * Get current span.
+     */
+    getCurrentSpan(): Span | undefined;
+    /**
+     * Get all recorded spans.
+     */
+    getSpans(): Span[];
+    /**
+     * Clear recorded spans.
+     */
+    clearSpans(): void;
+    /**
+     * Clear current context.
+     */
+    clearContext(): void;
+    /**
+     * Execute a function within a span.
+     */
+    withSpan<T>(name: string, fn: (span: Span) => Promise<T>, attributes?: Record<string, unknown>): Promise<T>;
+    /**
+     * Export spans as JSON.
+     */
+    exportSpans(): Record<string, unknown>[];
+}
+/**
+ * Get or create global tracer.
+ */
+export declare function getTracer(): Tracer;
+/**
+ * Create a new tracer instance.
+ */
+export declare function createTracer(): Tracer;
+//# sourceMappingURL=tracer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/ai-provider/tracer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAkGvC;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,WAAW,CAAC,CAAW;IAC/B,OAAO,CAAC,KAAK,CAAkB;IAE/B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAmBnE;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMpE;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,cAAc,IAAI,IAAI,GAAG,SAAS;IAIlC;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;IAIlB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACG,QAAQ,CAAC,CAAC,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,CAAC,CAAC;IAeb;;OAEG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;CAGzC;AAOD;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/ai-provider/tracer.js

@@ -0,0 +1,209 @@
+/**
+ * Request Tracing
+ *
+ * Distributed tracing with span support.
+ */
+import { randomUUID } from 'crypto';
+import { createLogger } from './logger.js';
+const logger = createLogger('Tracer');
+/**
+ * Span implementation.
+ */
+class SpanImpl {
+    traceId;
+    spanId;
+    name;
+    startTime;
+    endTime;
+    status;
+    attributes;
+    parentSpanId;
+    constructor(name, traceId, attributes, parentSpanId) {
+        this.traceId = traceId;
+        this.spanId = randomUUID();
+        this.name = name;
+        this.startTime = Date.now();
+        this.attributes = attributes || {};
+        this.parentSpanId = parentSpanId;
+    }
+    setStatus(status, error) {
+        this.status = status;
+        if (error) {
+            this.attributes.error = String(error);
+            if (error instanceof Error) {
+                this.attributes.errorName = error.name;
+                this.attributes.errorMessage = error.message;
+                this.attributes.errorStack = error.stack;
+            }
+        }
+    }
+    end() {
+        this.endTime = Date.now();
+        // Log span completion
+        logger.debug('Span ended', {
+            traceId: this.traceId,
+            spanId: this.spanId,
+            name: this.name,
+            durationMs: this.endTime - this.startTime,
+            status: this.status,
+            attributes: this.attributes,
+        });
+    }
+    /**
+     * Add an attribute to the span.
+     */
+    setAttribute(key, value) {
+        this.attributes[key] = value;
+    }
+    /**
+     * Add multiple attributes.
+     */
+    setAttributes(attributes) {
+        Object.assign(this.attributes, attributes);
+    }
+    /**
+     * Get span duration (returns 0 if not ended).
+     */
+    getDuration() {
+        if (!this.endTime)
+            return 0;
+        return this.endTime - this.startTime;
+    }
+    /**
+     * Convert to JSON for serialization.
+     */
+    toJSON() {
+        return {
+            traceId: this.traceId,
+            spanId: this.spanId,
+            parentSpanId: this.parentSpanId,
+            name: this.name,
+            startTime: this.startTime,
+            endTime: this.endTime,
+            durationMs: this.getDuration(),
+            status: this.status,
+            attributes: this.attributes,
+        };
+    }
+}
+/**
+ * Tracer for creating and managing spans.
+ */
+export class Tracer {
+    currentTraceId;
+    currentSpan;
+    spans = [];
+    /**
+     * Generate a unique request ID.
+     */
+    generateRequestId() {
+        return randomUUID();
+    }
+    /**
+     * Start a new span.
+     */
+    startSpan(name, attributes) {
+        const traceId = this.currentTraceId || this.generateRequestId();
+        const parentSpanId = this.currentSpan?.spanId;
+        const span = new SpanImpl(name, traceId, attributes, parentSpanId);
+        this.spans.push(span);
+        this.currentTraceId = traceId;
+        this.currentSpan = span;
+        logger.debug('Span started', {
+            traceId: span.traceId,
+            spanId: span.spanId,
+            name: span.name,
+            parentSpanId,
+        });
+        return span;
+    }
+    /**
+     * Start a new trace (top-level span).
+     */
+    startTrace(name, attributes) {
+        this.currentTraceId = this.generateRequestId();
+        this.currentSpan = undefined;
+        return this.startSpan(name, attributes);
+    }
+    /**
+     * Get current trace ID.
+     */
+    getTraceId() {
+        return this.currentTraceId;
+    }
+    /**
+     * Set trace ID for correlation with external systems.
+     */
+    setTraceId(traceId) {
+        this.currentTraceId = traceId;
+    }
+    /**
+     * Get current span.
+     */
+    getCurrentSpan() {
+        return this.currentSpan;
+    }
+    /**
+     * Get all recorded spans.
+     */
+    getSpans() {
+        return [...this.spans];
+    }
+    /**
+     * Clear recorded spans.
+     */
+    clearSpans() {
+        this.spans = [];
+    }
+    /**
+     * Clear current context.
+     */
+    clearContext() {
+        this.currentTraceId = undefined;
+        this.currentSpan = undefined;
+    }
+    /**
+     * Execute a function within a span.
+     */
+    async withSpan(name, fn, attributes) {
+        const span = this.startSpan(name, attributes);
+        try {
+            const result = await fn(span);
+            span.setStatus('success');
+            return result;
+        }
+        catch (error) {
+            span.setStatus('error', error);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    }
+    /**
+     * Export spans as JSON.
+     */
+    exportSpans() {
+        return this.spans.map(span => span.toJSON());
+    }
+}
+/**
+ * Global tracer instance.
+ */
+let globalTracer = null;
+/**
+ * Get or create global tracer.
+ */
+export function getTracer() {
+    if (!globalTracer) {
+        globalTracer = new Tracer();
+    }
+    return globalTracer;
+}
+/**
+ * Create a new tracer instance.
+ */
+export function createTracer() {
+    return new Tracer();
+}
+//# sourceMappingURL=tracer.js.map

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

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

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

@@ -0,0 +1,181 @@
+/**
+ * AI Provider Type Definitions
+ *
+ * TypeScript interfaces for the AI Provider module.
+ * Supports Claude Code mode for spawning CLI processes.
+ */
+export type ProviderMode = 'claude_code';
+export interface AIProvider {
+    run(prompt: string, options?: RunOptions): Promise<AIResponse>;
+    test(options?: TestOptions): Promise<TestResult>;
+    getStatus(): Promise<ProviderStatus>;
+    getMode(): ProviderMode;
+    shutdown(): Promise<void>;
+}
+export interface AIResponse {
+    success: boolean;
+    output: string;
+    model?: string;
+    durationMs?: number;
+    /** Session ID for linking to JSONL logs (used for token tracking) */
+    sessionId?: string;
+    error?: string;
+    errorType?: ErrorType;
+    suggestion?: string;
+}
+export interface ProviderStatus {
+    mode: ProviderMode;
+    isConfigured: boolean;
+    isAuthenticated: boolean;
+    isRateLimited: boolean;
+    rateLimitMessage?: string;
+    suggestion?: string;
+    cliVersion?: string;
+    activeProcesses?: number;
+    maxParallelProcesses?: number;
+}
+export interface RunOptions {
+    timeout?: number;
+    workingDirectory?: string;
+    /** Model to use: 'sonnet' (default) or 'opus' */
+    model?: 'sonnet' | 'opus';
+    /** Session ID for linking to JSONL logs (used for token tracking) */
+    sessionId?: string;
+    onProgress?: (message: string) => void;
+}
+export interface TestOptions {
+    prompt?: string;
+}
+export interface TestResult {
+    success: boolean;
+    mode: ProviderMode;
+    model?: string;
+    durationMs?: number;
+    response?: string;
+    error?: string;
+    suggestion?: string;
+}
+export interface AIProviderConfig {
+    mode: ProviderMode;
+    maxParallelProcesses: number;
+    requestTimeoutSeconds: number;
+    maxRetries: number;
+    workingDirectory?: string;
+    circuitBreakerThreshold?: number;
+    /** Enable file operations by skipping permission prompts. Required for autopilot. Default: true */
+    dangerouslySkipPermissions?: boolean;
+}
+export interface AIProviderConfigInput {
+    mode?: ProviderMode;
+    maxParallelProcesses?: number;
+    requestTimeoutSeconds?: number;
+    maxRetries?: number;
+}
+export interface ProcessManagerConfig {
+    maxParallel: number;
+    timeoutMs: number;
+    workingDirectory: string;
+    maxRetries: number;
+    circuitBreakerThreshold: number;
+    /** Enable file operations by skipping permission prompts. Required for autopilot. */
+    dangerouslySkipPermissions?: boolean;
+}
+export interface ProcessResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    errorType?: ErrorType;
+    suggestion?: string;
+    durationMs?: number;
+    model?: string;
+}
+export interface ProcessStatus {
+    isAuthenticated: boolean;
+    accountEmail?: string;
+    activeProcesses: number;
+    isRateLimited: boolean;
+    rateLimitMessage?: string;
+    cliVersion?: string;
+    suggestion?: string;
+}
+export interface SpawnResult {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+}
+export type ErrorType = 'auth' | 'rate_limit' | 'timeout' | 'network' | 'cli_not_found' | 'unknown';
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    recoveryTimeMs: number;
+    halfOpenRequests: number;
+}
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    jitterFactor?: number;
+}
+export interface CLIVersionInfo {
+    version: string;
+    supportsOutputFormat: boolean;
+    supportsPrintMode: boolean;
+    supportsWorkingDirectory: boolean;
+}
+export interface MetricStats {
+    count: number;
+    min: number;
+    max: number;
+    avg: number;
+    p50: number;
+    p95: number;
+    p99: number;
+}
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    component: string;
+    message: string;
+    context?: Record<string, unknown>;
+    requestId?: string;
+}
+export interface Span {
+    traceId: string;
+    spanId: string;
+    name: string;
+    startTime: number;
+    endTime?: number;
+    status?: string;
+    attributes: Record<string, unknown>;
+    setStatus(status: string, error?: unknown): void;
+    end(): void;
+}
+export interface InstanceState {
+    instances: InstanceInfo[];
+}
+export interface InstanceInfo {
+    instanceId: string;
+    processCount: number;
+    timestamp: number;
+}
+export interface AIProviderAPIResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    suggestion?: string;
+}
+export interface GetConfigResponse {
+    config: AIProviderConfig | null;
+}
+export interface GetStatusResponse {
+    status: ProviderStatus;
+}
+export interface UpdateConfigResponse {
+    config: AIProviderConfig;
+}
+export interface TestProviderResponse {
+    result: TestResult;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/ai-provider/types.js

@@ -0,0 +1,8 @@
+/**
+ * AI Provider Type Definitions
+ *
+ * TypeScript interfaces for the AI Provider module.
+ * Supports Claude Code mode for spawning CLI processes.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ai-provider/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}