letta-client 0.1.11__py3-none-any.whl → 0.1.14__py3-none-any.whl

letta_client/__init__.py

@@ -127,7 +127,7 @@ from .types import (
     ValidationErrorLocItem,
 )
 from .errors import ConflictError, InternalServerError, NotFoundError, UnprocessableEntityError
-from . import agents, blocks, health, jobs, models, providers, runs, sources, tools
+from . import agents, blocks, health, jobs, models, providers, runs, sources, tag, tools
 from .agents import (
     AgentsSearchRequestCombinator,
     AgentsSearchRequestSearchItem,
@@ -136,9 +136,11 @@ from .agents import (
     AgentsSearchRequestSearchItemOrderBy,
     AgentsSearchRequestSearchItemOrderByDirection,
     AgentsSearchRequestSearchItemOrderByValue,
+    AgentsSearchRequestSearchItemTags,
     AgentsSearchRequestSearchItemVersion,
     AgentsSearchRequestSearchItem_Name,
     AgentsSearchRequestSearchItem_OrderBy,
+    AgentsSearchRequestSearchItem_Tags,
     AgentsSearchRequestSearchItem_Version,
     CreateAgentRequestToolRulesItem,
     UpdateAgentToolRulesItem,
@@ -162,9 +164,11 @@ __all__ = [
     "AgentsSearchRequestSearchItemOrderBy",
     "AgentsSearchRequestSearchItemOrderByDirection",
     "AgentsSearchRequestSearchItemOrderByValue",
+    "AgentsSearchRequestSearchItemTags",
     "AgentsSearchRequestSearchItemVersion",
     "AgentsSearchRequestSearchItem_Name",
     "AgentsSearchRequestSearchItem_OrderBy",
+    "AgentsSearchRequestSearchItem_Tags",
     "AgentsSearchRequestSearchItem_Version",
     "AppAuthScheme",
     "AppAuthSchemeAuthMode",
@@ -301,5 +305,6 @@ __all__ = [
     "providers",
     "runs",
     "sources",
+    "tag",
     "tools",
 ]

letta_client/agents/__init__.py

@@ -8,9 +8,11 @@ from .types import (
     AgentsSearchRequestSearchItemOrderBy,
     AgentsSearchRequestSearchItemOrderByDirection,
     AgentsSearchRequestSearchItemOrderByValue,
+    AgentsSearchRequestSearchItemTags,
     AgentsSearchRequestSearchItemVersion,
     AgentsSearchRequestSearchItem_Name,
     AgentsSearchRequestSearchItem_OrderBy,
+    AgentsSearchRequestSearchItem_Tags,
     AgentsSearchRequestSearchItem_Version,
     CreateAgentRequestToolRulesItem,
     UpdateAgentToolRulesItem,
@@ -55,9 +57,11 @@ __all__ = [
     "AgentsSearchRequestSearchItemOrderBy",
     "AgentsSearchRequestSearchItemOrderByDirection",
     "AgentsSearchRequestSearchItemOrderByValue",
+    "AgentsSearchRequestSearchItemTags",
     "AgentsSearchRequestSearchItemVersion",
     "AgentsSearchRequestSearchItem_Name",
     "AgentsSearchRequestSearchItem_OrderBy",
+    "AgentsSearchRequestSearchItem_Tags",
     "AgentsSearchRequestSearchItem_Version",
     "CreateAgentRequestToolRulesItem",
     "LettaStreamingResponse",

letta_client/agents/client.py

@@ -144,8 +144,8 @@ class AgentsClient:
     def create(
         self,
         *,
-        memory_blocks: typing.Sequence[CreateBlock],
         name: typing.Optional[str] = OMIT,
+        memory_blocks: typing.Optional[typing.Sequence[CreateBlock]] = OMIT,
         tools: typing.Optional[typing.Sequence[str]] = OMIT,
         tool_ids: typing.Optional[typing.Sequence[str]] = OMIT,
         source_ids: typing.Optional[typing.Sequence[str]] = OMIT,
@@ -165,6 +165,7 @@ class AgentsClient:
         context_window_limit: typing.Optional[int] = OMIT,
         embedding_chunk_size: typing.Optional[int] = OMIT,
         from_template: typing.Optional[str] = OMIT,
+        template: typing.Optional[bool] = OMIT,
         project: typing.Optional[str] = OMIT,
         tool_exec_environment_variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
         variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
@@ -175,12 +176,12 @@ class AgentsClient:
 
         Parameters
         ----------
-        memory_blocks : typing.Sequence[CreateBlock]
-            The blocks to create in the agent's in-context memory.
-
         name : typing.Optional[str]
             The name of the agent.
 
+        memory_blocks : typing.Optional[typing.Sequence[CreateBlock]]
+            The blocks to create in the agent's in-context memory.
+
         tools : typing.Optional[typing.Sequence[str]]
             The tools used by the agent.
 
@@ -238,6 +239,9 @@ class AgentsClient:
         from_template : typing.Optional[str]
             The template id used to configure the agent
 
+        template : typing.Optional[bool]
+            Whether the agent is a template
+
         project : typing.Optional[str]
             The project slug that the agent will be associated with.
 
@@ -257,19 +261,12 @@ class AgentsClient:
 
         Examples
         --------
-        from letta_client import CreateBlock, Letta
+        from letta_client import Letta
 
         client = Letta(
             token="YOUR_TOKEN",
         )
-        client.agents.create(
-            memory_blocks=[
-                CreateBlock(
-                    value="value",
-                    label="label",
-                )
-            ],
-        )
+        client.agents.create()
         """
         _response = self._client_wrapper.httpx_client.request(
             "v1/agents/",
@@ -306,6 +303,7 @@ class AgentsClient:
                 "context_window_limit": context_window_limit,
                 "embedding_chunk_size": embedding_chunk_size,
                 "from_template": from_template,
+                "template": template,
                 "project": project,
                 "tool_exec_environment_variables": tool_exec_environment_variables,
                 "variables": variables,
@@ -838,8 +836,8 @@ class AsyncAgentsClient:
     async def create(
         self,
         *,
-        memory_blocks: typing.Sequence[CreateBlock],
         name: typing.Optional[str] = OMIT,
+        memory_blocks: typing.Optional[typing.Sequence[CreateBlock]] = OMIT,
         tools: typing.Optional[typing.Sequence[str]] = OMIT,
         tool_ids: typing.Optional[typing.Sequence[str]] = OMIT,
         source_ids: typing.Optional[typing.Sequence[str]] = OMIT,
@@ -859,6 +857,7 @@ class AsyncAgentsClient:
         context_window_limit: typing.Optional[int] = OMIT,
         embedding_chunk_size: typing.Optional[int] = OMIT,
         from_template: typing.Optional[str] = OMIT,
+        template: typing.Optional[bool] = OMIT,
         project: typing.Optional[str] = OMIT,
         tool_exec_environment_variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
         variables: typing.Optional[typing.Dict[str, typing.Optional[str]]] = OMIT,
@@ -869,12 +868,12 @@ class AsyncAgentsClient:
 
         Parameters
         ----------
-        memory_blocks : typing.Sequence[CreateBlock]
-            The blocks to create in the agent's in-context memory.
-
         name : typing.Optional[str]
             The name of the agent.
 
+        memory_blocks : typing.Optional[typing.Sequence[CreateBlock]]
+            The blocks to create in the agent's in-context memory.
+
         tools : typing.Optional[typing.Sequence[str]]
             The tools used by the agent.
 
@@ -932,6 +931,9 @@ class AsyncAgentsClient:
         from_template : typing.Optional[str]
             The template id used to configure the agent
 
+        template : typing.Optional[bool]
+            Whether the agent is a template
+
         project : typing.Optional[str]
             The project slug that the agent will be associated with.
 
@@ -953,7 +955,7 @@ class AsyncAgentsClient:
         --------
         import asyncio
 
-        from letta_client import AsyncLetta, CreateBlock
+        from letta_client import AsyncLetta
 
         client = AsyncLetta(
             token="YOUR_TOKEN",
@@ -961,14 +963,7 @@ class AsyncAgentsClient:
 
 
         async def main() -> None:
-            await client.agents.create(
-                memory_blocks=[
-                    CreateBlock(
-                        value="value",
-                        label="label",
-                    )
-                ],
-            )
+            await client.agents.create()
 
 
         asyncio.run(main())
@@ -1008,6 +1003,7 @@ class AsyncAgentsClient:
                 "context_window_limit": context_window_limit,
                 "embedding_chunk_size": embedding_chunk_size,
                 "from_template": from_template,
+                "template": template,
                 "project": project,
                 "tool_exec_environment_variables": tool_exec_environment_variables,
                 "variables": variables,

letta_client/agents/types/__init__.py

@@ -5,6 +5,7 @@ from .agents_search_request_search_item import (
     AgentsSearchRequestSearchItem,
     AgentsSearchRequestSearchItem_Name,
     AgentsSearchRequestSearchItem_OrderBy,
+    AgentsSearchRequestSearchItem_Tags,
     AgentsSearchRequestSearchItem_Version,
 )
 from .agents_search_request_search_item_name import AgentsSearchRequestSearchItemName
@@ -12,6 +13,7 @@ from .agents_search_request_search_item_name_operator import AgentsSearchRequest
 from .agents_search_request_search_item_order_by import AgentsSearchRequestSearchItemOrderBy
 from .agents_search_request_search_item_order_by_direction import AgentsSearchRequestSearchItemOrderByDirection
 from .agents_search_request_search_item_order_by_value import AgentsSearchRequestSearchItemOrderByValue
+from .agents_search_request_search_item_tags import AgentsSearchRequestSearchItemTags
 from .agents_search_request_search_item_version import AgentsSearchRequestSearchItemVersion
 from .create_agent_request_tool_rules_item import CreateAgentRequestToolRulesItem
 from .update_agent_tool_rules_item import UpdateAgentToolRulesItem
@@ -24,9 +26,11 @@ __all__ = [
     "AgentsSearchRequestSearchItemOrderBy",
     "AgentsSearchRequestSearchItemOrderByDirection",
     "AgentsSearchRequestSearchItemOrderByValue",
+    "AgentsSearchRequestSearchItemTags",
     "AgentsSearchRequestSearchItemVersion",
     "AgentsSearchRequestSearchItem_Name",
     "AgentsSearchRequestSearchItem_OrderBy",
+    "AgentsSearchRequestSearchItem_Tags",
     "AgentsSearchRequestSearchItem_Version",
     "CreateAgentRequestToolRulesItem",
     "UpdateAgentToolRulesItem",

letta_client/agents/types/agents_search_request_search_item.py

@@ -41,6 +41,21 @@ class AgentsSearchRequestSearchItem_Name(UncheckedBaseModel):
             extra = pydantic.Extra.allow
 
 
+class AgentsSearchRequestSearchItem_Tags(UncheckedBaseModel):
+    field: typing.Literal["tags"] = "tags"
+    operator: typing.Literal["contains"] = "contains"
+    value: typing.List[str]
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow
+
+
 class AgentsSearchRequestSearchItem_OrderBy(UncheckedBaseModel):
     field: typing.Literal["order_by"] = "order_by"
     value: AgentsSearchRequestSearchItemOrderByValue
@@ -58,7 +73,10 @@ class AgentsSearchRequestSearchItem_OrderBy(UncheckedBaseModel):
 
 AgentsSearchRequestSearchItem = typing_extensions.Annotated[
     typing.Union[
-        AgentsSearchRequestSearchItem_Version, AgentsSearchRequestSearchItem_Name, AgentsSearchRequestSearchItem_OrderBy
+        AgentsSearchRequestSearchItem_Version,
+        AgentsSearchRequestSearchItem_Name,
+        AgentsSearchRequestSearchItem_Tags,
+        AgentsSearchRequestSearchItem_OrderBy,
     ],
     UnionMetadata(discriminant="field"),
 ]

letta_client/agents/types/agents_search_request_search_item_tags.py

@@ -0,0 +1,20 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ...core.unchecked_base_model import UncheckedBaseModel
+import typing
+from ...core.pydantic_utilities import IS_PYDANTIC_V2
+import pydantic
+
+
+class AgentsSearchRequestSearchItemTags(UncheckedBaseModel):
+    operator: typing.Literal["contains"] = "contains"
+    value: typing.List[str]
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

letta_client/base_client.py

@@ -0,0 +1,176 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from .environment import LettaEnvironment
+import httpx
+from .core.client_wrapper import SyncClientWrapper
+from .tools.client import ToolsClient
+from .sources.client import SourcesClient
+from .agents.client import AgentsClient
+from .models.client import ModelsClient
+from .blocks.client import BlocksClient
+from .jobs.client import JobsClient
+from .health.client import HealthClient
+from .providers.client import ProvidersClient
+from .runs.client import RunsClient
+from .tag.client import TagClient
+from .core.client_wrapper import AsyncClientWrapper
+from .tools.client import AsyncToolsClient
+from .sources.client import AsyncSourcesClient
+from .agents.client import AsyncAgentsClient
+from .models.client import AsyncModelsClient
+from .blocks.client import AsyncBlocksClient
+from .jobs.client import AsyncJobsClient
+from .health.client import AsyncHealthClient
+from .providers.client import AsyncProvidersClient
+from .runs.client import AsyncRunsClient
+from .tag.client import AsyncTagClient
+
+
+class LettaBase:
+    """
+    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+
+    Parameters
+    ----------
+    base_url : typing.Optional[str]
+        The base url to use for requests from the client.
+
+    environment : LettaEnvironment
+        The environment to use for requests from the client. from .environment import LettaEnvironment
+
+
+
+        Defaults to LettaEnvironment.LETTA_CLOUD
+
+
+
+    token : typing.Optional[str]
+    timeout : typing.Optional[float]
+        The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
+
+    follow_redirects : typing.Optional[bool]
+        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+
+    httpx_client : typing.Optional[httpx.Client]
+        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+
+    Examples
+    --------
+    from letta_client import Letta
+
+    client = Letta(
+        token="YOUR_TOKEN",
+    )
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[str] = None,
+        environment: LettaEnvironment = LettaEnvironment.LETTA_CLOUD,
+        token: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+        follow_redirects: typing.Optional[bool] = True,
+        httpx_client: typing.Optional[httpx.Client] = None,
+    ):
+        _defaulted_timeout = timeout if timeout is not None else 60 if httpx_client is None else None
+        self._client_wrapper = SyncClientWrapper(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            token=token,
+            httpx_client=httpx_client
+            if httpx_client is not None
+            else httpx.Client(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
+            if follow_redirects is not None
+            else httpx.Client(timeout=_defaulted_timeout),
+            timeout=_defaulted_timeout,
+        )
+        self.tools = ToolsClient(client_wrapper=self._client_wrapper)
+        self.sources = SourcesClient(client_wrapper=self._client_wrapper)
+        self.agents = AgentsClient(client_wrapper=self._client_wrapper)
+        self.models = ModelsClient(client_wrapper=self._client_wrapper)
+        self.blocks = BlocksClient(client_wrapper=self._client_wrapper)
+        self.jobs = JobsClient(client_wrapper=self._client_wrapper)
+        self.health = HealthClient(client_wrapper=self._client_wrapper)
+        self.providers = ProvidersClient(client_wrapper=self._client_wrapper)
+        self.runs = RunsClient(client_wrapper=self._client_wrapper)
+        self.tag = TagClient(client_wrapper=self._client_wrapper)
+
+
+class AsyncLettaBase:
+    """
+    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+
+    Parameters
+    ----------
+    base_url : typing.Optional[str]
+        The base url to use for requests from the client.
+
+    environment : LettaEnvironment
+        The environment to use for requests from the client. from .environment import LettaEnvironment
+
+
+
+        Defaults to LettaEnvironment.LETTA_CLOUD
+
+
+
+    token : typing.Optional[str]
+    timeout : typing.Optional[float]
+        The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
+
+    follow_redirects : typing.Optional[bool]
+        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+
+    httpx_client : typing.Optional[httpx.AsyncClient]
+        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+
+    Examples
+    --------
+    from letta_client import AsyncLetta
+
+    client = AsyncLetta(
+        token="YOUR_TOKEN",
+    )
+    """
+
+    def __init__(
+        self,
+        *,
+        base_url: typing.Optional[str] = None,
+        environment: LettaEnvironment = LettaEnvironment.LETTA_CLOUD,
+        token: typing.Optional[str] = None,
+        timeout: typing.Optional[float] = None,
+        follow_redirects: typing.Optional[bool] = True,
+        httpx_client: typing.Optional[httpx.AsyncClient] = None,
+    ):
+        _defaulted_timeout = timeout if timeout is not None else 60 if httpx_client is None else None
+        self._client_wrapper = AsyncClientWrapper(
+            base_url=_get_base_url(base_url=base_url, environment=environment),
+            token=token,
+            httpx_client=httpx_client
+            if httpx_client is not None
+            else httpx.AsyncClient(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
+            if follow_redirects is not None
+            else httpx.AsyncClient(timeout=_defaulted_timeout),
+            timeout=_defaulted_timeout,
+        )
+        self.tools = AsyncToolsClient(client_wrapper=self._client_wrapper)
+        self.sources = AsyncSourcesClient(client_wrapper=self._client_wrapper)
+        self.agents = AsyncAgentsClient(client_wrapper=self._client_wrapper)
+        self.models = AsyncModelsClient(client_wrapper=self._client_wrapper)
+        self.blocks = AsyncBlocksClient(client_wrapper=self._client_wrapper)
+        self.jobs = AsyncJobsClient(client_wrapper=self._client_wrapper)
+        self.health = AsyncHealthClient(client_wrapper=self._client_wrapper)
+        self.providers = AsyncProvidersClient(client_wrapper=self._client_wrapper)
+        self.runs = AsyncRunsClient(client_wrapper=self._client_wrapper)
+        self.tag = AsyncTagClient(client_wrapper=self._client_wrapper)
+
+
+def _get_base_url(*, base_url: typing.Optional[str] = None, environment: LettaEnvironment) -> str:
+    if base_url is not None:
+        return base_url
+    elif environment is not None:
+        return environment.value
+    else:
+        raise Exception("Please pass in either base_url or environment to construct the client")

letta_client/client.py

@@ -1,172 +1,55 @@
-# This file was auto-generated by Fern from our API Definition.
-
+from textwrap import dedent
+import inspect
 import typing
-from .environment import LettaEnvironment
-import httpx
-from .core.client_wrapper import SyncClientWrapper
-from .tools.client import ToolsClient
-from .sources.client import SourcesClient
-from .agents.client import AgentsClient
-from .models.client import ModelsClient
-from .blocks.client import BlocksClient
-from .jobs.client import JobsClient
-from .health.client import HealthClient
-from .providers.client import ProvidersClient
-from .runs.client import RunsClient
-from .core.client_wrapper import AsyncClientWrapper
-from .tools.client import AsyncToolsClient
-from .sources.client import AsyncSourcesClient
-from .agents.client import AsyncAgentsClient
-from .models.client import AsyncModelsClient
-from .blocks.client import AsyncBlocksClient
-from .jobs.client import AsyncJobsClient
-from .health.client import AsyncHealthClient
-from .providers.client import AsyncProvidersClient
-from .runs.client import AsyncRunsClient
-
-
-class Letta:
-    """
-    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
-
-    Parameters
-    ----------
-    base_url : typing.Optional[str]
-        The base url to use for requests from the client.
-
-    environment : LettaEnvironment
-        The environment to use for requests from the client. from .environment import LettaEnvironment
-
-
 
-        Defaults to LettaEnvironment.LETTA_CLOUD
+from .base_client import LettaBase, AsyncLettaBase
+from .core.request_options import RequestOptions
+from .tools.client import ToolsClient as ToolsClientBase
+from .types.letta_schemas_tool_tool import LettaSchemasToolTool
 
 
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
 
-    token : typing.Optional[str]
-    timeout : typing.Optional[float]
-        The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
 
-    follow_redirects : typing.Optional[bool]
-        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
+class Letta(LettaBase):
 
-    httpx_client : typing.Optional[httpx.Client]
-        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
-
-    Examples
-    --------
-    from letta_client import Letta
-
-    client = Letta(
-        token="YOUR_TOKEN",
-    )
-    """
-
-    def __init__(
-        self,
-        *,
-        base_url: typing.Optional[str] = None,
-        environment: LettaEnvironment = LettaEnvironment.LETTA_CLOUD,
-        token: typing.Optional[str] = None,
-        timeout: typing.Optional[float] = None,
-        follow_redirects: typing.Optional[bool] = True,
-        httpx_client: typing.Optional[httpx.Client] = None,
-    ):
-        _defaulted_timeout = timeout if timeout is not None else 60 if httpx_client is None else None
-        self._client_wrapper = SyncClientWrapper(
-            base_url=_get_base_url(base_url=base_url, environment=environment),
-            token=token,
-            httpx_client=httpx_client
-            if httpx_client is not None
-            else httpx.Client(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
-            if follow_redirects is not None
-            else httpx.Client(timeout=_defaulted_timeout),
-            timeout=_defaulted_timeout,
-        )
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
         self.tools = ToolsClient(client_wrapper=self._client_wrapper)
-        self.sources = SourcesClient(client_wrapper=self._client_wrapper)
-        self.agents = AgentsClient(client_wrapper=self._client_wrapper)
-        self.models = ModelsClient(client_wrapper=self._client_wrapper)
-        self.blocks = BlocksClient(client_wrapper=self._client_wrapper)
-        self.jobs = JobsClient(client_wrapper=self._client_wrapper)
-        self.health = HealthClient(client_wrapper=self._client_wrapper)
-        self.providers = ProvidersClient(client_wrapper=self._client_wrapper)
-        self.runs = RunsClient(client_wrapper=self._client_wrapper)
 
 
-class AsyncLetta:
-    """
-    Use this class to access the different functions within the SDK. You can instantiate any number of clients with different configuration that will propagate to these functions.
+class AsyncLetta(AsyncLettaBase):
 
-    Parameters
-    ----------
-    base_url : typing.Optional[str]
-        The base url to use for requests from the client.
-
-    environment : LettaEnvironment
-        The environment to use for requests from the client. from .environment import LettaEnvironment
-
-
-
-        Defaults to LettaEnvironment.LETTA_CLOUD
-
-
-
-    token : typing.Optional[str]
-    timeout : typing.Optional[float]
-        The timeout to be used, in seconds, for requests. By default the timeout is 60 seconds, unless a custom httpx client is used, in which case this default is not enforced.
-
-    follow_redirects : typing.Optional[bool]
-        Whether the default httpx client follows redirects or not, this is irrelevant if a custom httpx client is passed in.
-
-    httpx_client : typing.Optional[httpx.AsyncClient]
-        The httpx client to use for making requests, a preconfigured client is used by default, however this is useful should you want to pass in any custom httpx configuration.
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.tools = ToolsClient(client_wrapper=self._client_wrapper)
 
-    Examples
-    --------
-    from letta_client import AsyncLetta
 
-    client = AsyncLetta(
-        token="YOUR_TOKEN",
-    )
-    """
+class ToolsClient(ToolsClientBase):
 
-    def __init__(
+    def create_from_function(
         self,
         *,
-        base_url: typing.Optional[str] = None,
-        environment: LettaEnvironment = LettaEnvironment.LETTA_CLOUD,
-        token: typing.Optional[str] = None,
-        timeout: typing.Optional[float] = None,
-        follow_redirects: typing.Optional[bool] = True,
-        httpx_client: typing.Optional[httpx.AsyncClient] = None,
-    ):
-        _defaulted_timeout = timeout if timeout is not None else 60 if httpx_client is None else None
-        self._client_wrapper = AsyncClientWrapper(
-            base_url=_get_base_url(base_url=base_url, environment=environment),
-            token=token,
-            httpx_client=httpx_client
-            if httpx_client is not None
-            else httpx.AsyncClient(timeout=_defaulted_timeout, follow_redirects=follow_redirects)
-            if follow_redirects is not None
-            else httpx.AsyncClient(timeout=_defaulted_timeout),
-            timeout=_defaulted_timeout,
+        function: typing.Callable,
+        name: typing.Optional[str] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        tags: typing.Optional[typing.Sequence[str]] = OMIT,
+        source_type: typing.Optional[str] = OMIT,
+        json_schema: typing.Optional[
+            typing.Dict[str, typing.Optional[typing.Any]]
+        ] = OMIT,
+        return_char_limit: typing.Optional[int] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> LettaSchemasToolTool:
+        source_code = dedent(inspect.getsource(function))
+        return self.create(
+            source_code=source_code,
+            name=name,
+            description=description,
+            tags=tags,
+            source_type=source_type,
+            json_schema=json_schema,
+            return_char_limit=return_char_limit,
+            request_options=request_options,
         )
-        self.tools = AsyncToolsClient(client_wrapper=self._client_wrapper)
-        self.sources = AsyncSourcesClient(client_wrapper=self._client_wrapper)
-        self.agents = AsyncAgentsClient(client_wrapper=self._client_wrapper)
-        self.models = AsyncModelsClient(client_wrapper=self._client_wrapper)
-        self.blocks = AsyncBlocksClient(client_wrapper=self._client_wrapper)
-        self.jobs = AsyncJobsClient(client_wrapper=self._client_wrapper)
-        self.health = AsyncHealthClient(client_wrapper=self._client_wrapper)
-        self.providers = AsyncProvidersClient(client_wrapper=self._client_wrapper)
-        self.runs = AsyncRunsClient(client_wrapper=self._client_wrapper)
-
-
-def _get_base_url(*, base_url: typing.Optional[str] = None, environment: LettaEnvironment) -> str:
-    if base_url is not None:
-        return base_url
-    elif environment is not None:
-        return environment.value
-    else:
-        raise Exception("Please pass in either base_url or environment to construct the client")

letta_client/core/client_wrapper.py

@@ -16,7 +16,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "letta-client",
-            "X-Fern-SDK-Version": "0.1.11",
+            "X-Fern-SDK-Version": "0.1.14",
         }
         if self.token is not None:
             headers["Authorization"] = f"Bearer {self.token}"

letta_client/tag/__init__.py

@@ -0,0 +1,2 @@
+# This file was auto-generated by Fern from our API Definition.
+

letta_client/tag/client.py

@@ -0,0 +1,169 @@
+# This file was auto-generated by Fern from our API Definition.
+
+from ..core.client_wrapper import SyncClientWrapper
+import typing
+from ..core.request_options import RequestOptions
+from ..core.unchecked_base_model import construct_type
+from ..errors.unprocessable_entity_error import UnprocessableEntityError
+from ..types.http_validation_error import HttpValidationError
+from json.decoder import JSONDecodeError
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper
+
+
+class TagClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list_tags(
+        self,
+        *,
+        cursor: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        query_text: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[str]:
+        """
+        Get a list of all tags in the database
+
+        Parameters
+        ----------
+        cursor : typing.Optional[str]
+
+        limit : typing.Optional[int]
+
+        query_text : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[str]
+            Successful Response
+
+        Examples
+        --------
+        from letta_client import Letta
+
+        client = Letta(
+            token="YOUR_TOKEN",
+        )
+        client.tag.list_tags()
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/tags/",
+            method="GET",
+            params={
+                "cursor": cursor,
+                "limit": limit,
+                "query_text": query_text,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[str],
+                    construct_type(
+                        type_=typing.List[str],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+
+class AsyncTagClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list_tags(
+        self,
+        *,
+        cursor: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        query_text: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[str]:
+        """
+        Get a list of all tags in the database
+
+        Parameters
+        ----------
+        cursor : typing.Optional[str]
+
+        limit : typing.Optional[int]
+
+        query_text : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[str]
+            Successful Response
+
+        Examples
+        --------
+        import asyncio
+
+        from letta_client import AsyncLetta
+
+        client = AsyncLetta(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.tag.list_tags()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/tags/",
+            method="GET",
+            params={
+                "cursor": cursor,
+                "limit": limit,
+                "query_text": query_text,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    typing.List[str],
+                    construct_type(
+                        type_=typing.List[str],  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 422:
+                raise UnprocessableEntityError(
+                    typing.cast(
+                        HttpValidationError,
+                        construct_type(
+                            type_=HttpValidationError,  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)

{letta_client-0.1.11.dist-info → letta_client-0.1.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: letta-client
-Version: 0.1.11
+Version: 0.1.14
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers

{letta_client-0.1.11.dist-info → letta_client-0.1.14.dist-info}/RECORD

@@ -1,8 +1,8 @@
-letta_client/__init__.py,sha256=T0u1lJaSA6ApQUOFx5wM0Avb3-eKU2EaILq6lbgvxeQ,8506
-letta_client/agents/__init__.py,sha256=sAErDvvZvXcBy-XJxaSDkMyKKUNzA5uGh3tmWIR5ODc,3074
+letta_client/__init__.py,sha256=jdTY31_FAPmI9tE4WRI6ypAL7R5kyLilXmfLtJtVPqA,8684
+letta_client/agents/__init__.py,sha256=D_1CWRp_6mF3CUCE-6Jx8QAZVldpgrC_uK_UTLExVDI,3236
 letta_client/agents/archival_memory/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/archival_memory/client.py,sha256=8A4GM52LAmZK7v2XJzfWR_PK99E_xcXTYhZMPsK7Uvc,18889
-letta_client/agents/client.py,sha256=0-kldkdnp6dulewB5Ae4pbcCL_MiMQBnLtKSgcQTO6A,53706
+letta_client/agents/client.py,sha256=FeXldhkuVr0KDb-hEuQhbq-2BvOMnPC_vit6yIP82nI,53740
 letta_client/agents/context/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/context/client.py,sha256=s9dQA3yJo8KVSinnZz0Mv0GWs0tEqoSH5HgdTTD_klc,4781
 letta_client/agents/core_memory/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
@@ -27,23 +27,25 @@ letta_client/agents/templates/types/__init__.py,sha256=n6TG69a7_CByZmnRbsApvXiH9
 letta_client/agents/templates/types/templates_migrate_response.py,sha256=7N4JtAaiao-LrNdi72K7XB01uXJVkczaKYIJIMf0QYs,577
 letta_client/agents/tools/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/agents/tools/client.py,sha256=c90wAW7q7S8NE_ZZNo55FB5LmtcnPs-mjA1kJ7MRvvA,12852
-letta_client/agents/types/__init__.py,sha256=EU-iiIbYdLqamAEYerwvSBrg4q3gKYxKYAnc2TmYZME,1664
+letta_client/agents/types/__init__.py,sha256=q0Zi5FO9IWVN318qJhEZlUrKzx4kgygfFw9fwmFMujo,1873
 letta_client/agents/types/agents_search_request_combinator.py,sha256=7ZvVX3QILYpXAsKw3l7rQxwwleNekGP73GbNVboCaCA,166
-letta_client/agents/types/agents_search_request_search_item.py,sha256=bjdUuqZQ1b6Q1tjSc092fjlNx2MO2rcDUkP1Uj0Xl-4,2318
+letta_client/agents/types/agents_search_request_search_item.py,sha256=ialUuCAyvTsLFzaUfVWTW9q45Sti4MSzZj_ayxXeTSA,2862
 letta_client/agents/types/agents_search_request_search_item_name.py,sha256=CITFiKq5TtyVKb9CwzRDAACl-HxqOqTOGQLAbcUFXjw,740
 letta_client/agents/types/agents_search_request_search_item_name_operator.py,sha256=Vw5IieCX8pbMGxDvsTzOiaqP9Zws8BpzQcn7QsPNHdI,190
 letta_client/agents/types/agents_search_request_search_item_order_by.py,sha256=2mUspR1ifvuTbeJzbbW7ted0IWGsbGxJGDSZzdQWEOs,899
 letta_client/agents/types/agents_search_request_search_item_order_by_direction.py,sha256=WDYbLnLuJIpM9gMSlwNUtRmckaCGqWXii_N-3uTBeNg,184
 letta_client/agents/types/agents_search_request_search_item_order_by_value.py,sha256=KmJ3WGea7c_yZMVSShZIfTcYrJ2a7qYV0-31nikSMcE,193
+letta_client/agents/types/agents_search_request_search_item_tags.py,sha256=kZOgsK1eUGdHaulx8MxxtB0X6gzidTLbyMQWc5fhOPo,648
 letta_client/agents/types/agents_search_request_search_item_version.py,sha256=hipwPCnixAAq5UfhmcAyIcG9Ut1xGhVnP6lYRG1bBsw,584
 letta_client/agents/types/create_agent_request_tool_rules_item.py,sha256=xSYFbxIAA6k-pZfVsCaTByE8nXRIqyKnfOm_IEjKfEM,415
 letta_client/agents/types/update_agent_tool_rules_item.py,sha256=5pYbFgeqxmXUHUTZpEWlZ7ODc1G6CpFGWljz_iBpWVA,408
+letta_client/base_client.py,sha256=OapnOZBD94aLQa5uoPCbNIR4zDg55DVI5zBe-wWHYfs,7419
 letta_client/blocks/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/blocks/client.py,sha256=-4_DMOmUdzPxCqmOYJv3O9Yrf3ZG-gpzyciTe9qbI7k,32517
-letta_client/client.py,sha256=WSYCCgvSON4veHp6xSz_4ex5bpKzL5ifp7g0ft1ZDmU,7201
+letta_client/client.py,sha256=Hi4LXwglMFc-IKUbhM4a7-Bew0Xzf2q5EtO5ziq-yro,1729
 letta_client/core/__init__.py,sha256=OKbX2aCZXgHCDUsCouqv-OiX32xA6eFFCKIUH9M5Vzk,1591
 letta_client/core/api_error.py,sha256=RE8LELok2QCjABadECTvtDp7qejA1VmINCh6TbqPwSE,426
-letta_client/core/client_wrapper.py,sha256=oDaC73_QhHPe4fNOX1KBJJhHF3La9ZkebwasEgPHwDw,1997
+letta_client/core/client_wrapper.py,sha256=UXzK6xyTKG5xsAxhh0GmagqOfdrYVdH3KfrgC00KCwQ,1997
 letta_client/core/datetime_utils.py,sha256=nBys2IsYrhPdszxGKCNRPSOCwa-5DWOHG95FB8G9PKo,1047
 letta_client/core/file.py,sha256=d4NNbX8XvXP32z8KpK2Xovv33nFfruIrpz0QWxlgpZk,2663
 letta_client/core/http_client.py,sha256=siUQ6UV0ARZALlxubqWSSAAPC9B4VW8y6MGlHStfaeo,19552
@@ -77,6 +79,8 @@ letta_client/sources/files/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roe
 letta_client/sources/files/client.py,sha256=K7YdVxWOu4lkv5-cuMZMkTcl9Fr92Q5U2liXYFUqZ4I,13297
 letta_client/sources/passages/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/sources/passages/client.py,sha256=n0QVtLC0W1X6_SjhiEGSl9oZexocnsLZYeYRAqV2BCk,4767
+letta_client/tag/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
+letta_client/tag/client.py,sha256=zAy0hjEOVNZV3QAd9iiVuapAXQNCi0wKvZ_wvqj0TmI,5191
 letta_client/tools/__init__.py,sha256=FTtvy8EDg9nNNg9WCatVgKTRYV8-_v1roeGPAKoa_pw,65
 letta_client/tools/client.py,sha256=dh8uX3tNFbKjgvd2TUwP0KTj4THksnFxnZmEit7tOY4,58734
 letta_client/types/__init__.py,sha256=0swb0p3HYf3pucfNX4_oJ51oIXXwxhkTIbtkQdW40cI,10356
@@ -199,6 +203,6 @@ letta_client/types/user_update.py,sha256=0Bl1OjO7bfmlpsGQ36dSh6DH1UB_wJOTNewS0wD
 letta_client/types/validation_error.py,sha256=ACDS7wL5nQbS8ymFhWljwbBJmbugNa8bs2O5xEZC3u4,680
 letta_client/types/validation_error_loc_item.py,sha256=LAtjCHIllWRBFXvAZ5QZpp7CPXjdtN9EB7HrLVo6EP0,128
 letta_client/version.py,sha256=bttKLbIhO3UonCYQlqs600zzbQgfhCCMjeXR9WRzid4,79
-letta_client-0.1.11.dist-info/METADATA,sha256=mKN0tKMPvNMS8hXGVLmiD2CV3g9rU42nhCNH4nKT_7Y,4929
-letta_client-0.1.11.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
-letta_client-0.1.11.dist-info/RECORD,,
+letta_client-0.1.14.dist-info/METADATA,sha256=nN2i4nSVBxEhnje9_WKKlH8rXCzlgSFmrjSmEbg62nE,4929
+letta_client-0.1.14.dist-info/WHEEL,sha256=Zb28QaM1gQi8f4VCBhsUklF61CTlNYfs9YAZn-TOGFk,88
+letta_client-0.1.14.dist-info/RECORD,,