acontext 0.0.4__py3-none-any.whl → 0.0.6__py3-none-any.whl

acontext/resources/async_sessions.py

@@ -15,6 +15,7 @@ from ..types.session import (
     ListSessionsOutput,
     Message,
     Session,
+    TokenCounts,
 )
 from ..uploads import FileUpload, normalize_file_upload
 from pydantic import BaseModel
@@ -321,3 +322,17 @@ class AsyncSessionsAPI:
             "GET", f"/session/{session_id}/get_learning_status"
         )
         return LearningStatus.model_validate(data)
+
+    async def get_token_counts(self, session_id: str) -> TokenCounts:
+        """Get total token counts for all text and tool-call parts in a session.
+
+        Args:
+            session_id: The UUID of the session.
+
+        Returns:
+            TokenCounts object containing total_tokens.
+        """
+        data = await self._requester.request(
+            "GET", f"/session/{session_id}/token_counts"
+        )
+        return TokenCounts.model_validate(data)

acontext/resources/async_spaces.py

@@ -8,6 +8,8 @@ from typing import Any, List
 from .._utils import build_params
 from ..client_types import AsyncRequesterProtocol
 from ..types.space import (
+    ExperienceConfirmation,
+    ListExperienceConfirmationsOutput,
     ListSpacesOutput,
     SearchResultBlockItem,
     Space,
@@ -186,3 +188,60 @@ class AsyncSpacesAPI:
             "GET", f"/space/{space_id}/semantic_grep", params=params or None
         )
         return [SearchResultBlockItem.model_validate(item) for item in data]
+
+    async def get_unconfirmed_experiences(
+        self,
+        space_id: str,
+        *,
+        limit: int | None = None,
+        cursor: str | None = None,
+        time_desc: bool | None = None,
+    ) -> ListExperienceConfirmationsOutput:
+        """Get all unconfirmed experiences in a space with cursor-based pagination.
+
+        Args:
+            space_id: The UUID of the space.
+            limit: Maximum number of confirmations to return (1-200, default 20).
+            cursor: Cursor for pagination. Use the cursor from the previous response to get the next page.
+            time_desc: Order by created_at descending if True, ascending if False (default False).
+
+        Returns:
+            ListExperienceConfirmationsOutput containing the list of experience confirmations and pagination information.
+        """
+        params = build_params(limit=limit, cursor=cursor, time_desc=time_desc)
+        data = await self._requester.request(
+            "GET",
+            f"/space/{space_id}/experience_confirmations",
+            params=params or None,
+        )
+        return ListExperienceConfirmationsOutput.model_validate(data)
+
+    async def confirm_experience(
+        self,
+        space_id: str,
+        experience_id: str,
+        *,
+        save: bool,
+    ) -> ExperienceConfirmation | None:
+        """Confirm an experience confirmation.
+
+        If save is False, delete the row. If save is True, get the data first,
+        then delete the row.
+
+        Args:
+            space_id: The UUID of the space.
+            experience_id: The UUID of the experience confirmation.
+            save: If True, get data before deleting. If False, just delete.
+
+        Returns:
+            ExperienceConfirmation object if save is True, None otherwise.
+        """
+        payload = {"save": save}
+        data = await self._requester.request(
+            "PATCH",
+            f"/space/{space_id}/experience_confirmations/{experience_id}",
+            json_data=payload,
+        )
+        if data is None:
+            return None
+        return ExperienceConfirmation.model_validate(data)

acontext/resources/sessions.py

@@ -15,6 +15,7 @@ from ..types.session import (
     ListSessionsOutput,
     Message,
     Session,
+    TokenCounts,
 )
 from ..uploads import FileUpload, normalize_file_upload
 from pydantic import BaseModel
@@ -321,3 +322,17 @@ class SessionsAPI:
             "GET", f"/session/{session_id}/get_learning_status"
         )
         return LearningStatus.model_validate(data)
+
+    def get_token_counts(self, session_id: str) -> TokenCounts:
+        """Get total token counts for all text and tool-call parts in a session.
+
+        Args:
+            session_id: The UUID of the session.
+
+        Returns:
+            TokenCounts object containing total_tokens.
+        """
+        data = self._requester.request(
+            "GET", f"/session/{session_id}/token_counts"
+        )
+        return TokenCounts.model_validate(data)

acontext/resources/spaces.py

@@ -8,6 +8,8 @@ from typing import Any, List
 from .._utils import build_params
 from ..client_types import RequesterProtocol
 from ..types.space import (
+    ExperienceConfirmation,
+    ListExperienceConfirmationsOutput,
     ListSpacesOutput,
     SearchResultBlockItem,
     Space,
@@ -184,3 +186,60 @@ class SpacesAPI:
             "GET", f"/space/{space_id}/semantic_grep", params=params or None
         )
         return [SearchResultBlockItem.model_validate(item) for item in data]
+
+    def get_unconfirmed_experiences(
+        self,
+        space_id: str,
+        *,
+        limit: int | None = None,
+        cursor: str | None = None,
+        time_desc: bool | None = None,
+    ) -> ListExperienceConfirmationsOutput:
+        """Get all unconfirmed experiences in a space with cursor-based pagination.
+
+        Args:
+            space_id: The UUID of the space.
+            limit: Maximum number of confirmations to return (1-200, default 20).
+            cursor: Cursor for pagination. Use the cursor from the previous response to get the next page.
+            time_desc: Order by created_at descending if True, ascending if False (default False).
+
+        Returns:
+            ListExperienceConfirmationsOutput containing the list of experience confirmations and pagination information.
+        """
+        params = build_params(limit=limit, cursor=cursor, time_desc=time_desc)
+        data = self._requester.request(
+            "GET",
+            f"/space/{space_id}/experience_confirmations",
+            params=params or None,
+        )
+        return ListExperienceConfirmationsOutput.model_validate(data)
+
+    def confirm_experience(
+        self,
+        space_id: str,
+        experience_id: str,
+        *,
+        save: bool,
+    ) -> ExperienceConfirmation | None:
+        """Confirm an experience confirmation.
+
+        If save is False, delete the row. If save is True, get the data first,
+        then delete the row.
+
+        Args:
+            space_id: The UUID of the space.
+            experience_id: The UUID of the experience confirmation.
+            save: If True, get data before deleting. If False, just delete.
+
+        Returns:
+            ExperienceConfirmation object if save is True, None otherwise.
+        """
+        payload = {"save": save}
+        data = self._requester.request(
+            "PATCH",
+            f"/space/{space_id}/experience_confirmations/{experience_id}",
+            json_data=payload,
+        )
+        if data is None:
+            return None
+        return ExperienceConfirmation.model_validate(data)

acontext/types/__init__.py

@@ -20,9 +20,12 @@ from .session import (
     PublicURL,
     Session,
     Task,
+    TokenCounts,
 )
 from .block import Block
 from .space import (
+    ExperienceConfirmation,
+    ListExperienceConfirmationsOutput,
     ListSpacesOutput,
     SearchResultBlockItem,
     Space,
@@ -55,7 +58,10 @@ __all__ = [
     "PublicURL",
     "Session",
     "Task",
+    "TokenCounts",
     # Space types
+    "ExperienceConfirmation",
+    "ListExperienceConfirmationsOutput",
     "ListSpacesOutput",
     "SearchResultBlockItem",
     "Space",

acontext/types/session.py

@@ -133,3 +133,9 @@ class LearningStatus(BaseModel):
     not_space_digested_count: int = Field(
         ..., description="Number of tasks that are not space digested"
     )
+
+
+class TokenCounts(BaseModel):
+    """Response model for token counts."""
+
+    total_tokens: int = Field(..., description="Total token count for all text and tool-call parts in a session")

acontext/types/space.py

@@ -44,3 +44,26 @@ class SpaceSearchResult(BaseModel):
         ..., description="List of cited blocks"
     )
     final_answer: str | None = Field(None, description="AI-generated final answer")
+
+
+class ExperienceConfirmation(BaseModel):
+    """Experience confirmation model."""
+
+    id: str = Field(..., description="Experience confirmation UUID")
+    space_id: str = Field(..., description="Space UUID")
+    task_id: str | None = Field(None, description="Task UUID (optional)")
+    experience_data: dict[str, Any] = Field(
+        ..., description="Experience data dictionary"
+    )
+    created_at: str = Field(..., description="ISO 8601 formatted creation timestamp")
+    updated_at: str = Field(..., description="ISO 8601 formatted update timestamp")
+
+
+class ListExperienceConfirmationsOutput(BaseModel):
+    """Response model for listing experience confirmations."""
+
+    items: list[ExperienceConfirmation] = Field(
+        ..., description="List of experience confirmations"
+    )
+    next_cursor: str | None = Field(None, description="Cursor for pagination")
+    has_more: bool = Field(..., description="Whether there are more items")

{acontext-0.0.4.dist-info → acontext-0.0.6.dist-info}/METADATA

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

{acontext-0.0.4.dist-info → acontext-0.0.6.dist-info}/RECORD

@@ -10,21 +10,21 @@ acontext/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 acontext/resources/__init__.py,sha256=KSVQ3YJ-wuU6OWGWJ47gDGbjjetP102aEsVSR8JUb_4,721
 acontext/resources/async_blocks.py,sha256=e_iJpgcAdwS2tXQ16MMCnySlddp5JV3BadN_EyqZSF4,5555
 acontext/resources/async_disks.py,sha256=2JjLpUkz5YZEkLt_jCts_khTG_b7lvf4cUMfoaJcnI8,6471
-acontext/resources/async_sessions.py,sha256=B7GgGV5M2wH1t9wyJdvdsCxrBfXxBKCAd6V6IGHAS2Y,11414
-acontext/resources/async_spaces.py,sha256=MnHJ6c8bqT2RgSsDeyYS8fgrvnMxZ3yOkd5d9hSHjPE,6414
+acontext/resources/async_sessions.py,sha256=b5oha4np1-RmNf2eRsnuJ2UJjdPyztExYQF-7_1pIAc,11894
+acontext/resources/async_spaces.py,sha256=GTQIDLA_rDWB6AVP__jLpV7kfw9og021DD5N67gZYEE,8587
 acontext/resources/async_tools.py,sha256=RbGaF2kX65Mun-q-Fp5H1J8waWTLIdCOfbdY19jpn1o,1091
 acontext/resources/blocks.py,sha256=HJdAy5HdyTcHCYCPmqNdvApYKZ6aWs-ORIi_wQt3TUM,5447
 acontext/resources/disks.py,sha256=BjVhVXoujHWhg6L0TG9GmW9HLTTldJYEPxCbuppRkc4,6336
-acontext/resources/sessions.py,sha256=0t2EREueidwSz0bXycmaysNmA4AT7EXKVGKr8C09X2w,11247
-acontext/resources/spaces.py,sha256=ugmma1jY3k4i87MdgBSoCTP_Slxg895qeWtiKNM5SqQ,6273
+acontext/resources/sessions.py,sha256=9iVd_2ZCxwuUFIfdsp1lRSTHb9JoFTHFkhzT7065kwY,11715
+acontext/resources/spaces.py,sha256=h9-nQ_snz5YFc-ooPYBfFk28i-C8DHmdFMjrddiKnAw,8422
 acontext/resources/tools.py,sha256=II_185B0HYKSP43hizE6C1zs7kjkkPLKihuEG8s-DRY,1046
-acontext/types/__init__.py,sha256=vTSOk8ByG2qUJF9CRj73wYefQAxaFiqSKrMLClWb0hY,1244
+acontext/types/__init__.py,sha256=vrKXYUO8zZ4uIBFqRdnp-DRY0tzTDk7rNSUn0bdpTA8,1418
 acontext/types/block.py,sha256=CzKByunk642rWXNNnh8cx67UzKLKDAxODmC_whwjP90,1078
 acontext/types/disk.py,sha256=g9u3rgCh05rK-gay19NUi-WyzI5Vt1GQwcyKv-5TSC4,2361
-acontext/types/session.py,sha256=_suqVE_bgaQ6vGX0sgTuICREPZwWKG8cRy6aXoEee-w,5466
-acontext/types/space.py,sha256=lhik5PMG0CthQAqgfi9MSlsP1N_sD7ubBbgAldFtO7s,1589
+acontext/types/session.py,sha256=OprkkCsEbDHrQ_Kpd6yv8lcyoCfV54IcTmNft-gAyPI,5656
+acontext/types/space.py,sha256=uxbPrOHYpsntPHqhMCLQ2KovM7BngHC5Q2j7qexVrN8,2537
 acontext/types/tool.py,sha256=-mVn-vgk2SENK0Ubt-ZgWFZxKa-ddABqcAgXQ69YY-E,805
 acontext/uploads.py,sha256=6twnqQOY_eerNuEjeSKsE_3S0IfJUiczXtAy4aXqDl8,1379
-acontext-0.0.4.dist-info/WHEEL,sha256=YUH1mBqsx8Dh2cQG2rlcuRYUhJddG9iClegy4IgnHik,79
-acontext-0.0.4.dist-info/METADATA,sha256=gNQPNnyKjtZFInTRTl4eIraKn-cHHq_T0UOGI3G6Lqg,11648
-acontext-0.0.4.dist-info/RECORD,,
+acontext-0.0.6.dist-info/WHEEL,sha256=3id4o64OvRm9dUknh3mMJNcfoTRK08ua5cU6DFyVy-4,79
+acontext-0.0.6.dist-info/METADATA,sha256=2-rXug4Y_HWeXvvA-zUEnetakYXGqvddOrzGKpVY46I,11648
+acontext-0.0.6.dist-info/RECORD,,

{acontext-0.0.4.dist-info → acontext-0.0.6.dist-info}/WHEEL

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