ai-experiments 2.1.3 → 2.3.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # ai-experiments
 
+## 2.3.0
+
+### Patch Changes
+
+- Updated dependencies [9e2779a]
+- Updated dependencies [b7c7c57]
+  - ai-functions@2.3.0
+  - ai-database@2.3.0
+
 ## 2.1.3
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,18 @@
 # ai-experiments
 
-AI-powered experimentation primitives for testing and evaluating models.
+![Stability: Experimental](https://img.shields.io/badge/stability-experimental-red)
+
+Runtime A/B testing for AI variants in production. Traffic splitting, multi-armed bandits, parameter sweeps, and ClickHouse-backed outcome tracking via the canonical `ai-database` adapter.
+
+## Lifecycle
+
+**Runtime (production).** `ai-experiments` is for splitting live traffic across model/prompt/parameter variants and measuring outcomes against real users. Reach for it when you need to learn which variant wins under production conditions — not in a test suite.
+
+## Not for
+
+- **Unit testing.** If you want to assert that a specific input produces a specific output during development or CI, use [`ai-tests`](../ai-tests) plus `vitest`. `ai-experiments` exists to *measure* outcomes across users, not to *assert* them against fixtures.
+- **Sandboxing untrusted code.** That's [`ai-evaluate`](../ai-evaluate)'s job.
+- **Offline-only experiments.** While `Experiment()` works offline for parameter sweeps, the package's value comes from production tracking — if you're never deploying the variants, a plain `for` loop is simpler.
 
 ## Overview
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-experiments",
-  "version": "2.1.3",
-  "description": "AI-powered experimentation primitives for testing and evaluating models",
+  "version": "2.3.0",
+  "description": "Runtime A/B testing for AI variants in production - traffic splitting, decision strategies, and ClickHouse-backed outcome tracking",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,13 +11,21 @@
       "types": "./dist/index.d.ts"
     },
     "./storage": {
-      "import": "./dist/chdb-storage.js",
-      "types": "./dist/chdb-storage.d.ts"
+      "import": "./dist/clickhouse-storage.js",
+      "types": "./dist/clickhouse-storage.d.ts"
     }
   },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "clean": "rm -rf dist"
+  },
   "dependencies": {
-    "chdb": "^1.6.0",
-    "ai-functions": "2.1.3"
+    "ai-database": "2.3.0",
+    "ai-functions": "2.3.0"
   },
   "keywords": [
     "ai",
@@ -26,13 +34,5 @@
     "analytics",
     "primitives"
   ],
-  "license": "MIT",
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
-    "clean": "rm -rf dist"
-  }
-}
+  "license": "MIT"
+}