ai.matey.middleware 0.2.0

package/dist/types/conversation-history.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Conversation History Middleware
+ *
+ * Manages conversation history across requests with configurable trimming strategies.
+ * Maintains a global conversation history that can be accessed and modified by requests.
+ *
+ * @module
+ */
+import type { Middleware } from 'ai.matey.types';
+import type { IRMessage } from 'ai.matey.types';
+import { type TrimStrategy } from 'ai.matey.utils';
+/**
+ * Configuration for conversation history middleware.
+ */
+export interface ConversationHistoryConfig {
+    /**
+     * Maximum number of message pairs to keep.
+     * - 0: No history (stateless)
+     * - -1: Unlimited history
+     * - N > 0: Keep last N user/assistant pairs
+     * @default -1 (unlimited)
+     */
+    maxHistorySize?: number;
+    /**
+     * Trimming strategy.
+     * - 'fifo': First-in-first-out, remove oldest messages
+     * - 'smart': Preserve system messages, trim user/assistant pairs
+     * @default 'smart'
+     */
+    strategy?: TrimStrategy;
+    /**
+     * Whether to prepend history to each request.
+     * If false, history is maintained but not automatically added to requests.
+     * @default true
+     */
+    prependHistory?: boolean;
+    /**
+     * Whether to append responses to history after each request.
+     * @default true
+     */
+    trackResponses?: boolean;
+    /**
+     * Initial conversation history.
+     * Useful for seeding with system messages or previous conversation.
+     * @default []
+     */
+    initialHistory?: IRMessage[];
+    /**
+     * Custom filter to determine which messages should be added to history.
+     * Return true to include message in history, false to exclude.
+     * @default (msg) => true (include all messages)
+     */
+    messageFilter?: (message: IRMessage) => boolean;
+}
+/**
+ * Conversation history manager for accessing and manipulating history.
+ */
+export interface ConversationHistoryManager {
+    /**
+     * Get the current conversation history.
+     */
+    getHistory(): readonly IRMessage[];
+    /**
+     * Add a message to the history.
+     * @param message Message to add
+     */
+    addMessage(message: IRMessage): void;
+    /**
+     * Add multiple messages to the history.
+     * @param messages Messages to add
+     */
+    addMessages(messages: IRMessage[]): void;
+    /**
+     * Clear the conversation history.
+     */
+    clear(): void;
+    /**
+     * Set the conversation history to a specific state.
+     * @param history New history state
+     */
+    setHistory(history: IRMessage[]): void;
+    /**
+     * Get the number of message pairs in history (excluding system messages).
+     */
+    getPairCount(): number;
+    /**
+     * Manually trigger history trimming based on config.
+     */
+    trim(): void;
+}
+/**
+ * Create conversation history middleware.
+ *
+ * Maintains a global conversation history across requests. Automatically prepends
+ * history to requests and appends responses to history after completion.
+ *
+ * @param config Conversation history configuration
+ * @returns Conversation history middleware and manager
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const { middleware, manager } = createConversationHistoryMiddleware({
+ *   maxHistorySize: 10,
+ *   strategy: 'smart'
+ * });
+ *
+ * bridge.use(middleware);
+ *
+ * // Access history
+ * console.log('Pairs:', manager.getPairCount());
+ * console.log('History:', manager.getHistory());
+ *
+ * // Clear history when needed
+ * manager.clear();
+ * ```
+ *
+ * @example With Initial System Message
+ * ```typescript
+ * const { middleware } = createConversationHistoryMiddleware({
+ *   initialHistory: [
+ *     { role: 'system', content: 'You are a helpful assistant.' }
+ *   ],
+ *   maxHistorySize: 5,
+ *   strategy: 'smart' // Preserves system message
+ * });
+ * ```
+ *
+ * @example Stateless Mode (No History)
+ * ```typescript
+ * const { middleware } = createConversationHistoryMiddleware({
+ *   maxHistorySize: 0 // No history tracking
+ * });
+ * ```
+ *
+ * @example Custom Message Filtering
+ * ```typescript
+ * const { middleware } = createConversationHistoryMiddleware({
+ *   maxHistorySize: 10,
+ *   // Only track user and assistant messages, ignore system
+ *   messageFilter: (msg) => msg.role !== 'system'
+ * });
+ * ```
+ */
+export declare function createConversationHistoryMiddleware(config?: ConversationHistoryConfig): {
+    middleware: Middleware;
+    manager: ConversationHistoryManager;
+};
+/**
+ * Create a simple conversation history middleware with minimal config.
+ *
+ * @param maxHistorySize Maximum number of message pairs to keep
+ * @returns Conversation history middleware
+ *
+ * @example
+ * ```typescript
+ * // Keep last 5 message pairs
+ * bridge.use(simpleConversationHistory(5));
+ * ```
+ */
+export declare function simpleConversationHistory(maxHistorySize?: number): Middleware;
+/**
+ * Create a stateless conversation history middleware.
+ * Useful for explicitly disabling history in a pipeline.
+ *
+ * @returns Stateless middleware
+ *
+ * @example
+ * ```typescript
+ * // Explicitly disable history
+ * bridge.use(statelessConversation());
+ * ```
+ */
+export declare function statelessConversation(): Middleware;
+/**
+ * Create a conversation history middleware that only tracks user/assistant pairs.
+ * System messages from requests are passed through but not tracked.
+ *
+ * @param maxHistorySize Maximum number of message pairs
+ * @returns Conversation history middleware
+ *
+ * @example
+ * ```typescript
+ * // Track conversation but not system messages
+ * bridge.use(conversationOnlyHistory(10));
+ * ```
+ */
+export declare function conversationOnlyHistory(maxHistorySize?: number): Middleware;
+//# sourceMappingURL=conversation-history.d.ts.map

package/dist/types/conversation-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.d.ts","sourceRoot":"","sources":["../../src/conversation-history.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAqC,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAkB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAe,KAAK,YAAY,EAAqB,MAAM,gBAAgB,CAAC;AAMnF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IAExB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC;IAE7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,UAAU,IAAI,SAAS,SAAS,EAAE,CAAC;IAEnC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAEvC;;OAEG;IACH,YAAY,IAAI,MAAM,CAAC;IAEvB;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;CACd;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,mCAAmC,CAAC,MAAM,GAAE,yBAA8B,GAAG;IAC3F,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,0BAA0B,CAAC;CACrC,CA0HA;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,GAAE,MAAW,GAAG,UAAU,CAGjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,CAGlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,GAAE,MAAW,GAAG,UAAU,CAO/E"}

package/dist/types/cost-tracking.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Cost Tracking Middleware
+ *
+ * Track and monitor API costs across different providers.
+ * Essential for production deployments to control spending.
+ *
+ * @module
+ */
+import type { Middleware, StreamingMiddleware } from 'ai.matey.types';
+import type { IRUsage } from 'ai.matey.types';
+/**
+ * Provider pricing configuration
+ */
+export interface ProviderPricing {
+    /**
+     * Cost per 1M input tokens (in USD)
+     */
+    inputCostPer1M: number;
+    /**
+     * Cost per 1M output tokens (in USD)
+     */
+    outputCostPer1M: number;
+    /**
+     * Optional: Different pricing for cached tokens
+     */
+    cachedInputCostPer1M?: number;
+    /**
+     * Optional: Different pricing based on request type
+     */
+    imageInputCostPer1M?: number;
+}
+/**
+ * Model-specific pricing
+ */
+export interface ModelPricing {
+    /**
+     * Model identifier or pattern (supports wildcards)
+     */
+    model: string | RegExp;
+    /**
+     * Pricing for this model
+     */
+    pricing: ProviderPricing;
+}
+/**
+ * Cost calculation result
+ */
+export interface CostCalculation {
+    /**
+     * Provider name
+     */
+    provider: string;
+    /**
+     * Model used
+     */
+    model: string;
+    /**
+     * Input tokens
+     */
+    inputTokens: number;
+    /**
+     * Output tokens
+     */
+    outputTokens: number;
+    /**
+     * Total tokens
+     */
+    totalTokens: number;
+    /**
+     * Input cost in USD
+     */
+    inputCost: number;
+    /**
+     * Output cost in USD
+     */
+    outputCost: number;
+    /**
+     * Total cost in USD
+     */
+    totalCost: number;
+    /**
+     * Request timestamp
+     */
+    timestamp: number;
+    /**
+     * Request ID
+     */
+    requestId: string;
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Cost tracking storage interface
+ */
+export interface CostStorage {
+    /**
+     * Record a cost calculation
+     */
+    record(cost: CostCalculation): Promise<void>;
+    /**
+     * Get total cost for a time period
+     */
+    getTotal(startTime?: number, endTime?: number): Promise<number>;
+    /**
+     * Get costs grouped by provider
+     */
+    getByProvider(startTime?: number, endTime?: number): Promise<Map<string, number>>;
+    /**
+     * Get costs grouped by model
+     */
+    getByModel(startTime?: number, endTime?: number): Promise<Map<string, number>>;
+    /**
+     * Clear all cost data
+     */
+    clear(): Promise<void>;
+}
+/**
+ * In-memory cost storage
+ */
+export declare class InMemoryCostStorage implements CostStorage {
+    private costs;
+    record(cost: CostCalculation): Promise<void>;
+    getTotal(startTime?: number, endTime?: number): Promise<number>;
+    getByProvider(startTime?: number, endTime?: number): Promise<Map<string, number>>;
+    getByModel(startTime?: number, endTime?: number): Promise<Map<string, number>>;
+    clear(): Promise<void>;
+    private filterCosts;
+    /**
+     * Get all cost records (for debugging/export)
+     */
+    getAllCosts(): CostCalculation[];
+}
+/**
+ * Cost tracking configuration
+ */
+export interface CostTrackingConfig {
+    /**
+     * Provider-specific pricing
+     */
+    providers?: Record<string, ProviderPricing>;
+    /**
+     * Model-specific pricing (overrides provider pricing)
+     */
+    models?: ModelPricing[];
+    /**
+     * Cost storage implementation
+     */
+    storage?: CostStorage;
+    /**
+     * Callback when cost is calculated
+     */
+    onCost?: (cost: CostCalculation) => void | Promise<void>;
+    /**
+     * Callback when cost threshold is exceeded
+     */
+    onThresholdExceeded?: (cost: CostCalculation, threshold: number) => void | Promise<void>;
+    /**
+     * Cost threshold per request (in USD)
+     */
+    requestThreshold?: number;
+    /**
+     * Cost threshold per hour (in USD)
+     */
+    hourlyThreshold?: number;
+    /**
+     * Cost threshold per day (in USD)
+     */
+    dailyThreshold?: number;
+    /**
+     * Whether to log costs to console
+     */
+    logCosts?: boolean;
+    /**
+     * Whether to include cost in response metadata
+     */
+    includeInMetadata?: boolean;
+}
+/**
+ * Default pricing for common providers (as of 2024)
+ * Prices in USD per 1M tokens
+ */
+export declare const DEFAULT_PRICING: Record<string, ProviderPricing>;
+/**
+ * Calculate cost for a request/response
+ */
+export declare function calculateCost(usage: IRUsage, provider: string, model: string, config: CostTrackingConfig): CostCalculation;
+/**
+ * Create cost tracking middleware
+ *
+ * @param config - Cost tracking configuration
+ * @returns Middleware function
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { createCostTrackingMiddleware } from 'ai.matey';
+ *
+ * const costTracking = createCostTrackingMiddleware({
+ *   logCosts: true,
+ *   onCost: (cost) => {
+ *     console.log(`Request cost: $${cost.totalCost.toFixed(6)}`);
+ *   }
+ * });
+ *
+ * bridge.use(costTracking);
+ * ```
+ *
+ * @example With Custom Pricing
+ * ```typescript
+ * const costTracking = createCostTrackingMiddleware({
+ *   providers: {
+ *     'anthropic': {
+ *       inputCostPer1M: 3.0,
+ *       outputCostPer1M: 15.0
+ *     }
+ *   },
+ *   models: [
+ *     {
+ *       model: /gpt-4-turbo/,
+ *       pricing: {
+ *         inputCostPer1M: 10.0,
+ *         outputCostPer1M: 30.0
+ *       }
+ *     }
+ *   ]
+ * });
+ * ```
+ *
+ * @example With Thresholds
+ * ```typescript
+ * const costTracking = createCostTrackingMiddleware({
+ *   requestThreshold: 0.10,  // Warn if request costs > $0.10
+ *   hourlyThreshold: 10.00,  // Warn if hourly cost > $10
+ *   dailyThreshold: 100.00,  // Warn if daily cost > $100
+ *   onThresholdExceeded: (cost, threshold) => {
+ *     console.warn(`Cost threshold exceeded: $${cost.totalCost} > $${threshold}`);
+ *   }
+ * });
+ * ```
+ */
+export declare function createCostTrackingMiddleware(config?: CostTrackingConfig): Middleware;
+/**
+ * Create streaming cost tracking middleware
+ *
+ * Note: For streaming, cost is calculated at the end when usage is available
+ */
+export declare function createStreamingCostTrackingMiddleware(config?: CostTrackingConfig): StreamingMiddleware;
+/**
+ * Get cost statistics from storage
+ */
+export declare function getCostStats(storage: CostStorage, hours?: number): Promise<{
+    period: string;
+    total: number;
+    byProvider: {
+        [k: string]: number;
+    };
+    byModel: {
+        [k: string]: number;
+    };
+}>;
+//# sourceMappingURL=cost-tracking.d.ts.map

package/dist/types/cost-tracking.d.ts.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AI Matey Middleware
+ *
+ * Consolidated package containing all middleware components.
+ * Middleware provides cross-cutting concerns like caching, retry,
+ * logging, and security for the AI adapter system.
+ *
+ * @module ai.matey.middleware
+ */
+export * from './caching.js';
+export * from './conversation-history.js';
+export * from './cost-tracking.js';
+export * from './logging.js';
+export * from './opentelemetry.js';
+export * from './retry.js';
+export * from './security.js';
+export * from './telemetry.js';
+export * from './transform.js';
+export * from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,cAAc,CAAC;AAC7B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC"}

package/dist/types/logging.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Logging Middleware
+ *
+ * Logs requests, responses, and errors with configurable levels and sanitization.
+ *
+ * @module
+ */
+import type { Middleware } from 'ai.matey.types';
+/**
+ * Log level.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Logger interface.
+ */
+export interface Logger {
+    debug(message: string, data?: unknown): void;
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+}
+/**
+ * Configuration for logging middleware.
+ */
+export interface LoggingConfig {
+    /**
+     * Minimum log level.
+     * @default 'info'
+     */
+    level?: LogLevel;
+    /**
+     * Whether to log request bodies.
+     * @default true
+     */
+    logRequests?: boolean;
+    /**
+     * Whether to log response bodies.
+     * @default true
+     */
+    logResponses?: boolean;
+    /**
+     * Whether to log errors.
+     * @default true
+     */
+    logErrors?: boolean;
+    /**
+     * Whether to sanitize sensitive data (API keys, tokens).
+     * @default true
+     */
+    sanitize?: boolean;
+    /**
+     * Custom logger implementation.
+     * @default console
+     */
+    logger?: Logger;
+    /**
+     * Custom log prefix.
+     */
+    prefix?: string;
+}
+/**
+ * Create logging middleware.
+ *
+ * Logs requests, responses, and errors at configurable levels.
+ *
+ * @param config Logging configuration
+ * @returns Logging middleware
+ *
+ * @example
+ * ```typescript
+ * const logging = createLoggingMiddleware({
+ *   level: 'info',
+ *   logRequests: true,
+ *   logResponses: true,
+ *   sanitize: true
+ * });
+ *
+ * bridge.use(logging);
+ * ```
+ */
+export declare function createLoggingMiddleware(config?: LoggingConfig): Middleware;
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAqC,MAAM,gBAAgB,CAAC;AAOpF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwGD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,GAAE,aAAkB,GAAG,UAAU,CAwE9E"}