vellum-ai 1.11.2__py3-none-any.whl → 1.13.5__py3-none-any.whl

vellum/client/resources/documents/client.py

@@ -213,9 +213,10 @@ class DocumentsClient:
         self,
         *,
         label: str,
-        contents: core.File,
         add_to_index_names: typing.Optional[typing.List[str]] = OMIT,
         external_id: typing.Optional[str] = OMIT,
+        contents: typing.Optional[core.File] = OMIT,
+        url: typing.Optional[str] = OMIT,
         keywords: typing.Optional[typing.List[str]] = OMIT,
         metadata: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -230,15 +231,18 @@ class DocumentsClient:
         label : str
             A human-friendly name for this document. Typically the filename.
 
-        contents : core.File
-            See core.File for more documentation
-
         add_to_index_names : typing.Optional[typing.List[str]]
             Optionally include the names of all indexes that you'd like this document to be included in
 
         external_id : typing.Optional[str]
             Optionally include an external ID for this document. This is useful if you want to re-upload the same document later when its contents change and would like it to be re-indexed.
 
+        contents : typing.Optional[core.File]
+            See core.File for more documentation
+
+        url : typing.Optional[str]
+            A URL from which the document can be downloaded. Either contents or url must be provided.
+
         keywords : typing.Optional[typing.List[str]]
             Optionally include a list of keywords that'll be associated with this document. Used when performing keyword searches.
 
@@ -255,9 +259,10 @@ class DocumentsClient:
         """
         _response = self._raw_client.upload(
             label=label,
-            contents=contents,
             add_to_index_names=add_to_index_names,
             external_id=external_id,
+            contents=contents,
+            url=url,
             keywords=keywords,
             metadata=metadata,
             request_options=request_options,
@@ -491,9 +496,10 @@ class AsyncDocumentsClient:
         self,
         *,
         label: str,
-        contents: core.File,
         add_to_index_names: typing.Optional[typing.List[str]] = OMIT,
         external_id: typing.Optional[str] = OMIT,
+        contents: typing.Optional[core.File] = OMIT,
+        url: typing.Optional[str] = OMIT,
         keywords: typing.Optional[typing.List[str]] = OMIT,
         metadata: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -508,15 +514,18 @@ class AsyncDocumentsClient:
         label : str
             A human-friendly name for this document. Typically the filename.
 
-        contents : core.File
-            See core.File for more documentation
-
         add_to_index_names : typing.Optional[typing.List[str]]
             Optionally include the names of all indexes that you'd like this document to be included in
 
         external_id : typing.Optional[str]
             Optionally include an external ID for this document. This is useful if you want to re-upload the same document later when its contents change and would like it to be re-indexed.
 
+        contents : typing.Optional[core.File]
+            See core.File for more documentation
+
+        url : typing.Optional[str]
+            A URL from which the document can be downloaded. Either contents or url must be provided.
+
         keywords : typing.Optional[typing.List[str]]
             Optionally include a list of keywords that'll be associated with this document. Used when performing keyword searches.
 
@@ -533,9 +542,10 @@ class AsyncDocumentsClient:
         """
         _response = await self._raw_client.upload(
             label=label,
-            contents=contents,
             add_to_index_names=add_to_index_names,
             external_id=external_id,
+            contents=contents,
+            url=url,
             keywords=keywords,
             metadata=metadata,
             request_options=request_options,

vellum/client/resources/documents/raw_client.py

@@ -234,9 +234,10 @@ class RawDocumentsClient:
         self,
         *,
         label: str,
-        contents: core.File,
         add_to_index_names: typing.Optional[typing.List[str]] = OMIT,
         external_id: typing.Optional[str] = OMIT,
+        contents: typing.Optional[core.File] = OMIT,
+        url: typing.Optional[str] = OMIT,
         keywords: typing.Optional[typing.List[str]] = OMIT,
         metadata: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -251,15 +252,18 @@ class RawDocumentsClient:
         label : str
             A human-friendly name for this document. Typically the filename.
 
-        contents : core.File
-            See core.File for more documentation
-
         add_to_index_names : typing.Optional[typing.List[str]]
             Optionally include the names of all indexes that you'd like this document to be included in
 
         external_id : typing.Optional[str]
             Optionally include an external ID for this document. This is useful if you want to re-upload the same document later when its contents change and would like it to be re-indexed.
 
+        contents : typing.Optional[core.File]
+            See core.File for more documentation
+
+        url : typing.Optional[str]
+            A URL from which the document can be downloaded. Either contents or url must be provided.
+
         keywords : typing.Optional[typing.List[str]]
             Optionally include a list of keywords that'll be associated with this document. Used when performing keyword searches.
 
@@ -282,11 +286,12 @@ class RawDocumentsClient:
                 "add_to_index_names": add_to_index_names,
                 "external_id": external_id,
                 "label": label,
+                "url": url,
                 "keywords": keywords,
                 "metadata": metadata,
             },
             files={
-                "contents": contents,
+                **({"contents": contents} if contents is not None else {}),
             },
             request_options=request_options,
             omit=OMIT,
@@ -555,9 +560,10 @@ class AsyncRawDocumentsClient:
         self,
         *,
         label: str,
-        contents: core.File,
         add_to_index_names: typing.Optional[typing.List[str]] = OMIT,
         external_id: typing.Optional[str] = OMIT,
+        contents: typing.Optional[core.File] = OMIT,
+        url: typing.Optional[str] = OMIT,
         keywords: typing.Optional[typing.List[str]] = OMIT,
         metadata: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
@@ -572,15 +578,18 @@ class AsyncRawDocumentsClient:
         label : str
             A human-friendly name for this document. Typically the filename.
 
-        contents : core.File
-            See core.File for more documentation
-
         add_to_index_names : typing.Optional[typing.List[str]]
             Optionally include the names of all indexes that you'd like this document to be included in
 
         external_id : typing.Optional[str]
             Optionally include an external ID for this document. This is useful if you want to re-upload the same document later when its contents change and would like it to be re-indexed.
 
+        contents : typing.Optional[core.File]
+            See core.File for more documentation
+
+        url : typing.Optional[str]
+            A URL from which the document can be downloaded. Either contents or url must be provided.
+
         keywords : typing.Optional[typing.List[str]]
             Optionally include a list of keywords that'll be associated with this document. Used when performing keyword searches.
 
@@ -603,11 +612,12 @@ class AsyncRawDocumentsClient:
                 "add_to_index_names": add_to_index_names,
                 "external_id": external_id,
                 "label": label,
+                "url": url,
                 "keywords": keywords,
                 "metadata": metadata,
             },
             files={
-                "contents": contents,
+                **({"contents": contents} if contents is not None else {}),
             },
             request_options=request_options,
             omit=OMIT,

vellum/client/resources/events/raw_client.py

@@ -103,9 +103,9 @@ class RawEventsClient:
                 raise TooManyRequestsError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        ErrorDetailResponse,
+                        typing.Optional[typing.Any],
                         parse_obj_as(
-                            type_=ErrorDetailResponse,  # type: ignore
+                            type_=typing.Optional[typing.Any],  # type: ignore
                             object_=_response.json(),
                         ),
                     ),
@@ -198,9 +198,9 @@ class AsyncRawEventsClient:
                 raise TooManyRequestsError(
                     headers=dict(_response.headers),
                     body=typing.cast(
-                        ErrorDetailResponse,
+                        typing.Optional[typing.Any],
                         parse_obj_as(
-                            type_=ErrorDetailResponse,  # type: ignore
+                            type_=typing.Optional[typing.Any],  # type: ignore
                             object_=_response.json(),
                         ),
                     ),

vellum/client/resources/integration_auth_configs/client.py

@@ -47,6 +47,7 @@ class IntegrationAuthConfigsClient:
         expand : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             The response fields to expand for more information.
             - 'integration_credentials' expands the list of integration credentials that the authenticated entity has access to for the auth config.
+            - 'additional_parameters' (retrieve only) fetches additional parameter requirements for the auth config.
 
         integration_name : typing.Optional[str]
 
@@ -130,6 +131,7 @@ class AsyncIntegrationAuthConfigsClient:
         expand : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             The response fields to expand for more information.
             - 'integration_credentials' expands the list of integration credentials that the authenticated entity has access to for the auth config.
+            - 'additional_parameters' (retrieve only) fetches additional parameter requirements for the auth config.
 
         integration_name : typing.Optional[str]
 

vellum/client/resources/integration_auth_configs/raw_client.py

@@ -35,6 +35,7 @@ class RawIntegrationAuthConfigsClient:
         expand : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             The response fields to expand for more information.
             - 'integration_credentials' expands the list of integration credentials that the authenticated entity has access to for the auth config.
+            - 'additional_parameters' (retrieve only) fetches additional parameter requirements for the auth config.
 
         integration_name : typing.Optional[str]
 
@@ -115,6 +116,7 @@ class AsyncRawIntegrationAuthConfigsClient:
         expand : typing.Optional[typing.Union[str, typing.Sequence[str]]]
             The response fields to expand for more information.
             - 'integration_credentials' expands the list of integration credentials that the authenticated entity has access to for the auth config.
+            - 'additional_parameters' (retrieve only) fetches additional parameter requirements for the auth config.
 
         integration_name : typing.Optional[str]
 

vellum/client/resources/integration_providers/client.py

@@ -34,6 +34,7 @@ class IntegrationProvidersClient:
         integration_provider: str,
         tool_name: str,
         *,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ComponentsSchemasComposioToolDefinition:
         """
@@ -50,6 +51,9 @@ class IntegrationProvidersClient:
         tool_name : str
             The tool's unique name, as specified by the integration provider
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to use. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -73,7 +77,11 @@ class IntegrationProvidersClient:
         )
         """
         _response = self._raw_client.retrieve_integration_provider_tool_definition(
-            integration_name, integration_provider, tool_name, request_options=request_options
+            integration_name,
+            integration_provider,
+            tool_name,
+            toolkit_version=toolkit_version,
+            request_options=request_options,
         )
         return _response.data
 
@@ -87,6 +95,7 @@ class IntegrationProvidersClient:
         limit: typing.Optional[int] = None,
         offset: typing.Optional[int] = None,
         search: typing.Optional[str] = None,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PaginatedSlimToolDefinitionList:
         """
@@ -115,6 +124,9 @@ class IntegrationProvidersClient:
         search : typing.Optional[str]
             The search term to filter the tools by
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to lookup. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -143,6 +155,7 @@ class IntegrationProvidersClient:
             limit=limit,
             offset=offset,
             search=search,
+            toolkit_version=toolkit_version,
             request_options=request_options,
         )
         return _response.data
@@ -169,6 +182,7 @@ class AsyncIntegrationProvidersClient:
         integration_provider: str,
         tool_name: str,
         *,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ComponentsSchemasComposioToolDefinition:
         """
@@ -185,6 +199,9 @@ class AsyncIntegrationProvidersClient:
         tool_name : str
             The tool's unique name, as specified by the integration provider
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to use. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -216,7 +233,11 @@ class AsyncIntegrationProvidersClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.retrieve_integration_provider_tool_definition(
-            integration_name, integration_provider, tool_name, request_options=request_options
+            integration_name,
+            integration_provider,
+            tool_name,
+            toolkit_version=toolkit_version,
+            request_options=request_options,
         )
         return _response.data
 
@@ -230,6 +251,7 @@ class AsyncIntegrationProvidersClient:
         limit: typing.Optional[int] = None,
         offset: typing.Optional[int] = None,
         search: typing.Optional[str] = None,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> PaginatedSlimToolDefinitionList:
         """
@@ -258,6 +280,9 @@ class AsyncIntegrationProvidersClient:
         search : typing.Optional[str]
             The search term to filter the tools by
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to lookup. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -294,6 +319,7 @@ class AsyncIntegrationProvidersClient:
             limit=limit,
             offset=offset,
             search=search,
+            toolkit_version=toolkit_version,
             request_options=request_options,
         )
         return _response.data

vellum/client/resources/integration_providers/raw_client.py

@@ -23,6 +23,7 @@ class RawIntegrationProvidersClient:
         integration_provider: str,
         tool_name: str,
         *,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[ComponentsSchemasComposioToolDefinition]:
         """
@@ -39,6 +40,9 @@ class RawIntegrationProvidersClient:
         tool_name : str
             The tool's unique name, as specified by the integration provider
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to use. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -51,6 +55,9 @@ class RawIntegrationProvidersClient:
             f"v1/integration-providers/{jsonable_encoder(integration_provider)}/integrations/{jsonable_encoder(integration_name)}/tools/{jsonable_encoder(tool_name)}",
             base_url=self._client_wrapper.get_environment().default,
             method="GET",
+            params={
+                "toolkit_version": toolkit_version,
+            },
             request_options=request_options,
         )
         try:
@@ -78,6 +85,7 @@ class RawIntegrationProvidersClient:
         limit: typing.Optional[int] = None,
         offset: typing.Optional[int] = None,
         search: typing.Optional[str] = None,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[PaginatedSlimToolDefinitionList]:
         """
@@ -106,6 +114,9 @@ class RawIntegrationProvidersClient:
         search : typing.Optional[str]
             The search term to filter the tools by
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to lookup. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -125,6 +136,7 @@ class RawIntegrationProvidersClient:
                 "limit": limit,
                 "offset": offset,
                 "search": search,
+                "toolkit_version": toolkit_version,
             },
             request_options=request_options,
         )
@@ -154,6 +166,7 @@ class AsyncRawIntegrationProvidersClient:
         integration_provider: str,
         tool_name: str,
         *,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[ComponentsSchemasComposioToolDefinition]:
         """
@@ -170,6 +183,9 @@ class AsyncRawIntegrationProvidersClient:
         tool_name : str
             The tool's unique name, as specified by the integration provider
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to use. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -182,6 +198,9 @@ class AsyncRawIntegrationProvidersClient:
             f"v1/integration-providers/{jsonable_encoder(integration_provider)}/integrations/{jsonable_encoder(integration_name)}/tools/{jsonable_encoder(tool_name)}",
             base_url=self._client_wrapper.get_environment().default,
             method="GET",
+            params={
+                "toolkit_version": toolkit_version,
+            },
             request_options=request_options,
         )
         try:
@@ -209,6 +228,7 @@ class AsyncRawIntegrationProvidersClient:
         limit: typing.Optional[int] = None,
         offset: typing.Optional[int] = None,
         search: typing.Optional[str] = None,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[PaginatedSlimToolDefinitionList]:
         """
@@ -237,6 +257,9 @@ class AsyncRawIntegrationProvidersClient:
         search : typing.Optional[str]
             The search term to filter the tools by
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to lookup. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -256,6 +279,7 @@ class AsyncRawIntegrationProvidersClient:
                 "limit": limit,
                 "offset": offset,
                 "search": search,
+                "toolkit_version": toolkit_version,
             },
             request_options=request_options,
         )

vellum/client/resources/integrations/client.py

@@ -39,6 +39,7 @@ class IntegrationsClient:
         integration_provider: str,
         tool_name: str,
         *,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ComponentsSchemasComposioToolDefinition:
         """
@@ -53,6 +54,9 @@ class IntegrationsClient:
         tool_name : str
             The tool's unique name, as specified by the integration provider
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to use. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -76,7 +80,11 @@ class IntegrationsClient:
         )
         """
         _response = self._raw_client.retrieve_integration_tool_definition(
-            integration_name, integration_provider, tool_name, request_options=request_options
+            integration_name,
+            integration_provider,
+            tool_name,
+            toolkit_version=toolkit_version,
+            request_options=request_options,
         )
         return _response.data
 
@@ -87,6 +95,9 @@ class IntegrationsClient:
         tool_name: str,
         *,
         arguments: typing.Dict[str, typing.Optional[typing.Any]],
+        toolkit_version: typing.Optional[str] = OMIT,
+        integration: typing.Optional[str] = OMIT,
+        tool: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ComponentsSchemasComposioExecuteToolResponse:
         """
@@ -103,6 +114,12 @@ class IntegrationsClient:
 
         arguments : typing.Dict[str, typing.Optional[typing.Any]]
 
+        toolkit_version : typing.Optional[str]
+
+        integration : typing.Optional[str]
+
+        tool : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -127,7 +144,14 @@ class IntegrationsClient:
         )
         """
         _response = self._raw_client.execute_integration_tool(
-            integration_name, integration_provider, tool_name, arguments=arguments, request_options=request_options
+            integration_name,
+            integration_provider,
+            tool_name,
+            arguments=arguments,
+            toolkit_version=toolkit_version,
+            integration=integration,
+            tool=tool,
+            request_options=request_options,
         )
         return _response.data
 
@@ -247,6 +271,7 @@ class AsyncIntegrationsClient:
         integration_provider: str,
         tool_name: str,
         *,
+        toolkit_version: typing.Optional[str] = None,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ComponentsSchemasComposioToolDefinition:
         """
@@ -261,6 +286,9 @@ class AsyncIntegrationsClient:
         tool_name : str
             The tool's unique name, as specified by the integration provider
 
+        toolkit_version : typing.Optional[str]
+            The version of the toolkit to use. Pass 'latest' to get the latest version, or a specific version string to pin it. If not provided, uses the provider's default.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -292,7 +320,11 @@ class AsyncIntegrationsClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.retrieve_integration_tool_definition(
-            integration_name, integration_provider, tool_name, request_options=request_options
+            integration_name,
+            integration_provider,
+            tool_name,
+            toolkit_version=toolkit_version,
+            request_options=request_options,
         )
         return _response.data
 
@@ -303,6 +335,9 @@ class AsyncIntegrationsClient:
         tool_name: str,
         *,
         arguments: typing.Dict[str, typing.Optional[typing.Any]],
+        toolkit_version: typing.Optional[str] = OMIT,
+        integration: typing.Optional[str] = OMIT,
+        tool: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> ComponentsSchemasComposioExecuteToolResponse:
         """
@@ -319,6 +354,12 @@ class AsyncIntegrationsClient:
 
         arguments : typing.Dict[str, typing.Optional[typing.Any]]
 
+        toolkit_version : typing.Optional[str]
+
+        integration : typing.Optional[str]
+
+        tool : typing.Optional[str]
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -351,7 +392,14 @@ class AsyncIntegrationsClient:
         asyncio.run(main())
         """
         _response = await self._raw_client.execute_integration_tool(
-            integration_name, integration_provider, tool_name, arguments=arguments, request_options=request_options
+            integration_name,
+            integration_provider,
+            tool_name,
+            arguments=arguments,
+            toolkit_version=toolkit_version,
+            integration=integration,
+            tool=tool,
+            request_options=request_options,
         )
         return _response.data