acontext 0.0.9__py3-none-any.whl → 0.0.11__py3-none-any.whl

acontext/resources/async_sessions.py

@@ -15,6 +15,7 @@ from ..types.session import (
     LearningStatus,
     ListSessionsOutput,
     Message,
+    MessageObservingStatus,
     Session,
     TokenCounts,
 )
@@ -167,7 +168,7 @@ class AsyncSessionsAPI:
         )
         return GetTasksOutput.model_validate(data)
 
-    async def send_message(
+    async def store_message(
         self,
         session_id: str,
         *,
@@ -181,7 +182,7 @@ class AsyncSessionsAPI:
             | None
         ) = None,
     ) -> Message:
-        """Send a message to a session.
+        """Store a message to a session.
 
         Args:
             session_id: The UUID of the session.
@@ -346,3 +347,21 @@ class AsyncSessionsAPI:
             "GET", f"/session/{session_id}/token_counts"
         )
         return TokenCounts.model_validate(data)
+
+async def messages_observing_status(self, session_id: str) -> MessageObservingStatus:
+        """Get message observing status counts for a session.
+        
+        Returns the count of messages by their observing status:
+        observed, in_process, and pending.
+        
+        Args:
+            session_id: The UUID of the session.
+        
+        Returns:
+            MessageObservingStatus object containing observed, in_process, 
+            pending counts and updated_at timestamp.
+        """
+        data = await self._requester.request(
+            "GET", f"/session/{session_id}/observing_status"
+        )
+        return MessageObservingStatus.model_validate(data)

acontext/resources/sessions.py

@@ -15,6 +15,7 @@ from ..types.session import (
     LearningStatus,
     ListSessionsOutput,
     Message,
+    MessageObservingStatus,
     Session,
     TokenCounts,
 )
@@ -171,7 +172,7 @@ class SessionsAPI:
         )
         return GetTasksOutput.model_validate(data)
 
-    def send_message(
+    def store_message(
         self,
         session_id: str,
         *,
@@ -185,7 +186,7 @@ class SessionsAPI:
             | None
         ) = None,
     ) -> Message:
-        """Send a message to a session.
+        """Store a message to a session.
 
         Args:
             session_id: The UUID of the session.
@@ -348,3 +349,20 @@ class SessionsAPI:
         """
         data = self._requester.request("GET", f"/session/{session_id}/token_counts")
         return TokenCounts.model_validate(data)
+    def messages_observing_status(self, session_id: str) -> MessageObservingStatus:
+        """Get message observing status counts for a session.
+        
+        Returns the count of messages by their observing status:
+        observed, in_process, and pending.
+        
+        Args:
+            session_id: The UUID of the session.
+        
+        Returns:
+            MessageObservingStatus object containing observed, in_process, 
+            pending counts and updated_at timestamp.
+        """
+        data = self._requester.request(
+            "GET", f"/session/{session_id}/observing_status"
+        )
+        return MessageObservingStatus.model_validate(data)

acontext/types/session.py

@@ -30,6 +30,34 @@ class RemoveToolResultStrategy(TypedDict):
     params: RemoveToolResultParams
 
 
+class RemoveToolCallParamsParams(TypedDict, total=False):
+    """Parameters for the remove_tool_call_params edit strategy.
+
+    Attributes:
+        keep_recent_n_tool_calls: Number of most recent tool calls to keep with full parameters.
+            Defaults to 3 if not specified.
+    """
+
+    keep_recent_n_tool_calls: NotRequired[int]
+
+
+
+class RemoveToolCallParamsStrategy(TypedDict):
+    """Edit strategy to remove parameters from old tool-call parts.
+
+    Keeps the most recent N tool calls with full parameters, replacing older
+    tool call arguments with empty JSON "{}". The tool call ID and name remain
+    intact so tool-results can still reference them.
+
+    Example:
+        {"type": "remove_tool_call_params", "params": {"keep_recent_n_tool_calls": 5}}
+    """
+
+    type: Literal["remove_tool_call_params"]
+    params: RemoveToolCallParamsParams
+
+
+
 class TokenLimitParams(TypedDict):
     """Parameters for the token_limit edit strategy.
 
@@ -59,7 +87,7 @@ class TokenLimitStrategy(TypedDict):
 
 # Union type for all edit strategies
 # When adding new strategies, add them to this Union: EditStrategy = Union[RemoveToolResultStrategy, OtherStrategy, ...]
-EditStrategy = Union[RemoveToolResultStrategy, TokenLimitStrategy]
+EditStrategy = Union[RemoveToolResultStrategy, RemoveToolCallParamsStrategy, TokenLimitStrategy]
 
 
 class Asset(BaseModel):
@@ -187,6 +215,10 @@ class GetMessagesOutput(BaseModel):
         ...,
         description="List of messages in the requested format (Message, OpenAI format, or Anthropic format)",
     )
+    ids: list[str] = Field(
+	...,
+	description="List of message UUIDs corresponding to each item in the same order",
+    )
     next_cursor: str | None = Field(None, description="Cursor for pagination")
     has_more: bool = Field(..., description="Whether there are more items")
     public_urls: dict[str, PublicURL] | None = Field(
@@ -221,3 +253,19 @@ class TokenCounts(BaseModel):
         ...,
         description="Total token count for all text and tool-call parts in a session",
     )
+
+class MessageObservingStatus(BaseModel):
+    """Response model for message observing status."""
+    
+    observed: int = Field(
+        ..., description="Number of messages with observed status"
+    )
+    in_process: int = Field(
+        ..., description="Number of messages with in_process status"
+    )
+    pending: int = Field(
+        ..., description="Number of messages with pending status"
+    )
+    updated_at: str = Field(
+        ..., description="Timestamp when the status was retrieved"
+    )

acontext-0.0.11.dist-info/METADATA

@@ -0,0 +1,34 @@
+Metadata-Version: 2.3
+Name: acontext
+Version: 0.0.11
+Summary: Python SDK for the Acontext API
+Keywords: acontext,sdk,client,api
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: openai>=2.6.1
+Requires-Dist: anthropic>=0.72.0
+Requires-Dist: pydantic>=2.12.3
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/memodb-io/Acontext
+Project-URL: Issues, https://github.com/memodb-io/Acontext/issues
+Project-URL: Repository, https://github.com/memodb-io/Acontext
+Description-Content-Type: text/markdown
+
+## acontext client for python
+
+Python SDK for interacting with the Acontext REST API.
+
+### Installation
+
+```bash
+pip install acontext
+```
+
+> Requires Python 3.10 or newer.
+
+
+
+
+
+# 🔍 Document
+
+To understand more about this SDK, please view [our docs](https://docs.acontext.io/) and [api references](https://docs.acontext.io/api-reference/introduction)

{acontext-0.0.9.dist-info → acontext-0.0.11.dist-info}/RECORD

@@ -13,21 +13,21 @@ acontext/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 acontext/resources/__init__.py,sha256=KSVQ3YJ-wuU6OWGWJ47gDGbjjetP102aEsVSR8JUb_4,721
 acontext/resources/async_blocks.py,sha256=e_iJpgcAdwS2tXQ16MMCnySlddp5JV3BadN_EyqZSF4,5555
 acontext/resources/async_disks.py,sha256=2JjLpUkz5YZEkLt_jCts_khTG_b7lvf4cUMfoaJcnI8,6471
-acontext/resources/async_sessions.py,sha256=oFVcU0rBGD5Mhue7HdKxRQermmSHSlI05eNRgPV-8J4,12541
+acontext/resources/async_sessions.py,sha256=UBqVr7M0BrRifB79u7xWe0CfM66YTeSebiKHpvZZhBI,13252
 acontext/resources/async_spaces.py,sha256=5lIZjI8GmgoMBcftAMD2vDj2FmbLZ6pi1-yNCWKv4cM,6408
 acontext/resources/async_tools.py,sha256=RbGaF2kX65Mun-q-Fp5H1J8waWTLIdCOfbdY19jpn1o,1091
 acontext/resources/blocks.py,sha256=HJdAy5HdyTcHCYCPmqNdvApYKZ6aWs-ORIi_wQt3TUM,5447
 acontext/resources/disks.py,sha256=BjVhVXoujHWhg6L0TG9GmW9HLTTldJYEPxCbuppRkc4,6336
-acontext/resources/sessions.py,sha256=mETp0dtGBi9e20L5f_KbCzw-6oP0pjtUmx-9Vlb8vYA,12634
+acontext/resources/sessions.py,sha256=7wdCM1rlozv3F05o9a5T9T-EEOp-y1eiVZHVfRYbQUo,13336
 acontext/resources/spaces.py,sha256=LJP9krygZGdktMDtYGudCpk7yBxe_4v34QLk3SdejwQ,6267
 acontext/resources/tools.py,sha256=II_185B0HYKSP43hizE6C1zs7kjkkPLKihuEG8s-DRY,1046
 acontext/types/__init__.py,sha256=QWNLmdSnLE2b5XRXxnI2OKnHVdKQPJH0nJvvOYwhB1o,1448
 acontext/types/block.py,sha256=CzKByunk642rWXNNnh8cx67UzKLKDAxODmC_whwjP90,1078
 acontext/types/disk.py,sha256=g9u3rgCh05rK-gay19NUi-WyzI5Vt1GQwcyKv-5TSC4,2361
-acontext/types/session.py,sha256=HU8i8zxHGfGkHS9YRlh4JDst3aWZLfqSIUVq-HX4GYg,8444
+acontext/types/session.py,sha256=H_n4vZJ02ZO5flqGZ8R5AYVSScxScf2r7UgsN5LRIa0,9965
 acontext/types/space.py,sha256=uxbPrOHYpsntPHqhMCLQ2KovM7BngHC5Q2j7qexVrN8,2537
 acontext/types/tool.py,sha256=-mVn-vgk2SENK0Ubt-ZgWFZxKa-ddABqcAgXQ69YY-E,805
 acontext/uploads.py,sha256=6twnqQOY_eerNuEjeSKsE_3S0IfJUiczXtAy4aXqDl8,1379
-acontext-0.0.9.dist-info/WHEEL,sha256=xDCZ-UyfvkGuEHPeI7BcJzYKIZzdqN8A8o1M5Om8IyA,79
-acontext-0.0.9.dist-info/METADATA,sha256=O1dmjGIvaW5EisSVf5E9huYMe2jo_SmrYUUhy6JVv_Q,14395
-acontext-0.0.9.dist-info/RECORD,,
+acontext-0.0.11.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
+acontext-0.0.11.dist-info/METADATA,sha256=rlg5ytr7FzRwgofIKYaZkUFUxbYXoiW2EwOBKXIe1hs,859
+acontext-0.0.11.dist-info/RECORD,,

{acontext-0.0.9.dist-info → acontext-0.0.11.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.17
+Generator: uv 0.9.18
 Root-Is-Purelib: true
 Tag: py3-none-any

acontext-0.0.9.dist-info/METADATA

@@ -1,661 +0,0 @@
-Metadata-Version: 2.3
-Name: acontext
-Version: 0.0.9
-Summary: Python SDK for the Acontext API
-Keywords: acontext,sdk,client,api
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: openai>=2.6.1
-Requires-Dist: anthropic>=0.72.0
-Requires-Dist: pydantic>=2.12.3
-Requires-Python: >=3.10
-Project-URL: Homepage, https://github.com/memodb-io/Acontext
-Project-URL: Issues, https://github.com/memodb-io/Acontext/issues
-Project-URL: Repository, https://github.com/memodb-io/Acontext
-Description-Content-Type: text/markdown
-
-## acontext client for python
-
-Python SDK for interacting with the Acontext REST API.
-
-### Installation
-
-```bash
-pip install acontext
-```
-
-> Requires Python 3.10 or newer.
-
-### Quickstart
-
-```python
-from acontext import AcontextClient
-
-with AcontextClient(api_key="sk_project_token") as client:
-    # Create a space
-    space = client.spaces.create()
-    
-    # Create a session
-    session = client.sessions.create(space_id=space.id)
-    
-    # Send a message
-    from acontext.messages import build_acontext_message
-    message = build_acontext_message(role="user", parts=["Hello!"])
-    client.sessions.send_message(session.id, blob=message, format="acontext")
-```
-
-See the sections below for detailed examples of all available APIs.
-
-### Async Client
-
-The SDK provides full async support via `AsyncAcontextClient`. All API methods are available in async form:
-
-```python
-import asyncio
-from acontext import AsyncAcontextClient
-
-async def main():
-    async with AsyncAcontextClient(api_key="sk_project_token") as client:
-        # Create a space
-        space = await client.spaces.create()
-        
-        # Create a session
-        session = await client.sessions.create(space_id=space.id)
-        
-        # Send a message
-        from acontext.messages import build_acontext_message
-        message = build_acontext_message(role="user", parts=["Hello async!"])
-        await client.sessions.send_message(session.id, blob=message, format="acontext")
-        
-        # Perform concurrent operations
-        spaces_task = client.spaces.list(limit=10)
-        sessions_task = client.sessions.list(limit=10)
-        spaces, sessions = await asyncio.gather(spaces_task, sessions_task)
-
-asyncio.run(main())
-```
-
-### Health Check
-
-#### Ping the server
-
-Test connectivity to the Acontext API server:
-
-```python
-# Synchronous client
-pong = client.ping()
-print(f"Server responded: {pong}")  # Output: Server responded: pong
-
-# Async client
-pong = await client.ping()
-print(f"Server responded: {pong}")  # Output: Server responded: pong
-```
-
-This is useful for:
-- Verifying API connectivity before performing operations
-- Health checks in monitoring systems
-- Debugging connection issues
-
-### Spaces API
-
-#### List spaces
-
-```python
-spaces = client.spaces.list(limit=10, time_desc=True)
-for space in spaces.items:
-    print(f"{space.id}: {space.configs}")
-```
-
-#### Create space
-
-```python
-space = client.spaces.create(configs={"name": "My Space"})
-print(f"Created space: {space.id}")
-```
-
-#### Delete space
-
-```python
-client.spaces.delete(space_id="space-uuid")
-```
-
-#### Update space configs
-
-```python
-client.spaces.update_configs(
-    space_id="space-uuid",
-    configs={"name": "Updated Name", "description": "New description"}
-)
-```
-
-#### Get space configs
-
-```python
-space = client.spaces.get_configs(space_id="space-uuid")
-print(space.configs)
-```
-
-### Sessions API
-
-#### List sessions
-
-```python
-sessions = client.sessions.list(
-    space_id="space-uuid",
-    limit=20,
-    time_desc=True
-)
-for session in sessions.items:
-    print(f"{session.id}: {session.space_id}")
-```
-
-#### Create session
-
-```python
-session = client.sessions.create(
-    space_id="space-uuid",
-    configs={"mode": "chat"}
-)
-print(f"Created session: {session.id}")
-```
-
-#### Delete session
-
-```python
-client.sessions.delete(session_id="session-uuid")
-```
-
-#### Update session configs
-
-```python
-client.sessions.update_configs(
-    session_id="session-uuid",
-    configs={"mode": "updated-mode"}
-)
-```
-
-#### Get session configs
-
-```python
-session = client.sessions.get_configs(session_id="session-uuid")
-print(session.configs)
-```
-
-#### Connect session to space
-
-```python
-client.sessions.connect_to_space(
-    session_id="session-uuid",
-    space_id="space-uuid"
-)
-```
-
-#### Get tasks
-
-```python
-tasks = client.sessions.get_tasks(
-    session_id="session-uuid",
-    limit=10,
-    time_desc=True
-)
-for task in tasks.items:
-    print(f"{task.id}: {task.status}")
-```
-
-#### Get messages
-
-```python
-messages = client.sessions.get_messages(
-    session_id="session-uuid",
-    limit=50,
-    format="acontext",
-    time_desc=True
-)
-for message in messages.items:
-    print(f"{message.role}: {message.parts}")
-```
-
-#### Send message (Acontext format)
-
-```python
-from acontext.messages import build_acontext_message
-
-# Simple text message
-message = build_acontext_message(role="user", parts=["Hello!"])
-client.sessions.send_message(
-    session_id="session-uuid",
-    blob=message,
-    format="acontext"
-)
-
-# Message with file upload
-from acontext import FileUpload
-
-file_message = build_acontext_message(
-    role="user",
-    parts=[{"type": "file", "file_field": "document"}]
-)
-client.sessions.send_message(
-    session_id="session-uuid",
-    blob=file_message,
-    format="acontext",
-    file_field="document",
-    file=FileUpload(
-        filename="doc.pdf",
-        content=b"file content",
-        content_type="application/pdf"
-    )
-)
-```
-
-#### Send message (OpenAI format)
-
-```python
-openai_message = {
-    "role": "user",
-    "content": "Hello from OpenAI format!"
-}
-client.sessions.send_message(
-    session_id="session-uuid",
-    blob=openai_message,
-    format="openai"
-)
-```
-
-#### Send message (Anthropic format)
-
-```python
-anthropic_message = {
-    "role": "user",
-    "content": "Hello from Anthropic format!"
-}
-client.sessions.send_message(
-    session_id="session-uuid",
-    blob=anthropic_message,
-    format="anthropic"
-)
-```
-
-#### Flush session buffer
-
-```python
-result = client.sessions.flush(session_id="session-uuid")
-print(result)  # {"status": 0, "errmsg": ""}
-```
-
-### Tools API
-
-#### Get tool names
-
-```python
-tools = client.tools.get_tool_name()
-for tool in tools:
-    print(f"{tool.name} (used in {tool.sop_count} SOPs)")
-```
-
-#### Rename tool names
-
-```python
-result = client.tools.rename_tool_name(
-    rename=[
-        {"old_name": "calculate", "new_name": "calculate_math"},
-        {"old_name": "search", "new_name": "search_web"},
-    ]
-)
-print(result.status)  # 0 for success
-```
-
-### Agent Tools
-
-The SDK provides agent tools that allow LLMs (OpenAI, Anthropic) to interact with Acontext disks through function calling. These tools can be converted to OpenAI or Anthropic tool schemas and executed when the LLM calls them.
-
-#### Pre-configured Disk Tools
-
-The SDK includes a pre-configured `DISK_TOOLS` pool with four disk operation tools:
-
-- **`write_file`**: Write text content to a file
-- **`read_file`**: Read a text file with optional line offset and limit
-- **`replace_string`**: Replace strings in a file
-- **`list_artifacts`**: List files and directories in a path
-
-#### Getting Tool Schemas for LLM APIs
-
-Convert tools to the appropriate format for your LLM provider:
-
-```python
-from acontext import AcontextClient
-from acontext.agent.disk import DISK_TOOLS
-
-client = AcontextClient(api_key="sk-ac-your-root-api-bearer-token")
-
-# Get OpenAI-compatible tool schemas
-openai_tools = DISK_TOOLS.to_openai_tool_schema()
-
-# Get Anthropic-compatible tool schemas
-anthropic_tools = DISK_TOOLS.to_anthropic_tool_schema()
-
-# Use with OpenAI API
-import openai
-openai_client = openai.OpenAI(api_key="your-openai-key")
-completion = openai_client.chat.completions.create(
-    model="gpt-4",
-    messages=[{"role": "user", "content": 'Write a file called hello.txt with "Hello, World!"'}],
-    tools=openai_tools,
-)
-```
-
-#### Executing Tools
-
-When an LLM calls a tool, execute it using the tool pool:
-
-```python
-from acontext import AcontextClient
-from acontext.agent.disk import DISK_TOOLS
-
-client = AcontextClient(api_key="sk-ac-your-root-api-bearer-token")
-
-# Create a disk for the tools to operate on
-disk = client.disks.create()
-
-# Create a context for the tools
-ctx = DISK_TOOLS.format_context(client, disk.id)
-
-# Execute a tool (e.g., after LLM returns a tool call)
-result = DISK_TOOLS.execute_tool(
-    ctx,
-    "write_file",
-    {"filename": "hello.txt", "file_path": "/notes/", "content": "Hello, World!"}
-)
-print(result)  # File 'hello.txt' written successfully to '/notes/hello.txt'
-
-# Read the file
-read_result = DISK_TOOLS.execute_tool(
-    ctx,
-    "read_file",
-    {"filename": "hello.txt", "file_path": "/notes/"}
-)
-print(read_result)
-
-# List files in a directory
-list_result = DISK_TOOLS.execute_tool(
-    ctx,
-    "list_artifacts",
-    {"file_path": "/notes/"}
-)
-print(list_result)
-
-# Replace a string in a file
-replace_result = DISK_TOOLS.execute_tool(
-    ctx,
-    "replace_string",
-    {
-        "filename": "hello.txt",
-        "file_path": "/notes/",
-        "old_string": "Hello",
-        "new_string": "Hi",
-    }
-)
-print(replace_result)
-```
-
-#### Creating Custom Tools
-
-You can create custom tools by extending `BaseTool`:
-
-```python
-from acontext.agent.base import BaseTool, BaseToolPool, BaseContext
-from typing import Dict, Any
-
-class MyCustomTool(BaseTool):
-    @property
-    def name(self) -> str:
-        return "my_custom_tool"
-    
-    @property
-    def description(self) -> str:
-        return "A custom tool that does something"
-    
-    @property
-    def arguments(self) -> dict:
-        return {
-            "param1": {
-                "type": "string",
-                "description": "First parameter",
-            }
-        }
-    
-    @property
-    def required_arguments(self) -> list[str]:
-        return ["param1"]
-    
-    def execute(self, ctx: BaseContext, llm_arguments: dict) -> str:
-        param1 = llm_arguments.get("param1")
-        # Your custom logic here
-        return f"Result: {param1}"
-
-# Create a custom tool pool
-class MyToolPool(BaseToolPool):
-    def format_context(self, *args, **kwargs) -> BaseContext:
-        # Create and return your context
-        return BaseContext()
-
-my_pool = MyToolPool()
-my_pool.add_tool(MyCustomTool())
-```
-
-### Blocks API
-
-#### List blocks
-
-```python
-blocks = client.blocks.list(
-    space_id="space-uuid",
-    parent_id="parent-uuid",
-    block_type="page"
-)
-for block in blocks:
-    print(f"{block.id}: {block.title}")
-```
-
-#### Create block
-
-```python
-# Create a page
-page = client.blocks.create(
-    space_id="space-uuid",
-    block_type="page",
-    title="My Page"
-)
-
-# Create a text block under the page
-text_block = client.blocks.create(
-    space_id="space-uuid",
-    parent_id=page["id"],
-    block_type="text",
-    title="Content",
-    props={"text": "Block content here"}
-)
-```
-
-#### Delete block
-
-```python
-client.blocks.delete(space_id="space-uuid", block_id="block-uuid")
-```
-
-#### Get block properties
-
-```python
-block = client.blocks.get_properties(
-    space_id="space-uuid",
-    block_id="block-uuid"
-)
-print(f"{block.title}: {block.props}")
-```
-
-#### Update block properties
-
-```python
-client.blocks.update_properties(
-    space_id="space-uuid",
-    block_id="block-uuid",
-    title="Updated Title",
-    props={"text": "Updated content"}
-)
-```
-
-#### Move block
-
-```python
-# Move to a different parent
-client.blocks.move(
-    space_id="space-uuid",
-    block_id="block-uuid",
-    parent_id="new-parent-uuid"
-)
-
-# Update sort order
-client.blocks.move(
-    space_id="space-uuid",
-    block_id="block-uuid",
-    sort=0
-)
-```
-
-#### Update block sort
-
-```python
-client.blocks.update_sort(
-    space_id="space-uuid",
-    block_id="block-uuid",
-    sort=5
-)
-```
-
-### Disks API
-
-#### List disks
-
-```python
-disks = client.disks.list(limit=10, time_desc=True)
-for disk in disks.items:
-    print(f"Disk: {disk.id}")
-```
-
-#### Create disk
-
-```python
-disk = client.disks.create()
-print(f"Created disk: {disk.id}")
-```
-
-#### Delete disk
-
-```python
-client.disks.delete(disk_id="disk-uuid")
-```
-
-### DiskArtifacts API
-
-#### Upsert artifact
-
-```python
-from acontext import FileUpload
-
-artifact = client.disks.artifacts.upsert(
-    disk_id="disk-uuid",
-    file=FileUpload(
-        filename="notes.md",
-        content=b"# Notes\nContent here",
-        content_type="text/markdown"
-    ),
-    file_path="/documents/",
-    meta={"source": "api", "version": "1.0"}
-)
-print(f"Uploaded: {artifact.filename}")
-```
-
-#### Get artifact
-
-```python
-artifact = client.disks.artifacts.get(
-    disk_id="disk-uuid",
-    file_path="/documents/",
-    filename="notes.md",
-    with_public_url=True,
-    with_content=True
-)
-print(f"Content: {artifact.content}")
-print(f"URL: {artifact.public_url}")
-```
-
-#### Update artifact metadata
-
-```python
-artifact = client.disks.artifacts.update(
-    disk_id="disk-uuid",
-    file_path="/documents/",
-    filename="notes.md",
-    meta={"source": "api", "version": "2.0", "updated": True}
-)
-```
-
-#### Delete artifact
-
-```python
-client.disks.artifacts.delete(
-    disk_id="disk-uuid",
-    file_path="/documents/",
-    filename="notes.md"
-)
-```
-
-#### List artifacts
-
-```python
-artifacts = client.disks.artifacts.list(
-    disk_id="disk-uuid",
-    path="/documents/"
-)
-for artifact in artifacts.items:
-    print(f"{artifact.filename} ({artifact.size_b} bytes)")
-```
-
-### Semantic search within spaces
-
-The SDK provides a powerful semantic search API for finding content within your spaces:
-
-#### 1. Experience Search (Advanced AI-powered search)
-
-The most sophisticated search that can operate in two modes: **fast** (quick semantic search) or **agentic** (AI-powered iterative refinement).
-
-```python
-from acontext import AcontextClient
-
-client = AcontextClient(api_key="sk_project_token")
-
-# Fast mode - quick semantic search
-result = client.spaces.experience_search(
-    space_id="space-uuid",
-    query="How to implement authentication?",
-    limit=10,
-    mode="fast",
-)
-
-# Agentic mode - AI-powered iterative search
-result = client.spaces.experience_search(
-    space_id="space-uuid",
-    query="What are the best practices for API security?",
-    limit=10,
-    mode="agentic",
-    max_iterations=20,
-)
-
-# Access results
-for block in result.cited_blocks:
-    print(f"{block.title} (distance: {block.distance})")
-
-if result.final_answer:
-    print(f"AI Answer: {result.final_answer}")
-```
-
-See `examples/search_usage.py` for more detailed examples including async usage.