ai.matey.patterns 0.2.0

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "ai.matey.patterns",
+  "version": "0.2.0",
+  "description": "Production integration patterns for AI Matey - complexity routing, parallel aggregation, failover, cost optimization, batch processing",
+  "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.core": "*",
+    "ai.matey.errors": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "patterns",
+    "routing",
+    "failover",
+    "batch",
+    "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/patterns"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/readme.md

@@ -0,0 +1,54 @@
+# ai.matey.patterns
+
+Production integration patterns for the [ai.matey](https://github.com/johnhenry/ai.matey)
+Universal AI Adapter System — the validated patterns from the pattern library, packaged as
+importable utilities.
+
+```bash
+npm install ai.matey.patterns
+```
+
+## Patterns
+
+| Utility | Purpose |
+|---|---|
+| `createComplexityRouter()` | Route by query complexity: cheap models for simple queries, capable models for hard ones |
+| `createParallelAggregator()` | Query several providers at once; fastest-wins, all-results, or a custom judge |
+| `createFailoverMiddleware()` | Bridge-level failover to fallback adapters (Router users: prefer built-in fallback chains) |
+| `createCostOptimizer()` | Cost-optimized routing plus a sliding-window budget ceiling |
+| `createBatchProcessor()` | Bounded-concurrency queue with token-bucket rate limiting and retries |
+
+## Quick start
+
+```typescript
+import { createComplexityRouter, createBatchProcessor } from 'ai.matey.patterns';
+import { Bridge } from 'ai.matey.core';
+import { OpenAIFrontendAdapter } from 'ai.matey.frontend';
+import { OpenAIBackendAdapter, AnthropicBackendAdapter } from 'ai.matey.backend';
+
+const router = createComplexityRouter({
+  tiers: [
+    { backend: 'fast', maxComplexity: 40 },
+    { backend: 'powerful', maxComplexity: 100 },
+  ],
+  backends: {
+    fast: new OpenAIBackendAdapter({ apiKey: process.env.OPENAI_API_KEY }),
+    powerful: new AnthropicBackendAdapter({ apiKey: process.env.ANTHROPIC_API_KEY }),
+  },
+});
+
+const bridge = new Bridge(new OpenAIFrontendAdapter(), router);
+
+const processor = createBatchProcessor({
+  execute: (request) => bridge.chat(request),
+  concurrency: 5,
+  requestsPerSecond: 10,
+});
+```
+
+See the [pattern guide](https://github.com/johnhenry/ai.matey/blob/main/docs/PATTERNS.md) for
+the full write-ups, benchmarks, and trade-offs behind each pattern.
+
+## License
+
+MIT