@trenchwork/coder 1.3.0

package/dist/providers/baseProvider.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Base Provider - Abstract LLM Provider Implementation
+ *
+ * Provides common functionality for LLM providers:
+ * - Retry logic with exponential backoff
+ * - Rate limit handling
+ * - Transient error recovery
+ * - Message conversion utilities
+ * - Usage tracking
+ *
+ * Usage:
+ * ```typescript
+ * class MyProvider extends BaseProvider {
+ *   readonly id = 'my-provider';
+ *
+ *   protected async doGenerate(messages, tools): Promise<ProviderResponse> {
+ *     // Provider-specific implementation
+ *   }
+ *
+ *   protected async doGenerateStream(messages, tools): AsyncIterable<StreamChunk> {
+ *     // Provider-specific implementation
+ *   }
+ * }
+ * ```
+ */
+import type { ConversationMessage, LLMProvider, ProviderResponse, ProviderToolDefinition, ProviderUsage, StreamChunk, ProviderModelInfo } from '../core/types.js';
+import { isBaseTransientError, isBaseRateLimitError, isAuthError } from '../core/errorClassification.js';
+/** Patterns that indicate transient/retryable errors (canonical: errorClassification) */
+export declare const TRANSIENT_ERROR_PATTERNS: readonly ["premature close", "premature end", "unexpected end", "aborted", "fetcherror", "invalid response body", "gunzip", "decompress", "econnreset", "econnrefused", "epipe", "socket hang up", "network", "timeout", "500", "502", "503", "504", "overloaded"];
+/** Default retry configuration */
+export declare const DEFAULT_RETRY_CONFIG: {
+    readonly maxRetries: 3;
+    readonly initialDelayMs: 1000;
+    readonly maxDelayMs: 30000;
+    readonly backoffMultiplier: 2;
+};
+/** Default rate limit configuration */
+export declare const DEFAULT_RATE_LIMIT_CONFIG: {
+    readonly maxRetries: 4;
+    readonly initialDelayMs: 1500;
+    readonly minDelayMs: 750;
+    readonly maxDelayMs: 40000;
+};
+export interface RetryConfig {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+}
+export interface RateLimitConfig {
+    maxRetries: number;
+    initialDelayMs: number;
+    minDelayMs: number;
+    maxDelayMs: number;
+}
+export interface BaseProviderOptions {
+    model: string;
+    maxTokens?: number;
+    temperature?: number;
+    retryConfig?: Partial<RetryConfig>;
+    rateLimitConfig?: Partial<RateLimitConfig>;
+}
+export declare const isTransientError: typeof isBaseTransientError;
+export declare const isRateLimitError: typeof isBaseRateLimitError;
+export { isAuthError };
+/**
+ * Sleep for a given duration
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Calculate exponential backoff delay
+ */
+export declare function calculateBackoffDelay(attempt: number, config: RetryConfig): number;
+/**
+ * Execute an operation with retry logic
+ */
+export declare function withRetry<T>(operation: () => Promise<T>, options?: {
+    config?: Partial<RetryConfig>;
+    shouldRetry?: (error: unknown) => boolean;
+    onRetry?: (error: unknown, attempt: number, delay: number) => void;
+}): Promise<T>;
+/**
+ * Extract system message from conversation
+ */
+export declare function extractSystemMessage(messages: ConversationMessage[]): {
+    system: string | null;
+    rest: ConversationMessage[];
+};
+/**
+ * Merge consecutive messages from the same role
+ */
+export declare function mergeConsecutiveMessages(messages: ConversationMessage[]): ConversationMessage[];
+/**
+ * Create an empty usage object
+ */
+export declare function emptyUsage(): ProviderUsage;
+/**
+ * Merge usage objects
+ */
+export declare function mergeUsage(a: ProviderUsage, b: ProviderUsage): ProviderUsage;
+/**
+ * Abstract base class for LLM providers
+ *
+ * Implements common functionality like retry logic and error handling.
+ * Subclasses must implement the abstract methods for provider-specific behavior.
+ */
+export declare abstract class BaseProvider implements LLMProvider {
+    abstract readonly id: string;
+    readonly model: string;
+    protected readonly maxTokens: number;
+    protected readonly temperature: number;
+    protected readonly retryConfig: RetryConfig;
+    protected readonly rateLimitConfig: RateLimitConfig;
+    constructor(options: BaseProviderOptions);
+    /**
+     * Generate a response (implemented by subclass)
+     */
+    generate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    /**
+     * Generate a streaming response (implemented by subclass)
+     */
+    generateStream(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    /**
+     * Get available models (optional, implemented by subclass)
+     */
+    getModels(): Promise<ProviderModelInfo[]>;
+    /**
+     * Provider-specific generate implementation
+     */
+    protected abstract doGenerate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    /**
+     * Provider-specific stream implementation
+     */
+    protected abstract doGenerateStream(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterable<StreamChunk>;
+    /**
+     * Called when a retry is about to happen
+     */
+    protected onRetry(_error: unknown, _attempt: number, _delay: number): void;
+}
+//# sourceMappingURL=baseProvider.d.ts.map

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

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

package/dist/providers/baseProvider.js

@@ -0,0 +1,230 @@
+/**
+ * Base Provider - Abstract LLM Provider Implementation
+ *
+ * Provides common functionality for LLM providers:
+ * - Retry logic with exponential backoff
+ * - Rate limit handling
+ * - Transient error recovery
+ * - Message conversion utilities
+ * - Usage tracking
+ *
+ * Usage:
+ * ```typescript
+ * class MyProvider extends BaseProvider {
+ *   readonly id = 'my-provider';
+ *
+ *   protected async doGenerate(messages, tools): Promise<ProviderResponse> {
+ *     // Provider-specific implementation
+ *   }
+ *
+ *   protected async doGenerateStream(messages, tools): AsyncIterable<StreamChunk> {
+ *     // Provider-specific implementation
+ *   }
+ * }
+ * ```
+ */
+// Error classification lives in the canonical module (audit Rank 5). These are
+// re-exported below under this module's historical public names so importers
+// (test/providers/baseProvider.test.ts) and withRetry's defaults are unchanged.
+import { BASE_TRANSIENT_ERROR_PATTERNS, isBaseTransientError, isBaseRateLimitError, isAuthError, } from '../core/errorClassification.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Constants
+// ═══════════════════════════════════════════════════════════════════════════════
+/** Patterns that indicate transient/retryable errors (canonical: errorClassification) */
+export const TRANSIENT_ERROR_PATTERNS = BASE_TRANSIENT_ERROR_PATTERNS;
+/** Default retry configuration */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+};
+/** Default rate limit configuration */
+export const DEFAULT_RATE_LIMIT_CONFIG = {
+    maxRetries: 4,
+    initialDelayMs: 1500,
+    minDelayMs: 750,
+    maxDelayMs: 40000,
+};
+// ═══════════════════════════════════════════════════════════════════════════════
+// Error Detection Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+// Re-exported under this module's historical public names. Definitions live in
+// src/core/errorClassification.ts (moved verbatim, audit Rank 5). withRetry
+// below still references isTransientError/isAuthError through these bindings.
+export const isTransientError = isBaseTransientError;
+export const isRateLimitError = isBaseRateLimitError;
+export { isAuthError };
+// ═══════════════════════════════════════════════════════════════════════════════
+// Retry Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Sleep for a given duration
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Calculate exponential backoff delay
+ */
+export function calculateBackoffDelay(attempt, config) {
+    const delay = config.initialDelayMs * Math.pow(config.backoffMultiplier, attempt);
+    // Add jitter (±10%)
+    const jitter = delay * 0.1 * (Math.random() * 2 - 1);
+    return Math.min(delay + jitter, config.maxDelayMs);
+}
+/**
+ * Execute an operation with retry logic
+ */
+export async function withRetry(operation, options = {}) {
+    const config = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...options.config,
+    };
+    const shouldRetry = options.shouldRetry ?? isTransientError;
+    let lastError;
+    for (let attempt = 0; attempt <= config.maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry auth errors
+            if (isAuthError(error)) {
+                throw error;
+            }
+            // Check if we should retry
+            if (attempt === config.maxRetries || !shouldRetry(error)) {
+                throw error;
+            }
+            // Calculate delay and wait
+            const delay = calculateBackoffDelay(attempt, config);
+            options.onRetry?.(error, attempt, delay);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Message Utilities
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Extract system message from conversation
+ */
+export function extractSystemMessage(messages) {
+    const systemMessages = messages.filter((m) => m.role === 'system');
+    const rest = messages.filter((m) => m.role !== 'system');
+    if (systemMessages.length === 0) {
+        return { system: null, rest };
+    }
+    // Combine all system messages
+    const system = systemMessages
+        .map((m) => (typeof m.content === 'string' ? m.content : JSON.stringify(m.content)))
+        .join('\n\n');
+    return { system, rest };
+}
+/**
+ * Merge consecutive messages from the same role
+ */
+export function mergeConsecutiveMessages(messages) {
+    if (messages.length === 0)
+        return [];
+    const merged = [];
+    let current = null;
+    for (const message of messages) {
+        if (!current) {
+            current = { ...message };
+            continue;
+        }
+        if (current.role === message.role && typeof current.content === 'string' && typeof message.content === 'string') {
+            // Merge text content
+            current.content = `${current.content}\n\n${message.content}`;
+        }
+        else {
+            merged.push(current);
+            current = { ...message };
+        }
+    }
+    if (current) {
+        merged.push(current);
+    }
+    return merged;
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Usage Tracking
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Create an empty usage object
+ */
+export function emptyUsage() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+    };
+}
+/**
+ * Merge usage objects
+ */
+export function mergeUsage(a, b) {
+    return {
+        inputTokens: (a.inputTokens ?? 0) + (b.inputTokens ?? 0),
+        outputTokens: (a.outputTokens ?? 0) + (b.outputTokens ?? 0),
+        totalTokens: (a.totalTokens ?? 0) + (b.totalTokens ?? 0),
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// Abstract Base Provider
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Abstract base class for LLM providers
+ *
+ * Implements common functionality like retry logic and error handling.
+ * Subclasses must implement the abstract methods for provider-specific behavior.
+ */
+export class BaseProvider {
+    model;
+    maxTokens;
+    temperature;
+    retryConfig;
+    rateLimitConfig;
+    constructor(options) {
+        this.model = options.model;
+        this.maxTokens = options.maxTokens ?? 4096;
+        this.temperature = options.temperature ?? 0;
+        this.retryConfig = { ...DEFAULT_RETRY_CONFIG, ...options.retryConfig };
+        this.rateLimitConfig = { ...DEFAULT_RATE_LIMIT_CONFIG, ...options.rateLimitConfig };
+    }
+    /**
+     * Generate a response (implemented by subclass)
+     */
+    async generate(messages, tools) {
+        return withRetry(() => this.doGenerate(messages, tools), {
+            config: this.retryConfig,
+            shouldRetry: (error) => isTransientError(error) || isRateLimitError(error),
+            onRetry: (error, attempt, delay) => {
+                this.onRetry(error, attempt, delay);
+            },
+        });
+    }
+    /**
+     * Generate a streaming response (implemented by subclass)
+     */
+    async *generateStream(messages, tools) {
+        // Stream operations are harder to retry, so we do best-effort
+        yield* this.doGenerateStream(messages, tools);
+    }
+    /**
+     * Get available models (optional, implemented by subclass)
+     */
+    async getModels() {
+        return [];
+    }
+    /**
+     * Called when a retry is about to happen
+     */
+    onRetry(_error, _attempt, _delay) {
+        // Subclasses can override for logging
+    }
+}
+//# sourceMappingURL=baseProvider.js.map

package/dist/providers/baseProvider.js.map

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

package/dist/providers/openaiChatCompletionsProvider.d.ts

@@ -0,0 +1,70 @@
+import type { ConversationMessage, LLMProvider, ProviderId, ProviderModelInfo, ProviderResponse, ProviderToolDefinition, StreamChunk } from '../core/types.js';
+/**
+ * Security utility for safe JSON parsing with protection against prototype pollution
+ */
+export declare function safeJSONParse<T = unknown>(json: string, options?: {
+    maxDepth?: number;
+    maxProperties?: number;
+}): T;
+/**
+ * Custom error class for provider-specific failures
+ */
+export declare class ProviderStreamError extends Error {
+    readonly isRetryable: boolean;
+    readonly originalError?: Error;
+    readonly providerId: string;
+    constructor(message: string, providerId: string, originalError?: Error, isRetryable?: boolean);
+}
+interface OpenAIChatCompletionsOptions {
+    apiKey: string;
+    model: string;
+    providerId?: ProviderId;
+    baseURL?: string;
+    /** Request timeout in milliseconds (default: 120000) */
+    timeout?: number;
+    /** Maximum retries for transient errors (default: 3) */
+    maxRetries?: number;
+    /** Optional temperature override */
+    temperature?: number;
+    /** Maximum completion tokens to request (default: 4096 to avoid runaway outputs) */
+    maxTokens?: number;
+    /** Custom fetch — e.g. to inject a dynamic Authorization header for a proxy. */
+    fetchImpl?: typeof fetch;
+    /** Disable SSE streaming: generateStream delegates to one generate() call.
+     *  For proxies (the Trenchwork Lambda) that reject `stream: true`. */
+    disableStreaming?: boolean;
+}
+export declare class OpenAIChatCompletionsProvider implements LLMProvider {
+    readonly id: ProviderId;
+    readonly model: string;
+    private readonly client;
+    private readonly maxRetries;
+    private readonly temperature?;
+    private readonly maxTokens;
+    private readonly disableStreaming;
+    private readonly requestCount;
+    private readonly lastRequestTime;
+    constructor(options: OpenAIChatCompletionsOptions);
+    /**
+     * Sleep for a given number of milliseconds
+     */
+    private sleep;
+    /**
+     * Calculate exponential backoff delay
+     */
+    private getBackoffDelay;
+    /**
+     * Execute request with retry logic for transient errors
+     */
+    private executeWithRetry;
+    generate(messages: ConversationMessage[], tools: ProviderToolDefinition[]): Promise<ProviderResponse>;
+    generateStream(messages: ConversationMessage[], tools: ProviderToolDefinition[]): AsyncIterableIterator<StreamChunk>;
+    private cachedModelInfo;
+    /**
+     * Fetch model info from OpenAI API
+     * Returns context window and token limits from the real API
+     */
+    getModelInfo(): Promise<ProviderModelInfo | null>;
+}
+export {};
+//# sourceMappingURL=openaiChatCompletionsProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openaiChatCompletionsProvider.d.ts","sourceRoot":"","sources":["../../src/providers/openaiChatCompletionsProvider.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EAGtB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAK1B;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EACvC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,CAAC,CAuBH;AAuGD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,WAAW,UAAO;CAa3F;AAqHD,UAAU,4BAA4B;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;0EACsE;IACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAID,qBAAa,6BAA8B,YAAW,WAAW;IAC/D,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;gBAE1C,OAAO,EAAE,4BAA4B;IA0DjD;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;YACW,gBAAgB;IAsCxB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6GpG,cAAc,CACnB,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,KAAK,EAAE,sBAAsB,EAAE,GAC9B,qBAAqB,CAAC,WAAW,CAAC;IAsJrC,OAAO,CAAC,eAAe,CAAkC;IAEzD;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;CA6CxD"}