vellum-ai 1.4.1__py3-none-any.whl → 1.5.0__py3-none-any.whl

vellum/__init__.py

@@ -68,9 +68,15 @@ from .client.types import (
     CodeResourceDefinition,
     CompilePromptDeploymentExpandMetaRequest,
     CompilePromptMeta,
+    ComponentsSchemasComposioExecuteToolRequest,
+    ComponentsSchemasComposioExecuteToolResponse,
+    ComponentsSchemasComposioToolDefinition,
     ComponentsSchemasPdfSearchResultMetaSource,
     ComponentsSchemasPdfSearchResultMetaSourceRequest,
     ComponentsSchemasPromptVersionBuildConfigSandbox,
+    ComposioExecuteToolRequest,
+    ComposioExecuteToolResponse,
+    ComposioToolDefinition,
     ConditionCombinator,
     ConditionalNodeResult,
     ConditionalNodeResultData,
@@ -694,6 +700,7 @@ from .resources import (
     documents,
     events,
     folder_entities,
+    integrations,
     metric_definitions,
     ml_models,
     organizations,
@@ -777,9 +784,15 @@ __all__ = [
     "CodeResourceDefinition",
     "CompilePromptDeploymentExpandMetaRequest",
     "CompilePromptMeta",
+    "ComponentsSchemasComposioExecuteToolRequest",
+    "ComponentsSchemasComposioExecuteToolResponse",
+    "ComponentsSchemasComposioToolDefinition",
     "ComponentsSchemasPdfSearchResultMetaSource",
     "ComponentsSchemasPdfSearchResultMetaSourceRequest",
     "ComponentsSchemasPromptVersionBuildConfigSandbox",
+    "ComposioExecuteToolRequest",
+    "ComposioExecuteToolResponse",
+    "ComposioToolDefinition",
     "ConditionCombinator",
     "ConditionalNodeResult",
     "ConditionalNodeResultData",
@@ -1401,6 +1414,7 @@ __all__ = [
     "documents",
     "events",
     "folder_entities",
+    "integrations",
     "metric_definitions",
     "ml_models",
     "organizations",

vellum/client/__init__.py

@@ -16,6 +16,7 @@ from .resources.document_indexes.client import AsyncDocumentIndexesClient, Docum
 from .resources.documents.client import AsyncDocumentsClient, DocumentsClient
 from .resources.events.client import AsyncEventsClient, EventsClient
 from .resources.folder_entities.client import AsyncFolderEntitiesClient, FolderEntitiesClient
+from .resources.integrations.client import AsyncIntegrationsClient, IntegrationsClient
 from .resources.metric_definitions.client import AsyncMetricDefinitionsClient, MetricDefinitionsClient
 from .resources.ml_models.client import AsyncMlModelsClient, MlModelsClient
 from .resources.organizations.client import AsyncOrganizationsClient, OrganizationsClient
@@ -129,6 +130,7 @@ class Vellum:
             timeout=_defaulted_timeout,
         )
         self._raw_client = RawVellum(client_wrapper=self._client_wrapper)
+        self.integrations = IntegrationsClient(client_wrapper=self._client_wrapper)
         self.events = EventsClient(client_wrapper=self._client_wrapper)
         self.ad_hoc = AdHocClient(client_wrapper=self._client_wrapper)
         self.container_images = ContainerImagesClient(client_wrapper=self._client_wrapper)
@@ -1003,6 +1005,7 @@ class AsyncVellum:
             timeout=_defaulted_timeout,
         )
         self._raw_client = AsyncRawVellum(client_wrapper=self._client_wrapper)
+        self.integrations = AsyncIntegrationsClient(client_wrapper=self._client_wrapper)
         self.events = AsyncEventsClient(client_wrapper=self._client_wrapper)
         self.ad_hoc = AsyncAdHocClient(client_wrapper=self._client_wrapper)
         self.container_images = AsyncContainerImagesClient(client_wrapper=self._client_wrapper)

vellum/client/core/client_wrapper.py

@@ -27,10 +27,10 @@ class BaseClientWrapper:
 
     def get_headers(self) -> typing.Dict[str, str]:
         headers: typing.Dict[str, str] = {
-            "User-Agent": "vellum-ai/1.4.1",
+            "User-Agent": "vellum-ai/1.5.0",
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "vellum-ai",
-            "X-Fern-SDK-Version": "1.4.1",
+            "X-Fern-SDK-Version": "1.5.0",
             **(self.get_custom_headers() or {}),
         }
         if self._api_version is not None:

vellum/client/reference.md

@@ -1261,6 +1261,166 @@ client.submit_workflow_execution_actuals(
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Integrations
+<details><summary><code>client.integrations.<a href="src/vellum/resources/integrations/client.py">retrieve_integration_tool_definition</a>(...)</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```python
+from vellum import Vellum
+
+client = Vellum(
+    api_version="YOUR_API_VERSION",
+    api_key="YOUR_API_KEY",
+)
+client.integrations.retrieve_integration_tool_definition(
+    integration="integration",
+    provider="provider",
+    tool_name="tool_name",
+)
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**integration:** `str` — The integration name
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**provider:** `str` — The integration provider name
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**tool_name:** `str` — The tool's unique name, as specified by the integration provider
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.integrations.<a href="src/vellum/resources/integrations/client.py">execute_integration_tool</a>(...)</code></summary>
+<dl>
+<dd>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```python
+from vellum import Vellum
+
+client = Vellum(
+    api_version="YOUR_API_VERSION",
+    api_key="YOUR_API_KEY",
+)
+client.integrations.execute_integration_tool(
+    integration="integration",
+    provider="provider",
+    tool_name="tool_name",
+    arguments={"arguments": {"key": "value"}},
+)
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**integration:** `str` — The integration name
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**provider:** `str` — The integration provider name
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**tool_name:** `str` — The tool's unique name, as specified by the integration provider
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**arguments:** `typing.Dict[str, typing.Optional[typing.Any]]` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request_options:** `typing.Optional[RequestOptions]` — Request-specific configuration.
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>

vellum/client/resources/__init__.py

@@ -10,6 +10,7 @@ from . import (
     documents,
     events,
     folder_entities,
+    integrations,
     metric_definitions,
     ml_models,
     organizations,
@@ -45,6 +46,7 @@ __all__ = [
     "documents",
     "events",
     "folder_entities",
+    "integrations",
     "metric_definitions",
     "ml_models",
     "organizations",

vellum/client/resources/integrations/__init__.py

@@ -0,0 +1,4 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+

vellum/client/resources/integrations/client.py

@@ -0,0 +1,260 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ...core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ...core.request_options import RequestOptions
+from ...types.components_schemas_composio_execute_tool_response import ComponentsSchemasComposioExecuteToolResponse
+from ...types.components_schemas_composio_tool_definition import ComponentsSchemasComposioToolDefinition
+from .raw_client import AsyncRawIntegrationsClient, RawIntegrationsClient
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class IntegrationsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawIntegrationsClient(client_wrapper=client_wrapper)
+
+    @property
+    def _client_wrapper(self) -> SyncClientWrapper:
+        return self._raw_client._client_wrapper
+
+    @property
+    def with_raw_response(self) -> RawIntegrationsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawIntegrationsClient
+        """
+        return self._raw_client
+
+    def retrieve_integration_tool_definition(
+        self,
+        integration: str,
+        provider: str,
+        tool_name: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ComponentsSchemasComposioToolDefinition:
+        """
+        Parameters
+        ----------
+        integration : str
+            The integration name
+
+        provider : str
+            The integration provider name
+
+        tool_name : str
+            The tool's unique name, as specified by the integration provider
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ComponentsSchemasComposioToolDefinition
+
+
+        Examples
+        --------
+        from vellum import Vellum
+
+        client = Vellum(
+            api_version="YOUR_API_VERSION",
+            api_key="YOUR_API_KEY",
+        )
+        client.integrations.retrieve_integration_tool_definition(
+            integration="integration",
+            provider="provider",
+            tool_name="tool_name",
+        )
+        """
+        _response = self._raw_client.retrieve_integration_tool_definition(
+            integration, provider, tool_name, request_options=request_options
+        )
+        return _response.data
+
+    def execute_integration_tool(
+        self,
+        integration: str,
+        provider: str,
+        tool_name: str,
+        *,
+        arguments: typing.Dict[str, typing.Optional[typing.Any]],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ComponentsSchemasComposioExecuteToolResponse:
+        """
+        Parameters
+        ----------
+        integration : str
+            The integration name
+
+        provider : str
+            The integration provider name
+
+        tool_name : str
+            The tool's unique name, as specified by the integration provider
+
+        arguments : typing.Dict[str, typing.Optional[typing.Any]]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ComponentsSchemasComposioExecuteToolResponse
+
+
+        Examples
+        --------
+        from vellum import Vellum
+
+        client = Vellum(
+            api_version="YOUR_API_VERSION",
+            api_key="YOUR_API_KEY",
+        )
+        client.integrations.execute_integration_tool(
+            integration="integration",
+            provider="provider",
+            tool_name="tool_name",
+            arguments={"arguments": {"key": "value"}},
+        )
+        """
+        _response = self._raw_client.execute_integration_tool(
+            integration, provider, tool_name, arguments=arguments, request_options=request_options
+        )
+        return _response.data
+
+
+class AsyncIntegrationsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawIntegrationsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawIntegrationsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawIntegrationsClient
+        """
+        return self._raw_client
+
+    async def retrieve_integration_tool_definition(
+        self,
+        integration: str,
+        provider: str,
+        tool_name: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ComponentsSchemasComposioToolDefinition:
+        """
+        Parameters
+        ----------
+        integration : str
+            The integration name
+
+        provider : str
+            The integration provider name
+
+        tool_name : str
+            The tool's unique name, as specified by the integration provider
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ComponentsSchemasComposioToolDefinition
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum
+
+        client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.integrations.retrieve_integration_tool_definition(
+                integration="integration",
+                provider="provider",
+                tool_name="tool_name",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.retrieve_integration_tool_definition(
+            integration, provider, tool_name, request_options=request_options
+        )
+        return _response.data
+
+    async def execute_integration_tool(
+        self,
+        integration: str,
+        provider: str,
+        tool_name: str,
+        *,
+        arguments: typing.Dict[str, typing.Optional[typing.Any]],
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ComponentsSchemasComposioExecuteToolResponse:
+        """
+        Parameters
+        ----------
+        integration : str
+            The integration name
+
+        provider : str
+            The integration provider name
+
+        tool_name : str
+            The tool's unique name, as specified by the integration provider
+
+        arguments : typing.Dict[str, typing.Optional[typing.Any]]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ComponentsSchemasComposioExecuteToolResponse
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum
+
+        client = AsyncVellum(
+            api_version="YOUR_API_VERSION",
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.integrations.execute_integration_tool(
+                integration="integration",
+                provider="provider",
+                tool_name="tool_name",
+                arguments={"arguments": {"key": "value"}},
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.execute_integration_tool(
+            integration, provider, tool_name, arguments=arguments, request_options=request_options
+        )
+        return _response.data