acontext 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

acontext/resources/async_disks.py

@@ -2,6 +2,8 @@
 Disk and artifact endpoints (async).
 """
 
+from __future__ import annotations
+
 import json
 from collections.abc import Mapping
 from typing import Any, BinaryIO, cast

acontext/resources/async_sessions.py

@@ -180,6 +180,47 @@ class AsyncSessionsAPI:
         )
         return GetTasksOutput.model_validate(data)
 
+    async def get_session_summary(
+        self,
+        session_id: str,
+        *,
+        limit: int | None = None,
+    ) -> str:
+        """Get a summary of all tasks in a session as a formatted string.
+
+        Args:
+            session_id: The UUID of the session.
+            limit: Maximum number of tasks to include in the summary. Defaults to None (all tasks).
+
+        Returns:
+            A formatted string containing the session summary with all task information.
+        """
+        tasks_output = await self.get_tasks(session_id, limit=limit, time_desc=False)
+        tasks = tasks_output.items
+
+        if not tasks:
+            return ""
+
+        parts: list[str] = []
+        for task in tasks:
+            task_lines = [
+                f'<task id="{task.order}" description="{task.data.task_description}">'
+            ]
+            if task.data.progresses:
+                task_lines.append("<progress>")
+                for i, p in enumerate(task.data.progresses, 1):
+                    task_lines.append(f"{i}. {p}")
+                task_lines.append("</progress>")
+            if task.data.user_preferences:
+                task_lines.append("<user_preference>")
+                for i, pref in enumerate(task.data.user_preferences, 1):
+                    task_lines.append(f"{i}. {pref}")
+                task_lines.append("</user_preference>")
+            task_lines.append("</task>")
+            parts.append("\n".join(task_lines))
+
+        return "\n".join(parts)
+
     async def store_message(
         self,
         session_id: str,
@@ -294,6 +335,7 @@ class AsyncSessionsAPI:
                 Each strategy is a dict with 'type' and 'params' keys.
                 Examples:
                     - Remove tool results: [{"type": "remove_tool_result", "params": {"keep_recent_n_tool_results": 3}}]
+                    - Middle out: [{"type": "middle_out", "params": {"token_reduce_to": 5000}}]
                     - Token limit: [{"type": "token_limit", "params": {"limit_tokens": 20000}}]
                 Defaults to None.
             pin_editing_strategies_at_message: Message ID to pin editing strategies at.

acontext/resources/sessions.py

@@ -180,6 +180,47 @@ class SessionsAPI:
         )
         return GetTasksOutput.model_validate(data)
 
+    def get_session_summary(
+        self,
+        session_id: str,
+        *,
+        limit: int | None = None,
+    ) -> str:
+        """Get a summary of all tasks in a session as a formatted string.
+
+        Args:
+            session_id: The UUID of the session.
+            limit: Maximum number of tasks to include in the summary. Defaults to None (all tasks).
+
+        Returns:
+            A formatted string containing the session summary with all task information.
+        """
+        tasks_output = self.get_tasks(session_id, limit=limit, time_desc=False)
+        tasks = tasks_output.items
+
+        if not tasks:
+            return ""
+
+        parts: list[str] = []
+        for task in tasks:
+            task_lines = [
+                f'<task id="{task.order}" description="{task.data.task_description}">'
+            ]
+            if task.data.progresses:
+                task_lines.append("<progress>")
+                for i, p in enumerate(task.data.progresses, 1):
+                    task_lines.append(f"{i}. {p}")
+                task_lines.append("</progress>")
+            if task.data.user_preferences:
+                task_lines.append("<user_preference>")
+                for i, pref in enumerate(task.data.user_preferences, 1):
+                    task_lines.append(f"{i}. {pref}")
+                task_lines.append("</user_preference>")
+            task_lines.append("</task>")
+            parts.append("\n".join(task_lines))
+
+        return "\n".join(parts)
+
     def store_message(
         self,
         session_id: str,
@@ -294,6 +335,7 @@ class SessionsAPI:
                 Each strategy is a dict with 'type' and 'params' keys.
                 Examples:
                     - Remove tool results: [{"type": "remove_tool_result", "params": {"keep_recent_n_tool_results": 3}}]
+                    - Middle out: [{"type": "middle_out", "params": {"token_reduce_to": 5000}}]
                     - Token limit: [{"type": "token_limit", "params": {"limit_tokens": 20000}}]
                 Defaults to None.
             pin_editing_strategies_at_message: Message ID to pin editing strategies at.
@@ -320,7 +362,9 @@ class SessionsAPI:
         if edit_strategies is not None:
             params["edit_strategies"] = json.dumps(edit_strategies)
         if pin_editing_strategies_at_message is not None:
-            params["pin_editing_strategies_at_message"] = pin_editing_strategies_at_message
+            params["pin_editing_strategies_at_message"] = (
+                pin_editing_strategies_at_message
+            )
         data = self._requester.request(
             "GET", f"/session/{session_id}/messages", params=params or None
         )
@@ -366,20 +410,19 @@ class SessionsAPI:
         """
         data = self._requester.request("GET", f"/session/{session_id}/token_counts")
         return TokenCounts.model_validate(data)
+
     def messages_observing_status(self, session_id: str) -> MessageObservingStatus:
         """Get message observing status counts for a session.
-        
+
         Returns the count of messages by their observing status:
         observed, in_process, and pending.
-        
+
         Args:
             session_id: The UUID of the session.
-        
+
         Returns:
-            MessageObservingStatus object containing observed, in_process, 
+            MessageObservingStatus object containing observed, in_process,
             pending counts and updated_at timestamp.
         """
-        data = self._requester.request(
-            "GET", f"/session/{session_id}/observing_status"
-        )
+        data = self._requester.request("GET", f"/session/{session_id}/observing_status")
         return MessageObservingStatus.model_validate(data)

acontext/types/session.py

@@ -89,10 +89,34 @@ class TokenLimitStrategy(TypedDict):
     params: TokenLimitParams
 
 
+class MiddleOutParams(TypedDict):
+    """Parameters for the middle_out edit strategy.
+
+    Attributes:
+        token_reduce_to: Target token count to reduce the prompt to. Required parameter.
+    """
+
+    token_reduce_to: int
+
+
+class MiddleOutStrategy(TypedDict):
+    """Edit strategy to reduce prompt size by removing middle messages.
+
+    Example:
+        {"type": "middle_out", "params": {"token_reduce_to": 5000}}
+    """
+
+    type: Literal["middle_out"]
+    params: MiddleOutParams
+
+
 # Union type for all edit strategies
 # When adding new strategies, add them to this Union: EditStrategy = Union[RemoveToolResultStrategy, OtherStrategy, ...]
 EditStrategy = Union[
-    RemoveToolResultStrategy, RemoveToolCallParamsStrategy, TokenLimitStrategy
+    RemoveToolResultStrategy,
+    RemoveToolCallParamsStrategy,
+    TokenLimitStrategy,
+    MiddleOutStrategy,
 ]
 
 

{acontext-0.1.0.dist-info → acontext-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acontext
-Version: 0.1.0
+Version: 0.1.2
 Summary: Python SDK for the Acontext API
 Keywords: acontext,sdk,client,api
 Requires-Dist: httpx>=0.28.1
@@ -10,8 +10,8 @@ Requires-Dist: pydantic>=2.12.3
 Requires-Dist: urllib3>=2.6.3
 Requires-Python: >=3.10
 Project-URL: Homepage, https://github.com/memodb-io/Acontext
-Project-URL: Issues, https://github.com/memodb-io/Acontext/issues
 Project-URL: Repository, https://github.com/memodb-io/Acontext
+Project-URL: Issues, https://github.com/memodb-io/Acontext/issues
 Description-Content-Type: text/markdown
 
 ## acontext client for python

{acontext-0.1.0.dist-info → acontext-0.1.2.dist-info}/RECORD

@@ -13,15 +13,15 @@ acontext/messages.py,sha256=oNRZStfhcPFt6DPOfs_-Q7R1Xui6dOMr3wmpmC8pzvE,2310
 acontext/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 acontext/resources/__init__.py,sha256=Oww11t9hmwdNFK2nC8YW9mf4BBSz5YLPAXAWLlZuNTs,935
 acontext/resources/async_blocks.py,sha256=e_iJpgcAdwS2tXQ16MMCnySlddp5JV3BadN_EyqZSF4,5555
-acontext/resources/async_disks.py,sha256=1kq9DpU7gXEhYkKGUlMyVyi8GPVSwYHjD_iEBv1UocQ,9024
-acontext/resources/async_sessions.py,sha256=DCGVohFrYpJZzERVzUlLr2xBxf_bzIUKD3EFhJ26S0I,14726
+acontext/resources/async_disks.py,sha256=iwCTam-fdoL3SKLqEVkTi3Pk90PsqNvsGBQECcPIHRc,9060
+acontext/resources/async_sessions.py,sha256=0SuNzuLSG4wKyJa_QCIP5pKkvzW6VDe5yHNRDdqoPrw,16317
 acontext/resources/async_skills.py,sha256=VoeqO9Z6E7qPCE2tMJaO7coONaCKCoLJRANQ5yWVbiE,4666
 acontext/resources/async_spaces.py,sha256=b8DNG2L43B6iSgfmH8M-0cxAp681IjSCjw-4alfjV2A,6712
 acontext/resources/async_tools.py,sha256=RbGaF2kX65Mun-q-Fp5H1J8waWTLIdCOfbdY19jpn1o,1091
 acontext/resources/async_users.py,sha256=m0nK_Luo6Uuvw2azGx8Wg2cXnipnTnyheolr79fX16Y,2020
 acontext/resources/blocks.py,sha256=HJdAy5HdyTcHCYCPmqNdvApYKZ6aWs-ORIi_wQt3TUM,5447
 acontext/resources/disks.py,sha256=pvxs9gdVBothuy0LSkPmuS061nNOgJX3iffypqLHW1Y,9032
-acontext/resources/sessions.py,sha256=qUoLs01tzmYChHy3kozzGQ3ZeAz_JyWGtCIsVL20BO4,14491
+acontext/resources/sessions.py,sha256=xHvT-CQHXhTc6BHHwpW_jyzMkxccSuTIdpLpTjS_NRc,16056
 acontext/resources/skills.py,sha256=ZECLUfy4QWHnzk9nnq1VvEeFTx-u7NvEhECfbq5Reiw,4615
 acontext/resources/spaces.py,sha256=Ktvkkn3Jj7CZoKMbn6fYuo0zqImoCWj2EnMsnL2q-0A,6571
 acontext/resources/tools.py,sha256=II_185B0HYKSP43hizE6C1zs7kjkkPLKihuEG8s-DRY,1046
@@ -30,12 +30,12 @@ acontext/types/__init__.py,sha256=L6g545qLolIVoo3ltlsOeZOr8T72lTrg9bOK-q1Mw0c,19
 acontext/types/block.py,sha256=CzKByunk642rWXNNnh8cx67UzKLKDAxODmC_whwjP90,1078
 acontext/types/common.py,sha256=5kLwzszlIofz8qZ9-Wj_zcBBiF22mAWgH9uWPkcgWCE,327
 acontext/types/disk.py,sha256=nMjyXLUre4Xuu_YfBbzzdRQDRxB8qX1Zx9LsNqGCi9E,2223
-acontext/types/session.py,sha256=WIaTiiAw8OujeSnk18Vy_Fn_AffW60pfs-unlPXYuT8,11076
+acontext/types/session.py,sha256=JeIlnjT6Gs2t4kZu5DKjus9KeCc-Vgjj7RH1x-JqYyY,11597
 acontext/types/skill.py,sha256=VlLp5NpsJSpyoQTlTuV6jJ4G6ArHr1SDpcqEmFkHyeY,2364
 acontext/types/space.py,sha256=9BkGBYGeQDVwYTmPLoIjMY-IUdQzjrt8I7CXca2_5Vc,2600
 acontext/types/tool.py,sha256=-mVn-vgk2SENK0Ubt-ZgWFZxKa-ddABqcAgXQ69YY-E,805
 acontext/types/user.py,sha256=JjE0xZDwUAs2BL741U7NINyyPAso64A1YmgMBPqSuvo,1331
 acontext/uploads.py,sha256=6twnqQOY_eerNuEjeSKsE_3S0IfJUiczXtAy4aXqDl8,1379
-acontext-0.1.0.dist-info/WHEEL,sha256=XjEbIc5-wIORjWaafhI6vBtlxDBp7S9KiujWF1EM7Ak,79
-acontext-0.1.0.dist-info/METADATA,sha256=KXOlyw54Vjq-wPK8zVSt77DG8eJPm7nstGsnm8C7vZc,888
-acontext-0.1.0.dist-info/RECORD,,
+acontext-0.1.2.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+acontext-0.1.2.dist-info/METADATA,sha256=dIwbYqoDjMXrc9QjiL_u5usSy7IgVgrdLMn6ZVaBHCU,888
+acontext-0.1.2.dist-info/RECORD,,

{acontext-0.1.0.dist-info → acontext-0.1.2.dist-info}/WHEEL

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