ai.matey.core 0.2.0

package/dist/types/model-pricing.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Model Pricing Registry
+ *
+ * Centralized pricing database for AI models across providers.
+ * Prices are in USD per 1,000 tokens.
+ *
+ * @module
+ */
+import type { ModelCapabilities } from 'ai.matey.types';
+/**
+ * Pricing data for a specific model.
+ */
+export interface ModelPricing {
+    readonly input: number;
+    readonly output: number;
+}
+/**
+ * Extended capabilities including estimated quality and latency.
+ */
+export interface ExtendedModelCapabilities extends ModelCapabilities {
+    readonly pricing: ModelPricing;
+    readonly latency?: {
+        readonly p50?: number;
+        readonly p95?: number;
+    };
+    readonly qualityScore?: number;
+    readonly modelFamily?: string;
+    readonly releaseDate?: string;
+}
+/**
+ * Get pricing information for a specific model.
+ *
+ * @param modelId - The model identifier (e.g., "gpt-4", "claude-3-opus-20240229")
+ * @returns Pricing data or null if not found
+ */
+export declare function getModelPricing(modelId: string): ModelPricing | null;
+/**
+ * Get extended capabilities for a specific model.
+ *
+ * @param modelId - The model identifier
+ * @returns Extended capabilities or null if not found
+ */
+export declare function getModelCapabilities(modelId: string): Partial<ExtendedModelCapabilities> | null;
+/**
+ * Get all models with pricing data.
+ *
+ * @returns Array of model IDs with pricing information
+ */
+export declare function getAllPricedModels(): string[];
+/**
+ * Find models by model family.
+ *
+ * @param family - The model family (e.g., "gpt-4", "claude-3")
+ * @returns Array of model IDs in the family
+ */
+export declare function getModelsByFamily(family: string): string[];
+/**
+ * Set custom pricing for a model (overrides static database).
+ *
+ * @param modelId - The model identifier
+ * @param pricing - Custom pricing data
+ */
+export declare function setPricingOverride(modelId: string, pricing: ModelPricing): void;
+/**
+ * Clear pricing override for a model.
+ *
+ * @param modelId - The model identifier
+ */
+export declare function clearPricingOverride(modelId: string): void;
+/**
+ * Clear all pricing overrides.
+ */
+export declare function clearAllPricingOverrides(): void;
+/**
+ * Get pricing with user overrides applied.
+ *
+ * @param modelId - The model identifier
+ * @returns Pricing data (override if set, else from database)
+ */
+export declare function getPricingWithOverrides(modelId: string): ModelPricing | null;
+//# sourceMappingURL=model-pricing.d.ts.map

package/dist/types/model-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../../src/model-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAyQD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI,CAE/F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAI1D;AAQD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAE/E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAE5E"}

package/dist/types/model-translation.d.ts

@@ -0,0 +1,171 @@
+/**
+ * Core Model Translation
+ *
+ * Backend-agnostic model translation utilities for converting model names
+ * between different AI providers. Works in any environment (Node.js, Browser, Deno, etc.).
+ *
+ * @module core/model-translation
+ */
+/**
+ * Model name mapping (source model → target model).
+ */
+export type ModelMapping = Record<string, string>;
+/**
+ * Translation strategy for Router fallback.
+ */
+export type ModelTranslationStrategy = 'exact' | 'pattern' | 'hybrid' | 'none';
+/**
+ * Configuration for model translation behavior.
+ */
+export interface ModelTranslationConfig {
+    /**
+     * Translation strategy to use.
+     * @default 'hybrid'
+     */
+    readonly strategy: ModelTranslationStrategy;
+    /**
+     * Emit warning event when using backend default model.
+     * @default true
+     */
+    readonly warnOnDefault?: boolean;
+    /**
+     * Throw error if no translation found (instead of returning original).
+     * @default false
+     */
+    readonly strictMode?: boolean;
+}
+/**
+ * Options for translateModel function.
+ */
+export interface ModelTranslationOptions {
+    /**
+     * Exact model mappings.
+     */
+    readonly mapping?: ModelMapping;
+    /**
+     * Backend default model (used in hybrid strategy).
+     */
+    readonly defaultModel?: string;
+    /**
+     * Translation strategy.
+     * @default 'exact'
+     */
+    readonly strategy?: ModelTranslationStrategy;
+    /**
+     * Throw error if no translation found.
+     * @default false
+     */
+    readonly strictMode?: boolean;
+}
+/**
+ * Result of model translation.
+ */
+export interface TranslationResult {
+    /**
+     * Translated model name.
+     */
+    readonly translated: string;
+    /**
+     * Source of translation.
+     */
+    readonly source: 'exact' | 'pattern' | 'default' | 'none';
+    /**
+     * Whether a translation was applied.
+     */
+    readonly wasTranslated: boolean;
+}
+/**
+ * Translate a model name using exact mapping.
+ *
+ * @param modelName - Original model name
+ * @param options - Translation options
+ * @returns Translation result
+ *
+ * @example
+ * ```typescript
+ * const result = translateModel('gpt-4', {
+ *   mapping: { 'gpt-4': 'claude-3-5-sonnet-20241022' }
+ * });
+ * // → { translated: 'claude-3-5-sonnet-20241022', source: 'exact', wasTranslated: true }
+ * ```
+ */
+export declare function translateModel(modelName: string, options?: ModelTranslationOptions): TranslationResult;
+/**
+ * Create a model translator with pre-configured options.
+ *
+ * @param options - Default translation options
+ * @returns Translator function
+ *
+ * @example
+ * ```typescript
+ * const translator = createModelTranslator({
+ *   mapping: { 'gpt-4': 'claude-3-5-sonnet-20241022' },
+ *   strategy: 'hybrid',
+ *   defaultModel: 'claude-3-5-haiku-20241022'
+ * });
+ *
+ * const result = translator('gpt-4');
+ * // → { translated: 'claude-3-5-sonnet-20241022', source: 'exact', wasTranslated: true }
+ * ```
+ */
+export declare function createModelTranslator(defaultOptions: ModelTranslationOptions): (modelName: string, overrides?: Partial<ModelTranslationOptions>) => TranslationResult;
+/**
+ * Get reverse mapping (target model → source model).
+ *
+ * @param mapping - Forward mapping
+ * @returns Reverse mapping
+ *
+ * @example
+ * ```typescript
+ * const forward = { 'gpt-4': 'claude-3-5-sonnet' };
+ * const reverse = reverseMapping(forward);
+ * // → { 'claude-3-5-sonnet': 'gpt-4' }
+ * ```
+ */
+export declare function reverseMapping(mapping: ModelMapping): ModelMapping;
+/**
+ * Check if a model name has an exact translation.
+ *
+ * @param modelName - Model name to check
+ * @param mapping - Model mapping
+ * @returns True if exact translation exists
+ *
+ * @example
+ * ```typescript
+ * const mapping = { 'gpt-4': 'claude-3-5-sonnet' };
+ * hasTranslation('gpt-4', mapping); // → true
+ * hasTranslation('gpt-3.5', mapping); // → false
+ * ```
+ */
+export declare function hasTranslation(modelName: string, mapping: ModelMapping): boolean;
+/**
+ * Merge multiple model mappings into one.
+ *
+ * Later mappings take precedence over earlier ones.
+ *
+ * @param mappings - Array of mappings to merge
+ * @returns Merged mapping
+ *
+ * @example
+ * ```typescript
+ * const mapping1 = { 'gpt-4': 'claude-3-opus' };
+ * const mapping2 = { 'gpt-4': 'claude-3-5-sonnet' }; // Override
+ * const merged = mergeMappings(mapping1, mapping2);
+ * // → { 'gpt-4': 'claude-3-5-sonnet' }
+ * ```
+ */
+export declare function mergeMappings(...mappings: ModelMapping[]): ModelMapping;
+/**
+ * Validate that a model mapping is well-formed.
+ *
+ * @param mapping - Mapping to validate
+ * @throws Error if mapping is invalid
+ *
+ * @example
+ * ```typescript
+ * validateMapping({ 'gpt-4': 'claude-3-5-sonnet' }); // OK
+ * validateMapping({ 'gpt-4': '' }); // Throws: empty target model
+ * ```
+ */
+export declare function validateMapping(mapping: ModelMapping): void;
+//# sourceMappingURL=model-translation.d.ts.map

package/dist/types/model-translation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-translation.d.ts","sourceRoot":"","sources":["../../src/model-translation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B,GACpC,iBAAiB,CA+BnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,uBAAuB,GACtC,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,KAAK,iBAAiB,CAIxF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAMlE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAEhF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,CAMvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAa3D"}

package/dist/types/router.d.ts

@@ -0,0 +1,287 @@
+/**
+ * Router Implementation
+ *
+ * The Router manages multiple backend adapters with intelligent routing,
+ * fallback strategies, circuit breaker pattern, and health checking.
+ * It implements the BackendAdapter interface so it can be used as a backend.
+ *
+ * @module
+ */
+import type { BackendAdapter, AdapterMetadata } from 'ai.matey.types';
+import type { IRChatRequest, IRChatResponse, IRChatStream } from 'ai.matey.types';
+import type { Router as IRouter, RouterConfig, BackendInfo, BackendStats, RouterStats, ModelMapping, ModelPatternMapping, ParallelDispatchOptions, ParallelDispatchResult } from 'ai.matey.types';
+/**
+ * Router manages multiple backend adapters with intelligent routing.
+ */
+export declare class Router implements IRouter {
+    readonly metadata: AdapterMetadata;
+    readonly config: RouterConfig;
+    private backends;
+    private modelMapping;
+    private modelTranslationMapping;
+    private backendTranslationMappings;
+    private modelPatterns;
+    private fallbackChain;
+    private roundRobinIndex;
+    private healthCheckInterval?;
+    private stats;
+    constructor(config?: Partial<RouterConfig>);
+    /**
+     * Convert IR request to provider format.
+     * Not applicable for Router - use the specific backend adapter instead.
+     */
+    fromIR(_request: IRChatRequest): unknown;
+    /**
+     * Convert provider response to IR format.
+     * Not applicable for Router - use the specific backend adapter instead.
+     */
+    toIR(_response: unknown, _originalRequest: IRChatRequest, _latencyMs: number): IRChatResponse;
+    /**
+     * Register a backend adapter.
+     */
+    register(name: string, adapter: BackendAdapter): Router;
+    /**
+     * Unregister a backend adapter.
+     */
+    unregister(name: string): Router;
+    /**
+     * Get a registered backend adapter.
+     */
+    get(name: string): BackendAdapter | undefined;
+    /**
+     * Check if backend is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * List all registered backend names.
+     */
+    listBackends(): readonly string[];
+    /**
+     * Get information about all or specific backend.
+     */
+    getBackendInfo(): BackendInfo[];
+    getBackendInfo(name: string): BackendInfo | undefined;
+    /**
+     * Set fallback chain for sequential failover.
+     */
+    setFallbackChain(chain: readonly string[]): Router;
+    /**
+     * Get current fallback chain.
+     */
+    getFallbackChain(): readonly string[];
+    /**
+     * Set model to backend mapping.
+     */
+    setModelMapping(mapping: ModelMapping): Router;
+    /**
+     * Get current model mapping.
+     */
+    getModelMapping(): ModelMapping;
+    /**
+     * Set model name translation mapping (for fallback scenarios).
+     * Maps source model names to target model names.
+     *
+     * @example
+     * ```typescript
+     * router.setModelTranslationMapping({
+     *   'gpt-4': 'claude-3-5-sonnet-20241022',
+     *   'gpt-3.5-turbo': 'claude-3-5-haiku-20241022'
+     * });
+     * ```
+     */
+    setModelTranslationMapping(mapping: ModelMapping): Router;
+    /**
+     * Get current model translation mapping.
+     */
+    getModelTranslationMapping(): ModelMapping;
+    /**
+     * Set backend-specific model translation mapping.
+     * This takes priority over global model translation mapping.
+     *
+     * @example
+     * ```typescript
+     * router.setBackendTranslationMapping('anthropic', {
+     *   'gpt-4': 'claude-3-5-sonnet-20241022',
+     *   'gpt-3.5-turbo': 'claude-3-5-haiku-20241022'
+     * });
+     * ```
+     */
+    setBackendTranslationMapping(backendName: string, mapping: ModelMapping): Router;
+    /**
+     * Get backend-specific model translation mapping.
+     */
+    getBackendTranslationMapping(backendName: string): ModelMapping;
+    /**
+     * Clear all model translation mappings.
+     *
+     * @returns This router for chaining
+     */
+    clearModelTranslationMapping(): Router;
+    /**
+     * Clear backend-specific model translation mappings.
+     *
+     * @param backendName Optional backend name to clear. If not provided, clears all.
+     * @returns This router for chaining
+     */
+    clearBackendTranslationMapping(backendName?: string): Router;
+    /**
+     * Set model pattern mappings.
+     */
+    setModelPatterns(patterns: readonly ModelPatternMapping[]): Router;
+    /**
+     * Get current model patterns.
+     */
+    getModelPatterns(): readonly ModelPatternMapping[];
+    /**
+     * Select backend for a request.
+     */
+    selectBackend(request: IRChatRequest, preferredBackend?: string): Promise<string>;
+    /**
+     * Execute request with automatic backend selection and fallback.
+     */
+    execute(request: IRChatRequest, signal?: AbortSignal): Promise<IRChatResponse>;
+    /**
+     * Execute streaming request with automatic backend selection and fallback.
+     */
+    executeStream(request: IRChatRequest, signal?: AbortSignal): IRChatStream;
+    /**
+     * Dispatch request to multiple backends in parallel.
+     */
+    dispatchParallel(request: IRChatRequest, options?: ParallelDispatchOptions, signal?: AbortSignal): Promise<ParallelDispatchResult>;
+    /**
+     * Check health of all or specific backend.
+     */
+    checkHealth(): Promise<Record<string, boolean>>;
+    checkHealth(name: string): Promise<boolean>;
+    /**
+     * Manually open circuit breaker for a backend.
+     */
+    openCircuitBreaker(name: string, timeoutMs?: number): void;
+    /**
+     * Manually close circuit breaker for a backend.
+     */
+    closeCircuitBreaker(name: string): void;
+    /**
+     * Reset circuit breaker statistics.
+     */
+    resetCircuitBreaker(name?: string): void;
+    /**
+     * Check if circuit breaker is open for a backend.
+     *
+     * @param name Backend name
+     * @returns true if circuit breaker is open, false otherwise
+     */
+    isCircuitBreakerOpen(name: string): boolean;
+    /**
+     * Get router statistics.
+     */
+    getStats(): RouterStats;
+    /**
+     * Reset router statistics.
+     */
+    resetStats(): void;
+    /**
+     * Get statistics for specific backend.
+     */
+    getBackendStats(name: string): BackendStats | undefined;
+    /**
+     * Clone router with new configuration.
+     */
+    clone(config: Partial<RouterConfig>): Router;
+    /**
+     * Clean up resources.
+     */
+    dispose(): void;
+    /**
+     * Execute request on specific backend.
+     */
+    private executeOnBackend;
+    /**
+     * Execute streaming request on specific backend.
+     */
+    private executeStreamOnBackend;
+    /**
+     * Execute fallback strategy.
+     */
+    private executeFallback;
+    /**
+     * Translate model name for a specific backend.
+     *
+     * Applies translation strategy: backend-specific exact → global exact → pattern → default → passthrough
+     */
+    private translateModelForBackend;
+    /**
+     * Sequential fallback: try backends one by one.
+     */
+    private fallbackSequential;
+    /**
+     * Parallel fallback: try all remaining backends at once.
+     */
+    private fallbackParallel;
+    /**
+     * Check circuit breaker state.
+     */
+    private checkCircuitBreaker;
+    /**
+     * Get list of available backends.
+     */
+    private getAvailableBackends;
+    /**
+     * Check if backend is available.
+     */
+    private isBackendAvailable;
+    /**
+     * Routing: explicit backend selection.
+     */
+    private routeExplicit;
+    /**
+     * Routing: model-based selection.
+     */
+    private routeByModel;
+    /**
+     * Routing: cost-optimized selection.
+     */
+    private routeByCost;
+    /**
+     * Routing: latency-optimized selection.
+     */
+    private routeByLatency;
+    /**
+     * Routing: round-robin selection.
+     */
+    private routeRoundRobin;
+    /**
+     * Routing: random selection.
+     */
+    private routeRandom;
+    /**
+     * Select backend based on capability requirements.
+     * Returns the backend name with the best matching model, or null if none match.
+     */
+    private selectBackendByCapabilities;
+    /**
+     * Calculate backend statistics.
+     */
+    private calculateBackendStats;
+    /**
+     * Create backend info from state.
+     */
+    private createBackendInfo;
+    /**
+     * Start periodic health checking.
+     */
+    private startHealthChecking;
+    /**
+     * Combine multiple abort signals.
+     */
+    private combineSignals;
+    /**
+     * Wrap unknown error as AdapterError.
+     */
+    private wrapError;
+}
+/**
+ * Create a new Router instance.
+ */
+export declare function createRouter(config?: Partial<RouterConfig>): Router;
+//# sourceMappingURL=router.d.ts.map

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

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "ai.matey.core",
+  "version": "0.2.0",
+  "description": "Core components for AI Matey - Universal AI Adapter System",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "readme.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "ai.matey.types": "*",
+    "ai.matey.errors": "*",
+    "ai.matey.utils": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "core",
+    "router",
+    "bridge",
+    "ai-matey"
+  ],
+  "author": "AI Matey",
+  "license": "MIT",
+  "homepage": "https://github.com/johnhenry/ai.matey#readme",
+  "bugs": {
+    "url": "https://github.com/johnhenry/ai.matey/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnhenry/ai.matey.git",
+    "directory": "packages/ai.matey.core"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/readme.md

@@ -0,0 +1,34 @@
+# ai.matey.core
+
+Core Bridge, Router, and MiddlewareStack implementations
+
+Part of the [ai.matey](https://github.com/johnhenry/ai.matey) monorepo.
+
+## Installation
+
+```bash
+npm install ai.matey.core
+```
+
+## Exports
+
+- `Bridge`
+- `createBridge`
+- `Router`
+- `createRouter`
+- `MiddlewareStack`
+- `createMiddlewareContext`
+
+## Usage
+
+```typescript
+import { Bridge, createBridge, Router, createRouter, MiddlewareStack, createMiddlewareContext } from 'ai.matey.core';
+```
+
+## API Reference
+
+See the TypeScript definitions for detailed API documentation.
+
+## License
+
+MIT - see [LICENSE](./LICENSE) for details.