attocode 0.1.2 → 0.1.4

package/dist/src/integrations/openrouter-pricing.js

@@ -5,9 +5,10 @@
  * for accurate cost estimation.
  */
 // =============================================================================
-// PRICING CACHE
+// MODEL INFO CACHE
 // =============================================================================
 let pricingCache = new Map();
+let contextLengthCache = new Map();
 let cacheTimestamp = 0;
 const CACHE_TTL = 3600000; // 1 hour
 // Default fallback pricing - conservative mid-tier estimate
@@ -19,17 +20,14 @@ const DEFAULT_PRICING = {
     request: 0,
     image: 0,
 };
-// =============================================================================
-// FETCH PRICING
-// =============================================================================
 /**
- * Fetch pricing data from OpenRouter API.
+ * Fetch model data (pricing + context lengths) from OpenRouter API.
  */
-export async function fetchOpenRouterPricing() {
+export async function fetchOpenRouterModels() {
     const apiKey = process.env.OPENROUTER_API_KEY;
     if (!apiKey) {
-        console.log('⚠️  No OPENROUTER_API_KEY - using default pricing estimates');
-        return new Map();
+        console.log('⚠️  No OPENROUTER_API_KEY - using default estimates');
+        return { pricing: new Map(), contextLengths: new Map() };
     }
     try {
         const response = await fetch('https://openrouter.ai/api/v1/models', {
@@ -43,6 +41,7 @@ export async function fetchOpenRouterPricing() {
         }
         const data = await response.json();
         const pricing = new Map();
+        const contextLengths = new Map();
         for (const model of data.data) {
             pricing.set(model.id, {
                 prompt: parseFloat(model.pricing.prompt) || 0,
@@ -50,30 +49,48 @@ export async function fetchOpenRouterPricing() {
                 request: parseFloat(model.pricing.request || '0'),
                 image: parseFloat(model.pricing.image || '0'),
             });
+            // Store context length
+            if (model.context_length) {
+                contextLengths.set(model.id, model.context_length);
+            }
         }
-        return pricing;
+        return { pricing, contextLengths };
     }
     catch (error) {
-        console.log(`⚠️  Failed to fetch OpenRouter pricing: ${error.message}`);
-        return new Map();
+        console.log(`⚠️  Failed to fetch OpenRouter models: ${error.message}`);
+        return { pricing: new Map(), contextLengths: new Map() };
     }
 }
 /**
- * Initialize or refresh the pricing cache.
+ * @deprecated Use fetchOpenRouterModels() instead
  */
-export async function initPricingCache() {
+export async function fetchOpenRouterPricing() {
+    const { pricing } = await fetchOpenRouterModels();
+    return pricing;
+}
+/**
+ * Initialize or refresh the model info cache (pricing + context lengths).
+ */
+export async function initModelCache() {
     const now = Date.now();
     // Only refresh if cache is stale
     if (pricingCache.size > 0 && (now - cacheTimestamp) < CACHE_TTL) {
         return;
     }
-    const pricing = await fetchOpenRouterPricing();
+    const { pricing, contextLengths } = await fetchOpenRouterModels();
     if (pricing.size > 0) {
         pricingCache = pricing;
+        contextLengthCache = contextLengths;
         cacheTimestamp = now;
-        console.log(`💰 Loaded pricing for ${pricing.size} models from OpenRouter`);
+        console.log(`💰 Loaded ${pricing.size} models from OpenRouter (pricing + context limits)`);
     }
 }
+/**
+ * @deprecated Use initModelCache() instead
+ */
+export async function initPricingCache() {
+    return initModelCache();
+}
 // =============================================================================
 // PRICING LOOKUP
 // =============================================================================
@@ -95,6 +112,30 @@ export function getModelPricing(modelId) {
     // Return default
     return DEFAULT_PRICING;
 }
+/**
+ * Get context length (max tokens) for a specific model.
+ * Returns undefined if the model is not in the cache.
+ */
+export function getModelContextLength(modelId) {
+    // Direct lookup
+    if (contextLengthCache.has(modelId)) {
+        return contextLengthCache.get(modelId);
+    }
+    // Try without provider prefix (e.g., "gpt-4" instead of "openai/gpt-4")
+    const shortId = modelId.split('/').pop() || modelId;
+    for (const [id, contextLength] of contextLengthCache) {
+        if (id.endsWith(shortId) || id.includes(shortId)) {
+            return contextLength;
+        }
+    }
+    return undefined;
+}
+/**
+ * Check if model cache has been initialized.
+ */
+export function isModelCacheInitialized() {
+    return pricingCache.size > 0;
+}
 /**
  * Calculate cost for a completion.
  */
@@ -120,5 +161,5 @@ export function formatCost(cost) {
 // =============================================================================
 // EXPORTS
 // =============================================================================
-export { pricingCache, DEFAULT_PRICING };
+export { pricingCache, contextLengthCache, DEFAULT_PRICING };
 //# sourceMappingURL=openrouter-pricing.js.map

package/dist/src/integrations/openrouter-pricing.js.map

@@ -1 +1 @@
-{"version":3,"file":"openrouter-pricing.js","sourceRoot":"","sources":["../../../src/integrations/openrouter-pricing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"openrouter-pricing.js","sourceRoot":"","sources":["../../../src/integrations/openrouter-pricing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,IAAI,YAAY,GAA8B,IAAI,GAAG,EAAE,CAAC;AACxD,IAAI,kBAAkB,GAAwB,IAAI,GAAG,EAAE,CAAC;AACxD,IAAI,cAAc,GAAW,CAAC,CAAC;AAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,SAAS;AAEpC,4DAA4D;AAC5D,0EAA0E;AAC1E,4EAA4E;AAC5E,MAAM,eAAe,GAAiB;IACpC,MAAM,EAAE,WAAW,EAAK,gDAAgD;IACxE,UAAU,EAAE,SAAS,EAAG,+CAA+C;IACvE,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACT,CAAC;AAcF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,qCAAqC,EAAE;YAClE,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,MAAM,EAAE;gBACnC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA8B,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;QAChD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEjD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE;gBACpB,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC7C,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;gBACrD,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC;gBACjD,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;aAC9C,CAAC,CAAC;YAEH,uBAAuB;YACvB,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,0CAA2C,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAClF,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,cAAc,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAClD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,iCAAiC;IACjC,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,cAAc,CAAC,GAAG,SAAS,EAAE,CAAC;QAChE,OAAO;IACT,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAClE,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,YAAY,GAAG,OAAO,CAAC;QACvB,kBAAkB,GAAG,cAAc,CAAC;QACpC,cAAc,GAAG,GAAG,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,CAAC,IAAI,oDAAoD,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,OAAO,cAAc,EAAE,CAAC;AAC1B,CAAC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,gBAAgB;IAChB,IAAI,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC;IACpC,CAAC;IAED,wEAAwE;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC;IACpD,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,YAAY,EAAE,CAAC;QACzC,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,gBAAgB;IAChB,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,wEAAwE;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC;IACpD,KAAK,MAAM,CAAC,EAAE,EAAE,aAAa,CAAC,IAAI,kBAAkB,EAAE,CAAC;QACrD,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,OAAe,EACf,WAAmB,EACnB,YAAoB;IAEpB,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEzC,MAAM,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/C,MAAM,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IACrD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAEpC,OAAO,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,gCAAgC;IAC7E,CAAC;IACD,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAChB,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC"}

package/dist/src/integrations/retry.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Generic Retry Utility
+ *
+ * Provides configurable retry logic with exponential backoff for transient failures.
+ * Used by tools, MCP client, and other operations that may encounter temporary errors.
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchData(),
+ *   {
+ *     maxAttempts: 3,
+ *     baseDelayMs: 1000,
+ *     retryableErrors: ['ETIMEDOUT', 'ECONNRESET'],
+ *   }
+ * );
+ * ```
+ */
+/**
+ * Configuration for retry behavior.
+ */
+export interface RetryConfig {
+    /** Maximum number of attempts (including initial) */
+    maxAttempts: number;
+    /** Base delay between retries in milliseconds (default: 1000) */
+    baseDelayMs?: number;
+    /** Maximum delay between retries in milliseconds (default: 30000) */
+    maxDelayMs?: number;
+    /** Multiplier for exponential backoff (default: 2) */
+    backoffMultiplier?: number;
+    /** Add random jitter to delays (default: true) */
+    jitter?: boolean;
+    /** Error message patterns that are retryable */
+    retryableErrors?: string[];
+    /** Error codes that are retryable (e.g., 'ETIMEDOUT', 'ECONNRESET') */
+    retryableCodes?: string[];
+    /** Custom function to determine if error is retryable */
+    isRetryable?: (error: Error) => boolean;
+    /** Callback on each retry attempt */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+    /** Callback when all attempts exhausted */
+    onExhausted?: (attempts: number, lastError: Error) => void;
+}
+/**
+ * Result of a retry operation.
+ */
+export interface RetryResult<T> {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** The result value (if successful) */
+    value?: T;
+    /** The error (if failed) */
+    error?: Error;
+    /** Number of attempts made */
+    attempts: number;
+    /** Total time spent (including delays) */
+    totalTimeMs: number;
+}
+/**
+ * Default retryable error patterns.
+ * These are common transient errors that often resolve on retry.
+ */
+export declare const DEFAULT_RETRYABLE_ERRORS: string[];
+/**
+ * Default retryable error codes.
+ */
+export declare const DEFAULT_RETRYABLE_CODES: string[];
+/**
+ * Execute a function with retry logic.
+ *
+ * @param fn - The async function to execute
+ * @param config - Retry configuration
+ * @returns Promise resolving to the result or throwing the last error
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with defaults
+ * const data = await withRetry(() => fetchData(), { maxAttempts: 3 });
+ *
+ * // With custom config
+ * const data = await withRetry(
+ *   () => unreliableApi(),
+ *   {
+ *     maxAttempts: 5,
+ *     baseDelayMs: 500,
+ *     backoffMultiplier: 1.5,
+ *     retryableErrors: ['timeout'],
+ *     onRetry: (attempt, err) => console.log(`Retry ${attempt}: ${err.message}`),
+ *   }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config: RetryConfig): Promise<T>;
+/**
+ * Execute a function with retry and return detailed result.
+ *
+ * Unlike withRetry, this never throws - it returns a result object
+ * that indicates success or failure.
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetryResult(() => unreliableOp(), { maxAttempts: 3 });
+ * if (result.success) {
+ *   console.log('Got:', result.value);
+ * } else {
+ *   console.log('Failed after', result.attempts, 'attempts:', result.error);
+ * }
+ * ```
+ */
+export declare function withRetryResult<T>(fn: () => Promise<T>, config: RetryConfig): Promise<RetryResult<T>>;
+/**
+ * Retry config for tool execution.
+ * Conservative: 2 attempts, short delays.
+ */
+export declare const TOOL_RETRY_CONFIG: Omit<RetryConfig, 'maxAttempts'>;
+/**
+ * Retry config for MCP calls.
+ * More aggressive: 3 attempts, longer delays.
+ */
+export declare const MCP_RETRY_CONFIG: Omit<RetryConfig, 'maxAttempts'>;
+/**
+ * Retry config for file operations.
+ * Short delays, handles busy files.
+ */
+export declare const FILE_RETRY_CONFIG: Omit<RetryConfig, 'maxAttempts'>;
+/**
+ * Retry config for network operations.
+ * Standard exponential backoff.
+ */
+export declare const NETWORK_RETRY_CONFIG: Omit<RetryConfig, 'maxAttempts'>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/src/integrations/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/integrations/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IAEpB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,yDAAyD;IACzD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAExC,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnE,2CAA2C;IAC3C,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,KAAK,IAAI,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IAEjB,uCAAuC;IACvC,KAAK,CAAC,EAAE,CAAC,CAAC;IAEV,4BAA4B;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,UAapC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,UAUnC,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,CAAC,CAAC,CA0DZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAwBzB;AAgDD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAM9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAM7D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAM9D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAMjE,CAAC"}

package/dist/src/integrations/retry.js

@@ -0,0 +1,233 @@
+/**
+ * Generic Retry Utility
+ *
+ * Provides configurable retry logic with exponential backoff for transient failures.
+ * Used by tools, MCP client, and other operations that may encounter temporary errors.
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchData(),
+ *   {
+ *     maxAttempts: 3,
+ *     baseDelayMs: 1000,
+ *     retryableErrors: ['ETIMEDOUT', 'ECONNRESET'],
+ *   }
+ * );
+ * ```
+ */
+/**
+ * Default retryable error patterns.
+ * These are common transient errors that often resolve on retry.
+ */
+export const DEFAULT_RETRYABLE_ERRORS = [
+    'ETIMEDOUT',
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'EPIPE',
+    'EBUSY',
+    'timeout',
+    'socket hang up',
+    'network error',
+    'temporarily unavailable',
+    'service unavailable',
+    'rate limit',
+];
+/**
+ * Default retryable error codes.
+ */
+export const DEFAULT_RETRYABLE_CODES = [
+    'ETIMEDOUT',
+    'ECONNRESET',
+    'ECONNREFUSED',
+    'ENOTFOUND',
+    'EPIPE',
+    'EBUSY',
+    'EAGAIN',
+    'ENETUNREACH',
+    'EHOSTUNREACH',
+];
+// =============================================================================
+// RETRY IMPLEMENTATION
+// =============================================================================
+/**
+ * Execute a function with retry logic.
+ *
+ * @param fn - The async function to execute
+ * @param config - Retry configuration
+ * @returns Promise resolving to the result or throwing the last error
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with defaults
+ * const data = await withRetry(() => fetchData(), { maxAttempts: 3 });
+ *
+ * // With custom config
+ * const data = await withRetry(
+ *   () => unreliableApi(),
+ *   {
+ *     maxAttempts: 5,
+ *     baseDelayMs: 500,
+ *     backoffMultiplier: 1.5,
+ *     retryableErrors: ['timeout'],
+ *     onRetry: (attempt, err) => console.log(`Retry ${attempt}: ${err.message}`),
+ *   }
+ * );
+ * ```
+ */
+export async function withRetry(fn, config) {
+    const { maxAttempts, baseDelayMs = 1000, maxDelayMs = 30000, backoffMultiplier = 2, jitter = true, retryableErrors = DEFAULT_RETRYABLE_ERRORS, retryableCodes = DEFAULT_RETRYABLE_CODES, isRetryable, onRetry, onExhausted, } = config;
+    let lastError;
+    let attempt = 0;
+    while (attempt < maxAttempts) {
+        attempt++;
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if this is the last attempt
+            if (attempt >= maxAttempts) {
+                onExhausted?.(attempt, lastError);
+                throw lastError;
+            }
+            // Check if error is retryable
+            if (!shouldRetry(lastError, retryableErrors, retryableCodes, isRetryable)) {
+                throw lastError;
+            }
+            // Calculate delay with exponential backoff
+            let delay = Math.min(baseDelayMs * Math.pow(backoffMultiplier, attempt - 1), maxDelayMs);
+            // Add jitter (±25%)
+            if (jitter) {
+                const jitterAmount = delay * 0.25;
+                delay += (Math.random() - 0.5) * 2 * jitterAmount;
+                delay = Math.max(0, delay);
+            }
+            onRetry?.(attempt, lastError, delay);
+            // Wait before retry
+            await sleep(delay);
+        }
+    }
+    // Should never reach here, but TypeScript needs this
+    throw lastError ?? new Error('Retry failed');
+}
+/**
+ * Execute a function with retry and return detailed result.
+ *
+ * Unlike withRetry, this never throws - it returns a result object
+ * that indicates success or failure.
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetryResult(() => unreliableOp(), { maxAttempts: 3 });
+ * if (result.success) {
+ *   console.log('Got:', result.value);
+ * } else {
+ *   console.log('Failed after', result.attempts, 'attempts:', result.error);
+ * }
+ * ```
+ */
+export async function withRetryResult(fn, config) {
+    const startTime = Date.now();
+    let attempts = 0;
+    try {
+        const result = await withRetry(async () => {
+            attempts++;
+            return await fn();
+        }, config);
+        return {
+            success: true,
+            value: result,
+            attempts,
+            totalTimeMs: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error,
+            attempts,
+            totalTimeMs: Date.now() - startTime,
+        };
+    }
+}
+// =============================================================================
+// HELPERS
+// =============================================================================
+/**
+ * Determine if an error should trigger a retry.
+ */
+function shouldRetry(error, retryableErrors, retryableCodes, customIsRetryable) {
+    // Custom check takes precedence
+    if (customIsRetryable) {
+        return customIsRetryable(error);
+    }
+    // Check error code
+    const code = error.code;
+    if (code && retryableCodes.includes(code)) {
+        return true;
+    }
+    // Check error message patterns
+    const message = error.message.toLowerCase();
+    for (const pattern of retryableErrors) {
+        if (message.includes(pattern.toLowerCase())) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Sleep for a specified duration.
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// =============================================================================
+// SPECIALIZED RETRY CONFIGS
+// =============================================================================
+/**
+ * Retry config for tool execution.
+ * Conservative: 2 attempts, short delays.
+ */
+export const TOOL_RETRY_CONFIG = {
+    baseDelayMs: 500,
+    maxDelayMs: 5000,
+    backoffMultiplier: 2,
+    retryableCodes: ['ETIMEDOUT', 'ECONNRESET', 'EBUSY', 'EAGAIN'],
+    retryableErrors: ['timeout', 'temporarily unavailable'],
+};
+/**
+ * Retry config for MCP calls.
+ * More aggressive: 3 attempts, longer delays.
+ */
+export const MCP_RETRY_CONFIG = {
+    baseDelayMs: 1000,
+    maxDelayMs: 10000,
+    backoffMultiplier: 2,
+    retryableCodes: DEFAULT_RETRYABLE_CODES,
+    retryableErrors: ['timeout', 'socket hang up', 'connection reset'],
+};
+/**
+ * Retry config for file operations.
+ * Short delays, handles busy files.
+ */
+export const FILE_RETRY_CONFIG = {
+    baseDelayMs: 100,
+    maxDelayMs: 2000,
+    backoffMultiplier: 2,
+    retryableCodes: ['EBUSY', 'EAGAIN', 'EMFILE', 'ENFILE'],
+    retryableErrors: ['resource busy', 'too many open files'],
+};
+/**
+ * Retry config for network operations.
+ * Standard exponential backoff.
+ */
+export const NETWORK_RETRY_CONFIG = {
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+    retryableCodes: DEFAULT_RETRYABLE_CODES,
+    retryableErrors: DEFAULT_RETRYABLE_ERRORS,
+};
+//# sourceMappingURL=retry.js.map

package/dist/src/integrations/retry.js.map

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

package/dist/src/integrations/skill-executor.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Skill Executor
+ *
+ * Handles invocation of skills with argument parsing and template substitution.
+ * Skills can be invoked like commands: /review --file src/main.ts --focus security
+ */
+import type { Skill, SkillManager } from './skills.js';
+/**
+ * Parsed arguments from command line input.
+ */
+export interface ParsedArgs {
+    /** Named arguments (--name value or -n value) */
+    named: Record<string, unknown>;
+    /** Positional arguments (remaining after named) */
+    positional: string[];
+    /** Any parsing errors */
+    errors: string[];
+}
+/**
+ * Context provided during skill execution.
+ */
+export interface SkillExecutionContext {
+    /** Current working directory */
+    cwd: string;
+    /** Session ID */
+    sessionId?: string;
+    /** Current conversation context (for prompt injection) */
+    conversationContext?: string;
+    /** Callback to run agent with injected prompt */
+    runWithPrompt?: (prompt: string) => Promise<SkillExecutionResult>;
+}
+/**
+ * Result of skill execution.
+ */
+export interface SkillExecutionResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Result message or output */
+    output: string;
+    /** Injected prompt for the agent (if prompt-injection mode) */
+    injectedPrompt?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Skill execution event types.
+ */
+export type SkillExecutorEvent = {
+    type: 'skill.invoke.start';
+    skillName: string;
+    args: string[];
+} | {
+    type: 'skill.invoke.parsed';
+    skillName: string;
+    parsed: ParsedArgs;
+} | {
+    type: 'skill.invoke.complete';
+    skillName: string;
+    result: SkillExecutionResult;
+} | {
+    type: 'skill.invoke.error';
+    skillName: string;
+    error: string;
+};
+export type SkillExecutorEventListener = (event: SkillExecutorEvent) => void;
+/**
+ * Executes invokable skills with argument parsing and template substitution.
+ */
+export declare class SkillExecutor {
+    private skillManager;
+    private eventListeners;
+    constructor(skillManager: SkillManager);
+    /**
+     * Check if an input string is a potential skill invocation.
+     * Returns the skill name if it matches, null otherwise.
+     */
+    isSkillInvocation(input: string): string | null;
+    /**
+     * Parse command-line style arguments.
+     */
+    parseArguments(skill: Skill, rawArgs: string[]): ParsedArgs;
+    /**
+     * Substitute template variables in skill content.
+     * Variables are in the form {{name}} or {{name|default}}.
+     */
+    substituteTemplate(content: string, args: ParsedArgs): string;
+    /**
+     * Execute a skill by name with arguments.
+     */
+    executeSkill(skillName: string, rawArgs: string[], ctx: SkillExecutionContext): Promise<SkillExecutionResult>;
+    /**
+     * Build the prompt to inject based on skill content and arguments.
+     */
+    private buildInjectedPrompt;
+    /**
+     * Format help text for a skill.
+     */
+    formatSkillHelp(skill: Skill): string;
+    /**
+     * Get all invokable skills.
+     */
+    getInvokableSkills(): Skill[];
+    /**
+     * Subscribe to executor events.
+     */
+    subscribe(listener: SkillExecutorEventListener): () => void;
+    private emit;
+}
+/**
+ * Create a skill executor.
+ */
+export declare function createSkillExecutor(skillManager: SkillManager): SkillExecutor;
+//# sourceMappingURL=skill-executor.d.ts.map

package/dist/src/integrations/skill-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-executor.d.ts","sourceRoot":"","sources":["../../../src/integrations/skill-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAC;AAMtE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,mDAAmD;IACnD,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,yBAAyB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IAEZ,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,iDAAiD;IACjD,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACnE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IAEf,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,MAAM,MAAM,0BAA0B,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAM7E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAA8C;gBAExD,YAAY,EAAE,YAAY;IAItC;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAc/C;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU;IA8F3D;;;OAGG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM;IAY7D;;OAEG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,EACjB,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,oBAAoB,CAAC;IAqEhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAoBrC;;OAEG;IACH,kBAAkB,IAAI,KAAK,EAAE;IAI7B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,0BAA0B,GAAG,MAAM,IAAI;IAK3D,OAAO,CAAC,IAAI;CASb;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,aAAa,CAE7E"}