ai.matey.middleware 0.2.0

package/dist/types/opentelemetry.d.ts

@@ -0,0 +1,219 @@
+/**
+ * OpenTelemetry Middleware
+ *
+ * Provides distributed tracing and metrics export using OpenTelemetry.
+ * OpenTelemetry packages are optional peer dependencies - this middleware
+ * will check for their availability at runtime.
+ *
+ * @module
+ */
+import type { Middleware, TelemetrySink } from 'ai.matey.types';
+/**
+ * Batch span processor configuration.
+ */
+export interface BatchSpanProcessorConfig {
+    /**
+     * Maximum queue size for buffering spans.
+     * @default 2048
+     */
+    maxQueueSize?: number;
+    /**
+     * Maximum batch size per export.
+     * @default 512
+     */
+    maxExportBatchSize?: number;
+    /**
+     * Scheduled delay (in milliseconds) for batching.
+     * @default 5000
+     */
+    scheduledDelayMillis?: number;
+    /**
+     * Export timeout (in milliseconds).
+     * @default 30000
+     */
+    exportTimeoutMillis?: number;
+}
+/**
+ * Configuration for OpenTelemetry middleware.
+ */
+export interface OpenTelemetryConfig {
+    /**
+     * Service name for OpenTelemetry.
+     * @default 'ai-matey'
+     */
+    serviceName?: string;
+    /**
+     * Service version for OpenTelemetry.
+     * @default '0.1.0'
+     */
+    serviceVersion?: string;
+    /**
+     * OTLP endpoint URL.
+     * @default 'http://localhost:4318/v1/traces'
+     */
+    endpoint?: string;
+    /**
+     * Custom headers for OTLP export.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Sampling rate (0.0 to 1.0).
+     * @default 1.0 (100%)
+     */
+    samplingRate?: number;
+    /**
+     * Custom resource attributes.
+     */
+    resourceAttributes?: Record<string, string>;
+    /**
+     * Whether to export spans.
+     * @default true
+     */
+    exportSpans?: boolean;
+    /**
+     * Custom tracer name.
+     * @default 'ai-matey-tracer'
+     */
+    tracerName?: string;
+    /**
+     * Batch span processor configuration.
+     */
+    batchSpanProcessorConfig?: BatchSpanProcessorConfig;
+    /**
+     * OTLP exporter timeout (in milliseconds).
+     * @default 10000
+     */
+    exporterTimeoutMillis?: number;
+}
+/**
+ * OpenTelemetry span attribute names.
+ */
+export declare const OpenTelemetryAttributes: {
+    readonly REQUEST_ID: "ai.request.id";
+    readonly REQUEST_MODEL: "ai.request.model";
+    readonly REQUEST_STREAM: "ai.request.stream";
+    readonly REQUEST_MESSAGE_COUNT: "ai.request.message_count";
+    readonly REQUEST_MAX_TOKENS: "ai.request.max_tokens";
+    readonly RESPONSE_BACKEND: "ai.response.backend";
+    readonly RESPONSE_FINISH_REASON: "ai.response.finish_reason";
+    readonly RESPONSE_MODEL: "ai.response.model";
+    readonly TOKENS_PROMPT: "ai.tokens.prompt";
+    readonly TOKENS_COMPLETION: "ai.tokens.completion";
+    readonly TOKENS_TOTAL: "ai.tokens.total";
+    readonly FRONTEND: "ai.frontend";
+    readonly BACKEND: "ai.backend";
+    readonly DURATION_MS: "ai.duration.ms";
+};
+/**
+ * Create OpenTelemetry middleware.
+ *
+ * Provides distributed tracing with span creation, context propagation,
+ * and metrics export via OpenTelemetry.
+ *
+ * **Note:** This middleware requires optional OpenTelemetry packages to be installed:
+ * - `@opentelemetry/api`
+ * - `@opentelemetry/sdk-trace-base`
+ * - `@opentelemetry/exporter-trace-otlp-http`
+ * - `@opentelemetry/resources`
+ * - `@opentelemetry/semantic-conventions`
+ *
+ * Install with:
+ * ```bash
+ * npm install @opentelemetry/api @opentelemetry/sdk-trace-base \
+ *   @opentelemetry/exporter-trace-otlp-http @opentelemetry/resources \
+ *   @opentelemetry/semantic-conventions
+ * ```
+ *
+ * @param config OpenTelemetry configuration
+ * @returns Promise that resolves to OpenTelemetry middleware
+ * @throws Error if OpenTelemetry packages are not installed
+ *
+ * @example
+ * ```typescript
+ * import { createOpenTelemetryMiddleware } from 'ai.matey.middleware';
+ *
+ * const otel = await createOpenTelemetryMiddleware({
+ *   serviceName: 'my-ai-service',
+ *   endpoint: 'http://localhost:4318/v1/traces',
+ *   samplingRate: 1.0
+ * });
+ *
+ * bridge.use(otel);
+ * ```
+ */
+export declare function createOpenTelemetryMiddleware(config?: OpenTelemetryConfig): Promise<Middleware>;
+/**
+ * OpenTelemetry-based telemetry sink.
+ *
+ * Implements the TelemetrySink interface using OpenTelemetry metrics.
+ * This allows you to use the existing telemetry middleware with OpenTelemetry.
+ *
+ * **Note:** Currently uses spans for metrics as the OpenTelemetry metrics API
+ * is still evolving. Consider using createOpenTelemetryMiddleware for full
+ * tracing support.
+ */
+export declare class OpenTelemetryTelemetrySink implements TelemetrySink {
+    private tracer;
+    private constructor();
+    /**
+     * Create a new OpenTelemetryTelemetrySink instance.
+     *
+     * @param config OpenTelemetry configuration
+     * @returns Promise that resolves to a new sink instance
+     * @throws Error if OpenTelemetry packages are not installed
+     */
+    static create(config?: OpenTelemetryConfig): Promise<OpenTelemetryTelemetrySink>;
+    recordMetric(name: string, value: number, tags?: Record<string, string>): void;
+    recordEvent(name: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Check if OpenTelemetry packages are installed and available.
+ *
+ * @returns Promise that resolves to true if OpenTelemetry is available
+ *
+ * @example
+ * ```typescript
+ * import { isOpenTelemetryAvailable } from 'ai.matey.middleware';
+ *
+ * if (await isOpenTelemetryAvailable()) {
+ *   console.log('OpenTelemetry is available!');
+ * } else {
+ *   console.log('OpenTelemetry packages not installed.');
+ * }
+ * ```
+ */
+export declare function isOpenTelemetryAvailable(): Promise<boolean>;
+/**
+ * Synchronously check if OpenTelemetry is already loaded.
+ * Use isOpenTelemetryAvailable() for async check with dynamic import.
+ *
+ * @returns True if OpenTelemetry is already loaded
+ *
+ * @example
+ * ```typescript
+ * import { isOpenTelemetryLoaded } from 'ai.matey.middleware';
+ *
+ * if (isOpenTelemetryLoaded()) {
+ *   console.log('OpenTelemetry is already loaded!');
+ * }
+ * ```
+ */
+export declare function isOpenTelemetryLoaded(): boolean;
+/**
+ * Force shutdown of the global tracer provider.
+ * Useful for graceful shutdown in server applications.
+ *
+ * @returns Promise that resolves when shutdown is complete
+ *
+ * @example
+ * ```typescript
+ * import { shutdownOpenTelemetry } from 'ai.matey.middleware';
+ *
+ * process.on('SIGTERM', async () => {
+ *   await shutdownOpenTelemetry();
+ *   process.exit(0);
+ * });
+ * ```
+ */
+export declare function shutdownOpenTelemetry(): Promise<void>;
+//# sourceMappingURL=opentelemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../../src/opentelemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAqC,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAkEnG;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5C;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IAEpD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;CAwB1B,CAAC;AAuHX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,UAAU,CAAC,CAyIrB;AAMD;;;;;;;;;GASG;AACH,qBAAa,0BAA2B,YAAW,aAAa;IAC9D,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO;IAIP;;;;;;OAMG;WACU,MAAM,CAAC,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAqB1F,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAY9E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CA0BhE;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEjE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO3D"}

package/dist/types/retry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Retry Middleware
+ *
+ * Retries failed requests with exponential backoff.
+ *
+ * @module
+ */
+import type { Middleware } from 'ai.matey.types';
+/**
+ * Configuration for retry middleware.
+ */
+export interface RetryConfig {
+    /**
+     * Maximum number of retry attempts.
+     * @default 3
+     */
+    maxAttempts?: number;
+    /**
+     * Initial delay before first retry (milliseconds).
+     * @default 1000
+     */
+    initialDelay?: number;
+    /**
+     * Backoff multiplier for exponential backoff.
+     * @default 2
+     */
+    backoffMultiplier?: number;
+    /**
+     * Maximum delay between retries (milliseconds).
+     * @default 30000 (30 seconds)
+     */
+    maxDelay?: number;
+    /**
+     * Whether to add jitter to retry delays.
+     * @default true
+     */
+    useJitter?: boolean;
+    /**
+     * Custom function to determine if error is retryable.
+     * @default Check error.isRetryable property
+     */
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+    /**
+     * Callback invoked before each retry.
+     */
+    onRetry?: (error: unknown, attempt: number, delay: number) => void;
+}
+/**
+ * Create retry middleware.
+ *
+ * Retries failed requests with exponential backoff.
+ *
+ * @param config Retry configuration
+ * @returns Retry middleware
+ *
+ * @example
+ * ```typescript
+ * const retry = createRetryMiddleware({
+ *   maxAttempts: 3,
+ *   initialDelay: 1000,
+ *   backoffMultiplier: 2,
+ *   maxDelay: 30000
+ * });
+ *
+ * bridge.use(retry);
+ * ```
+ */
+export declare function createRetryMiddleware(config?: RetryConfig): Middleware;
+/**
+ * Check if an error is a rate limit error.
+ */
+export declare function isRateLimitError(error: unknown): boolean;
+/**
+ * Check if an error is a network error.
+ */
+export declare function isNetworkError(error: unknown): boolean;
+/**
+ * Check if an error is a server error (5xx).
+ */
+export declare function isServerError(error: unknown): boolean;
+/**
+ * Create a retry predicate that only retries specific error types.
+ * Note: maxAttempts is enforced by the middleware loop, not this function.
+ */
+export declare function createRetryPredicate(errorTypes: Array<'rate_limit' | 'network' | 'server'>): (error: unknown, attempt: number) => boolean;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/retry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAqC,MAAM,gBAAgB,CAAC;AAQpF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAE3D;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AA8DD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,WAAgB,GAAG,UAAU,CA2F1E;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMrD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,KAAK,CAAC,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC,GACrD,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAwB9C"}

package/dist/types/security.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Security Middleware
+ *
+ * Adds security headers and implements security best practices for HTTP responses.
+ *
+ * @module
+ */
+import type { Middleware } from 'ai.matey.types';
+/**
+ * Security headers configuration
+ */
+export interface SecurityConfig {
+    /**
+     * Content Security Policy
+     * @default "default-src 'self'"
+     */
+    contentSecurityPolicy?: string | false;
+    /**
+     * X-Content-Type-Options header
+     * @default "nosniff"
+     */
+    contentTypeOptions?: string | false;
+    /**
+     * X-Frame-Options header
+     * @default "DENY"
+     */
+    frameOptions?: 'DENY' | 'SAMEORIGIN' | false;
+    /**
+     * X-XSS-Protection header
+     * @default "1; mode=block"
+     */
+    xssProtection?: string | false;
+    /**
+     * Strict-Transport-Security header
+     * @default "max-age=31536000; includeSubDomains"
+     */
+    hsts?: string | false;
+    /**
+     * Referrer-Policy header
+     * @default "strict-origin-when-cross-origin"
+     */
+    referrerPolicy?: 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url' | false;
+    /**
+     * Permissions-Policy header
+     * @default "geolocation=(), microphone=(), camera=()"
+     */
+    permissionsPolicy?: string | false;
+    /**
+     * X-Powered-By header (should be removed for security)
+     * @default false (header removed)
+     */
+    poweredBy?: string | false;
+    /**
+     * Additional custom headers
+     */
+    customHeaders?: Record<string, string>;
+}
+/**
+ * Default security configuration
+ */
+export declare const DEFAULT_SECURITY_CONFIG: Required<Omit<SecurityConfig, 'customHeaders'>>;
+/**
+ * Create security headers middleware
+ *
+ * Adds security headers to responses to protect against common vulnerabilities.
+ *
+ * @param config - Security configuration
+ * @returns Middleware function
+ *
+ * @example
+ * ```typescript
+ * import { createSecurityMiddleware } from 'ai.matey';
+ *
+ * const security = createSecurityMiddleware({
+ *   contentSecurityPolicy: "default-src 'self'",
+ *   hsts: 'max-age=31536000',
+ * });
+ *
+ * bridge.use(security);
+ * ```
+ *
+ * @example Production Configuration
+ * ```typescript
+ * const productionSecurity = createSecurityMiddleware({
+ *   contentSecurityPolicy: "default-src 'self'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'",
+ *   frameOptions: 'DENY',
+ *   hsts: 'max-age=31536000; includeSubDomains; preload',
+ *   referrerPolicy: 'strict-origin-when-cross-origin',
+ *   permissionsPolicy: 'geolocation=(), microphone=(), camera=(), payment=()',
+ * });
+ * ```
+ */
+export declare function createSecurityMiddleware(config?: SecurityConfig): Middleware;
+/**
+ * Create production-ready security middleware with strict settings
+ *
+ * @returns Middleware with production security settings
+ *
+ * @example
+ * ```typescript
+ * import { createProductionSecurityMiddleware } from 'ai.matey';
+ *
+ * bridge.use(createProductionSecurityMiddleware());
+ * ```
+ */
+export declare function createProductionSecurityMiddleware(): Middleware;
+/**
+ * Create development-friendly security middleware with relaxed settings
+ *
+ * @returns Middleware with development security settings
+ *
+ * @example
+ * ```typescript
+ * import { createDevelopmentSecurityMiddleware } from 'ai.matey';
+ *
+ * bridge.use(createDevelopmentSecurityMiddleware());
+ * ```
+ */
+export declare function createDevelopmentSecurityMiddleware(): Middleware;
+//# sourceMappingURL=security.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/security.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAEvC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAEpC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,CAAC;IAE7C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE/B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EACX,aAAa,GACb,4BAA4B,GAC5B,QAAQ,GACR,0BAA0B,GAC1B,aAAa,GACb,eAAe,GACf,iCAAiC,GACjC,YAAY,GACZ,KAAK,CAAC;IAEV;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAEnC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CASnF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,cAAmB,GAAG,UAAU,CAgFhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kCAAkC,IAAI,UAAU,CAY/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,IAAI,UAAU,CAWhE"}

package/dist/types/telemetry.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Telemetry Middleware
+ *
+ * Tracks metrics, events, and performance data for requests and responses.
+ *
+ * @module
+ */
+import type { Middleware, TelemetrySink } from 'ai.matey.types';
+/**
+ * Configuration for telemetry middleware.
+ */
+export interface TelemetryConfig {
+    /**
+     * Telemetry sink for sending metrics.
+     */
+    sink: TelemetrySink;
+    /**
+     * Whether to track request counts.
+     * @default true
+     */
+    trackCounts?: boolean;
+    /**
+     * Whether to track latencies.
+     * @default true
+     */
+    trackLatencies?: boolean;
+    /**
+     * Whether to track errors.
+     * @default true
+     */
+    trackErrors?: boolean;
+    /**
+     * Whether to track token usage.
+     * @default true
+     */
+    trackTokens?: boolean;
+    /**
+     * Custom tags to add to all metrics.
+     */
+    tags?: Record<string, string>;
+    /**
+     * Sample rate (0.0 to 1.0).
+     * @default 1.0 (100%)
+     */
+    sampleRate?: number;
+}
+/**
+ * Metric names.
+ */
+export declare const MetricNames: {
+    readonly REQUEST_COUNT: "ai.adapter.request.count";
+    readonly REQUEST_DURATION: "ai.adapter.request.duration";
+    readonly REQUEST_ERROR: "ai.adapter.request.error";
+    readonly TOKEN_PROMPT: "ai.adapter.tokens.prompt";
+    readonly TOKEN_COMPLETION: "ai.adapter.tokens.completion";
+    readonly TOKEN_TOTAL: "ai.adapter.tokens.total";
+};
+/**
+ * Event names.
+ */
+export declare const EventNames: {
+    readonly REQUEST_START: "ai.adapter.request.start";
+    readonly REQUEST_COMPLETE: "ai.adapter.request.complete";
+    readonly REQUEST_ERROR: "ai.adapter.request.error";
+};
+/**
+ * Create telemetry middleware.
+ *
+ * Tracks metrics and events for monitoring and observability.
+ *
+ * @param config Telemetry configuration
+ * @returns Telemetry middleware
+ *
+ * @example
+ * ```typescript
+ * const telemetry = createTelemetryMiddleware({
+ *   sink: {
+ *     recordMetric: (name, value, tags) => {
+ *       console.log(`Metric: ${name} = ${value}`, tags);
+ *     },
+ *     recordEvent: (name, data) => {
+ *       console.log(`Event: ${name}`, data);
+ *     }
+ *   },
+ *   trackCounts: true,
+ *   trackLatencies: true,
+ *   trackTokens: true
+ * });
+ *
+ * bridge.use(telemetry);
+ * ```
+ */
+export declare function createTelemetryMiddleware(config: TelemetryConfig): Middleware;
+/**
+ * Console telemetry sink for development/debugging.
+ */
+export declare class ConsoleTelemetrySink implements TelemetrySink {
+    recordMetric(name: string, value: number, tags?: Record<string, string>): void;
+    recordEvent(name: string, data?: Record<string, unknown>): void;
+}
+/**
+ * In-memory telemetry sink for testing.
+ */
+export declare class InMemoryTelemetrySink implements TelemetrySink {
+    private metrics;
+    private events;
+    recordMetric(name: string, value: number, tags?: Record<string, string>): void;
+    recordEvent(name: string, data?: Record<string, unknown>): void;
+    getMetrics(): Array<{
+        name: string;
+        value: number;
+        tags?: Record<string, string>;
+    }>;
+    getEvents(): Array<{
+        name: string;
+        data?: Record<string, unknown>;
+    }>;
+    clear(): void;
+}
+//# sourceMappingURL=telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAqC,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAOnG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAiBX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU,CAuI7E;AAMD;;GAEG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI9E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGhE;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,OAAO,CAA6E;IAC5F,OAAO,CAAC,MAAM,CAA+D;IAE7E,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI9E,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,UAAU,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IAInF,SAAS,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAIpE,KAAK,IAAI,IAAI;CAId"}