darwin-sdk 0.1.0__tar.gz

darwin_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Darwin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

darwin_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: darwin-sdk
+Version: 0.1.0
+Summary: Official Python SDK for Darwin
+Author: Darwin
+License-Expression: MIT
+Project-URL: Documentation, https://docs.darwin.so/sdks/python
+Project-URL: Issues, https://github.com/darwin-studios/darwin/issues
+Project-URL: Repository, https://github.com/darwin-studios/darwin-python
+Keywords: darwin,agent,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: anyio>=3.0.0
+Requires-Dist: httpx>=0.23.0
+Requires-Dist: pydantic<3,>=1.9.2
+Requires-Dist: typing-extensions>=4.0.0
+Dynamic: license-file
+
+# Darwin Python SDK
+
+The official Python client for the Darwin API. Fern generates the client from Darwin's reviewed
+public OpenAPI contract.
+
+```bash
+pip install darwin-sdk
+```
+
+```python
+import os
+
+from darwin_sdk import Darwin
+
+darwin = Darwin(token=os.environ["DARWIN_API_KEY"])
+turn = darwin.agent.create_message(
+    content="Help me plan a product launch.",
+)
+```
+
+See [docs.darwin.so](https://docs.darwin.so/sdks/python) for authentication and API guides.

darwin_sdk-0.1.0/README.md

@@ -0,0 +1,21 @@
+# Darwin Python SDK
+
+The official Python client for the Darwin API. Fern generates the client from Darwin's reviewed
+public OpenAPI contract.
+
+```bash
+pip install darwin-sdk
+```
+
+```python
+import os
+
+from darwin_sdk import Darwin
+
+darwin = Darwin(token=os.environ["DARWIN_API_KEY"])
+turn = darwin.agent.create_message(
+    content="Help me plan a product launch.",
+)
+```
+
+See [docs.darwin.so](https://docs.darwin.so/sdks/python) for authentication and API guides.

darwin_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "darwin-sdk"
+version = "0.1.0"
+description = "Official Python SDK for Darwin"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [{ name = "Darwin" }]
+keywords = ["darwin", "agent", "sdk"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Typing :: Typed",
+]
+dependencies = [
+  "anyio>=3.0.0",
+  "httpx>=0.23.0",
+  "pydantic>=1.9.2,<3",
+  "typing-extensions>=4.0.0",
+]
+
+[project.urls]
+Documentation = "https://docs.darwin.so/sdks/python"
+Issues = "https://github.com/darwin-studios/darwin/issues"
+Repository = "https://github.com/darwin-studios/darwin-python"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["darwin_sdk*"]
+exclude = ["darwin_sdk.tests*"]
+
+[tool.setuptools.package-data]
+darwin_sdk = ["py.typed"]

darwin_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

darwin_sdk-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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