darwin-sdk 0.1.0__py3-none-any.whl

darwin_sdk/__init__.py

@@ -0,0 +1,96 @@
+# This file was auto-generated by Fern from our API Definition.
+
+# isort: skip_file
+
+import typing
+from importlib import import_module
+
+if typing.TYPE_CHECKING:
+    from .types import Approval, Error, ErrorMessage, ExecuteToolResponse, Goal, Tool, ToolRisk
+    from .errors import BadRequestError, ForbiddenError, NotFoundError, UnauthorizedError
+    from . import agent, approvals, goals, integrations, tools
+    from ._default_clients import DefaultAioHttpClient, DefaultAsyncHttpxClient
+    from .approvals import ApprovalDecisionRequestDecision, ListApprovalsResponse
+    from .client import AsyncDarwin, Darwin
+    from .environment import DarwinEnvironment
+    from .goals import CreateGoalRequestKind, ListGoalsResponse
+    from .tools import ListToolsResponse
+_dynamic_imports: typing.Dict[str, str] = {
+    "Approval": ".types",
+    "ApprovalDecisionRequestDecision": ".approvals",
+    "AsyncDarwin": ".client",
+    "BadRequestError": ".errors",
+    "CreateGoalRequestKind": ".goals",
+    "Darwin": ".client",
+    "DarwinEnvironment": ".environment",
+    "DefaultAioHttpClient": "._default_clients",
+    "DefaultAsyncHttpxClient": "._default_clients",
+    "Error": ".types",
+    "ErrorMessage": ".types",
+    "ExecuteToolResponse": ".types",
+    "ForbiddenError": ".errors",
+    "Goal": ".types",
+    "ListApprovalsResponse": ".approvals",
+    "ListGoalsResponse": ".goals",
+    "ListToolsResponse": ".tools",
+    "NotFoundError": ".errors",
+    "Tool": ".types",
+    "ToolRisk": ".types",
+    "UnauthorizedError": ".errors",
+    "agent": ".agent",
+    "approvals": ".approvals",
+    "goals": ".goals",
+    "integrations": ".integrations",
+    "tools": ".tools",
+}
+
+
+def __getattr__(attr_name: str) -> typing.Any:
+    module_name = _dynamic_imports.get(attr_name)
+    if module_name is None:
+        raise AttributeError(f"No {attr_name} found in _dynamic_imports for module name -> {__name__}")
+    try:
+        module = import_module(module_name, __package__)
+        if module_name == f".{attr_name}":
+            return module
+        else:
+            return getattr(module, attr_name)
+    except ImportError as e:
+        raise ImportError(f"Failed to import {attr_name} from {module_name}: {e}") from e
+    except AttributeError as e:
+        raise AttributeError(f"Failed to get {attr_name} from {module_name}: {e}") from e
+
+
+def __dir__():
+    lazy_attrs = list(_dynamic_imports.keys())
+    return sorted(lazy_attrs)
+
+
+__all__ = [
+    "Approval",
+    "ApprovalDecisionRequestDecision",
+    "AsyncDarwin",
+    "BadRequestError",
+    "CreateGoalRequestKind",
+    "Darwin",
+    "DarwinEnvironment",
+    "DefaultAioHttpClient",
+    "DefaultAsyncHttpxClient",
+    "Error",
+    "ErrorMessage",
+    "ExecuteToolResponse",
+    "ForbiddenError",
+    "Goal",
+    "ListApprovalsResponse",
+    "ListGoalsResponse",
+    "ListToolsResponse",
+    "NotFoundError",
+    "Tool",
+    "ToolRisk",
+    "UnauthorizedError",
+    "agent",
+    "approvals",
+    "goals",
+    "integrations",
+    "tools",
+]

darwin_sdk/_default_clients.py

@@ -0,0 +1,30 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import httpx
+
+SDK_DEFAULT_TIMEOUT = 60
+
+try:
+    import httpx_aiohttp  # type: ignore[import-not-found]
+except ImportError:
+
+    class DefaultAioHttpClient(httpx.AsyncClient):  # type: ignore
+        def __init__(self, **kwargs: typing.Any) -> None:
+            raise RuntimeError("To use the aiohttp client, install the aiohttp extra: pip install darwin_sdk[aiohttp]")
+
+else:
+
+    class DefaultAioHttpClient(httpx_aiohttp.HttpxAiohttpClient):  # type: ignore
+        def __init__(self, **kwargs: typing.Any) -> None:
+            kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)
+            kwargs.setdefault("follow_redirects", True)
+            super().__init__(**kwargs)
+
+
+class DefaultAsyncHttpxClient(httpx.AsyncClient):
+    def __init__(self, **kwargs: typing.Any) -> None:
+        kwargs.setdefault("timeout", SDK_DEFAULT_TIMEOUT)
+        kwargs.setdefault("follow_redirects", True)
+        super().__init__(**kwargs)

darwin_sdk/agent/__init__.py

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

darwin_sdk/agent/client.py

@@ -0,0 +1,212 @@
+# 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 .raw_client import AsyncRawAgentClient, RawAgentClient
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class AgentClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAgentClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAgentClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAgentClient
+        """
+        return self._raw_client
+
+    def get_conversation(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        cursor: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Dict[str, typing.Any]:
+        """
+        Returns the conversation for the agent currently selected on the developer/MCP channel. Natural-language routing in createMessage updates this selection.
+
+        Parameters
+        ----------
+        limit : typing.Optional[int]
+
+        cursor : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Dict[str, typing.Any]
+            The conversation page.
+
+        Examples
+        --------
+        from darwin_sdk import Darwin
+
+        client = Darwin(
+            token="YOUR_TOKEN",
+        )
+        client.agent.get_conversation()
+        """
+        _response = self._raw_client.get_conversation(limit=limit, cursor=cursor, request_options=request_options)
+        return _response.data
+
+    def create_message(
+        self,
+        *,
+        content: str,
+        request_id: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Dict[str, typing.Any]:
+        """
+        Darwin infers the intended accessible personal or business agent from the message and current conversation. Name an agent naturally when changing context; ambiguous requests return a clarification without running tools.
+
+        Parameters
+        ----------
+        content : str
+
+        request_id : typing.Optional[str]
+            An optional caller-generated idempotency and correlation identifier.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Dict[str, typing.Any]
+            The completed agent turn.
+
+        Examples
+        --------
+        from darwin_sdk import Darwin
+
+        client = Darwin(
+            token="YOUR_TOKEN",
+        )
+        client.agent.create_message(
+            content="content",
+        )
+        """
+        _response = self._raw_client.create_message(
+            content=content, request_id=request_id, request_options=request_options
+        )
+        return _response.data
+
+
+class AsyncAgentClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAgentClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAgentClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAgentClient
+        """
+        return self._raw_client
+
+    async def get_conversation(
+        self,
+        *,
+        limit: typing.Optional[int] = None,
+        cursor: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Dict[str, typing.Any]:
+        """
+        Returns the conversation for the agent currently selected on the developer/MCP channel. Natural-language routing in createMessage updates this selection.
+
+        Parameters
+        ----------
+        limit : typing.Optional[int]
+
+        cursor : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Dict[str, typing.Any]
+            The conversation page.
+
+        Examples
+        --------
+        import asyncio
+
+        from darwin_sdk import AsyncDarwin
+
+        client = AsyncDarwin(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agent.get_conversation()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_conversation(limit=limit, cursor=cursor, request_options=request_options)
+        return _response.data
+
+    async def create_message(
+        self,
+        *,
+        content: str,
+        request_id: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Dict[str, typing.Any]:
+        """
+        Darwin infers the intended accessible personal or business agent from the message and current conversation. Name an agent naturally when changing context; ambiguous requests return a clarification without running tools.
+
+        Parameters
+        ----------
+        content : str
+
+        request_id : typing.Optional[str]
+            An optional caller-generated idempotency and correlation identifier.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.Dict[str, typing.Any]
+            The completed agent turn.
+
+        Examples
+        --------
+        import asyncio
+
+        from darwin_sdk import AsyncDarwin
+
+        client = AsyncDarwin(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.agent.create_message(
+                content="content",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.create_message(
+            content=content, request_id=request_id, request_options=request_options
+        )
+        return _response.data