beth-copilot 1.0.13 → 1.0.15

package/dist/providers/retry.test.js

@@ -0,0 +1,439 @@
+/**
+ * Retry Utility Tests
+ *
+ * Tests for exponential backoff retry logic.
+ */
+import { describe, it, mock } from 'node:test';
+import assert from 'node:assert';
+import { calculateDelay, isTransientError, retry, RetryError } from './retry.js';
+describe('RetryError', () => {
+    describe('constructor', () => {
+        it('should set message correctly', () => {
+            const lastError = new Error('Last error');
+            const error = new RetryError('All attempts failed', 3, lastError);
+            assert.strictEqual(error.message, 'All attempts failed');
+        });
+        it('should set attempts correctly', () => {
+            const lastError = new Error('Last error');
+            const error = new RetryError('Failed', 5, lastError);
+            assert.strictEqual(error.attempts, 5);
+        });
+        it('should set lastError correctly', () => {
+            const lastError = new Error('Original failure');
+            const error = new RetryError('Failed', 3, lastError);
+            assert.strictEqual(error.lastError, lastError);
+            assert.strictEqual(error.lastError.message, 'Original failure');
+        });
+        it('should set name to "RetryError"', () => {
+            const lastError = new Error('Test');
+            const error = new RetryError('Failed', 1, lastError);
+            assert.strictEqual(error.name, 'RetryError');
+        });
+        it('should inherit from Error', () => {
+            const lastError = new Error('Test');
+            const error = new RetryError('Failed', 1, lastError);
+            assert.ok(error instanceof Error);
+            assert.ok(error instanceof RetryError);
+        });
+        it('should have a stack trace', () => {
+            const lastError = new Error('Test');
+            const error = new RetryError('Failed', 1, lastError);
+            assert.ok(typeof error.stack === 'string');
+            assert.ok(error.stack.length > 0);
+        });
+    });
+});
+describe('calculateDelay', () => {
+    describe('without jitter', () => {
+        it('should return baseDelay for attempt 0', () => {
+            const delay = calculateDelay(0, 1000, 30000, false);
+            assert.strictEqual(delay, 1000);
+        });
+        it('should return 2*baseDelay for attempt 1 (exponential backoff)', () => {
+            const delay = calculateDelay(1, 1000, 30000, false);
+            assert.strictEqual(delay, 2000);
+        });
+        it('should return 4*baseDelay for attempt 2', () => {
+            const delay = calculateDelay(2, 1000, 30000, false);
+            assert.strictEqual(delay, 4000);
+        });
+        it('should return 8*baseDelay for attempt 3', () => {
+            const delay = calculateDelay(3, 1000, 30000, false);
+            assert.strictEqual(delay, 8000);
+        });
+        it('should follow formula baseDelay * 2^attempt', () => {
+            const baseDelay = 500;
+            const maxDelay = 100000;
+            for (let attempt = 0; attempt < 5; attempt++) {
+                const expected = baseDelay * Math.pow(2, attempt);
+                const actual = calculateDelay(attempt, baseDelay, maxDelay, false);
+                assert.strictEqual(actual, expected, `attempt ${attempt} should be ${expected}`);
+            }
+        });
+        it('should cap at maxDelay', () => {
+            const delay = calculateDelay(10, 1000, 5000, false);
+            assert.strictEqual(delay, 5000);
+        });
+        it('should cap when exponential exceeds maxDelay', () => {
+            // attempt 4 with base 1000 = 16000, but maxDelay is 10000
+            const delay = calculateDelay(4, 1000, 10000, false);
+            assert.strictEqual(delay, 10000);
+        });
+        it('should work with small baseDelay', () => {
+            const delay = calculateDelay(0, 1, 100, false);
+            assert.strictEqual(delay, 1);
+        });
+    });
+    describe('with jitter', () => {
+        it('should return value in expected range (0.5x to 1.5x) for attempt 0', () => {
+            const baseDelay = 1000;
+            const lowerBound = baseDelay * 0.5;
+            const upperBound = baseDelay * 1.5;
+            // Run multiple times to test jitter variance
+            for (let i = 0; i < 10; i++) {
+                const delay = calculateDelay(0, baseDelay, 30000, true);
+                assert.ok(delay >= lowerBound - 1, `delay ${delay} should be >= ${lowerBound}`);
+                assert.ok(delay <= upperBound + 1, `delay ${delay} should be <= ${upperBound}`);
+            }
+        });
+        it('should return varying values due to randomness', () => {
+            const delays = new Set();
+            // Generate many delays; with jitter they should vary
+            for (let i = 0; i < 50; i++) {
+                const delay = calculateDelay(0, 1000, 30000, true);
+                delays.add(delay);
+            }
+            // With 50 samples and jitter, we should have multiple unique values
+            assert.ok(delays.size > 1, 'Jitter should produce varying delays');
+        });
+        it('should respect maxDelay cap even with jitter', () => {
+            const maxDelay = 1000;
+            for (let i = 0; i < 10; i++) {
+                const delay = calculateDelay(5, 1000, maxDelay, true);
+                assert.ok(delay <= maxDelay * 1.5 + 1, `delay should not greatly exceed maxDelay * 1.5`);
+            }
+        });
+        it('should return integers (floor applied)', () => {
+            for (let i = 0; i < 10; i++) {
+                const delay = calculateDelay(0, 1000, 30000, true);
+                assert.strictEqual(Math.floor(delay), delay, 'delay should be an integer');
+            }
+        });
+    });
+});
+describe('isTransientError', () => {
+    describe('HTTP status codes', () => {
+        describe('retryable status codes', () => {
+            const retryableStatuses = [429, 500, 502, 503, 504];
+            for (const status of retryableStatuses) {
+                it(`should return true for HTTP ${status}`, () => {
+                    const error = new Error('Test error');
+                    error.status = status;
+                    const result = isTransientError(error);
+                    assert.strictEqual(result, true);
+                });
+                it(`should return true for HTTP ${status} using statusCode property`, () => {
+                    const error = new Error('Test error');
+                    error.statusCode = status;
+                    const result = isTransientError(error);
+                    assert.strictEqual(result, true);
+                });
+            }
+        });
+        describe('non-retryable status codes', () => {
+            const nonRetryableStatuses = [400, 401, 403, 404, 405, 422];
+            for (const status of nonRetryableStatuses) {
+                it(`should return false for HTTP ${status}`, () => {
+                    const error = new Error('Test error');
+                    error.status = status;
+                    const result = isTransientError(error);
+                    assert.strictEqual(result, false);
+                });
+            }
+        });
+    });
+    describe('network error codes', () => {
+        const transientNetworkCodes = [
+            'ECONNRESET',
+            'ETIMEDOUT',
+            'ECONNREFUSED',
+            'ENOTFOUND',
+            'ENETUNREACH',
+            'EHOSTUNREACH',
+            'EPIPE',
+            'EAI_AGAIN',
+        ];
+        for (const code of transientNetworkCodes) {
+            it(`should return true for ${code}`, () => {
+                const error = new Error('Network error');
+                error.code = code;
+                const result = isTransientError(error);
+                assert.strictEqual(result, true, `${code} should be transient`);
+            });
+        }
+        it('should return false for unknown error code', () => {
+            const error = new Error('Unknown error');
+            error.code = 'UNKNOWN_CODE';
+            const result = isTransientError(error);
+            assert.strictEqual(result, false);
+        });
+    });
+    describe('errors without status or code', () => {
+        it('should return false for plain Error', () => {
+            const error = new Error('Plain error');
+            const result = isTransientError(error);
+            assert.strictEqual(result, false);
+        });
+        it('should return false for error with only message', () => {
+            const error = new Error('Something went wrong');
+            const result = isTransientError(error);
+            assert.strictEqual(result, false);
+        });
+    });
+    describe('custom retryableStatuses', () => {
+        it('should use custom retryable statuses', () => {
+            const error = new Error('Test');
+            error.status = 418; // I'm a teapot
+            // With default, 418 is not retryable
+            assert.strictEqual(isTransientError(error), false);
+            // With custom statuses including 418
+            assert.strictEqual(isTransientError(error, [418]), true);
+        });
+        it('should not treat default retryable status as retryable if excluded from custom list', () => {
+            const error = new Error('Test');
+            error.status = 429;
+            // With custom statuses not including 429
+            assert.strictEqual(isTransientError(error, [500]), false);
+        });
+        it('should still check network codes even with custom statuses', () => {
+            const error = new Error('Network error');
+            error.code = 'ECONNRESET';
+            // Network error codes are checked independently of HTTP statuses
+            assert.strictEqual(isTransientError(error, [400]), true);
+        });
+    });
+});
+describe('retry', () => {
+    describe('successful execution', () => {
+        it('should return result on first success', async () => {
+            const fn = mock.fn(async () => 'success');
+            const result = await retry(fn, { baseDelay: 1, jitter: false });
+            assert.strictEqual(result, 'success');
+            assert.strictEqual(fn.mock.calls.length, 1);
+        });
+        it('should return the value from async function', async () => {
+            const fn = mock.fn(async () => ({ data: [1, 2, 3] }));
+            const result = await retry(fn, { baseDelay: 1 });
+            assert.deepStrictEqual(result, { data: [1, 2, 3] });
+        });
+    });
+    describe('retry on transient error', () => {
+        it('should retry and eventually succeed', async () => {
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                if (attempts < 3) {
+                    const error = new Error('Server error');
+                    error.status = 500;
+                    throw error;
+                }
+                return 'success after retry';
+            };
+            const result = await retry(fn, { baseDelay: 1, jitter: false });
+            assert.strictEqual(result, 'success after retry');
+            assert.strictEqual(attempts, 3);
+        });
+        it('should retry on rate limit error', async () => {
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                if (attempts === 1) {
+                    const error = new Error('Rate limited');
+                    error.status = 429;
+                    throw error;
+                }
+                return 'success';
+            };
+            const result = await retry(fn, { baseDelay: 1, jitter: false });
+            assert.strictEqual(result, 'success');
+            assert.strictEqual(attempts, 2);
+        });
+        it('should retry on network error', async () => {
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                if (attempts === 1) {
+                    const error = new Error('Connection reset');
+                    error.code = 'ECONNRESET';
+                    throw error;
+                }
+                return 'connected';
+            };
+            const result = await retry(fn, { baseDelay: 1, jitter: false });
+            assert.strictEqual(result, 'connected');
+            assert.strictEqual(attempts, 2);
+        });
+    });
+    describe('exhausted retries', () => {
+        it('should throw RetryError after exhausting maxRetries', async () => {
+            const fn = async () => {
+                const error = new Error('Always fails');
+                error.status = 503;
+                throw error;
+            };
+            await assert.rejects(retry(fn, { maxRetries: 2, baseDelay: 1, jitter: false }), (error) => {
+                assert.ok(error instanceof RetryError);
+                assert.strictEqual(error.attempts, 3); // 1 initial + 2 retries
+                assert.strictEqual(error.lastError.message, 'Always fails');
+                return true;
+            });
+        });
+        it('should include total attempts in error message', async () => {
+            const fn = async () => {
+                const error = new Error('Fail');
+                error.status = 500;
+                throw error;
+            };
+            await assert.rejects(retry(fn, { maxRetries: 3, baseDelay: 1, jitter: false }), (error) => {
+                assert.ok(error instanceof RetryError);
+                assert.ok(error.message.includes('4'), 'Should mention 4 total attempts');
+                return true;
+            });
+        });
+    });
+    describe('non-transient error', () => {
+        it('should throw immediately without retry for 400 error', async () => {
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                const error = new Error('Bad request');
+                error.status = 400;
+                throw error;
+            };
+            await assert.rejects(retry(fn, { maxRetries: 3, baseDelay: 1 }), (error) => {
+                assert.ok(error instanceof Error);
+                assert.strictEqual(error.message, 'Bad request');
+                assert.ok(!(error instanceof RetryError), 'Should not be RetryError');
+                return true;
+            });
+            assert.strictEqual(attempts, 1, 'Should only attempt once');
+        });
+        it('should throw immediately without retry for 401 error', async () => {
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                const error = new Error('Unauthorized');
+                error.status = 401;
+                throw error;
+            };
+            await assert.rejects(retry(fn, { maxRetries: 3, baseDelay: 1 }), (error) => {
+                assert.ok(error instanceof Error);
+                return true;
+            });
+            assert.strictEqual(attempts, 1);
+        });
+        it('should throw immediately for 403 error', async () => {
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                const error = new Error('Forbidden');
+                error.status = 403;
+                throw error;
+            };
+            await assert.rejects(retry(fn, { maxRetries: 3, baseDelay: 1 }));
+            assert.strictEqual(attempts, 1);
+        });
+        it('should throw immediately for plain error without status', async () => {
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                throw new Error('Unknown error');
+            };
+            await assert.rejects(retry(fn, { maxRetries: 3, baseDelay: 1 }));
+            assert.strictEqual(attempts, 1);
+        });
+    });
+    describe('onRetry callback', () => {
+        it('should call onRetry with correct arguments', async () => {
+            const onRetryCalls = [];
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                if (attempts < 3) {
+                    const error = new Error('Server error');
+                    error.status = 500;
+                    throw error;
+                }
+                return 'done';
+            };
+            await retry(fn, {
+                baseDelay: 1,
+                jitter: false,
+                onRetry: (error, attempt, delay) => {
+                    onRetryCalls.push({ error, attempt, delay });
+                },
+            });
+            assert.strictEqual(onRetryCalls.length, 2);
+            // First retry
+            assert.strictEqual(onRetryCalls[0].attempt, 1);
+            assert.strictEqual(onRetryCalls[0].delay, 1); // baseDelay * 2^0
+            // Second retry
+            assert.strictEqual(onRetryCalls[1].attempt, 2);
+            assert.strictEqual(onRetryCalls[1].delay, 2); // baseDelay * 2^1
+        });
+        it('should not call onRetry on successful first attempt', async () => {
+            const onRetry = mock.fn();
+            const fn = async () => 'success';
+            await retry(fn, { baseDelay: 1, onRetry });
+            assert.strictEqual(onRetry.mock.calls.length, 0);
+        });
+    });
+    describe('maxRetries = 0', () => {
+        it('should only attempt once with maxRetries=0', async () => {
+            let attempts = 0;
+            const fn = async () => {
+                attempts++;
+                const error = new Error('Fail');
+                error.status = 500;
+                throw error;
+            };
+            await assert.rejects(retry(fn, { maxRetries: 0, baseDelay: 1 }), (error) => {
+                assert.ok(error instanceof RetryError);
+                assert.strictEqual(error.attempts, 1);
+                return true;
+            });
+            assert.strictEqual(attempts, 1);
+        });
+        it('should succeed with maxRetries=0 if first attempt succeeds', async () => {
+            const fn = async () => 'immediate success';
+            const result = await retry(fn, { maxRetries: 0, baseDelay: 1 });
+            assert.strictEqual(result, 'immediate success');
+        });
+    });
+    describe('options defaults', () => {
+        it('should work with empty options object', async () => {
+            const fn = async () => 'result';
+            // Uses default options
+            const result = await retry(fn, {});
+            assert.strictEqual(result, 'result');
+        });
+        it('should work with no options', async () => {
+            const fn = async () => 'result';
+            const result = await retry(fn);
+            assert.strictEqual(result, 'result');
+        });
+    });
+    describe('error conversion', () => {
+        it('should convert non-Error throws to Error', async () => {
+            const fn = async () => {
+                throw 'string error'; // eslint-disable-line @typescript-eslint/only-throw-error
+            };
+            await assert.rejects(retry(fn, { maxRetries: 0, baseDelay: 1 }), (error) => {
+                assert.ok(error instanceof RetryError);
+                assert.ok(error.lastError instanceof Error);
+                return true;
+            });
+        });
+    });
+});
+//# sourceMappingURL=retry.test.js.map

package/dist/providers/retry.test.js.map

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

package/dist/providers/streaming.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Stream Handler Utilities for LLM Streaming Responses
+ *
+ * Provides utilities for processing incremental streaming responses from LLM APIs.
+ * Handles content accumulation, tool call assembly from deltas, and stream transformation.
+ */
+import type { ChatChunk, ChatRole, FinishReason, ToolCall } from './types.js';
+/**
+ * Accumulates streamed chat response chunks into a complete response.
+ *
+ * Handles the complexity of:
+ * - Concatenating content chunks as they arrive
+ * - Assembling tool calls from incremental deltas (by index)
+ * - Tracking the finish reason from the final chunk
+ * - Managing multiple in-flight tool calls simultaneously
+ *
+ * @example
+ * ```typescript
+ * const accumulator = new StreamAccumulator();
+ *
+ * for await (const chunk of stream) {
+ *   accumulator.processChunk(chunk);
+ * }
+ *
+ * console.log(accumulator.getContent());
+ * console.log(accumulator.getToolCalls());
+ * console.log(accumulator.getFinishReason());
+ * ```
+ */
+export declare class StreamAccumulator {
+    /** Accumulated text content from all chunks */
+    private content;
+    /** Map of tool call index to partially assembled tool call */
+    private toolCallMap;
+    /** Finish reason from the final chunk */
+    private finishReason;
+    /** Role from the response (typically from first chunk) */
+    private role;
+    /**
+     * Process a single chunk from the stream.
+     *
+     * Updates internal state with any content, tool call deltas,
+     * role, or finish reason present in the chunk.
+     *
+     * @param chunk - The chat chunk to process
+     */
+    processChunk(chunk: ChatChunk): void;
+    /**
+     * Process a tool call delta and merge it into the accumulated state.
+     *
+     * Tool calls arrive incrementally:
+     * - First chunk: id, type, function.name
+     * - Subsequent chunks: function.arguments (appended)
+     *
+     * @param delta - The tool call delta to process
+     */
+    private processToolCallDelta;
+    /**
+     * Get the accumulated text content.
+     *
+     * @returns The complete text content from all processed chunks
+     */
+    getContent(): string;
+    /**
+     * Get the assembled tool calls.
+     *
+     * Returns tool calls sorted by their original index order.
+     *
+     * @returns Array of fully assembled tool calls
+     */
+    getToolCalls(): ToolCall[];
+    /**
+     * Get the finish reason from the final chunk.
+     *
+     * @returns The finish reason, or null if stream hasn't finished
+     */
+    getFinishReason(): FinishReason | null;
+    /**
+     * Get the role of the response.
+     *
+     * @returns The chat role (defaults to 'assistant' if not specified)
+     */
+    getRole(): ChatRole;
+    /**
+     * Reset the accumulator for reuse.
+     *
+     * Clears all accumulated state, allowing the accumulator to be
+     * reused for processing a new stream.
+     */
+    reset(): void;
+}
+/**
+ * Result of collecting a complete stream.
+ */
+export interface CollectedStreamResult {
+    /** Accumulated text content */
+    content: string;
+    /** Assembled tool calls */
+    toolCalls: ToolCall[];
+    /** Finish reason from the final chunk */
+    finishReason: FinishReason | null;
+}
+/**
+ * Consume an entire stream and collect the results.
+ *
+ * This is a convenience function that uses StreamAccumulator internally
+ * to process all chunks and return the final aggregated result.
+ *
+ * @param stream - Async iterable of chat chunks
+ * @returns Promise resolving to the collected stream result
+ *
+ * @example
+ * ```typescript
+ * const stream = client.streamCompletion(messages);
+ * const result = await collectStream(stream);
+ *
+ * if (result.toolCalls.length > 0) {
+ *   // Handle tool calls
+ * } else {
+ *   console.log(result.content);
+ * }
+ * ```
+ */
+export declare function collectStream(stream: AsyncIterable<ChatChunk>): Promise<CollectedStreamResult>;
+/**
+ * Transform stream chunks using a mapping function.
+ *
+ * Creates a new async generator that yields transformed values
+ * for each chunk in the input stream.
+ *
+ * @typeParam T - The output type of the mapper function
+ * @param stream - Async iterable of chat chunks
+ * @param mapper - Function to transform each chunk
+ * @returns Async generator yielding transformed values
+ *
+ * @example
+ * ```typescript
+ * // Extract just the content from each chunk
+ * const contentStream = mapStream(stream, (chunk) => chunk.content ?? '');
+ *
+ * for await (const text of contentStream) {
+ *   process.stdout.write(text);
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Transform to custom event format
+ * const eventStream = mapStream(stream, (chunk) => ({
+ *   type: 'delta',
+ *   text: chunk.content,
+ *   done: chunk.finish_reason !== null,
+ * }));
+ * ```
+ */
+export declare function mapStream<T>(stream: AsyncIterable<ChatChunk>, mapper: (chunk: ChatChunk) => T): AsyncGenerator<T>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/providers/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/providers/streaming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,QAAQ,EAET,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,iBAAiB;IAC5B,+CAA+C;IAC/C,OAAO,CAAC,OAAO,CAAc;IAE7B,8DAA8D;IAC9D,OAAO,CAAC,WAAW,CAA2C;IAE9D,yCAAyC;IACzC,OAAO,CAAC,YAAY,CAA6B;IAEjD,0DAA0D;IAC1D,OAAO,CAAC,IAAI,CAAyB;IAErC;;;;;;;OAOG;IACH,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAwBpC;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAiC5B;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;;;OAMG;IACH,YAAY,IAAI,QAAQ,EAAE;IAgB1B;;;;OAIG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;;;OAIG;IACH,OAAO,IAAI,QAAQ;IAInB;;;;;OAKG;IACH,KAAK,IAAI,IAAI;CAMd;AA4BD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,2BAA2B;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IAEtB,yCAAyC;IACzC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAYhC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAuB,SAAS,CAAC,CAAC,EAChC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAChC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,CAAC,GAC9B,cAAc,CAAC,CAAC,CAAC,CAInB"}