add open enums, server selection, update description

sheldonvaughn · sheldonvaughn · commit 5d06b0a7b457 · 2025-09-18T07:54:13.000-05:00
diff --git a/.speakeasy/gen.lock b/.speakeasy/gen.lock
@@ -1,12 +1,12 @@
 lockVersion: 2.0.0
 id: 03e733ff-14c6-48f8-87a5-37a1a4588594
 management:
-  docChecksum: f629b0ca18ec064975608b5eea7aebfd
+  docChecksum: 7849dd264d8d3676743d325682310ed7
   docVersion: 1.0.0
-  speakeasyVersion: 1.617.1
-  generationVersion: 2.701.8
+  speakeasyVersion: 1.618.1
+  generationVersion: 2.702.0
   releaseVersion: 0.1.0
-  configChecksum: ee7ed66772b5663ad6d381d1b4142fe2
+  configChecksum: 9b2fc6a03dd7103d87270af55bb29a50
 features:
   python:
     acceptHeaders: 3.0.0
@@ -27,11 +27,13 @@ features:
     methodArguments: 1.0.2
     nameOverrides: 3.0.1
     nullables: 1.0.1
+    openEnums: 1.0.1
     responseFormat: 1.0.1
     retries: 3.0.2
     sdkHooks: 1.1.0
     serverEvents: 1.0.9
     serverEventsSentinels: 0.1.0
+    serverIDs: 3.0.0
     unions: 3.0.4
 generatedFiles:
   - .devcontainer/README.md
diff --git a/.speakeasy/gen.yaml b/.speakeasy/gen.yaml
@@ -39,7 +39,7 @@ python:
   baseErrorName: OpenRouterError
   clientServerStatusCodesAsErrors: true
   defaultErrorName: OpenRouterDefaultError
-  description: Python Client SDK Generated by Speakeasy.
+  description: The OpenRouter Python SDK.
   enableCustomCodeRegions: true
   enumFormat: union
   envVarPrefix: OPENROUTER
diff --git a/.speakeasy/in.openapi.yaml b/.speakeasy/in.openapi.yaml
@@ -12,6 +12,7 @@ info:
     url: https://opensource.org/licenses/MIT
 servers:
   - url: https://{provider_url}/api/v1
+    x-speakeasy-server-id: production
     variables:
       provider_url:
         default: openrouter.ai
@@ -77,6 +78,7 @@ components:
           type: string
           nullable: true
         format:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -103,6 +105,7 @@ components:
           type: string
           nullable: true
         format:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -133,6 +136,7 @@ components:
           type: string
           nullable: true
         format:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -351,6 +355,7 @@ components:
       type: object
       properties:
         finish_reason:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -541,6 +546,7 @@ components:
         delta:
           $ref: '#/components/schemas/ChatCompletionChunkChoiceDelta'
         finish_reason:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -649,6 +655,7 @@ components:
               type: string
               description: Base64 encoded audio data
             format:
+              x-speakeasy-unknown-values: allow
               type: string
               enum:
                 - wav
diff --git a/.speakeasy/out.openapi.yaml b/.speakeasy/out.openapi.yaml
@@ -12,6 +12,7 @@ info:
     url: https://opensource.org/licenses/MIT
 servers:
   - url: https://{provider_url}/api/v1
+    x-speakeasy-server-id: production
     variables:
       provider_url:
         default: openrouter.ai
@@ -77,6 +78,7 @@ components:
           type: string
           nullable: true
         format:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -103,6 +105,7 @@ components:
           type: string
           nullable: true
         format:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -133,6 +136,7 @@ components:
           type: string
           nullable: true
         format:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -351,6 +355,7 @@ components:
       type: object
       properties:
         finish_reason:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -541,6 +546,7 @@ components:
         delta:
           $ref: '#/components/schemas/ChatCompletionChunkChoiceDelta'
         finish_reason:
+          x-speakeasy-unknown-values: allow
           type: string
           nullable: true
           enum:
@@ -649,6 +655,7 @@ components:
               type: string
               description: Base64 encoded audio data
             format:
+              x-speakeasy-unknown-values: allow
               type: string
               enum:
                 - wav
diff --git a/.speakeasy/workflow.lock b/.speakeasy/workflow.lock
@@ -1,20 +1,20 @@
-speakeasyVersion: 1.617.1
+speakeasyVersion: 1.618.1
 sources:
     OpenRouter Chat Completions API:
         sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:a7746404e672bbb6dcd8354532d0c627d24522844c39d58011d4cd9c7e8ebd20
-        sourceBlobDigest: sha256:67c793fef9c039a2c351fc6ba7ed9a6119059023fe3fbd1022645d7494c2c63c
+        sourceRevisionDigest: sha256:74ae52780983745871d33efc788abba37d1d8b271f358771b180ddb8546d6f7f
+        sourceBlobDigest: sha256:2fd2132e64b77adae1fc045512364d6517f47916c553e757226e5b9012d2170d
         tags:
             - latest
             - 1.0.0
 targets:
     open-router:
         source: OpenRouter Chat Completions API
         sourceNamespace: open-router-chat-completions-api
-        sourceRevisionDigest: sha256:a7746404e672bbb6dcd8354532d0c627d24522844c39d58011d4cd9c7e8ebd20
-        sourceBlobDigest: sha256:67c793fef9c039a2c351fc6ba7ed9a6119059023fe3fbd1022645d7494c2c63c
+        sourceRevisionDigest: sha256:74ae52780983745871d33efc788abba37d1d8b271f358771b180ddb8546d6f7f
+        sourceBlobDigest: sha256:2fd2132e64b77adae1fc045512364d6517f47916c553e757226e5b9012d2170d
         codeSamplesNamespace: open-router-chat-completions-api-python-code-samples
-        codeSamplesRevisionDigest: sha256:fb054934c4d0de58a48ca8cdfde7b4210f71c425fb9dfad02e8824b8a1848774
+        codeSamplesRevisionDigest: sha256:fd8ed35536e452d20ff16d6c33d311ebd405bf7e0f9188cfafcba4cd81539d96
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest
diff --git a/README.md b/README.md
@@ -401,9 +401,15 @@ with OpenRouter(
 <!-- Start Server Selection [server] -->
 ## Server Selection
 
-### Server Variables
+### Select Server by Name
 
-The default server `https://{provider_url}/api/v1` contains variables and is set to `https://openrouter.ai/api/v1` by default. To override default values, the following parameters are available when initializing the SDK client instance:
+You can override the default server globally by passing a server name to the `server: str` optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the names associated with the available servers:
+
+| Name         | Server                          | Variables      | Description       |
+| ------------ | ------------------------------- | -------------- | ----------------- |
+| `production` | `https://{provider_url}/api/v1` | `provider_url` | Production server |
+
+If the selected server has variables, you may override its default values through the additional parameters made available in the SDK constructor:
 
 | Variable       | Parameter           | Default           | Description |
 | -------------- | ------------------- | ----------------- | ----------- |
@@ -417,6 +423,7 @@ import os
 
 
 with OpenRouter(
+    server="production",
     provider_url="https://ruddy-guacamole.info/"
     api_key=os.getenv("OPENROUTER_API_KEY", ""),
 ) as open_router:
@@ -437,7 +444,7 @@ with OpenRouter(
 
 ### Override Server URL Per-Client
 
-The default server can be overridden globally by passing a URL to the `server_url: str` optional parameter when initializing the SDK client instance. For example:
+The default server can also be overridden globally by passing a URL to the `server_url: str` optional parameter when initializing the SDK client instance. For example:
 ```python
 from openrouter import OpenRouter
 import os
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,7 +1,7 @@
 [project]
 name = "openrouter"
 version = "0.1.0"
-description = "Python Client SDK Generated by Speakeasy."
+description = "The OpenRouter Python SDK."
 authors = [{ name = "Speakeasy" },]
 readme = "README.md"
 requires-python = ">=3.9.2"
diff --git a/src/openrouter/_version.py b/src/openrouter/_version.py
@@ -5,8 +5,8 @@
 __title__: str = "openrouter"
 __version__: str = "0.1.0"
 __openapi_doc_version__: str = "1.0.0"
-__gen_version__: str = "2.701.8"
-__user_agent__: str = "speakeasy-sdk/python 0.1.0 2.701.8 1.0.0 openrouter"
+__gen_version__: str = "2.702.0"
+__user_agent__: str = "speakeasy-sdk/python 0.1.0 2.702.0 1.0.0 openrouter"
 
 try:
     if __package__ is not None:
diff --git a/src/openrouter/models/chatcompletionchoice.py b/src/openrouter/models/chatcompletionchoice.py
@@ -12,14 +12,17 @@
     OptionalNullable,
     UNSET,
     UNSET_SENTINEL,
+    UnrecognizedStr,
 )
+from openrouter.utils import validate_open_enum
 from pydantic import model_serializer
-from typing import Literal
-from typing_extensions import NotRequired, TypedDict
+from pydantic.functional_validators import PlainValidator
+from typing import Literal, Union
+from typing_extensions import Annotated, NotRequired, TypedDict
 
 
-ChatCompletionChoiceFinishReason = Literal[
-    "tool_calls", "stop", "length", "content_filter", "error"
+ChatCompletionChoiceFinishReason = Union[
+    Literal["tool_calls", "stop", "length", "content_filter", "error"], UnrecognizedStr
 ]
 r"""Reason the completion finished"""
 
@@ -40,7 +43,10 @@ class ChatCompletionChoiceTypedDict(TypedDict):
 class ChatCompletionChoice(BaseModel):
     r"""Chat completion choice"""
 
-    finish_reason: Nullable[ChatCompletionChoiceFinishReason]
+    finish_reason: Annotated[
+        Nullable[ChatCompletionChoiceFinishReason],
+        PlainValidator(validate_open_enum(False)),
+    ]
     r"""Reason the completion finished"""
 
     index: float
diff --git a/src/openrouter/models/chatcompletionchunkchoice.py b/src/openrouter/models/chatcompletionchunkchoice.py
@@ -15,14 +15,17 @@
     OptionalNullable,
     UNSET,
     UNSET_SENTINEL,
+    UnrecognizedStr,
 )
+from openrouter.utils import validate_open_enum
 from pydantic import model_serializer
-from typing import Literal
-from typing_extensions import NotRequired, TypedDict
+from pydantic.functional_validators import PlainValidator
+from typing import Literal, Union
+from typing_extensions import Annotated, NotRequired, TypedDict
 
 
-ChatCompletionChunkChoiceFinishReason = Literal[
-    "tool_calls", "stop", "length", "content_filter", "error"
+ChatCompletionChunkChoiceFinishReason = Union[
+    Literal["tool_calls", "stop", "length", "content_filter", "error"], UnrecognizedStr
 ]
 
 
@@ -43,7 +46,10 @@ class ChatCompletionChunkChoice(BaseModel):
     delta: ChatCompletionChunkChoiceDelta
     r"""Delta changes in streaming response"""
 
-    finish_reason: Nullable[ChatCompletionChunkChoiceFinishReason]
+    finish_reason: Annotated[
+        Nullable[ChatCompletionChunkChoiceFinishReason],
+        PlainValidator(validate_open_enum(False)),
+    ]
 
     index: float
 
diff --git a/src/openrouter/models/chatcompletioncontentpartaudio.py b/src/openrouter/models/chatcompletioncontentpartaudio.py
@@ -1,16 +1,18 @@
 """Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
 
 from __future__ import annotations
-from openrouter.types import BaseModel
+from openrouter.types import BaseModel, UnrecognizedStr
+from openrouter.utils import validate_open_enum
 import pydantic
-from typing import Literal
+from pydantic.functional_validators import PlainValidator
+from typing import Literal, Union
 from typing_extensions import Annotated, TypedDict
 
 
 ChatCompletionContentPartAudioType = Literal["input_audio"]
 
-ChatCompletionContentPartAudioFormat = Literal[
-    "wav", "mp3", "flac", "m4a", "ogg", "pcm16", "pcm24"
+ChatCompletionContentPartAudioFormat = Union[
+    Literal["wav", "mp3", "flac", "m4a", "ogg", "pcm16", "pcm24"], UnrecognizedStr
 ]
 r"""Audio format"""
 
@@ -27,7 +29,11 @@ class InputAudio(BaseModel):
     r"""Base64 encoded audio data"""
 
     format_: Annotated[
-        ChatCompletionContentPartAudioFormat, pydantic.Field(alias="format")
+        Annotated[
+            ChatCompletionContentPartAudioFormat,
+            PlainValidator(validate_open_enum(False)),
+        ],
+        pydantic.Field(alias="format"),
     ]
     r"""Audio format"""
 
diff --git a/src/openrouter/models/reasoningdetailencrypted.py b/src/openrouter/models/reasoningdetailencrypted.py
@@ -7,17 +7,20 @@
     OptionalNullable,
     UNSET,
     UNSET_SENTINEL,
+    UnrecognizedStr,
 )
+from openrouter.utils import validate_open_enum
 import pydantic
 from pydantic import model_serializer
-from typing import Literal, Optional
+from pydantic.functional_validators import PlainValidator
+from typing import Literal, Optional, Union
 from typing_extensions import Annotated, NotRequired, TypedDict
 
 
 ReasoningDetailEncryptedType = Literal["reasoning.encrypted"]
 
-ReasoningDetailEncryptedFormat = Literal[
-    "unknown", "openai-responses-v1", "anthropic-claude-v1"
+ReasoningDetailEncryptedFormat = Union[
+    Literal["unknown", "openai-responses-v1", "anthropic-claude-v1"], UnrecognizedStr
 ]
 
 
@@ -41,7 +44,11 @@ class ReasoningDetailEncrypted(BaseModel):
     id: OptionalNullable[str] = UNSET
 
     format_: Annotated[
-        OptionalNullable[ReasoningDetailEncryptedFormat], pydantic.Field(alias="format")
+        Annotated[
+            OptionalNullable[ReasoningDetailEncryptedFormat],
+            PlainValidator(validate_open_enum(False)),
+        ],
+        pydantic.Field(alias="format"),
     ] = "anthropic-claude-v1"
 
     index: Optional[float] = None
diff --git a/src/openrouter/models/reasoningdetailsummary.py b/src/openrouter/models/reasoningdetailsummary.py
diff --git a/src/openrouter/models/reasoningdetailtext.py b/src/openrouter/models/reasoningdetailtext.py
diff --git a/src/openrouter/sdk.py b/src/openrouter/sdk.py
diff --git a/src/openrouter/sdkconfiguration.py b/src/openrouter/sdkconfiguration.py
