acontext 0.1.8__tar.gz → 0.1.9__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acontext
-Version: 0.1.8
+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.8 → acontext-0.1.9}/pyproject.toml

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

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

@@ -224,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
@@ -238,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,
@@ -264,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
@@ -412,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.8 → acontext-0.1.9}/src/acontext/resources/sessions.py

@@ -224,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
@@ -238,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,
@@ -265,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
@@ -406,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.8 → 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(