chore: update API docs from spoon-ai-sdk

Author: actions-user

docs/api-reference/spoon_ai/agents.md

@@ -7,17 +7,15 @@ title: spoon_ai.memory
 # Table of Contents
 
 * [spoon\_ai.memory](#spoon_ai.memory)
+* [spoon\_ai.memory.mem0\_client](#spoon_ai.memory.mem0_client)
+  * [SpoonMem0](#spoon_ai.memory.mem0_client.SpoonMem0)
+    * [add\_text](#spoon_ai.memory.mem0_client.SpoonMem0.add_text)
+    * [get\_all\_memory](#spoon_ai.memory.mem0_client.SpoonMem0.get_all_memory)
+* [spoon\_ai.memory.remove\_message](#spoon_ai.memory.remove_message)
+  * [RemoveMessage](#spoon_ai.memory.remove_message.RemoveMessage)
 * [spoon\_ai.memory.utils](#spoon_ai.memory.utils)
   * [extract\_memories](#spoon_ai.memory.utils.extract_memories)
   * [extract\_first\_memory\_id](#spoon_ai.memory.utils.extract_first_memory_id)
-* [spoon\_ai.memory.short\_term\_manager](#spoon_ai.memory.short_term_manager)
-  * [TrimStrategy](#spoon_ai.memory.short_term_manager.TrimStrategy)
-    * [FROM\_START](#spoon_ai.memory.short_term_manager.TrimStrategy.FROM_START)
-    * [FROM\_END](#spoon_ai.memory.short_term_manager.TrimStrategy.FROM_END)
-  * [MessageTokenCounter](#spoon_ai.memory.short_term_manager.MessageTokenCounter)
-  * [ShortTermMemoryManager](#spoon_ai.memory.short_term_manager.ShortTermMemoryManager)
-    * [trim\_messages](#spoon_ai.memory.short_term_manager.ShortTermMemoryManager.trim_messages)
-    * [summarize\_messages](#spoon_ai.memory.short_term_manager.ShortTermMemoryManager.summarize_messages)
 * [spoon\_ai.memory.checkpointer](#spoon_ai.memory.checkpointer)
   * [Checkpoint](#spoon_ai.memory.checkpointer.Checkpoint)
     * [messages](#spoon_ai.memory.checkpointer.Checkpoint.messages)
@@ -55,12 +53,14 @@ title: spoon_ai.memory
     * [after\_agent](#spoon_ai.memory.checkpointer.CheckpointMiddleware.after_agent)
   * [create\_sqlite\_checkpointer](#spoon_ai.memory.checkpointer.create_sqlite_checkpointer)
   * [create\_memory\_checkpointer](#spoon_ai.memory.checkpointer.create_memory_checkpointer)
-* [spoon\_ai.memory.remove\_message](#spoon_ai.memory.remove_message)
-  * [RemoveMessage](#spoon_ai.memory.remove_message.RemoveMessage)
-* [spoon\_ai.memory.mem0\_client](#spoon_ai.memory.mem0_client)
-  * [SpoonMem0](#spoon_ai.memory.mem0_client.SpoonMem0)
-    * [add\_text](#spoon_ai.memory.mem0_client.SpoonMem0.add_text)
-    * [get\_all\_memory](#spoon_ai.memory.mem0_client.SpoonMem0.get_all_memory)
+* [spoon\_ai.memory.short\_term\_manager](#spoon_ai.memory.short_term_manager)
+  * [TrimStrategy](#spoon_ai.memory.short_term_manager.TrimStrategy)
+    * [FROM\_START](#spoon_ai.memory.short_term_manager.TrimStrategy.FROM_START)
+    * [FROM\_END](#spoon_ai.memory.short_term_manager.TrimStrategy.FROM_END)
+  * [MessageTokenCounter](#spoon_ai.memory.short_term_manager.MessageTokenCounter)
+  * [ShortTermMemoryManager](#spoon_ai.memory.short_term_manager.ShortTermMemoryManager)
+    * [trim\_messages](#spoon_ai.memory.short_term_manager.ShortTermMemoryManager.trim_messages)
+    * [summarize\_messages](#spoon_ai.memory.short_term_manager.ShortTermMemoryManager.summarize_messages)
 
 <a id="spoon_ai.memory"></a>
 
@@ -71,113 +71,86 @@ Short-term memory management for conversation history.
 This module provides memory management utilities for maintaining and optimizing
 conversation history in chat applications.
 
-<a id="spoon_ai.memory.utils"></a>
-
-# Module `spoon_ai.memory.utils`
+<a id="spoon_ai.memory.mem0_client"></a>
 
-Memory helpers shared across Mem0 demos and utilities.
+# Module `spoon_ai.memory.mem0_client`
 
-<a id="spoon_ai.memory.utils.extract_memories"></a>
+<a id="spoon_ai.memory.mem0_client.SpoonMem0"></a>
 
-#### `extract_memories`
+## `SpoonMem0` Objects
 
 ```python
-def extract_memories(result: Any) -> List[str]
+class SpoonMem0()
 ```
 
-Normalize Mem0 search/get responses into a list of memory strings.
-Supports common shapes: &#123;"memories": [...]&#125;, &#123;"results": [...]&#125;, &#123;"data": [...]&#125;, list, or scalar.
+Lightweight wrapper around Mem0's MemoryClient with safe defaults.
 
-<a id="spoon_ai.memory.utils.extract_first_memory_id"></a>
+<a id="spoon_ai.memory.mem0_client.SpoonMem0.add_text"></a>
 
-#### `extract_first_memory_id`
+#### `add_text`
 
 ```python
-def extract_first_memory_id(result: Any) -> Optional[str]
+def add_text(data: str,
+             user_id: Optional[str] = None,
+             metadata: Optional[Dict[str, Any]] = None) -> None
 ```
 
-Pull the first memory id from Mem0 responses.
-Supports common id fields: id, _id, memory_id, uuid.
-
-<a id="spoon_ai.memory.short_term_manager"></a>
-
-# Module `spoon_ai.memory.short_term_manager`
-
-Short-term memory management for conversation history.
+Convenience helper for adding a single text memory.
 
-<a id="spoon_ai.memory.short_term_manager.TrimStrategy"></a>
+<a id="spoon_ai.memory.mem0_client.SpoonMem0.get_all_memory"></a>
 
-## `TrimStrategy` Objects
+#### `get_all_memory`
 
 ```python
-class TrimStrategy(str, Enum)
+def get_all_memory(user_id: Optional[str] = None,
+                   limit: Optional[int] = None) -> List[str]
 ```
 
-Strategy for trimming messages.
-
-<a id="spoon_ai.memory.short_term_manager.TrimStrategy.FROM_START"></a>
-
-#### `FROM_START`
-
-Remove oldest messages first
+Retrieve all memories for a user (subject to backend limits).
 
-<a id="spoon_ai.memory.short_term_manager.TrimStrategy.FROM_END"></a>
+<a id="spoon_ai.memory.remove_message"></a>
 
-#### `FROM_END`
+# Module `spoon_ai.memory.remove_message`
 
-Remove newest messages first
+Helpers for emitting message-removal directives.
 
-<a id="spoon_ai.memory.short_term_manager.MessageTokenCounter"></a>
+<a id="spoon_ai.memory.remove_message.RemoveMessage"></a>
 
-## `MessageTokenCounter` Objects
+## `RemoveMessage` Objects
 
 ```python
-class MessageTokenCounter()
+class RemoveMessage(BaseModel)
 ```
 
-Approximate token counter aligned with LangChain semantics.
-
-<a id="spoon_ai.memory.short_term_manager.ShortTermMemoryManager"></a>
+Lightweight message that signals another message should be removed.
 
-## `ShortTermMemoryManager` Objects
+<a id="spoon_ai.memory.utils"></a>
 
-```python
-class ShortTermMemoryManager()
-```
+# Module `spoon_ai.memory.utils`
 
-Manager for short-term conversation memory with advanced operations.
+Memory helpers shared across Mem0 demos and utilities.
 
-<a id="spoon_ai.memory.short_term_manager.ShortTermMemoryManager.trim_messages"></a>
+<a id="spoon_ai.memory.utils.extract_memories"></a>
 
-#### `trim_messages`
+#### `extract_memories`
 
 ```python
-async def trim_messages(messages: List[Message],
-                        max_tokens: int,
-                        strategy: TrimStrategy = TrimStrategy.FROM_END,
-                        keep_system: bool = True,
-                        model: Optional[str] = None) -> List[Message]
+def extract_memories(result: Any) -> List[str]
 ```
 
-Trim messages using a LangChain-style heuristic.
+Normalize Mem0 search/get responses into a list of memory strings.
+Supports common shapes: &#123;"memories": [...]&#125;, &#123;"results": [...]&#125;, &#123;"data": [...]&#125;, list, or scalar.
 
-<a id="spoon_ai.memory.short_term_manager.ShortTermMemoryManager.summarize_messages"></a>
+<a id="spoon_ai.memory.utils.extract_first_memory_id"></a>
 
-#### `summarize_messages`
+#### `extract_first_memory_id`
 
 ```python
-async def summarize_messages(
-    messages: List[Message],
-    max_tokens_before_summary: int,
-    messages_to_keep: int = 5,
-    summary_model: Optional[str] = None,
-    llm_manager=None,
-    llm_provider: Optional[str] = None,
-    existing_summary: str = ""
-) -> Tuple[List[Message], List[RemoveMessage], Optional[str]]
+def extract_first_memory_id(result: Any) -> Optional[str]
 ```
 
-Summarize earlier messages and emit removal directives.
+Pull the first memory id from Mem0 responses.
+Supports common id fields: id, _id, memory_id, uuid.
 
 <a id="spoon_ai.memory.checkpointer"></a>
 
@@ -661,56 +634,83 @@ Create an in-memory checkpointer for testing.
 
   InMemoryCheckpointer instance
 
-<a id="spoon_ai.memory.remove_message"></a>
+<a id="spoon_ai.memory.short_term_manager"></a>
 
-# Module `spoon_ai.memory.remove_message`
+# Module `spoon_ai.memory.short_term_manager`
 
-Helpers for emitting message-removal directives.
+Short-term memory management for conversation history.
 
-<a id="spoon_ai.memory.remove_message.RemoveMessage"></a>
+<a id="spoon_ai.memory.short_term_manager.TrimStrategy"></a>
 
-## `RemoveMessage` Objects
+## `TrimStrategy` Objects
 
 ```python
-class RemoveMessage(BaseModel)
+class TrimStrategy(str, Enum)
 ```
 
-Lightweight message that signals another message should be removed.
+Strategy for trimming messages.
 
-<a id="spoon_ai.memory.mem0_client"></a>
+<a id="spoon_ai.memory.short_term_manager.TrimStrategy.FROM_START"></a>
 
-# Module `spoon_ai.memory.mem0_client`
+#### `FROM_START`
 
-<a id="spoon_ai.memory.mem0_client.SpoonMem0"></a>
+Remove oldest messages first
 
-## `SpoonMem0` Objects
+<a id="spoon_ai.memory.short_term_manager.TrimStrategy.FROM_END"></a>
+
+#### `FROM_END`
+
+Remove newest messages first
+
+<a id="spoon_ai.memory.short_term_manager.MessageTokenCounter"></a>
+
+## `MessageTokenCounter` Objects
 
 ```python
-class SpoonMem0()
+class MessageTokenCounter()
 ```
 
-Lightweight wrapper around Mem0's MemoryClient with safe defaults.
+Approximate token counter aligned with LangChain semantics.
 
-<a id="spoon_ai.memory.mem0_client.SpoonMem0.add_text"></a>
+<a id="spoon_ai.memory.short_term_manager.ShortTermMemoryManager"></a>
 
-#### `add_text`
+## `ShortTermMemoryManager` Objects
 
 ```python
-def add_text(data: str,
-             user_id: Optional[str] = None,
-             metadata: Optional[Dict[str, Any]] = None) -> None
+class ShortTermMemoryManager()
 ```
 
-Convenience helper for adding a single text memory.
+Manager for short-term conversation memory with advanced operations.
 
-<a id="spoon_ai.memory.mem0_client.SpoonMem0.get_all_memory"></a>
+<a id="spoon_ai.memory.short_term_manager.ShortTermMemoryManager.trim_messages"></a>
 
-#### `get_all_memory`
+#### `trim_messages`
 
 ```python
-def get_all_memory(user_id: Optional[str] = None,
-                   limit: Optional[int] = None) -> List[str]
+async def trim_messages(messages: List[Message],
+                        max_tokens: int,
+                        strategy: TrimStrategy = TrimStrategy.FROM_END,
+                        keep_system: bool = True,
+                        model: Optional[str] = None) -> List[Message]
 ```
 
-Retrieve all memories for a user (subject to backend limits).
+Trim messages using a LangChain-style heuristic.
+
+<a id="spoon_ai.memory.short_term_manager.ShortTermMemoryManager.summarize_messages"></a>
+
+#### `summarize_messages`
+
+```python
+async def summarize_messages(
+    messages: List[Message],
+    max_tokens_before_summary: int,
+    messages_to_keep: int = 5,
+    summary_model: Optional[str] = None,
+    llm_manager=None,
+    llm_provider: Optional[str] = None,
+    existing_summary: str = ""
+) -> Tuple[List[Message], List[RemoveMessage], Optional[str]]
+```
+
+Summarize earlier messages and emit removal directives.