letta-client 1.0.0a9__py3-none-any.whl → 1.0.0a11__py3-none-any.whl

letta_client/resources/agents/agents.py

@@ -44,7 +44,7 @@ from ...types import (
     AgentType,
     agent_list_params,
     agent_create_params,
-    agent_update_params,
+    agent_modify_params,
     agent_retrieve_params,
     agent_export_file_params,
     agent_import_file_params,
@@ -441,185 +441,6 @@ class AgentsResource(SyncAPIResource):
             cast_to=AgentState,
         )
 
-    def update(
-        self,
-        agent_id: str,
-        *,
-        base_template_id: Optional[str] | Omit = omit,
-        block_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        context_window_limit: Optional[int] | Omit = omit,
-        description: Optional[str] | Omit = omit,
-        embedding: Optional[str] | Omit = omit,
-        embedding_config: Optional[EmbeddingConfigParam] | Omit = omit,
-        enable_sleeptime: Optional[bool] | Omit = omit,
-        hidden: Optional[bool] | Omit = omit,
-        identity_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        last_run_completion: Union[str, datetime, None] | Omit = omit,
-        last_run_duration_ms: Optional[int] | Omit = omit,
-        llm_config: Optional[LlmConfigParam] | Omit = omit,
-        max_files_open: Optional[int] | Omit = omit,
-        max_tokens: Optional[int] | Omit = omit,
-        message_buffer_autoclear: Optional[bool] | Omit = omit,
-        message_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        metadata: Optional[Dict[str, object]] | Omit = omit,
-        model: Optional[str] | Omit = omit,
-        name: Optional[str] | Omit = omit,
-        parallel_tool_calls: Optional[bool] | Omit = omit,
-        per_file_view_window_char_limit: Optional[int] | Omit = omit,
-        project_id: Optional[str] | Omit = omit,
-        reasoning: Optional[bool] | Omit = omit,
-        response_format: Optional[agent_update_params.ResponseFormat] | Omit = omit,
-        secrets: Optional[Dict[str, str]] | Omit = omit,
-        source_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        system: Optional[str] | Omit = omit,
-        tags: Optional[SequenceNotStr[str]] | Omit = omit,
-        template_id: Optional[str] | Omit = omit,
-        timezone: Optional[str] | Omit = omit,
-        tool_exec_environment_variables: Optional[Dict[str, str]] | Omit = omit,
-        tool_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        tool_rules: Optional[Iterable[agent_update_params.ToolRule]] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentState:
-        """
-        Update an existing agent.
-
-        Args:
-          agent_id: The ID of the agent in the format 'agent-<uuid4>'
-
-          base_template_id: The base template id of the agent.
-
-          block_ids: The ids of the blocks used by the agent.
-
-          context_window_limit: The context window limit used by the agent.
-
-          description: The description of the agent.
-
-          embedding: The embedding configuration handle used by the agent, specified in the format
-              provider/model-name.
-
-          embedding_config: Configuration for embedding model connection and processing parameters.
-
-          enable_sleeptime: If set to True, memory management will move to a background agent thread.
-
-          hidden: If set to True, the agent will be hidden.
-
-          identity_ids: The ids of the identities associated with this agent.
-
-          last_run_completion: The timestamp when the agent last completed a run.
-
-          last_run_duration_ms: The duration in milliseconds of the agent's last run.
-
-          llm_config: Configuration for Language Model (LLM) connection and generation parameters.
-
-          max_files_open: Maximum number of files that can be open at once for this agent. Setting this
-              too high may exceed the context window, which will break the agent.
-
-          max_tokens: The maximum number of tokens to generate, including reasoning step. If not set,
-              the model will use its default value.
-
-          message_buffer_autoclear: If set to True, the agent will not remember previous messages (though the agent
-              will still retain state via core memory blocks and archival/recall memory). Not
-              recommended unless you have an advanced use case.
-
-          message_ids: The ids of the messages in the agent's in-context memory.
-
-          metadata: The metadata of the agent.
-
-          model: The LLM configuration handle used by the agent, specified in the format
-              provider/model-name, as an alternative to specifying llm_config.
-
-          name: The name of the agent.
-
-          parallel_tool_calls: If set to True, enables parallel tool calling. Defaults to False.
-
-          per_file_view_window_char_limit: The per-file view window character limit for this agent. Setting this too high
-              may exceed the context window, which will break the agent.
-
-          project_id: The id of the project the agent belongs to.
-
-          reasoning: Whether to enable reasoning for this agent.
-
-          response_format: The response format for the agent.
-
-          secrets: The environment variables for tool execution specific to this agent.
-
-          source_ids: The ids of the sources used by the agent.
-
-          system: The system prompt used by the agent.
-
-          tags: The tags associated with the agent.
-
-          template_id: The id of the template the agent belongs to.
-
-          timezone: The timezone of the agent (IANA format).
-
-          tool_exec_environment_variables: Deprecated: use `secrets` field instead
-
-          tool_ids: The ids of the tools used by the agent.
-
-          tool_rules: The tool rules governing the agent.
-
-          extra_headers: Send extra headers
-
-          extra_query: Add additional query parameters to the request
-
-          extra_body: Add additional JSON properties to the request
-
-          timeout: Override the client-level default timeout for this request, in seconds
-        """
-        if not agent_id:
-            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return self._patch(
-            f"/v1/agents/{agent_id}",
-            body=maybe_transform(
-                {
-                    "base_template_id": base_template_id,
-                    "block_ids": block_ids,
-                    "context_window_limit": context_window_limit,
-                    "description": description,
-                    "embedding": embedding,
-                    "embedding_config": embedding_config,
-                    "enable_sleeptime": enable_sleeptime,
-                    "hidden": hidden,
-                    "identity_ids": identity_ids,
-                    "last_run_completion": last_run_completion,
-                    "last_run_duration_ms": last_run_duration_ms,
-                    "llm_config": llm_config,
-                    "max_files_open": max_files_open,
-                    "max_tokens": max_tokens,
-                    "message_buffer_autoclear": message_buffer_autoclear,
-                    "message_ids": message_ids,
-                    "metadata": metadata,
-                    "model": model,
-                    "name": name,
-                    "parallel_tool_calls": parallel_tool_calls,
-                    "per_file_view_window_char_limit": per_file_view_window_char_limit,
-                    "project_id": project_id,
-                    "reasoning": reasoning,
-                    "response_format": response_format,
-                    "secrets": secrets,
-                    "source_ids": source_ids,
-                    "system": system,
-                    "tags": tags,
-                    "template_id": template_id,
-                    "timezone": timezone,
-                    "tool_exec_environment_variables": tool_exec_environment_variables,
-                    "tool_ids": tool_ids,
-                    "tool_rules": tool_rules,
-                },
-                agent_update_params.AgentUpdateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=AgentState,
-        )
-
     def list(
         self,
         *,
@@ -933,100 +754,43 @@ class AgentsResource(SyncAPIResource):
             cast_to=AgentImportFileResponse,
         )
 
-
-class AsyncAgentsResource(AsyncAPIResource):
-    @cached_property
-    def tools(self) -> AsyncToolsResource:
-        return AsyncToolsResource(self._client)
-
-    @cached_property
-    def folders(self) -> AsyncFoldersResource:
-        return AsyncFoldersResource(self._client)
-
-    @cached_property
-    def files(self) -> AsyncFilesResource:
-        return AsyncFilesResource(self._client)
-
-    @cached_property
-    def blocks(self) -> AsyncBlocksResource:
-        return AsyncBlocksResource(self._client)
-
-    @cached_property
-    def groups(self) -> AsyncGroupsResource:
-        return AsyncGroupsResource(self._client)
-
-    @cached_property
-    def messages(self) -> AsyncMessagesResource:
-        return AsyncMessagesResource(self._client)
-
-    @cached_property
-    def with_raw_response(self) -> AsyncAgentsResourceWithRawResponse:
-        """
-        This property can be used as a prefix for any HTTP method call to return
-        the raw response object instead of the parsed content.
-
-        For more information, see https://www.github.com/letta-ai/letta-python#accessing-raw-response-data-eg-headers
-        """
-        return AsyncAgentsResourceWithRawResponse(self)
-
-    @cached_property
-    def with_streaming_response(self) -> AsyncAgentsResourceWithStreamingResponse:
-        """
-        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
-
-        For more information, see https://www.github.com/letta-ai/letta-python#with_streaming_response
-        """
-        return AsyncAgentsResourceWithStreamingResponse(self)
-
-    async def create(
+    def modify(
         self,
+        agent_id: str,
         *,
-        agent_type: AgentType | Omit = omit,
         base_template_id: Optional[str] | Omit = omit,
         block_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         context_window_limit: Optional[int] | Omit = omit,
         description: Optional[str] | Omit = omit,
         embedding: Optional[str] | Omit = omit,
-        embedding_chunk_size: Optional[int] | Omit = omit,
         embedding_config: Optional[EmbeddingConfigParam] | Omit = omit,
-        enable_reasoner: Optional[bool] | Omit = omit,
         enable_sleeptime: Optional[bool] | Omit = omit,
-        from_template: Optional[str] | Omit = omit,
         hidden: Optional[bool] | Omit = omit,
         identity_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        include_base_tool_rules: Optional[bool] | Omit = omit,
-        include_base_tools: bool | Omit = omit,
-        include_default_source: bool | Omit = omit,
-        include_multi_agent_tools: bool | Omit = omit,
-        initial_message_sequence: Optional[Iterable[MessageCreateParam]] | Omit = omit,
+        last_run_completion: Union[str, datetime, None] | Omit = omit,
+        last_run_duration_ms: Optional[int] | Omit = omit,
         llm_config: Optional[LlmConfigParam] | Omit = omit,
         max_files_open: Optional[int] | Omit = omit,
-        max_reasoning_tokens: Optional[int] | Omit = omit,
         max_tokens: Optional[int] | Omit = omit,
-        memory_blocks: Optional[Iterable[CreateBlockParam]] | Omit = omit,
-        memory_variables: Optional[Dict[str, str]] | Omit = omit,
-        message_buffer_autoclear: bool | Omit = omit,
+        message_buffer_autoclear: Optional[bool] | Omit = omit,
+        message_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         metadata: Optional[Dict[str, object]] | Omit = omit,
         model: Optional[str] | Omit = omit,
-        name: str | Omit = omit,
+        name: Optional[str] | Omit = omit,
         parallel_tool_calls: Optional[bool] | Omit = omit,
         per_file_view_window_char_limit: Optional[int] | Omit = omit,
-        project: Optional[str] | Omit = omit,
         project_id: Optional[str] | Omit = omit,
         reasoning: Optional[bool] | Omit = omit,
-        response_format: Optional[agent_create_params.ResponseFormat] | Omit = omit,
+        response_format: Optional[agent_modify_params.ResponseFormat] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         source_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         system: Optional[str] | Omit = omit,
         tags: Optional[SequenceNotStr[str]] | Omit = omit,
-        template: bool | Omit = omit,
         template_id: Optional[str] | Omit = omit,
         timezone: Optional[str] | Omit = omit,
         tool_exec_environment_variables: Optional[Dict[str, str]] | Omit = omit,
         tool_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        tool_rules: Optional[Iterable[agent_create_params.ToolRule]] | Omit = omit,
-        tools: Optional[SequenceNotStr[str]] | Omit = omit,
-        x_project: str | Omit = omit,
+        tool_rules: Optional[Iterable[agent_modify_params.ToolRule]] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -1035,10 +799,10 @@ class AsyncAgentsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AgentState:
         """
-        Create an agent.
+        Update an existing agent.
 
         Args:
-          agent_type: The type of agent.
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
 
           base_template_id: The base template id of the agent.
 
@@ -1051,52 +815,32 @@ class AsyncAgentsResource(AsyncAPIResource):
           embedding: The embedding configuration handle used by the agent, specified in the format
               provider/model-name.
 
-          embedding_chunk_size: The embedding chunk size used by the agent.
-
           embedding_config: Configuration for embedding model connection and processing parameters.
 
-          enable_reasoner: Whether to enable internal extended thinking step for a reasoner model.
-
           enable_sleeptime: If set to True, memory management will move to a background agent thread.
 
-          from_template: Deprecated: please use the 'create agents from a template' endpoint instead.
-
           hidden: If set to True, the agent will be hidden.
 
           identity_ids: The ids of the identities associated with this agent.
 
-          include_base_tool_rules: If true, attaches the Letta base tool rules (e.g. deny all tools not explicitly
-              allowed).
-
-          include_base_tools: If true, attaches the Letta core tools (e.g. core_memory related functions).
-
-          include_default_source: If true, automatically creates and attaches a default data source for this
-              agent.
-
-          include_multi_agent_tools: If true, attaches the Letta multi-agent tools (e.g. sending a message to another
-              agent).
+          last_run_completion: The timestamp when the agent last completed a run.
 
-          initial_message_sequence: The initial set of messages to put in the agent's in-context memory.
+          last_run_duration_ms: The duration in milliseconds of the agent's last run.
 
           llm_config: Configuration for Language Model (LLM) connection and generation parameters.
 
           max_files_open: Maximum number of files that can be open at once for this agent. Setting this
               too high may exceed the context window, which will break the agent.
 
-          max_reasoning_tokens: The maximum number of tokens to generate for reasoning step. If not set, the
-              model will use its default value.
-
           max_tokens: The maximum number of tokens to generate, including reasoning step. If not set,
               the model will use its default value.
 
-          memory_blocks: The blocks to create in the agent's in-context memory.
-
-          memory_variables: The variables that should be set for the agent.
-
           message_buffer_autoclear: If set to True, the agent will not remember previous messages (though the agent
               will still retain state via core memory blocks and archival/recall memory). Not
               recommended unless you have an advanced use case.
 
+          message_ids: The ids of the messages in the agent's in-context memory.
+
           metadata: The metadata of the agent.
 
           model: The LLM configuration handle used by the agent, specified in the format
@@ -1109,10 +853,6 @@ class AsyncAgentsResource(AsyncAPIResource):
           per_file_view_window_char_limit: The per-file view window character limit for this agent. Setting this too high
               may exceed the context window, which will break the agent.
 
-          project: Deprecated: Project should now be passed via the X-Project header instead of in
-              the request body. If using the sdk, this can be done via the new x_project field
-              below.
-
           project_id: The id of the project the agent belongs to.
 
           reasoning: Whether to enable reasoning for this agent.
@@ -1127,22 +867,16 @@ class AsyncAgentsResource(AsyncAPIResource):
 
           tags: The tags associated with the agent.
 
-          template: Deprecated: No longer used
-
           template_id: The id of the template the agent belongs to.
 
           timezone: The timezone of the agent (IANA format).
 
-          tool_exec_environment_variables: Deprecated: use `secrets` field instead.
+          tool_exec_environment_variables: Deprecated: use `secrets` field instead
 
           tool_ids: The ids of the tools used by the agent.
 
           tool_rules: The tool rules governing the agent.
 
-          tools: The tools used by the agent.
-
-          x_project: The project slug to associate with the agent (cloud only).
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1151,42 +885,33 @@ class AsyncAgentsResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        extra_headers = {**strip_not_given({"X-Project": x_project}), **(extra_headers or {})}
-        return await self._post(
-            "/v1/agents/",
-            body=await async_maybe_transform(
+        if not agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        return self._patch(
+            f"/v1/agents/{agent_id}",
+            body=maybe_transform(
                 {
-                    "agent_type": agent_type,
                     "base_template_id": base_template_id,
                     "block_ids": block_ids,
                     "context_window_limit": context_window_limit,
                     "description": description,
                     "embedding": embedding,
-                    "embedding_chunk_size": embedding_chunk_size,
                     "embedding_config": embedding_config,
-                    "enable_reasoner": enable_reasoner,
                     "enable_sleeptime": enable_sleeptime,
-                    "from_template": from_template,
                     "hidden": hidden,
                     "identity_ids": identity_ids,
-                    "include_base_tool_rules": include_base_tool_rules,
-                    "include_base_tools": include_base_tools,
-                    "include_default_source": include_default_source,
-                    "include_multi_agent_tools": include_multi_agent_tools,
-                    "initial_message_sequence": initial_message_sequence,
+                    "last_run_completion": last_run_completion,
+                    "last_run_duration_ms": last_run_duration_ms,
                     "llm_config": llm_config,
                     "max_files_open": max_files_open,
-                    "max_reasoning_tokens": max_reasoning_tokens,
                     "max_tokens": max_tokens,
-                    "memory_blocks": memory_blocks,
-                    "memory_variables": memory_variables,
                     "message_buffer_autoclear": message_buffer_autoclear,
+                    "message_ids": message_ids,
                     "metadata": metadata,
                     "model": model,
                     "name": name,
                     "parallel_tool_calls": parallel_tool_calls,
                     "per_file_view_window_char_limit": per_file_view_window_char_limit,
-                    "project": project,
                     "project_id": project_id,
                     "reasoning": reasoning,
                     "response_format": response_format,
@@ -1194,15 +919,13 @@ class AsyncAgentsResource(AsyncAPIResource):
                     "source_ids": source_ids,
                     "system": system,
                     "tags": tags,
-                    "template": template,
                     "template_id": template_id,
                     "timezone": timezone,
                     "tool_exec_environment_variables": tool_exec_environment_variables,
                     "tool_ids": tool_ids,
                     "tool_rules": tool_rules,
-                    "tools": tools,
                 },
-                agent_create_params.AgentCreateParams,
+                agent_modify_params.AgentModifyParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -1210,109 +933,100 @@ class AsyncAgentsResource(AsyncAPIResource):
             cast_to=AgentState,
         )
 
-    async def retrieve(
-        self,
-        agent_id: str,
-        *,
-        include: List[
-            Literal[
-                "agent.blocks",
-                "agent.identities",
-                "agent.managed_group",
-                "agent.secrets",
-                "agent.sources",
-                "agent.tags",
-                "agent.tools",
-            ]
-        ]
-        | Omit = omit,
-        include_relationships: Optional[SequenceNotStr[str]] | Omit = omit,
-        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
-        # The extra values given here take precedence over values defined on the client or passed to this method.
-        extra_headers: Headers | None = None,
-        extra_query: Query | None = None,
-        extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AgentState:
-        """
-        Get the state of the agent.
 
-        Args:
-          agent_id: The ID of the agent in the format 'agent-<uuid4>'
+class AsyncAgentsResource(AsyncAPIResource):
+    @cached_property
+    def tools(self) -> AsyncToolsResource:
+        return AsyncToolsResource(self._client)
 
-          include: Specify which relational fields to include in the response. No relationships are
-              included by default.
+    @cached_property
+    def folders(self) -> AsyncFoldersResource:
+        return AsyncFoldersResource(self._client)
 
-          include_relationships: Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
-              in the response. If not provided, all relationships are loaded by default. Using
-              this can optimize performance by reducing unnecessary joins.This is a legacy
-              parameter, and no longer supported after 1.0.0 SDK versions.
+    @cached_property
+    def files(self) -> AsyncFilesResource:
+        return AsyncFilesResource(self._client)
 
-          extra_headers: Send extra headers
+    @cached_property
+    def blocks(self) -> AsyncBlocksResource:
+        return AsyncBlocksResource(self._client)
 
-          extra_query: Add additional query parameters to the request
+    @cached_property
+    def groups(self) -> AsyncGroupsResource:
+        return AsyncGroupsResource(self._client)
 
-          extra_body: Add additional JSON properties to the request
+    @cached_property
+    def messages(self) -> AsyncMessagesResource:
+        return AsyncMessagesResource(self._client)
 
-          timeout: Override the client-level default timeout for this request, in seconds
+    @cached_property
+    def with_raw_response(self) -> AsyncAgentsResourceWithRawResponse:
         """
-        if not agent_id:
-            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return await self._get(
-            f"/v1/agents/{agent_id}",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {
-                        "include": include,
-                        "include_relationships": include_relationships,
-                    },
-                    agent_retrieve_params.AgentRetrieveParams,
-                ),
-            ),
-            cast_to=AgentState,
-        )
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/letta-ai/letta-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncAgentsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncAgentsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-    async def update(
+        For more information, see https://www.github.com/letta-ai/letta-python#with_streaming_response
+        """
+        return AsyncAgentsResourceWithStreamingResponse(self)
+
+    async def create(
         self,
-        agent_id: str,
         *,
+        agent_type: AgentType | Omit = omit,
         base_template_id: Optional[str] | Omit = omit,
         block_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         context_window_limit: Optional[int] | Omit = omit,
         description: Optional[str] | Omit = omit,
         embedding: Optional[str] | Omit = omit,
+        embedding_chunk_size: Optional[int] | Omit = omit,
         embedding_config: Optional[EmbeddingConfigParam] | Omit = omit,
+        enable_reasoner: Optional[bool] | Omit = omit,
         enable_sleeptime: Optional[bool] | Omit = omit,
+        from_template: Optional[str] | Omit = omit,
         hidden: Optional[bool] | Omit = omit,
         identity_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        last_run_completion: Union[str, datetime, None] | Omit = omit,
-        last_run_duration_ms: Optional[int] | Omit = omit,
+        include_base_tool_rules: Optional[bool] | Omit = omit,
+        include_base_tools: bool | Omit = omit,
+        include_default_source: bool | Omit = omit,
+        include_multi_agent_tools: bool | Omit = omit,
+        initial_message_sequence: Optional[Iterable[MessageCreateParam]] | Omit = omit,
         llm_config: Optional[LlmConfigParam] | Omit = omit,
         max_files_open: Optional[int] | Omit = omit,
+        max_reasoning_tokens: Optional[int] | Omit = omit,
         max_tokens: Optional[int] | Omit = omit,
-        message_buffer_autoclear: Optional[bool] | Omit = omit,
-        message_ids: Optional[SequenceNotStr[str]] | Omit = omit,
+        memory_blocks: Optional[Iterable[CreateBlockParam]] | Omit = omit,
+        memory_variables: Optional[Dict[str, str]] | Omit = omit,
+        message_buffer_autoclear: bool | Omit = omit,
         metadata: Optional[Dict[str, object]] | Omit = omit,
         model: Optional[str] | Omit = omit,
-        name: Optional[str] | Omit = omit,
+        name: str | Omit = omit,
         parallel_tool_calls: Optional[bool] | Omit = omit,
         per_file_view_window_char_limit: Optional[int] | Omit = omit,
+        project: Optional[str] | Omit = omit,
         project_id: Optional[str] | Omit = omit,
         reasoning: Optional[bool] | Omit = omit,
-        response_format: Optional[agent_update_params.ResponseFormat] | Omit = omit,
+        response_format: Optional[agent_create_params.ResponseFormat] | Omit = omit,
         secrets: Optional[Dict[str, str]] | Omit = omit,
         source_ids: Optional[SequenceNotStr[str]] | Omit = omit,
         system: Optional[str] | Omit = omit,
         tags: Optional[SequenceNotStr[str]] | Omit = omit,
+        template: bool | Omit = omit,
         template_id: Optional[str] | Omit = omit,
         timezone: Optional[str] | Omit = omit,
         tool_exec_environment_variables: Optional[Dict[str, str]] | Omit = omit,
         tool_ids: Optional[SequenceNotStr[str]] | Omit = omit,
-        tool_rules: Optional[Iterable[agent_update_params.ToolRule]] | Omit = omit,
+        tool_rules: Optional[Iterable[agent_create_params.ToolRule]] | Omit = omit,
+        tools: Optional[SequenceNotStr[str]] | Omit = omit,
+        x_project: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -1321,10 +1035,10 @@ class AsyncAgentsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AgentState:
         """
-        Update an existing agent.
+        Create an agent.
 
         Args:
-          agent_id: The ID of the agent in the format 'agent-<uuid4>'
+          agent_type: The type of agent.
 
           base_template_id: The base template id of the agent.
 
@@ -1337,32 +1051,52 @@ class AsyncAgentsResource(AsyncAPIResource):
           embedding: The embedding configuration handle used by the agent, specified in the format
               provider/model-name.
 
+          embedding_chunk_size: The embedding chunk size used by the agent.
+
           embedding_config: Configuration for embedding model connection and processing parameters.
 
+          enable_reasoner: Whether to enable internal extended thinking step for a reasoner model.
+
           enable_sleeptime: If set to True, memory management will move to a background agent thread.
 
+          from_template: Deprecated: please use the 'create agents from a template' endpoint instead.
+
           hidden: If set to True, the agent will be hidden.
 
           identity_ids: The ids of the identities associated with this agent.
 
-          last_run_completion: The timestamp when the agent last completed a run.
+          include_base_tool_rules: If true, attaches the Letta base tool rules (e.g. deny all tools not explicitly
+              allowed).
 
-          last_run_duration_ms: The duration in milliseconds of the agent's last run.
+          include_base_tools: If true, attaches the Letta core tools (e.g. core_memory related functions).
+
+          include_default_source: If true, automatically creates and attaches a default data source for this
+              agent.
+
+          include_multi_agent_tools: If true, attaches the Letta multi-agent tools (e.g. sending a message to another
+              agent).
+
+          initial_message_sequence: The initial set of messages to put in the agent's in-context memory.
 
           llm_config: Configuration for Language Model (LLM) connection and generation parameters.
 
           max_files_open: Maximum number of files that can be open at once for this agent. Setting this
               too high may exceed the context window, which will break the agent.
 
+          max_reasoning_tokens: The maximum number of tokens to generate for reasoning step. If not set, the
+              model will use its default value.
+
           max_tokens: The maximum number of tokens to generate, including reasoning step. If not set,
               the model will use its default value.
 
+          memory_blocks: The blocks to create in the agent's in-context memory.
+
+          memory_variables: The variables that should be set for the agent.
+
           message_buffer_autoclear: If set to True, the agent will not remember previous messages (though the agent
               will still retain state via core memory blocks and archival/recall memory). Not
               recommended unless you have an advanced use case.
 
-          message_ids: The ids of the messages in the agent's in-context memory.
-
           metadata: The metadata of the agent.
 
           model: The LLM configuration handle used by the agent, specified in the format
@@ -1375,6 +1109,10 @@ class AsyncAgentsResource(AsyncAPIResource):
           per_file_view_window_char_limit: The per-file view window character limit for this agent. Setting this too high
               may exceed the context window, which will break the agent.
 
+          project: Deprecated: Project should now be passed via the X-Project header instead of in
+              the request body. If using the sdk, this can be done via the new x_project field
+              below.
+
           project_id: The id of the project the agent belongs to.
 
           reasoning: Whether to enable reasoning for this agent.
@@ -1389,16 +1127,22 @@ class AsyncAgentsResource(AsyncAPIResource):
 
           tags: The tags associated with the agent.
 
+          template: Deprecated: No longer used
+
           template_id: The id of the template the agent belongs to.
 
           timezone: The timezone of the agent (IANA format).
 
-          tool_exec_environment_variables: Deprecated: use `secrets` field instead
+          tool_exec_environment_variables: Deprecated: use `secrets` field instead.
 
           tool_ids: The ids of the tools used by the agent.
 
           tool_rules: The tool rules governing the agent.
 
+          tools: The tools used by the agent.
+
+          x_project: The project slug to associate with the agent (cloud only).
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1407,33 +1151,42 @@ class AsyncAgentsResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not agent_id:
-            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
-        return await self._patch(
-            f"/v1/agents/{agent_id}",
+        extra_headers = {**strip_not_given({"X-Project": x_project}), **(extra_headers or {})}
+        return await self._post(
+            "/v1/agents/",
             body=await async_maybe_transform(
                 {
+                    "agent_type": agent_type,
                     "base_template_id": base_template_id,
                     "block_ids": block_ids,
                     "context_window_limit": context_window_limit,
                     "description": description,
                     "embedding": embedding,
+                    "embedding_chunk_size": embedding_chunk_size,
                     "embedding_config": embedding_config,
+                    "enable_reasoner": enable_reasoner,
                     "enable_sleeptime": enable_sleeptime,
+                    "from_template": from_template,
                     "hidden": hidden,
                     "identity_ids": identity_ids,
-                    "last_run_completion": last_run_completion,
-                    "last_run_duration_ms": last_run_duration_ms,
+                    "include_base_tool_rules": include_base_tool_rules,
+                    "include_base_tools": include_base_tools,
+                    "include_default_source": include_default_source,
+                    "include_multi_agent_tools": include_multi_agent_tools,
+                    "initial_message_sequence": initial_message_sequence,
                     "llm_config": llm_config,
                     "max_files_open": max_files_open,
+                    "max_reasoning_tokens": max_reasoning_tokens,
                     "max_tokens": max_tokens,
+                    "memory_blocks": memory_blocks,
+                    "memory_variables": memory_variables,
                     "message_buffer_autoclear": message_buffer_autoclear,
-                    "message_ids": message_ids,
                     "metadata": metadata,
                     "model": model,
                     "name": name,
                     "parallel_tool_calls": parallel_tool_calls,
                     "per_file_view_window_char_limit": per_file_view_window_char_limit,
+                    "project": project,
                     "project_id": project_id,
                     "reasoning": reasoning,
                     "response_format": response_format,
@@ -1441,13 +1194,15 @@ class AsyncAgentsResource(AsyncAPIResource):
                     "source_ids": source_ids,
                     "system": system,
                     "tags": tags,
+                    "template": template,
                     "template_id": template_id,
                     "timezone": timezone,
                     "tool_exec_environment_variables": tool_exec_environment_variables,
                     "tool_ids": tool_ids,
                     "tool_rules": tool_rules,
+                    "tools": tools,
                 },
-                agent_update_params.AgentUpdateParams,
+                agent_create_params.AgentCreateParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
@@ -1455,6 +1210,72 @@ class AsyncAgentsResource(AsyncAPIResource):
             cast_to=AgentState,
         )
 
+    async def retrieve(
+        self,
+        agent_id: str,
+        *,
+        include: List[
+            Literal[
+                "agent.blocks",
+                "agent.identities",
+                "agent.managed_group",
+                "agent.secrets",
+                "agent.sources",
+                "agent.tags",
+                "agent.tools",
+            ]
+        ]
+        | Omit = omit,
+        include_relationships: Optional[SequenceNotStr[str]] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AgentState:
+        """
+        Get the state of the agent.
+
+        Args:
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
+
+          include: Specify which relational fields to include in the response. No relationships are
+              included by default.
+
+          include_relationships: Specify which relational fields (e.g., 'tools', 'sources', 'memory') to include
+              in the response. If not provided, all relationships are loaded by default. Using
+              this can optimize performance by reducing unnecessary joins.This is a legacy
+              parameter, and no longer supported after 1.0.0 SDK versions.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        return await self._get(
+            f"/v1/agents/{agent_id}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "include": include,
+                        "include_relationships": include_relationships,
+                    },
+                    agent_retrieve_params.AgentRetrieveParams,
+                ),
+            ),
+            cast_to=AgentState,
+        )
+
     def list(
         self,
         *,
@@ -1768,6 +1589,185 @@ class AsyncAgentsResource(AsyncAPIResource):
             cast_to=AgentImportFileResponse,
         )
 
+    async def modify(
+        self,
+        agent_id: str,
+        *,
+        base_template_id: Optional[str] | Omit = omit,
+        block_ids: Optional[SequenceNotStr[str]] | Omit = omit,
+        context_window_limit: Optional[int] | Omit = omit,
+        description: Optional[str] | Omit = omit,
+        embedding: Optional[str] | Omit = omit,
+        embedding_config: Optional[EmbeddingConfigParam] | Omit = omit,
+        enable_sleeptime: Optional[bool] | Omit = omit,
+        hidden: Optional[bool] | Omit = omit,
+        identity_ids: Optional[SequenceNotStr[str]] | Omit = omit,
+        last_run_completion: Union[str, datetime, None] | Omit = omit,
+        last_run_duration_ms: Optional[int] | Omit = omit,
+        llm_config: Optional[LlmConfigParam] | Omit = omit,
+        max_files_open: Optional[int] | Omit = omit,
+        max_tokens: Optional[int] | Omit = omit,
+        message_buffer_autoclear: Optional[bool] | Omit = omit,
+        message_ids: Optional[SequenceNotStr[str]] | Omit = omit,
+        metadata: Optional[Dict[str, object]] | Omit = omit,
+        model: Optional[str] | Omit = omit,
+        name: Optional[str] | Omit = omit,
+        parallel_tool_calls: Optional[bool] | Omit = omit,
+        per_file_view_window_char_limit: Optional[int] | Omit = omit,
+        project_id: Optional[str] | Omit = omit,
+        reasoning: Optional[bool] | Omit = omit,
+        response_format: Optional[agent_modify_params.ResponseFormat] | Omit = omit,
+        secrets: Optional[Dict[str, str]] | Omit = omit,
+        source_ids: Optional[SequenceNotStr[str]] | Omit = omit,
+        system: Optional[str] | Omit = omit,
+        tags: Optional[SequenceNotStr[str]] | Omit = omit,
+        template_id: Optional[str] | Omit = omit,
+        timezone: Optional[str] | Omit = omit,
+        tool_exec_environment_variables: Optional[Dict[str, str]] | Omit = omit,
+        tool_ids: Optional[SequenceNotStr[str]] | Omit = omit,
+        tool_rules: Optional[Iterable[agent_modify_params.ToolRule]] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AgentState:
+        """
+        Update an existing agent.
+
+        Args:
+          agent_id: The ID of the agent in the format 'agent-<uuid4>'
+
+          base_template_id: The base template id of the agent.
+
+          block_ids: The ids of the blocks used by the agent.
+
+          context_window_limit: The context window limit used by the agent.
+
+          description: The description of the agent.
+
+          embedding: The embedding configuration handle used by the agent, specified in the format
+              provider/model-name.
+
+          embedding_config: Configuration for embedding model connection and processing parameters.
+
+          enable_sleeptime: If set to True, memory management will move to a background agent thread.
+
+          hidden: If set to True, the agent will be hidden.
+
+          identity_ids: The ids of the identities associated with this agent.
+
+          last_run_completion: The timestamp when the agent last completed a run.
+
+          last_run_duration_ms: The duration in milliseconds of the agent's last run.
+
+          llm_config: Configuration for Language Model (LLM) connection and generation parameters.
+
+          max_files_open: Maximum number of files that can be open at once for this agent. Setting this
+              too high may exceed the context window, which will break the agent.
+
+          max_tokens: The maximum number of tokens to generate, including reasoning step. If not set,
+              the model will use its default value.
+
+          message_buffer_autoclear: If set to True, the agent will not remember previous messages (though the agent
+              will still retain state via core memory blocks and archival/recall memory). Not
+              recommended unless you have an advanced use case.
+
+          message_ids: The ids of the messages in the agent's in-context memory.
+
+          metadata: The metadata of the agent.
+
+          model: The LLM configuration handle used by the agent, specified in the format
+              provider/model-name, as an alternative to specifying llm_config.
+
+          name: The name of the agent.
+
+          parallel_tool_calls: If set to True, enables parallel tool calling. Defaults to False.
+
+          per_file_view_window_char_limit: The per-file view window character limit for this agent. Setting this too high
+              may exceed the context window, which will break the agent.
+
+          project_id: The id of the project the agent belongs to.
+
+          reasoning: Whether to enable reasoning for this agent.
+
+          response_format: The response format for the agent.
+
+          secrets: The environment variables for tool execution specific to this agent.
+
+          source_ids: The ids of the sources used by the agent.
+
+          system: The system prompt used by the agent.
+
+          tags: The tags associated with the agent.
+
+          template_id: The id of the template the agent belongs to.
+
+          timezone: The timezone of the agent (IANA format).
+
+          tool_exec_environment_variables: Deprecated: use `secrets` field instead
+
+          tool_ids: The ids of the tools used by the agent.
+
+          tool_rules: The tool rules governing the agent.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not agent_id:
+            raise ValueError(f"Expected a non-empty value for `agent_id` but received {agent_id!r}")
+        return await self._patch(
+            f"/v1/agents/{agent_id}",
+            body=await async_maybe_transform(
+                {
+                    "base_template_id": base_template_id,
+                    "block_ids": block_ids,
+                    "context_window_limit": context_window_limit,
+                    "description": description,
+                    "embedding": embedding,
+                    "embedding_config": embedding_config,
+                    "enable_sleeptime": enable_sleeptime,
+                    "hidden": hidden,
+                    "identity_ids": identity_ids,
+                    "last_run_completion": last_run_completion,
+                    "last_run_duration_ms": last_run_duration_ms,
+                    "llm_config": llm_config,
+                    "max_files_open": max_files_open,
+                    "max_tokens": max_tokens,
+                    "message_buffer_autoclear": message_buffer_autoclear,
+                    "message_ids": message_ids,
+                    "metadata": metadata,
+                    "model": model,
+                    "name": name,
+                    "parallel_tool_calls": parallel_tool_calls,
+                    "per_file_view_window_char_limit": per_file_view_window_char_limit,
+                    "project_id": project_id,
+                    "reasoning": reasoning,
+                    "response_format": response_format,
+                    "secrets": secrets,
+                    "source_ids": source_ids,
+                    "system": system,
+                    "tags": tags,
+                    "template_id": template_id,
+                    "timezone": timezone,
+                    "tool_exec_environment_variables": tool_exec_environment_variables,
+                    "tool_ids": tool_ids,
+                    "tool_rules": tool_rules,
+                },
+                agent_modify_params.AgentModifyParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=AgentState,
+        )
+
 
 class AgentsResourceWithRawResponse:
     def __init__(self, agents: AgentsResource) -> None:
@@ -1779,9 +1779,6 @@ class AgentsResourceWithRawResponse:
         self.retrieve = to_raw_response_wrapper(
             agents.retrieve,
         )
-        self.update = to_raw_response_wrapper(
-            agents.update,
-        )
         self.list = to_raw_response_wrapper(
             agents.list,
         )
@@ -1797,6 +1794,9 @@ class AgentsResourceWithRawResponse:
         self.import_file = to_raw_response_wrapper(
             agents.import_file,
         )
+        self.modify = to_raw_response_wrapper(
+            agents.modify,
+        )
 
     @cached_property
     def tools(self) -> ToolsResourceWithRawResponse:
@@ -1833,9 +1833,6 @@ class AsyncAgentsResourceWithRawResponse:
         self.retrieve = async_to_raw_response_wrapper(
             agents.retrieve,
         )
-        self.update = async_to_raw_response_wrapper(
-            agents.update,
-        )
         self.list = async_to_raw_response_wrapper(
             agents.list,
         )
@@ -1851,6 +1848,9 @@ class AsyncAgentsResourceWithRawResponse:
         self.import_file = async_to_raw_response_wrapper(
             agents.import_file,
         )
+        self.modify = async_to_raw_response_wrapper(
+            agents.modify,
+        )
 
     @cached_property
     def tools(self) -> AsyncToolsResourceWithRawResponse:
@@ -1887,9 +1887,6 @@ class AgentsResourceWithStreamingResponse:
         self.retrieve = to_streamed_response_wrapper(
             agents.retrieve,
         )
-        self.update = to_streamed_response_wrapper(
-            agents.update,
-        )
         self.list = to_streamed_response_wrapper(
             agents.list,
         )
@@ -1905,6 +1902,9 @@ class AgentsResourceWithStreamingResponse:
         self.import_file = to_streamed_response_wrapper(
             agents.import_file,
         )
+        self.modify = to_streamed_response_wrapper(
+            agents.modify,
+        )
 
     @cached_property
     def tools(self) -> ToolsResourceWithStreamingResponse:
@@ -1941,9 +1941,6 @@ class AsyncAgentsResourceWithStreamingResponse:
         self.retrieve = async_to_streamed_response_wrapper(
             agents.retrieve,
         )
-        self.update = async_to_streamed_response_wrapper(
-            agents.update,
-        )
         self.list = async_to_streamed_response_wrapper(
             agents.list,
         )
@@ -1959,6 +1956,9 @@ class AsyncAgentsResourceWithStreamingResponse:
         self.import_file = async_to_streamed_response_wrapper(
             agents.import_file,
         )
+        self.modify = async_to_streamed_response_wrapper(
+            agents.modify,
+        )
 
     @cached_property
     def tools(self) -> AsyncToolsResourceWithStreamingResponse: