@openrouter/sdk 0.12.29 → 0.12.31

package/esm/models/errors/paymentrequiredresponseerror.js

@@ -16,6 +16,9 @@ export class PaymentRequiredResponseError extends OpenRouterError {
         super(message, httpMeta);
         this.data$ = err;
         this.error = err.error;
+        if (err.openrouterMetadata != null) {
+            this.openrouterMetadata = err.openrouterMetadata;
+        }
         if (err.userId != null)
             this.userId = err.userId;
         this.name = "PaymentRequiredResponseError";
@@ -24,6 +27,8 @@ export class PaymentRequiredResponseError extends OpenRouterError {
 /** @internal */
 export const PaymentRequiredResponseError$inboundSchema = z.object({
     error: models.PaymentRequiredResponseErrorData$inboundSchema,
+    openrouter_metadata: z.nullable(z.record(z.string(), z.nullable(z.any())))
+        .optional(),
     user_id: z.nullable(z.string()).optional(),
     request$: z.custom(x => x instanceof Request),
     response$: z.custom(x => x instanceof Response),
@@ -31,6 +36,7 @@ export const PaymentRequiredResponseError$inboundSchema = z.object({
 })
     .transform((v) => {
     const remapped = remap$(v, {
+        "openrouter_metadata": "openrouterMetadata",
         "user_id": "userId",
     });
     return new PaymentRequiredResponseError(remapped, {

package/esm/models/errors/provideroverloadedresponseerror.d.ts

@@ -9,6 +9,9 @@ export type ProviderOverloadedResponseErrorData = {
      * Error data for ProviderOverloadedResponse
      */
     error: models.ProviderOverloadedResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
 };
 /**
@@ -19,6 +22,9 @@ export declare class ProviderOverloadedResponseError extends OpenRouterError {
      * Error data for ProviderOverloadedResponse
      */
     error: models.ProviderOverloadedResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
     /** The original data that was passed to this error instance. */
     data$: ProviderOverloadedResponseErrorData;

package/esm/models/errors/provideroverloadedresponseerror.js

@@ -16,6 +16,9 @@ export class ProviderOverloadedResponseError extends OpenRouterError {
         super(message, httpMeta);
         this.data$ = err;
         this.error = err.error;
+        if (err.openrouterMetadata != null) {
+            this.openrouterMetadata = err.openrouterMetadata;
+        }
         if (err.userId != null)
             this.userId = err.userId;
         this.name = "ProviderOverloadedResponseError";
@@ -24,6 +27,8 @@ export class ProviderOverloadedResponseError extends OpenRouterError {
 /** @internal */
 export const ProviderOverloadedResponseError$inboundSchema = z.object({
     error: models.ProviderOverloadedResponseErrorData$inboundSchema,
+    openrouter_metadata: z.nullable(z.record(z.string(), z.nullable(z.any())))
+        .optional(),
     user_id: z.nullable(z.string()).optional(),
     request$: z.custom(x => x instanceof Request),
     response$: z.custom(x => x instanceof Response),
@@ -31,6 +36,7 @@ export const ProviderOverloadedResponseError$inboundSchema = z.object({
 })
     .transform((v) => {
     const remapped = remap$(v, {
+        "openrouter_metadata": "openrouterMetadata",
         "user_id": "userId",
     });
     return new ProviderOverloadedResponseError(remapped, {

package/esm/models/errors/requesttimeoutresponseerror.d.ts

@@ -9,6 +9,9 @@ export type RequestTimeoutResponseErrorData = {
      * Error data for RequestTimeoutResponse
      */
     error: models.RequestTimeoutResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
 };
 /**
@@ -19,6 +22,9 @@ export declare class RequestTimeoutResponseError extends OpenRouterError {
      * Error data for RequestTimeoutResponse
      */
     error: models.RequestTimeoutResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
     /** The original data that was passed to this error instance. */
     data$: RequestTimeoutResponseErrorData;

package/esm/models/errors/requesttimeoutresponseerror.js

@@ -16,6 +16,9 @@ export class RequestTimeoutResponseError extends OpenRouterError {
         super(message, httpMeta);
         this.data$ = err;
         this.error = err.error;
+        if (err.openrouterMetadata != null) {
+            this.openrouterMetadata = err.openrouterMetadata;
+        }
         if (err.userId != null)
             this.userId = err.userId;
         this.name = "RequestTimeoutResponseError";
@@ -24,6 +27,8 @@ export class RequestTimeoutResponseError extends OpenRouterError {
 /** @internal */
 export const RequestTimeoutResponseError$inboundSchema = z.object({
     error: models.RequestTimeoutResponseErrorData$inboundSchema,
+    openrouter_metadata: z.nullable(z.record(z.string(), z.nullable(z.any())))
+        .optional(),
     user_id: z.nullable(z.string()).optional(),
     request$: z.custom(x => x instanceof Request),
     response$: z.custom(x => x instanceof Response),
@@ -31,6 +36,7 @@ export const RequestTimeoutResponseError$inboundSchema = z.object({
 })
     .transform((v) => {
     const remapped = remap$(v, {
+        "openrouter_metadata": "openrouterMetadata",
         "user_id": "userId",
     });
     return new RequestTimeoutResponseError(remapped, {

package/esm/models/errors/serviceunavailableresponseerror.d.ts

@@ -9,6 +9,9 @@ export type ServiceUnavailableResponseErrorData = {
      * Error data for ServiceUnavailableResponse
      */
     error: models.ServiceUnavailableResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
 };
 /**
@@ -19,6 +22,9 @@ export declare class ServiceUnavailableResponseError extends OpenRouterError {
      * Error data for ServiceUnavailableResponse
      */
     error: models.ServiceUnavailableResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
     /** The original data that was passed to this error instance. */
     data$: ServiceUnavailableResponseErrorData;

package/esm/models/errors/serviceunavailableresponseerror.js

@@ -16,6 +16,9 @@ export class ServiceUnavailableResponseError extends OpenRouterError {
         super(message, httpMeta);
         this.data$ = err;
         this.error = err.error;
+        if (err.openrouterMetadata != null) {
+            this.openrouterMetadata = err.openrouterMetadata;
+        }
         if (err.userId != null)
             this.userId = err.userId;
         this.name = "ServiceUnavailableResponseError";
@@ -24,6 +27,8 @@ export class ServiceUnavailableResponseError extends OpenRouterError {
 /** @internal */
 export const ServiceUnavailableResponseError$inboundSchema = z.object({
     error: models.ServiceUnavailableResponseErrorData$inboundSchema,
+    openrouter_metadata: z.nullable(z.record(z.string(), z.nullable(z.any())))
+        .optional(),
     user_id: z.nullable(z.string()).optional(),
     request$: z.custom(x => x instanceof Request),
     response$: z.custom(x => x instanceof Response),
@@ -31,6 +36,7 @@ export const ServiceUnavailableResponseError$inboundSchema = z.object({
 })
     .transform((v) => {
     const remapped = remap$(v, {
+        "openrouter_metadata": "openrouterMetadata",
         "user_id": "userId",
     });
     return new ServiceUnavailableResponseError(remapped, {

package/esm/models/errors/toomanyrequestsresponseerror.d.ts

@@ -9,6 +9,9 @@ export type TooManyRequestsResponseErrorData = {
      * Error data for TooManyRequestsResponse
      */
     error: models.TooManyRequestsResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
 };
 /**
@@ -19,6 +22,9 @@ export declare class TooManyRequestsResponseError extends OpenRouterError {
      * Error data for TooManyRequestsResponse
      */
     error: models.TooManyRequestsResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
     /** The original data that was passed to this error instance. */
     data$: TooManyRequestsResponseErrorData;

package/esm/models/errors/toomanyrequestsresponseerror.js

@@ -16,6 +16,9 @@ export class TooManyRequestsResponseError extends OpenRouterError {
         super(message, httpMeta);
         this.data$ = err;
         this.error = err.error;
+        if (err.openrouterMetadata != null) {
+            this.openrouterMetadata = err.openrouterMetadata;
+        }
         if (err.userId != null)
             this.userId = err.userId;
         this.name = "TooManyRequestsResponseError";
@@ -24,6 +27,8 @@ export class TooManyRequestsResponseError extends OpenRouterError {
 /** @internal */
 export const TooManyRequestsResponseError$inboundSchema = z.object({
     error: models.TooManyRequestsResponseErrorData$inboundSchema,
+    openrouter_metadata: z.nullable(z.record(z.string(), z.nullable(z.any())))
+        .optional(),
     user_id: z.nullable(z.string()).optional(),
     request$: z.custom(x => x instanceof Request),
     response$: z.custom(x => x instanceof Response),
@@ -31,6 +36,7 @@ export const TooManyRequestsResponseError$inboundSchema = z.object({
 })
     .transform((v) => {
     const remapped = remap$(v, {
+        "openrouter_metadata": "openrouterMetadata",
         "user_id": "userId",
     });
     return new TooManyRequestsResponseError(remapped, {

package/esm/models/errors/unauthorizedresponseerror.d.ts

@@ -9,6 +9,9 @@ export type UnauthorizedResponseErrorData = {
      * Error data for UnauthorizedResponse
      */
     error: models.UnauthorizedResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
 };
 /**
@@ -19,6 +22,9 @@ export declare class UnauthorizedResponseError extends OpenRouterError {
      * Error data for UnauthorizedResponse
      */
     error: models.UnauthorizedResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
     /** The original data that was passed to this error instance. */
     data$: UnauthorizedResponseErrorData;

package/esm/models/errors/unauthorizedresponseerror.js

@@ -16,6 +16,9 @@ export class UnauthorizedResponseError extends OpenRouterError {
         super(message, httpMeta);
         this.data$ = err;
         this.error = err.error;
+        if (err.openrouterMetadata != null) {
+            this.openrouterMetadata = err.openrouterMetadata;
+        }
         if (err.userId != null)
             this.userId = err.userId;
         this.name = "UnauthorizedResponseError";
@@ -24,6 +27,8 @@ export class UnauthorizedResponseError extends OpenRouterError {
 /** @internal */
 export const UnauthorizedResponseError$inboundSchema = z.object({
     error: models.UnauthorizedResponseErrorData$inboundSchema,
+    openrouter_metadata: z.nullable(z.record(z.string(), z.nullable(z.any())))
+        .optional(),
     user_id: z.nullable(z.string()).optional(),
     request$: z.custom(x => x instanceof Request),
     response$: z.custom(x => x instanceof Response),
@@ -31,6 +36,7 @@ export const UnauthorizedResponseError$inboundSchema = z.object({
 })
     .transform((v) => {
     const remapped = remap$(v, {
+        "openrouter_metadata": "openrouterMetadata",
         "user_id": "userId",
     });
     return new UnauthorizedResponseError(remapped, {

package/esm/models/errors/unprocessableentityresponseerror.d.ts

@@ -9,6 +9,9 @@ export type UnprocessableEntityResponseErrorData = {
      * Error data for UnprocessableEntityResponse
      */
     error: models.UnprocessableEntityResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
 };
 /**
@@ -19,6 +22,9 @@ export declare class UnprocessableEntityResponseError extends OpenRouterError {
      * Error data for UnprocessableEntityResponse
      */
     error: models.UnprocessableEntityResponseErrorData;
+    openrouterMetadata?: {
+        [k: string]: any | null;
+    } | null | undefined;
     userId?: string | null | undefined;
     /** The original data that was passed to this error instance. */
     data$: UnprocessableEntityResponseErrorData;

package/esm/models/errors/unprocessableentityresponseerror.js

@@ -16,6 +16,9 @@ export class UnprocessableEntityResponseError extends OpenRouterError {
         super(message, httpMeta);
         this.data$ = err;
         this.error = err.error;
+        if (err.openrouterMetadata != null) {
+            this.openrouterMetadata = err.openrouterMetadata;
+        }
         if (err.userId != null)
             this.userId = err.userId;
         this.name = "UnprocessableEntityResponseError";
@@ -24,6 +27,8 @@ export class UnprocessableEntityResponseError extends OpenRouterError {
 /** @internal */
 export const UnprocessableEntityResponseError$inboundSchema = z.object({
     error: models.UnprocessableEntityResponseErrorData$inboundSchema,
+    openrouter_metadata: z.nullable(z.record(z.string(), z.nullable(z.any())))
+        .optional(),
     user_id: z.nullable(z.string()).optional(),
     request$: z.custom(x => x instanceof Request),
     response$: z.custom(x => x instanceof Response),
@@ -31,6 +36,7 @@ export const UnprocessableEntityResponseError$inboundSchema = z.object({
 })
     .transform((v) => {
     const remapped = remap$(v, {
+        "openrouter_metadata": "openrouterMetadata",
         "user_id": "userId",
     });
     return new UnprocessableEntityResponseError(remapped, {

package/esm/models/index.d.ts

@@ -51,6 +51,7 @@ export * from "./chatsearchmodelsservertool.js";
 export * from "./chatstreamchoice.js";
 export * from "./chatstreamchunk.js";
 export * from "./chatstreamdelta.js";
+export * from "./chatstreamingresponse.js";
 export * from "./chatstreamoptions.js";
 export * from "./chatstreamtoolcall.js";
 export * from "./chatsystemmessage.js";
@@ -85,6 +86,8 @@ export * from "./deleteguardrailresponse.js";
 export * from "./deleteworkspaceresponse.js";
 export * from "./easyinputmessage.js";
 export * from "./edgenetworktimeoutresponseerrordata.js";
+export * from "./endpointinfo.js";
+export * from "./endpointsmetadata.js";
 export * from "./endpointstatus.js";
 export * from "./errorevent.js";
 export * from "./filecitation.js";
@@ -139,6 +142,7 @@ export * from "./listmemberassignmentsresponse.js";
 export * from "./listworkspacesresponse.js";
 export * from "./mcpservertool.js";
 export * from "./memberassignment.js";
+export * from "./metadatalevel.js";
 export * from "./model.js";
 export * from "./modelarchitecture.js";
 export * from "./modelgroup.js";
@@ -158,6 +162,7 @@ export * from "./openairesponsestruncation.js";
 export * from "./openresponsescreatedevent.js";
 export * from "./openresponsesinprogressevent.js";
 export * from "./openresponsesresult.js";
+export * from "./openroutermetadata.js";
 export * from "./openrouterwebsearchservertool.js";
 export * from "./outputapplypatchservertoolitem.js";
 export * from "./outputbashservertoolitem.js";
@@ -196,6 +201,8 @@ export * from "./percentilelatencycutoffs.js";
 export * from "./percentilestats.js";
 export * from "./percentilethroughputcutoffs.js";
 export * from "./perrequestlimits.js";
+export * from "./pipelinestage.js";
+export * from "./pipelinestagetype.js";
 export * from "./preferredmaxlatency.js";
 export * from "./preferredminthroughput.js";
 export * from "./preview20250311websearchservertool.js";
@@ -236,6 +243,10 @@ export * from "./responseincludesenum.js";
 export * from "./responseoutputtext.js";
 export * from "./responseserrorfield.js";
 export * from "./responsesrequest.js";
+export * from "./responsesstreamingresponse.js";
+export * from "./routerattempt.js";
+export * from "./routerparams.js";
+export * from "./routingstrategy.js";
 export * from "./searchcontextsizeenum.js";
 export * from "./searchmodelsservertoolconfig.js";
 export * from "./searchqualitylevel.js";

package/esm/models/index.js

@@ -55,6 +55,7 @@ export * from "./chatsearchmodelsservertool.js";
 export * from "./chatstreamchoice.js";
 export * from "./chatstreamchunk.js";
 export * from "./chatstreamdelta.js";
+export * from "./chatstreamingresponse.js";
 export * from "./chatstreamoptions.js";
 export * from "./chatstreamtoolcall.js";
 export * from "./chatsystemmessage.js";
@@ -89,6 +90,8 @@ export * from "./deleteguardrailresponse.js";
 export * from "./deleteworkspaceresponse.js";
 export * from "./easyinputmessage.js";
 export * from "./edgenetworktimeoutresponseerrordata.js";
+export * from "./endpointinfo.js";
+export * from "./endpointsmetadata.js";
 export * from "./endpointstatus.js";
 export * from "./errorevent.js";
 export * from "./filecitation.js";
@@ -143,6 +146,7 @@ export * from "./listmemberassignmentsresponse.js";
 export * from "./listworkspacesresponse.js";
 export * from "./mcpservertool.js";
 export * from "./memberassignment.js";
+export * from "./metadatalevel.js";
 export * from "./model.js";
 export * from "./modelarchitecture.js";
 export * from "./modelgroup.js";
@@ -162,6 +166,7 @@ export * from "./openairesponsestruncation.js";
 export * from "./openresponsescreatedevent.js";
 export * from "./openresponsesinprogressevent.js";
 export * from "./openresponsesresult.js";
+export * from "./openroutermetadata.js";
 export * from "./openrouterwebsearchservertool.js";
 export * from "./outputapplypatchservertoolitem.js";
 export * from "./outputbashservertoolitem.js";
@@ -200,6 +205,8 @@ export * from "./percentilelatencycutoffs.js";
 export * from "./percentilestats.js";
 export * from "./percentilethroughputcutoffs.js";
 export * from "./perrequestlimits.js";
+export * from "./pipelinestage.js";
+export * from "./pipelinestagetype.js";
 export * from "./preferredmaxlatency.js";
 export * from "./preferredminthroughput.js";
 export * from "./preview20250311websearchservertool.js";
@@ -240,6 +247,10 @@ export * from "./responseincludesenum.js";
 export * from "./responseoutputtext.js";
 export * from "./responseserrorfield.js";
 export * from "./responsesrequest.js";
+export * from "./responsesstreamingresponse.js";
+export * from "./routerattempt.js";
+export * from "./routerparams.js";
+export * from "./routingstrategy.js";
 export * from "./searchcontextsizeenum.js";
 export * from "./searchmodelsservertoolconfig.js";
 export * from "./searchqualitylevel.js";

package/esm/models/metadatalevel.d.ts

@@ -0,0 +1,16 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * Opt-in level for surfacing routing metadata on the response under `openrouter_metadata`.
+ */
+export declare const MetadataLevel: {
+    readonly Disabled: "disabled";
+    readonly Enabled: "enabled";
+};
+/**
+ * Opt-in level for surfacing routing metadata on the response under `openrouter_metadata`.
+ */
+export type MetadataLevel = OpenEnum<typeof MetadataLevel>;
+/** @internal */
+export declare const MetadataLevel$outboundSchema: z.ZodType<string, MetadataLevel>;
+//# sourceMappingURL=metadatalevel.d.ts.map

package/esm/models/metadatalevel.js

@@ -0,0 +1,15 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d3f8399ef138
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * Opt-in level for surfacing routing metadata on the response under `openrouter_metadata`.
+ */
+export const MetadataLevel = {
+    Disabled: "disabled",
+    Enabled: "enabled",
+};
+/** @internal */
+export const MetadataLevel$outboundSchema = openEnums.outboundSchema(MetadataLevel);
+//# sourceMappingURL=metadatalevel.js.map

package/esm/models/openresponsesresult.d.ts

@@ -17,6 +17,7 @@ import { LegacyWebSearchServerTool } from "./legacywebsearchservertool.js";
 import { McpServerTool } from "./mcpservertool.js";
 import { OpenAIResponsesResponseStatus } from "./openairesponsesresponsestatus.js";
 import { OpenAIResponsesToolChoiceUnion } from "./openairesponsestoolchoiceunion.js";
+import { OpenRouterMetadata } from "./openroutermetadata.js";
 import { OutputItems } from "./outputitems.js";
 import { Preview20250311WebSearchServerTool } from "./preview20250311websearchservertool.js";
 import { PreviewWebSearchServerTool } from "./previewwebsearchservertool.js";
@@ -96,6 +97,7 @@ export type OpenResponsesResult = {
      */
     usage?: Usage | null | undefined;
     user?: string | null | undefined;
+    openrouterMetadata?: OpenRouterMetadata | undefined;
 };
 /** @internal */
 export declare const OpenResponsesResultObject$inboundSchema: z.ZodEnum<typeof OpenResponsesResultObject>;

package/esm/models/openresponsesresult.js

@@ -20,6 +20,7 @@ import { LegacyWebSearchServerTool$inboundSchema, } from "./legacywebsearchserve
 import { McpServerTool$inboundSchema } from "./mcpservertool.js";
 import { OpenAIResponsesResponseStatus$inboundSchema, } from "./openairesponsesresponsestatus.js";
 import { OpenAIResponsesToolChoiceUnion$inboundSchema, } from "./openairesponsestoolchoiceunion.js";
+import { OpenRouterMetadata$inboundSchema, } from "./openroutermetadata.js";
 import { OutputItems$inboundSchema } from "./outputitems.js";
 import { Preview20250311WebSearchServerTool$inboundSchema, } from "./preview20250311websearchservertool.js";
 import { PreviewWebSearchServerTool$inboundSchema, } from "./previewwebsearchservertool.js";
@@ -117,6 +118,7 @@ export const OpenResponsesResult$inboundSchema = z.object({
     truncation: z.nullable(Truncation$inboundSchema).optional(),
     usage: z.nullable(Usage$inboundSchema).optional(),
     user: z.nullable(z.string()).optional(),
+    openrouter_metadata: OpenRouterMetadata$inboundSchema.optional(),
 }).transform((v) => {
     return remap$(v, {
         "completed_at": "completedAt",
@@ -135,6 +137,7 @@ export const OpenResponsesResult$inboundSchema = z.object({
         "tool_choice": "toolChoice",
         "top_logprobs": "topLogprobs",
         "top_p": "topP",
+        "openrouter_metadata": "openrouterMetadata",
     });
 });
 export function openResponsesResultFromJSON(jsonString) {

package/esm/models/openroutermetadata.d.ts

@@ -0,0 +1,24 @@
+import * as z from "zod/v4";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { EndpointsMetadata } from "./endpointsmetadata.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { PipelineStage } from "./pipelinestage.js";
+import { RouterAttempt } from "./routerattempt.js";
+import { RouterParams } from "./routerparams.js";
+import { RoutingStrategy } from "./routingstrategy.js";
+export type OpenRouterMetadata = {
+    attempt: number;
+    attempts?: Array<RouterAttempt> | undefined;
+    endpoints: EndpointsMetadata;
+    isByok: boolean;
+    params?: RouterParams | undefined;
+    pipeline?: Array<PipelineStage> | undefined;
+    region: string | null;
+    requested: string;
+    strategy: RoutingStrategy;
+    summary: string;
+};
+/** @internal */
+export declare const OpenRouterMetadata$inboundSchema: z.ZodType<OpenRouterMetadata, unknown>;
+export declare function openRouterMetadataFromJSON(jsonString: string): SafeParseResult<OpenRouterMetadata, SDKValidationError>;
+//# sourceMappingURL=openroutermetadata.d.ts.map

package/esm/models/openroutermetadata.js

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8a5688777dfa
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { EndpointsMetadata$inboundSchema, } from "./endpointsmetadata.js";
+import { PipelineStage$inboundSchema } from "./pipelinestage.js";
+import { RouterAttempt$inboundSchema } from "./routerattempt.js";
+import { RouterParams$inboundSchema } from "./routerparams.js";
+import { RoutingStrategy$inboundSchema, } from "./routingstrategy.js";
+/** @internal */
+export const OpenRouterMetadata$inboundSchema = z.object({
+    attempt: z.int(),
+    attempts: z.array(RouterAttempt$inboundSchema).optional(),
+    endpoints: EndpointsMetadata$inboundSchema,
+    is_byok: z.boolean(),
+    params: RouterParams$inboundSchema.optional(),
+    pipeline: z.array(PipelineStage$inboundSchema).optional(),
+    region: z.nullable(z.string()),
+    requested: z.string(),
+    strategy: RoutingStrategy$inboundSchema,
+    summary: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        "is_byok": "isByok",
+    });
+});
+export function openRouterMetadataFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => OpenRouterMetadata$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'OpenRouterMetadata' from JSON`);
+}
+//# sourceMappingURL=openroutermetadata.js.map

package/esm/models/operations/createresponses.d.ts

@@ -44,16 +44,11 @@ export type CreateResponsesRequest = {
      * @remarks
      */
     appCategories?: string | undefined;
-    responsesRequest: models.ResponsesRequest;
-};
-/**
- * Successful response
- */
-export type CreateResponsesResponseBody = {
     /**
-     * Union of all possible event types emitted during response streaming
+     * Opt-in to surface routing metadata on the response under `openrouter_metadata`. Defaults to `disabled`.
      */
-    data: models.StreamEvents;
+    xOpenRouterExperimentalMetadata?: models.MetadataLevel | undefined;
+    responsesRequest: models.ResponsesRequest;
 };
 export type CreateResponsesResponse = models.OpenResponsesResult | EventStream<models.StreamEvents>;
 /** @internal */
@@ -61,15 +56,13 @@ export type CreateResponsesRequest$Outbound = {
     "HTTP-Referer"?: string | undefined;
     appTitle?: string | undefined;
     appCategories?: string | undefined;
+    "X-OpenRouter-Experimental-Metadata"?: string | undefined;
     ResponsesRequest: models.ResponsesRequest$Outbound;
 };
 /** @internal */
 export declare const CreateResponsesRequest$outboundSchema: z.ZodType<CreateResponsesRequest$Outbound, CreateResponsesRequest>;
 export declare function createResponsesRequestToJSON(createResponsesRequest: CreateResponsesRequest): string;
 /** @internal */
-export declare const CreateResponsesResponseBody$inboundSchema: z.ZodType<CreateResponsesResponseBody, unknown>;
-export declare function createResponsesResponseBodyFromJSON(jsonString: string): SafeParseResult<CreateResponsesResponseBody, SDKValidationError>;
-/** @internal */
 export declare const CreateResponsesResponse$inboundSchema: z.ZodType<CreateResponsesResponse, unknown>;
 export declare function createResponsesResponseFromJSON(jsonString: string): SafeParseResult<CreateResponsesResponse, SDKValidationError>;
 //# sourceMappingURL=createresponses.d.ts.map

package/esm/models/operations/createresponses.js

@@ -12,10 +12,13 @@ export const CreateResponsesRequest$outboundSchema = z.object({
     httpReferer: z.string().optional(),
     appTitle: z.string().optional(),
     appCategories: z.string().optional(),
+    xOpenRouterExperimentalMetadata: models.MetadataLevel$outboundSchema
+        .optional(),
     responsesRequest: models.ResponsesRequest$outboundSchema,
 }).transform((v) => {
     return remap$(v, {
         httpReferer: "HTTP-Referer",
+        xOpenRouterExperimentalMetadata: "X-OpenRouter-Experimental-Metadata",
         responsesRequest: "ResponsesRequest",
     });
 });
@@ -23,25 +26,6 @@ export function createResponsesRequestToJSON(createResponsesRequest) {
     return JSON.stringify(CreateResponsesRequest$outboundSchema.parse(createResponsesRequest));
 }
 /** @internal */
-export const CreateResponsesResponseBody$inboundSchema = z.object({
-    data: z.string().transform((v, ctx) => {
-        try {
-            return JSON.parse(v);
-        }
-        catch (err) {
-            ctx.addIssue({
-                input: v,
-                code: "custom",
-                message: `malformed json: ${err}`,
-            });
-            return z.NEVER;
-        }
-    }).pipe(models.StreamEvents$inboundSchema),
-});
-export function createResponsesResponseBodyFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => CreateResponsesResponseBody$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'CreateResponsesResponseBody' from JSON`);
-}
-/** @internal */
 export const CreateResponsesResponse$inboundSchema = z.union([
     models.OpenResponsesResult$inboundSchema,
     z.custom(x => x instanceof ReadableStream)
@@ -51,7 +35,8 @@ export const CreateResponsesResponse$inboundSchema = z.union([
                 return { done: true, value: undefined };
             return {
                 done: false,
-                value: z.lazy(() => CreateResponsesResponseBody$inboundSchema).parse(rawEvent)?.data,
+                value: models.ResponsesStreamingResponse$inboundSchema.parse(rawEvent)
+                    ?.data,
             };
         });
     }),