acontext 0.0.16__tar.gz → 0.0.17__tar.gz

{acontext-0.0.16 → acontext-0.0.17}/PKG-INFO

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

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

{acontext-0.0.16 → acontext-0.0.17}/src/acontext/agent/disk.py

@@ -328,6 +328,110 @@ class DownloadFileTool(BaseTool):
         return f"Public download URL for '{normalized_path}{filename}' (expires in {expire}s):\n{result.public_url}"
 
 
+class GrepArtifactsTool(BaseTool):
+    """Tool for searching artifact content using regex patterns."""
+
+    @property
+    def name(self) -> str:
+        return "grep_artifacts"
+
+    @property
+    def description(self) -> str:
+        return "Search for text patterns within file contents using regex. Only searches text-based files (code, markdown, json, csv, etc.). Use this to find specific code patterns, TODO comments, function definitions, or any text content."
+
+    @property
+    def arguments(self) -> dict:
+        return {
+            "query": {
+                "type": "string",
+                "description": "Regex pattern to search for (e.g., 'TODO.*', 'function.*calculate', 'import.*pandas')",
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Maximum number of results to return (default 100)",
+            },
+        }
+
+    @property
+    def required_arguments(self) -> list[str]:
+        return ["query"]
+
+    def execute(self, ctx: DiskContext, llm_arguments: dict) -> str:
+        """Search artifact content using regex pattern."""
+        query = llm_arguments.get("query")
+        limit = llm_arguments.get("limit", 100)
+
+        if not query:
+            raise ValueError("query is required")
+
+        results = ctx.client.disks.artifacts.grep_artifacts(
+            ctx.disk_id,
+            query=query,
+            limit=limit,
+        )
+
+        if not results:
+            return f"No matches found for pattern '{query}'"
+
+        matches = []
+        for artifact in results:
+            matches.append(f"{artifact.path}{artifact.filename}")
+
+        return f"Found {len(matches)} file(s) matching '{query}':\n" + "\n".join(matches)
+
+
+class GlobArtifactsTool(BaseTool):
+    """Tool for finding files by path pattern using glob syntax."""
+
+    @property
+    def name(self) -> str:
+        return "glob_artifacts"
+
+    @property
+    def description(self) -> str:
+        return "Find files by path pattern using glob syntax. Use * for any characters, ? for single character, ** for recursive directories. Perfect for finding files by extension or location."
+
+    @property
+    def arguments(self) -> dict:
+        return {
+            "query": {
+                "type": "string",
+                "description": "Glob pattern (e.g., '**/*.py' for all Python files, '*.txt' for text files in root, '/docs/**/*.md' for markdown in docs)",
+            },
+            "limit": {
+                "type": "integer",
+                "description": "Maximum number of results to return (default 100)",
+            },
+        }
+
+    @property
+    def required_arguments(self) -> list[str]:
+        return ["query"]
+
+    def execute(self, ctx: DiskContext, llm_arguments: dict) -> str:
+        """Search artifact paths using glob pattern."""
+        query = llm_arguments.get("query")
+        limit = llm_arguments.get("limit", 100)
+
+        if not query:
+            raise ValueError("query is required")
+
+        results = ctx.client.disks.artifacts.glob_artifacts(
+            ctx.disk_id,
+            query=query,
+            limit=limit,
+        )
+
+        if not results:
+            return f"No files found matching pattern '{query}'"
+
+        matches = []
+        for artifact in results:
+            matches.append(f"{artifact.path}{artifact.filename}")
+
+        return f"Found {len(matches)} file(s) matching '{query}':\n" + "\n".join(matches)
+
+
 class DiskToolPool(BaseToolPool):
     """Tool pool for disk operations on Acontext disks."""
 
@@ -340,6 +444,8 @@ DISK_TOOLS.add_tool(WriteFileTool())
 DISK_TOOLS.add_tool(ReadFileTool())
 DISK_TOOLS.add_tool(ReplaceStringTool())
 DISK_TOOLS.add_tool(ListTool())
+DISK_TOOLS.add_tool(GrepArtifactsTool())
+DISK_TOOLS.add_tool(GlobArtifactsTool())
 DISK_TOOLS.add_tool(DownloadFileTool())
 
 

acontext-0.0.17/src/acontext/resources/async_users.py

@@ -0,0 +1,57 @@
+"""
+User management endpoints (async).
+"""
+
+from urllib.parse import quote
+
+from .._utils import build_params
+from ..client_types import AsyncRequesterProtocol
+from ..types.user import GetUserResourcesOutput, ListUsersOutput
+
+
+class AsyncUsersAPI:
+    def __init__(self, requester: AsyncRequesterProtocol) -> None:
+        self._requester = requester
+
+    async def list(
+        self,
+        *,
+        limit: int | None = None,
+        cursor: str | None = None,
+        time_desc: bool | None = None,
+    ) -> ListUsersOutput:
+        """List all users in the project.
+
+        Args:
+            limit: Maximum number of users to return. If not provided or 0, all users will be returned. Defaults to None.
+            cursor: Cursor for pagination. Defaults to None.
+            time_desc: Order by created_at descending if True, ascending if False. Defaults to None.
+
+        Returns:
+            ListUsersOutput containing the list of users and pagination information.
+        """
+        params = build_params(limit=limit, cursor=cursor, time_desc=time_desc)
+        data = await self._requester.request("GET", "/user/ls", params=params or None)
+        return ListUsersOutput.model_validate(data)
+
+    async def get_resources(self, identifier: str) -> GetUserResourcesOutput:
+        """Get resource counts for a user.
+
+        Args:
+            identifier: The user identifier string.
+
+        Returns:
+            GetUserResourcesOutput containing counts for Spaces, Sessions, Disks, and Skills.
+        """
+        data = await self._requester.request(
+            "GET", f"/user/{quote(identifier, safe='')}/resources"
+        )
+        return GetUserResourcesOutput.model_validate(data)
+
+    async def delete(self, identifier: str) -> None:
+        """Delete a user and cascade delete all associated resources (Space, Session, Disk, Skill).
+
+        Args:
+            identifier: The user identifier string.
+        """
+        await self._requester.request("DELETE", f"/user/{quote(identifier, safe='')}")

{acontext-0.0.16 → acontext-0.0.17}/src/acontext/resources/disks.py

@@ -2,10 +2,14 @@
 Disk and artifact endpoints.
 """
 
+from __future__ import annotations
+
 import json
 from collections.abc import Mapping
 from typing import Any, BinaryIO, cast
 
+from pydantic import TypeAdapter
+
 from .._utils import build_params
 from ..client_types import RequesterProtocol
 from ..types.disk import (
@@ -195,8 +199,85 @@ class DiskArtifactsAPI:
         *,
         path: str | None = None,
     ) -> ListArtifactsResp:
+        """List artifacts in a disk at a specific path.
+        
+        Args:
+            disk_id: The UUID of the disk.
+            path: Directory path to list. Defaults to None (root).
+            
+        Returns:
+            ListArtifactsResp containing the list of artifacts.
+        """
         params: dict[str, Any] = {}
         if path is not None:
             params["path"] = path
         data = self._requester.request("GET", f"/disk/{disk_id}/artifact/ls", params=params or None)
         return ListArtifactsResp.model_validate(data)
+
+    def grep_artifacts(
+        self,
+        disk_id: str,
+        *,
+        query: str,
+        limit: int = 100,
+    ) -> list[Artifact]:
+        """Search artifact content using regex pattern.
+        
+        Args:
+            disk_id: The disk ID to search in
+            query: Regex pattern to search for in file content
+            limit: Maximum number of results (default 100, max 1000)
+            
+        Returns:
+            List of matching artifacts
+            
+        Example:
+        ```python
+            # Search for TODO comments in code
+            results = client.disks.artifacts.grep_artifacts(
+                disk_id="disk-uuid",
+                query="TODO.*bug"
+            )
+        ```
+        """
+        params = build_params(query=query, limit=limit)
+        data = self._requester.request(
+            "GET",
+            f"/disk/{disk_id}/artifact/grep",
+            params=params
+        )
+        return TypeAdapter(list[Artifact]).validate_python(data)
+
+    def glob_artifacts(
+        self,
+        disk_id: str,
+        *,
+        query: str,
+        limit: int = 100,
+    ) -> list[Artifact]:
+        """Search artifact paths using glob pattern.
+        
+        Args:
+            disk_id: The disk ID to search in
+            query: Glob pattern (e.g., '**/*.py', '*.txt')
+            limit: Maximum number of results (default 100, max 1000)
+            
+        Returns:
+            List of matching artifacts
+            
+        Example:
+        ```python
+            # Find all Python files
+            results = client.disks.artifacts.glob_artifacts(
+                disk_id="disk-uuid",
+                query="**/*.py"
+            )
+        ```
+        """
+        params = build_params(query=query, limit=limit)
+        data = self._requester.request(
+            "GET",
+            f"/disk/{disk_id}/artifact/glob",
+            params=params
+        )
+        return TypeAdapter(list[Artifact]).validate_python(data)

acontext-0.0.17/src/acontext/resources/users.py

@@ -0,0 +1,57 @@
+"""
+User management endpoints.
+"""
+
+from urllib.parse import quote
+
+from .._utils import build_params
+from ..client_types import RequesterProtocol
+from ..types.user import GetUserResourcesOutput, ListUsersOutput
+
+
+class UsersAPI:
+    def __init__(self, requester: RequesterProtocol) -> None:
+        self._requester = requester
+
+    def list(
+        self,
+        *,
+        limit: int | None = None,
+        cursor: str | None = None,
+        time_desc: bool | None = None,
+    ) -> ListUsersOutput:
+        """List all users in the project.
+
+        Args:
+            limit: Maximum number of users to return. If not provided or 0, all users will be returned. Defaults to None.
+            cursor: Cursor for pagination. Defaults to None.
+            time_desc: Order by created_at descending if True, ascending if False. Defaults to None.
+
+        Returns:
+            ListUsersOutput containing the list of users and pagination information.
+        """
+        params = build_params(limit=limit, cursor=cursor, time_desc=time_desc)
+        data = self._requester.request("GET", "/user/ls", params=params or None)
+        return ListUsersOutput.model_validate(data)
+
+    def get_resources(self, identifier: str) -> GetUserResourcesOutput:
+        """Get resource counts for a user.
+
+        Args:
+            identifier: The user identifier string.
+
+        Returns:
+            GetUserResourcesOutput containing counts for Spaces, Sessions, Disks, and Skills.
+        """
+        data = self._requester.request(
+            "GET", f"/user/{quote(identifier, safe='')}/resources"
+        )
+        return GetUserResourcesOutput.model_validate(data)
+
+    def delete(self, identifier: str) -> None:
+        """Delete a user and cascade delete all associated resources (Space, Session, Disk, Skill).
+
+        Args:
+            identifier: The user identifier string.
+        """
+        self._requester.request("DELETE", f"/user/{quote(identifier, safe='')}")

{acontext-0.0.16 → acontext-0.0.17}/src/acontext/types/__init__.py

@@ -45,6 +45,12 @@ from .skill import (
     Skill,
     SkillCatalogItem,
 )
+from .user import (
+    GetUserResourcesOutput,
+    ListUsersOutput,
+    User,
+    UserResourceCounts,
+)
 
 __all__ = [
     # Disk types
@@ -88,4 +94,9 @@ __all__ = [
     "SkillCatalogItem",
     "ListSkillsOutput",
     "GetSkillFileResp",
+    # User types
+    "GetUserResourcesOutput",
+    "ListUsersOutput",
+    "User",
+    "UserResourceCounts",
 ]

acontext-0.0.17/src/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.16/src/acontext/resources/async_users.py

@@ -1,20 +0,0 @@
-"""
-User management endpoints (async).
-"""
-
-from urllib.parse import quote
-
-from ..client_types import AsyncRequesterProtocol
-
-
-class AsyncUsersAPI:
-    def __init__(self, requester: AsyncRequesterProtocol) -> None:
-        self._requester = requester
-
-    async def delete(self, identifier: str) -> None:
-        """Delete a user and cascade delete all associated resources (Space, Session, Disk, Skill).
-
-        Args:
-            identifier: The user identifier string.
-        """
-        await self._requester.request("DELETE", f"/user/{quote(identifier, safe='')}")

acontext-0.0.16/src/acontext/resources/users.py

@@ -1,20 +0,0 @@
-"""
-User management endpoints.
-"""
-
-from urllib.parse import quote
-
-from ..client_types import RequesterProtocol
-
-
-class UsersAPI:
-    def __init__(self, requester: RequesterProtocol) -> None:
-        self._requester = requester
-
-    def delete(self, identifier: str) -> None:
-        """Delete a user and cascade delete all associated resources (Space, Session, Disk, Skill).
-
-        Args:
-            identifier: The user identifier string.
-        """
-        self._requester.request("DELETE", f"/user/{quote(identifier, safe='')}")