@planu/cli 0.30.0 → 0.31.0

package/dist/engine/llm-providers/health-checker.d.ts

@@ -0,0 +1,18 @@
+import type { LLMProviderDefinition, ProviderHealthResult, LLMProviderId } from '../../types/index.js';
+/**
+ * Check health of a single provider. Results are cached for `cacheTtlMs` milliseconds.
+ */
+export declare function checkProviderHealth(definition: LLMProviderDefinition, cacheTtlMs?: number): ProviderHealthResult;
+/**
+ * Check health of all configured providers.
+ */
+export declare function checkAllProvidersHealth(definitions: LLMProviderDefinition[], cacheTtlMs?: number): ProviderHealthResult[];
+/**
+ * Get providers filtered by health status.
+ */
+export declare function getHealthyProviders(definitions: LLMProviderDefinition[]): LLMProviderId[];
+/**
+ * Clear the health cache (useful for testing or force-refresh).
+ */
+export declare function clearHealthCache(): void;
+//# sourceMappingURL=health-checker.d.ts.map

package/dist/engine/llm-providers/health-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-checker.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/health-checker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACd,MAAM,sBAAsB,CAAC;AAS9B;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,qBAAqB,EACjC,UAAU,GAAE,MAA6B,GACxC,oBAAoB,CActB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,qBAAqB,EAAE,EACpC,UAAU,CAAC,EAAE,MAAM,GAClB,oBAAoB,EAAE,CAExB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,aAAa,EAAE,CAOzF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/engine/llm-providers/health-checker.js

@@ -0,0 +1,45 @@
+// engine/llm-providers/health-checker.ts — Provider health checking.
+// SPEC-083 AC-07
+import { createProviderAdapter } from './provider-adapter.js';
+/** Cache for health check results with TTL. */
+const healthCache = new Map();
+/** Default cache TTL in milliseconds (5 minutes). */
+const DEFAULT_CACHE_TTL_MS = 5 * 60 * 1000;
+/**
+ * Check health of a single provider. Results are cached for `cacheTtlMs` milliseconds.
+ */
+export function checkProviderHealth(definition, cacheTtlMs = DEFAULT_CACHE_TTL_MS) {
+    const now = Date.now();
+    const cached = healthCache.get(definition.id);
+    if (cached && cached.expiry > now) {
+        return cached.result;
+    }
+    const adapter = createProviderAdapter(definition);
+    const result = adapter.checkHealth();
+    healthCache.set(definition.id, { result, expiry: now + cacheTtlMs });
+    return result;
+}
+/**
+ * Check health of all configured providers.
+ */
+export function checkAllProvidersHealth(definitions, cacheTtlMs) {
+    return definitions.map((def) => checkProviderHealth(def, cacheTtlMs));
+}
+/**
+ * Get providers filtered by health status.
+ */
+export function getHealthyProviders(definitions) {
+    return definitions
+        .filter((def) => {
+        const health = checkProviderHealth(def);
+        return health.status === 'healthy';
+    })
+        .map((def) => def.id);
+}
+/**
+ * Clear the health cache (useful for testing or force-refresh).
+ */
+export function clearHealthCache() {
+    healthCache.clear();
+}
+//# sourceMappingURL=health-checker.js.map

package/dist/engine/llm-providers/health-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-checker.js","sourceRoot":"","sources":["../../../src/engine/llm-providers/health-checker.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,iBAAiB;AAOjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,+CAA+C;AAC/C,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4D,CAAC;AAExF,qDAAqD;AACrD,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAiC,EACjC,aAAqB,oBAAoB;IAEzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAE9C,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAErC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,UAAU,EAAE,CAAC,CAAC;IAErE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAoC,EACpC,UAAmB;IAEnB,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAoC;IACtE,OAAO,WAAW;SACf,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;QACd,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC;IACrC,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/dist/engine/llm-providers/index.d.ts

@@ -0,0 +1,10 @@
+export { createProviderAdapter, BaseProviderAdapter, OllamaAdapter } from './provider-adapter.js';
+export { checkApiKey, checkMultipleKeys, getKeyStatusSummary } from './key-manager.js';
+export { checkProviderHealth, checkAllProvidersHealth, getHealthyProviders, clearHealthCache, } from './health-checker.js';
+export { resolveFailover, getFailoverLog, clearFailoverLog, buildDefaultChain, } from './failover-chain.js';
+export { balanceLoad, recordRequest, recordLatency, resetLoadBalancer } from './load-balancer.js';
+export { optimizeCost, calculateSavings, complexityToTier, getEquivalences, } from './cost-optimizer.js';
+export type { TaskComplexity } from './cost-optimizer.js';
+export { trackRequest, getRateLimitState, isNearRateLimit, getRateLimitHealthStatus, suggestAlternatives, resetRateLimits, } from './rate-limiter.js';
+export { recordCost, getCostSummary, getAllCostSummaries, getCostRecords, loadCostRecords, clearCostRecords, } from './cost-tracker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/llm-providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/engine/llm-providers/index.js

@@ -0,0 +1,11 @@
+// engine/llm-providers/index.ts — Barrel export for LLM provider engine.
+// SPEC-083
+export { createProviderAdapter, BaseProviderAdapter, OllamaAdapter } from './provider-adapter.js';
+export { checkApiKey, checkMultipleKeys, getKeyStatusSummary } from './key-manager.js';
+export { checkProviderHealth, checkAllProvidersHealth, getHealthyProviders, clearHealthCache, } from './health-checker.js';
+export { resolveFailover, getFailoverLog, clearFailoverLog, buildDefaultChain, } from './failover-chain.js';
+export { balanceLoad, recordRequest, recordLatency, resetLoadBalancer } from './load-balancer.js';
+export { optimizeCost, calculateSavings, complexityToTier, getEquivalences, } from './cost-optimizer.js';
+export { trackRequest, getRateLimitState, isNearRateLimit, getRateLimitHealthStatus, suggestAlternatives, resetRateLimits, } from './rate-limiter.js';
+export { recordCost, getCostSummary, getAllCostSummaries, getCostRecords, loadCostRecords, clearCostRecords, } from './cost-tracker.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/llm-providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/llm-providers/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,WAAW;AAEX,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/engine/llm-providers/key-manager.d.ts

@@ -0,0 +1,23 @@
+import type { ApiKeyStatus, LLMProviderId } from '../../types/index.js';
+/**
+ * Check if an API key environment variable is set and matches the expected pattern.
+ * Never logs or returns the actual key value — only status.
+ */
+export declare function checkApiKey(envVarName: string, keyPattern: string): ApiKeyStatus;
+/**
+ * Check API keys for multiple environment variable names (supports multiple keys per provider).
+ * Returns 'configured' if at least one key is valid.
+ */
+export declare function checkMultipleKeys(envVarNames: string[], keyPattern: string): ApiKeyStatus;
+/**
+ * Get a summary of API key status for all providers.
+ */
+export declare function getKeyStatusSummary(providers: {
+    id: LLMProviderId;
+    apiKeyEnv: string;
+    keyPattern: string;
+}[]): {
+    providerId: LLMProviderId;
+    status: ApiKeyStatus;
+}[];
+//# sourceMappingURL=key-manager.d.ts.map

package/dist/engine/llm-providers/key-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-manager.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/key-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAExE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAgBhF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAczF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE;IAAE,EAAE,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAAE,GACxE;IAAE,UAAU,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,EAAE,CAKvD"}

package/dist/engine/llm-providers/key-manager.js

@@ -0,0 +1,47 @@
+// engine/llm-providers/key-manager.ts — API key management.
+// SPEC-083 AC-11
+/**
+ * Check if an API key environment variable is set and matches the expected pattern.
+ * Never logs or returns the actual key value — only status.
+ */
+export function checkApiKey(envVarName, keyPattern) {
+    if (!envVarName) {
+        // Provider doesn't require an API key (e.g., Ollama)
+        return 'configured';
+    }
+    const value = process.env[envVarName];
+    if (!value) {
+        return 'missing';
+    }
+    if (keyPattern && !new RegExp(keyPattern).test(value)) {
+        return 'invalid_format';
+    }
+    return 'configured';
+}
+/**
+ * Check API keys for multiple environment variable names (supports multiple keys per provider).
+ * Returns 'configured' if at least one key is valid.
+ */
+export function checkMultipleKeys(envVarNames, keyPattern) {
+    if (envVarNames.length === 0) {
+        return 'configured';
+    }
+    const statuses = envVarNames.map((name) => checkApiKey(name, keyPattern));
+    if (statuses.some((s) => s === 'configured')) {
+        return 'configured';
+    }
+    if (statuses.some((s) => s === 'invalid_format')) {
+        return 'invalid_format';
+    }
+    return 'missing';
+}
+/**
+ * Get a summary of API key status for all providers.
+ */
+export function getKeyStatusSummary(providers) {
+    return providers.map((p) => ({
+        providerId: p.id,
+        status: checkApiKey(p.apiKeyEnv, p.keyPattern),
+    }));
+}
+//# sourceMappingURL=key-manager.js.map

package/dist/engine/llm-providers/key-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-manager.js","sourceRoot":"","sources":["../../../src/engine/llm-providers/key-manager.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,iBAAiB;AAIjB;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,UAAkB;IAChE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,qDAAqD;QACrD,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,UAAU,IAAI,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAqB,EAAE,UAAkB;IACzE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAE1E,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,CAAC,EAAE,CAAC;QAC7C,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,gBAAgB,CAAC,EAAE,CAAC;QACjD,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAyE;IAEzE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3B,UAAU,EAAE,CAAC,CAAC,EAAE;QAChB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC;KAC/C,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/engine/llm-providers/load-balancer.d.ts

@@ -0,0 +1,13 @@
+import type { LLMProviderDefinition, LLMProviderId, LoadBalancingStrategy, ProviderRecommendation, QualityTier } from '../../types/index.js';
+/**
+ * Rank providers using the specified load balancing strategy.
+ * Returns an ordered list of recommendations (best first).
+ */
+export declare function balanceLoad(definitions: LLMProviderDefinition[], strategy: LoadBalancingStrategy, tier: QualityTier): ProviderRecommendation[];
+/** Update simulated request count for a provider. */
+export declare function recordRequest(providerId: LLMProviderId): void;
+/** Update simulated latency for a provider. */
+export declare function recordLatency(providerId: LLMProviderId, latencyMs: number): void;
+/** Reset all load balancer state (for testing). */
+export declare function resetLoadBalancer(): void;
+//# sourceMappingURL=load-balancer.d.ts.map

package/dist/engine/llm-providers/load-balancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-balancer.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/load-balancer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAY9B;;;GAGG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,qBAAqB,EAAE,EACpC,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,EAAE,WAAW,GAChB,sBAAsB,EAAE,CAoB1B;AAoED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI,CAE7D;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAEhF;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}

package/dist/engine/llm-providers/load-balancer.js

@@ -0,0 +1,94 @@
+// engine/llm-providers/load-balancer.ts — Load balancing strategies.
+// SPEC-083 AC-04
+import { checkProviderHealth } from './health-checker.js';
+/** Round-robin state: index per invocation. */
+let roundRobinIndex = 0;
+/** Simulated request counts per provider (for least-loaded). */
+const requestCounts = new Map();
+/** Simulated latency records per provider (for latency-based). */
+const latencyRecords = new Map();
+/**
+ * Rank providers using the specified load balancing strategy.
+ * Returns an ordered list of recommendations (best first).
+ */
+export function balanceLoad(definitions, strategy, tier) {
+    const healthy = definitions.filter((d) => {
+        const h = checkProviderHealth(d);
+        return h.status !== 'unavailable';
+    });
+    if (healthy.length === 0) {
+        return [];
+    }
+    switch (strategy) {
+        case 'round-robin':
+            return rankRoundRobin(healthy, tier);
+        case 'least-loaded':
+            return rankLeastLoaded(healthy, tier);
+        case 'latency-based':
+            return rankLatencyBased(healthy, tier);
+        case 'cost-based':
+            return rankCostBased(healthy, tier);
+    }
+}
+function rankRoundRobin(defs, tier) {
+    const start = roundRobinIndex % defs.length;
+    roundRobinIndex++;
+    const ordered = [...defs.slice(start), ...defs.slice(0, start)];
+    return ordered.map((d, i) => buildRecommendation(d, tier, 1.0 - i * 0.1, 'round-robin'));
+}
+function rankLeastLoaded(defs, tier) {
+    const sorted = [...defs].sort((a, b) => {
+        const countA = requestCounts.get(a.id) ?? 0;
+        const countB = requestCounts.get(b.id) ?? 0;
+        return countA - countB;
+    });
+    return sorted.map((d, i) => buildRecommendation(d, tier, 1.0 - i * 0.1, 'least-loaded'));
+}
+function rankLatencyBased(defs, tier) {
+    const sorted = [...defs].sort((a, b) => {
+        const latA = latencyRecords.get(a.id) ?? 500;
+        const latB = latencyRecords.get(b.id) ?? 500;
+        return latA - latB;
+    });
+    return sorted.map((d, i) => buildRecommendation(d, tier, 1.0 - i * 0.1, 'latency-based'));
+}
+function rankCostBased(defs, tier) {
+    const sorted = [...defs].sort((a, b) => {
+        const modelA = a.models.find((m) => m.tier === tier) ?? a.models[0];
+        const modelB = b.models.find((m) => m.tier === tier) ?? b.models[0];
+        const costA = modelA
+            ? modelA.pricingPerMToken.input + modelA.pricingPerMToken.output
+            : Infinity;
+        const costB = modelB
+            ? modelB.pricingPerMToken.input + modelB.pricingPerMToken.output
+            : Infinity;
+        return costA - costB;
+    });
+    return sorted.map((d, i) => buildRecommendation(d, tier, 1.0 - i * 0.1, 'cost-based'));
+}
+function buildRecommendation(def, tier, score, strategy) {
+    const model = def.models.find((m) => m.tier === tier) ?? def.models[0];
+    return {
+        providerId: def.id,
+        modelId: model?.id ?? 'unknown',
+        tier: model?.tier ?? tier,
+        costEstimate: { tokensEstimated: 0, usdEstimated: 0 },
+        reasoning: [`Selected via ${strategy} strategy`],
+        score: Math.max(score, 0.1),
+    };
+}
+/** Update simulated request count for a provider. */
+export function recordRequest(providerId) {
+    requestCounts.set(providerId, (requestCounts.get(providerId) ?? 0) + 1);
+}
+/** Update simulated latency for a provider. */
+export function recordLatency(providerId, latencyMs) {
+    latencyRecords.set(providerId, latencyMs);
+}
+/** Reset all load balancer state (for testing). */
+export function resetLoadBalancer() {
+    roundRobinIndex = 0;
+    requestCounts.clear();
+    latencyRecords.clear();
+}
+//# sourceMappingURL=load-balancer.js.map

package/dist/engine/llm-providers/load-balancer.js.map

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

package/dist/engine/llm-providers/provider-adapter.d.ts

@@ -0,0 +1,25 @@
+import type { LLMProviderDefinition, LLMProviderAdapter, LLMModelDefinition, ProviderHealthResult, LLMProviderId, ApiKeyStatus } from '../../types/index.js';
+/**
+ * Base adapter implementation shared by all providers.
+ * Validates config and reports status without making real API calls.
+ */
+export declare class BaseProviderAdapter implements LLMProviderAdapter {
+    readonly providerId: LLMProviderId;
+    protected readonly definition: LLMProviderDefinition;
+    constructor(definition: LLMProviderDefinition);
+    checkHealth(): ProviderHealthResult;
+    getModels(): LLMModelDefinition[];
+    estimateCost(inputTokens: number, outputTokens: number, modelId?: string): number;
+    getStatus(): ProviderHealthResult;
+    protected getApiKeyStatus(): ApiKeyStatus;
+    private buildHealthDetails;
+}
+/** Ollama-specific adapter: no API key required, checks local port. */
+export declare class OllamaAdapter extends BaseProviderAdapter {
+    checkHealth(): ProviderHealthResult;
+}
+/**
+ * Factory function to create the appropriate adapter for a provider.
+ */
+export declare function createProviderAdapter(definition: LLMProviderDefinition): LLMProviderAdapter;
+//# sourceMappingURL=provider-adapter.d.ts.map

package/dist/engine/llm-providers/provider-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-adapter.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/provider-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACb,MAAM,sBAAsB,CAAC;AAG9B;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,kBAAkB;IAC5D,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;gBAEzC,UAAU,EAAE,qBAAqB;IAK7C,WAAW,IAAI,oBAAoB;IAkBnC,SAAS,IAAI,kBAAkB,EAAE;IAIjC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAYjF,SAAS,IAAI,oBAAoB;IAIjC,SAAS,CAAC,eAAe,IAAI,YAAY;IAIzC,OAAO,CAAC,kBAAkB;CAS3B;AAED,uEAAuE;AACvE,qBAAa,aAAc,SAAQ,mBAAmB;IACpD,WAAW,IAAI,oBAAoB;CAgBpC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,qBAAqB,GAAG,kBAAkB,CAK3F"}

package/dist/engine/llm-providers/provider-adapter.js

@@ -0,0 +1,86 @@
+// engine/llm-providers/provider-adapter.ts — Provider adapter interface + factory.
+// SPEC-083 AC-02
+import { checkApiKey } from './key-manager.js';
+/**
+ * Base adapter implementation shared by all providers.
+ * Validates config and reports status without making real API calls.
+ */
+export class BaseProviderAdapter {
+    providerId;
+    definition;
+    constructor(definition) {
+        this.providerId = definition.id;
+        this.definition = definition;
+    }
+    checkHealth() {
+        const apiKeyStatus = this.getApiKeyStatus();
+        const status = apiKeyStatus === 'configured'
+            ? 'healthy'
+            : apiKeyStatus === 'invalid_format'
+                ? 'degraded'
+                : 'unavailable';
+        return {
+            providerId: this.providerId,
+            status,
+            apiKeyStatus,
+            lastChecked: new Date().toISOString(),
+            details: this.buildHealthDetails(apiKeyStatus),
+        };
+    }
+    getModels() {
+        return this.definition.models;
+    }
+    estimateCost(inputTokens, outputTokens, modelId) {
+        const model = modelId
+            ? this.definition.models.find((m) => m.id === modelId)
+            : this.definition.models[0];
+        if (!model) {
+            return 0;
+        }
+        const inputCost = (inputTokens / 1_000_000) * model.pricingPerMToken.input;
+        const outputCost = (outputTokens / 1_000_000) * model.pricingPerMToken.output;
+        return inputCost + outputCost;
+    }
+    getStatus() {
+        return this.checkHealth();
+    }
+    getApiKeyStatus() {
+        return checkApiKey(this.definition.apiKeyEnv, this.definition.keyPattern);
+    }
+    buildHealthDetails(keyStatus) {
+        if (keyStatus === 'configured') {
+            return `${this.definition.name} is configured and ready.`;
+        }
+        if (keyStatus === 'invalid_format') {
+            return `${this.definition.name} API key is present but has unexpected format.`;
+        }
+        return `${this.definition.name} API key (${this.definition.apiKeyEnv}) is not set.`;
+    }
+}
+/** Ollama-specific adapter: no API key required, checks local port. */
+export class OllamaAdapter extends BaseProviderAdapter {
+    checkHealth() {
+        // Ollama doesn't require an API key; check if port config is set
+        const isLocal = this.definition.baseUrl.includes('localhost') ||
+            this.definition.baseUrl.includes('127.0.0.1');
+        return {
+            providerId: this.providerId,
+            status: isLocal ? 'healthy' : 'degraded',
+            apiKeyStatus: 'configured',
+            lastChecked: new Date().toISOString(),
+            details: isLocal
+                ? 'Ollama configured for local usage (port 11434). No API key required.'
+                : 'Ollama configured with non-local URL. Verify connectivity.',
+        };
+    }
+}
+/**
+ * Factory function to create the appropriate adapter for a provider.
+ */
+export function createProviderAdapter(definition) {
+    if (definition.id === 'ollama') {
+        return new OllamaAdapter(definition);
+    }
+    return new BaseProviderAdapter(definition);
+}
+//# sourceMappingURL=provider-adapter.js.map

package/dist/engine/llm-providers/provider-adapter.js.map

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

package/dist/engine/llm-providers/rate-limiter.d.ts

@@ -0,0 +1,29 @@
+import type { LLMProviderDefinition, LLMProviderId, RateLimitState, ProviderHealthStatus } from '../../types/index.js';
+/**
+ * Record a request against a provider's rate limit window.
+ */
+export declare function trackRequest(providerId: LLMProviderId, tokensUsed: number, limits: {
+    requestsPerMinute: number;
+    tokensPerMinute: number;
+}): RateLimitState;
+/**
+ * Get the current rate limit state for a provider.
+ */
+export declare function getRateLimitState(providerId: LLMProviderId): RateLimitState | undefined;
+/**
+ * Check if a provider is near its rate limit (>80% capacity).
+ */
+export declare function isNearRateLimit(providerId: LLMProviderId): boolean;
+/**
+ * Get health status adjustment based on rate limiting.
+ */
+export declare function getRateLimitHealthStatus(providerId: LLMProviderId): ProviderHealthStatus;
+/**
+ * Get suggested alternative providers when one is near its rate limit.
+ */
+export declare function suggestAlternatives(currentProvider: LLMProviderId, allProviders: LLMProviderDefinition[]): LLMProviderId[];
+/**
+ * Reset all rate limit state (for testing).
+ */
+export declare function resetRateLimits(): void;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/engine/llm-providers/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/rate-limiter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAQ9B;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,aAAa,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAC7D,cAAc,CAyBhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,aAAa,GAAG,cAAc,GAAG,SAAS,CAEvF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAMlE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,aAAa,GAAG,oBAAoB,CAKxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,aAAa,EAC9B,YAAY,EAAE,qBAAqB,EAAE,GACpC,aAAa,EAAE,CAIjB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/engine/llm-providers/rate-limiter.js

@@ -0,0 +1,70 @@
+// engine/llm-providers/rate-limiter.ts — Rate limiting awareness.
+// SPEC-083 AC-10
+/** In-memory rate limit tracking per provider. */
+const rateLimitStates = new Map();
+/** Threshold percentage at which a provider is considered degraded. */
+const DEGRADED_THRESHOLD = 0.8;
+/**
+ * Record a request against a provider's rate limit window.
+ */
+export function trackRequest(providerId, tokensUsed, limits) {
+    const now = new Date();
+    const existing = rateLimitStates.get(providerId);
+    // Reset window if older than 1 minute
+    const windowStart = existing?.windowStart ?? now.toISOString();
+    const windowAge = now.getTime() - new Date(windowStart).getTime();
+    const shouldReset = windowAge > 60_000;
+    const state = {
+        providerId,
+        requestsUsed: shouldReset ? 1 : (existing?.requestsUsed ?? 0) + 1,
+        tokensUsed: shouldReset ? tokensUsed : (existing?.tokensUsed ?? 0) + tokensUsed,
+        windowStart: shouldReset ? now.toISOString() : windowStart,
+        capacityPercent: 0,
+    };
+    // Calculate capacity as the max of request% and token%
+    const requestPercent = limits.requestsPerMinute > 0 ? state.requestsUsed / limits.requestsPerMinute : 0;
+    const tokenPercent = limits.tokensPerMinute > 0 ? state.tokensUsed / limits.tokensPerMinute : 0;
+    state.capacityPercent = Math.max(requestPercent, tokenPercent);
+    rateLimitStates.set(providerId, state);
+    return state;
+}
+/**
+ * Get the current rate limit state for a provider.
+ */
+export function getRateLimitState(providerId) {
+    return rateLimitStates.get(providerId);
+}
+/**
+ * Check if a provider is near its rate limit (>80% capacity).
+ */
+export function isNearRateLimit(providerId) {
+    const state = rateLimitStates.get(providerId);
+    if (!state) {
+        return false;
+    }
+    return state.capacityPercent >= DEGRADED_THRESHOLD;
+}
+/**
+ * Get health status adjustment based on rate limiting.
+ */
+export function getRateLimitHealthStatus(providerId) {
+    if (isNearRateLimit(providerId)) {
+        return 'degraded';
+    }
+    return 'healthy';
+}
+/**
+ * Get suggested alternative providers when one is near its rate limit.
+ */
+export function suggestAlternatives(currentProvider, allProviders) {
+    return allProviders
+        .filter((p) => p.id !== currentProvider && !isNearRateLimit(p.id))
+        .map((p) => p.id);
+}
+/**
+ * Reset all rate limit state (for testing).
+ */
+export function resetRateLimits() {
+    rateLimitStates.clear();
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/engine/llm-providers/rate-limiter.js.map

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

package/dist/engine/orchestrator/agent-spawner.d.ts

@@ -0,0 +1,22 @@
+import type { RuntimeAgentConfig, RuntimeAgentProcess, RuntimeSpawnDescriptor, RuntimeSpawnMethod } from '../../types/index.js';
+/**
+ * Build a spawn descriptor for an agent based on spawn method.
+ * Language-agnostic: command is fully configurable per agent.
+ */
+export declare function buildSpawnDescriptor(agent: RuntimeAgentConfig, context: string, spawnMethod: RuntimeSpawnMethod, timeoutMs: number): RuntimeSpawnDescriptor;
+/**
+ * Create an initial AgentProcess record in pending state.
+ */
+export declare function createAgentProcess(agentId: string): RuntimeAgentProcess;
+/**
+ * Spawn an agent as a child process (real execution).
+ * Returns a new RuntimeAgentProcess with the result.
+ * In tests, this function should be mocked.
+ */
+export declare function spawnAgent(descriptor: RuntimeSpawnDescriptor, initial: RuntimeAgentProcess, onProgress?: (agentId: string, status: string) => void): Promise<RuntimeAgentProcess>;
+/**
+ * Parse token usage from agent stdout.
+ * Looks for patterns like "Tokens used: 1234" or JSON with token counts.
+ */
+export declare function parseTokenUsage(stdout: string): number;
+//# sourceMappingURL=agent-spawner.d.ts.map

package/dist/engine/orchestrator/agent-spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-spawner.d.ts","sourceRoot":"","sources":["../../../src/engine/orchestrator/agent-spawner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,kBAAkB,EAC/B,SAAS,EAAE,MAAM,GAChB,sBAAsB,CAsBxB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAUvE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,sBAAsB,EAClC,OAAO,EAAE,mBAAmB,EAC5B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GACrD,OAAO,CAAC,mBAAmB,CAAC,CA4D9B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CActD"}