acontext 0.1.6__tar.gz → 0.1.8__tar.gz

{acontext-0.1.6 → acontext-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acontext
-Version: 0.1.6
+Version: 0.1.8
 Summary: Python SDK for the Acontext API
 Keywords: acontext,sdk,client,api
 Requires-Dist: httpx>=0.28.1

{acontext-0.1.6 → acontext-0.1.8}/pyproject.toml

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

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/async_client.py

@@ -15,7 +15,6 @@ from .uploads import FileUpload as FileUpload
 from .resources.async_disks import AsyncDisksAPI as AsyncDisksAPI
 from .resources.async_sandboxes import AsyncSandboxesAPI as AsyncSandboxesAPI
 from .resources.async_sessions import AsyncSessionsAPI as AsyncSessionsAPI
-from .resources.async_tools import AsyncToolsAPI as AsyncToolsAPI
 from .resources.async_skills import AsyncSkillsAPI as AsyncSkillsAPI
 from .resources.async_users import AsyncUsersAPI as AsyncUsersAPI
 
@@ -107,7 +106,6 @@ class AcontextAsyncClient:
         self.sessions = AsyncSessionsAPI(self)
         self.disks = AsyncDisksAPI(self)
         self.artifacts = self.disks.artifacts
-        self.tools = AsyncToolsAPI(self)
         self.skills = AsyncSkillsAPI(self)
         self.users = AsyncUsersAPI(self)
         self.sandboxes = AsyncSandboxesAPI(self)

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/client.py

@@ -15,7 +15,6 @@ from .uploads import FileUpload as FileUpload
 from .resources.disks import DisksAPI as DisksAPI
 from .resources.sandboxes import SandboxesAPI as SandboxesAPI
 from .resources.sessions import SessionsAPI as SessionsAPI
-from .resources.tools import ToolsAPI as ToolsAPI
 from .resources.skills import SkillsAPI as SkillsAPI
 from .resources.users import UsersAPI as UsersAPI
 
@@ -107,7 +106,6 @@ class AcontextClient:
         self.sessions = SessionsAPI(self)
         self.disks = DisksAPI(self)
         self.artifacts = self.disks.artifacts
-        self.tools = ToolsAPI(self)
         self.skills = SkillsAPI(self)
         self.users = UsersAPI(self)
         self.sandboxes = SandboxesAPI(self)

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/resources/__init__.py

@@ -3,13 +3,11 @@
 from .async_disks import AsyncDisksAPI, AsyncDiskArtifactsAPI
 from .async_sandboxes import AsyncSandboxesAPI
 from .async_sessions import AsyncSessionsAPI
-from .async_tools import AsyncToolsAPI
 from .async_skills import AsyncSkillsAPI
 from .async_users import AsyncUsersAPI
 from .disks import DisksAPI, DiskArtifactsAPI
 from .sandboxes import SandboxesAPI
 from .sessions import SessionsAPI
-from .tools import ToolsAPI
 from .skills import SkillsAPI
 from .users import UsersAPI
 
@@ -18,14 +16,12 @@ __all__ = [
     "DiskArtifactsAPI",
     "SandboxesAPI",
     "SessionsAPI",
-    "ToolsAPI",
     "SkillsAPI",
     "UsersAPI",
     "AsyncDisksAPI",
     "AsyncDiskArtifactsAPI",
     "AsyncSandboxesAPI",
     "AsyncSessionsAPI",
-    "AsyncToolsAPI",
     "AsyncSkillsAPI",
     "AsyncUsersAPI",
 ]

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/resources/async_sandboxes.py

@@ -9,7 +9,7 @@ from ..types.sandbox import (
     SandboxCommandOutput,
     SandboxRuntimeInfo,
 )
-from ..types.tool import FlagResponse
+from ..types.common import FlagResponse
 
 
 class AsyncSandboxesAPI:

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/resources/async_sessions.py

@@ -40,6 +40,7 @@ class AsyncSessionsAPI:
         limit: int | None = None,
         cursor: str | None = None,
         time_desc: bool | None = None,
+        filter_by_configs: Mapping[str, Any] | None = None,
     ) -> ListSessionsOutput:
         """List all sessions in the project.
 
@@ -48,13 +49,25 @@ class AsyncSessionsAPI:
             limit: Maximum number of sessions 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.
+            filter_by_configs: Filter by session configs using JSONB containment.
+                Only sessions where configs contains all key-value pairs in this
+                dict will be returned. Supports nested objects.
+                Note: Matching is case-sensitive and type-sensitive.
+                Sessions with NULL configs are excluded from filtered results.
+                Defaults to None.
 
         Returns:
             ListSessionsOutput containing the list of sessions and pagination information.
+
+        Example:
+            >>> sessions = await client.sessions.list(filter_by_configs={"agent": "bot1"})
         """
         params: dict[str, Any] = {}
         if user:
             params["user"] = user
+        # Handle filter_by_configs - JSON encode, skip empty dict
+        if filter_by_configs is not None and len(filter_by_configs) > 0:
+            params["filter_by_configs"] = json.dumps(filter_by_configs)
         params.update(
             build_params(
                 limit=limit,
@@ -71,6 +84,7 @@ class AsyncSessionsAPI:
         user: str | None = None,
         disable_task_tracking: bool | None = None,
         configs: Mapping[str, Any] | None = None,
+        use_uuid: str | None = None,
     ) -> Session:
         """Create a new session.
 
@@ -78,9 +92,14 @@ class AsyncSessionsAPI:
             user: Optional user identifier string. Defaults to None.
             disable_task_tracking: Whether to disable task tracking for this session. Defaults to None (server default: False).
             configs: Optional session configuration dictionary. Defaults to None.
+            use_uuid: Optional UUID string to use as the session ID. If not provided, a UUID will be auto-generated.
+                If a session with this UUID already exists, a 409 Conflict error will be raised.
 
         Returns:
             The created Session object.
+
+        Raises:
+            AcontextAPIError: If use_uuid is invalid or a session with this UUID already exists.
         """
         payload: dict[str, Any] = {}
         if user:
@@ -89,6 +108,8 @@ class AsyncSessionsAPI:
             payload["disable_task_tracking"] = disable_task_tracking
         if configs is not None:
             payload["configs"] = configs
+        if use_uuid is not None:
+            payload["use_uuid"] = use_uuid
         data = await self._requester.request("POST", "/session", json_data=payload)
         return Session.model_validate(data)
 

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/resources/sandboxes.py

@@ -9,7 +9,7 @@ from ..types.sandbox import (
     SandboxCommandOutput,
     SandboxRuntimeInfo,
 )
-from ..types.tool import FlagResponse
+from ..types.common import FlagResponse
 
 
 class SandboxesAPI:

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/resources/sessions.py

@@ -40,6 +40,7 @@ class SessionsAPI:
         limit: int | None = None,
         cursor: str | None = None,
         time_desc: bool | None = None,
+        filter_by_configs: Mapping[str, Any] | None = None,
     ) -> ListSessionsOutput:
         """List all sessions in the project.
 
@@ -48,13 +49,25 @@ class SessionsAPI:
             limit: Maximum number of sessions 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.
+            filter_by_configs: Filter by session configs using JSONB containment.
+                Only sessions where configs contains all key-value pairs in this
+                dict will be returned. Supports nested objects.
+                Note: Matching is case-sensitive and type-sensitive.
+                Sessions with NULL configs are excluded from filtered results.
+                Defaults to None.
 
         Returns:
             ListSessionsOutput containing the list of sessions and pagination information.
+
+        Example:
+            >>> sessions = client.sessions.list(filter_by_configs={"agent": "bot1"})
         """
         params: dict[str, Any] = {}
         if user:
             params["user"] = user
+        # Handle filter_by_configs - JSON encode, skip empty dict
+        if filter_by_configs is not None and len(filter_by_configs) > 0:
+            params["filter_by_configs"] = json.dumps(filter_by_configs)
         params.update(
             build_params(
                 limit=limit,
@@ -71,6 +84,7 @@ class SessionsAPI:
         user: str | None = None,
         disable_task_tracking: bool | None = None,
         configs: Mapping[str, Any] | None = None,
+        use_uuid: str | None = None,
     ) -> Session:
         """Create a new session.
 
@@ -78,9 +92,14 @@ class SessionsAPI:
             user: Optional user identifier string. Defaults to None.
             disable_task_tracking: Whether to disable task tracking for this session. Defaults to None (server default: False).
             configs: Optional session configuration dictionary. Defaults to None.
+            use_uuid: Optional UUID string to use as the session ID. If not provided, a UUID will be auto-generated.
+                If a session with this UUID already exists, a 409 Conflict error will be raised.
 
         Returns:
             The created Session object.
+
+        Raises:
+            AcontextAPIError: If use_uuid is invalid or a session with this UUID already exists.
         """
         payload: dict[str, Any] = {}
         if user:
@@ -89,6 +108,8 @@ class SessionsAPI:
             payload["disable_task_tracking"] = disable_task_tracking
         if configs is not None:
             payload["configs"] = configs
+        if use_uuid is not None:
+            payload["use_uuid"] = use_uuid
         data = self._requester.request("POST", "/session", json_data=payload)
         return Session.model_validate(data)
 

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/types/__init__.py

@@ -1,6 +1,6 @@
 """Type definitions for API responses."""
 
-from .common import FileContent
+from .common import FileContent, FlagResponse
 from .disk import (
     Artifact,
     Disk,
@@ -22,11 +22,6 @@ from .session import (
     TaskData,
     TokenCounts,
 )
-from .tool import (
-    FlagResponse,
-    ToolReferenceData,
-    ToolRenameItem,
-)
 from .skill import (
     FileInfo,
     GetSkillFileResp,
@@ -50,10 +45,12 @@ from .user import (
 )
 
 __all__ = [
+    # Common types
+    "FileContent",
+    "FlagResponse",
     # Disk types
     "Artifact",
     "Disk",
-    "FileContent",
     "GetArtifactResp",
     "ListArtifactsResp",
     "ListDisksOutput",
@@ -70,10 +67,6 @@ __all__ = [
     "Task",
     "TaskData",
     "TokenCounts",
-    # Tool types
-    "FlagResponse",
-    "ToolReferenceData",
-    "ToolRenameItem",
     # Skill types
     "FileInfo",
     "Skill",

{acontext-0.1.6 → acontext-0.1.8}/src/acontext/types/common.py

@@ -9,3 +9,10 @@ class FileContent(BaseModel):
     type: str = Field(..., description="File content type: 'text', 'json', 'csv', or 'code'")
     raw: str = Field(..., description="Raw text content of the file")
 
+
+class FlagResponse(BaseModel):
+    """Response model for flag operations like kill sandbox."""
+
+    status: int = Field(..., description="Status code of the operation")
+    errmsg: str = Field(..., description="Error message if any")
+

acontext-0.1.6/src/acontext/resources/async_tools.py

@@ -1,34 +0,0 @@
-"""Async tool endpoints."""
-
-from ..client_types import AsyncRequesterProtocol
-from ..types.tool import FlagResponse, ToolReferenceData
-
-
-class AsyncToolsAPI:
-    def __init__(self, requester: AsyncRequesterProtocol) -> None:
-        self._requester = requester
-
-    async def rename_tool_name(
-        self, *, rename: list[dict[str, str]]
-    ) -> FlagResponse:
-        """Rename tool names within a project.
-
-        Args:
-            rename: List of dictionaries with old_name and new_name keys.
-
-        Returns:
-            FlagResponse containing status and errmsg fields.
-        """
-        payload = {"rename": rename}
-        data = await self._requester.request("PUT", "/tool/name", json_data=payload)
-        return FlagResponse.model_validate(data)
-
-    async def get_tool_name(self) -> list[ToolReferenceData]:
-        """Get all tool names within a project.
-
-        Returns:
-            List of ToolReferenceData objects.
-        """
-        data = await self._requester.request("GET", "/tool/name")
-        return [ToolReferenceData.model_validate(item) for item in data]
-

acontext-0.1.6/src/acontext/resources/tools.py

@@ -1,34 +0,0 @@
-"""Tool endpoints."""
-
-from ..client_types import RequesterProtocol
-from ..types.tool import FlagResponse, ToolReferenceData
-
-
-class ToolsAPI:
-    def __init__(self, requester: RequesterProtocol) -> None:
-        self._requester = requester
-
-    def rename_tool_name(
-        self, *, rename: list[dict[str, str]]
-    ) -> FlagResponse:
-        """Rename tool names within a project.
-
-        Args:
-            rename: List of dictionaries with old_name and new_name keys.
-
-        Returns:
-            FlagResponse containing status and errmsg fields.
-        """
-        payload = {"rename": rename}
-        data = self._requester.request("PUT", "/tool/name", json_data=payload)
-        return FlagResponse.model_validate(data)
-
-    def get_tool_name(self) -> list[ToolReferenceData]:
-        """Get all tool names within a project.
-
-        Returns:
-            List of ToolReferenceData objects.
-        """
-        data = self._requester.request("GET", "/tool/name")
-        return [ToolReferenceData.model_validate(item) for item in data]
-

acontext-0.1.6/src/acontext/types/tool.py

@@ -1,25 +0,0 @@
-"""Type definitions for tool resources."""
-
-from pydantic import BaseModel, Field
-
-
-class FlagResponse(BaseModel):
-    """Flag response with status and error message."""
-
-    status: int = Field(..., description="Status code")
-    errmsg: str = Field(..., description="Error message")
-
-
-class ToolReferenceData(BaseModel):
-    """Tool reference data."""
-
-    name: str = Field(..., description="Tool name")
-    sop_count: int = Field(..., description="Number of SOPs using this tool")
-
-
-class ToolRenameItem(BaseModel):
-    """Tool rename item."""
-
-    old_name: str = Field(..., description="Old tool name")
-    new_name: str = Field(..., description="New tool name")
-