@openrouter/sdk 0.13.35 → 0.13.36

package/esm/lib/config.d.ts

@@ -49,8 +49,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "0.13.35";
+    readonly sdkVersion: "0.13.36";
     readonly genVersion: "2.884.4";
-    readonly userAgent: "speakeasy-sdk/typescript 0.13.35 2.884.4 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.13.36 2.884.4 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -26,8 +26,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "0.13.35",
+    sdkVersion: "0.13.36",
     genVersion: "2.884.4",
-    userAgent: "speakeasy-sdk/typescript 0.13.35 2.884.4 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 0.13.36 2.884.4 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/basereasoningconfig.d.ts

@@ -1,10 +1,15 @@
 import * as z from "zod/v4";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { ReasoningContext } from "./reasoningcontext.js";
 import { ReasoningEffort } from "./reasoningeffort.js";
 import { ReasoningMode } from "./reasoningmode.js";
 import { ReasoningSummaryVerbosity } from "./reasoningsummaryverbosity.js";
 export type BaseReasoningConfig = {
+    /**
+     * Controls which reasoning is available to the model. `auto` uses the model default (same as omitting); `all_turns` includes reasoning from earlier turns passed in input; `current_turn` limits to the current turn only. Only supported by OpenAI GPT-5.6 and newer.
+     */
+    context?: ReasoningContext | null | undefined;
     effort?: ReasoningEffort | null | undefined;
     /**
      * Selects the reasoning mode. `standard` is the default; `pro` engages deeper reasoning on models that support it, billed at standard token rates. Only supported by OpenAI GPT-5.6 and newer.

package/esm/models/basereasoningconfig.js

@@ -4,11 +4,13 @@
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";
+import { ReasoningContext$inboundSchema, } from "./reasoningcontext.js";
 import { ReasoningEffort$inboundSchema, } from "./reasoningeffort.js";
 import { ReasoningMode$inboundSchema } from "./reasoningmode.js";
 import { ReasoningSummaryVerbosity$inboundSchema, } from "./reasoningsummaryverbosity.js";
 /** @internal */
 export const BaseReasoningConfig$inboundSchema = z.object({
+    context: z.nullable(ReasoningContext$inboundSchema).optional(),
     effort: z.nullable(ReasoningEffort$inboundSchema).optional(),
     mode: z.nullable(ReasoningMode$inboundSchema).optional(),
     summary: z.nullable(ReasoningSummaryVerbosity$inboundSchema).optional(),

package/esm/models/index.d.ts

@@ -392,6 +392,8 @@ export * from "./presetwithdesignatedversion.js";
 export * from "./preview20250311websearchservertool.js";
 export * from "./previewwebsearchservertool.js";
 export * from "./previewwebsearchuserlocation.js";
+export * from "./promptcachebreakpoint.js";
+export * from "./promptcacheoptions.js";
 export * from "./promptinjectionscanscope.js";
 export * from "./providername.js";
 export * from "./provideroptions.js";
@@ -408,6 +410,7 @@ export * from "./rankingsdailyitem.js";
 export * from "./rankingsdailymeta.js";
 export * from "./rankingsdailyresponse.js";
 export * from "./reasoningconfig.js";
+export * from "./reasoningcontext.js";
 export * from "./reasoningdeltaevent.js";
 export * from "./reasoningdetailencrypted.js";
 export * from "./reasoningdetailservertoolcall.js";

package/esm/models/index.js

@@ -396,6 +396,8 @@ export * from "./presetwithdesignatedversion.js";
 export * from "./preview20250311websearchservertool.js";
 export * from "./previewwebsearchservertool.js";
 export * from "./previewwebsearchuserlocation.js";
+export * from "./promptcachebreakpoint.js";
+export * from "./promptcacheoptions.js";
 export * from "./promptinjectionscanscope.js";
 export * from "./providername.js";
 export * from "./provideroptions.js";
@@ -412,6 +414,7 @@ export * from "./rankingsdailyitem.js";
 export * from "./rankingsdailymeta.js";
 export * from "./rankingsdailyresponse.js";
 export * from "./reasoningconfig.js";
+export * from "./reasoningcontext.js";
 export * from "./reasoningdeltaevent.js";
 export * from "./reasoningdetailencrypted.js";
 export * from "./reasoningdetailservertoolcall.js";

package/esm/models/inputtext.d.ts

@@ -1,10 +1,15 @@
 import * as z from "zod/v4";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { PromptCacheBreakpoint, PromptCacheBreakpoint$Outbound } from "./promptcachebreakpoint.js";
 /**
  * Text input content item
  */
 export type InputText = {
+    /**
+     * Marks an explicit prompt-cache boundary on this content block. Everything through the block carrying this marker is part of the candidate cached prefix. Only supported by OpenAI GPT-5.6 and newer.
+     */
+    promptCacheBreakpoint?: PromptCacheBreakpoint | null | undefined;
     text: string;
     type: "input_text";
 };
@@ -12,6 +17,7 @@ export type InputText = {
 export declare const InputText$inboundSchema: z.ZodType<InputText, unknown>;
 /** @internal */
 export type InputText$Outbound = {
+    prompt_cache_breakpoint?: PromptCacheBreakpoint$Outbound | null | undefined;
     text: string;
     type: "input_text";
 };

package/esm/models/inputtext.js

@@ -3,16 +3,30 @@
  * @generated-id: 8d6c10a240ae
  */
 import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
+import { PromptCacheBreakpoint$inboundSchema, PromptCacheBreakpoint$outboundSchema, } from "./promptcachebreakpoint.js";
 /** @internal */
 export const InputText$inboundSchema = z.object({
+    prompt_cache_breakpoint: z.nullable(PromptCacheBreakpoint$inboundSchema)
+        .optional(),
     text: z.string(),
     type: z.literal("input_text"),
+}).transform((v) => {
+    return remap$(v, {
+        "prompt_cache_breakpoint": "promptCacheBreakpoint",
+    });
 });
 /** @internal */
 export const InputText$outboundSchema = z.object({
+    promptCacheBreakpoint: z.nullable(PromptCacheBreakpoint$outboundSchema)
+        .optional(),
     text: z.string(),
     type: z.literal("input_text"),
+}).transform((v) => {
+    return remap$(v, {
+        promptCacheBreakpoint: "prompt_cache_breakpoint",
+    });
 });
 export function inputTextToJSON(inputText) {
     return JSON.stringify(InputText$outboundSchema.parse(inputText));

package/esm/models/promptcachebreakpoint.d.ts

@@ -0,0 +1,29 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+export declare const PromptCacheBreakpointMode: {
+    readonly Explicit: "explicit";
+};
+export type PromptCacheBreakpointMode = ClosedEnum<typeof PromptCacheBreakpointMode>;
+/**
+ * Marks an explicit prompt-cache boundary on this content block. Everything through the block carrying this marker is part of the candidate cached prefix. Only supported by OpenAI GPT-5.6 and newer.
+ */
+export type PromptCacheBreakpoint = {
+    mode: PromptCacheBreakpointMode;
+};
+/** @internal */
+export declare const PromptCacheBreakpointMode$inboundSchema: z.ZodEnum<typeof PromptCacheBreakpointMode>;
+/** @internal */
+export declare const PromptCacheBreakpointMode$outboundSchema: z.ZodEnum<typeof PromptCacheBreakpointMode>;
+/** @internal */
+export declare const PromptCacheBreakpoint$inboundSchema: z.ZodType<PromptCacheBreakpoint, unknown>;
+/** @internal */
+export type PromptCacheBreakpoint$Outbound = {
+    mode: string;
+};
+/** @internal */
+export declare const PromptCacheBreakpoint$outboundSchema: z.ZodType<PromptCacheBreakpoint$Outbound, PromptCacheBreakpoint>;
+export declare function promptCacheBreakpointToJSON(promptCacheBreakpoint: PromptCacheBreakpoint): string;
+export declare function promptCacheBreakpointFromJSON(jsonString: string): SafeParseResult<PromptCacheBreakpoint, SDKValidationError>;
+//# sourceMappingURL=promptcachebreakpoint.d.ts.map

package/esm/models/promptcachebreakpoint.js

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f8222f76987b
+ */
+import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+export const PromptCacheBreakpointMode = {
+    Explicit: "explicit",
+};
+/** @internal */
+export const PromptCacheBreakpointMode$inboundSchema = z.enum(PromptCacheBreakpointMode);
+/** @internal */
+export const PromptCacheBreakpointMode$outboundSchema = PromptCacheBreakpointMode$inboundSchema;
+/** @internal */
+export const PromptCacheBreakpoint$inboundSchema = z.object({
+    mode: PromptCacheBreakpointMode$inboundSchema,
+});
+/** @internal */
+export const PromptCacheBreakpoint$outboundSchema = z.object({
+    mode: PromptCacheBreakpointMode$outboundSchema,
+});
+export function promptCacheBreakpointToJSON(promptCacheBreakpoint) {
+    return JSON.stringify(PromptCacheBreakpoint$outboundSchema.parse(promptCacheBreakpoint));
+}
+export function promptCacheBreakpointFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => PromptCacheBreakpoint$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'PromptCacheBreakpoint' from JSON`);
+}
+//# sourceMappingURL=promptcachebreakpoint.js.map

package/esm/models/promptcacheoptions.d.ts

@@ -0,0 +1,24 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+export declare const PromptCacheOptionsMode: {
+    readonly Explicit: "explicit";
+};
+export type PromptCacheOptionsMode = ClosedEnum<typeof PromptCacheOptionsMode>;
+/**
+ * Request-level prompt-cache controls. `mode: "explicit"` disables OpenAI-managed breakpoints so only blocks marked with `prompt_cache_breakpoint` are cached. Only supported by OpenAI GPT-5.6 and newer.
+ */
+export type PromptCacheOptions = {
+    mode: PromptCacheOptionsMode;
+    ttl?: string | null | undefined;
+};
+/** @internal */
+export declare const PromptCacheOptionsMode$outboundSchema: z.ZodEnum<typeof PromptCacheOptionsMode>;
+/** @internal */
+export type PromptCacheOptions$Outbound = {
+    mode: string;
+    ttl?: string | null | undefined;
+};
+/** @internal */
+export declare const PromptCacheOptions$outboundSchema: z.ZodType<PromptCacheOptions$Outbound, PromptCacheOptions>;
+export declare function promptCacheOptionsToJSON(promptCacheOptions: PromptCacheOptions): string;
+//# sourceMappingURL=promptcacheoptions.d.ts.map

package/esm/models/promptcacheoptions.js

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: beb41f51263a
+ */
+import * as z from "zod/v4";
+export const PromptCacheOptionsMode = {
+    Explicit: "explicit",
+};
+/** @internal */
+export const PromptCacheOptionsMode$outboundSchema = z.enum(PromptCacheOptionsMode);
+/** @internal */
+export const PromptCacheOptions$outboundSchema = z.object({
+    mode: PromptCacheOptionsMode$outboundSchema,
+    ttl: z.nullable(z.string()).optional(),
+});
+export function promptCacheOptionsToJSON(promptCacheOptions) {
+    return JSON.stringify(PromptCacheOptions$outboundSchema.parse(promptCacheOptions));
+}
+//# sourceMappingURL=promptcacheoptions.js.map

package/esm/models/reasoningconfig.d.ts

@@ -1,4 +1,5 @@
 import * as z from "zod/v4";
+import { ReasoningContext } from "./reasoningcontext.js";
 import { ReasoningEffort } from "./reasoningeffort.js";
 import { ReasoningMode } from "./reasoningmode.js";
 import { ReasoningSummaryVerbosity } from "./reasoningsummaryverbosity.js";
@@ -6,6 +7,10 @@ import { ReasoningSummaryVerbosity } from "./reasoningsummaryverbosity.js";
  * Configuration for reasoning mode in the response
  */
 export type ReasoningConfig = {
+    /**
+     * Controls which reasoning is available to the model. `auto` uses the model default (same as omitting); `all_turns` includes reasoning from earlier turns passed in input; `current_turn` limits to the current turn only. Only supported by OpenAI GPT-5.6 and newer.
+     */
+    context?: ReasoningContext | null | undefined;
     effort?: ReasoningEffort | null | undefined;
     /**
      * Selects the reasoning mode. `standard` is the default; `pro` engages deeper reasoning on models that support it, billed at standard token rates. Only supported by OpenAI GPT-5.6 and newer.
@@ -17,6 +22,7 @@ export type ReasoningConfig = {
 };
 /** @internal */
 export type ReasoningConfig$Outbound = {
+    context?: string | null | undefined;
     effort?: string | null | undefined;
     mode?: string | null | undefined;
     summary?: string | null | undefined;

package/esm/models/reasoningconfig.js

@@ -4,11 +4,13 @@
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
+import { ReasoningContext$outboundSchema, } from "./reasoningcontext.js";
 import { ReasoningEffort$outboundSchema, } from "./reasoningeffort.js";
 import { ReasoningMode$outboundSchema, } from "./reasoningmode.js";
 import { ReasoningSummaryVerbosity$outboundSchema, } from "./reasoningsummaryverbosity.js";
 /** @internal */
 export const ReasoningConfig$outboundSchema = z.object({
+    context: z.nullable(ReasoningContext$outboundSchema).optional(),
     effort: z.nullable(ReasoningEffort$outboundSchema).optional(),
     mode: z.nullable(ReasoningMode$outboundSchema).optional(),
     summary: z.nullable(ReasoningSummaryVerbosity$outboundSchema).optional(),

package/esm/models/reasoningcontext.d.ts

@@ -0,0 +1,19 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * Controls which reasoning is available to the model. `auto` uses the model default (same as omitting); `all_turns` includes reasoning from earlier turns passed in input; `current_turn` limits to the current turn only. Only supported by OpenAI GPT-5.6 and newer.
+ */
+export declare const ReasoningContext: {
+    readonly Auto: "auto";
+    readonly AllTurns: "all_turns";
+    readonly CurrentTurn: "current_turn";
+};
+/**
+ * Controls which reasoning is available to the model. `auto` uses the model default (same as omitting); `all_turns` includes reasoning from earlier turns passed in input; `current_turn` limits to the current turn only. Only supported by OpenAI GPT-5.6 and newer.
+ */
+export type ReasoningContext = OpenEnum<typeof ReasoningContext>;
+/** @internal */
+export declare const ReasoningContext$inboundSchema: z.ZodType<ReasoningContext, unknown>;
+/** @internal */
+export declare const ReasoningContext$outboundSchema: z.ZodType<string, ReasoningContext>;
+//# sourceMappingURL=reasoningcontext.d.ts.map

package/esm/models/reasoningcontext.js

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 999ae13f294f
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * Controls which reasoning is available to the model. `auto` uses the model default (same as omitting); `all_turns` includes reasoning from earlier turns passed in input; `current_turn` limits to the current turn only. Only supported by OpenAI GPT-5.6 and newer.
+ */
+export const ReasoningContext = {
+    Auto: "auto",
+    AllTurns: "all_turns",
+    CurrentTurn: "current_turn",
+};
+/** @internal */
+export const ReasoningContext$inboundSchema = openEnums.inboundSchema(ReasoningContext);
+/** @internal */
+export const ReasoningContext$outboundSchema = openEnums.outboundSchema(ReasoningContext);
+//# sourceMappingURL=reasoningcontext.js.map

package/esm/models/responsesrequest.d.ts

@@ -32,6 +32,7 @@ import { OutputModalityEnum } from "./outputmodalityenum.js";
 import { ParetoRouterPlugin, ParetoRouterPlugin$Outbound } from "./paretorouterplugin.js";
 import { Preview20250311WebSearchServerTool, Preview20250311WebSearchServerTool$Outbound } from "./preview20250311websearchservertool.js";
 import { PreviewWebSearchServerTool, PreviewWebSearchServerTool$Outbound } from "./previewwebsearchservertool.js";
+import { PromptCacheOptions, PromptCacheOptions$Outbound } from "./promptcacheoptions.js";
 import { ProviderPreferences, ProviderPreferences$Outbound } from "./providerpreferences.js";
 import { ReasoningConfig, ReasoningConfig$Outbound } from "./reasoningconfig.js";
 import { ResponseHealingPlugin, ResponseHealingPlugin$Outbound } from "./responsehealingplugin.js";
@@ -137,6 +138,10 @@ export type ResponsesRequest = {
     previousResponseId?: string | null | undefined;
     prompt?: StoredPromptTemplate | null | undefined;
     promptCacheKey?: string | null | undefined;
+    /**
+     * Request-level prompt-cache controls. `mode: "explicit"` disables OpenAI-managed breakpoints so only blocks marked with `prompt_cache_breakpoint` are cached. Only supported by OpenAI GPT-5.6 and newer.
+     */
+    promptCacheOptions?: PromptCacheOptions | null | undefined;
     /**
      * When multiple model providers are available, optionally indicate your routing preference.
      */
@@ -264,6 +269,7 @@ export type ResponsesRequest$Outbound = {
     previous_response_id?: string | null | undefined;
     prompt?: StoredPromptTemplate$Outbound | null | undefined;
     prompt_cache_key?: string | null | undefined;
+    prompt_cache_options?: PromptCacheOptions$Outbound | null | undefined;
     provider?: ProviderPreferences$Outbound | null | undefined;
     reasoning?: ReasoningConfig$Outbound | null | undefined;
     safety_identifier?: string | null | undefined;

package/esm/models/responsesrequest.js

@@ -37,6 +37,7 @@ import { OutputModalityEnum$outboundSchema, } from "./outputmodalityenum.js";
 import { ParetoRouterPlugin$outboundSchema, } from "./paretorouterplugin.js";
 import { Preview20250311WebSearchServerTool$outboundSchema, } from "./preview20250311websearchservertool.js";
 import { PreviewWebSearchServerTool$outboundSchema, } from "./previewwebsearchservertool.js";
+import { PromptCacheOptions$outboundSchema, } from "./promptcacheoptions.js";
 import { ProviderPreferences$outboundSchema, } from "./providerpreferences.js";
 import { ReasoningConfig$outboundSchema, } from "./reasoningconfig.js";
 import { ResponseHealingPlugin$outboundSchema, } from "./responsehealingplugin.js";
@@ -152,6 +153,7 @@ export const ResponsesRequest$outboundSchema = z.object({
     previousResponseId: z.nullable(z.string()).optional(),
     prompt: z.nullable(StoredPromptTemplate$outboundSchema).optional(),
     promptCacheKey: z.nullable(z.string()).optional(),
+    promptCacheOptions: z.nullable(PromptCacheOptions$outboundSchema).optional(),
     provider: z.nullable(ProviderPreferences$outboundSchema).optional(),
     reasoning: z.nullable(ReasoningConfig$outboundSchema).optional(),
     safetyIdentifier: z.nullable(z.string()).optional(),
@@ -209,6 +211,7 @@ export const ResponsesRequest$outboundSchema = z.object({
         presencePenalty: "presence_penalty",
         previousResponseId: "previous_response_id",
         promptCacheKey: "prompt_cache_key",
+        promptCacheOptions: "prompt_cache_options",
         safetyIdentifier: "safety_identifier",
         serviceTier: "service_tier",
         sessionId: "session_id",

package/esm/models/usage.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 export type InputTokensDetails = {
+    cacheWriteTokens?: number | null | undefined;
     cachedTokens: number;
 };
 export type OutputTokensDetails = {

package/esm/models/usage.js

@@ -7,9 +7,11 @@ import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 /** @internal */
 export const InputTokensDetails$inboundSchema = z.object({
+    cache_write_tokens: z.nullable(z.int()).optional(),
     cached_tokens: z.int(),
 }).transform((v) => {
     return remap$(v, {
+        "cache_write_tokens": "cacheWriteTokens",
         "cached_tokens": "cachedTokens",
     });
 });

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.13.35",
+  "version": "0.13.36",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.13.35",
+  "version": "0.13.36",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 400+ language models through a unified API.",
   "keywords": [
@@ -21,8 +21,8 @@
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.22.0",
   "publishConfig": {
-    "access": "public",
-    "provenance": true
+    "provenance": true,
+    "access": "public"
   },
   "type": "module",
   "main": "./esm/index.js",
@@ -73,15 +73,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "compile": "tsc",
-    "prepare": "npm run build",
-    "test": "vitest --run --project unit",
+    "test:transit": "exit 0",
     "typecheck": "tsc --noEmit",
     "typecheck:transit": "exit 0",
+    "test:watch": "vitest --watch --project unit",
+    "compile": "tsc",
     "postinstall": "node scripts/check-types.js || true",
-    "test:e2e": "vitest --run --project e2e",
-    "test:transit": "exit 0",
-    "test:watch": "vitest --watch --project unit"
+    "prepare": "npm run build",
+    "test": "vitest --run --project unit",
+    "test:e2e": "vitest --run --project e2e"
   },
   "peerDependencies": {},
   "devDependencies": {