@oxy.so/contracts 1.3.0 → 1.5.0

package/dist/types/index.d.ts

@@ -78,16 +78,16 @@ export { embeddingVectorSchema, embeddingUsageSchema, embeddingSuccessSchema, em
 export type { EmbeddingVector, EmbeddingUsage, EmbeddingSuccess, EmbeddingFailure, EmbeddingResponse, } from './inference/embeddings';
 export { priceVersionStatusSchema, priceVersionSchema, priceSnapshotSchema, } from './inference/priceVersion';
 export type { PriceVersionStatus, PriceVersion, PriceSnapshot } from './inference/priceVersion';
-export { inferenceModalitySchema, modelCapabilitiesSchema, modelLicenseSchema, modelProvenanceSchema, inferenceDataPolicySchema, availabilityScopeSchema, commercialPermissionSchema, modelDeprecationSchema, modelEvaluationResultSchema, modelSafetyMetadataSchema, modelPublisherSchema, catalogueModelSchema, modelRevisionSchema, inferenceProviderSchema, modelDeploymentSchema, routingProfileCandidateSchema, routingProfileSchema, cataloguePublisherSummarySchema, catalogueServingProviderSummarySchema, modelCatalogueEntrySchema, } from './inference/catalogue';
-export type { InferenceModality, ModelCapabilities, ModelLicense, ModelProvenance, InferenceDataPolicy, AvailabilityScope, CommercialPermission, ModelDeprecation, ModelEvaluationResult, ModelSafetyMetadata, ModelPublisher, CatalogueModel, ModelRevision, InferenceProvider, ModelDeployment, RoutingProfileCandidate, RoutingProfile, CataloguePublisherSummary, CatalogueServingProviderSummary, ModelCatalogueEntry, } from './inference/catalogue';
+export { inferenceModalitySchema, reasoningEffortSchema, modelCapabilitiesSchema, modelLicenseSchema, modelProvenanceSchema, inferenceDataPolicySchema, availabilityScopeSchema, commercialPermissionSchema, modelDeprecationSchema, modelEvaluationResultSchema, modelSafetyMetadataSchema, modelPublisherSchema, catalogueModelSchema, modelRevisionSchema, inferenceProviderSchema, modelDeploymentSchema, routingProfileCandidateSchema, routingProfileSchema, cataloguePublisherSummarySchema, catalogueServingProviderSummarySchema, modelCatalogueEntrySchema, } from './inference/catalogue';
+export type { InferenceModality, ReasoningEffort, ModelCapabilities, ModelLicense, ModelProvenance, InferenceDataPolicy, AvailabilityScope, CommercialPermission, ModelDeprecation, ModelEvaluationResult, ModelSafetyMetadata, ModelPublisher, CatalogueModel, ModelRevision, InferenceProvider, ModelDeployment, RoutingProfileCandidate, RoutingProfile, CataloguePublisherSummary, CatalogueServingProviderSummary, ModelCatalogueEntry, } from './inference/catalogue';
 export { routingTargetSchema, routingPolicyScopeSchema, routingFallbackPolicySchema, routingPolicySchema, routingPolicyReferenceSchema, authorizedRouteSchema, } from './inference/routingPolicy';
 export type { RoutingTarget, RoutingPolicyScope, RoutingFallbackPolicy, RoutingPolicy, RoutingPolicyReference, AuthorizedRoute, } from './inference/routingPolicy';
 export { aliaReleaseArtifactSchema, aliaReleaseSignatureSchema, aliaModelReleaseManifestSchema, } from './inference/aliaModelRelease';
 export type { AliaReleaseArtifact, AliaReleaseSignature, AliaModelReleaseManifest, } from './inference/aliaModelRelease';
 export { modelDistributionMethodSchema, modelSystemicRiskTierSchema, trainingComputeFlopsSchema, SYSTEMIC_RISK_COMPUTE_THRESHOLD_FLOPS, modelDownstreamDocumentationSchema, modelGpaiDocumentationSchema, modelLineDeclarationSchema, modelReleaseIngestionRequestSchema, modelReleaseIngestionResultSchema, modelDocumentationSchema, } from './inference/modelDocumentation';
 export type { ModelDistributionMethod, ModelSystemicRiskTier, ModelDownstreamDocumentation, ModelGpaiDocumentation, ModelLineDeclaration, ModelReleaseIngestionRequest, ModelReleaseIngestionResult, ModelDocumentation, } from './inference/modelDocumentation';
-export { inferenceContentSourceSchema, inferenceContentPartSchema, inferenceToolCallSchema, inferenceMessageRoleSchema, inferenceMessageSchema, inferenceInputSchema, samplingParametersSchema, toolDefinitionSchema, toolChoiceSchema, responseFormatSchema, clientRequestMetadataSchema, inferenceRequestSchema, inferenceSpeechParametersSchema, } from './inference/request';
-export type { InferenceContentSource, InferenceContentPart, InferenceToolCall, InferenceMessageRole, InferenceMessage, InferenceInput, SamplingParameters, ToolDefinition, ToolChoice, ResponseFormat, ClientRequestMetadata, InferenceRequest, InferenceSpeechParameters, } from './inference/request';
+export { inferenceContentSourceSchema, inferenceContentPartSchema, inferenceToolCallSchema, inferenceMessageRoleSchema, inferenceMessageSchema, inferenceInputSchema, samplingParametersSchema, inferenceReasoningSchema, toolDefinitionSchema, toolChoiceSchema, responseFormatSchema, clientRequestMetadataSchema, inferenceRequestSchema, inferenceSpeechParametersSchema, } from './inference/request';
+export type { InferenceContentSource, InferenceContentPart, InferenceToolCall, InferenceMessageRole, InferenceMessage, InferenceInput, SamplingParameters, InferenceReasoning, ToolDefinition, ToolChoice, ResponseFormat, ClientRequestMetadata, InferenceRequest, InferenceSpeechParameters, } from './inference/request';
 export { inferenceStreamStartEventSchema, inferenceStreamDeltaEventSchema, inferenceAudioMediaTypeSchema, MAX_INFERENCE_AUDIO_BYTES, inferenceStreamAudioEventSchema, inferenceStreamToolCallEventSchema, inferenceStreamUsageEventSchema, inferenceRouteSwitchDetailSchema, inferenceRouteSwitchReasonSchema, inferenceStreamRouteSwitchEventSchema, inferenceStreamErrorEventSchema, inferenceFinishReasonSchema, inferenceStreamDoneEventSchema, inferenceStreamEventSchema, } from './inference/streamEvents';
 export type { InferenceStreamStartEvent, InferenceStreamDeltaEvent, InferenceAudioMediaType, InferenceStreamAudioEvent, InferenceStreamToolCallEvent, InferenceStreamUsageEvent, InferenceRouteSwitchDetail, InferenceRouteSwitchReason, InferenceStreamRouteSwitchEvent, InferenceStreamErrorEvent, InferenceFinishReason, InferenceStreamDoneEvent, InferenceStreamEvent, } from './inference/streamEvents';
 export { usageReservationRequestSchema, usageReservationStatusSchema, usageReservationSchema, inferenceRequestOutcomeSchema, normalizedUsageReportSchema, usageReceiptSchema, usageRefundSubjectSchema, usageRefundReasonSchema, usageRefundSchema, } from './inference/usage';
@@ -105,3 +105,5 @@ export type { EmailContextAddress, EmailContextMailbox, EmailContextMessage, Ema
 export { inboxComposeRequestSchema, inboxDailyBriefRequestSchema, inboxNaturalSearchRequestSchema, inboxMessageInferenceParamsSchema, inboxInferenceTextResponseSchema, inboxNaturalSearchResponseSchema, inboxSmartRepliesResponseSchema, inboxThreadSummaryResponseSchema, inboxInferenceStreamEventSchema, } from './inference/inbox';
 export type { InboxComposeRequest, InboxDailyBriefRequest, InboxInferenceTextResponse, InboxNaturalSearchResponse, InboxSmartRepliesResponse, InboxThreadSummaryResponse, InboxInferenceStreamEvent, } from './inference/inbox';
 export * from './externalIdentity';
+export * from './linkedAccounts';
+export * from './notifications';

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

@@ -29,6 +29,15 @@
 import { z } from 'zod';
 /** The modalities a model can consume or produce. */
 export declare const inferenceModalitySchema: z.ZodEnum<["text", "image", "audio", "video", "embedding"]>;
+/**
+ * How hard a reasoning model is asked to think before it answers.
+ *
+ * A closed, provider-neutral vocabulary: Kaana translates each value into the
+ * serving provider's own control. A model advertises the subset it accepts in
+ * `modelCapabilitiesSchema.reasoningEfforts`, and Oxy refuses a request for an
+ * effort the resolved model does not advertise rather than dropping it.
+ */
+export declare const reasoningEffortSchema: z.ZodEnum<["low", "medium", "high"]>;
 /**
  * What a model can do, in the terms a caller has to decide against before
  * sending a request: can it call tools, does it accept images, will it honour a
@@ -42,6 +51,13 @@ export declare const modelCapabilitiesSchema: z.ZodObject<{
     structuredOutput: z.ZodBoolean;
     jsonMode: z.ZodBoolean;
     reasoning: z.ZodBoolean;
+    /**
+     * The reasoning efforts a request may name for this model, in the order
+     * low → high. Empty means the model takes no effort control at all (it may
+     * still reason: `reasoning` answers that). Added in contract set 3.1.0;
+     * absent on the wire from an older producer, it parses as `[]`.
+     */
+    reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<["low", "medium", "high"]>, "many">>;
     streaming: z.ZodBoolean;
     promptCaching: z.ZodBoolean;
     maxContextTokens: z.ZodNumber;
@@ -54,6 +70,7 @@ export declare const modelCapabilitiesSchema: z.ZodObject<{
     structuredOutput: boolean;
     jsonMode: boolean;
     reasoning: boolean;
+    reasoningEfforts: ("low" | "medium" | "high")[];
     streaming: boolean;
     promptCaching: boolean;
     maxContextTokens: number;
@@ -70,6 +87,7 @@ export declare const modelCapabilitiesSchema: z.ZodObject<{
     promptCaching: boolean;
     maxContextTokens: number;
     maxOutputTokens: number;
+    reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
 }>;
 /**
  * License terms, including the two questions that decide whether Oxy may serve
@@ -289,6 +307,13 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         structuredOutput: z.ZodBoolean;
         jsonMode: z.ZodBoolean;
         reasoning: z.ZodBoolean;
+        /**
+         * The reasoning efforts a request may name for this model, in the order
+         * low → high. Empty means the model takes no effort control at all (it may
+         * still reason: `reasoning` answers that). Added in contract set 3.1.0;
+         * absent on the wire from an older producer, it parses as `[]`.
+         */
+        reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<["low", "medium", "high"]>, "many">>;
         streaming: z.ZodBoolean;
         promptCaching: z.ZodBoolean;
         maxContextTokens: z.ZodNumber;
@@ -301,6 +326,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         structuredOutput: boolean;
         jsonMode: boolean;
         reasoning: boolean;
+        reasoningEfforts: ("low" | "medium" | "high")[];
         streaming: boolean;
         promptCaching: boolean;
         maxContextTokens: number;
@@ -317,6 +343,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
+        reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
     }>;
     license: z.ZodObject<{
         /** SPDX identifier where one exists, otherwise the publisher's own name. */
@@ -395,6 +422,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         structuredOutput: boolean;
         jsonMode: boolean;
         reasoning: boolean;
+        reasoningEfforts: ("low" | "medium" | "high")[];
         streaming: boolean;
         promptCaching: boolean;
         maxContextTokens: number;
@@ -441,6 +469,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
+        reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
     };
     schemaVersion: 1;
     slug: string;
@@ -479,6 +508,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         structuredOutput: boolean;
         jsonMode: boolean;
         reasoning: boolean;
+        reasoningEfforts: ("low" | "medium" | "high")[];
         streaming: boolean;
         promptCaching: boolean;
         maxContextTokens: number;
@@ -525,6 +555,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
+        reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
     };
     schemaVersion: 1;
     slug: string;
@@ -1127,6 +1158,13 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         structuredOutput: z.ZodBoolean;
         jsonMode: z.ZodBoolean;
         reasoning: z.ZodBoolean;
+        /**
+         * The reasoning efforts a request may name for this model, in the order
+         * low → high. Empty means the model takes no effort control at all (it may
+         * still reason: `reasoning` answers that). Added in contract set 3.1.0;
+         * absent on the wire from an older producer, it parses as `[]`.
+         */
+        reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<["low", "medium", "high"]>, "many">>;
         streaming: z.ZodBoolean;
         promptCaching: z.ZodBoolean;
         maxContextTokens: z.ZodNumber;
@@ -1139,6 +1177,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         structuredOutput: boolean;
         jsonMode: boolean;
         reasoning: boolean;
+        reasoningEfforts: ("low" | "medium" | "high")[];
         streaming: boolean;
         promptCaching: boolean;
         maxContextTokens: number;
@@ -1155,6 +1194,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
+        reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
     }>;
     license: z.ZodObject<{
         /** SPDX identifier where one exists, otherwise the publisher's own name. */
@@ -1195,6 +1235,12 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
     }>;
     knowledgeCutoff: z.ZodOptional<z.ZodString>;
     releasedOn: z.ZodOptional<z.ZodString>;
+    /**
+     * When the upstream provider first published this model, as that provider
+     * reports it. Present only when a provider reported it; never an Oxy or Kaana
+     * observation time. Lets a picker order models newest first.
+     */
+    releasedAt: z.ZodOptional<z.ZodString>;
     regions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     servingProviders: z.ZodDefault<z.ZodArray<z.ZodObject<{
         slug: z.ZodString;
@@ -1418,6 +1464,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         structuredOutput: boolean;
         jsonMode: boolean;
         reasoning: boolean;
+        reasoningEfforts: ("low" | "medium" | "high")[];
         streaming: boolean;
         promptCaching: boolean;
         maxContextTokens: number;
@@ -1483,6 +1530,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
     description?: string | undefined;
     knowledgeCutoff?: string | undefined;
     releasedOn?: string | undefined;
+    releasedAt?: string | undefined;
     modelCardUrl?: string | undefined;
     safety?: {
         contentFilteringDefault: "strict" | "none" | "provider_default";
@@ -1516,6 +1564,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
+        reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
     };
     schemaVersion: 3;
     modelId: string;
@@ -1556,6 +1605,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
     description?: string | undefined;
     knowledgeCutoff?: string | undefined;
     releasedOn?: string | undefined;
+    releasedAt?: string | undefined;
     modelCardUrl?: string | undefined;
     evaluations?: {
         score: string;
@@ -1598,6 +1648,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
     } | undefined;
 }>;
 export type InferenceModality = z.infer<typeof inferenceModalitySchema>;
+export type ReasoningEffort = z.infer<typeof reasoningEffortSchema>;
 export type ModelCapabilities = z.infer<typeof modelCapabilitiesSchema>;
 export type ModelLicense = z.infer<typeof modelLicenseSchema>;
 export type ModelProvenance = z.infer<typeof modelProvenanceSchema>;

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

@@ -334,6 +334,7 @@ export declare const modelLineDeclarationSchema: z.ZodObject<{
         structuredOutput: z.ZodBoolean;
         jsonMode: z.ZodBoolean;
         reasoning: z.ZodBoolean;
+        reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<["low", "medium", "high"]>, "many">>;
         streaming: z.ZodBoolean;
         promptCaching: z.ZodBoolean;
         maxContextTokens: z.ZodNumber;
@@ -346,6 +347,7 @@ export declare const modelLineDeclarationSchema: z.ZodObject<{
         structuredOutput: boolean;
         jsonMode: boolean;
         reasoning: boolean;
+        reasoningEfforts: ("low" | "medium" | "high")[];
         streaming: boolean;
         promptCaching: boolean;
         maxContextTokens: number;
@@ -362,6 +364,7 @@ export declare const modelLineDeclarationSchema: z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
+        reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
     }>;
     knowledgeCutoff: z.ZodOptional<z.ZodString>;
     releasedOn: z.ZodOptional<z.ZodString>;
@@ -375,6 +378,7 @@ export declare const modelLineDeclarationSchema: z.ZodObject<{
         structuredOutput: boolean;
         jsonMode: boolean;
         reasoning: boolean;
+        reasoningEfforts: ("low" | "medium" | "high")[];
         streaming: boolean;
         promptCaching: boolean;
         maxContextTokens: number;
@@ -397,6 +401,7 @@ export declare const modelLineDeclarationSchema: z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
+        reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
     };
     description?: string | undefined;
     knowledgeCutoff?: string | undefined;
@@ -957,6 +962,7 @@ export declare const modelReleaseIngestionRequestSchema: z.ZodObject<{
             structuredOutput: z.ZodBoolean;
             jsonMode: z.ZodBoolean;
             reasoning: z.ZodBoolean;
+            reasoningEfforts: z.ZodDefault<z.ZodArray<z.ZodEnum<["low", "medium", "high"]>, "many">>;
             streaming: z.ZodBoolean;
             promptCaching: z.ZodBoolean;
             maxContextTokens: z.ZodNumber;
@@ -969,6 +975,7 @@ export declare const modelReleaseIngestionRequestSchema: z.ZodObject<{
             structuredOutput: boolean;
             jsonMode: boolean;
             reasoning: boolean;
+            reasoningEfforts: ("low" | "medium" | "high")[];
             streaming: boolean;
             promptCaching: boolean;
             maxContextTokens: number;
@@ -985,6 +992,7 @@ export declare const modelReleaseIngestionRequestSchema: z.ZodObject<{
             promptCaching: boolean;
             maxContextTokens: number;
             maxOutputTokens: number;
+            reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
         }>;
         knowledgeCutoff: z.ZodOptional<z.ZodString>;
         releasedOn: z.ZodOptional<z.ZodString>;
@@ -998,6 +1006,7 @@ export declare const modelReleaseIngestionRequestSchema: z.ZodObject<{
             structuredOutput: boolean;
             jsonMode: boolean;
             reasoning: boolean;
+            reasoningEfforts: ("low" | "medium" | "high")[];
             streaming: boolean;
             promptCaching: boolean;
             maxContextTokens: number;
@@ -1020,6 +1029,7 @@ export declare const modelReleaseIngestionRequestSchema: z.ZodObject<{
             promptCaching: boolean;
             maxContextTokens: number;
             maxOutputTokens: number;
+            reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
         };
         description?: string | undefined;
         knowledgeCutoff?: string | undefined;
@@ -1037,6 +1047,7 @@ export declare const modelReleaseIngestionRequestSchema: z.ZodObject<{
             structuredOutput: boolean;
             jsonMode: boolean;
             reasoning: boolean;
+            reasoningEfforts: ("low" | "medium" | "high")[];
             streaming: boolean;
             promptCaching: boolean;
             maxContextTokens: number;
@@ -1131,6 +1142,7 @@ export declare const modelReleaseIngestionRequestSchema: z.ZodObject<{
             promptCaching: boolean;
             maxContextTokens: number;
             maxOutputTokens: number;
+            reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
         };
         description?: string | undefined;
         knowledgeCutoff?: string | undefined;

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

@@ -1237,6 +1237,20 @@ export declare const responseFormatSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
     name: string;
     strict: boolean;
 }>]>;
+/**
+ * The caller's reasoning control. Strict, like every leaf: a provider-specific
+ * knob (`budget_tokens`, `summary`) is refused rather than silently dropped.
+ *
+ * Oxy forwards it only after checking the resolved model advertises the effort
+ * in its catalogue `reasoningEfforts`; Kaana translates it per provider.
+ */
+export declare const inferenceReasoningSchema: z.ZodObject<{
+    effort: z.ZodEnum<["low", "medium", "high"]>;
+}, "strict", z.ZodTypeAny, {
+    effort: "low" | "medium" | "high";
+}, {
+    effort: "low" | "medium" | "high";
+}>;
 /**
  * What the edge records about the CALL, as opposed to its content.
  *
@@ -1900,6 +1914,14 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         presencePenalty?: number | undefined;
         stopSequences?: string[] | undefined;
     }>;
+    /** Absent means the route's own default reasoning behaviour. */
+    reasoning: z.ZodOptional<z.ZodObject<{
+        effort: z.ZodEnum<["low", "medium", "high"]>;
+    }, "strict", z.ZodTypeAny, {
+        effort: "low" | "medium" | "high";
+    }, {
+        effort: "low" | "medium" | "high";
+    }>>;
     speech: z.ZodOptional<z.ZodObject<{
         voice: z.ZodString;
         responseFormat: z.ZodEnum<["mp3", "opus", "aac", "flac", "wav", "pcm"]>;
@@ -2308,6 +2330,9 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         policyVersion: number;
     };
     idempotencyKey?: string | undefined;
+    reasoning?: {
+        effort: "low" | "medium" | "high";
+    } | undefined;
     maxOutputTokens?: number | undefined;
     responseFormat?: {
         type: "text";
@@ -2467,6 +2492,9 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         strict?: boolean | undefined;
     }[] | undefined;
     idempotencyKey?: string | undefined;
+    reasoning?: {
+        effort: "low" | "medium" | "high";
+    } | undefined;
     maxOutputTokens?: number | undefined;
     responseFormat?: {
         type: "text";
@@ -2626,6 +2654,9 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         policyVersion: number;
     };
     idempotencyKey?: string | undefined;
+    reasoning?: {
+        effort: "low" | "medium" | "high";
+    } | undefined;
     maxOutputTokens?: number | undefined;
     responseFormat?: {
         type: "text";
@@ -2785,6 +2816,9 @@ export declare const inferenceRequestSchema: z.ZodEffects<z.ZodObject<{
         strict?: boolean | undefined;
     }[] | undefined;
     idempotencyKey?: string | undefined;
+    reasoning?: {
+        effort: "low" | "medium" | "high";
+    } | undefined;
     maxOutputTokens?: number | undefined;
     responseFormat?: {
         type: "text";
@@ -2841,6 +2875,7 @@ export type InferenceMessageRole = z.infer<typeof inferenceMessageRoleSchema>;
 export type InferenceMessage = z.infer<typeof inferenceMessageSchema>;
 export type InferenceInput = z.infer<typeof inferenceInputSchema>;
 export type SamplingParameters = z.infer<typeof samplingParametersSchema>;
+export type InferenceReasoning = z.infer<typeof inferenceReasoningSchema>;
 export type ToolDefinition = z.infer<typeof toolDefinitionSchema>;
 export type ToolChoice = z.infer<typeof toolChoiceSchema>;
 export type ResponseFormat = z.infer<typeof responseFormatSchema>;

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

@@ -99,4 +99,4 @@
  * change to, say, the catalogue reject every in-flight inference request; the
  * per-shape `schemaVersion` is what a message is validated against.
  */
-export declare const INFERENCE_CONTRACT_VERSION = "3.0.0";
+export declare const INFERENCE_CONTRACT_VERSION = "3.1.0";