feat(api): OpenAPI spec update via Stainless API (#4)

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 20
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/structify%2Fstructify-aa1bdd07a9fcf09044a5dae55e26b5bf3fcd742b8f3a86e1e815f67c45cf5030.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/structify%2Fstructify-48f219e1b0e6ca3514d5922413233d8da39b0a01e299e434253db4e07e8e8fb3.yml

api.md

@@ -131,7 +131,7 @@ Methods:
 Types:
 
 ```python
-from structify.types.structure import RunCreateResponse
+from structify.types.structure import Llm, RunCreateResponse
 ```
 
 Methods:
@@ -143,7 +143,7 @@ Methods:
 Types:
 
 ```python
-from structify.types.structure import RunAsyncCreateResponse
+from structify.types.structure import Llm, RunAsyncCreateResponse
 ```
 
 Methods:

src/structify/resources/structure/run.py

@@ -23,7 +23,8 @@
 from ..._base_client import (
     make_request_options,
 )
-from ...types.structure import run_create_params
+from ...types.structure import Llm, run_create_params
+from ...types.structure.llm import Llm
 
 __all__ = ["RunResource", "AsyncRunResource"]
 
@@ -42,9 +43,9 @@ def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         text: run_create_params.Variant0Text,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -75,9 +76,9 @@ def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         document: run_create_params.Variant1Document,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -108,9 +109,9 @@ def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         web: run_create_params.Variant2Web,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -141,9 +142,9 @@ def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         sec_filing: run_create_params.Variant3SecFiling,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -170,15 +171,18 @@ def create(
         ...
 
     @required_args(
-        ["dataset_name", "text"], ["dataset_name", "document"], ["dataset_name", "web"], ["dataset_name", "sec_filing"]
+        ["dataset_name", "llm", "text"],
+        ["dataset_name", "llm", "document"],
+        ["dataset_name", "llm", "web"],
+        ["dataset_name", "llm", "sec_filing"],
     )
     def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         text: run_create_params.Variant0Text | NotGiven = NOT_GIVEN,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         document: run_create_params.Variant1Document | NotGiven = NOT_GIVEN,
         web: run_create_params.Variant2Web | NotGiven = NOT_GIVEN,
         sec_filing: run_create_params.Variant3SecFiling | NotGiven = NOT_GIVEN,
@@ -208,8 +212,8 @@ def create(
                 query=maybe_transform(
                     {
                         "dataset_name": dataset_name,
-                        "custom_instruction": custom_instruction,
                         "llm": llm,
+                        "custom_instruction": custom_instruction,
                     },
                     run_create_params.RunCreateParams,
                 ),
@@ -232,9 +236,9 @@ async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         text: run_create_params.Variant0Text,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -265,9 +269,9 @@ async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         document: run_create_params.Variant1Document,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -298,9 +302,9 @@ async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         web: run_create_params.Variant2Web,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -331,9 +335,9 @@ async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         sec_filing: run_create_params.Variant3SecFiling,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -360,15 +364,18 @@ async def create(
         ...
 
     @required_args(
-        ["dataset_name", "text"], ["dataset_name", "document"], ["dataset_name", "web"], ["dataset_name", "sec_filing"]
+        ["dataset_name", "llm", "text"],
+        ["dataset_name", "llm", "document"],
+        ["dataset_name", "llm", "web"],
+        ["dataset_name", "llm", "sec_filing"],
     )
     async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         text: run_create_params.Variant0Text | NotGiven = NOT_GIVEN,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         document: run_create_params.Variant1Document | NotGiven = NOT_GIVEN,
         web: run_create_params.Variant2Web | NotGiven = NOT_GIVEN,
         sec_filing: run_create_params.Variant3SecFiling | NotGiven = NOT_GIVEN,
@@ -398,8 +405,8 @@ async def create(
                 query=await async_maybe_transform(
                     {
                         "dataset_name": dataset_name,
-                        "custom_instruction": custom_instruction,
                         "llm": llm,
+                        "custom_instruction": custom_instruction,
                     },
                     run_create_params.RunCreateParams,
                 ),

src/structify/resources/structure/run_async.py

@@ -23,7 +23,8 @@
 from ..._base_client import (
     make_request_options,
 )
-from ...types.structure import run_async_create_params
+from ...types.structure import Llm, run_async_create_params
+from ...types.structure.llm import Llm
 
 __all__ = ["RunAsyncResource", "AsyncRunAsyncResource"]
 
@@ -42,9 +43,9 @@ def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         text: run_async_create_params.Variant0Text,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -74,9 +75,9 @@ def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         document: run_async_create_params.Variant1Document,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -106,9 +107,9 @@ def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         web: run_async_create_params.Variant2Web,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -138,9 +139,9 @@ def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         sec_filing: run_async_create_params.Variant3SecFiling,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -166,15 +167,18 @@ def create(
         ...
 
     @required_args(
-        ["dataset_name", "text"], ["dataset_name", "document"], ["dataset_name", "web"], ["dataset_name", "sec_filing"]
+        ["dataset_name", "llm", "text"],
+        ["dataset_name", "llm", "document"],
+        ["dataset_name", "llm", "web"],
+        ["dataset_name", "llm", "sec_filing"],
     )
     def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         text: run_async_create_params.Variant0Text | NotGiven = NOT_GIVEN,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         document: run_async_create_params.Variant1Document | NotGiven = NOT_GIVEN,
         web: run_async_create_params.Variant2Web | NotGiven = NOT_GIVEN,
         sec_filing: run_async_create_params.Variant3SecFiling | NotGiven = NOT_GIVEN,
@@ -204,8 +208,8 @@ def create(
                 query=maybe_transform(
                     {
                         "dataset_name": dataset_name,
-                        "custom_instruction": custom_instruction,
                         "llm": llm,
+                        "custom_instruction": custom_instruction,
                     },
                     run_async_create_params.RunAsyncCreateParams,
                 ),
@@ -228,9 +232,9 @@ async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         text: run_async_create_params.Variant0Text,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -260,9 +264,9 @@ async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         document: run_async_create_params.Variant1Document,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -292,9 +296,9 @@ async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         web: run_async_create_params.Variant2Web,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -324,9 +328,9 @@ async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         sec_filing: run_async_create_params.Variant3SecFiling,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -352,15 +356,18 @@ async def create(
         ...
 
     @required_args(
-        ["dataset_name", "text"], ["dataset_name", "document"], ["dataset_name", "web"], ["dataset_name", "sec_filing"]
+        ["dataset_name", "llm", "text"],
+        ["dataset_name", "llm", "document"],
+        ["dataset_name", "llm", "web"],
+        ["dataset_name", "llm", "sec_filing"],
     )
     async def create(
         self,
         *,
         dataset_name: str,
+        llm: Llm,
         text: run_async_create_params.Variant0Text | NotGiven = NOT_GIVEN,
         custom_instruction: Optional[str] | NotGiven = NOT_GIVEN,
-        llm: Optional[object] | NotGiven = NOT_GIVEN,
         document: run_async_create_params.Variant1Document | NotGiven = NOT_GIVEN,
         web: run_async_create_params.Variant2Web | NotGiven = NOT_GIVEN,
         sec_filing: run_async_create_params.Variant3SecFiling | NotGiven = NOT_GIVEN,
@@ -390,8 +397,8 @@ async def create(
                 query=await async_maybe_transform(
                     {
                         "dataset_name": dataset_name,
-                        "custom_instruction": custom_instruction,
                         "llm": llm,
+                        "custom_instruction": custom_instruction,
                     },
                     run_async_create_params.RunAsyncCreateParams,
                 ),

src/structify/types/structure/__init__.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from .llm import Llm as Llm
 from .is_complete import IsComplete as IsComplete
 from .run_create_params import RunCreateParams as RunCreateParams
 from .run_async_create_params import RunAsyncCreateParams as RunAsyncCreateParams

src/structify/types/structure/llm.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+__all__ = ["Llm"]
+
+Llm = Literal["Gpt4V", "Structify", "Human"]