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

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

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

@@ -17,22 +17,22 @@ acontext/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 acontext/resources/__init__.py,sha256=NN5rlry2o_GdqxbiKq0oeVLi6NE6i1k0MwA0Nw0MOO8,739
 acontext/resources/async_disks.py,sha256=rc8hSdVsZ1UbrK2kwxmEMZyP0aEMsvjyZ70cYddpiF8,12051
 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_sessions.py,sha256=-edVKXjDFTQkt37xGX20YUNYjq6ed5LpVPgzXMAwN5U,19117
 acontext/resources/async_skills.py,sha256=eRn3NjBhR6_6GmEyZO_nKc0OnHgR_TeIHxqGX_73lwo,5999
 acontext/resources/async_users.py,sha256=CjW_Xz-UnNf449Hr1j3YeGgtIVZi2ePY5-r7Uj3wMIc,2005
 acontext/resources/disks.py,sha256=YyAzm6A00T4A3dI8YTEAOxwm6bnCnp8gWIoZ4lLGN5w,11859
 acontext/resources/sandboxes.py,sha256=BWaSK2MrkVvKgVeHJZyIbvaiEqXREIa7X5LJxOoxUts,2781
-acontext/resources/sessions.py,sha256=wdrTi8c_6PsgA9X4izLOuU4xV7MDONV-wExWWUb_LJo,15678
+acontext/resources/sessions.py,sha256=MDnuwu1KUYe0s7RnbzTGl1xMICudXzWQ73vBEKtgN7Y,18826
 acontext/resources/skills.py,sha256=CZFgJhRDtGlbDcTBKNxFkG4DlqoaJb0c_ymfV12QKdM,5930
 acontext/resources/users.py,sha256=vZfBHd2ARmd9d5d8n5rLaMUT5z2bMO82k7OcqMaFqxk,1946
 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/session.py,sha256=2CD-okvwScQFUWfMGQ6RpNWpaNGpz0lbmhnm8cWaLgQ,11177
 acontext/types/skill.py,sha256=v7OAvtkwTeZAkLG7NQMcwFoSJ4g-HDWjPZ4EoMyU3mk,2779
 acontext/types/user.py,sha256=dBzHCqULSJ3Sqw7T8nA0U8Sctz76Pd0hm1qsHvtEIBQ,1264
 acontext/uploads.py,sha256=6twnqQOY_eerNuEjeSKsE_3S0IfJUiczXtAy4aXqDl8,1379
-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.9.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
+acontext-0.1.9.dist-info/METADATA,sha256=k6W8Q89F_3FXpPYezcQs_iyhb8utr60cR3BGJpCe0Xw,888
+acontext-0.1.9.dist-info/RECORD,,

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

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