acontext 0.1.1__tar.gz → 0.1.3__tar.gz

{acontext-0.1.1 → acontext-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acontext
-Version: 0.1.1
+Version: 0.1.3
 Summary: Python SDK for the Acontext API
 Keywords: acontext,sdk,client,api
 Requires-Dist: httpx>=0.28.1
@@ -10,8 +10,8 @@ Requires-Dist: pydantic>=2.12.3
 Requires-Dist: urllib3>=2.6.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
+Project-URL: Issues, https://github.com/memodb-io/Acontext/issues
 Description-Content-Type: text/markdown
 
 ## acontext client for python

{acontext-0.1.1 → acontext-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acontext"
-version = "0.1.1"
+version = "0.1.3"
 description = "Python SDK for the Acontext API"
 readme = "README.md"
 requires-python = ">=3.10"

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/async_client.py

@@ -14,6 +14,7 @@ from .messages import MessagePart as MessagePart
 from .uploads import FileUpload as FileUpload
 from .resources.async_disks import AsyncDisksAPI as AsyncDisksAPI
 from .resources.async_blocks import AsyncBlocksAPI as AsyncBlocksAPI
+from .resources.async_sandboxes import AsyncSandboxesAPI as AsyncSandboxesAPI
 from .resources.async_sessions import AsyncSessionsAPI as AsyncSessionsAPI
 from .resources.async_spaces import AsyncSpacesAPI as AsyncSpacesAPI
 from .resources.async_tools import AsyncToolsAPI as AsyncToolsAPI
@@ -113,6 +114,7 @@ class AcontextAsyncClient:
         self.tools = AsyncToolsAPI(self)
         self.skills = AsyncSkillsAPI(self)
         self.users = AsyncUsersAPI(self)
+        self.sandboxes = AsyncSandboxesAPI(self)
 
     @property
     def base_url(self) -> str:

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/client.py

@@ -14,6 +14,7 @@ from .messages import MessagePart as MessagePart
 from .uploads import FileUpload as FileUpload
 from .resources.disks import DisksAPI as DisksAPI
 from .resources.blocks import BlocksAPI as BlocksAPI
+from .resources.sandboxes import SandboxesAPI as SandboxesAPI
 from .resources.sessions import SessionsAPI as SessionsAPI
 from .resources.spaces import SpacesAPI as SpacesAPI
 from .resources.tools import ToolsAPI as ToolsAPI
@@ -113,6 +114,7 @@ class AcontextClient:
         self.tools = ToolsAPI(self)
         self.skills = SkillsAPI(self)
         self.users = UsersAPI(self)
+        self.sandboxes = SandboxesAPI(self)
 
     @property
     def base_url(self) -> str:

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/resources/__init__.py

@@ -2,6 +2,7 @@
 
 from .async_blocks import AsyncBlocksAPI
 from .async_disks import AsyncDisksAPI, AsyncDiskArtifactsAPI
+from .async_sandboxes import AsyncSandboxesAPI
 from .async_sessions import AsyncSessionsAPI
 from .async_spaces import AsyncSpacesAPI
 from .async_tools import AsyncToolsAPI
@@ -9,6 +10,7 @@ from .async_skills import AsyncSkillsAPI
 from .async_users import AsyncUsersAPI
 from .blocks import BlocksAPI
 from .disks import DisksAPI, DiskArtifactsAPI
+from .sandboxes import SandboxesAPI
 from .sessions import SessionsAPI
 from .spaces import SpacesAPI
 from .tools import ToolsAPI
@@ -19,6 +21,7 @@ __all__ = [
     "DisksAPI",
     "DiskArtifactsAPI",
     "BlocksAPI",
+    "SandboxesAPI",
     "SessionsAPI",
     "SpacesAPI",
     "ToolsAPI",
@@ -27,6 +30,7 @@ __all__ = [
     "AsyncDisksAPI",
     "AsyncDiskArtifactsAPI",
     "AsyncBlocksAPI",
+    "AsyncSandboxesAPI",
     "AsyncSessionsAPI",
     "AsyncSpacesAPI",
     "AsyncToolsAPI",

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/resources/async_disks.py

@@ -287,3 +287,95 @@ class AsyncDiskArtifactsAPI:
             "GET", f"/disk/{disk_id}/artifact/glob", params=params
         )
         return [Artifact.model_validate(item) for item in data]
+
+    async def download_to_sandbox(
+        self,
+        disk_id: str,
+        *,
+        file_path: str,
+        filename: str,
+        sandbox_id: str,
+        sandbox_path: str,
+    ) -> bool:
+        """Download an artifact from disk storage to a sandbox environment.
+
+        Args:
+            disk_id: The UUID of the disk containing the artifact.
+            file_path: Directory path of the artifact (not including filename).
+            filename: The filename of the artifact.
+            sandbox_id: The UUID of the target sandbox.
+            sandbox_path: Destination directory in the sandbox.
+
+        Returns:
+            True if the download was successful.
+
+        Example:
+        ```python
+            success = await client.disks.artifacts.download_to_sandbox(
+                disk_id="disk-uuid",
+                file_path="/documents/",
+                filename="report.pdf",
+                sandbox_id="sandbox-uuid",
+                sandbox_path="/home/user/"
+            )
+            print(f"Success: {success}")
+        ```
+        """
+        payload = {
+            "file_path": file_path,
+            "filename": filename,
+            "sandbox_id": sandbox_id,
+            "sandbox_path": sandbox_path,
+        }
+        data = await self._requester.request(
+            "POST",
+            f"/disk/{disk_id}/artifact/download_to_sandbox",
+            json_data=payload,
+        )
+        return bool(data.get("success", False))
+
+    async def upload_from_sandbox(
+        self,
+        disk_id: str,
+        *,
+        sandbox_id: str,
+        sandbox_path: str,
+        sandbox_filename: str,
+        file_path: str,
+    ) -> Artifact:
+        """Upload a file from a sandbox environment to disk storage as an artifact.
+
+        Args:
+            disk_id: The UUID of the target disk.
+            sandbox_id: The UUID of the source sandbox.
+            sandbox_path: Source directory in the sandbox (not including filename).
+            sandbox_filename: Filename in the sandbox.
+            file_path: Destination directory path on the disk.
+
+        Returns:
+            Artifact containing the created artifact information.
+
+        Example:
+        ```python
+            artifact = await client.disks.artifacts.upload_from_sandbox(
+                disk_id="disk-uuid",
+                sandbox_id="sandbox-uuid",
+                sandbox_path="/home/user/",
+                sandbox_filename="output.txt",
+                file_path="/results/"
+            )
+            print(f"Created: {artifact.path}{artifact.filename}")
+        ```
+        """
+        payload = {
+            "sandbox_id": sandbox_id,
+            "sandbox_path": sandbox_path,
+            "sandbox_filename": sandbox_filename,
+            "file_path": file_path,
+        }
+        data = await self._requester.request(
+            "POST",
+            f"/disk/{disk_id}/artifact/upload_from_sandbox",
+            json_data=payload,
+        )
+        return Artifact.model_validate(data)

acontext-0.1.3/src/acontext/resources/async_sandboxes.py

@@ -0,0 +1,58 @@
+"""
+Sandboxes endpoints (async).
+"""
+
+from ..client_types import AsyncRequesterProtocol
+from ..types.sandbox import (
+    SandboxCommandOutput,
+    SandboxRuntimeInfo,
+)
+from ..types.tool import FlagResponse
+
+
+class AsyncSandboxesAPI:
+    def __init__(self, requester: AsyncRequesterProtocol) -> None:
+        self._requester = requester
+
+    async def create(self) -> SandboxRuntimeInfo:
+        """Create and start a new sandbox.
+
+        Returns:
+            SandboxRuntimeInfo containing the sandbox ID, status, and timestamps.
+        """
+        data = await self._requester.request("POST", "/sandbox")
+        return SandboxRuntimeInfo.model_validate(data)
+
+    async def exec_command(
+        self,
+        *,
+        sandbox_id: str,
+        command: str,
+    ) -> SandboxCommandOutput:
+        """Execute a shell command in the sandbox.
+
+        Args:
+            sandbox_id: The UUID of the sandbox.
+            command: The shell command to execute.
+
+        Returns:
+            SandboxCommandOutput containing stdout, stderr, and exit code.
+        """
+        data = await self._requester.request(
+            "POST",
+            f"/sandbox/{sandbox_id}/exec",
+            json_data={"command": command},
+        )
+        return SandboxCommandOutput.model_validate(data)
+
+    async def kill(self, sandbox_id: str) -> FlagResponse:
+        """Kill a running sandbox.
+
+        Args:
+            sandbox_id: The UUID of the sandbox to kill.
+
+        Returns:
+            FlagResponse with status and error message.
+        """
+        data = await self._requester.request("DELETE", f"/sandbox/{sandbox_id}")
+        return FlagResponse.model_validate(data)

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/resources/async_sessions.py

@@ -180,6 +180,47 @@ class AsyncSessionsAPI:
         )
         return GetTasksOutput.model_validate(data)
 
+    async def get_session_summary(
+        self,
+        session_id: str,
+        *,
+        limit: int | None = None,
+    ) -> str:
+        """Get a summary of all tasks in a session as a formatted string.
+
+        Args:
+            session_id: The UUID of the session.
+            limit: Maximum number of tasks to include in the summary. Defaults to None (all tasks).
+
+        Returns:
+            A formatted string containing the session summary with all task information.
+        """
+        tasks_output = await self.get_tasks(session_id, limit=limit, time_desc=False)
+        tasks = tasks_output.items
+
+        if not tasks:
+            return ""
+
+        parts: list[str] = []
+        for task in tasks:
+            task_lines = [
+                f'<task id="{task.order}" description="{task.data.task_description}">'
+            ]
+            if task.data.progresses:
+                task_lines.append("<progress>")
+                for i, p in enumerate(task.data.progresses, 1):
+                    task_lines.append(f"{i}. {p}")
+                task_lines.append("</progress>")
+            if task.data.user_preferences:
+                task_lines.append("<user_preference>")
+                for i, pref in enumerate(task.data.user_preferences, 1):
+                    task_lines.append(f"{i}. {pref}")
+                task_lines.append("</user_preference>")
+            task_lines.append("</task>")
+            parts.append("\n".join(task_lines))
+
+        return "\n".join(parts)
+
     async def store_message(
         self,
         session_id: str,
@@ -294,6 +335,7 @@ class AsyncSessionsAPI:
                 Each strategy is a dict with 'type' and 'params' keys.
                 Examples:
                     - Remove tool results: [{"type": "remove_tool_result", "params": {"keep_recent_n_tool_results": 3}}]
+                    - Middle out: [{"type": "middle_out", "params": {"token_reduce_to": 5000}}]
                     - Token limit: [{"type": "token_limit", "params": {"limit_tokens": 20000}}]
                 Defaults to None.
             pin_editing_strategies_at_message: Message ID to pin editing strategies at.

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/resources/disks.py

@@ -37,26 +37,28 @@ class DisksAPI:
         time_desc: bool | None = None,
     ) -> ListDisksOutput:
         """List all disks in the project.
-        
+
         Args:
             user: Filter by user identifier. Defaults to None.
             limit: Maximum number of disks to return. Defaults to None.
             cursor: Cursor for pagination. Defaults to None.
             time_desc: Order by created_at descending if True, ascending if False. Defaults to None.
-            
+
         Returns:
             ListDisksOutput containing the list of disks and pagination information.
         """
-        params = build_params(user=user, limit=limit, cursor=cursor, time_desc=time_desc)
+        params = build_params(
+            user=user, limit=limit, cursor=cursor, time_desc=time_desc
+        )
         data = self._requester.request("GET", "/disk", params=params or None)
         return ListDisksOutput.model_validate(data)
 
     def create(self, *, user: str | None = None) -> Disk:
         """Create a new disk.
-        
+
         Args:
             user: Optional user identifier string. Defaults to None.
-            
+
         Returns:
             The created Disk object.
         """
@@ -68,7 +70,7 @@ class DisksAPI:
 
     def delete(self, disk_id: str) -> None:
         """Delete a disk by its ID.
-        
+
         Args:
             disk_id: The UUID of the disk to delete.
         """
@@ -83,20 +85,22 @@ class DiskArtifactsAPI:
         self,
         disk_id: str,
         *,
-        file: FileUpload
-        | tuple[str, BinaryIO | bytes]
-        | tuple[str, BinaryIO | bytes, str],
+        file: (
+            FileUpload
+            | tuple[str, BinaryIO | bytes]
+            | tuple[str, BinaryIO | bytes, str]
+        ),
         file_path: str | None = None,
         meta: Mapping[str, Any] | None = None,
     ) -> Artifact:
         """Upload a file to create or update an artifact.
-        
+
         Args:
             disk_id: The UUID of the disk.
             file: The file to upload (FileUpload object or tuple format).
             file_path: Directory path (not including filename), defaults to "/".
             meta: Custom metadata as JSON-serializable dict, defaults to None.
-            
+
         Returns:
             Artifact containing the created/updated artifact information.
         """
@@ -126,7 +130,7 @@ class DiskArtifactsAPI:
         expire: int | None = None,
     ) -> GetArtifactResp:
         """Get an artifact by disk ID, file path, and filename.
-        
+
         Args:
             disk_id: The UUID of the disk.
             file_path: Directory path (not including filename).
@@ -134,7 +138,7 @@ class DiskArtifactsAPI:
             with_public_url: Whether to include a presigned public URL. Defaults to None.
             with_content: Whether to include file content. Defaults to None.
             expire: URL expiration time in seconds. Defaults to None.
-            
+
         Returns:
             GetArtifactResp containing the artifact and optionally public URL and content.
         """
@@ -145,7 +149,9 @@ class DiskArtifactsAPI:
             with_content=with_content,
             expire=expire,
         )
-        data = self._requester.request("GET", f"/disk/{disk_id}/artifact", params=params)
+        data = self._requester.request(
+            "GET", f"/disk/{disk_id}/artifact", params=params
+        )
         return GetArtifactResp.model_validate(data)
 
     def update(
@@ -157,13 +163,13 @@ class DiskArtifactsAPI:
         meta: Mapping[str, Any],
     ) -> UpdateArtifactResp:
         """Update an artifact's metadata.
-        
+
         Args:
             disk_id: The UUID of the disk.
             file_path: Directory path (not including filename).
             filename: The filename of the artifact.
             meta: Custom metadata as JSON-serializable dict.
-            
+
         Returns:
             UpdateArtifactResp containing the updated artifact information.
         """
@@ -172,7 +178,9 @@ class DiskArtifactsAPI:
             "file_path": full_path,
             "meta": json.dumps(cast(Mapping[str, Any], meta)),
         }
-        data = self._requester.request("PUT", f"/disk/{disk_id}/artifact", json_data=payload)
+        data = self._requester.request(
+            "PUT", f"/disk/{disk_id}/artifact", json_data=payload
+        )
         return UpdateArtifactResp.model_validate(data)
 
     def delete(
@@ -183,7 +191,7 @@ class DiskArtifactsAPI:
         filename: str,
     ) -> None:
         """Delete an artifact by disk ID, file path, and filename.
-        
+
         Args:
             disk_id: The UUID of the disk.
             file_path: Directory path (not including filename).
@@ -200,18 +208,20 @@ class DiskArtifactsAPI:
         path: str | None = None,
     ) -> ListArtifactsResp:
         """List artifacts in a disk at a specific path.
-        
+
         Args:
             disk_id: The UUID of the disk.
             path: Directory path to list. Defaults to None (root).
-            
+
         Returns:
             ListArtifactsResp containing the list of artifacts.
         """
         params: dict[str, Any] = {}
         if path is not None:
             params["path"] = path
-        data = self._requester.request("GET", f"/disk/{disk_id}/artifact/ls", params=params or None)
+        data = self._requester.request(
+            "GET", f"/disk/{disk_id}/artifact/ls", params=params or None
+        )
         return ListArtifactsResp.model_validate(data)
 
     def grep_artifacts(
@@ -222,15 +232,15 @@ class DiskArtifactsAPI:
         limit: int = 100,
     ) -> list[Artifact]:
         """Search artifact content using regex pattern.
-        
+
         Args:
             disk_id: The disk ID to search in
             query: Regex pattern to search for in file content
             limit: Maximum number of results (default 100, max 1000)
-            
+
         Returns:
             List of matching artifacts
-            
+
         Example:
         ```python
             # Search for TODO comments in code
@@ -242,9 +252,7 @@ class DiskArtifactsAPI:
         """
         params = build_params(query=query, limit=limit)
         data = self._requester.request(
-            "GET",
-            f"/disk/{disk_id}/artifact/grep",
-            params=params
+            "GET", f"/disk/{disk_id}/artifact/grep", params=params
         )
         return TypeAdapter(list[Artifact]).validate_python(data)
 
@@ -256,15 +264,15 @@ class DiskArtifactsAPI:
         limit: int = 100,
     ) -> list[Artifact]:
         """Search artifact paths using glob pattern.
-        
+
         Args:
             disk_id: The disk ID to search in
             query: Glob pattern (e.g., '**/*.py', '*.txt')
             limit: Maximum number of results (default 100, max 1000)
-            
+
         Returns:
             List of matching artifacts
-            
+
         Example:
         ```python
             # Find all Python files
@@ -276,8 +284,98 @@ class DiskArtifactsAPI:
         """
         params = build_params(query=query, limit=limit)
         data = self._requester.request(
-            "GET",
-            f"/disk/{disk_id}/artifact/glob",
-            params=params
+            "GET", f"/disk/{disk_id}/artifact/glob", params=params
         )
         return TypeAdapter(list[Artifact]).validate_python(data)
+
+    def download_to_sandbox(
+        self,
+        disk_id: str,
+        *,
+        file_path: str,
+        filename: str,
+        sandbox_id: str,
+        sandbox_path: str,
+    ) -> bool:
+        """Download an artifact from disk storage to a sandbox environment.
+
+        Args:
+            disk_id: The UUID of the disk containing the artifact.
+            file_path: Directory path of the artifact (not including filename).
+            filename: The filename of the artifact.
+            sandbox_id: The UUID of the target sandbox.
+            sandbox_path: Destination directory in the sandbox.
+
+        Returns:
+            True if the download was successful.
+
+        Example:
+        ```python
+            success = client.disks.artifacts.download_to_sandbox(
+                disk_id="disk-uuid",
+                file_path="/documents/",
+                filename="report.pdf",
+                sandbox_id="sandbox-uuid",
+                sandbox_path="/home/user/"
+            )
+            print(f"Success: {success}")
+        ```
+        """
+        payload = {
+            "file_path": file_path,
+            "filename": filename,
+            "sandbox_id": sandbox_id,
+            "sandbox_path": sandbox_path,
+        }
+        data = self._requester.request(
+            "POST",
+            f"/disk/{disk_id}/artifact/download_to_sandbox",
+            json_data=payload,
+        )
+        return bool(data.get("success", False))
+
+    def upload_from_sandbox(
+        self,
+        disk_id: str,
+        *,
+        sandbox_id: str,
+        sandbox_path: str,
+        sandbox_filename: str,
+        file_path: str,
+    ) -> Artifact:
+        """Upload a file from a sandbox environment to disk storage as an artifact.
+
+        Args:
+            disk_id: The UUID of the target disk.
+            sandbox_id: The UUID of the source sandbox.
+            sandbox_path: Source directory in the sandbox (not including filename).
+            sandbox_filename: Filename in the sandbox.
+            file_path: Destination directory path on the disk.
+
+        Returns:
+            Artifact containing the created artifact information.
+
+        Example:
+        ```python
+            artifact = client.disks.artifacts.upload_from_sandbox(
+                disk_id="disk-uuid",
+                sandbox_id="sandbox-uuid",
+                sandbox_path="/home/user/",
+                sandbox_filename="output.txt",
+                file_path="/results/"
+            )
+            print(f"Created: {artifact.path}{artifact.filename}")
+        ```
+        """
+        payload = {
+            "sandbox_id": sandbox_id,
+            "sandbox_path": sandbox_path,
+            "sandbox_filename": sandbox_filename,
+            "file_path": file_path,
+        }
+        data = self._requester.request(
+            "POST",
+            f"/disk/{disk_id}/artifact/upload_from_sandbox",
+            json_data=payload,
+        )
+        return Artifact.model_validate(data)

acontext-0.1.3/src/acontext/resources/sandboxes.py

@@ -0,0 +1,58 @@
+"""
+Sandboxes endpoints.
+"""
+
+from ..client_types import RequesterProtocol
+from ..types.sandbox import (
+    SandboxCommandOutput,
+    SandboxRuntimeInfo,
+)
+from ..types.tool import FlagResponse
+
+
+class SandboxesAPI:
+    def __init__(self, requester: RequesterProtocol) -> None:
+        self._requester = requester
+
+    def create(self) -> SandboxRuntimeInfo:
+        """Create and start a new sandbox.
+
+        Returns:
+            SandboxRuntimeInfo containing the sandbox ID, status, and timestamps.
+        """
+        data = self._requester.request("POST", "/sandbox")
+        return SandboxRuntimeInfo.model_validate(data)
+
+    def exec_command(
+        self,
+        *,
+        sandbox_id: str,
+        command: str,
+    ) -> SandboxCommandOutput:
+        """Execute a shell command in the sandbox.
+
+        Args:
+            sandbox_id: The UUID of the sandbox.
+            command: The shell command to execute.
+
+        Returns:
+            SandboxCommandOutput containing stdout, stderr, and exit code.
+        """
+        data = self._requester.request(
+            "POST",
+            f"/sandbox/{sandbox_id}/exec",
+            json_data={"command": command},
+        )
+        return SandboxCommandOutput.model_validate(data)
+
+    def kill(self, sandbox_id: str) -> FlagResponse:
+        """Kill a running sandbox.
+
+        Args:
+            sandbox_id: The UUID of the sandbox to kill.
+
+        Returns:
+            FlagResponse with status and error message.
+        """
+        data = self._requester.request("DELETE", f"/sandbox/{sandbox_id}")
+        return FlagResponse.model_validate(data)

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/resources/sessions.py

@@ -180,6 +180,47 @@ class SessionsAPI:
         )
         return GetTasksOutput.model_validate(data)
 
+    def get_session_summary(
+        self,
+        session_id: str,
+        *,
+        limit: int | None = None,
+    ) -> str:
+        """Get a summary of all tasks in a session as a formatted string.
+
+        Args:
+            session_id: The UUID of the session.
+            limit: Maximum number of tasks to include in the summary. Defaults to None (all tasks).
+
+        Returns:
+            A formatted string containing the session summary with all task information.
+        """
+        tasks_output = self.get_tasks(session_id, limit=limit, time_desc=False)
+        tasks = tasks_output.items
+
+        if not tasks:
+            return ""
+
+        parts: list[str] = []
+        for task in tasks:
+            task_lines = [
+                f'<task id="{task.order}" description="{task.data.task_description}">'
+            ]
+            if task.data.progresses:
+                task_lines.append("<progress>")
+                for i, p in enumerate(task.data.progresses, 1):
+                    task_lines.append(f"{i}. {p}")
+                task_lines.append("</progress>")
+            if task.data.user_preferences:
+                task_lines.append("<user_preference>")
+                for i, pref in enumerate(task.data.user_preferences, 1):
+                    task_lines.append(f"{i}. {pref}")
+                task_lines.append("</user_preference>")
+            task_lines.append("</task>")
+            parts.append("\n".join(task_lines))
+
+        return "\n".join(parts)
+
     def store_message(
         self,
         session_id: str,
@@ -294,6 +335,7 @@ class SessionsAPI:
                 Each strategy is a dict with 'type' and 'params' keys.
                 Examples:
                     - Remove tool results: [{"type": "remove_tool_result", "params": {"keep_recent_n_tool_results": 3}}]
+                    - Middle out: [{"type": "middle_out", "params": {"token_reduce_to": 5000}}]
                     - Token limit: [{"type": "token_limit", "params": {"limit_tokens": 20000}}]
                 Defaults to None.
             pin_editing_strategies_at_message: Message ID to pin editing strategies at.
@@ -320,7 +362,9 @@ class SessionsAPI:
         if edit_strategies is not None:
             params["edit_strategies"] = json.dumps(edit_strategies)
         if pin_editing_strategies_at_message is not None:
-            params["pin_editing_strategies_at_message"] = pin_editing_strategies_at_message
+            params["pin_editing_strategies_at_message"] = (
+                pin_editing_strategies_at_message
+            )
         data = self._requester.request(
             "GET", f"/session/{session_id}/messages", params=params or None
         )
@@ -366,20 +410,19 @@ 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, 
+            MessageObservingStatus object containing observed, in_process,
             pending counts and updated_at timestamp.
         """
-        data = self._requester.request(
-            "GET", f"/session/{session_id}/observing_status"
-        )
+        data = self._requester.request("GET", f"/session/{session_id}/observing_status")
         return MessageObservingStatus.model_validate(data)

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/types/__init__.py

@@ -45,6 +45,10 @@ from .skill import (
     Skill,
     SkillCatalogItem,
 )
+from .sandbox import (
+    SandboxCommandOutput,
+    SandboxRuntimeInfo,
+)
 from .user import (
     GetUserResourcesOutput,
     ListUsersOutput,
@@ -94,6 +98,9 @@ __all__ = [
     "SkillCatalogItem",
     "ListSkillsOutput",
     "GetSkillFileResp",
+    # Sandbox types
+    "SandboxCommandOutput",
+    "SandboxRuntimeInfo",
     # User types
     "GetUserResourcesOutput",
     "ListUsersOutput",

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/types/disk.py

@@ -43,8 +43,12 @@ class GetArtifactResp(BaseModel):
     """Response model for getting an artifact."""
 
     artifact: Artifact = Field(..., description="Artifact information")
-    public_url: str | None = Field(None, description="Presigned URL for downloading the artifact")
-    content: FileContent | None = Field(None, description="Parsed file content if available")
+    public_url: str | None = Field(
+        None, description="Presigned URL for downloading the artifact"
+    )
+    content: FileContent | None = Field(
+        None, description="Parsed file content if available"
+    )
 
 
 class ListArtifactsResp(BaseModel):
@@ -58,4 +62,3 @@ class UpdateArtifactResp(BaseModel):
     """Response model for updating an artifact."""
 
     artifact: Artifact = Field(..., description="Updated artifact information")
-

acontext-0.1.3/src/acontext/types/sandbox.py

@@ -0,0 +1,20 @@
+"""Type definitions for sandbox resources."""
+
+from pydantic import BaseModel, Field
+
+
+class SandboxRuntimeInfo(BaseModel):
+    """Runtime information about a sandbox."""
+
+    sandbox_id: str = Field(..., description="Sandbox ID")
+    sandbox_status: str = Field(..., description="Sandbox status (running, killed, paused, error)")
+    sandbox_created_at: str = Field(..., description="ISO 8601 formatted creation timestamp")
+    sandbox_expires_at: str = Field(..., description="ISO 8601 formatted expiration timestamp")
+
+
+class SandboxCommandOutput(BaseModel):
+    """Output from executing a command in a sandbox."""
+
+    stdout: str = Field(..., description="Standard output from the command")
+    stderr: str = Field(..., description="Standard error from the command")
+    exit_code: int = Field(..., description="Exit code of the command")

{acontext-0.1.1 → acontext-0.1.3}/src/acontext/types/session.py

@@ -89,10 +89,34 @@ class TokenLimitStrategy(TypedDict):
     params: TokenLimitParams
 
 
+class MiddleOutParams(TypedDict):
+    """Parameters for the middle_out edit strategy.
+
+    Attributes:
+        token_reduce_to: Target token count to reduce the prompt to. Required parameter.
+    """
+
+    token_reduce_to: int
+
+
+class MiddleOutStrategy(TypedDict):
+    """Edit strategy to reduce prompt size by removing middle messages.
+
+    Example:
+        {"type": "middle_out", "params": {"token_reduce_to": 5000}}
+    """
+
+    type: Literal["middle_out"]
+    params: MiddleOutParams
+
+
 # Union type for all edit strategies
 # When adding new strategies, add them to this Union: EditStrategy = Union[RemoveToolResultStrategy, OtherStrategy, ...]
 EditStrategy = Union[
-    RemoveToolResultStrategy, RemoveToolCallParamsStrategy, TokenLimitStrategy
+    RemoveToolResultStrategy,
+    RemoveToolCallParamsStrategy,
+    TokenLimitStrategy,
+    MiddleOutStrategy,
 ]