@x12i/ai-gateway 7.9.2 → 9.0.0

package/dist-cjs/troubleshooting-helper.cjs

@@ -600,12 +600,12 @@ function formatDiagnostic(diagnostic) {
 /**
  * Quick validation helper - throws if invalid
  */
-function assertValidAIRequest(request) {
+function assertValidAIRequest(request, logger) {
     const validation = validateAIRequest(request);
     if (!validation.valid) {
         throw new Error(`AIRequest validation failed:\n${validation.errors.join('\n')}`);
     }
     if (validation.warnings.length > 0) {
-        console.warn('AIRequest validation warnings:', validation.warnings);
+        logger?.warn('AIRequest validation warnings', { warnings: validation.warnings });
     }
 }

package/dist-cjs/troubleshooting-helper.d.ts

@@ -120,4 +120,4 @@ export declare function formatDiagnostic(diagnostic: DiagnosticInfo): string;
 /**
  * Quick validation helper - throws if invalid
  */
-export declare function assertValidAIRequest(request: Partial<AIRequest>): void;
+export declare function assertValidAIRequest(request: Partial<AIRequest>, logger?: import('@x12i/logxer').Logxer): void;

package/dist-cjs/types.d.ts

@@ -32,11 +32,18 @@ export type ActivityIdentity = {
     };
     /** Gateway-level request correlation ID. */
     aiRequestId: string;
-    /** @deprecated Use aiRequestId. Kept only for backward compatibility. */
-    jobId?: string;
+    /**
+     * Upstream job identifier — must be supplied on `request.identity` only.
+     * The gateway copies this value as-is; it never generates or mutates it.
+     */
+    jobId: string;
     jobTypeId?: string;
     agentId: string;
-    taskId?: string;
+    /**
+     * Upstream task identifier — must be supplied on `request.identity` only.
+     * The gateway copies this value as-is; it never generates or mutates it.
+     */
+    taskId: string;
     taskTypeId?: string;
     /** Graph/node linkage (optional, used by activity identity grouping). */
     graphId?: string;
@@ -413,7 +420,7 @@ export interface GatewayConfig extends Omit<RouterConfig, 'defaultEngine' | 'log
  * Extends LLMRequest but omits 'messages' and 'input' to allow custom message handling
  * and make input optional (router may require it, but gateway allows it to be optional)
  */
-interface BaseLLMRequest extends Omit<LLMRequest, 'messages' | 'input'> {
+interface BaseLLMRequest extends Omit<LLMRequest, 'messages' | 'input' | 'request' | 'mode'> {
     /**
      * AI request ID - Required for all invocations and activity tracking
      */
@@ -422,15 +429,14 @@ interface BaseLLMRequest extends Omit<LLMRequest, 'messages' | 'input'> {
     jobId?: string;
     /**
      * Optional top-level run/session id for Activix. Prefer `identity.sessionId`; if both are set they must match.
-     * When omitted, `ActivityManager` resolves session from `identity.sessionId`, then `jobId`, then `aiRequestId`.
+     * When omitted, `ActivityManager` resolves session from `identity.sessionId`, then `identity.jobId`, then `aiRequestId`.
      */
     sessionId?: string;
     /**
-     * Optional identity object used for upstream linkage (forwarded through the request).
-     * May be partial; may include product-specific keys beyond `ActivityIdentity`. When omitted,
-     * the gateway normalizes and attaches a full envelope (`ensureGatewayRequestIdentity` / activity tracking).
+     * Mandatory runtime identity from the upstream client (job/task correlation, Activix `runContext`).
+     * Must include at least `jobId` and `taskId` as non-empty strings; the gateway never invents these.
      */
-    identity?: ActivityIdentity & Record<string, unknown>;
+    identity: ActivityIdentity & Record<string, unknown>;
     /**
      * Job type ID (optional) - Short ID or hash to identify recurring job types
      * Best practice: Use MD5 hash of the job type string for consistent job identification
@@ -459,7 +465,7 @@ interface BaseLLMRequest extends Omit<LLMRequest, 'messages' | 'input'> {
      */
     instructions: string;
     /**
-     * Task ID (optional)
+     * @deprecated Prefer `identity.taskId`. The gateway does not copy this into `identity`.
      */
     taskId?: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/ai-gateway",
-  "version": "7.9.2",
+  "version": "9.0.0",
   "description": "AI Gateway - Unified interface for LLM provider routing and management",
   "type": "module",
   "exports": {
@@ -64,8 +64,8 @@
     "@x12i/rendrix": "^4.2.0",
     "@aws-sdk/s3-request-presigner": "^3.953.0",
     "@x12i/env": "^4.0.1",
-    "@x12i/logxer": "^4.0.2",
-    "@x12i/activix": "^6.5.0",
+    "@x12i/logxer": "^4.2.1",
+    "@x12i/activix": "^6.5.1",
     "@x12i/flex-md": "^4.8.0"
   },
   "devDependencies": {