@openrouter/sdk 1.3.29 → 1.3.30

package/esm/models/oranthropicservertooluseblock.js

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6dab967e4db6
+ */
+import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+import { ORAnthropicNullableCaller$inboundSchema, } from "./oranthropicnullablecaller.js";
+/** @internal */
+export const ORAnthropicServerToolUseBlock$inboundSchema = z.object({
+    caller: z.nullable(ORAnthropicNullableCaller$inboundSchema).optional(),
+    id: z.string(),
+    input: z.any().optional(),
+    name: z.string(),
+    type: z.literal("server_tool_use"),
+});
+export function orAnthropicServerToolUseBlockFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ORAnthropicServerToolUseBlock$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ORAnthropicServerToolUseBlock' from JSON`);
+}
+//# sourceMappingURL=oranthropicservertooluseblock.js.map

package/esm/models/oranthropicshelltoolresult.d.ts

@@ -0,0 +1,43 @@
+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 ORAnthropicShellToolResultTypeContainerFileCitation: {
+    readonly ContainerFileCitation: "container_file_citation";
+};
+export type ORAnthropicShellToolResultTypeContainerFileCitation = ClosedEnum<typeof ORAnthropicShellToolResultTypeContainerFileCitation>;
+export type ORAnthropicShellToolResultFile = {
+    containerId: string;
+    endIndex: number;
+    fileId: string;
+    filename: string;
+    startIndex: number;
+    type: ORAnthropicShellToolResultTypeContainerFileCitation;
+};
+/**
+ * Output of an `openrouter:shell` call executed in the OpenRouter sandbox
+ */
+export type ORAnthropicShellToolResult = {
+    /**
+     * The canonical container id the command ran under — the `{container_id}` for the Container Files API, reusable as a `container_reference` in later requests. Present on every sandbox-executed call, even when no files changed.
+     */
+    containerId?: string | undefined;
+    content: {
+        [k: string]: any;
+    };
+    /**
+     * Citations for the files the sandbox command created or modified, most-recently-touched first (at most 10). Retrieve them via the Container Files API.
+     */
+    files?: Array<ORAnthropicShellToolResultFile> | undefined;
+    toolUseId: string;
+    type: "openrouter_shell_tool_result";
+};
+/** @internal */
+export declare const ORAnthropicShellToolResultTypeContainerFileCitation$inboundSchema: z.ZodEnum<typeof ORAnthropicShellToolResultTypeContainerFileCitation>;
+/** @internal */
+export declare const ORAnthropicShellToolResultFile$inboundSchema: z.ZodType<ORAnthropicShellToolResultFile, unknown>;
+export declare function orAnthropicShellToolResultFileFromJSON(jsonString: string): SafeParseResult<ORAnthropicShellToolResultFile, SDKValidationError>;
+/** @internal */
+export declare const ORAnthropicShellToolResult$inboundSchema: z.ZodType<ORAnthropicShellToolResult, unknown>;
+export declare function orAnthropicShellToolResultFromJSON(jsonString: string): SafeParseResult<ORAnthropicShellToolResult, SDKValidationError>;
+//# sourceMappingURL=oranthropicshelltoolresult.d.ts.map

package/esm/models/oranthropicshelltoolresult.js

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6c0f19243a3e
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+export const ORAnthropicShellToolResultTypeContainerFileCitation = {
+    ContainerFileCitation: "container_file_citation",
+};
+/** @internal */
+export const ORAnthropicShellToolResultTypeContainerFileCitation$inboundSchema = z
+    .enum(ORAnthropicShellToolResultTypeContainerFileCitation);
+/** @internal */
+export const ORAnthropicShellToolResultFile$inboundSchema = z.object({
+    container_id: z.string(),
+    end_index: z.int(),
+    file_id: z.string(),
+    filename: z.string(),
+    start_index: z.int(),
+    type: ORAnthropicShellToolResultTypeContainerFileCitation$inboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        "container_id": "containerId",
+        "end_index": "endIndex",
+        "file_id": "fileId",
+        "start_index": "startIndex",
+    });
+});
+export function orAnthropicShellToolResultFileFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ORAnthropicShellToolResultFile$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ORAnthropicShellToolResultFile' from JSON`);
+}
+/** @internal */
+export const ORAnthropicShellToolResult$inboundSchema = z.object({
+    container_id: z.string().optional(),
+    content: z.record(z.string(), z.any()),
+    files: z.array(z.lazy(() => ORAnthropicShellToolResultFile$inboundSchema))
+        .optional(),
+    tool_use_id: z.string(),
+    type: z.literal("openrouter_shell_tool_result"),
+}).transform((v) => {
+    return remap$(v, {
+        "container_id": "containerId",
+        "tool_use_id": "toolUseId",
+    });
+});
+export function orAnthropicShellToolResultFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ORAnthropicShellToolResult$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ORAnthropicShellToolResult' from JSON`);
+}
+//# sourceMappingURL=oranthropicshelltoolresult.js.map

package/esm/models/oranthropicstopreason.d.ts

@@ -0,0 +1,16 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+export declare const ORAnthropicStopReason: {
+    readonly EndTurn: "end_turn";
+    readonly MaxTokens: "max_tokens";
+    readonly ModelContextWindowExceeded: "model_context_window_exceeded";
+    readonly StopSequence: "stop_sequence";
+    readonly ToolUse: "tool_use";
+    readonly PauseTurn: "pause_turn";
+    readonly Refusal: "refusal";
+    readonly Compaction: "compaction";
+};
+export type ORAnthropicStopReason = OpenEnum<typeof ORAnthropicStopReason>;
+/** @internal */
+export declare const ORAnthropicStopReason$inboundSchema: z.ZodType<ORAnthropicStopReason, unknown>;
+//# sourceMappingURL=oranthropicstopreason.d.ts.map

package/esm/models/oranthropicstopreason.js

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2f8990149810
+ */
+import * as openEnums from "../types/enums.js";
+export const ORAnthropicStopReason = {
+    EndTurn: "end_turn",
+    MaxTokens: "max_tokens",
+    ModelContextWindowExceeded: "model_context_window_exceeded",
+    StopSequence: "stop_sequence",
+    ToolUse: "tool_use",
+    PauseTurn: "pause_turn",
+    Refusal: "refusal",
+    Compaction: "compaction",
+};
+/** @internal */
+export const ORAnthropicStopReason$inboundSchema = openEnums.inboundSchema(ORAnthropicStopReason);
+//# sourceMappingURL=oranthropicstopreason.js.map

package/esm/models/outputfusionservertoolitem.d.ts

@@ -19,7 +19,7 @@ export type FailedModel = {
      */
     statusCode?: number | undefined;
 };
-export type ResponseT = {
+export type OutputFusionServerToolItemResponse = {
     content?: string | undefined;
     model: string;
 };
@@ -51,7 +51,7 @@ export type OutputFusionServerToolItem = {
     /**
      * Analysis models that produced a response in this fusion run, with each model's full panel content.
      */
-    responses?: Array<ResponseT> | undefined;
+    responses?: Array<OutputFusionServerToolItemResponse> | undefined;
     /**
      * Web pages the analysis panels and analyst retrieved via web search during this fusion run, deduplicated by URL across the whole run. Present when at least one model cited a source.
      */
@@ -72,16 +72,16 @@ export declare const FailedModel$outboundSchema: z.ZodType<FailedModel$Outbound,
 export declare function failedModelToJSON(failedModel: FailedModel): string;
 export declare function failedModelFromJSON(jsonString: string): SafeParseResult<FailedModel, SDKValidationError>;
 /** @internal */
-export declare const ResponseT$inboundSchema: z.ZodType<ResponseT, unknown>;
+export declare const OutputFusionServerToolItemResponse$inboundSchema: z.ZodType<OutputFusionServerToolItemResponse, unknown>;
 /** @internal */
-export type ResponseT$Outbound = {
+export type OutputFusionServerToolItemResponse$Outbound = {
     content?: string | undefined;
     model: string;
 };
 /** @internal */
-export declare const ResponseT$outboundSchema: z.ZodType<ResponseT$Outbound, ResponseT>;
-export declare function responseToJSON(responseT: ResponseT): string;
-export declare function responseFromJSON(jsonString: string): SafeParseResult<ResponseT, SDKValidationError>;
+export declare const OutputFusionServerToolItemResponse$outboundSchema: z.ZodType<OutputFusionServerToolItemResponse$Outbound, OutputFusionServerToolItemResponse>;
+export declare function outputFusionServerToolItemResponseToJSON(outputFusionServerToolItemResponse: OutputFusionServerToolItemResponse): string;
+export declare function outputFusionServerToolItemResponseFromJSON(jsonString: string): SafeParseResult<OutputFusionServerToolItemResponse, SDKValidationError>;
 /** @internal */
 export declare const OutputFusionServerToolItemType$inboundSchema: z.ZodEnum<typeof OutputFusionServerToolItemType>;
 /** @internal */
@@ -95,7 +95,7 @@ export type OutputFusionServerToolItem$Outbound = {
     failed_models?: Array<FailedModel$Outbound> | undefined;
     failure_reason?: string | undefined;
     id?: string | undefined;
-    responses?: Array<ResponseT$Outbound> | undefined;
+    responses?: Array<OutputFusionServerToolItemResponse$Outbound> | undefined;
     sources?: Array<FusionSource$Outbound> | undefined;
     status: string;
     type: string;

package/esm/models/outputfusionservertoolitem.js

@@ -39,20 +39,20 @@ export function failedModelFromJSON(jsonString) {
     return safeParse(jsonString, (x) => FailedModel$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'FailedModel' from JSON`);
 }
 /** @internal */
-export const ResponseT$inboundSchema = z.object({
+export const OutputFusionServerToolItemResponse$inboundSchema = z.object({
     content: z.string().optional(),
     model: z.string(),
 });
 /** @internal */
-export const ResponseT$outboundSchema = z.object({
+export const OutputFusionServerToolItemResponse$outboundSchema = z.object({
     content: z.string().optional(),
     model: z.string(),
 });
-export function responseToJSON(responseT) {
-    return JSON.stringify(ResponseT$outboundSchema.parse(responseT));
+export function outputFusionServerToolItemResponseToJSON(outputFusionServerToolItemResponse) {
+    return JSON.stringify(OutputFusionServerToolItemResponse$outboundSchema.parse(outputFusionServerToolItemResponse));
 }
-export function responseFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => ResponseT$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ResponseT' from JSON`);
+export function outputFusionServerToolItemResponseFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => OutputFusionServerToolItemResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'OutputFusionServerToolItemResponse' from JSON`);
 }
 /** @internal */
 export const OutputFusionServerToolItemType$inboundSchema = z.enum(OutputFusionServerToolItemType);
@@ -65,7 +65,7 @@ export const OutputFusionServerToolItem$inboundSchema = z.object({
     failed_models: z.array(z.lazy(() => FailedModel$inboundSchema)).optional(),
     failure_reason: z.string().optional(),
     id: z.string().optional(),
-    responses: z.array(z.lazy(() => ResponseT$inboundSchema)).optional(),
+    responses: z.array(z.lazy(() => OutputFusionServerToolItemResponse$inboundSchema)).optional(),
     sources: z.array(FusionSource$inboundSchema).optional(),
     status: ToolCallStatus$inboundSchema,
     type: OutputFusionServerToolItemType$inboundSchema,
@@ -82,7 +82,7 @@ export const OutputFusionServerToolItem$outboundSchema = z.object({
     failedModels: z.array(z.lazy(() => FailedModel$outboundSchema)).optional(),
     failureReason: z.string().optional(),
     id: z.string().optional(),
-    responses: z.array(z.lazy(() => ResponseT$outboundSchema)).optional(),
+    responses: z.array(z.lazy(() => OutputFusionServerToolItemResponse$outboundSchema)).optional(),
     sources: z.array(FusionSource$outboundSchema).optional(),
     status: ToolCallStatus$outboundSchema,
     type: OutputFusionServerToolItemType$outboundSchema,

package/esm/models/submitgenerationfeedbackrequest.d.ts

@@ -3,7 +3,7 @@ import { OpenEnum } from "../types/enums.js";
 /**
  * The category of feedback being reported
  */
-export declare const Category: {
+export declare const SubmitGenerationFeedbackRequestCategory: {
     readonly Latency: "latency";
     readonly Incoherence: "incoherence";
     readonly IncorrectResponse: "incorrect_response";
@@ -15,7 +15,7 @@ export declare const Category: {
 /**
  * The category of feedback being reported
  */
-export type Category = OpenEnum<typeof Category>;
+export type SubmitGenerationFeedbackRequestCategory = OpenEnum<typeof SubmitGenerationFeedbackRequestCategory>;
 /**
  * Structured feedback about a specific generation
  */
@@ -23,7 +23,7 @@ export type SubmitGenerationFeedbackRequest = {
     /**
      * The category of feedback being reported
      */
-    category: Category;
+    category: SubmitGenerationFeedbackRequestCategory;
     /**
      * An optional free-text comment describing the feedback
      */
@@ -34,7 +34,7 @@ export type SubmitGenerationFeedbackRequest = {
     generationId: string;
 };
 /** @internal */
-export declare const Category$outboundSchema: z.ZodType<string, Category>;
+export declare const SubmitGenerationFeedbackRequestCategory$outboundSchema: z.ZodType<string, SubmitGenerationFeedbackRequestCategory>;
 /** @internal */
 export type SubmitGenerationFeedbackRequest$Outbound = {
     category: string;

package/esm/models/submitgenerationfeedbackrequest.js

@@ -8,7 +8,7 @@ import * as openEnums from "../types/enums.js";
 /**
  * The category of feedback being reported
  */
-export const Category = {
+export const SubmitGenerationFeedbackRequestCategory = {
     Latency: "latency",
     Incoherence: "incoherence",
     IncorrectResponse: "incorrect_response",
@@ -18,11 +18,10 @@ export const Category = {
     Other: "other",
 };
 /** @internal */
-export const Category$outboundSchema = openEnums
-    .outboundSchema(Category);
+export const SubmitGenerationFeedbackRequestCategory$outboundSchema = openEnums.outboundSchema(SubmitGenerationFeedbackRequestCategory);
 /** @internal */
 export const SubmitGenerationFeedbackRequest$outboundSchema = z.object({
-    category: Category$outboundSchema,
+    category: SubmitGenerationFeedbackRequestCategory$outboundSchema,
     comment: z.string().optional(),
     generationId: z.string(),
 }).transform((v) => {

package/esm/sdk/batch.d.ts

@@ -0,0 +1,37 @@
+import { ClientSDK, RequestOptions } from "../lib/sdks.js";
+import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
+import { PageIterator } from "../types/operations.js";
+export declare class Batch extends ClientSDK {
+    /**
+     * List batches
+     *
+     * @remarks
+     * Lists batches in the workspace of the authenticating API key, newest first. To fetch the next page, pass the previous page's `last_id` as `after`. List items omit `results`. Use `GET /batches/{id}` to get them. See the [Batch API Quickstart](https://openrouter.ai/docs/batch-quickstart).
+     */
+    list(request?: operations.ListBatchesRequest | undefined, options?: RequestOptions): Promise<PageIterator<operations.ListBatchesResponse, {
+        cursor: string;
+    }>>;
+    /**
+     * Create a batch
+     *
+     * @remarks
+     * Creates a batch of requests that run asynchronously against a single endpoint (`/v1/chat/completions`, `/v1/responses`, `/v1/messages`, `/v1/embeddings`). Returns `202` with `status: "validating"`. Poll `GET /batches/{id}` for progress and results. See the [Batch API Quickstart](https://openrouter.ai/docs/batch-quickstart).
+     */
+    createBatches(request: operations.CreateBatchesRequest, options?: RequestOptions): Promise<models.BatchObject>;
+    /**
+     * Delete a batch
+     *
+     * @remarks
+     * Deletes a batch in a terminal status (`completed`, `failed`, `expired`, or `cancelled`) and its stored requests and results. Batches still in progress return `409`. Billing and usage records are kept. See the [Batch API Quickstart](https://openrouter.ai/docs/batch-quickstart).
+     */
+    delete(request: operations.DeleteBatchRequest, options?: RequestOptions): Promise<models.BatchDeletedObject>;
+    /**
+     * Get a batch
+     *
+     * @remarks
+     * Returns a batch with its status and request counts. Batches in a terminal status include `results`. Failed batches report the reason in `error.message`. See the [Batch API Quickstart](https://openrouter.ai/docs/batch-quickstart).
+     */
+    getBatches(request: operations.GetBatchesRequest, options?: RequestOptions): Promise<models.BatchObject>;
+}
+//# sourceMappingURL=batch.d.ts.map

package/esm/sdk/batch.js

@@ -0,0 +1,50 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 254a218f7d6b
+ */
+import { batchCreateBatches } from "../funcs/batchCreateBatches.js";
+import { batchDelete } from "../funcs/batchDelete.js";
+import { batchGetBatches } from "../funcs/batchGetBatches.js";
+import { batchList } from "../funcs/batchList.js";
+import { ClientSDK } from "../lib/sdks.js";
+import { unwrapAsync } from "../types/fp.js";
+import { unwrapResultIterator } from "../types/operations.js";
+export class Batch extends ClientSDK {
+    /**
+     * List batches
+     *
+     * @remarks
+     * Lists batches in the workspace of the authenticating API key, newest first. To fetch the next page, pass the previous page's `last_id` as `after`. List items omit `results`. Use `GET /batches/{id}` to get them. See the [Batch API Quickstart](https://openrouter.ai/docs/batch-quickstart).
+     */
+    async list(request, options) {
+        return unwrapResultIterator(batchList(this, request, options));
+    }
+    /**
+     * Create a batch
+     *
+     * @remarks
+     * Creates a batch of requests that run asynchronously against a single endpoint (`/v1/chat/completions`, `/v1/responses`, `/v1/messages`, `/v1/embeddings`). Returns `202` with `status: "validating"`. Poll `GET /batches/{id}` for progress and results. See the [Batch API Quickstart](https://openrouter.ai/docs/batch-quickstart).
+     */
+    async createBatches(request, options) {
+        return unwrapAsync(batchCreateBatches(this, request, options));
+    }
+    /**
+     * Delete a batch
+     *
+     * @remarks
+     * Deletes a batch in a terminal status (`completed`, `failed`, `expired`, or `cancelled`) and its stored requests and results. Batches still in progress return `409`. Billing and usage records are kept. See the [Batch API Quickstart](https://openrouter.ai/docs/batch-quickstart).
+     */
+    async delete(request, options) {
+        return unwrapAsync(batchDelete(this, request, options));
+    }
+    /**
+     * Get a batch
+     *
+     * @remarks
+     * Returns a batch with its status and request counts. Batches in a terminal status include `results`. Failed batches report the reason in `error.message`. See the [Batch API Quickstart](https://openrouter.ai/docs/batch-quickstart).
+     */
+    async getBatches(request, options) {
+        return unwrapAsync(batchGetBatches(this, request, options));
+    }
+}
+//# sourceMappingURL=batch.js.map

package/esm/sdk/sdk.d.ts

@@ -2,6 +2,7 @@ import { ClientSDK } from "../lib/sdks.js";
 import { Alpha } from "./alpha.js";
 import { Analytics } from "./analytics.js";
 import { APIKeys } from "./apikeys.js";
+import { Batch } from "./batch.js";
 import { Benchmarks } from "./benchmarks.js";
 import { Beta } from "./beta.js";
 import { BYOK } from "./byok.js";
@@ -49,6 +50,8 @@ export declare class OpenRouter extends ClientSDK {
     get stt(): STT;
     private _oAuth?;
     get oAuth(): OAuth;
+    private _batch?;
+    get batch(): Batch;
     private _benchmarks?;
     get benchmarks(): Benchmarks;
     private _byok?;

package/esm/sdk/sdk.js

@@ -6,6 +6,7 @@ import { ClientSDK } from "../lib/sdks.js";
 import { Alpha } from "./alpha.js";
 import { Analytics } from "./analytics.js";
 import { APIKeys } from "./apikeys.js";
+import { Batch } from "./batch.js";
 import { Benchmarks } from "./benchmarks.js";
 import { Beta } from "./beta.js";
 import { BYOK } from "./byok.js";
@@ -56,6 +57,9 @@ export class OpenRouter extends ClientSDK {
     get oAuth() {
         return (this._oAuth ?? (this._oAuth = new OAuth(this._options)));
     }
+    get batch() {
+        return (this._batch ?? (this._batch = new Batch(this._options)));
+    }
     get benchmarks() {
         return (this._benchmarks ?? (this._benchmarks = new Benchmarks(this._options)));
     }

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "1.3.29",
+  "version": "1.3.30",
   "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": [
@@ -73,15 +73,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc && node scripts/unbarrel-imports.js",
     "prepublishOnly": "npm run build",
-    "prepare": "npm run build",
+    "typecheck:transit": "exit 0",
+    "compile": "tsc && node scripts/unbarrel-imports.js",
+    "postinstall": "node scripts/check-types.js || true",
     "test:e2e": "vitest --run --project e2e",
     "test:transit": "exit 0",
     "test:watch": "vitest --watch --project unit",
-    "typecheck:transit": "exit 0",
-    "test": "vitest --run --project unit",
     "typecheck": "tsc --noEmit",
-    "compile": "tsc && node scripts/unbarrel-imports.js",
-    "postinstall": "node scripts/check-types.js || true"
+    "prepare": "npm run build",
+    "test": "vitest --run --project unit"
   },
   "peerDependencies": {