acontext 0.0.14__py3-none-any.whl → 0.0.17__py3-none-any.whl

acontext/types/session.py

@@ -13,10 +13,13 @@ class RemoveToolResultParams(TypedDict, total=False):
             Defaults to 3 if not specified.
         tool_result_placeholder: Custom text to replace old tool results with.
             Defaults to "Done" if not specified.
+        keep_tools: List of tool names that should never have their results removed.
+            Tool results from these tools are always kept regardless of keep_recent_n_tool_results.
     """
 
     keep_recent_n_tool_results: NotRequired[int]
     tool_result_placeholder: NotRequired[str]
+    keep_tools: NotRequired[list[str]]
 
 
 class RemoveToolResultStrategy(TypedDict):
@@ -36,10 +39,12 @@ class RemoveToolCallParamsParams(TypedDict, total=False):
     Attributes:
         keep_recent_n_tool_calls: Number of most recent tool calls to keep with full parameters.
             Defaults to 3 if not specified.
+        keep_tools: List of tool names that should never have their parameters removed.
+            Tool calls for these tools always keep their full parameters regardless of keep_recent_n_tool_calls.
     """
 
     keep_recent_n_tool_calls: NotRequired[int]
-
+    keep_tools: NotRequired[list[str]]
 
 
 class RemoveToolCallParamsStrategy(TypedDict):
@@ -57,7 +62,6 @@ class RemoveToolCallParamsStrategy(TypedDict):
     params: RemoveToolCallParamsParams
 
 
-
 class TokenLimitParams(TypedDict):
     """Parameters for the token_limit edit strategy.
 
@@ -87,7 +91,9 @@ class TokenLimitStrategy(TypedDict):
 
 # Union type for all edit strategies
 # When adding new strategies, add them to this Union: EditStrategy = Union[RemoveToolResultStrategy, OtherStrategy, ...]
-EditStrategy = Union[RemoveToolResultStrategy, RemoveToolCallParamsStrategy, TokenLimitStrategy]
+EditStrategy = Union[
+    RemoveToolResultStrategy, RemoveToolCallParamsStrategy, TokenLimitStrategy
+]
 
 
 class Asset(BaseModel):
@@ -137,6 +143,7 @@ class Session(BaseModel):
 
     id: str = Field(..., description="Session UUID")
     project_id: str = Field(..., description="Project UUID")
+    user_id: str | None = Field(None, description="User UUID")
     disable_task_tracking: bool = Field(
         False, description="Whether task tracking is disabled for this session"
     )
@@ -216,15 +223,29 @@ class GetMessagesOutput(BaseModel):
         description="List of messages in the requested format (Message, OpenAI format, or Anthropic format)",
     )
     ids: list[str] = Field(
-	...,
-	description="List of message UUIDs corresponding to each item in the same order",
+        ...,
+        description="List of message UUIDs corresponding to each item in the same order",
     )
     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(
+        ...,
+        description="Total token count of the returned messages",
+    )
     public_urls: dict[str, PublicURL] | None = Field(
         None,
         description="Map of SHA256 hash to PublicURL (only included when format='acontext')",
     )
+    edit_at_message_id: str | None = Field(
+        None,
+        description=(
+            "The message ID where edit strategies were applied up to. "
+            "If pin_editing_strategies_at_message was provided, this equals that value. "
+            "Otherwise, this is the ID of the last message in the response. "
+            "Use this value to maintain prompt cache stability by passing it as "
+            "pin_editing_strategies_at_message in subsequent requests."
+        ),
+    )
 
 
 class GetTasksOutput(BaseModel):
@@ -254,18 +275,13 @@ class TokenCounts(BaseModel):
         description="Total token count for all text and tool-call parts in a session",
     )
 
+
 class MessageObservingStatus(BaseModel):
     """Response model for message observing status."""
-    
-    observed: int = Field(
-        ..., description="Number of messages with observed status"
-    )
+
+    observed: int = Field(..., description="Number of messages with observed status")
     in_process: int = Field(
         ..., description="Number of messages with in_process status"
     )
-    pending: int = Field(
-        ..., description="Number of messages with pending status"
-    )
-    updated_at: str = Field(
-        ..., description="Timestamp when the status was retrieved"
-    )
+    pending: int = Field(..., description="Number of messages with pending status")
+    updated_at: str = Field(..., description="Timestamp when the status was retrieved")

acontext/types/skill.py

@@ -0,0 +1,69 @@
+"""Type definitions for skill resources."""
+
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+from .common import FileContent
+
+
+class FileInfo(BaseModel):
+    """File information in a skill."""
+
+    path: str = Field(..., description="Relative file path from skill root")
+    mime: str = Field(..., description="MIME type of the file")
+
+
+class Skill(BaseModel):
+    """Skill model representing an agent skill resource."""
+
+    id: str = Field(..., description="Skill UUID")
+    user_id: str | None = Field(None, description="User UUID")
+    name: str = Field(..., description="Skill name (unique within project)")
+    description: str = Field(..., description="Skill description")
+    file_index: list[FileInfo] = Field(
+        ..., description="List of file information (path and MIME type) in the skill"
+    )
+    meta: dict[str, Any] | None = Field(
+        None, description="Custom metadata dictionary"
+    )
+    created_at: str = Field(..., description="ISO 8601 formatted creation timestamp")
+    updated_at: str = Field(..., description="ISO 8601 formatted update timestamp")
+
+
+class SkillCatalogItem(BaseModel):
+    """Catalog item containing only name and description."""
+
+    name: str = Field(..., description="Skill name (unique within project)")
+    description: str = Field(..., description="Skill description")
+
+
+class ListSkillsOutput(BaseModel):
+    """Response model for listing skills (catalog format with name and description only)."""
+
+    items: list[SkillCatalogItem] = Field(
+        ..., description="List of skills with name and description"
+    )
+    next_cursor: str | None = Field(None, description="Cursor for pagination")
+    has_more: bool = Field(..., description="Whether there are more items")
+
+
+class _ListSkillsResponse(BaseModel):
+    """Internal response model for API pagination (full Skill objects).
+    
+    This is used internally to parse the raw API response before converting
+    to the catalog format (ListSkillsOutput).
+    """
+    items: list[Skill]
+    next_cursor: str | None = None
+    has_more: bool = False
+
+
+class GetSkillFileResp(BaseModel):
+    """Response model for getting a skill file."""
+
+    path: str = Field(..., description="File path")
+    mime: str = Field(..., description="MIME type of the file")
+    url: str | None = Field(None, description="Presigned URL for downloading the file (present if file is not parseable)")
+    content: FileContent | None = Field(None, description="Parsed file content if available (present if file is parseable)")
+

acontext/types/space.py

@@ -10,6 +10,7 @@ class Space(BaseModel):
 
     id: str = Field(..., description="Space UUID")
     project_id: str = Field(..., description="Project UUID")
+    user_id: str | None = Field(None, description="User UUID")
     configs: dict[str, Any] | None = Field(
         None, description="Space configuration dictionary"
     )

acontext/types/user.py

@@ -0,0 +1,36 @@
+"""Type definitions for user resources."""
+
+from pydantic import BaseModel, Field
+
+
+class User(BaseModel):
+    """User model representing a user resource."""
+
+    id: str = Field(..., description="User UUID")
+    project_id: str = Field(..., description="Project UUID")
+    identifier: str = Field(..., description="User identifier string")
+    created_at: str = Field(..., description="ISO 8601 formatted creation timestamp")
+    updated_at: str = Field(..., description="ISO 8601 formatted update timestamp")
+
+
+class ListUsersOutput(BaseModel):
+    """Response model for listing users."""
+
+    items: list[User] = Field(..., description="List of users")
+    next_cursor: str | None = Field(None, description="Cursor for pagination")
+    has_more: bool = Field(..., description="Whether there are more items")
+
+
+class UserResourceCounts(BaseModel):
+    """Resource counts for a user."""
+
+    spaces_count: int = Field(..., description="Number of spaces")
+    sessions_count: int = Field(..., description="Number of sessions")
+    disks_count: int = Field(..., description="Number of disks")
+    skills_count: int = Field(..., description="Number of skills")
+
+
+class GetUserResourcesOutput(BaseModel):
+    """Response model for getting user resources."""
+
+    counts: UserResourceCounts = Field(..., description="Resource counts")

{acontext-0.0.14.dist-info → acontext-0.0.17.dist-info}/METADATA

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

acontext-0.0.17.dist-info/RECORD

@@ -0,0 +1,41 @@
+acontext/__init__.py,sha256=jAgRawWIjyMd6g3gq7Xm_3vNB31cPj8rMFPO4LGQKdM,1027
+acontext/_constants.py,sha256=Ikuy_Wz3CPmXjKPLXb4Y580-fe54o1hZ2ZB1Bpw3sFE,363
+acontext/_utils.py,sha256=GKQH45arKh0sDu64u-5jwrII_ctnU_oChYlgR5lRkfE,1250
+acontext/agent/__init__.py,sha256=PAUhm1rBYOdKw3lCD-H9d72emkGL4KoxEvVq4GeS9ig,158
+acontext/agent/base.py,sha256=kN2KzV6fOlvmMSi_0yu2QqwVLtHh09TznAy_SDtC8iM,2998
+acontext/agent/disk.py,sha256=dSDjCejP0o4Z4nHJgfKfIXLFZaCA9AFV852Yo9E9GHk,16131
+acontext/agent/skill.py,sha256=opsOTQyuedqQMlwDXWMVwCwg0u9cyehfyELDEbat3bE,4451
+acontext/async_client.py,sha256=sqdSNjl3tx8ijoRNYoEwh1Lxdlhfk0zyd-h-xffIJJE,8372
+acontext/client.py,sha256=3xha-zbHYLwI1njlhmoB_BYK5JIJoXFyrCpvIi63b9o,8097
+acontext/client_types.py,sha256=uVBWzLbZyXrqkljG49ojdQL_xX6N3n_HGt4Bs_TEE48,987
+acontext/errors.py,sha256=W9i7_t46q9kbci3XAyZiyQhS154d4R9rSon3na-gjgs,1296
+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=rwcRwQ79ZYbMMWAj5YDDpKQmfAIOl9M3CTYxOZTy_UU,6830
+acontext/resources/async_sessions.py,sha256=Ld9T8l884r3UuUprRz7MwafSI8BaPfLA0pg0dPfNM1A,14363
+acontext/resources/async_skills.py,sha256=mbEzyUH7S2_jkZ5tfl0FzpHJ7Io3x_biw5FirhokzAQ,5062
+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/skills.py,sha256=FPp1YWhH85I9BU0fJJC9FbePIbFhyX6j2FYxjPuBEAc,4935
+acontext/resources/spaces.py,sha256=Ktvkkn3Jj7CZoKMbn6fYuo0zqImoCWj2EnMsnL2q-0A,6571
+acontext/resources/tools.py,sha256=II_185B0HYKSP43hizE6C1zs7kjkkPLKihuEG8s-DRY,1046
+acontext/resources/users.py,sha256=6xwU7UeMWRIGn6n7LKgsptV9pzYFNWCbJftieptVg6k,1961
+acontext/types/__init__.py,sha256=L6g545qLolIVoo3ltlsOeZOr8T72lTrg9bOK-q1Mw0c,1909
+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/skill.py,sha256=qBDNysW9ptKX6RcMiZd4PfwWwvcYCzj_dC-6RbXqyx4,2531
+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.0.17.dist-info/WHEEL,sha256=eycQt0QpYmJMLKpE3X9iDk8R04v2ZF0x82ogq-zP6bQ,79
+acontext-0.0.17.dist-info/METADATA,sha256=Z6rVfzFv3K3o_hSyymhrvdQU2ZGZ20GEwQPjPkNR7Rw,859
+acontext-0.0.17.dist-info/RECORD,,

{acontext-0.0.14.dist-info → acontext-0.0.17.dist-info}/WHEEL

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

acontext-0.0.14.dist-info/RECORD

@@ -1,33 +0,0 @@
-acontext/__init__.py,sha256=jAgRawWIjyMd6g3gq7Xm_3vNB31cPj8rMFPO4LGQKdM,1027
-acontext/_constants.py,sha256=Ikuy_Wz3CPmXjKPLXb4Y580-fe54o1hZ2ZB1Bpw3sFE,363
-acontext/_utils.py,sha256=GKQH45arKh0sDu64u-5jwrII_ctnU_oChYlgR5lRkfE,1250
-acontext/agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-acontext/agent/base.py,sha256=kN2KzV6fOlvmMSi_0yu2QqwVLtHh09TznAy_SDtC8iM,2998
-acontext/agent/disk.py,sha256=d9sOggIs4da7niB9TaE0ab82_7l0O5n08eOcQxcaYRs,12623
-acontext/async_client.py,sha256=mfyR-WVy_LEOXjrkTcXLNaPDC5euaZ9zFI_5e1gapGs,8153
-acontext/client.py,sha256=jFr5-Q8obdcZBamUNtY3fCklpOJiNiIKLzEApTmbnTg,7920
-acontext/client_types.py,sha256=uVBWzLbZyXrqkljG49ojdQL_xX6N3n_HGt4Bs_TEE48,987
-acontext/errors.py,sha256=W9i7_t46q9kbci3XAyZiyQhS154d4R9rSon3na-gjgs,1296
-acontext/messages.py,sha256=oNRZStfhcPFt6DPOfs_-Q7R1Xui6dOMr3wmpmC8pzvE,2310
-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=660qEvz9aG_Nn3XiKKj9AbWizMstHhUsQN2m3W8ZGJ4,13357
-acontext/resources/async_spaces.py,sha256=5lIZjI8GmgoMBcftAMD2vDj2FmbLZ6pi1-yNCWKv4cM,6408
-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=9qfEMVmiJGmhAqKYQ89yYa14SDZ-dyol1-rPXU3wSI0,13441
-acontext/resources/spaces.py,sha256=LJP9krygZGdktMDtYGudCpk7yBxe_4v34QLk3SdejwQ,6267
-acontext/resources/tools.py,sha256=II_185B0HYKSP43hizE6C1zs7kjkkPLKihuEG8s-DRY,1046
-acontext/types/__init__.py,sha256=QWNLmdSnLE2b5XRXxnI2OKnHVdKQPJH0nJvvOYwhB1o,1448
-acontext/types/block.py,sha256=CzKByunk642rWXNNnh8cx67UzKLKDAxODmC_whwjP90,1078
-acontext/types/disk.py,sha256=g9u3rgCh05rK-gay19NUi-WyzI5Vt1GQwcyKv-5TSC4,2361
-acontext/types/session.py,sha256=H_n4vZJ02ZO5flqGZ8R5AYVSScxScf2r7UgsN5LRIa0,9965
-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.14.dist-info/WHEEL,sha256=KSLUh82mDPEPk0Bx0ScXlWL64bc8KmzIPNcpQZFV-6E,79
-acontext-0.0.14.dist-info/METADATA,sha256=sm1g1hhGbW15feWubCtcNkjgK5Ja1S_-xr1lIbXvmjU,859
-acontext-0.0.14.dist-info/RECORD,,