acontext 0.1.6__py3-none-any.whl → 0.1.8__py3-none-any.whl

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/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/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/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/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/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/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/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/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.dist-info → acontext-0.1.8.dist-info}/METADATA

@@ -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.dist-info → acontext-0.1.8.dist-info}/RECORD

@@ -8,34 +8,31 @@ acontext/agent/prompts.py,sha256=awhYYClNAROnTAfzKKD8G5gHfTFs-1KqMUEWCEnlMMQ,495
 acontext/agent/sandbox.py,sha256=ziGGs2yqJaik_9o7S3f9G-CzcndmRs9fC3WDUi_UGbI,19016
 acontext/agent/skill.py,sha256=uB7teH7OAk4Cy6pOLRCJFBi5KZbyMMgZSLEt77TLB20,12880
 acontext/agent/text_editor.py,sha256=mrUtMfAtgpOOwYnh2xQpWRc0lCoE9u2_WMTVRuFiWRQ,13390
-acontext/async_client.py,sha256=WjqW7ruMtlYTBlk6PQ1-1yhjFSBBxGqI3oxrfEqqIpQ,8471
-acontext/client.py,sha256=XggELxXU9-8BcAcHOoiqQZypfPmkhe7SyJ3plHq-A9M,8217
+acontext/async_client.py,sha256=QpWPMkX9TeV41un8Y975Bu7M8EWlstETVOIoiQdDaMs,8364
+acontext/client.py,sha256=pD9FWVio9GM2qNexZ2Mp-S_iGyr7dkX6D4ge4Km9cB0,8131
 acontext/client_types.py,sha256=oR6lSDMjEERx0mIVOpKaTXbEu_lfoxe3fDpzA-ALE-8,1063
 acontext/errors.py,sha256=W9i7_t46q9kbci3XAyZiyQhS154d4R9rSon3na-gjgs,1296
 acontext/messages.py,sha256=oNRZStfhcPFt6DPOfs_-Q7R1Xui6dOMr3wmpmC8pzvE,2310
 acontext/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-acontext/resources/__init__.py,sha256=i2_12EUfxo2z-dgMu8dyAsEiT9nf2P00voN2_vMZ2K8,843
+acontext/resources/__init__.py,sha256=NN5rlry2o_GdqxbiKq0oeVLi6NE6i1k0MwA0Nw0MOO8,739
 acontext/resources/async_disks.py,sha256=rc8hSdVsZ1UbrK2kwxmEMZyP0aEMsvjyZ70cYddpiF8,12051
-acontext/resources/async_sandboxes.py,sha256=qkpEhmUUUrq_C1mVSVyUzBvxzBdq6BvL9e76FXyk19M,2850
-acontext/resources/async_sessions.py,sha256=wBUUIDUvMqe_mdR3l_3HuPfEWUcq65SOJLc5mKTu0nI,14691
+acontext/resources/async_sandboxes.py,sha256=GC-HhkgNl70P4W-eD9lSRE-aPYoOPqRes_9hvGvQf9g,2852
+acontext/resources/async_sessions.py,sha256=UhnAFh13wJrvXBqFeK1bTXsdT5YAj-q3LDQ96_IhJvA,15921
 acontext/resources/async_skills.py,sha256=eRn3NjBhR6_6GmEyZO_nKc0OnHgR_TeIHxqGX_73lwo,5999
-acontext/resources/async_tools.py,sha256=RbGaF2kX65Mun-q-Fp5H1J8waWTLIdCOfbdY19jpn1o,1091
 acontext/resources/async_users.py,sha256=CjW_Xz-UnNf449Hr1j3YeGgtIVZi2ePY5-r7Uj3wMIc,2005
 acontext/resources/disks.py,sha256=YyAzm6A00T4A3dI8YTEAOxwm6bnCnp8gWIoZ4lLGN5w,11859
-acontext/resources/sandboxes.py,sha256=2E9Ls15t3FQ9LBZOnk0--IjQhxwZGTPkbpS5zcnOJSo,2779
-acontext/resources/sessions.py,sha256=yaFwiWsShM4HVguwsM-Mp9HHJohl84R-LOFp8uGJUyU,14454
+acontext/resources/sandboxes.py,sha256=BWaSK2MrkVvKgVeHJZyIbvaiEqXREIa7X5LJxOoxUts,2781
+acontext/resources/sessions.py,sha256=wdrTi8c_6PsgA9X4izLOuU4xV7MDONV-wExWWUb_LJo,15678
 acontext/resources/skills.py,sha256=CZFgJhRDtGlbDcTBKNxFkG4DlqoaJb0c_ymfV12QKdM,5930
-acontext/resources/tools.py,sha256=II_185B0HYKSP43hizE6C1zs7kjkkPLKihuEG8s-DRY,1046
 acontext/resources/users.py,sha256=vZfBHd2ARmd9d5d8n5rLaMUT5z2bMO82k7OcqMaFqxk,1946
-acontext/types/__init__.py,sha256=rZHoT0gWIQ576J2mGqhyqWu4Uh8jn0HINdhNJwbjZ8U,1725
-acontext/types/common.py,sha256=5kLwzszlIofz8qZ9-Wj_zcBBiF22mAWgH9uWPkcgWCE,327
+acontext/types/__init__.py,sha256=Qwz8d8Z060bSRWaR5QavgVoQviBHqQ9UqvDme_nbDpM,1611
+acontext/types/common.py,sha256=CbJdF8c9jbSCtDhVTxCLOzXaSe836C_AUrmMEFA8aHA,563
 acontext/types/disk.py,sha256=jdQqQ8HF3cwl_Y1dh98TOXZKfcdN_gSzaSrCE8PKT-0,2250
 acontext/types/sandbox.py,sha256=vbgpwjbVjjY3uwXxSbOP8IfC65lhkJ_4BYA19dqj5FE,2248
 acontext/types/session.py,sha256=WqhEtrg1jwknIiQ9TipUeLONS4bY_J_C7Xd_TrYlsWg,11003
 acontext/types/skill.py,sha256=v7OAvtkwTeZAkLG7NQMcwFoSJ4g-HDWjPZ4EoMyU3mk,2779
-acontext/types/tool.py,sha256=UlX6JIGRKd96vPayOkyi6pGwFi6w9GwWwAxr4BcqVts,670
 acontext/types/user.py,sha256=dBzHCqULSJ3Sqw7T8nA0U8Sctz76Pd0hm1qsHvtEIBQ,1264
 acontext/uploads.py,sha256=6twnqQOY_eerNuEjeSKsE_3S0IfJUiczXtAy4aXqDl8,1379
-acontext-0.1.6.dist-info/WHEEL,sha256=e_m4S054HL0hyR3CpOk-b7Q7fDX6BuFkgL5OjAExXas,80
-acontext-0.1.6.dist-info/METADATA,sha256=xUgSw00x4t4EHQR7WLgfwlnjEgXJjD1LH2mk4t_KKSo,888
-acontext-0.1.6.dist-info/RECORD,,
+acontext-0.1.8.dist-info/WHEEL,sha256=fAguSjoiATBe7TNBkJwOjyL1Tt4wwiaQGtNtjRPNMQA,80
+acontext-0.1.8.dist-info/METADATA,sha256=oWNmr7kXtegIBZRwOwYR2bkb_gL0Ms0vp55fO0EPtqQ,888
+acontext-0.1.8.dist-info/RECORD,,

{acontext-0.1.6.dist-info → acontext-0.1.8.dist-info}/WHEEL

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

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/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/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")
-