@oxy.so/contracts 4.5.0 → 4.7.0

package/dist/types/agency.d.ts

@@ -858,8 +858,8 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
     }>, "many">>;
     autonomy: z.ZodEnum<["read_only", "draft", "execute_on_request", "autonomous"]>;
 }, "strict", z.ZodTypeAny, {
-    ownerAccountId: string;
     tool: string;
+    ownerAccountId: string;
     actor: {
         type: "alia";
         ownerAccountId: string;
@@ -904,8 +904,8 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
     stepId?: string | undefined;
     grantId?: string | undefined;
 }, {
-    ownerAccountId: string;
     tool: string;
+    ownerAccountId: string;
     actor: {
         type: "alia";
         ownerAccountId: string;
@@ -950,8 +950,8 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
     stepId?: string | undefined;
     grantId?: string | undefined;
 }>, {
-    ownerAccountId: string;
     tool: string;
+    ownerAccountId: string;
     actor: {
         type: "alia";
         ownerAccountId: string;
@@ -996,8 +996,8 @@ export declare const capabilityTicketClaimsSchema: z.ZodEffects<z.ZodObject<{
     stepId?: string | undefined;
     grantId?: string | undefined;
 }, {
-    ownerAccountId: string;
     tool: string;
+    ownerAccountId: string;
     actor: {
         type: "alia";
         ownerAccountId: string;
@@ -1180,9 +1180,9 @@ export declare const auditEventSchema: z.ZodObject<{
         capabilityTicketId?: string | undefined;
     }>;
 }, "strict", z.ZodTypeAny, {
+    tool: string;
     appId: string;
     effectiveAccountId: string;
-    tool: string;
     resource: {
         appId: string;
         effectiveAccountId: string;
@@ -1227,9 +1227,9 @@ export declare const auditEventSchema: z.ZodObject<{
         capabilityTicketId?: string | undefined;
     };
 }, {
+    tool: string;
     appId: string;
     effectiveAccountId: string;
-    tool: string;
     resource: {
         appId: string;
         effectiveAccountId: string;

package/dist/types/capabilityInvocation.d.ts

@@ -0,0 +1,80 @@
+/**
+ * How a catalog tool call travels over HTTP, in both directions.
+ *
+ * A capability catalog names each tool's `invocation` as a method plus a path
+ * template (`/email/messages/{emailId}`). Two parties have to agree on what
+ * that means: the coordinator that BUILDS the request from the model's
+ * arguments (Alia), and the app that MATCHES an incoming request back to the
+ * one tool its ticket was signed for (the Inbox capability middleware). Each
+ * used to carry its own copy of the rules, and the matcher walked the tool list
+ * in array order, so a literal segment (`/messages/unread`) and a parameter
+ * (`/messages/{id}`) in the same position resolved to whichever tool happened to
+ * be declared first. Both halves live here now, next to the catalog schema that
+ * refuses a catalog whose templates could ever match the same request — so a
+ * match is unique by construction, not by ordering.
+ */
+/** The part of a catalog tool this module needs. */
+export interface CatalogInvocationTemplate {
+    readonly method: string;
+    readonly path: string;
+}
+interface InvocationCarrier {
+    readonly name: string;
+    readonly invocation: CatalogInvocationTemplate;
+}
+/** The `{name}` placeholders of a path template, in order. */
+export declare function catalogInvocationPathParameters(path: string): string[];
+/**
+ * Whether one concrete request could match BOTH templates.
+ *
+ * Same method, same number of segments, and at every position either the same
+ * literal or a parameter on at least one side. `/messages/{id}` and
+ * `/messages/unread` overlap (the request `/messages/unread` fits both);
+ * `/messages/{id}` and `/messages/{id}/thread` do not.
+ */
+export declare function catalogInvocationsOverlap(left: CatalogInvocationTemplate, right: CatalogInvocationTemplate): boolean;
+/**
+ * Whether two templates name the same ADDRESS: same method, and at every
+ * position the same literal or a parameter on both sides — parameter names do
+ * not matter (`/messages/{id}` and `/messages/{emailId}` are one address;
+ * `/messages/{id}` and `/messages/bundled` are not, though they overlap).
+ * Used to say which documented REST operation shares its address with a tool.
+ */
+export declare function catalogInvocationTemplatesEquivalent(left: CatalogInvocationTemplate, right: CatalogInvocationTemplate): boolean;
+/** Every pair of tools whose invocations overlap — empty for a valid catalog. */
+export declare function findOverlappingCatalogInvocations<T extends InvocationCarrier>(tools: readonly T[]): Array<readonly [T, T]>;
+export interface CatalogInvocationMatch<T> {
+    readonly tool: T;
+    /** Decoded path parameters, keyed by their template names. */
+    readonly params: Record<string, string>;
+}
+/**
+ * The ONE tool whose invocation matches `method` + `path` (the full app-local
+ * path, e.g. `/email/messages/abc`), or null.
+ *
+ * Every tool is tried, not the first hit, so the answer cannot depend on the
+ * order the catalog lists its tools in. A second hit means the catalog should
+ * never have validated — `appCapabilityCatalogSchema` refuses overlapping
+ * templates — so it throws rather than guessing which tool the ticket meant.
+ */
+export declare function matchCatalogInvocation<T extends InvocationCarrier>(tools: readonly T[], method: string, path: string): CatalogInvocationMatch<T> | null;
+export interface ResolvedCatalogInvocation {
+    readonly method: string;
+    readonly url: URL;
+    /** JSON body for non-GET invocations; GET arguments travel in the query. */
+    readonly body?: Record<string, unknown>;
+}
+/**
+ * Build the HTTP request for a tool call from the model's arguments.
+ *
+ * Path parameters are substituted (and removed from the remaining arguments);
+ * GET sends the rest as query parameters, everything else as a JSON body. A GET
+ * argument that is not a scalar is refused instead of being stringified into
+ * `[object Object]` — the catalog schema only lets GET tools declare scalar
+ * inputs, so reaching that branch means the arguments did not come from the
+ * tool's own schema. The resolved URL must stay on `internalBaseUrl`'s origin.
+ */
+export declare function resolveCatalogInvocation(catalog: {
+    readonly internalBaseUrl: string;
+}, tool: InvocationCarrier, args: Readonly<Record<string, unknown>>): ResolvedCatalogInvocation;
+export {};

package/dist/types/index.d.ts

@@ -74,9 +74,9 @@ 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, reasoningEffortSchema, inferenceApiFormatSchema, realtimeSessionKindSchema, realtimeSessionTransportSchema, modelRealtimeCapabilitiesSchema, 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, InferenceApiFormat, RealtimeSessionKind, RealtimeSessionTransport, ModelRealtimeCapabilities, 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 { inferenceModalitySchema, reasoningEffortSchema, powerLevelSchema, modelPowerClassSchema, inferenceApiFormatSchema, realtimeSessionKindSchema, realtimeSessionTransportSchema, modelRealtimeCapabilitiesSchema, 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, PowerLevel, ModelPowerClass, InferenceApiFormat, RealtimeSessionKind, RealtimeSessionTransport, ModelRealtimeCapabilities, 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, effectiveSameModelDeployment, 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';
@@ -98,6 +98,8 @@ export { PRODUCT_PLAN_STATUSES, productPlanStatusSchema, LIVE_PRODUCT_PLAN_STATU
 export type { ProductPlanStatus, PlanAllowance, ProductPlan, PayAsYouGoEntitlement, CostCenterStatus, CostCenter, CostCenterSpend, ProductEntitlement, } from './inference/entitlement';
 export { AUTONOMY_LEVELS, CAPABILITY_PACKAGES, autonomyLevelSchema, capabilityPackageSchema, actorRefSchema, resourceRefSchema, toolGrantOverrideSchema, grantLimitSchema, capabilityCatalogBindingSchema, executionAuthorizationRefSchema, capabilityCoordinatorSchema, delegationGrantSchema, automationTriggerSchema, automationActorSelectionSchema, automationDataFlowSchema, automationDefinitionSchema, capabilityTicketClaimsSchema, policyDecisionSchema, auditResultSchema, auditEventSchema, catalogToolSchema, catalogEventSchema, appCapabilityCatalogSchema, catalogRegistrationSchema, normalizedAppEventSchema, } from './agency';
 export type { AutonomyLevel, CapabilityPackage, ActorRef, ResourceRef, ToolGrantOverride, GrantLimit, CapabilityCatalogBinding, ExecutionAuthorizationRef, CapabilityCoordinator, DelegationGrant, AutomationTrigger, AutomationActorSelection, AutomationDefinition, CapabilityTicketClaims, PolicyDecision, AuditEvent, CatalogTool, CatalogEvent, AppCapabilityCatalog, CatalogRegistration, NormalizedAppEvent, } from './agency';
+export { catalogInvocationPathParameters, catalogInvocationsOverlap, catalogInvocationTemplatesEquivalent, findOverlappingCatalogInvocations, matchCatalogInvocation, resolveCatalogInvocation, } from './capabilityInvocation';
+export type { CatalogInvocationMatch, CatalogInvocationTemplate, ResolvedCatalogInvocation, } from './capabilityInvocation';
 export { emailContextAddressSchema, emailContextMailboxSchema, emailContextMessageSchema, emailAgentContextSchema, } from './emailAgentContext';
 export type { EmailContextAddress, EmailContextMailbox, EmailContextMessage, EmailAgentContext, } from './emailAgentContext';
 export { inboxComposeRequestSchema, inboxDailyBriefRequestSchema, inboxNaturalSearchRequestSchema, inboxMessageInferenceParamsSchema, inboxInferenceTextResponseSchema, inboxNaturalSearchResponseSchema, inboxSmartRepliesResponseSchema, inboxThreadSummaryResponseSchema, inboxInferenceStreamEventSchema, } from './inference/inbox';
@@ -108,3 +110,5 @@ export * from './federationInstanceFetch';
 export * from './notifications';
 export * from './email/messages';
 export * from './stickers';
+export { decisionEffortSchema, decisionQuestionSchema, decisionInputSchema, decisionRequestSchema, decisionAnswerSchema, decisionResultSchema, decisionSuccessSchema, decisionFailureSchema, decisionInputBudget, decisionFitsGateway, decisionAnswersMatch, } from './inference/decisions';
+export type { DecisionQuestion, DecisionInput, DecisionRequest, DecisionAnswer, DecisionFailure, DecisionResult, DecisionSuccess, } from './inference/decisions';

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

@@ -38,6 +38,31 @@ export declare const inferenceModalitySchema: z.ZodEnum<["text", "image", "audio
  * effort the resolved model does not advertise rather than dropping it.
  */
 export declare const reasoningEffortSchema: z.ZodEnum<["low", "medium", "high"]>;
+/**
+ * A POWER LEVEL: the public name of a product-preset routing profile that asks
+ * Oxy to choose a model by capability tier instead of naming one (contract set
+ * 3.4.0). Ordered cheapest first; `auto` asks Oxy to pick the cheapest level
+ * that suffices for the request.
+ *
+ * - `instant` — very cheap, fast small models; the least reasoning each model
+ *   accepts (`low` on a reasoning model, nothing on one without effort control)
+ * - `medium` — mid-size models, low reasoning effort
+ * - `high` — strong models, medium reasoning effort
+ * - `xhigh` — strong models, high reasoning effort
+ * - `pro` — frontier models, high reasoning effort
+ * - `ultra` — the heaviest frontier models, maximum reasoning effort
+ *
+ * A power level is a routing profile, never a model: its slug has no `/`, and
+ * the response always reports the concrete model that ran.
+ */
+export declare const powerLevelSchema: z.ZodEnum<["auto", "instant", "medium", "high", "xhigh", "pro", "ultra"]>;
+/**
+ * The reviewed capability tier of one MODEL, which power levels choose from.
+ * `xhigh` and `auto` are not classes: `xhigh` runs `high`-class models at a
+ * higher effort, and `auto` chooses a level. Reviewed catalogue data with a
+ * cited public benchmark source — never inferred from a model's name.
+ */
+export declare const modelPowerClassSchema: z.ZodEnum<["instant", "medium", "high", "pro", "ultra"]>;
 /**
  * The public dialects a request can arrive in — `client.apiFormat` on the
  * envelope, and the list a deployment declares it can execute.
@@ -46,7 +71,7 @@ export declare const reasoningEffortSchema: z.ZodEnum<["low", "medium", "high"]>
  * two uses cannot drift: a capability naming a dialect the envelope cannot
  * carry, or the reverse, would authorize a request no route can serve.
  */
-export declare const inferenceApiFormatSchema: z.ZodEnum<["responses", "chat_completions", "embeddings", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>;
+export declare const inferenceApiFormatSchema: z.ZodEnum<["responses", "chat_completions", "embeddings", "decisions", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>;
 /**
  * What a realtime session is FOR. The three are different upstream products
  * with different event families and different metering, not options of one:
@@ -117,7 +142,7 @@ export declare const modelCapabilitiesSchema: z.ZodEffects<z.ZodObject<{
      * applied before this field existed, and authorizes no format that needs a
      * declaration (audio output on `chat_completions`, a realtime session).
      */
-    apiFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<["responses", "chat_completions", "embeddings", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>, "many">>;
+    apiFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<["responses", "chat_completions", "embeddings", "decisions", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>, "many">>;
     /** Realtime sessions this model holds; absent means none. Contract set 3.2.0. */
     realtime: z.ZodOptional<z.ZodObject<{
         transports: z.ZodArray<z.ZodEnum<["websocket"]>, "many">;
@@ -142,7 +167,7 @@ export declare const modelCapabilitiesSchema: z.ZodEffects<z.ZodObject<{
     promptCaching: boolean;
     maxContextTokens: number;
     maxOutputTokens: number;
-    apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+    apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
     realtime?: {
         transports: "websocket"[];
         sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -160,7 +185,7 @@ export declare const modelCapabilitiesSchema: z.ZodEffects<z.ZodObject<{
     maxContextTokens: number;
     maxOutputTokens: number;
     reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-    apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+    apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
     realtime?: {
         transports: "websocket"[];
         sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -178,7 +203,7 @@ export declare const modelCapabilitiesSchema: z.ZodEffects<z.ZodObject<{
     promptCaching: boolean;
     maxContextTokens: number;
     maxOutputTokens: number;
-    apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+    apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
     realtime?: {
         transports: "websocket"[];
         sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -196,7 +221,7 @@ export declare const modelCapabilitiesSchema: z.ZodEffects<z.ZodObject<{
     maxContextTokens: number;
     maxOutputTokens: number;
     reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-    apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+    apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
     realtime?: {
         transports: "websocket"[];
         sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -444,7 +469,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
          * applied before this field existed, and authorizes no format that needs a
          * declaration (audio output on `chat_completions`, a realtime session).
          */
-        apiFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<["responses", "chat_completions", "embeddings", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>, "many">>;
+        apiFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<["responses", "chat_completions", "embeddings", "decisions", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>, "many">>;
         /** Realtime sessions this model holds; absent means none. Contract set 3.2.0. */
         realtime: z.ZodOptional<z.ZodObject<{
             transports: z.ZodArray<z.ZodEnum<["websocket"]>, "many">;
@@ -469,7 +494,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -487,7 +512,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         maxContextTokens: number;
         maxOutputTokens: number;
         reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -505,7 +530,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -523,7 +548,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         maxContextTokens: number;
         maxOutputTokens: number;
         reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -611,7 +636,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -659,7 +684,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         maxContextTokens: number;
         maxOutputTokens: number;
         reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -707,7 +732,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -755,7 +780,7 @@ export declare const catalogueModelSchema: z.ZodEffects<z.ZodObject<{
         maxContextTokens: number;
         maxOutputTokens: number;
         reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -1212,6 +1237,20 @@ export declare const routingProfileSchema: z.ZodObject<{
     }>, "many">;
     /** A product preset (Alia's "fast" toggle) rather than a customer's own profile. */
     isProductPreset: z.ZodBoolean;
+    /**
+     * Present when this profile IS a power level (contract set 3.4.0). Its
+     * `candidates` are then the currently servable models of the level's class,
+     * and may change between reads; cross-model failover among them is
+     * authorized by the profile and reported with a `route_switch` event.
+     */
+    powerLevel: z.ZodOptional<z.ZodEnum<["auto", "instant", "medium", "high", "xhigh", "pro", "ultra"]>>;
+    /**
+     * The reasoning effort a power level asks for when the request names none,
+     * clamped to the nearest effort the chosen model accepts (the lowest at or
+     * above it, else the highest). Absent: the level asks for no reasoning, sent
+     * as the least effort a reasoning model accepts.
+     */
+    reasoningEffort: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
 }, "strip", z.ZodTypeAny, {
     displayName: string;
     schemaVersion: 1;
@@ -1224,6 +1263,8 @@ export declare const routingProfileSchema: z.ZodObject<{
     }[];
     isProductPreset: boolean;
     description?: string | undefined;
+    powerLevel?: "medium" | "high" | "auto" | "instant" | "xhigh" | "pro" | "ultra" | undefined;
+    reasoningEffort?: "low" | "medium" | "high" | undefined;
 }, {
     displayName: string;
     schemaVersion: 1;
@@ -1236,6 +1277,8 @@ export declare const routingProfileSchema: z.ZodObject<{
     }[];
     isProductPreset: boolean;
     description?: string | undefined;
+    powerLevel?: "medium" | "high" | "auto" | "instant" | "xhigh" | "pro" | "ultra" | undefined;
+    reasoningEffort?: "low" | "medium" | "high" | undefined;
 }>;
 /** The publisher fields a customer sees beside a model. */
 export declare const cataloguePublisherSummarySchema: z.ZodObject<{
@@ -1386,7 +1429,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
          * applied before this field existed, and authorizes no format that needs a
          * declaration (audio output on `chat_completions`, a realtime session).
          */
-        apiFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<["responses", "chat_completions", "embeddings", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>, "many">>;
+        apiFormats: z.ZodOptional<z.ZodArray<z.ZodEnum<["responses", "chat_completions", "embeddings", "decisions", "images_generations", "audio_transcriptions", "audio_speech", "rerank", "batches"]>, "many">>;
         /** Realtime sessions this model holds; absent means none. Contract set 3.2.0. */
         realtime: z.ZodOptional<z.ZodObject<{
             transports: z.ZodArray<z.ZodEnum<["websocket"]>, "many">;
@@ -1411,7 +1454,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -1429,7 +1472,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         maxContextTokens: number;
         maxOutputTokens: number;
         reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -1447,7 +1490,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -1465,7 +1508,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         maxContextTokens: number;
         maxOutputTokens: number;
         reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -1729,6 +1772,12 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         knownLimitations?: string[] | undefined;
     }>>;
     modelCardUrl: z.ZodOptional<z.ZodString>;
+    /**
+     * The reviewed power class this model serves in, when one has been reviewed
+     * (contract set 3.4.0). Absent means the model is callable by name only and
+     * no power level chooses it.
+     */
+    powerClass: z.ZodOptional<z.ZodEnum<["instant", "medium", "high", "pro", "ultra"]>>;
 }, "strip", z.ZodTypeAny, {
     displayName: string;
     capabilities: {
@@ -1744,7 +1793,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         promptCaching: boolean;
         maxContextTokens: number;
         maxOutputTokens: number;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -1830,6 +1879,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
             per: number;
         }[];
     } | undefined;
+    powerClass?: "medium" | "high" | "instant" | "pro" | "ultra" | undefined;
 }, {
     displayName: string;
     capabilities: {
@@ -1845,7 +1895,7 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
         maxContextTokens: number;
         maxOutputTokens: number;
         reasoningEfforts?: ("low" | "medium" | "high")[] | undefined;
-        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
+        apiFormats?: ("embeddings" | "responses" | "chat_completions" | "decisions" | "images_generations" | "audio_transcriptions" | "audio_speech" | "rerank" | "batches")[] | undefined;
         realtime?: {
             transports: "websocket"[];
             sessionKinds: ("conversation" | "transcription" | "translation")[];
@@ -1931,9 +1981,12 @@ export declare const modelCatalogueEntrySchema: z.ZodObject<{
             per: number;
         }[];
     } | undefined;
+    powerClass?: "medium" | "high" | "instant" | "pro" | "ultra" | undefined;
 }>;
 export type InferenceModality = z.infer<typeof inferenceModalitySchema>;
 export type ReasoningEffort = z.infer<typeof reasoningEffortSchema>;
+export type PowerLevel = z.infer<typeof powerLevelSchema>;
+export type ModelPowerClass = z.infer<typeof modelPowerClassSchema>;
 export type InferenceApiFormat = z.infer<typeof inferenceApiFormatSchema>;
 export type RealtimeSessionKind = z.infer<typeof realtimeSessionKindSchema>;
 export type RealtimeSessionTransport = z.infer<typeof realtimeSessionTransportSchema>;