tool-call-retry 0.1.0

package/dist/format-error.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatErrorForLLM = formatErrorForLLM;
+const classify_js_1 = require("./classify.js");
+const SANITIZE_PATTERNS = [
+    // Stack traces
+    [/\n\s+at\s+.+/g, ''],
+    // Localhost URLs
+    [/https?:\/\/localhost[^\s]*/gi, '[localhost]'],
+    [/https?:\/\/127\.0\.0\.1[^\s]*/gi, '[localhost]'],
+    // Passwords in URLs
+    [/(:\/\/[^:@\s]+:)[^@\s]+(@)/g, '$1[redacted]$2'],
+    // Authorization headers / bearer tokens
+    [/bearer\s+[A-Za-z0-9\-._~+/]+=*/gi, 'bearer [redacted]'],
+    // API key-like patterns (long alphanumeric strings)
+    [/\b(sk|pk|api|key|token|secret)[-_][A-Za-z0-9\-_]{8,}/gi, '[redacted]'],
+];
+function sanitizeMessage(message) {
+    let s = message;
+    for (const [pattern, replacement] of SANITIZE_PATTERNS) {
+        s = s.replace(pattern, replacement);
+    }
+    return s.trim();
+}
+function formatErrorForLLM(error, options) {
+    const classification = (0, classify_js_1.classifyError)(error);
+    let code;
+    let message;
+    let retriable;
+    let suggestion;
+    switch (classification.category) {
+        case 'rate-limited':
+            code = 'RATE_LIMITED';
+            message = 'Rate limit exceeded';
+            retriable = true;
+            suggestion = 'Wait before retrying or reduce request frequency';
+            break;
+        case 'retriable':
+            code = 'SERVICE_UNAVAILABLE';
+            message = 'Service temporarily unavailable';
+            retriable = true;
+            suggestion = 'Retry the operation';
+            break;
+        case 'timeout':
+            code = 'TIMEOUT';
+            message = 'Request timed out';
+            retriable = true;
+            suggestion = 'Try again or reduce payload size';
+            break;
+        case 'non-retriable': {
+            code = 'INVALID_REQUEST';
+            const rawMessage = classification.message || (error instanceof Error ? error.message : String(error));
+            message = sanitizeMessage(rawMessage);
+            retriable = false;
+            suggestion = 'Check the tool arguments';
+            break;
+        }
+        case 'unknown':
+        default:
+            code = 'UNKNOWN_ERROR';
+            message = 'An unexpected error occurred';
+            retriable = true;
+            suggestion = 'Retry once; if it persists, report the issue';
+            break;
+    }
+    const result = { error: true, code, message, retriable, suggestion };
+    if (options?.toolName)
+        result.tool = options.toolName;
+    if (options?.attemptsMade !== undefined)
+        result.attemptsMade = options.attemptsMade;
+    return result;
+}
+//# sourceMappingURL=format-error.js.map

package/dist/format-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error.js","sourceRoot":"","sources":["../src/format-error.ts"],"names":[],"mappings":";;AAyBA,8CAmDC;AA3ED,+CAA8C;AAE9C,MAAM,iBAAiB,GAA4B;IACjD,eAAe;IACf,CAAC,eAAe,EAAE,EAAE,CAAC;IACrB,iBAAiB;IACjB,CAAC,8BAA8B,EAAE,aAAa,CAAC;IAC/C,CAAC,iCAAiC,EAAE,aAAa,CAAC;IAClD,oBAAoB;IACpB,CAAC,6BAA6B,EAAE,gBAAgB,CAAC;IACjD,wCAAwC;IACxC,CAAC,kCAAkC,EAAE,mBAAmB,CAAC;IACzD,oDAAoD;IACpD,CAAC,wDAAwD,EAAE,YAAY,CAAC;CACzE,CAAC;AAEF,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC,GAAG,OAAO,CAAC;IAChB,KAAK,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,iBAAiB,EAAE,CAAC;QACvD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,SAAgB,iBAAiB,CAC/B,KAAc,EACd,OAAsD;IAEtD,MAAM,cAAc,GAAG,IAAA,2BAAa,EAAC,KAAK,CAAC,CAAC;IAE5C,IAAI,IAAY,CAAC;IACjB,IAAI,OAAe,CAAC;IACpB,IAAI,SAAkB,CAAC;IACvB,IAAI,UAAkB,CAAC;IAEvB,QAAQ,cAAc,CAAC,QAAQ,EAAE,CAAC;QAChC,KAAK,cAAc;YACjB,IAAI,GAAG,cAAc,CAAC;YACtB,OAAO,GAAG,qBAAqB,CAAC;YAChC,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,GAAG,kDAAkD,CAAC;YAChE,MAAM;QACR,KAAK,WAAW;YACd,IAAI,GAAG,qBAAqB,CAAC;YAC7B,OAAO,GAAG,iCAAiC,CAAC;YAC5C,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,GAAG,qBAAqB,CAAC;YACnC,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,GAAG,SAAS,CAAC;YACjB,OAAO,GAAG,mBAAmB,CAAC;YAC9B,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,GAAG,kCAAkC,CAAC;YAChD,MAAM;QACR,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,IAAI,GAAG,iBAAiB,CAAC;YACzB,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,IAAI,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtG,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;YACtC,SAAS,GAAG,KAAK,CAAC;YAClB,UAAU,GAAG,0BAA0B,CAAC;YACxC,MAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC;QACf;YACE,IAAI,GAAG,eAAe,CAAC;YACvB,OAAO,GAAG,8BAA8B,CAAC;YACzC,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,GAAG,8CAA8C,CAAC;YAC5D,MAAM;IACV,CAAC;IAED,MAAM,MAAM,GAAsB,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACxF,IAAI,OAAO,EAAE,QAAQ;QAAE,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IACtD,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS;QAAE,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACpF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { withRetry, wrapTools, createRetryPolicy } from './retry.js';
+export { createCircuitBreaker } from './circuit-breaker.js';
+export { classifyError } from './classify.js';
+export { formatErrorForLLM } from './format-error.js';
+export type { ErrorCategory, ErrorClassification, ErrorClassifier, BackoffStrategy, JitterStrategy, CircuitState, RetryPolicy, CircuitBreakerConfig, LLMFormattedError, ToolRetryOptions, ToolRetryHooks, } from './types.js';
+export type { CircuitBreakerInstance } from './circuit-breaker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,cAAc,EACd,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatErrorForLLM = exports.classifyError = exports.createCircuitBreaker = exports.createRetryPolicy = exports.wrapTools = exports.withRetry = void 0;
+// tool-call-retry - AI-specific retry wrapper with circuit breaker for tool calls
+var retry_js_1 = require("./retry.js");
+Object.defineProperty(exports, "withRetry", { enumerable: true, get: function () { return retry_js_1.withRetry; } });
+Object.defineProperty(exports, "wrapTools", { enumerable: true, get: function () { return retry_js_1.wrapTools; } });
+Object.defineProperty(exports, "createRetryPolicy", { enumerable: true, get: function () { return retry_js_1.createRetryPolicy; } });
+var circuit_breaker_js_1 = require("./circuit-breaker.js");
+Object.defineProperty(exports, "createCircuitBreaker", { enumerable: true, get: function () { return circuit_breaker_js_1.createCircuitBreaker; } });
+var classify_js_1 = require("./classify.js");
+Object.defineProperty(exports, "classifyError", { enumerable: true, get: function () { return classify_js_1.classifyError; } });
+var format_error_js_1 = require("./format-error.js");
+Object.defineProperty(exports, "formatErrorForLLM", { enumerable: true, get: function () { return format_error_js_1.formatErrorForLLM; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,kFAAkF;AAClF,uCAAqE;AAA5D,qGAAA,SAAS,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAChD,2DAA4D;AAAnD,0HAAA,oBAAoB,OAAA;AAC7B,6CAA8C;AAArC,4GAAA,aAAa,OAAA;AACtB,qDAAsD;AAA7C,oHAAA,iBAAiB,OAAA"}

package/dist/retry.d.ts

@@ -0,0 +1,7 @@
+import type { LLMFormattedError, RetryPolicy, ToolRetryOptions } from './types.js';
+export declare function createRetryPolicy(options?: Partial<RetryPolicy>): Required<RetryPolicy>;
+export declare function withRetry<T>(fn: () => Promise<T>, options?: ToolRetryOptions & {
+    toolName?: string;
+}): Promise<T | LLMFormattedError>;
+export declare function wrapTools<T extends Record<string, (args: unknown) => Promise<unknown>>>(tools: T, options?: ToolRetryOptions): T;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMnF,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,CAUvF;AAmBD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,gBAAgB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACjD,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC,CA+FhC;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,EACrF,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,gBAAgB,GACzB,CAAC,CAQH"}

package/dist/retry.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRetryPolicy = createRetryPolicy;
+exports.withRetry = withRetry;
+exports.wrapTools = wrapTools;
+const classify_js_1 = require("./classify.js");
+const backoff_js_1 = require("./backoff.js");
+const circuit_breaker_js_1 = require("./circuit-breaker.js");
+const format_error_js_1 = require("./format-error.js");
+function createRetryPolicy(options) {
+    return {
+        maxRetries: options?.maxRetries ?? 3,
+        strategy: options?.strategy ?? 'exponential',
+        initialDelayMs: options?.initialDelayMs ?? 1000,
+        maxDelayMs: options?.maxDelayMs ?? 30000,
+        multiplier: options?.multiplier ?? 2,
+        jitter: options?.jitter ?? 'full',
+        maxTotalTimeMs: options?.maxTotalTimeMs ?? 60000,
+    };
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new DOMException('Aborted', 'AbortError'));
+            return;
+        }
+        const timer = setTimeout(resolve, ms);
+        if (signal) {
+            const onAbort = () => {
+                clearTimeout(timer);
+                reject(new DOMException('Aborted', 'AbortError'));
+            };
+            signal.addEventListener('abort', onAbort, { once: true });
+        }
+    });
+}
+async function withRetry(fn, options) {
+    const policy = createRetryPolicy({
+        ...options?.policy,
+        ...(options?.maxRetries !== undefined ? { maxRetries: options.maxRetries } : {}),
+    });
+    const cb = options?.circuitBreaker !== false
+        ? (0, circuit_breaker_js_1.createCircuitBreaker)(options?.circuitBreaker === undefined ? undefined : options.circuitBreaker)
+        : null;
+    const startTime = Date.now();
+    let prevDelay = policy.initialDelayMs;
+    let attempt = 0;
+    while (true) {
+        // Check circuit breaker before each attempt
+        if (cb && !cb.isCallPermitted) {
+            const formatted = (0, format_error_js_1.formatErrorForLLM)(new Error('Circuit breaker is open'), { toolName: options?.toolName, attemptsMade: attempt });
+            if (options?.onPermanentFailure === 'return-error')
+                return formatted;
+            const err = new Error('Circuit breaker is open');
+            options?.hooks?.onPermanentFailure?.({
+                error: err,
+                attempts: attempt,
+                totalMs: Date.now() - startTime,
+                formattedError: formatted,
+            });
+            throw err;
+        }
+        try {
+            const result = await fn();
+            cb?.recordSuccess();
+            options?.hooks?.onSuccess?.({ attempts: attempt + 1, totalMs: Date.now() - startTime });
+            return result;
+        }
+        catch (error) {
+            // Check if aborted by signal
+            if (options?.signal?.aborted) {
+                throw error;
+            }
+            cb?.recordFailure();
+            const classification = (0, classify_js_1.classifyError)(error, options?.classifyError);
+            attempt++;
+            const isPermanent = classification.category === 'non-retriable' || attempt > policy.maxRetries;
+            if (isPermanent) {
+                const formatted = (0, format_error_js_1.formatErrorForLLM)(error, {
+                    toolName: options?.toolName,
+                    attemptsMade: attempt,
+                });
+                options?.hooks?.onPermanentFailure?.({
+                    error,
+                    attempts: attempt,
+                    totalMs: Date.now() - startTime,
+                    formattedError: formatted,
+                });
+                if (options?.onPermanentFailure === 'return-error')
+                    return formatted;
+                throw error;
+            }
+            // Check total time budget
+            if (Date.now() - startTime >= policy.maxTotalTimeMs) {
+                const formatted = (0, format_error_js_1.formatErrorForLLM)(error, {
+                    toolName: options?.toolName,
+                    attemptsMade: attempt,
+                });
+                options?.hooks?.onPermanentFailure?.({
+                    error,
+                    attempts: attempt,
+                    totalMs: Date.now() - startTime,
+                    formattedError: formatted,
+                });
+                if (options?.onPermanentFailure === 'return-error')
+                    return formatted;
+                throw error;
+            }
+            let delay = (0, backoff_js_1.computeDelay)(attempt, policy, prevDelay);
+            if (classification.retryAfterMs !== undefined) {
+                delay = Math.max(delay, classification.retryAfterMs);
+            }
+            prevDelay = delay;
+            options?.hooks?.onRetry?.({ attempt, error, delayMs: delay, classification });
+            await sleep(delay, options?.signal);
+        }
+    }
+}
+function wrapTools(tools, options) {
+    const wrapped = {};
+    for (const key of Object.keys(tools)) {
+        const original = tools[key];
+        wrapped[key] = (args) => withRetry(() => original(args), { ...options, toolName: key });
+    }
+    return wrapped;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+export type ErrorCategory = 'retriable' | 'non-retriable' | 'rate-limited' | 'timeout' | 'unknown';
+export interface ErrorClassification {
+    category: ErrorCategory;
+    code: string;
+    message: string;
+    statusCode?: number;
+    retryAfterMs?: number;
+}
+export type ErrorClassifier = (error: unknown) => ErrorClassification | null;
+export type BackoffStrategy = 'exponential' | 'linear' | 'fixed' | 'custom';
+export type JitterStrategy = 'full' | 'equal' | 'decorrelated' | 'none';
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface RetryPolicy {
+    maxRetries?: number;
+    strategy?: BackoffStrategy;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    multiplier?: number;
+    jitter?: JitterStrategy;
+    maxTotalTimeMs?: number;
+}
+export interface CircuitBreakerConfig {
+    enabled?: boolean;
+    failureThreshold?: number;
+    rollingWindowMs?: number;
+    resetTimeoutMs?: number;
+    successThreshold?: number;
+}
+export interface LLMFormattedError {
+    error: true;
+    code: string;
+    message: string;
+    retriable: boolean;
+    suggestion: string;
+    tool?: string;
+    attemptsMade?: number;
+}
+export interface ToolRetryOptions {
+    policy?: RetryPolicy;
+    maxRetries?: number;
+    circuitBreaker?: CircuitBreakerConfig | false;
+    classifyError?: ErrorClassifier;
+    onPermanentFailure?: 'throw' | 'return-error';
+    signal?: AbortSignal;
+    hooks?: ToolRetryHooks;
+}
+export interface ToolRetryHooks {
+    onRetry?: (info: {
+        attempt: number;
+        error: unknown;
+        delayMs: number;
+        classification: ErrorClassification;
+    }) => void;
+    onSuccess?: (info: {
+        attempts: number;
+        totalMs: number;
+    }) => void;
+    onPermanentFailure?: (info: {
+        error: unknown;
+        attempts: number;
+        totalMs: number;
+        formattedError: LLMFormattedError;
+    }) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,mBAAmB,GAAG,IAAI,CAAC;AAE7E,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,MAAM,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;IAC9C,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,mBAAmB,CAAA;KAAE,KAAK,IAAI,CAAC;IACpH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClE,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,iBAAiB,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/H"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "tool-call-retry",
+  "version": "0.1.0",
+  "description": "AI-specific retry wrapper with circuit breaker for tool calls",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
+    "eslint": "^10.1.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}