ai.matey.types 0.2.0

package/dist/types/bridge.d.ts

@@ -0,0 +1,290 @@
+/**
+ * Bridge Types and Interfaces
+ *
+ * The Bridge is the primary developer-facing API for the Universal AI Adapter System.
+ * It connects a frontend adapter to one or more backend adapters, with embedded
+ * router and middleware stack for orchestration and cross-cutting concerns.
+ *
+ * @module
+ */
+import type { FrontendAdapter, BackendAdapter, InferFrontendRequest, InferFrontendResponse, InferFrontendStreamChunk } from './adapters.js';
+import type { Router, RouterConfig } from './router.js';
+import type { Middleware } from './middleware.js';
+import type { IRChatRequest, IRChatResponse } from './ir.js';
+/**
+ * Configuration options for Bridge.
+ */
+export interface BridgeConfig {
+    /**
+     * Enable debug mode with detailed logging.
+     * @default false
+     */
+    readonly debug?: boolean;
+    /**
+     * Global timeout for requests in milliseconds.
+     * @default 30000
+     */
+    readonly timeout?: number;
+    /**
+     * Maximum retries for transient failures.
+     * @default 0
+     */
+    readonly retries?: number;
+    /**
+     * Default model to use if not specified in request.
+     */
+    readonly defaultModel?: string;
+    /**
+     * Router configuration (if using router as backend).
+     */
+    readonly routerConfig?: Partial<RouterConfig>;
+    /**
+     * Automatically add request ID to metadata if not present.
+     * @default true
+     */
+    readonly autoRequestId?: boolean;
+    /**
+     * Custom configuration options.
+     */
+    readonly custom?: Record<string, unknown>;
+}
+/**
+ * Per-request options for overriding defaults.
+ */
+export interface RequestOptions {
+    /**
+     * Request timeout in milliseconds.
+     */
+    readonly timeout?: number;
+    /**
+     * AbortSignal for request cancellation.
+     */
+    readonly signal?: AbortSignal;
+    /**
+     * Preferred backend identifier (for router).
+     */
+    readonly backend?: string;
+    /**
+     * Additional metadata to attach to request.
+     */
+    readonly metadata?: Record<string, unknown>;
+    /**
+     * Skip middleware execution for this request.
+     * @default false
+     */
+    readonly skipMiddleware?: boolean;
+    /**
+     * Custom request options.
+     */
+    readonly custom?: Record<string, unknown>;
+}
+/**
+ * Event types emitted by Bridge.
+ */
+export declare const BridgeEventType: {
+    readonly REQUEST_START: "request:start";
+    readonly REQUEST_SUCCESS: "request:success";
+    readonly REQUEST_ERROR: "request:error";
+    readonly REQUEST_CANCELLED: "request:cancelled";
+    readonly STREAM_START: "stream:start";
+    readonly STREAM_CHUNK: "stream:chunk";
+    readonly STREAM_COMPLETE: "stream:complete";
+    readonly STREAM_ERROR: "stream:error";
+    readonly BACKEND_SELECTED: "backend:selected";
+    readonly BACKEND_FAILOVER: "backend:failover";
+    readonly MIDDLEWARE_EXECUTED: "middleware:executed";
+};
+export type BridgeEventType = (typeof BridgeEventType)[keyof typeof BridgeEventType];
+/**
+ * Base event interface.
+ */
+export interface BridgeEvent {
+    readonly type: BridgeEventType;
+    readonly timestamp: number;
+    readonly requestId?: string;
+}
+/**
+ * Request event with request details.
+ */
+export interface RequestEvent extends BridgeEvent {
+    readonly type: typeof BridgeEventType.REQUEST_START | typeof BridgeEventType.REQUEST_SUCCESS | typeof BridgeEventType.REQUEST_ERROR | typeof BridgeEventType.REQUEST_CANCELLED;
+    readonly request: IRChatRequest;
+    readonly response?: IRChatResponse;
+    readonly error?: Error;
+    readonly durationMs?: number;
+}
+/**
+ * Stream event with stream details.
+ */
+export interface StreamEvent extends BridgeEvent {
+    readonly type: typeof BridgeEventType.STREAM_START | typeof BridgeEventType.STREAM_CHUNK | typeof BridgeEventType.STREAM_COMPLETE | typeof BridgeEventType.STREAM_ERROR;
+    readonly request: IRChatRequest;
+    readonly chunkSequence?: number;
+    readonly error?: Error;
+    readonly durationMs?: number;
+}
+/**
+ * Backend event with backend details.
+ */
+export interface BackendEvent extends BridgeEvent {
+    readonly type: typeof BridgeEventType.BACKEND_SELECTED | typeof BridgeEventType.BACKEND_FAILOVER;
+    readonly backend: string;
+    readonly previousBackend?: string;
+    readonly reason?: string;
+}
+/**
+ * Middleware event with middleware details.
+ */
+export interface MiddlewareEvent extends BridgeEvent {
+    readonly type: typeof BridgeEventType.MIDDLEWARE_EXECUTED;
+    readonly middlewareName: string;
+    readonly durationMs: number;
+    readonly phase: 'request' | 'response';
+}
+/**
+ * Union of all event types.
+ */
+export type BridgeEventData = RequestEvent | StreamEvent | BackendEvent | MiddlewareEvent;
+/**
+ * Event listener function.
+ */
+export type BridgeEventListener = (event: BridgeEventData) => void | Promise<void>;
+/**
+ * Runtime statistics collected by Bridge.
+ */
+export interface BridgeStats {
+    /**
+     * Total requests processed.
+     */
+    readonly totalRequests: number;
+    /**
+     * Successful requests.
+     */
+    readonly successfulRequests: number;
+    /**
+     * Failed requests.
+     */
+    readonly failedRequests: number;
+    /**
+     * Success rate (0-100).
+     */
+    readonly successRate: number;
+    /**
+     * Total streaming requests.
+     */
+    readonly streamingRequests: number;
+    /**
+     * Average request latency in milliseconds.
+     */
+    readonly averageLatencyMs: number;
+    /**
+     * P50 latency in milliseconds.
+     */
+    readonly p50LatencyMs: number;
+    /**
+     * P95 latency in milliseconds.
+     */
+    readonly p95LatencyMs: number;
+    /**
+     * P99 latency in milliseconds.
+     */
+    readonly p99LatencyMs: number;
+    /**
+     * Backend usage breakdown (backend name → request count).
+     */
+    readonly backendUsage: Record<string, number>;
+    /**
+     * Error breakdown (error code → count).
+     */
+    readonly errorBreakdown: Record<string, number>;
+    /**
+     * When statistics were last reset.
+     */
+    readonly sinceTimestamp: number;
+}
+/**
+ * The Bridge connects frontend and backend adapters with routing and middleware.
+ *
+ * @template TFrontend Frontend adapter type
+ */
+export interface Bridge<TFrontend extends FrontendAdapter = FrontendAdapter> {
+    /**
+     * Frontend adapter for this bridge.
+     */
+    readonly frontend: TFrontend;
+    /**
+     * Backend adapter or router.
+     */
+    readonly backend: BackendAdapter | Router;
+    /**
+     * Bridge configuration.
+     */
+    readonly config: BridgeConfig;
+    /**
+     * Execute a non-streaming chat completion request.
+     */
+    chat(request: InferFrontendRequest<TFrontend>, options?: RequestOptions): Promise<InferFrontendResponse<TFrontend>>;
+    /**
+     * Execute a streaming chat completion request.
+     */
+    chatStream(request: InferFrontendRequest<TFrontend>, options?: RequestOptions): AsyncGenerator<InferFrontendStreamChunk<TFrontend>, void, undefined>;
+    /**
+     * Add middleware to the bridge's middleware stack.
+     */
+    use(middleware: Middleware): Bridge<TFrontend>;
+    /**
+     * Remove middleware from the stack.
+     */
+    removeMiddleware(middleware: Middleware): Bridge<TFrontend>;
+    /**
+     * Clear all middleware from the stack.
+     */
+    clearMiddleware(): Bridge<TFrontend>;
+    /**
+     * Get all middleware in the stack.
+     */
+    getMiddleware(): readonly Middleware[];
+    /**
+     * Register event listener.
+     */
+    on(event: BridgeEventType | '*', listener: BridgeEventListener): Bridge<TFrontend>;
+    /**
+     * Unregister event listener.
+     */
+    off(event: BridgeEventType | '*', listener: BridgeEventListener): Bridge<TFrontend>;
+    /**
+     * Register one-time event listener.
+     */
+    once(event: BridgeEventType, listener: BridgeEventListener): Bridge<TFrontend>;
+    /**
+     * Get runtime statistics.
+     */
+    getStats(): BridgeStats;
+    /**
+     * Reset statistics.
+     */
+    resetStats(): void;
+    /**
+     * Get router instance (if backend is a router).
+     */
+    getRouter(): Router | null;
+    /**
+     * Clone bridge with new configuration.
+     */
+    clone(config: Partial<BridgeConfig>): Bridge<TFrontend>;
+    /**
+     * Clean up resources.
+     */
+    dispose(): void;
+}
+/**
+ * Bridge builder for fluent API.
+ */
+export interface BridgeBuilder<TFrontend extends FrontendAdapter = FrontendAdapter> {
+    withFrontend<T extends FrontendAdapter>(frontend: T): BridgeBuilder<T>;
+    withBackend(backend: BackendAdapter | Router): BridgeBuilder<TFrontend>;
+    withConfig(config: Partial<BridgeConfig>): BridgeBuilder<TFrontend>;
+    withMiddleware(middleware: Middleware): BridgeBuilder<TFrontend>;
+    build(): Bridge<TFrontend>;
+}
+//# sourceMappingURL=bridge.d.ts.map

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

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

package/dist/types/errors.d.ts

@@ -0,0 +1,380 @@
+/**
+ * Error Types and Codes
+ *
+ * Normalized error handling across all AI providers. Provider-specific errors
+ * are translated to universal error types with actionable context.
+ *
+ * @module
+ */
+import type { IRChatRequest, IRChatResponse } from './ir.js';
+/**
+ * Universal error codes covering all adapter failure modes.
+ */
+export declare const ErrorCode: {
+    readonly INVALID_API_KEY: "INVALID_API_KEY";
+    readonly MISSING_API_KEY: "MISSING_API_KEY";
+    readonly EXPIRED_API_KEY: "EXPIRED_API_KEY";
+    readonly INSUFFICIENT_PERMISSIONS: "INSUFFICIENT_PERMISSIONS";
+    readonly QUOTA_EXCEEDED: "QUOTA_EXCEEDED";
+    readonly RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED";
+    readonly INVALID_REQUEST: "INVALID_REQUEST";
+    readonly INVALID_MESSAGE_FORMAT: "INVALID_MESSAGE_FORMAT";
+    readonly INVALID_PARAMETERS: "INVALID_PARAMETERS";
+    readonly UNSUPPORTED_MODEL: "UNSUPPORTED_MODEL";
+    readonly UNSUPPORTED_FEATURE: "UNSUPPORTED_FEATURE";
+    readonly CONTEXT_LENGTH_EXCEEDED: "CONTEXT_LENGTH_EXCEEDED";
+    readonly PROVIDER_ERROR: "PROVIDER_ERROR";
+    readonly PROVIDER_UNAVAILABLE: "PROVIDER_UNAVAILABLE";
+    readonly PROVIDER_TIMEOUT: "PROVIDER_TIMEOUT";
+    readonly PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED";
+    readonly ADAPTER_CONVERSION_ERROR: "ADAPTER_CONVERSION_ERROR";
+    readonly ADAPTER_VALIDATION_ERROR: "ADAPTER_VALIDATION_ERROR";
+    readonly UNSUPPORTED_CONVERSION: "UNSUPPORTED_CONVERSION";
+    readonly SEMANTIC_DRIFT_ERROR: "SEMANTIC_DRIFT_ERROR";
+    readonly NETWORK_ERROR: "NETWORK_ERROR";
+    readonly CONNECTION_TIMEOUT: "CONNECTION_TIMEOUT";
+    readonly DNS_RESOLUTION_FAILED: "DNS_RESOLUTION_FAILED";
+    readonly STREAM_ERROR: "STREAM_ERROR";
+    readonly STREAM_INTERRUPTED: "STREAM_INTERRUPTED";
+    readonly STREAM_PARSE_ERROR: "STREAM_PARSE_ERROR";
+    readonly STREAM_CANCELLED: "STREAM_CANCELLED";
+    readonly NO_BACKEND_AVAILABLE: "NO_BACKEND_AVAILABLE";
+    readonly ROUTING_FAILED: "ROUTING_FAILED";
+    readonly ALL_BACKENDS_FAILED: "ALL_BACKENDS_FAILED";
+    readonly MIDDLEWARE_ERROR: "MIDDLEWARE_ERROR";
+    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+export type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Groups error codes into categories for easier handling.
+ */
+export declare const ErrorCategory: {
+    readonly AUTHENTICATION: "authentication";
+    readonly AUTHORIZATION: "authorization";
+    readonly RATE_LIMIT: "rate_limit";
+    readonly VALIDATION: "validation";
+    readonly PROVIDER: "provider";
+    readonly ADAPTER: "adapter";
+    readonly NETWORK: "network";
+    readonly STREAMING: "streaming";
+    readonly ROUTING: "routing";
+    readonly MIDDLEWARE: "middleware";
+    readonly UNKNOWN: "unknown";
+};
+export type ErrorCategory = (typeof ErrorCategory)[keyof typeof ErrorCategory];
+/**
+ * Maps error codes to their categories.
+ */
+export declare const ERROR_CODE_CATEGORIES: Record<ErrorCode, ErrorCategory>;
+/**
+ * Context about where an error occurred in the adapter chain.
+ */
+export interface ErrorProvenance {
+    /**
+     * Frontend adapter that initiated the request.
+     */
+    readonly frontend?: string;
+    /**
+     * Backend adapter that was processing the request.
+     */
+    readonly backend?: string;
+    /**
+     * Middleware layer where error occurred (if applicable).
+     */
+    readonly middleware?: string;
+    /**
+     * Router that was handling the request (if applicable).
+     */
+    readonly router?: string;
+}
+/**
+ * HTTP status code and additional HTTP context.
+ */
+export interface HttpErrorContext {
+    readonly statusCode: number;
+    readonly statusText?: string;
+    readonly headers?: Record<string, string>;
+    readonly responseBody?: unknown;
+}
+/**
+ * Provider-specific error information.
+ */
+export interface ProviderErrorDetails {
+    /**
+     * Original error code from provider.
+     */
+    readonly providerCode?: string;
+    /**
+     * Original error message from provider.
+     */
+    readonly providerMessage?: string;
+    /**
+     * Provider name (openai, anthropic, gemini, etc.).
+     */
+    readonly provider: string;
+    /**
+     * Provider-specific error data.
+     */
+    readonly providerData?: Record<string, unknown>;
+}
+/**
+ * Validation error details.
+ */
+export interface ValidationErrorDetails {
+    /**
+     * Field or parameter that failed validation.
+     */
+    readonly field: string;
+    /**
+     * Value that failed validation.
+     */
+    readonly value: unknown;
+    /**
+     * Why validation failed.
+     */
+    readonly reason: string;
+    /**
+     * Expected format or constraint.
+     */
+    readonly expected?: string;
+}
+/**
+ * Rate limit error details.
+ */
+export interface RateLimitErrorDetails {
+    /**
+     * Time until rate limit resets (milliseconds).
+     */
+    readonly retryAfter?: number;
+    /**
+     * Rate limit ceiling (requests per period).
+     */
+    readonly limit?: number;
+    /**
+     * Remaining requests in current period.
+     */
+    readonly remaining?: number;
+    /**
+     * When limit resets (ISO timestamp).
+     */
+    readonly resetAt?: string;
+}
+/**
+ * Base error constructor options.
+ */
+export interface BaseErrorOptions {
+    readonly code: ErrorCode;
+    readonly message: string;
+    readonly isRetryable?: boolean;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+    readonly irState?: {
+        readonly request?: Partial<IRChatRequest>;
+        readonly response?: Partial<IRChatResponse>;
+    };
+    readonly details?: Record<string, unknown>;
+}
+/**
+ * Authentication error constructor options.
+ */
+export interface AuthenticationErrorOptions {
+    readonly code: typeof ErrorCode.INVALID_API_KEY | typeof ErrorCode.MISSING_API_KEY | typeof ErrorCode.EXPIRED_API_KEY;
+    readonly message: string;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+}
+/**
+ * Authorization error constructor options.
+ */
+export interface AuthorizationErrorOptions {
+    readonly code: typeof ErrorCode.INSUFFICIENT_PERMISSIONS | typeof ErrorCode.QUOTA_EXCEEDED;
+    readonly message: string;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+}
+/**
+ * Rate limit error constructor options.
+ */
+export interface RateLimitErrorOptions {
+    readonly message: string;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+    readonly rateLimitDetails?: RateLimitErrorDetails;
+}
+/**
+ * Validation error constructor options.
+ */
+export interface ValidationErrorOptions {
+    readonly code: typeof ErrorCode.INVALID_REQUEST | typeof ErrorCode.INVALID_MESSAGE_FORMAT | typeof ErrorCode.INVALID_PARAMETERS | typeof ErrorCode.UNSUPPORTED_MODEL | typeof ErrorCode.UNSUPPORTED_FEATURE | typeof ErrorCode.CONTEXT_LENGTH_EXCEEDED;
+    readonly message: string;
+    readonly validationDetails: ValidationErrorDetails[];
+    readonly provenance?: ErrorProvenance;
+    readonly irState?: {
+        readonly request?: Partial<IRChatRequest>;
+    };
+}
+/**
+ * Provider error constructor options.
+ */
+export interface ProviderErrorOptions {
+    readonly code: typeof ErrorCode.PROVIDER_ERROR | typeof ErrorCode.PROVIDER_UNAVAILABLE | typeof ErrorCode.PROVIDER_TIMEOUT | typeof ErrorCode.PROVIDER_OVERLOADED;
+    readonly message: string;
+    readonly isRetryable?: boolean;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+    readonly providerDetails?: ProviderErrorDetails;
+    readonly httpContext?: HttpErrorContext;
+    readonly irState?: {
+        readonly request?: Partial<IRChatRequest>;
+        readonly response?: Partial<IRChatResponse>;
+    };
+}
+/**
+ * Adapter conversion error constructor options.
+ */
+export interface AdapterConversionErrorOptions {
+    readonly code: typeof ErrorCode.ADAPTER_CONVERSION_ERROR | typeof ErrorCode.ADAPTER_VALIDATION_ERROR | typeof ErrorCode.UNSUPPORTED_CONVERSION | typeof ErrorCode.SEMANTIC_DRIFT_ERROR;
+    readonly message: string;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+    readonly irState?: {
+        readonly request?: Partial<IRChatRequest>;
+        readonly response?: Partial<IRChatResponse>;
+    };
+}
+/**
+ * Network error constructor options.
+ */
+export interface NetworkErrorOptions {
+    readonly code: typeof ErrorCode.NETWORK_ERROR | typeof ErrorCode.CONNECTION_TIMEOUT | typeof ErrorCode.DNS_RESOLUTION_FAILED;
+    readonly message: string;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+}
+/**
+ * Stream error constructor options.
+ */
+export interface StreamErrorOptions {
+    readonly code: typeof ErrorCode.STREAM_ERROR | typeof ErrorCode.STREAM_INTERRUPTED | typeof ErrorCode.STREAM_PARSE_ERROR | typeof ErrorCode.STREAM_CANCELLED;
+    readonly message: string;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+    readonly irState?: {
+        readonly request?: Partial<IRChatRequest>;
+    };
+}
+/**
+ * Router error constructor options.
+ */
+export interface RouterErrorOptions {
+    readonly code: typeof ErrorCode.NO_BACKEND_AVAILABLE | typeof ErrorCode.ROUTING_FAILED | typeof ErrorCode.ALL_BACKENDS_FAILED;
+    readonly message: string;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+    readonly attemptedBackends?: string[];
+    readonly irState?: {
+        readonly request?: Partial<IRChatRequest>;
+    };
+}
+/**
+ * Middleware error constructor options.
+ */
+export interface MiddlewareErrorOptions {
+    readonly message: string;
+    readonly middlewareName?: string;
+    readonly provenance?: ErrorProvenance;
+    readonly cause?: Error;
+    readonly irState?: {
+        readonly request?: Partial<IRChatRequest>;
+        readonly response?: Partial<IRChatResponse>;
+    };
+}
+/**
+ * Base error class interface.
+ */
+export interface AdapterError extends Error {
+    readonly code: ErrorCode;
+    readonly category: ErrorCategory;
+    readonly isRetryable: boolean;
+    readonly provenance: ErrorProvenance;
+    readonly cause?: Error;
+    readonly irState?: {
+        readonly request?: Partial<IRChatRequest>;
+        readonly response?: Partial<IRChatResponse>;
+    };
+    readonly details?: Record<string, unknown>;
+    readonly timestamp: number;
+    isCategory(category: ErrorCategory): boolean;
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Authentication error interface.
+ */
+export interface AuthenticationError extends AdapterError {
+    readonly name: 'AuthenticationError';
+}
+/**
+ * Authorization error interface.
+ */
+export interface AuthorizationError extends AdapterError {
+    readonly name: 'AuthorizationError';
+}
+/**
+ * Rate limit error interface.
+ */
+export interface RateLimitError extends AdapterError {
+    readonly name: 'RateLimitError';
+    readonly retryAfter?: number;
+    readonly limit?: number;
+    readonly remaining?: number;
+    readonly resetAt?: string;
+}
+/**
+ * Validation error interface.
+ */
+export interface ValidationError extends AdapterError {
+    readonly name: 'ValidationError';
+    readonly validationDetails: ValidationErrorDetails[];
+}
+/**
+ * Provider error interface.
+ */
+export interface ProviderError extends AdapterError {
+    readonly name: 'ProviderError';
+    readonly providerDetails?: ProviderErrorDetails;
+    readonly httpContext?: HttpErrorContext;
+}
+/**
+ * Adapter conversion error interface.
+ */
+export interface AdapterConversionError extends AdapterError {
+    readonly name: 'AdapterConversionError';
+}
+/**
+ * Network error interface.
+ */
+export interface NetworkError extends AdapterError {
+    readonly name: 'NetworkError';
+}
+/**
+ * Stream error interface.
+ */
+export interface StreamError extends AdapterError {
+    readonly name: 'StreamError';
+}
+/**
+ * Router error interface.
+ */
+export interface RouterError extends AdapterError {
+    readonly name: 'RouterError';
+    readonly attemptedBackends?: string[];
+}
+/**
+ * Middleware error interface.
+ */
+export interface MiddlewareError extends AdapterError {
+    readonly name: 'MiddlewareError';
+    readonly middlewareName?: string;
+}
+//# sourceMappingURL=errors.d.ts.map

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

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