@oxy.so/core 4.0.0 → 4.1.0

package/dist/cjs/inference/OxyInferenceClient.js

@@ -65,6 +65,7 @@ var _OxyInferenceClient_instances, _OxyInferenceClient_baseURL, _OxyInferenceCli
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OxyInferenceClient = exports.OxyInferenceProtocolError = exports.OxyInferenceError = exports.OXY_INFERENCE_BASE_URL = void 0;
 const contracts_1 = require("@oxy.so/contracts");
+const contracts_2 = require("@oxy.so/contracts");
 /** The base URL of the Oxy API, when a caller names none. */
 exports.OXY_INFERENCE_BASE_URL = 'https://api.oxy.so';
 /**
@@ -175,7 +176,7 @@ class OxyInferenceClient {
      *   "no such model".
      */
     async getModel(modelId, options = {}) {
-        const parsed = contracts_1.modelIdSchema.safeParse(modelId);
+        const parsed = contracts_2.modelIdSchema.safeParse(modelId);
         if (!parsed.success) {
             throw new Error(`Not a canonical model id: ${modelId}. Expected <publisher>/<model>, e.g. acme/some-model.`);
         }
@@ -212,6 +213,23 @@ class OxyInferenceClient {
                 : { delegatedUserId: options.delegatedUserId }),
         });
     }
+    /** Typed nonstreaming decisions. Idempotency conflicts are never replayed or retried. */
+    async decide(request, options = {}) {
+        const input = contracts_1.decisionRequestSchema.parse(request);
+        const payload = await __classPrivateFieldGet(this, _OxyInferenceClient_instances, "m", _OxyInferenceClient_request).call(this, 'POST', '/v1/decisions', {
+            body: input,
+            bindRequestId: true,
+            signal: options.signal,
+            idempotencyKey: options.idempotencyKey,
+            delegatedUserId: options.delegatedUserId,
+        });
+        const parsed = contracts_1.decisionSuccessSchema.safeParse(payload);
+        if (!parsed.success || parsed.data.model !== input.model ||
+            !(0, contracts_1.decisionAnswersMatch)(input, parsed.data.data)) {
+            throw new OxyInferenceProtocolError('Invalid or mismatched decisions response.');
+        }
+        return parsed.data;
+    }
     /** Generate audio bytes through Oxy's authenticated inference edge. */
     async speech(request, options = {}) {
         const response = await __classPrivateFieldGet(this, _OxyInferenceClient_fetch, "f").call(this, `${__classPrivateFieldGet(this, _OxyInferenceClient_baseURL, "f")}/v1/audio/speech`, {
@@ -232,7 +250,7 @@ class OxyInferenceClient {
         if (!response.ok) {
             throw toInferenceError(await response.json().catch(() => undefined), response.status, requestId);
         }
-        const mediaType = contracts_1.inferenceAudioMediaTypeSchema.safeParse(mediaTypeOf(response));
+        const mediaType = contracts_2.inferenceAudioMediaTypeSchema.safeParse(mediaTypeOf(response));
         if (!mediaType.success || !response.body) {
             await cancelUnreadResponse(response);
             throw protocolError('The inference API returned no supported audio body.', requestId);
@@ -249,7 +267,7 @@ class OxyInferenceClient {
                     break;
                 }
                 size += next.value.byteLength;
-                if (size > contracts_1.MAX_INFERENCE_AUDIO_BYTES)
+                if (size > contracts_2.MAX_INFERENCE_AUDIO_BYTES)
                     throw protocolError('The inference audio exceeds the response limit.', requestId);
                 chunks.push(next.value);
             }
@@ -332,7 +350,7 @@ class OxyInferenceClient {
             catch (_error) {
                 throw protocolError(`The inference API sent a ${frame.name || 'unnamed'} SSE event that is not JSON.`, requestId);
             }
-            const parsed = contracts_1.inferenceStreamEventSchema.safeParse(payload);
+            const parsed = contracts_2.inferenceStreamEventSchema.safeParse(payload);
             if (!parsed.success) {
                 const path = parsed.error.issues[0]?.path;
                 throw protocolError(`The inference API sent an event outside the published stream contract at ${path === undefined || path.length === 0 ? 'an unknown field' : path.join('.')}.`, requestId);
@@ -428,6 +446,13 @@ async function _OxyInferenceClient_request(method, path, options) {
     if (!response.ok) {
         throw toInferenceError(payload, response.status, response.headers.get('X-Oxy-Request-Id'));
     }
+    if (options.bindRequestId) {
+        const requestId = response.headers.get('X-Oxy-Request-Id');
+        if (!requestId || typeof payload !== 'object' || payload === null ||
+            !('requestId' in payload) || payload.requestId !== requestId) {
+            throw new OxyInferenceProtocolError('Decisions response request ID does not match its header.', requestId ?? undefined);
+        }
+    }
     return payload;
 };
 /** Bound one public SSE event before parsing it as JSON. */
@@ -574,7 +599,7 @@ const STATUS_FALLBACK_CODE = {
  * together — so an unrecognised one falls back to the status map instead of
  * being asserted into the type.
  */
-const INFERENCE_ERROR_CODE_SET = new Set(contracts_1.INFERENCE_ERROR_CODES);
+const INFERENCE_ERROR_CODE_SET = new Set(contracts_2.INFERENCE_ERROR_CODES);
 /** Read whichever error shape arrived into the one this client throws. */
 function toInferenceError(payload, status, requestIdHeader) {
     const body = (payload ?? {});

package/dist/esm/inference/OxyInferenceClient.js

@@ -61,6 +61,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
 var _OxyInferenceClient_instances, _OxyInferenceClient_baseURL, _OxyInferenceClient_credential, _OxyInferenceClient_fetch, _OxyInferenceClient_bearer, _OxyInferenceClient_headers, _OxyInferenceClient_request;
+import { decisionRequestSchema, decisionSuccessSchema, decisionAnswersMatch } from '@oxy.so/contracts';
 import { INFERENCE_ERROR_CODES, MAX_INFERENCE_AUDIO_BYTES, inferenceAudioMediaTypeSchema, inferenceStreamEventSchema, modelIdSchema, } from '@oxy.so/contracts';
 /** The base URL of the Oxy API, when a caller names none. */
 export const OXY_INFERENCE_BASE_URL = 'https://api.oxy.so';
@@ -207,6 +208,23 @@ export class OxyInferenceClient {
                 : { delegatedUserId: options.delegatedUserId }),
         });
     }
+    /** Typed nonstreaming decisions. Idempotency conflicts are never replayed or retried. */
+    async decide(request, options = {}) {
+        const input = decisionRequestSchema.parse(request);
+        const payload = await __classPrivateFieldGet(this, _OxyInferenceClient_instances, "m", _OxyInferenceClient_request).call(this, 'POST', '/v1/decisions', {
+            body: input,
+            bindRequestId: true,
+            signal: options.signal,
+            idempotencyKey: options.idempotencyKey,
+            delegatedUserId: options.delegatedUserId,
+        });
+        const parsed = decisionSuccessSchema.safeParse(payload);
+        if (!parsed.success || parsed.data.model !== input.model ||
+            !decisionAnswersMatch(input, parsed.data.data)) {
+            throw new OxyInferenceProtocolError('Invalid or mismatched decisions response.');
+        }
+        return parsed.data;
+    }
     /** Generate audio bytes through Oxy's authenticated inference edge. */
     async speech(request, options = {}) {
         const response = await __classPrivateFieldGet(this, _OxyInferenceClient_fetch, "f").call(this, `${__classPrivateFieldGet(this, _OxyInferenceClient_baseURL, "f")}/v1/audio/speech`, {
@@ -422,6 +440,13 @@ async function _OxyInferenceClient_request(method, path, options) {
     if (!response.ok) {
         throw toInferenceError(payload, response.status, response.headers.get('X-Oxy-Request-Id'));
     }
+    if (options.bindRequestId) {
+        const requestId = response.headers.get('X-Oxy-Request-Id');
+        if (!requestId || typeof payload !== 'object' || payload === null ||
+            !('requestId' in payload) || payload.requestId !== requestId) {
+            throw new OxyInferenceProtocolError('Decisions response request ID does not match its header.', requestId ?? undefined);
+        }
+    }
     return payload;
 };
 /** Bound one public SSE event before parsing it as JSON. */

package/dist/types/inference/OxyInferenceClient.d.ts

@@ -49,6 +49,7 @@
  * schema, so a rename on either side fails a build rather than a customer's
  * request.
  */
+import { type DecisionRequest, type DecisionSuccess } from '@oxy.so/contracts';
 import type { CurrencyCode, ExactDecimal, InferenceEnvironment, InferenceErrorCode, InferenceFinishReason, InferenceMessage, InferenceReasoning, InferenceRequestOutcome, InferenceAudioMediaType, InferenceStreamEvent, InferenceSpeechParameters, ModelCatalogueEntry, ResponseFormat, RoutingPolicyReference, RoutingProfile, ToolChoice, ToolDefinition, UnitPrice, UsageQuantity, UsageSource } from '@oxy.so/contracts';
 /** The base URL of the Oxy API, when a caller names none. */
 export declare const OXY_INFERENCE_BASE_URL = "https://api.oxy.so";
@@ -336,6 +337,8 @@ export declare class OxyInferenceClient {
      *   `code`, `retryable` and `requestId`.
      */
     respond(request: OxyResponsesRequest, options?: OxyInferenceRequestOptions): Promise<OxyInferenceResponse>;
+    /** Typed nonstreaming decisions. Idempotency conflicts are never replayed or retried. */
+    decide(request: DecisionRequest, options?: OxyInferenceRequestOptions): Promise<DecisionSuccess>;
     /** Generate audio bytes through Oxy's authenticated inference edge. */
     speech(request: OxySpeechRequest, options?: OxyInferenceRequestOptions): Promise<OxySpeechResponse>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxy.so/core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "OxyHQ SDK Foundation — API client, authentication, cryptographic identity, and shared utilities",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -179,8 +179,8 @@
     "@oxy.so/telemetry": "^1.2.0",
     "@noble/ciphers": "^1.3.0",
     "@noble/hashes": "^1.8.0",
-    "@oxy.so/contracts": "^4.4.0",
-    "@oxy.so/protocol": "^1.2.0",
+    "@oxy.so/contracts": "^4.7.0",
+    "@oxy.so/protocol": "^1.2.1",
     "@scure/bip39": "^1.6.0",
     "buffer": "^6.0.3",
     "express-rate-limit": "^8.6.0",

package/src/inference/OxyInferenceClient.ts

@@ -50,6 +50,8 @@
  * request.
  */
 
+import { decisionRequestSchema, decisionSuccessSchema, decisionAnswersMatch, type DecisionRequest, type DecisionSuccess } from '@oxy.so/contracts';
+
 import type {
     CurrencyCode,
     ExactDecimal,
@@ -471,6 +473,27 @@ export class OxyInferenceClient {
         });
     }
 
+    /** Typed nonstreaming decisions. Idempotency conflicts are never replayed or retried. */
+    async decide(
+        request: DecisionRequest,
+        options: OxyInferenceRequestOptions = {},
+    ): Promise<DecisionSuccess> {
+        const input = decisionRequestSchema.parse(request);
+        const payload = await this.#request<unknown>('POST', '/v1/decisions', {
+            body: input,
+            bindRequestId: true,
+            signal: options.signal,
+            idempotencyKey: options.idempotencyKey,
+            delegatedUserId: options.delegatedUserId,
+        });
+        const parsed = decisionSuccessSchema.safeParse(payload);
+        if (!parsed.success || parsed.data.model !== input.model ||
+            !decisionAnswersMatch(input, parsed.data.data)) {
+            throw new OxyInferenceProtocolError('Invalid or mismatched decisions response.');
+        }
+        return parsed.data;
+    }
+
     /** Generate audio bytes through Oxy's authenticated inference edge. */
     async speech(
         request: OxySpeechRequest,
@@ -728,6 +751,7 @@ export class OxyInferenceClient {
         path: string,
         options: {
             body?: unknown;
+            bindRequestId?: boolean;
             signal?: AbortSignal;
             idempotencyKey?: string;
             delegatedUserId?: string;
@@ -758,6 +782,13 @@ export class OxyInferenceClient {
             );
         }
 
+        if (options.bindRequestId) {
+            const requestId = response.headers.get('X-Oxy-Request-Id');
+            if (!requestId || typeof payload !== 'object' || payload === null ||
+                !('requestId' in payload) || payload.requestId !== requestId) {
+                throw new OxyInferenceProtocolError('Decisions response request ID does not match its header.', requestId ?? undefined);
+            }
+        }
         return payload as T;
     }
 }