@soleri/core 0.0.1 → 2.0.0

package/dist/llm/key-pool.d.ts

@@ -0,0 +1,38 @@
+import { SecretString } from './types.js';
+import type { KeyPoolConfig, KeyStatus } from './types.js';
+export declare class KeyPool {
+    private keys;
+    private activeIndex;
+    private keyBreakers;
+    private remainingQuota;
+    private readonly preemptiveThreshold;
+    constructor(config: KeyPoolConfig);
+    get hasKeys(): boolean;
+    getActiveKey(): SecretString;
+    get activeKeyIndex(): number;
+    get poolSize(): number;
+    get exhausted(): boolean;
+    rotateOnError(): SecretString | null;
+    rotatePreemptive(): boolean;
+    updateQuota(keyIndex: number, remaining: number): void;
+    getStatus(): {
+        poolSize: number;
+        activeKeyIndex: number;
+        exhausted: boolean;
+        perKeyStatus: KeyStatus[];
+    };
+    private findNextHealthyKey;
+}
+export interface KeyPoolFiles {
+    openai: KeyPoolConfig;
+    anthropic: KeyPoolConfig;
+}
+/**
+ * Load key pool configuration for an agent.
+ * Key loading priority:
+ * 1. ~/.{agentId}/keys.json
+ * 2. Fallback: OPENAI_API_KEY / ANTHROPIC_API_KEY env vars
+ * 3. Empty pool
+ */
+export declare function loadKeyPoolConfig(agentId: string): KeyPoolFiles;
+//# sourceMappingURL=key-pool.d.ts.map

package/dist/llm/key-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-pool.d.ts","sourceRoot":"","sources":["../../src/llm/key-pool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAa3D,qBAAa,OAAO;IAClB,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;gBAEjC,MAAM,EAAE,aAAa;IAoBjC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,YAAY,IAAI,YAAY;IAO5B,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,SAAS,IAAI,OAAO,CAOvB;IAED,aAAa,IAAI,YAAY,GAAG,IAAI;IAQpC,gBAAgB,IAAI,OAAO;IAe3B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAItD,SAAS,IAAI;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,SAAS,EAAE,CAAC;KAC3B;IAiBD,OAAO,CAAC,kBAAkB;CAa3B;AAMD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAqC/D"}

package/dist/llm/key-pool.js

@@ -0,0 +1,154 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { homedir } from 'node:os';
+import { SecretString } from './types.js';
+import { CircuitBreaker } from './utils.js';
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_PREEMPTIVE_THRESHOLD = 50;
+// =============================================================================
+// KEY POOL
+// =============================================================================
+export class KeyPool {
+    keys;
+    activeIndex = 0;
+    keyBreakers = new Map();
+    remainingQuota = new Map();
+    preemptiveThreshold;
+    constructor(config) {
+        this.keys = config.keys.filter((k) => k.length > 0).map((k) => new SecretString(k));
+        this.preemptiveThreshold = config.preemptiveThreshold ?? DEFAULT_PREEMPTIVE_THRESHOLD;
+        for (let i = 0; i < this.keys.length; i++) {
+            this.keyBreakers.set(i, new CircuitBreaker({
+                name: `key-pool-${i}`,
+                failureThreshold: 3,
+                resetTimeoutMs: 30_000,
+            }));
+        }
+        if (this.keys.length > 1) {
+            console.error(`[LLM] KeyPool initialized with ${this.keys.length} keys`);
+        }
+    }
+    get hasKeys() {
+        return this.keys.length > 0;
+    }
+    getActiveKey() {
+        if (this.keys.length === 0) {
+            throw new Error('KeyPool has no keys — cannot get active key');
+        }
+        return this.keys[this.activeIndex];
+    }
+    get activeKeyIndex() {
+        return this.activeIndex;
+    }
+    get poolSize() {
+        return this.keys.length;
+    }
+    get exhausted() {
+        if (this.keys.length === 0)
+            return true;
+        for (let i = 0; i < this.keys.length; i++) {
+            const breaker = this.keyBreakers.get(i);
+            if (!breaker.isOpen())
+                return false;
+        }
+        return true;
+    }
+    rotateOnError() {
+        const breaker = this.keyBreakers.get(this.activeIndex);
+        if (breaker) {
+            breaker.recordFailure();
+        }
+        return this.findNextHealthyKey();
+    }
+    rotatePreemptive() {
+        const previousIndex = this.activeIndex;
+        const remaining = this.remainingQuota.get(previousIndex);
+        if (remaining !== undefined && remaining < this.preemptiveThreshold) {
+            const next = this.findNextHealthyKey();
+            if (next) {
+                console.error(`[LLM] KeyPool preemptive rotation: key ${previousIndex} remaining=${remaining} < threshold=${this.preemptiveThreshold}`);
+                return true;
+            }
+        }
+        return false;
+    }
+    updateQuota(keyIndex, remaining) {
+        this.remainingQuota.set(keyIndex, remaining);
+    }
+    getStatus() {
+        const perKeyStatus = [];
+        for (let i = 0; i < this.keys.length; i++) {
+            perKeyStatus.push({
+                index: i,
+                circuitState: this.keyBreakers.get(i).getState(),
+                remainingQuota: this.remainingQuota.get(i) ?? null,
+            });
+        }
+        return {
+            poolSize: this.poolSize,
+            activeKeyIndex: this.activeIndex,
+            exhausted: this.exhausted,
+            perKeyStatus,
+        };
+    }
+    findNextHealthyKey() {
+        const startIndex = this.activeIndex;
+        for (let offset = 1; offset <= this.keys.length; offset++) {
+            const candidateIndex = (startIndex + offset) % this.keys.length;
+            const breaker = this.keyBreakers.get(candidateIndex);
+            if (!breaker.isOpen()) {
+                this.activeIndex = candidateIndex;
+                return this.keys[candidateIndex];
+            }
+        }
+        console.error('[LLM] KeyPool: all keys exhausted — no healthy key available');
+        return null;
+    }
+}
+/**
+ * Load key pool configuration for an agent.
+ * Key loading priority:
+ * 1. ~/.{agentId}/keys.json
+ * 2. Fallback: OPENAI_API_KEY / ANTHROPIC_API_KEY env vars
+ * 3. Empty pool
+ */
+export function loadKeyPoolConfig(agentId) {
+    if (!agentId || /[/\\]/.test(agentId) || agentId.includes('..')) {
+        throw new Error(`Invalid agentId: ${agentId}`);
+    }
+    const keysFilePath = path.join(homedir(), `.${agentId}`, 'keys.json');
+    let openaiKeys = [];
+    let anthropicKeys = [];
+    try {
+        if (fs.existsSync(keysFilePath)) {
+            const data = JSON.parse(fs.readFileSync(keysFilePath, 'utf-8'));
+            if (data?.openai && Array.isArray(data.openai)) {
+                openaiKeys = data.openai;
+            }
+            if (data?.anthropic && Array.isArray(data.anthropic)) {
+                anthropicKeys = data.anthropic;
+            }
+        }
+    }
+    catch {
+        console.error('[LLM] Could not read keys.json, falling back to env vars');
+    }
+    // Fallback: environment variables
+    if (openaiKeys.length === 0) {
+        const envKey = process.env.OPENAI_API_KEY || '';
+        if (envKey)
+            openaiKeys = [envKey];
+    }
+    if (anthropicKeys.length === 0) {
+        const envKey = process.env.ANTHROPIC_API_KEY || '';
+        if (envKey)
+            anthropicKeys = [envKey];
+    }
+    return {
+        openai: { keys: openaiKeys },
+        anthropic: { keys: anthropicKeys },
+    };
+}
+//# sourceMappingURL=key-pool.js.map

package/dist/llm/key-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-pool.js","sourceRoot":"","sources":["../../src/llm/key-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAExC,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,MAAM,OAAO,OAAO;IACV,IAAI,CAAiB;IACrB,WAAW,GAAW,CAAC,CAAC;IACxB,WAAW,GAAgC,IAAI,GAAG,EAAE,CAAC;IACrD,cAAc,GAAwB,IAAI,GAAG,EAAE,CAAC;IACvC,mBAAmB,CAAS;IAE7C,YAAY,MAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,IAAI,4BAA4B,CAAC;QAEtF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,WAAW,CAAC,GAAG,CAClB,CAAC,EACD,IAAI,cAAc,CAAC;gBACjB,IAAI,EAAE,YAAY,CAAC,EAAE;gBACrB,gBAAgB,EAAE,CAAC;gBACnB,cAAc,EAAE,MAAM;aACvB,CAAC,CACH,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,kCAAkC,IAAI,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,YAAY;QACV,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS;QACX,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBAAE,OAAO,KAAK,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IACnC,CAAC;IAED,gBAAgB;QACd,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACpE,MAAM,IAAI,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACvC,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CACX,0CAA0C,aAAa,cAAc,SAAS,gBAAgB,IAAI,CAAC,mBAAmB,EAAE,CACzH,CAAC;gBACF,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW,CAAC,QAAgB,EAAE,SAAiB;QAC7C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,SAAS;QAMP,MAAM,YAAY,GAAgB,EAAE,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,YAAY,CAAC,IAAI,CAAC;gBAChB,KAAK,EAAE,CAAC;gBACR,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,QAAQ,EAAE;gBACjD,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI;aACnD,CAAC,CAAC;QACL,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,WAAW;YAChC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY;SACb,CAAC;IACJ,CAAC;IAEO,kBAAkB;QACxB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;YAC1D,MAAM,cAAc,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAChE,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAE,CAAC;YACtD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtB,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC;gBAClC,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAWD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;IAEtE,IAAI,UAAU,GAAa,EAAE,CAAC;IAC9B,IAAI,aAAa,GAAa,EAAE,CAAC;IAEjC,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;YAChE,IAAI,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/C,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,CAAC;YACD,IAAI,IAAI,EAAE,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrD,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC5E,CAAC;IAED,kCAAkC;IAClC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;QAChD,IAAI,MAAM;YAAE,UAAU,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;QACnD,IAAI,MAAM;YAAE,aAAa,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;KACnC,CAAC;AACJ,CAAC"}

package/dist/llm/types.d.ts

@@ -0,0 +1,80 @@
+export declare class SecretString {
+    #private;
+    constructor(value: string);
+    expose(): string;
+    get isSet(): boolean;
+    toString(): string;
+    toJSON(): string;
+    [Symbol.toPrimitive](): string;
+}
+export declare class LLMError extends Error {
+    retryable: boolean;
+    statusCode?: number;
+    constructor(message: string, options?: {
+        retryable?: boolean;
+        statusCode?: number;
+    });
+}
+export interface LLMCallOptions {
+    provider: 'openai' | 'anthropic';
+    model: string;
+    systemPrompt: string;
+    userPrompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    caller: string;
+    task?: string;
+}
+export interface LLMCallResult {
+    text: string;
+    model: string;
+    provider: 'openai' | 'anthropic';
+    inputTokens?: number;
+    outputTokens?: number;
+    durationMs: number;
+}
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    resetTimeoutMs: number;
+    name: string;
+}
+export interface CircuitBreakerSnapshot {
+    state: CircuitState;
+    failureCount: number;
+    lastFailureAt: number | null;
+}
+export interface KeyPoolConfig {
+    keys: string[];
+    preemptiveThreshold?: number;
+}
+export interface KeyStatus {
+    index: number;
+    circuitState: CircuitBreakerSnapshot;
+    remainingQuota: number | null;
+}
+export interface RouteEntry {
+    caller: string;
+    task?: string;
+    model: string;
+    provider: 'openai' | 'anthropic';
+}
+export interface RoutingConfig {
+    routes: RouteEntry[];
+    defaultOpenAIModel: string;
+    defaultAnthropicModel: string;
+}
+export interface RateLimitInfo {
+    remaining: number | null;
+    resetMs: number | null;
+    retryAfterMs: number | null;
+}
+export interface RetryConfig {
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    jitter: number;
+    shouldRetry?: (error: unknown) => boolean;
+    onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;;gBAGX,KAAK,EAAE,MAAM;IAIzB,MAAM,IAAI,MAAM;IAIhB,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,QAAQ,IAAI,MAAM;IAGlB,MAAM,IAAI,MAAM;IAGhB,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM;CAM/B;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;CAOpF;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,sBAAsB,CAAC;IACrC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,GAAG,WAAW,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtE"}

package/dist/llm/types.js

@@ -0,0 +1,37 @@
+const REDACTED = '[REDACTED]';
+export class SecretString {
+    #value;
+    constructor(value) {
+        this.#value = value;
+    }
+    expose() {
+        return this.#value;
+    }
+    get isSet() {
+        return this.#value.length > 0;
+    }
+    toString() {
+        return REDACTED;
+    }
+    toJSON() {
+        return REDACTED;
+    }
+    [Symbol.toPrimitive]() {
+        return REDACTED;
+    }
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return REDACTED;
+    }
+}
+export class LLMError extends Error {
+    retryable;
+    statusCode;
+    constructor(message, options) {
+        super(message);
+        this.name = 'LLMError';
+        this.retryable = options?.retryable ?? false;
+        this.statusCode = options?.statusCode;
+        Object.setPrototypeOf(this, LLMError.prototype);
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,OAAO,YAAY;IACvB,MAAM,CAAS;IAEf,YAAY,KAAa;QACvB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,QAAQ;QACN,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM;QACJ,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,CAAC,MAAM,CAAC,WAAW,CAAC;QAClB,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACxC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,SAAS,CAAU;IACnB,UAAU,CAAU;IAEpB,YAAY,OAAe,EAAE,OAAsD;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/llm/utils.d.ts

@@ -0,0 +1,26 @@
+import type { CircuitBreakerConfig, CircuitBreakerSnapshot, RateLimitInfo, RetryConfig } from './types.js';
+export declare class CircuitOpenError extends Error {
+    retryable: boolean;
+    constructor(name: string);
+}
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private lastFailureAt;
+    private readonly config;
+    constructor(config?: Partial<CircuitBreakerConfig>);
+    call<T>(fn: () => Promise<T>): Promise<T>;
+    getState(): CircuitBreakerSnapshot;
+    isOpen(): boolean;
+    reset(): void;
+    /** Synchronously record a failure (used by KeyPool to trip breaker without async) */
+    recordFailure(): void;
+    private onSuccess;
+    private onFailure;
+    private shouldProbe;
+    private transitionTo;
+}
+export declare function computeDelay(error: unknown, attempt: number, config: RetryConfig): number;
+export declare function retry<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+export declare function parseRateLimitHeaders(headers: Headers): RateLimitInfo;
+//# sourceMappingURL=utils.d.ts.map

package/dist/llm/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/llm/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EAGtB,aAAa,EACb,WAAW,EACZ,MAAM,YAAY,CAAC;AA2BpB,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAS,UAAS;gBACN,IAAI,EAAE,MAAM;CAKzB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAI5C,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB/C,QAAQ,IAAI,sBAAsB;IAWlC,MAAM,IAAI,OAAO;IAIjB,KAAK,IAAI,IAAI;IAMb,qFAAqF;IACrF,aAAa,IAAI,IAAI;IAerB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,YAAY;CAKrB;AAaD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAazF;AAED,wBAAsB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CA2B9F;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAWrE"}

package/dist/llm/utils.js

@@ -0,0 +1,197 @@
+// =============================================================================
+// HELPERS
+// =============================================================================
+function isRetryable(error) {
+    if (error && typeof error === 'object' && 'retryable' in error) {
+        return error.retryable === true;
+    }
+    return false;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// =============================================================================
+// CIRCUIT BREAKER
+// =============================================================================
+const DEFAULT_CB_CONFIG = {
+    failureThreshold: 5,
+    resetTimeoutMs: 60_000,
+    name: 'default',
+};
+export class CircuitOpenError extends Error {
+    retryable = false;
+    constructor(name) {
+        super(`${name} circuit breaker is open — calls are being rejected`);
+        this.name = 'CircuitOpenError';
+        Object.setPrototypeOf(this, CircuitOpenError.prototype);
+    }
+}
+export class CircuitBreaker {
+    state = 'closed';
+    failureCount = 0;
+    lastFailureAt = null;
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CB_CONFIG, ...config };
+    }
+    async call(fn) {
+        if (this.state === 'open') {
+            if (this.shouldProbe()) {
+                this.transitionTo('half-open');
+            }
+            else {
+                throw new CircuitOpenError(this.config.name);
+            }
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure(error);
+            throw error;
+        }
+    }
+    getState() {
+        if (this.state === 'open' && this.shouldProbe()) {
+            this.transitionTo('half-open');
+        }
+        return {
+            state: this.state,
+            failureCount: this.failureCount,
+            lastFailureAt: this.lastFailureAt,
+        };
+    }
+    isOpen() {
+        return this.state === 'open' && !this.shouldProbe();
+    }
+    reset() {
+        this.transitionTo('closed');
+        this.failureCount = 0;
+        this.lastFailureAt = null;
+    }
+    /** Synchronously record a failure (used by KeyPool to trip breaker without async) */
+    recordFailure() {
+        this.failureCount++;
+        this.lastFailureAt = Date.now();
+        if (this.state === 'half-open') {
+            this.transitionTo('open');
+            return;
+        }
+        if (this.failureCount >= this.config.failureThreshold) {
+            console.error(`[LLM] CircuitBreaker:${this.config.name} threshold reached (${this.failureCount}/${this.config.failureThreshold}) — opening`);
+            this.transitionTo('open');
+        }
+    }
+    onSuccess() {
+        this.failureCount = 0;
+        this.transitionTo('closed');
+    }
+    onFailure(error) {
+        if (!isRetryable(error)) {
+            return;
+        }
+        this.failureCount++;
+        this.lastFailureAt = Date.now();
+        if (this.state === 'half-open') {
+            this.transitionTo('open');
+            return;
+        }
+        if (this.failureCount >= this.config.failureThreshold) {
+            console.error(`[LLM] CircuitBreaker:${this.config.name} threshold reached (${this.failureCount}/${this.config.failureThreshold}) — opening`);
+            this.transitionTo('open');
+        }
+    }
+    shouldProbe() {
+        if (this.lastFailureAt === null)
+            return false;
+        return Date.now() - this.lastFailureAt >= this.config.resetTimeoutMs;
+    }
+    transitionTo(newState) {
+        if (this.state !== newState) {
+            this.state = newState;
+        }
+    }
+}
+// =============================================================================
+// RETRY
+// =============================================================================
+const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    jitter: 0.1,
+};
+export function computeDelay(error, attempt, config) {
+    const retryAfterMs = error?.retryAfterMs;
+    if (retryAfterMs !== undefined && retryAfterMs > 0) {
+        return Math.min(retryAfterMs, config.maxDelayMs);
+    }
+    const exponential = config.baseDelayMs * Math.pow(2, attempt);
+    const capped = Math.min(exponential, config.maxDelayMs);
+    const jitterRange = capped * config.jitter;
+    const jitterOffset = (Math.random() * 2 - 1) * jitterRange;
+    return Math.max(0, Math.round(capped + jitterOffset));
+}
+export async function retry(fn, config) {
+    const resolved = { ...DEFAULT_RETRY_CONFIG, ...config };
+    if (resolved.maxAttempts < 1) {
+        throw new Error(`retry maxAttempts must be >= 1, got ${resolved.maxAttempts}`);
+    }
+    const shouldRetry = resolved.shouldRetry ?? isRetryable;
+    let lastError;
+    for (let attempt = 0; attempt < resolved.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt >= resolved.maxAttempts - 1 || !shouldRetry(error)) {
+                throw error;
+            }
+            const delay = computeDelay(error, attempt, resolved);
+            resolved.onRetry?.(error, attempt + 1, delay);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+// =============================================================================
+// RATE LIMIT HEADER PARSER
+// =============================================================================
+export function parseRateLimitHeaders(headers) {
+    const remaining = headers.get('x-ratelimit-remaining-requests');
+    const reset = headers.get('x-ratelimit-reset-requests');
+    const retryAfter = headers.get('retry-after');
+    return {
+        remaining: remaining !== null ? (isNaN(parseInt(remaining, 10)) ? null : parseInt(remaining, 10)) : null,
+        resetMs: reset !== null ? parseResetDuration(reset) : null,
+        retryAfterMs: retryAfter !== null ? parseRetryAfter(retryAfter) : null,
+    };
+}
+function parseResetDuration(value) {
+    let totalMs = 0;
+    let matched = false;
+    const minMatch = value.match(/(\d+)m(?!\s*s)/);
+    if (minMatch) {
+        totalMs += parseInt(minMatch[1], 10) * 60_000;
+        matched = true;
+    }
+    const msMatch = value.match(/(\d+)ms/);
+    if (msMatch) {
+        totalMs += parseInt(msMatch[1], 10);
+        matched = true;
+    }
+    const secMatch = value.match(/(\d+)(?<!m)s/);
+    if (secMatch) {
+        totalMs += parseInt(secMatch[1], 10) * 1000;
+        matched = true;
+    }
+    return matched ? totalMs : null;
+}
+function parseRetryAfter(value) {
+    const seconds = parseFloat(value);
+    return isNaN(seconds) ? null : Math.ceil(seconds * 1000);
+}
+//# sourceMappingURL=utils.js.map

package/dist/llm/utils.js.map

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

package/dist/planning/planner.d.ts

@@ -0,0 +1,48 @@
+export type PlanStatus = 'draft' | 'approved' | 'executing' | 'completed';
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'skipped' | 'failed';
+export interface PlanTask {
+    id: string;
+    title: string;
+    description: string;
+    status: TaskStatus;
+    updatedAt: number;
+}
+export interface Plan {
+    id: string;
+    objective: string;
+    scope: string;
+    status: PlanStatus;
+    decisions: string[];
+    tasks: PlanTask[];
+    createdAt: number;
+    updatedAt: number;
+}
+export interface PlanStore {
+    version: string;
+    plans: Plan[];
+}
+export declare class Planner {
+    private filePath;
+    private store;
+    constructor(filePath: string);
+    private load;
+    private save;
+    create(params: {
+        objective: string;
+        scope: string;
+        decisions?: string[];
+        tasks?: Array<{
+            title: string;
+            description: string;
+        }>;
+    }): Plan;
+    get(planId: string): Plan | null;
+    list(): Plan[];
+    approve(planId: string): Plan;
+    startExecution(planId: string): Plan;
+    updateTask(planId: string, taskId: string, status: TaskStatus): Plan;
+    complete(planId: string): Plan;
+    getExecuting(): Plan[];
+    getActive(): Plan[];
+}
+//# sourceMappingURL=planner.d.ts.map

package/dist/planning/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/planning/planner.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAC1E,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAY;gBAEb,QAAQ,EAAE,MAAM;IAK5B,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,IAAI;IAKZ,MAAM,CAAC,MAAM,EAAE;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvD,GAAG,IAAI;IAuBR,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIhC,IAAI,IAAI,IAAI,EAAE;IAId,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW7B,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAWpC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAgBpE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW9B,YAAY,IAAI,IAAI,EAAE;IAItB,SAAS,IAAI,IAAI,EAAE;CAKpB"}