acontext 0.1.7__tar.gz → 0.1.9__tar.gz

{acontext-0.1.7 → acontext-0.1.9}/PKG-INFO

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

{acontext-0.1.7 → acontext-0.1.9}/pyproject.toml

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

{acontext-0.1.7 → acontext-0.1.9}/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.7 → acontext-0.1.9}/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.7 → acontext-0.1.9}/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.7 → acontext-0.1.9}/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.7 → acontext-0.1.9}/src/acontext/resources/async_sessions.py

@@ -84,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.
 
@@ -91,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:
@@ -102,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)
 
@@ -216,6 +224,7 @@ class AsyncSessionsAPI:
         *,
         blob: MessageBlob,
         format: Literal["acontext", "openai", "anthropic", "gemini"] = "openai",
+        meta: dict[str, Any] | None = None,
         file_field: str | None = None,
         file: (
             FileUpload
@@ -230,12 +239,15 @@ class AsyncSessionsAPI:
             session_id: The UUID of the session.
             blob: The message blob in Acontext, OpenAI, Anthropic, or Gemini format.
             format: The format of the message blob. Defaults to "openai".
+            meta: Optional user-provided metadata for the message. This metadata is stored
+                separately from the message content and can be retrieved via get_messages().metas
+                or updated via patch_message_meta(). Works with all formats.
             file_field: The field name for file upload. Only used when format is "acontext".
                 Required if file is provided. Defaults to None.
             file: Optional file upload. Only used when format is "acontext". Defaults to None.
 
         Returns:
-            The created Message object.
+            The created Message object. The msg.meta field contains only user-provided metadata.
 
         Raises:
             ValueError: If format is invalid, file/file_field provided for non-acontext format,
@@ -256,6 +268,9 @@ class AsyncSessionsAPI:
         payload: dict[str, Any] = {
             "format": format,
         }
+        if meta is not None:
+            payload["meta"] = meta
+
         if format == "acontext":
             if isinstance(blob, Mapping):
                 payload["blob"] = blob
@@ -404,3 +419,83 @@ class AsyncSessionsAPI:
             "GET", f"/session/{session_id}/observing_status"
         )
         return MessageObservingStatus.model_validate(data)
+
+    async def patch_message_meta(
+        self,
+        session_id: str,
+        message_id: str,
+        *,
+        meta: dict[str, Any],
+    ) -> dict[str, Any]:
+        """Update message metadata using patch semantics.
+
+        Only updates keys present in the meta dict. Existing keys not in the request
+        are preserved. To delete a key, pass None as its value.
+
+        Args:
+            session_id: The UUID of the session.
+            message_id: The UUID of the message.
+            meta: Dictionary of metadata keys to add, update, or delete.
+                Pass None as a value to delete that key.
+
+        Returns:
+            The complete user metadata after the patch operation.
+
+        Example:
+            >>> # Add/update keys
+            >>> updated = await client.sessions.patch_message_meta(
+            ...     session_id, message_id,
+            ...     meta={"status": "processed", "score": 0.95}
+            ... )
+            >>> # Delete a key
+            >>> updated = await client.sessions.patch_message_meta(
+            ...     session_id, message_id,
+            ...     meta={"old_key": None}  # Deletes "old_key"
+            ... )
+        """
+        payload = {"meta": meta}
+        data = await self._requester.request(
+            "PATCH",
+            f"/session/{session_id}/messages/{message_id}/meta",
+            json_data=payload,
+        )
+        return data.get("meta", {})  # type: ignore
+
+    async def patch_configs(
+        self,
+        session_id: str,
+        *,
+        configs: dict[str, Any],
+    ) -> dict[str, Any]:
+        """Update session configs using patch semantics.
+
+        Only updates keys present in the configs dict. Existing keys not in the request
+        are preserved. To delete a key, pass None as its value.
+
+        Args:
+            session_id: The UUID of the session.
+            configs: Dictionary of config keys to add, update, or delete.
+                Pass None as a value to delete that key.
+
+        Returns:
+            The complete configs after the patch operation.
+
+        Example:
+            >>> # Add/update keys
+            >>> updated = await client.sessions.patch_configs(
+            ...     session_id,
+            ...     configs={"agent": "bot2", "temperature": 0.8}
+            ... )
+            >>> # Delete a key
+            >>> updated = await client.sessions.patch_configs(
+            ...     session_id,
+            ...     configs={"old_key": None}  # Deletes "old_key"
+            ... )
+        """
+        payload = {"configs": configs}
+        data = await self._requester.request(
+            "PATCH",
+            f"/session/{session_id}/configs",
+            json_data=payload,
+        )
+        return data.get("configs", {})  # type: ignore

{acontext-0.1.7 → acontext-0.1.9}/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.7 → acontext-0.1.9}/src/acontext/resources/sessions.py

@@ -84,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.
 
@@ -91,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:
@@ -102,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)
 
@@ -216,6 +224,7 @@ class SessionsAPI:
         *,
         blob: MessageBlob,
         format: Literal["acontext", "openai", "anthropic", "gemini"] = "openai",
+        meta: dict[str, Any] | None = None,
         file_field: str | None = None,
         file: (
             FileUpload
@@ -230,12 +239,15 @@ class SessionsAPI:
             session_id: The UUID of the session.
             blob: The message blob in Acontext, OpenAI, Anthropic, or Gemini format.
             format: The format of the message blob. Defaults to "openai".
+            meta: Optional user-provided metadata for the message. This metadata is stored
+                separately from the message content and can be retrieved via get_messages().metas
+                or updated via patch_message_meta(). Works with all formats.
             file_field: The field name for file upload. Only used when format is "acontext".
                 Required if file is provided. Defaults to None.
             file: Optional file upload. Only used when format is "acontext". Defaults to None.
 
         Returns:
-            The created Message object.
+            The created Message object. The msg.meta field contains only user-provided metadata.
 
         Raises:
             ValueError: If format is invalid, file/file_field provided for non-acontext format,
@@ -257,6 +269,9 @@ class SessionsAPI:
         payload: dict[str, Any] = {
             "format": format,
         }
+        if meta is not None:
+            payload["meta"] = meta
+
         if format == "acontext":
             if isinstance(blob, Mapping):
                 payload["blob"] = blob
@@ -398,3 +413,83 @@ class SessionsAPI:
         """
         data = self._requester.request("GET", f"/session/{session_id}/observing_status")
         return MessageObservingStatus.model_validate(data)
+
+    def patch_message_meta(
+        self,
+        session_id: str,
+        message_id: str,
+        *,
+        meta: dict[str, Any],
+    ) -> dict[str, Any]:
+        """Update message metadata using patch semantics.
+
+        Only updates keys present in the meta dict. Existing keys not in the request
+        are preserved. To delete a key, pass None as its value.
+
+        Args:
+            session_id: The UUID of the session.
+            message_id: The UUID of the message.
+            meta: Dictionary of metadata keys to add, update, or delete.
+                Pass None as a value to delete that key.
+
+        Returns:
+            The complete user metadata after the patch operation.
+
+        Example:
+            >>> # Add/update keys
+            >>> updated = client.sessions.patch_message_meta(
+            ...     session_id, message_id,
+            ...     meta={"status": "processed", "score": 0.95}
+            ... )
+            >>> # Delete a key
+            >>> updated = client.sessions.patch_message_meta(
+            ...     session_id, message_id,
+            ...     meta={"old_key": None}  # Deletes "old_key"
+            ... )
+        """
+        payload = {"meta": meta}
+        data = self._requester.request(
+            "PATCH",
+            f"/session/{session_id}/messages/{message_id}/meta",
+            json_data=payload,
+        )
+        return data.get("meta", {})  # type: ignore
+
+    def patch_configs(
+        self,
+        session_id: str,
+        *,
+        configs: dict[str, Any],
+    ) -> dict[str, Any]:
+        """Update session configs using patch semantics.
+
+        Only updates keys present in the configs dict. Existing keys not in the request
+        are preserved. To delete a key, pass None as its value.
+
+        Args:
+            session_id: The UUID of the session.
+            configs: Dictionary of config keys to add, update, or delete.
+                Pass None as a value to delete that key.
+
+        Returns:
+            The complete configs after the patch operation.
+
+        Example:
+            >>> # Add/update keys
+            >>> updated = client.sessions.patch_configs(
+            ...     session_id,
+            ...     configs={"agent": "bot2", "temperature": 0.8}
+            ... )
+            >>> # Delete a key
+            >>> updated = client.sessions.patch_configs(
+            ...     session_id,
+            ...     configs={"old_key": None}  # Deletes "old_key"
+            ... )
+        """
+        payload = {"configs": configs}
+        data = self._requester.request(
+            "PATCH",
+            f"/session/{session_id}/configs",
+            json_data=payload,
+        )
+        return data.get("configs", {})  # type: ignore

{acontext-0.1.7 → acontext-0.1.9}/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.7 → acontext-0.1.9}/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.7 → acontext-0.1.9}/src/acontext/types/session.py

@@ -245,6 +245,10 @@ class GetMessagesOutput(BaseModel):
         ...,
         description="List of message UUIDs corresponding to each item in the same order",
     )
+    metas: list[dict[str, Any]] = Field(
+        default_factory=list,
+        description="List of user-provided metadata for each message (same order as items/ids)",
+    )
     next_cursor: str | None = Field(None, description="Cursor for pagination")
     has_more: bool = Field(..., description="Whether there are more items")
     this_time_tokens: int = Field(

acontext-0.1.7/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.7/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.7/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")
-