@x12i/ai-gateway 10.2.1 → 10.3.0

package/README.md

@@ -13,7 +13,7 @@ Unified gateway for LLM provider routing, structured logging, optional Activix a
 | **Activix** | Optional Mongo-backed activity rows; billing written from gateway-computed slice on **`completeRecord`** (`outer.cost` + root fields). No Activix **`autoCost`** re-pricing. |
 | **Trace mode** | `diagnostics.mode === 'trace'` adds `metadata.attempts[]`, `metadata.usage`, and per-attempt **`costUsd`** / **`costStatus`**. |
 
-Pinned dependency versions are in `package.json` (currently **Activix ^8.6**, **ai-tools ^3.1**, **ai-profiles ^3.2**, **ai-providers-router ^4.9**).
+Pinned dependency versions are in `package.json` (currently **Activix ^9.0**, **ai-tools ^3.3**, **ai-profiles ^3.4**, **ai-providers-router ^4.9**).
 
 ---
 
@@ -262,9 +262,9 @@ Gateway billing helpers (exported for tests/integrators): `resolveCostCompletion
 
 ---
 
-## Activity tracking (@x12i/activix 8.6)
+## Activity tracking (@x12i/activix 9.0)
 
-When tracking is enabled and no custom tracker is supplied, the gateway constructs Activix with fixed collection names (see `src/config/activity-tracking-config.ts`):
+When tracking is enabled and no custom tracker is supplied, the gateway constructs Activix with fixed collection names (see `src/config/activity-tracking-config.ts`). **`storageMode` is omitted** — Activix 9 infers **`database`** when `MONGO_URI` (or env URI) is set and **`local`** playground when it is not. Configured Mongo that is unreachable causes **`init()` to fail** (no silent playground fallback); the gateway logs a warning and disables persistence for that process.
 
 | Collection | Typical use |
 |------------|-------------|
@@ -281,9 +281,9 @@ When tracking is enabled and no custom tracker is supplied, the gateway construc
 - `outer.cost`: Activix cost shape (`usd`, `tokens`, `provider`, `model`, `details`)
 - `response.metadata`: same billing slice as returned to callers
 
-Activix **8.6** runs **`materializeRecordRoutingAndBilling`** on persist (root **`config`** mirror from routing metadata). Gateway resolves billing **before** `completeRecord` and sets **`outer.cost`** from that slice.
+Activix runs **`materializeRecordRoutingAndBilling`** on persist (root **`config`** mirror from routing metadata). Gateway resolves billing **before** `completeRecord` and sets **`outer.cost`** from that slice.
 
-**`autoCost`:** Activix 8.6 default is **`false`**. The gateway keeps **`autoCost: false`** on the default activity manager so billing is not recomputed via ai-tools at persist time (no second pricing path). Custom **`activityTracker`** instances may opt in to Activix **`autoCost`** (uses **@x12i/ai-tools** v3 **`calculateFromRecord`** when enabled).
+**`autoCost`:** Activix default is **`false`**. The gateway keeps **`autoCost: false`** on the default activity manager so billing is not recomputed via ai-tools at persist time (no second pricing path). Custom **`activityTracker`** instances may opt in to Activix **`autoCost`** (uses **@x12i/ai-tools** v3 **`calculateFromRecord`** when enabled). For dev hosts that need probe-then-fallback when Mongo is down, pass a custom **`activityTracker`** with **`storageMode: 'automatic'`**.
 
 Mongo env: `MONGO_URI` + `MONGO_LOGS_DB` or `MONGO_DB`.
 

package/dist/activity-manager.js

@@ -331,7 +331,6 @@ export class ActivityManager {
                     timeout: 'timeout'
                 };
                 const activixOptions = {
-                    storageMode: 'automatic',
                     collections: [
                         {
                             name: collectionName,

package/dist/openrouter-routing.d.ts

@@ -7,6 +7,6 @@ export { readPreferOpenRouterFromEnv };
 export declare function resolveOpenRouterApiKey(config?: GatewayConfig): string | undefined;
 /**
  * Effective OpenRouter preference for invoke-time routing (ai-tools `preferOpenRouter`).
- * Constructor `openRouter.prefer` / `openRouter.enabled` override env `PREFER_OPENROUTER`.
+ * Constructor `openRouter.prefer` overrides env `PREFER_OPENROUTER`.
  */
 export declare function resolvePreferOpenRouter(config?: GatewayConfig): boolean;

package/dist/openrouter-routing.js

@@ -9,16 +9,12 @@ export function resolveOpenRouterApiKey(config = {}) {
 }
 /**
  * Effective OpenRouter preference for invoke-time routing (ai-tools `preferOpenRouter`).
- * Constructor `openRouter.prefer` / `openRouter.enabled` override env `PREFER_OPENROUTER`.
+ * Constructor `openRouter.prefer` overrides env `PREFER_OPENROUTER`.
  */
 export function resolvePreferOpenRouter(config = {}) {
     if (config.openRouter?.prefer === true)
         return true;
     if (config.openRouter?.prefer === false)
         return false;
-    if (config.openRouter?.enabled === true)
-        return true;
-    if (config.openRouter?.enabled === false)
-        return false;
     return resolvePreferOpenRouterPreference();
 }

package/dist/types.d.ts

@@ -391,11 +391,10 @@ export interface GatewayConfig extends Omit<RouterConfig, 'defaultEngine' | 'log
     };
     /**
      * OpenRouter preference (not a hard off-switch when {@link openrouter}.apiKey or OPENROUTER_API_KEY is set).
-     * - `prefer: true` / `enabled: true` or omitted env (default true): prefer OpenRouter when OPENROUTER_API_KEY is present.
-     * - `prefer: false` / `enabled: false` or PREFER_OPENROUTER=false: use direct providers when their API keys exist; OpenRouter still used as fallback when a requested provider has no key.
+     * - `prefer: true` or omitted env (default true): prefer OpenRouter when OPENROUTER_API_KEY is present.
+     * - `prefer: false` or PREFER_OPENROUTER=false: use direct providers when their API keys exist; OpenRouter still used as fallback when a requested provider has no key.
      */
     openRouter?: {
-        enabled?: boolean;
         prefer?: boolean;
     };
     /**

package/dist-cjs/activity-manager.cjs

@@ -331,7 +331,6 @@ export class ActivityManager {
                     timeout: 'timeout'
                 };
                 const activixOptions = {
-                    storageMode: 'automatic',
                     collections: [
                         {
                             name: collectionName,

package/dist-cjs/openrouter-routing.cjs

@@ -9,16 +9,12 @@ export function resolveOpenRouterApiKey(config = {}) {
 }
 /**
  * Effective OpenRouter preference for invoke-time routing (ai-tools `preferOpenRouter`).
- * Constructor `openRouter.prefer` / `openRouter.enabled` override env `PREFER_OPENROUTER`.
+ * Constructor `openRouter.prefer` overrides env `PREFER_OPENROUTER`.
  */
 export function resolvePreferOpenRouter(config = {}) {
     if (config.openRouter?.prefer === true)
         return true;
     if (config.openRouter?.prefer === false)
         return false;
-    if (config.openRouter?.enabled === true)
-        return true;
-    if (config.openRouter?.enabled === false)
-        return false;
     return resolvePreferOpenRouterPreference();
 }

package/dist-cjs/openrouter-routing.d.ts

@@ -7,6 +7,6 @@ export { readPreferOpenRouterFromEnv };
 export declare function resolveOpenRouterApiKey(config?: GatewayConfig): string | undefined;
 /**
  * Effective OpenRouter preference for invoke-time routing (ai-tools `preferOpenRouter`).
- * Constructor `openRouter.prefer` / `openRouter.enabled` override env `PREFER_OPENROUTER`.
+ * Constructor `openRouter.prefer` overrides env `PREFER_OPENROUTER`.
  */
 export declare function resolvePreferOpenRouter(config?: GatewayConfig): boolean;

package/dist-cjs/types.d.ts

@@ -391,11 +391,10 @@ export interface GatewayConfig extends Omit<RouterConfig, 'defaultEngine' | 'log
     };
     /**
      * OpenRouter preference (not a hard off-switch when {@link openrouter}.apiKey or OPENROUTER_API_KEY is set).
-     * - `prefer: true` / `enabled: true` or omitted env (default true): prefer OpenRouter when OPENROUTER_API_KEY is present.
-     * - `prefer: false` / `enabled: false` or PREFER_OPENROUTER=false: use direct providers when their API keys exist; OpenRouter still used as fallback when a requested provider has no key.
+     * - `prefer: true` or omitted env (default true): prefer OpenRouter when OPENROUTER_API_KEY is present.
+     * - `prefer: false` or PREFER_OPENROUTER=false: use direct providers when their API keys exist; OpenRouter still used as fallback when a requested provider has no key.
      */
     openRouter?: {
-        enabled?: boolean;
         prefer?: boolean;
     };
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/ai-gateway",
-  "version": "10.2.1",
+  "version": "10.3.0",
   "description": "AI Gateway - Unified interface for LLM provider routing and management",
   "type": "module",
   "exports": {
@@ -41,10 +41,10 @@
   "author": "x12i",
   "license": "mit",
   "dependencies": {
-    "@x12i/activix": "^8.6.2",
-    "@x12i/ai-profiles": "^3.3.0",
+    "@x12i/activix": "^9.0.0",
+    "@x12i/ai-profiles": "^3.4.0",
     "@x12i/ai-providers-router": "^4.9.2",
-    "@x12i/ai-tools": "^3.3.0",
+    "@x12i/ai-tools": "^3.3.3",
     "@x12i/flex-md": "^4.8.0",
     "@x12i/logxer": "^4.6.0",
     "@x12i/rendrix": "^4.3.0"