@openrouter/sdk 0.0.0-beta.0 → 0.0.0-beta.17

package/.devcontainer/README.md

@@ -1,4 +1,9 @@
 
+<div align="center">
+    <a href="https://codespaces.new/OpenRouterTeam/typescript-sdk.git/tree/main"><img src="https://github.com/codespaces/badge.svg" /></a>
+</div>
+<br>
+
 > **Remember to shutdown a GitHub Codespace when it is not in use!**
 
 # Dev Containers Quick Start

package/FUNCTIONS.md

@@ -20,23 +20,25 @@ specific category of applications.
 
 ```typescript
 import { OpenRouterCore } from "@openrouter/sdk/core.js";
-import { getCredits } from "@openrouter/sdk/funcs/getCredits.js";
+import { alphaResponsesSend2 } from "@openrouter/sdk/funcs/alphaResponsesSend2.js";
 
 // Use `OpenRouterCore` for best tree-shaking performance.
 // You can create one instance of it to use across an application.
 const openRouter = new OpenRouterCore({
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 async function run() {
-  const res = await getCredits(openRouter);
+  const res = await alphaResponsesSend2(openRouter, {
+    provider: {
+      zdr: true,
+    },
+  });
   if (res.ok) {
     const { value: result } = res;
     console.log(result);
   } else {
-    console.log("getCredits failed:", res.error);
+    console.log("alphaResponsesSend2 failed:", res.error);
   }
 }
 

package/REACT_QUERY.md

@@ -23,9 +23,7 @@ import { OpenRouterProvider } from "@openrouter/sdk/react-query";
 
 const queryClient = new QueryClient();
 const openRouter = new OpenRouterCore({
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 // Retries are handled by the underlying SDK.
@@ -52,10 +50,12 @@ from TanStack Query.
 [use-query]: https://tanstack.com/query/v5/docs/framework/react/reference/useQuery
 
 ```tsx
-import { useGetCredits } from "@openrouter/sdk/react-query/getCredits.js";
+import { useAnalyticsGetActivity } from "@openrouter/sdk/react-query/analyticsGetActivity.js";
 
 export function Example() {
-  const { data, error, status } = useGetCredits();
+  const { data, error, status } = useAnalyticsGetActivity({
+    date: "2025-08-24",
+  });
 
   // Render the UI here...
 }
@@ -68,11 +68,14 @@ more options provided by the query hooks to control these behaviors.
 
 ```tsx
 import { useState } from "react";
-import { useGetCredits } from "@openrouter/sdk/react-query/getCredits.js";
+import { useAnalyticsGetActivity } from "@openrouter/sdk/react-query/analyticsGetActivity.js";
 
 export function ExampleWithOptions() {
   const [enabled, setEnabled] = useState(true);
-  const { data, error, status } = useGetCredits(
+  const { data, error, status } = useAnalyticsGetActivity(
+    {
+      date: "2025-08-24",
+    },
     {
       // TanStack Query options:
       enabled,
@@ -109,10 +112,10 @@ Query.
 [use-mutation]: https://tanstack.com/query/v5/docs/framework/react/reference/useMutation
 
 ```tsx
-import { usePostCreditsCoinbaseMutation } from "@openrouter/sdk/react-query/postCreditsCoinbase.js";
+import { useAlphaResponsesSend2Mutation } from "@openrouter/sdk/react-query/alphaResponsesSend2.js";
 
 export function Example() {
-  const { mutate, status } = usePostCreditsCoinbaseMutation();
+  const { mutate, status } = useAlphaResponsesSend2Mutation();
 
   return (
     <form
@@ -121,7 +124,11 @@ export function Example() {
 
         // Read form data here...
 
-        mutate();
+        mutate({
+          provider: {
+            zdr: true,
+          },
+        });
       }}
     >
       {/* Form fields go here... */} 
@@ -137,10 +144,10 @@ Since the underlying SDK handles request timeouts and retries, there are a few
 more options provided by the mutation hooks to control these behaviors.
 
 ```tsx
-import { usePostCreditsCoinbaseMutation } from "@openrouter/sdk/react-query/postCreditsCoinbase.js";
+import { useAlphaResponsesSend2Mutation } from "@openrouter/sdk/react-query/alphaResponsesSend2.js";
 
 export function ExampleWithOptions() {
-  const { mutate, status } = usePostCreditsCoinbaseMutation({
+  const { mutate, status } = useAlphaResponsesSend2Mutation({
     // TanStack Query options:
     networkMode: "online",
     gcTime: 5 * 60 * 1000, // 5 minutes
@@ -172,7 +179,7 @@ query hook there are two functions that help invalidate cached data:
 
 ```tsx
 import { useQueryClient } from "@tanstack/react-query";
-import { invalidateGetCredits, invalidateAllGetCredits } from "@openrouter/sdk/react-query/getCredits.js";
+import { invalidateAnalyticsGetActivity, invalidateAllAnalyticsGetActivity } from "@openrouter/sdk/react-query/analyticsGetActivity.js";
 // Replace this with a real mutation
 import { useExampleMutation } from "@openrouter/sdk/react-query/example.js";
 
@@ -190,9 +197,9 @@ export function Example() {
         mutate(formData, {
           onSuccess: () => {
             // Invalidate a single cache entry:
-            invalidateGetCredits(queryClient, /* ... arguments ... */);
+            invalidateAnalyticsGetActivity(queryClient, /* ... arguments ... */);
             // OR, invalidate all cache entries for the query targets:
-            invalidateAllGetCredits(queryClient);
+            invalidateAllAnalyticsGetActivity(queryClient);
           },
         });
       }}
@@ -220,13 +227,11 @@ import { ErrorBoundary } from "react-error-boundary";
 
 import { OpenRouterCore } from "@openrouter/sdk";
 import { OpenRouterProvider } from "@openrouter/sdk/react-query";
-import { useGetCreditsSuspense } from "@openrouter/sdk/react-query/getCredits.js";
+import { useAnalyticsGetActivitySuspense } from "@openrouter/sdk/react-query/analyticsGetActivity.js";
 
 const queryClient = new QueryClient();
 const openRouter = new OpenRouterCore({
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 export function App() {
@@ -257,7 +262,9 @@ export function App() {
 }
 
 function Example() {
-  const { data } = useGetCreditsSuspense();
+  const { data } = useAnalyticsGetActivitySuspense({
+    date: "2025-08-24",
+  });
 
   // Render the UI here...
 }
@@ -277,17 +284,17 @@ import {
   QueryClient,
 } from "@tanstack/react-query";
 import { OpenRouterCore } from "@openrouter/sdk";
-import { prefetchGetCredits } from "@openrouter/sdk/react-query/getCredits.js";
+import { prefetchAnalyticsGetActivity } from "@openrouter/sdk/react-query/analyticsGetActivity.js";
 
 export default async function Page() {
   const queryClient = new QueryClient();
   const openRouter = new OpenRouterCore({
-    security: {
-      apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-    },
+    apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
   });
 
-  await prefetchGetCredits(openRouter);
+  await prefetchAnalyticsGetActivity(queryClient, openRouter, {
+    date: "2025-08-24",
+  });
 
   return (
     // HydrationBoundary is a Client Component, so hydration will happen there.

package/README.md

@@ -1,30 +1,17 @@
-# openrouter
+# OpenRouter SDK
 
-Developer-friendly & type-safe Typescript SDK specifically catered to leverage *openrouter* API.
-
-<div align="left">
-    <a href="https://www.speakeasy.com/?utm_source=openrouter&utm_campaign=typescript"><img src="https://www.speakeasy.com/assets/badges/built-by-speakeasy.svg" /></a>
-    <a href="https://opensource.org/licenses/MIT">
-        <img src="https://img.shields.io/badge/License-MIT-blue.svg" style="width: 100px; height: 28px;" />
-    </a>
-</div>
+The [OpenRouter](https://openrouter.ai/) SDK gives access to over 300 large language models on the OpenRouter chat and completion APIs, as well as the rest of our full API. For more information about the API: [OpenRouter Documentation](https://openrouter.ai/docs)
 
 <br /><br />
 > [!IMPORTANT]
 > This SDK is not yet ready for production use. To complete setup please follow the steps outlined in your [workspace](https://app.speakeasy.com/org/openrouter/sdk). Delete this section before > publishing to a package manager.
 
-<!-- Start Summary [summary] -->
-## Summary
-
-OpenRouter API: OpenAI-compatible Chat Completions API with additional OpenRouter features
-
-For more information about the API: [OpenRouter Documentation](https://openrouter.ai/docs)
-<!-- End Summary [summary] -->
+<!-- No Summary [summary] -->
 
 <!-- Start Table of Contents [toc] -->
 ## Table of Contents
 <!-- $toc-max-depth=2 -->
-* [openrouter](#openrouter)
+* [OpenRouter SDK](#openrouter-sdk)
   * [SDK Installation](#sdk-installation)
   * [Requirements](#requirements)
   * [SDK Example Usage](#sdk-example-usage)
@@ -98,13 +85,15 @@ For supported JavaScript runtimes, please consult [RUNTIMES.md](RUNTIMES.md).
 import { OpenRouter } from "@openrouter/sdk";
 
 const openRouter = new OpenRouter({
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 async function run() {
-  const result = await openRouter.getCredits();
+  const result = await openRouter.alpha.responses.send2({
+    provider: {
+      zdr: true,
+    },
+  });
 
   console.log(result);
 }
@@ -119,25 +108,46 @@ run();
 
 ### Per-Client Security Schemes
 
-This SDK supports the following security schemes globally:
+This SDK supports the following security scheme globally:
 
-| Name         | Type   | Scheme      | Environment Variable      |
-| ------------ | ------ | ----------- | ------------------------- |
-| `apiKeyAuth` | apiKey | API key     | `OPENROUTER_API_KEY_AUTH` |
-| `bearer`     | http   | HTTP Bearer | `OPENROUTER_BEARER`       |
+| Name     | Type | Scheme      | Environment Variable |
+| -------- | ---- | ----------- | -------------------- |
+| `apiKey` | http | HTTP Bearer | `OPENROUTER_API_KEY` |
 
-You can set the security parameters through the `security` optional parameter when initializing the SDK client instance. The selected scheme will be used by default to authenticate with the API for all operations that support it. For example:
+To authenticate with the API the `apiKey` parameter must be set when initializing the SDK client instance. For example:
 ```typescript
 import { OpenRouter } from "@openrouter/sdk";
 
 const openRouter = new OpenRouter({
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 async function run() {
-  const result = await openRouter.getCredits();
+  const result = await openRouter.alpha.responses.send2({
+    provider: {
+      zdr: true,
+    },
+  });
+
+  console.log(result);
+}
+
+run();
+
+```
+
+### Per-Operation Security Schemes
+
+Some operations in this SDK require the security scheme to be specified at the request level. For example:
+```typescript
+import { OpenRouter } from "@openrouter/sdk";
+
+const openRouter = new OpenRouter();
+
+async function run() {
+  const result = await openRouter.credits.postCreditsCoinbase({
+    bearer: process.env["OPENROUTER_BEARER"] ?? "",
+  });
 
   console.log(result);
 }
@@ -153,6 +163,13 @@ run();
 <details open>
 <summary>Available methods</summary>
 
+### [alpha](docs/sdks/alpha/README.md)
+
+
+#### [alpha.responses](docs/sdks/responses/README.md)
+
+* [send2](docs/sdks/responses/README.md#send2) - Submit a response request
+
 ### [analytics](docs/sdks/analytics/README.md)
 
 * [getActivity](docs/sdks/analytics/README.md#getactivity) - Get user activity grouped by endpoint
@@ -171,9 +188,18 @@ run();
 
 * [send](docs/sdks/chat/README.md#send) - Create a chat completion
 
+### [completions](docs/sdks/completions/README.md)
+
+* [generate](docs/sdks/completions/README.md#generate) - Create a completion
+
+### [credits](docs/sdks/credits/README.md)
+
+* [getCredits](docs/sdks/credits/README.md#getcredits) - Get total credits purchased and used for the authenticated user
+* [postCreditsCoinbase](docs/sdks/credits/README.md#postcreditscoinbase) - Create a Coinbase charge for crypto payment
+
 ### [embeddings](docs/sdks/embeddings/README.md)
 
-* [postEmbeddings](docs/sdks/embeddings/README.md#postembeddings) - Submit an embedding request
+* [generate](docs/sdks/embeddings/README.md#generate) - Submit an embedding request
 
 ### [endpoints](docs/sdks/endpoints/README.md)
 
@@ -184,21 +210,25 @@ run();
 
 * [getGeneration](docs/sdks/generations/README.md#getgeneration) - Get request & usage metadata for a generation
 
+### [model](docs/sdks/model/README.md)
+
+* [getParametersAuthorSlug](docs/sdks/model/README.md#getparametersauthorslug) - Get a model's supported parameters and data about which are most popular
+
 ### [models](docs/sdks/models/README.md)
 
 * [getModelsCount](docs/sdks/models/README.md#getmodelscount) - Get total count of available models
 * [getModels](docs/sdks/models/README.md#getmodels) - List all models and their properties
 * [getModelsUser](docs/sdks/models/README.md#getmodelsuser) - List models filtered by user provider preferences
 
-### [OpenRouter SDK](docs/sdks/openrouter/README.md)
+### [oAuth](docs/sdks/oauth/README.md)
 
-* [getCredits](docs/sdks/openrouter/README.md#getcredits) - Get total credits purchased and used for the authenticated user
-* [postCreditsCoinbase](docs/sdks/openrouter/README.md#postcreditscoinbase) - Create a Coinbase charge for crypto payment
-* [getProviders](docs/sdks/openrouter/README.md#getproviders)
+* [postAuthKeys](docs/sdks/oauth/README.md#postauthkeys) - Exchange authorization code for API key
+* [postAuthKeysCode](docs/sdks/oauth/README.md#postauthkeyscode) - Create authorization code
 
-### [parameters](docs/sdks/parameters/README.md)
 
-* [getParametersAuthorSlug](docs/sdks/parameters/README.md#getparametersauthorslug) - Get a model's supported parameters and data about which are most popular
+### [providers](docs/sdks/providers/README.md)
+
+* [getProviders](docs/sdks/providers/README.md#getproviders) - List all available model providers
 
 </details>
 <!-- End Available Resources and Operations [operations] -->
@@ -218,6 +248,7 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 
 <summary>Available standalone functions</summary>
 
+- [`alphaResponsesSend2`](docs/sdks/responses/README.md#send2) - Submit a response request
 - [`analyticsGetActivity`](docs/sdks/analytics/README.md#getactivity) - Get user activity grouped by endpoint
 - [`apiKeysDeleteKeysHash`](docs/sdks/apikeys/README.md#deletekeyshash) - Delete an API key
 - [`apiKeysGetAuthKey`](docs/sdks/apikeys/README.md#getauthkey) - Get current API key
@@ -227,17 +258,20 @@ To read more about standalone functions, check [FUNCTIONS.md](./FUNCTIONS.md).
 - [`apiKeysPatchKeysHash`](docs/sdks/apikeys/README.md#patchkeyshash) - Update an API key
 - [`apiKeysPostKeys`](docs/sdks/apikeys/README.md#postkeys) - Create a new API key
 - [`chatSend`](docs/sdks/chat/README.md#send) - Create a chat completion
-- [`embeddingsPostEmbeddings`](docs/sdks/embeddings/README.md#postembeddings) - Submit an embedding request
+- [`completionsGenerate`](docs/sdks/completions/README.md#generate) - Create a completion
+- [`creditsGetCredits`](docs/sdks/credits/README.md#getcredits) - Get total credits purchased and used for the authenticated user
+- [`creditsPostCreditsCoinbase`](docs/sdks/credits/README.md#postcreditscoinbase) - Create a Coinbase charge for crypto payment
+- [`embeddingsGenerate`](docs/sdks/embeddings/README.md#generate) - Submit an embedding request
 - [`endpointsGetEndpointsZdr`](docs/sdks/endpoints/README.md#getendpointszdr) - Preview the impact of ZDR on the available endpoints
 - [`endpointsGetModelsAuthorSlugEndpoints`](docs/sdks/endpoints/README.md#getmodelsauthorslugendpoints) - List all endpoints for a model
 - [`generationsGetGeneration`](docs/sdks/generations/README.md#getgeneration) - Get request & usage metadata for a generation
-- [`getCredits`](docs/sdks/openrouter/README.md#getcredits) - Get total credits purchased and used for the authenticated user
-- [`getProviders`](docs/sdks/openrouter/README.md#getproviders)
+- [`modelGetParametersAuthorSlug`](docs/sdks/model/README.md#getparametersauthorslug) - Get a model's supported parameters and data about which are most popular
 - [`modelsGetModels`](docs/sdks/models/README.md#getmodels) - List all models and their properties
 - [`modelsGetModelsCount`](docs/sdks/models/README.md#getmodelscount) - Get total count of available models
 - [`modelsGetModelsUser`](docs/sdks/models/README.md#getmodelsuser) - List models filtered by user provider preferences
-- [`parametersGetParametersAuthorSlug`](docs/sdks/parameters/README.md#getparametersauthorslug) - Get a model's supported parameters and data about which are most popular
-- [`postCreditsCoinbase`](docs/sdks/openrouter/README.md#postcreditscoinbase) - Create a Coinbase charge for crypto payment
+- [`oAuthPostAuthKeys`](docs/sdks/oauth/README.md#postauthkeys) - Exchange authorization code for API key
+- [`oAuthPostAuthKeysCode`](docs/sdks/oauth/README.md#postauthkeyscode) - Create authorization code
+- [`providersGetProviders`](docs/sdks/providers/README.md#getproviders) - List all available model providers
 
 </details>
 <!-- End Standalone functions [standalone-funcs] -->
@@ -264,6 +298,7 @@ To learn about this feature and how to get started, check
 
 <summary>Available React hooks</summary>
 
+- [`useAlphaResponsesSend2Mutation`](docs/sdks/responses/README.md#send2) - Submit a response request
 - [`useAnalyticsGetActivity`](docs/sdks/analytics/README.md#getactivity) - Get user activity grouped by endpoint
 - [`useApiKeysDeleteKeysHashMutation`](docs/sdks/apikeys/README.md#deletekeyshash) - Delete an API key
 - [`useApiKeysGetAuthKey`](docs/sdks/apikeys/README.md#getauthkey) - Get current API key
@@ -273,17 +308,20 @@ To learn about this feature and how to get started, check
 - [`useApiKeysPatchKeysHashMutation`](docs/sdks/apikeys/README.md#patchkeyshash) - Update an API key
 - [`useApiKeysPostKeysMutation`](docs/sdks/apikeys/README.md#postkeys) - Create a new API key
 - [`useChatSendMutation`](docs/sdks/chat/README.md#send) - Create a chat completion
-- [`useEmbeddingsPostEmbeddingsMutation`](docs/sdks/embeddings/README.md#postembeddings) - Submit an embedding request
+- [`useCompletionsGenerateMutation`](docs/sdks/completions/README.md#generate) - Create a completion
+- [`useCreditsGetCredits`](docs/sdks/credits/README.md#getcredits) - Get total credits purchased and used for the authenticated user
+- [`useCreditsPostCreditsCoinbaseMutation`](docs/sdks/credits/README.md#postcreditscoinbase) - Create a Coinbase charge for crypto payment
+- [`useEmbeddingsGenerateMutation`](docs/sdks/embeddings/README.md#generate) - Submit an embedding request
 - [`useEndpointsGetEndpointsZdr`](docs/sdks/endpoints/README.md#getendpointszdr) - Preview the impact of ZDR on the available endpoints
 - [`useEndpointsGetModelsAuthorSlugEndpoints`](docs/sdks/endpoints/README.md#getmodelsauthorslugendpoints) - List all endpoints for a model
 - [`useGenerationsGetGeneration`](docs/sdks/generations/README.md#getgeneration) - Get request & usage metadata for a generation
-- [`useGetCredits`](docs/sdks/openrouter/README.md#getcredits) - Get total credits purchased and used for the authenticated user
-- [`useGetProviders`](docs/sdks/openrouter/README.md#getproviders)
+- [`useModelGetParametersAuthorSlug`](docs/sdks/model/README.md#getparametersauthorslug) - Get a model's supported parameters and data about which are most popular
 - [`useModelsGetModels`](docs/sdks/models/README.md#getmodels) - List all models and their properties
 - [`useModelsGetModelsCount`](docs/sdks/models/README.md#getmodelscount) - Get total count of available models
 - [`useModelsGetModelsUser`](docs/sdks/models/README.md#getmodelsuser) - List models filtered by user provider preferences
-- [`useParametersGetParametersAuthorSlug`](docs/sdks/parameters/README.md#getparametersauthorslug) - Get a model's supported parameters and data about which are most popular
-- [`usePostCreditsCoinbaseMutation`](docs/sdks/openrouter/README.md#postcreditscoinbase) - Create a Coinbase charge for crypto payment
+- [`useOAuthPostAuthKeysCodeMutation`](docs/sdks/oauth/README.md#postauthkeyscode) - Create authorization code
+- [`useOAuthPostAuthKeysMutation`](docs/sdks/oauth/README.md#postauthkeys) - Exchange authorization code for API key
+- [`useProvidersGetProviders`](docs/sdks/providers/README.md#getproviders) - List all available model providers
 
 </details>
 <!-- End React hooks with TanStack Query [react-query] -->
@@ -301,13 +339,15 @@ underlying connection.
 import { OpenRouter } from "@openrouter/sdk";
 
 const openRouter = new OpenRouter({
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 async function run() {
-  const result = await openRouter.chat.send();
+  const result = await openRouter.alpha.responses.send2({
+    provider: {
+      zdr: true,
+    },
+  });
 
   console.log(result);
 }
@@ -330,13 +370,15 @@ To change the default retry strategy for a single API call, simply provide a ret
 import { OpenRouter } from "@openrouter/sdk";
 
 const openRouter = new OpenRouter({
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 async function run() {
-  const result = await openRouter.getCredits({
+  const result = await openRouter.alpha.responses.send2({
+    provider: {
+      zdr: true,
+    },
+  }, {
     retries: {
       strategy: "backoff",
       backoff: {
@@ -371,13 +413,15 @@ const openRouter = new OpenRouter({
     },
     retryConnectionErrors: false,
   },
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 async function run() {
-  const result = await openRouter.getCredits();
+  const result = await openRouter.alpha.responses.send2({
+    provider: {
+      zdr: true,
+    },
+  });
 
   console.log(result);
 }
@@ -407,14 +451,16 @@ import { OpenRouter } from "@openrouter/sdk";
 import * as errors from "@openrouter/sdk/models/errors";
 
 const openRouter = new OpenRouter({
-  security: {
-    apiKeyAuth: process.env["OPENROUTER_API_KEY_AUTH"] ?? "",
-  },
+  apiKey: process.env["OPENROUTER_API_KEY"] ?? "",
 });
 
 async function run() {
   try {
-    const result = await openRouter.getProviders();
+    const result = await openRouter.alpha.responses.send2({
+      provider: {
+        zdr: true,
+      },
+    });
 
     console.log(result);
   } catch (error) {
@@ -426,8 +472,9 @@ async function run() {
       console.log(error.headers);
 
       // Depending on the method different errors may be thrown
-      if (error instanceof errors.InternalServerError) {
-        console.log(error.data$.error); // operations.ErrorT
+      if (error instanceof errors.ErrorResponse) {
+        console.log(error.data$.error); // models.ErrorResponseError
+        console.log(error.data$.userId); // string
       }
     }
   }
@@ -438,10 +485,11 @@ run();
 ```
 
 ### Error Classes
-**Primary error:**
+**Primary errors:**
 * [`OpenRouterError`](./src/models/errors/openroutererror.ts): The base class for HTTP error responses.
+  * [`ErrorResponse`](./src/models/errors/errorresponse.ts): Error response. *
 
-<details><summary>Less common errors (8)</summary>
+<details><summary>Less common errors (9)</summary>
 
 <br />
 
@@ -454,8 +502,9 @@ run();
 
 
 **Inherit from [`OpenRouterError`](./src/models/errors/openroutererror.ts)**:
-* [`ChatError`](./src/models/errors/chaterror.ts): Bad request - invalid parameters. Applicable to 1 of 20 methods.*
-* [`InternalServerError`](./src/models/errors/internalservererror.ts): Internal Server Error. Status code `500`. Applicable to 1 of 20 methods.*
+* [`ChatError`](./src/models/errors/chaterror.ts): Bad request - invalid parameters. Applicable to 1 of 24 methods.*
+* [`CompletionError`](./src/models/errors/completionerror.ts): Bad request - invalid parameters. Applicable to 1 of 24 methods.*
+* [`InternalServerError`](./src/models/errors/internalservererror.ts): Internal Server Error. Status code `500`. Applicable to 1 of 24 methods.*
 * [`ResponseValidationError`](./src/models/errors/responsevalidationerror.ts): Type mismatch between the data returned from the server and the structure expected by the SDK. See `error.rawValue` for the raw value and `error.pretty()` for a nicely formatted multi-line string.
 
 </details>

package/dist/commonjs/funcs/alphaResponsesSend2.d.ts

@@ -0,0 +1,35 @@
+import { OpenRouterCore } from "../core.js";
+import { EventStream } from "../lib/event-streams.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { ConnectionError, InvalidRequestError, RequestAbortedError, RequestTimeoutError, UnexpectedClientError } from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { OpenRouterError } from "../models/errors/openroutererror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+export declare enum Send2AcceptEnum {
+    applicationJson = "application/json",
+    textEventStream = "text/event-stream"
+}
+/**
+ * Submit a response request
+ *
+ * @remarks
+ * Submits a request to the Responses API (beta)
+ */
+export declare function alphaResponsesSend2(client: OpenRouterCore, request: operations.PostApiAlphaResponsesRequest & {
+    stream?: false;
+}, options?: RequestOptions & {
+    acceptHeaderOverride?: Send2AcceptEnum;
+}): APIPromise<Result<operations.PostApiAlphaResponsesResponseBody, errors.ErrorResponse | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+export declare function alphaResponsesSend2(client: OpenRouterCore, request: operations.PostApiAlphaResponsesRequest & {
+    stream: true;
+}, options?: RequestOptions & {
+    acceptHeaderOverride?: Send2AcceptEnum;
+}): APIPromise<Result<EventStream<any>, errors.ErrorResponse | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+export declare function alphaResponsesSend2(client: OpenRouterCore, request: operations.PostApiAlphaResponsesRequest, options?: RequestOptions & {
+    acceptHeaderOverride?: Send2AcceptEnum;
+}): APIPromise<Result<operations.PostApiAlphaResponsesResponse, errors.ErrorResponse | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+//# sourceMappingURL=alphaResponsesSend2.d.ts.map

package/dist/commonjs/funcs/alphaResponsesSend2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alphaResponsesSend2.d.ts","sourceRoot":"","sources":["../../../src/funcs/alphaResponsesSend2.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAItD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,UAAU,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAW,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,oBAAY,eAAe;IACzB,eAAe,qBAAqB;IACpC,eAAe,sBAAsB;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,CAAC,4BAA4B,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,EACrE,OAAO,CAAC,EAAE,cAAc,GAAG;IAAE,oBAAoB,CAAC,EAAE,eAAe,CAAA;CAAE,GACpE,UAAU,CACX,MAAM,CACJ,UAAU,CAAC,iCAAiC,EAC1C,MAAM,CAAC,aAAa,GACpB,eAAe,GACf,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAAC;AACF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,CAAC,4BAA4B,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,EACnE,OAAO,CAAC,EAAE,cAAc,GAAG;IAAE,oBAAoB,CAAC,EAAE,eAAe,CAAA;CAAE,GACpE,UAAU,CACX,MAAM,CACJ,WAAW,CAAC,GAAG,CAAC,EACd,MAAM,CAAC,aAAa,GACpB,eAAe,GACf,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAAC;AACF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,UAAU,CAAC,4BAA4B,EAChD,OAAO,CAAC,EAAE,cAAc,GAAG;IAAE,oBAAoB,CAAC,EAAE,eAAe,CAAA;CAAE,GACpE,UAAU,CACX,MAAM,CACJ,UAAU,CAAC,6BAA6B,EACtC,MAAM,CAAC,aAAa,GACpB,eAAe,GACf,uBAAuB,GACvB,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,CACrB,CACF,CAAC"}