@x12i/ai-gateway 9.6.3 → 9.6.7

package/dist-cjs/gateway.d.ts

@@ -20,6 +20,8 @@ export declare class AIGateway {
     private defaultModelConfig;
     private _autoRegisterDone;
     private _aiToolsClient;
+    private readonly preferOpenRouter;
+    private readonly openRouterApiKey?;
     constructor(config?: GatewayConfig, activityManager?: ActivityManager);
     /**
      * Invoke chat request (without structured output requirements)

package/dist-cjs/index.cjs

@@ -29,9 +29,10 @@ export { Activix } from '@x12i/activix';
 export { normalizeToActivixCostShape } from '@x12i/activix';
 export { ActivityManager, ensureGatewayRequestIdentity } from './activity-manager.js';
 export { OptimixerManager } from './optimixer-manager.js';
-export { activityIdentityToLogMeta, withActivityIdentity, gatewayLogDebug } from './gateway-log-meta.js';
+export { activityIdentityToLogContext, activityIdentityToLogMeta, withActivityIdentity, withGatewayLogContext, gatewayLogDebug } from './gateway-log-meta.js';
+export { createGatewayLogger, GATEWAY_LOG_ENV_PREFIX } from './logger-factory.js';
 // Re-export logging (@x12i/logxer)
-export { createLogxer, DebugLogAbstract } from '@x12i/logxer';
+export { createLogxer, DebugLogAbstract, runWithLogContext, getStationRuntimeIdentity, mergeRuntimeIdentity } from '@x12i/logxer';
 // Runtime observability surface (leaf package: no downstream runtime objects)
 export { runtimeObjects } from './runtime-objects.js';
 // Export rate limiter

package/dist-cjs/index.d.ts

@@ -34,9 +34,10 @@ export { normalizeToActivixCostShape } from '@x12i/activix';
 export { ActivityManager, ensureGatewayRequestIdentity } from './activity-manager.js';
 export { OptimixerManager } from './optimixer-manager.js';
 export type { ActivityIdentity } from './types.js';
-export { activityIdentityToLogMeta, withActivityIdentity, gatewayLogDebug } from './gateway-log-meta.js';
-export { createLogxer, DebugLogAbstract } from '@x12i/logxer';
-export type { Logxer, LogMeta, RuntimeIdentity } from '@x12i/logxer';
+export { activityIdentityToLogContext, activityIdentityToLogMeta, withActivityIdentity, withGatewayLogContext, gatewayLogDebug } from './gateway-log-meta.js';
+export { createGatewayLogger, GATEWAY_LOG_ENV_PREFIX } from './logger-factory.js';
+export { createLogxer, DebugLogAbstract, runWithLogContext, getStationRuntimeIdentity, mergeRuntimeIdentity } from '@x12i/logxer';
+export type { Logxer, LogMeta, RuntimeIdentity, LogRuntimeContext, GetJobLogsInput, GetJobLogsResult, QueryableLogLine } from '@x12i/logxer';
 export { runtimeObjects } from './runtime-objects.js';
 export type { ActivixQueryableClient, LogxerQueryableClient, PackageRuntimeObjects, RuntimeObjects } from './runtime-objects.js';
 export { GatewayRateLimiter } from './gateway-rate-limiter.js';

package/dist-cjs/logger-factory.cjs

@@ -3,16 +3,14 @@
  *
  * Creates and configures logxer instances for the gateway
  */
-import { createLogxer } from '@x12i/logxer';
-function resolveDefaultRuntimeIdentity(packageName) {
-    const service = process.env.AI_GATEWAY_LOG_SERVICE ?? packageName ?? 'AI_GATEWAY';
-    if (!service)
-        return undefined;
-    return {
-        service,
-        env: process.env.NODE_ENV,
+import { createLogxer, getStationRuntimeIdentity, mergeRuntimeIdentity } from '@x12i/logxer';
+/** Stable ERC 2.0 env prefix — controls `AI_GATEWAY_LOGS_LEVEL`, etc. */
+export const GATEWAY_LOG_ENV_PREFIX = 'AI_GATEWAY';
+function resolveGatewayRuntimeIdentity(packageName) {
+    return mergeRuntimeIdentity(getStationRuntimeIdentity(), {
+        service: process.env.AI_GATEWAY_LOG_SERVICE ?? packageName ?? GATEWAY_LOG_ENV_PREFIX,
         version: process.env.npm_package_version
-    };
+    });
 }
 /**
  * Creates a logger instance based on configuration
@@ -28,13 +26,12 @@ export function createGatewayLogger(config) {
         return createNoOpLogger();
     }
     return createLogxer({
-        packageName: config.packageName || 'AI_GATEWAY',
-        envPrefix: config.packageName || 'AI_GATEWAY',
+        packageName: config.packageName || GATEWAY_LOG_ENV_PREFIX,
+        envPrefix: GATEWAY_LOG_ENV_PREFIX,
         debugNamespace: 'ai-gateway'
     }, {
-        logLevel: 'info',
-        logFormat: 'json',
-        runtimeIdentity: resolveDefaultRuntimeIdentity(config.packageName)
+        // Level/format/sinks: ERC 2.0 env discovery (`AI_GATEWAY_LOGS_LEVEL`, host-level format, …).
+        runtimeIdentity: resolveGatewayRuntimeIdentity(config.packageName)
     });
 }
 function createNoOpLogger() {

package/dist-cjs/logger-factory.d.ts

@@ -4,6 +4,8 @@
  * Creates and configures logxer instances for the gateway
  */
 import { type Logxer } from '@x12i/logxer';
+/** Stable ERC 2.0 env prefix — controls `AI_GATEWAY_LOGS_LEVEL`, etc. */
+export declare const GATEWAY_LOG_ENV_PREFIX = "AI_GATEWAY";
 /**
  * Creates a logger instance based on configuration
  *

package/dist-cjs/openrouter-routing.cjs

@@ -0,0 +1,27 @@
+/**
+ * OpenRouter API key and gateway-level "prefer OpenRouter" flag.
+ * Provider/model routing (openrouter vs vendor) is resolved by @x12i/ai-tools in mergeConfig.
+ */
+export function resolveOpenRouterApiKey(config = {}) {
+    const explicit = config.openrouter?.apiKey;
+    if (typeof explicit === 'string' && explicit.trim() && !explicit.startsWith('ENV.')) {
+        return explicit.trim();
+    }
+    const env = process.env.OPENROUTER_API_KEY?.trim();
+    return env || undefined;
+}
+/**
+ * When true, pass `routeViaOpenRouter: true` into ai-tools resolveModel (prefer OpenRouter even with direct keys).
+ * Default: true when OPENROUTER_API_KEY is set. `USE_OPENROUTER=false` turns this off; ai-tools still falls back
+ * when a vendor API key is missing.
+ */
+export function resolvePreferOpenRouter(config = {}) {
+    if (config.openRouter?.enabled === true)
+        return true;
+    if (config.openRouter?.enabled === false)
+        return false;
+    const env = process.env.USE_OPENROUTER;
+    if (env === 'false' || env === '0')
+        return false;
+    return !!resolveOpenRouterApiKey(config);
+}

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

@@ -0,0 +1,12 @@
+/**
+ * OpenRouter API key and gateway-level "prefer OpenRouter" flag.
+ * Provider/model routing (openrouter vs vendor) is resolved by @x12i/ai-tools in mergeConfig.
+ */
+import type { GatewayConfig } from './types.js';
+export declare function resolveOpenRouterApiKey(config?: GatewayConfig): string | undefined;
+/**
+ * When true, pass `routeViaOpenRouter: true` into ai-tools resolveModel (prefer OpenRouter even with direct keys).
+ * Default: true when OPENROUTER_API_KEY is set. `USE_OPENROUTER=false` turns this off; ai-tools still falls back
+ * when a vendor API key is missing.
+ */
+export declare function resolvePreferOpenRouter(config?: GatewayConfig): boolean;

package/dist-cjs/runtime-objects.d.ts

@@ -1,25 +1,8 @@
 import type { Logxer } from '@x12i/logxer';
 import type { Activix, ActivixQueryableClient } from '@x12i/activix';
 export type { ActivixQueryableClient } from '@x12i/activix';
-export type LogxerQueryableClient = {
-    getJobLogs(input: {
-        jobId: string;
-        graphId?: string;
-        nodeId?: string;
-        limit?: number;
-    }): Promise<{
-        jobId: string;
-        lines: Array<{
-            ts?: number | string;
-            level?: 'debug' | 'info' | 'warn' | 'error';
-            scope?: string;
-            packageName?: string;
-            nodeId?: string;
-            message: string;
-            data?: unknown;
-        }>;
-    }>;
-};
+export type { GetJobLogsInput, GetJobLogsResult } from '@x12i/logxer';
+export type LogxerQueryableClient = Pick<Logxer, 'getJobLogs'>;
 export type PackageRuntimeObjects = {
     name: string;
     activixClient?: ActivixQueryableClient;

package/dist-cjs/types.d.ts

@@ -375,10 +375,13 @@ export interface GatewayConfig extends Omit<RouterConfig, 'defaultEngine' | 'log
         apiKey: string;
     };
     /**
-     * Enable OpenRouter mode. When omitted, the gateway uses process.env.USE_OPENROUTER or enables when a key is set.
+     * OpenRouter preference (not a hard off-switch when {@link openrouter}.apiKey or OPENROUTER_API_KEY is set).
+     * - `enabled: true` or omitted with OPENROUTER_API_KEY: prefer OpenRouter even when direct provider keys exist.
+     * - `enabled: false` or USE_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;
     };
     /**
      * Operational mode override (`process.env.mode` / `MODE` when omitted).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/ai-gateway",
-  "version": "9.6.3",
+  "version": "9.6.7",
   "description": "AI Gateway - Unified interface for LLM provider routing and management",
   "type": "module",
   "exports": {
@@ -41,12 +41,12 @@
   "author": "x12i",
   "license": "mit",
   "dependencies": {
-    "@x12i/activix": "^8.3.0",
-    "@x12i/ai-providers-router": "^4.8.5",
-    "@x12i/ai-tools": "^2.0.7",
+    "@x12i/activix": "^8.3.1",
+    "@x12i/ai-providers-router": "^4.8.6",
+    "@x12i/ai-tools": "^2.1.2",
     "@x12i/flex-md": "^4.8.0",
     "@x12i/logxer": "^4.4.0",
-    "@x12i/optimixer": "^2.4.0",
+    "@x12i/optimixer": "^2.4.1",
     "@x12i/rendrix": "^4.3.0"
   },
   "devDependencies": {