@skillsmith/core 0.5.4 → 0.5.6

package/dist/telemetry/tracer-imports.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SMI-4250: Extracted dynamic import + instrumentation registry for tracer.
+ *
+ * Lives in its own module so tests can `vi.mock` the import surface without
+ * having to mock all of tracer.ts. The class registry encodes which OTel
+ * instrumentation packages tracer.ts attempts to load on init; each entry
+ * is optional at runtime and silently skipped if the package isn't installed
+ * (e.g. `instrumentation-aws-sdk` only loads when `@skillsmith/enterprise`
+ * is present in the consuming install).
+ */
+export declare function dynamicImport(moduleName: string): Promise<unknown>;
+export declare const INSTRUMENTATION_PACKAGES: ReadonlyArray<readonly [string, string]>;
+//# sourceMappingURL=tracer-imports.d.ts.map

package/dist/telemetry/tracer-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer-imports.d.ts","sourceRoot":"","sources":["../../src/telemetry/tracer-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE;AAED,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAKpE,CAAA"}

package/dist/telemetry/tracer-imports.js

@@ -0,0 +1,26 @@
+/**
+ * SMI-4250: Extracted dynamic import + instrumentation registry for tracer.
+ *
+ * Lives in its own module so tests can `vi.mock` the import surface without
+ * having to mock all of tracer.ts. The class registry encodes which OTel
+ * instrumentation packages tracer.ts attempts to load on init; each entry
+ * is optional at runtime and silently skipped if the package isn't installed
+ * (e.g. `instrumentation-aws-sdk` only loads when `@skillsmith/enterprise`
+ * is present in the consuming install).
+ */
+export async function dynamicImport(moduleName) {
+    try {
+        const importFn = new Function('m', 'return import(m)');
+        return await importFn(moduleName);
+    }
+    catch {
+        return null;
+    }
+}
+export const INSTRUMENTATION_PACKAGES = [
+    ['@opentelemetry/instrumentation-http', 'HttpInstrumentation'],
+    ['@opentelemetry/instrumentation-undici', 'UndiciInstrumentation'],
+    ['@opentelemetry/instrumentation-runtime-node', 'RuntimeNodeInstrumentation'],
+    ['@opentelemetry/instrumentation-aws-sdk', 'AwsInstrumentation'],
+];
+//# sourceMappingURL=tracer-imports.js.map

package/dist/telemetry/tracer-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer-imports.js","sourceRoot":"","sources":["../../src/telemetry/tracer-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAoC,CAAA;QACzF,OAAO,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAA;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAA6C;IAChF,CAAC,qCAAqC,EAAE,qBAAqB,CAAC;IAC9D,CAAC,uCAAuC,EAAE,uBAAuB,CAAC;IAClE,CAAC,6CAA6C,EAAE,4BAA4B,CAAC;IAC7E,CAAC,wCAAwC,EAAE,oBAAoB,CAAC;CACxD,CAAA"}

package/dist/telemetry/tracer-types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Type definitions for Skillsmith Tracer
+ * @module @skillsmith/core/telemetry/tracer-types
+ */
+/**
+ * Local type definitions matching OpenTelemetry interfaces
+ * SMI-755: Allows compilation without @opentelemetry/api installed
+ */
+export interface OTelSpan {
+    setAttributes(attributes: Record<string, unknown>): void;
+    setStatus(status: {
+        code: number;
+        message?: string;
+    }): void;
+    recordException(error: Error): void;
+    addEvent(name: string, attributes?: Record<string, unknown>): void;
+    end(): void;
+}
+export interface OTelTracer {
+    startSpan(name: string, options?: unknown): OTelSpan;
+}
+export interface OTelSpanOptions {
+    attributes?: Record<string, unknown>;
+    links?: unknown[];
+    startTime?: number;
+    root?: boolean;
+    kind?: number;
+}
+export type Span = OTelSpan;
+export type Tracer = OTelTracer;
+export type SpanOptions = OTelSpanOptions;
+export type SpanStatusCode = number;
+/**
+ * Tracer configuration
+ */
+export interface TracerConfig {
+    /** Service name for spans (default: skillsmith) */
+    serviceName?: string;
+    /** OTLP endpoint URL */
+    endpoint?: string;
+    /** Enable auto-instrumentation (default: true) */
+    autoInstrument?: boolean;
+    /** Enable console exporter for debugging (default: false) */
+    consoleExport?: boolean;
+    /** Sample rate 0-1 (default: 1.0 = 100%) */
+    sampleRate?: number;
+}
+/**
+ * Span attribute types
+ */
+export interface SpanAttributes {
+    [key: string]: string | number | boolean | string[] | number[] | boolean[] | undefined;
+}
+/**
+ * Span wrapper for easier usage
+ */
+export interface SpanWrapper {
+    /** Add attributes to span */
+    setAttributes(attributes: SpanAttributes): void;
+    /** Set span status */
+    setStatus(code: 'ok' | 'error', message?: string): void;
+    /** Record an exception */
+    recordException(error: Error): void;
+    /** Add an event to the span */
+    addEvent(name: string, attributes?: SpanAttributes): void;
+    /** End the span */
+    end(): void;
+    /** Get the underlying OTEL span (if available) */
+    getSpan(): Span | null;
+}
+/**
+ * Type-safe accessors for OTEL modules (SMI-755)
+ * These provide typed access while avoiding compile-time dependency
+ */
+export interface OTelApi {
+    trace: {
+        getTracer(name: string, version?: string): OTelTracer;
+        getActiveSpan(): OTelSpan | undefined;
+    };
+}
+export interface OTelNodeSDK {
+    new (config: unknown): {
+        start(): Promise<void>;
+        shutdown(): Promise<void>;
+    };
+}
+/**
+ * Resource factory function type (v2.x uses resourceFromAttributes instead of class)
+ */
+export type OTelResourceFromAttributes = (attributes: Record<string, string>) => unknown;
+//# sourceMappingURL=tracer-types.d.ts.map

package/dist/telemetry/tracer-types.d.ts.map

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

package/dist/telemetry/tracer-types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Skillsmith Tracer
+ * @module @skillsmith/core/telemetry/tracer-types
+ */
+export {};
+//# sourceMappingURL=tracer-types.js.map

package/dist/telemetry/tracer-types.js.map

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

package/dist/telemetry/tracer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SMI-739: OpenTelemetry Tracer Setup
+ * SMI-755: Graceful fallback when OpenTelemetry unavailable
+ *
+ * Provides distributed tracing for Skillsmith operations.
+ *
+ * @see tracer-types.ts for type definitions
+ * @see span-utils.ts for span wrapper classes
+ */
+export type { TracerConfig, SpanAttributes, SpanWrapper, Span, Tracer, SpanOptions, OTelApi, OTelNodeSDK, OTelResourceFromAttributes, } from './tracer-types.js';
+import type { TracerConfig, SpanOptions, SpanWrapper } from './tracer-types.js';
+/**
+ * Skillsmith Tracer - Wrapper for OpenTelemetry tracing
+ */
+export declare class SkillsmithTracer {
+    private tracer;
+    private initialized;
+    private enabled;
+    private config;
+    private sdkInstance;
+    constructor(config?: TracerConfig);
+    initialize(): Promise<void>;
+    isEnabled(): boolean;
+    startSpan(name: string, options?: SpanOptions): SpanWrapper;
+    withSpan<T>(name: string, fn: (span: SpanWrapper) => Promise<T>, options?: SpanOptions): Promise<T>;
+    withSpanSync<T>(name: string, fn: (span: SpanWrapper) => T, options?: SpanOptions): T;
+    getCurrentSpan(): SpanWrapper;
+    shutdown(): Promise<void>;
+}
+export declare function getTracer(): SkillsmithTracer;
+export declare function initializeTracing(config?: TracerConfig): Promise<SkillsmithTracer>;
+export declare function shutdownTracing(): Promise<void>;
+export declare function traced(spanName?: string): <T extends (...args: unknown[]) => Promise<unknown>>(target: unknown, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+//# sourceMappingURL=tracer.d.ts.map

package/dist/telemetry/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/telemetry/tracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,IAAI,EACJ,MAAM,EACN,WAAW,EACX,OAAO,EACP,WAAW,EACX,0BAA0B,GAC3B,MAAM,mBAAmB,CAAA;AAG1B,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EAKZ,MAAM,mBAAmB,CAAA;AAgC1B;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,WAAW,CAAqE;gBAE5E,MAAM,GAAE,YAAiB;IAwB/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmFjC,SAAS,IAAI,OAAO;IAIpB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW;IAMrD,QAAQ,CAAC,CAAC,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACrC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,CAAC,CAAC;IAeb,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC;IAerF,cAAc,IAAI,WAAW;IAQvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAQhC;AAKD,wBAAgB,SAAS,IAAI,gBAAgB,CAG5C;AAED,wBAAsB,iBAAiB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAKxF;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrD;AAED,wBAAgB,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,IACrB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,EACjE,QAAQ,OAAO,EACf,aAAa,MAAM,EACnB,YAAY,uBAAuB,CAAC,CAAC,CAAC,KACrC,uBAAuB,CAAC,CAAC,CAAC,CAkB9B"}

package/dist/telemetry/tracer.js

@@ -0,0 +1,242 @@
+/**
+ * SMI-739: OpenTelemetry Tracer Setup
+ * SMI-755: Graceful fallback when OpenTelemetry unavailable
+ *
+ * Provides distributed tracing for Skillsmith operations.
+ *
+ * @see tracer-types.ts for type definitions
+ * @see span-utils.ts for span wrapper classes
+ */
+import { NoOpSpanWrapper, ActiveSpanWrapper } from './span-utils.js';
+import { dynamicImport, INSTRUMENTATION_PACKAGES } from './tracer-imports.js';
+// Lazy import to avoid loading OTEL if not needed
+let api = null;
+let sdk = null;
+let resources = null;
+let semanticConventions = null;
+let otelAvailable = null;
+async function checkOTelAvailability() {
+    if (otelAvailable !== null)
+        return otelAvailable;
+    const result = await dynamicImport('@opentelemetry/api');
+    otelAvailable = result !== null;
+    return otelAvailable;
+}
+function getApi() {
+    return api;
+}
+function getSdk() {
+    return sdk;
+}
+function getResources() {
+    return resources;
+}
+function getSemanticConventions() {
+    return semanticConventions;
+}
+/**
+ * Skillsmith Tracer - Wrapper for OpenTelemetry tracing
+ */
+export class SkillsmithTracer {
+    tracer = null;
+    initialized = false;
+    enabled = false;
+    config;
+    sdkInstance = null;
+    constructor(config = {}) {
+        this.config = {
+            serviceName: config.serviceName ?? process.env.OTEL_SERVICE_NAME ?? 'skillsmith',
+            endpoint: config.endpoint ?? process.env.OTEL_EXPORTER_OTLP_ENDPOINT ?? '',
+            autoInstrument: config.autoInstrument ?? true,
+            consoleExport: config.consoleExport ?? false,
+            sampleRate: config.sampleRate ?? 1.0,
+        };
+        const telemetryDisabled = process.env.SKILLSMITH_TELEMETRY_ENABLED === 'false';
+        if (telemetryDisabled) {
+            this.enabled = false;
+            return;
+        }
+        const explicitlyEnabled = process.env.SKILLSMITH_TRACING_ENABLED === 'true';
+        const explicitlyDisabled = process.env.SKILLSMITH_TRACING_ENABLED === 'false';
+        if (explicitlyDisabled) {
+            this.enabled = false;
+        }
+        else if (explicitlyEnabled || this.config.endpoint || this.config.consoleExport) {
+            this.enabled = true;
+        }
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        if (!this.enabled) {
+            this.initialized = true;
+            return;
+        }
+        const isAvailable = await checkOTelAvailability();
+        if (!isAvailable) {
+            console.warn('[Skillsmith Telemetry] OpenTelemetry packages not installed. Tracing disabled.');
+            this.enabled = false;
+            this.initialized = true;
+            return;
+        }
+        try {
+            api = await dynamicImport('@opentelemetry/api');
+            sdk = await dynamicImport('@opentelemetry/sdk-node');
+            resources = await dynamicImport('@opentelemetry/resources');
+            semanticConventions = await dynamicImport('@opentelemetry/semantic-conventions');
+            if (!api || !sdk || !resources || !semanticConventions) {
+                console.warn('[Skillsmith Telemetry] Some OpenTelemetry packages missing. Tracing disabled.');
+                this.enabled = false;
+                this.initialized = true;
+                return;
+            }
+            const otelApi = getApi();
+            const otelSdk = getSdk();
+            const otelResources = getResources();
+            const otelSemConv = getSemanticConventions();
+            if (!otelApi || !otelSdk || !otelResources || !otelSemConv) {
+                this.enabled = false;
+                this.initialized = true;
+                return;
+            }
+            const sdkConfig = {};
+            sdkConfig.resource = otelResources.resourceFromAttributes({
+                [otelSemConv['ATTR_SERVICE_NAME'] ?? 'service.name']: this.config.serviceName,
+                [otelSemConv['ATTR_SERVICE_VERSION'] ?? 'service.version']: '0.1.0',
+            });
+            if (this.config.autoInstrument) {
+                // SMI-4250: explicit per-package instrumentation registration replaces
+                // the @opentelemetry/auto-instrumentations-node bundle (which transitively
+                // pinned @opentelemetry/core@2.5.0 across ~40 packages and blocked otel
+                // upgrades). Each entry is optional at runtime: aws-sdk only loads when
+                // @skillsmith/enterprise is in the consuming install. Registry lives in
+                // tracer-imports.ts so tests can mock the import surface.
+                const instrumentations = [];
+                for (const [pkgName, exportName] of INSTRUMENTATION_PACKAGES) {
+                    const mod = (await dynamicImport(pkgName));
+                    if (mod && typeof mod[exportName] === 'function') {
+                        const InstrumentationClass = mod[exportName];
+                        instrumentations.push(new InstrumentationClass());
+                    }
+                    else if (process.env.OTEL_LOG_LEVEL === 'debug') {
+                        console.debug(`[Skillsmith Telemetry] Instrumentation ${pkgName} not installed; skipping.`);
+                    }
+                }
+                if (instrumentations.length > 0) {
+                    sdkConfig.instrumentations = instrumentations;
+                }
+            }
+            const NodeSDK = otelSdk.NodeSDK;
+            this.sdkInstance = new NodeSDK(sdkConfig);
+            await this.sdkInstance.start();
+            this.tracer = otelApi.trace.getTracer(this.config.serviceName, '0.1.0');
+            this.initialized = true;
+        }
+        catch (error) {
+            console.warn('[Skillsmith Telemetry] Failed to initialize OpenTelemetry tracing:', error);
+            this.enabled = false;
+            this.initialized = true;
+        }
+    }
+    isEnabled() {
+        return this.enabled && this.initialized;
+    }
+    startSpan(name, options) {
+        if (!this.isEnabled() || !this.tracer)
+            return new NoOpSpanWrapper();
+        const span = this.tracer.startSpan(name, options);
+        return new ActiveSpanWrapper(span);
+    }
+    async withSpan(name, fn, options) {
+        const spanWrapper = this.startSpan(name, options);
+        try {
+            const result = await fn(spanWrapper);
+            spanWrapper.setStatus('ok');
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error)
+                spanWrapper.recordException(error);
+            spanWrapper.setStatus('error', error instanceof Error ? error.message : 'Unknown error');
+            throw error;
+        }
+        finally {
+            spanWrapper.end();
+        }
+    }
+    withSpanSync(name, fn, options) {
+        const spanWrapper = this.startSpan(name, options);
+        try {
+            const result = fn(spanWrapper);
+            spanWrapper.setStatus('ok');
+            return result;
+        }
+        catch (error) {
+            if (error instanceof Error)
+                spanWrapper.recordException(error);
+            spanWrapper.setStatus('error', error instanceof Error ? error.message : 'Unknown error');
+            throw error;
+        }
+        finally {
+            spanWrapper.end();
+        }
+    }
+    getCurrentSpan() {
+        const otelApi = getApi();
+        if (!otelApi)
+            return new NoOpSpanWrapper();
+        const span = otelApi.trace.getActiveSpan();
+        if (!span)
+            return new NoOpSpanWrapper();
+        return new ActiveSpanWrapper(span);
+    }
+    async shutdown() {
+        if (this.sdkInstance) {
+            await this.sdkInstance.shutdown();
+            this.sdkInstance = null;
+        }
+        this.tracer = null;
+        this.initialized = false;
+    }
+}
+// Default tracer instance
+let defaultTracer = null;
+export function getTracer() {
+    if (!defaultTracer)
+        defaultTracer = new SkillsmithTracer();
+    return defaultTracer;
+}
+export async function initializeTracing(config) {
+    if (defaultTracer)
+        await defaultTracer.shutdown();
+    defaultTracer = new SkillsmithTracer(config);
+    await defaultTracer.initialize();
+    return defaultTracer;
+}
+export async function shutdownTracing() {
+    if (defaultTracer) {
+        await defaultTracer.shutdown();
+        defaultTracer = null;
+    }
+}
+export function traced(spanName) {
+    return function (target, propertyKey, descriptor) {
+        const originalMethod = descriptor.value;
+        if (!originalMethod)
+            return descriptor;
+        descriptor.value = async function (...args) {
+            const tracer = getTracer();
+            const name = spanName ?? `${target.constructor.name}.${propertyKey}`;
+            const boundMethod = originalMethod.bind(this);
+            return tracer.withSpan(name, async (span) => {
+                span.setAttributes({
+                    'code.function': propertyKey,
+                    'code.namespace': target.constructor.name,
+                });
+                return boundMethod(...args);
+            });
+        };
+        return descriptor;
+    };
+}
+//# sourceMappingURL=tracer.js.map

package/dist/telemetry/tracer.js.map

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

package/dist/testing/MultiLLMProvider.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview Multi-LLM Provider Chain for Skill Compatibility Testing
+ * @module @skillsmith/core/testing/MultiLLMProvider
+ * @see SMI-1523: Configure multi-LLM provider chain
+ * @see SMI-2741: Split to meet 500-line standard
+ *
+ * Provides a unified interface for testing skills across multiple LLM providers:
+ * - Claude (Anthropic) - Primary
+ * - GPT (OpenAI) - Fallback 1
+ * - Gemini (Google) - Fallback 2
+ * - Cohere (Command) - Fallback 3
+ * - Ollama (Local) - Fallback 4
+ *
+ * Features:
+ * - Automatic failover with configurable strategy
+ * - Health monitoring and circuit breaker pattern
+ * - Cost-aware provider selection
+ * - Skill compatibility testing across providers
+ */
+import { EventEmitter } from 'events';
+export type { LLMProviderType, ProviderPriority, LoadBalanceStrategy, FailoverCondition, ProviderConfig, FallbackRule, FallbackStrategy, CircuitBreakerConfig, MultiLLMProviderConfig, HealthCheckResult, ProviderStatus, LLMRequest, LLMResponse, ProviderMetrics, SkillCompatibilityResult, ResolvedMultiLLMConfig, } from './MultiLLMProvider.types.js';
+export { DEFAULT_MULTI_LLM_CONFIG } from './MultiLLMProvider.types.js';
+export { CircuitBreaker, getErrorCondition, estimateTokens, calculateCost, calculateCompatibilityScore, } from './MultiLLMProvider.helpers.js';
+export type { CircuitState, CircuitBreakerMetrics } from './MultiLLMProvider.helpers.js';
+export { selectProvider, selectRoundRobin, selectLeastLoaded, selectByLatency, selectByCost, getFallbackProvider, } from './MultiLLMProvider.selection.js';
+export { aggregateMetrics, runCompatibilityTest } from './MultiLLMProvider.metrics.js';
+import type { LLMProviderType, MultiLLMProviderConfig, HealthCheckResult, ProviderStatus, LLMRequest, LLMResponse, ProviderMetrics, SkillCompatibilityResult } from './MultiLLMProvider.types.js';
+/**
+ * Multi-LLM Provider for skill compatibility testing
+ *
+ * Provides unified access to multiple LLM providers with automatic failover,
+ * load balancing, and cost optimization.
+ *
+ * @example
+ * ```typescript
+ * const provider = new MultiLLMProvider()
+ * await provider.initialize()
+ *
+ * // Complete a request with automatic failover
+ * const response = await provider.complete({
+ *   messages: [{ role: 'user', content: 'Explain this skill' }]
+ * })
+ *
+ * // Test skill compatibility across providers
+ * const compatibility = await provider.testSkillCompatibility('commit')
+ * ```
+ */
+export declare class MultiLLMProvider extends EventEmitter {
+    private config;
+    private initialized;
+    private circuitBreakers;
+    private providerMetrics;
+    private activeRequests;
+    private roundRobinIndex;
+    private v3ProviderManager;
+    constructor(config?: MultiLLMProviderConfig);
+    /** Initialize the multi-LLM provider */
+    initialize(): Promise<void>;
+    /** Check if provider is initialized */
+    isInitialized(): boolean;
+    /** Get enabled providers */
+    getEnabledProviders(): LLMProviderType[];
+    /** Get available providers (enabled + circuit closed) */
+    getAvailableProviders(): LLMProviderType[];
+    /** Check provider health */
+    healthCheck(provider: LLMProviderType): Promise<HealthCheckResult>;
+    /** Get provider status */
+    getProviderStatus(provider: LLMProviderType): ProviderStatus;
+    /** Complete a request with automatic failover */
+    complete(request: LLMRequest): Promise<LLMResponse>;
+    /** Test skill compatibility across providers */
+    testSkillCompatibility(skillId: string): Promise<SkillCompatibilityResult>;
+    /** Get provider metrics */
+    getMetrics(): Map<LLMProviderType, ProviderMetrics>;
+    /** Get aggregated metrics */
+    getAggregatedMetrics(): {
+        totalRequests: number;
+        totalCost: number;
+        avgLatencyMs: number;
+        avgSuccessRate: number;
+        providerBreakdown: Record<LLMProviderType, number>;
+    };
+    /** Close and cleanup */
+    close(): void;
+    private ensureInitialized;
+    private initializeV3Integration;
+    private doSelectProvider;
+    private doGetFallbackProvider;
+    private executeRequest;
+    private initializeMetrics;
+    private updateMetrics;
+}
+/**
+ * Create and initialize a MultiLLMProvider instance
+ */
+export declare function createMultiLLMProvider(config?: MultiLLMProviderConfig): Promise<MultiLLMProvider>;
+//# sourceMappingURL=MultiLLMProvider.d.ts.map

package/dist/testing/MultiLLMProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiLLMProvider.d.ts","sourceRoot":"","sources":["../../src/testing/MultiLLMProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAGrC,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAGtE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,2BAA2B,GAC5B,MAAM,+BAA+B,CAAA;AACtC,YAAY,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAGxF,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,mBAAmB,GACpB,MAAM,iCAAiC,CAAA;AAGxC,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAGtF,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EAEtB,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,WAAW,EACX,eAAe,EACf,wBAAwB,EAEzB,MAAM,6BAA6B,CAAA;AAepC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAkD;IACzE,OAAO,CAAC,eAAe,CAAmD;IAC1E,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,eAAe,CAAI;IAG3B,OAAO,CAAC,iBAAiB,CAAgB;gBAE7B,MAAM,GAAE,sBAA2B;IAa/C,wCAAwC;IAClC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC,uCAAuC;IACvC,aAAa,IAAI,OAAO;IAIxB,4BAA4B;IAC5B,mBAAmB,IAAI,eAAe,EAAE;IAMxC,yDAAyD;IACzD,qBAAqB,IAAI,eAAe,EAAE;IAO1C,4BAA4B;IACtB,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4BxE,0BAA0B;IAC1B,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,cAAc;IAe5D,iDAAiD;IAC3C,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAgDzD,gDAAgD;IAC1C,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAKhF,2BAA2B;IAC3B,UAAU,IAAI,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC;IAInD,6BAA6B;IAC7B,oBAAoB,IAAI;QACtB,aAAa,EAAE,MAAM,CAAA;QACrB,SAAS,EAAE,MAAM,CAAA;QACjB,YAAY,EAAE,MAAM,CAAA;QACpB,cAAc,EAAE,MAAM,CAAA;QACtB,iBAAiB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAA;KACnD;IAID,wBAAwB;IACxB,KAAK,IAAI,IAAI;IAcb,OAAO,CAAC,iBAAiB;YAQX,uBAAuB;IAKrC,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,qBAAqB;YAcf,cAAc;IAoC5B,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,aAAa;CAgCtB;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,GAAE,sBAA2B,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAI3B"}

package/dist/testing/MultiLLMProvider.helpers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Multi-LLM Provider Helper Functions and Classes
+ * @module @skillsmith/core/testing/MultiLLMProvider.helpers
+ */
+import type { CircuitBreakerConfig, ProviderConfig, FailoverCondition, LLMResponse } from './MultiLLMProvider.types.js';
+/** Circuit breaker state type */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+/** Circuit breaker metrics */
+export interface CircuitBreakerMetrics {
+    failures: number;
+    successes: number;
+    errorRate: number;
+}
+/**
+ * Simple circuit breaker for provider failover
+ */
+export declare class CircuitBreaker {
+    private config;
+    private state;
+    private failures;
+    private successes;
+    private lastFailureTime;
+    private totalRequests;
+    constructor(config: CircuitBreakerConfig);
+    getState(): CircuitState;
+    recordSuccess(): void;
+    recordFailure(): void;
+    canExecute(): boolean;
+    reset(): void;
+    getMetrics(): CircuitBreakerMetrics;
+}
+/**
+ * Determine error condition from error object
+ */
+export declare function getErrorCondition(error: unknown): FailoverCondition;
+/**
+ * Estimate token count from text
+ * Rough estimate: ~4 characters per token
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Calculate cost from token counts
+ */
+export declare function calculateCost(config: ProviderConfig, inputTokens: number, outputTokens: number): number;
+/**
+ * Calculate compatibility score from response
+ * Simple scoring based on latency and success
+ */
+export declare function calculateCompatibilityScore(response: LLMResponse): number;
+/**
+ * Simulate network request (for testing)
+ */
+export declare function simulateRequest(_config: ProviderConfig): Promise<void>;
+//# sourceMappingURL=MultiLLMProvider.helpers.d.ts.map

package/dist/testing/MultiLLMProvider.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiLLMProvider.helpers.d.ts","sourceRoot":"","sources":["../../src/testing/MultiLLMProvider.helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,WAAW,EACZ,MAAM,6BAA6B,CAAA;AAMpC,iCAAiC;AACjC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAA;AAE1D,8BAA8B;AAC9B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,qBAAa,cAAc;IAOb,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,aAAa,CAAI;gBAEL,MAAM,EAAE,oBAAoB;IAEhD,QAAQ,IAAI,YAAY;IAUxB,aAAa,IAAI,IAAI;IASrB,aAAa,IAAI,IAAI;IAarB,UAAU,IAAI,OAAO;IAKrB,KAAK,IAAI,IAAI;IAQb,UAAU,IAAI,qBAAqB;CAQpC;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAkBnE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAIzE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAU5E"}