acontext 0.0.1.dev4__tar.gz → 0.0.1.dev6__tar.gz

{acontext-0.0.1.dev4 → acontext-0.0.1.dev6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: acontext
-Version: 0.0.1.dev4
+Version: 0.0.1.dev6
 Summary: Python SDK for the Acontext API
 Keywords: acontext,sdk,client,api
 Requires-Dist: httpx>=0.28.1
@@ -91,3 +91,79 @@ try:
 finally:
     client.close()
 ```
+
+### Semantic search within spaces
+
+The SDK provides three powerful semantic search APIs for finding content within your spaces:
+
+#### 1. Experience Search (Advanced AI-powered search)
+
+The most sophisticated search that can operate in two modes: **fast** (quick semantic search) or **agentic** (AI-powered iterative refinement).
+
+```python
+from acontext import AcontextClient
+
+client = AcontextClient(api_key="sk_project_token")
+
+# Fast mode - quick semantic search
+result = client.spaces.experience_search(
+    space_id="space-uuid",
+    query="How to implement authentication?",
+    limit=10,
+    mode="fast",
+)
+
+# Agentic mode - AI-powered iterative search
+result = client.spaces.experience_search(
+    space_id="space-uuid",
+    query="What are the best practices for API security?",
+    limit=10,
+    mode="agentic",
+    semantic_threshold=0.8,
+    max_iterations=20,
+)
+
+# Access results
+for block in result.cited_blocks:
+    print(f"{block.title} (distance: {block.distance})")
+
+if result.final_answer:
+    print(f"AI Answer: {result.final_answer}")
+```
+
+#### 2. Semantic Global (Search page/folder titles)
+
+Search for pages and folders by their titles using semantic similarity (like a semantic version of `glob`):
+
+```python
+# Find pages about authentication
+results = client.spaces.semantic_global(
+    space_id="space-uuid",
+    query="authentication and authorization pages",
+    limit=10,
+    threshold=1.0,  # Only show results with distance < 1.0
+)
+
+for block in results:
+    print(f"{block.title} - {block.type}")
+```
+
+#### 3. Semantic Grep (Search content blocks)
+
+Search through actual content blocks using semantic similarity (like a semantic version of `grep`):
+
+```python
+# Find code examples for JWT validation
+results = client.spaces.semantic_grep(
+    space_id="space-uuid",
+    query="JWT token validation code examples",
+    limit=15,
+    threshold=0.7,
+)
+
+for block in results:
+    print(f"{block.title} - distance: {block.distance}")
+    print(f"Content: {block.props.get('text', '')[:100]}...")
+```
+
+See `examples/search_usage.py` for more detailed examples including async usage.

acontext-0.0.1.dev6/README.md

@@ -0,0 +1,154 @@
+## acontext client for python
+
+Python SDK for interacting with the Acontext REST API.
+
+### Installation
+
+```bash
+pip install acontext
+```
+
+> Requires Python 3.10 or newer.
+
+### Quickstart
+
+```python
+from acontext import AcontextClient, MessagePart
+
+with AcontextClient(api_key="sk_project_token") as client:
+    # List spaces for the authenticated project
+    spaces = client.spaces.list()
+
+    # Create a session bound to the first space
+    session = client.sessions.create(space_id=spaces[0]["id"])
+
+    # Send a text message to the session
+    client.sessions.send_message(
+        session["id"],
+        role="user",
+        parts=[MessagePart.text_part("Hello from Python!")],
+    )
+```
+
+See the inline docstrings for the full list of helpers covering sessions, spaces, disks, and artifact uploads.
+
+### Managing disks and artifacts
+
+Artifacts now live under project disks. Create a disk first, then upload files through the disk-scoped helper:
+
+```python
+from acontext import AcontextClient, FileUpload
+
+client = AcontextClient(api_key="sk_project_token")
+try:
+    disk = client.disks.create()
+    client.disks.artifacts.upsert(
+        disk["id"],
+        file=FileUpload(
+            filename="retro_notes.md",
+            content=b"# Retro Notes\nWe shipped file uploads successfully!\n",
+            content_type="text/markdown",
+        ),
+        file_path="/notes/",
+        meta={"source": "readme-demo"},
+    )
+finally:
+    client.close()
+```
+
+### Working with blocks
+
+```python
+from acontext import AcontextClient
+
+client = AcontextClient(api_key="sk_project_token")
+
+space = client.spaces.create()
+try:
+    page = client.blocks.create(space["id"], block_type="page", title="Kick-off Notes")
+    client.blocks.create(
+        space["id"],
+        parent_id=page["id"],
+        block_type="text",
+        title="First block",
+        props={"text": "Plan the sprint goals"},
+    )
+finally:
+    client.close()
+```
+
+### Semantic search within spaces
+
+The SDK provides three powerful semantic search APIs for finding content within your spaces:
+
+#### 1. Experience Search (Advanced AI-powered search)
+
+The most sophisticated search that can operate in two modes: **fast** (quick semantic search) or **agentic** (AI-powered iterative refinement).
+
+```python
+from acontext import AcontextClient
+
+client = AcontextClient(api_key="sk_project_token")
+
+# Fast mode - quick semantic search
+result = client.spaces.experience_search(
+    space_id="space-uuid",
+    query="How to implement authentication?",
+    limit=10,
+    mode="fast",
+)
+
+# Agentic mode - AI-powered iterative search
+result = client.spaces.experience_search(
+    space_id="space-uuid",
+    query="What are the best practices for API security?",
+    limit=10,
+    mode="agentic",
+    semantic_threshold=0.8,
+    max_iterations=20,
+)
+
+# Access results
+for block in result.cited_blocks:
+    print(f"{block.title} (distance: {block.distance})")
+
+if result.final_answer:
+    print(f"AI Answer: {result.final_answer}")
+```
+
+#### 2. Semantic Global (Search page/folder titles)
+
+Search for pages and folders by their titles using semantic similarity (like a semantic version of `glob`):
+
+```python
+# Find pages about authentication
+results = client.spaces.semantic_global(
+    space_id="space-uuid",
+    query="authentication and authorization pages",
+    limit=10,
+    threshold=1.0,  # Only show results with distance < 1.0
+)
+
+for block in results:
+    print(f"{block.title} - {block.type}")
+```
+
+#### 3. Semantic Grep (Search content blocks)
+
+Search through actual content blocks using semantic similarity (like a semantic version of `grep`):
+
+```python
+# Find code examples for JWT validation
+results = client.spaces.semantic_grep(
+    space_id="space-uuid",
+    query="JWT token validation code examples",
+    limit=15,
+    threshold=0.7,
+)
+
+for block in results:
+    print(f"{block.title} - distance: {block.distance}")
+    print(f"Content: {block.props.get('text', '')[:100]}...")
+```
+
+See `examples/search_usage.py` for more detailed examples including async usage.

{acontext-0.0.1.dev4 → acontext-0.0.1.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "acontext"
-version = "0.0.1.dev4"
+version = "0.0.1.dev6"
 description = "Python SDK for the Acontext API"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -18,11 +18,7 @@ Repository = "https://github.com/memodb-io/Acontext"
 Issues = "https://github.com/memodb-io/Acontext/issues"
 
 [dependency-groups]
-dev = [
-    "pytest", 
-    "ruff",
-    "pytest-asyncio"
-]
+dev = ["pytest", "ruff", "pytest-asyncio"]
 
 [build-system]
 requires = ["uv_build>=0.9.2,<0.10.0"]

acontext-0.0.1.dev6/src/acontext/resources/async_spaces.py

@@ -0,0 +1,188 @@
+"""
+Spaces endpoints (async).
+"""
+
+from collections.abc import Mapping
+from typing import Any, List
+
+from .._utils import build_params
+from ..client_types import AsyncRequesterProtocol
+from ..types.space import (
+    ListSpacesOutput,
+    SearchResultBlockItem,
+    Space,
+    SpaceSearchResult,
+)
+
+
+class AsyncSpacesAPI:
+    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,
+    ) -> ListSpacesOutput:
+        """List all spaces in the project.
+
+        Args:
+            limit: Maximum number of spaces to return. 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:
+            ListSpacesOutput containing the list of spaces and pagination information.
+        """
+        params = build_params(limit=limit, cursor=cursor, time_desc=time_desc)
+        data = await self._requester.request("GET", "/space", params=params or None)
+        return ListSpacesOutput.model_validate(data)
+
+    async def create(self, *, configs: Mapping[str, Any] | None = None) -> Space:
+        """Create a new space.
+
+        Args:
+            configs: Optional space configuration dictionary. Defaults to None.
+
+        Returns:
+            The created Space object.
+        """
+        payload: dict[str, Any] = {}
+        if configs is not None:
+            payload["configs"] = configs
+        data = await self._requester.request("POST", "/space", json_data=payload)
+        return Space.model_validate(data)
+
+    async def delete(self, space_id: str) -> None:
+        """Delete a space by its ID.
+
+        Args:
+            space_id: The UUID of the space to delete.
+        """
+        await self._requester.request("DELETE", f"/space/{space_id}")
+
+    async def update_configs(
+        self,
+        space_id: str,
+        *,
+        configs: Mapping[str, Any],
+    ) -> None:
+        """Update space configurations.
+
+        Args:
+            space_id: The UUID of the space.
+            configs: Space configuration dictionary.
+        """
+        payload = {"configs": configs}
+        await self._requester.request(
+            "PUT", f"/space/{space_id}/configs", json_data=payload
+        )
+
+    async def get_configs(self, space_id: str) -> Space:
+        """Get space configurations.
+
+        Args:
+            space_id: The UUID of the space.
+
+        Returns:
+            Space object containing the configurations.
+        """
+        data = await self._requester.request("GET", f"/space/{space_id}/configs")
+        return Space.model_validate(data)
+
+    async def experience_search(
+        self,
+        space_id: str,
+        *,
+        query: str,
+        limit: int | None = None,
+        mode: str | None = None,
+        semantic_threshold: float | None = None,
+        max_iterations: int | None = None,
+    ) -> SpaceSearchResult:
+        """Perform experience search within a space.
+
+        This is the most advanced search option that can operate in two modes:
+        - fast: Quick semantic search (default)
+        - agentic: Iterative search with AI-powered refinement
+
+        Args:
+            space_id: The UUID of the space.
+            query: The search query string.
+            limit: Maximum number of results to return (1-50, default 10).
+            mode: Search mode, either "fast" or "agentic" (default "fast").
+            semantic_threshold: Cosine distance threshold (0=identical, 2=opposite).
+            max_iterations: Maximum iterations for agentic search (1-100, default 16).
+
+        Returns:
+            SpaceSearchResult containing cited blocks and optional final answer.
+        """
+        params = build_params(
+            query=query,
+            limit=limit,
+            mode=mode,
+            semantic_threshold=semantic_threshold,
+            max_iterations=max_iterations,
+        )
+        data = await self._requester.request(
+            "GET", f"/space/{space_id}/experience_search", params=params or None
+        )
+        return SpaceSearchResult.model_validate(data)
+
+    async def semantic_global(
+        self,
+        space_id: str,
+        *,
+        query: str,
+        limit: int | None = None,
+        threshold: float | None = None,
+    ) -> List[SearchResultBlockItem]:
+        """Perform semantic global (glob) search for page/folder titles.
+
+        Searches specifically for page/folder titles using semantic similarity,
+        similar to a semantic version of the glob command.
+
+        Args:
+            space_id: The UUID of the space.
+            query: Search query for page/folder titles.
+            limit: Maximum number of results to return (1-50, default 10).
+            threshold: Cosine distance threshold (0=identical, 2=opposite).
+
+        Returns:
+            List of SearchResultBlockItem objects matching the query.
+        """
+        params = build_params(query=query, limit=limit, threshold=threshold)
+        data = await self._requester.request(
+            "GET", f"/space/{space_id}/semantic_global", params=params or None
+        )
+        return [SearchResultBlockItem.model_validate(item) for item in data]
+
+    async def semantic_grep(
+        self,
+        space_id: str,
+        *,
+        query: str,
+        limit: int | None = None,
+        threshold: float | None = None,
+    ) -> List[SearchResultBlockItem]:
+        """Perform semantic grep search for content blocks.
+
+        Searches through content blocks (actual text content) using semantic similarity,
+        similar to a semantic version of the grep command.
+
+        Args:
+            space_id: The UUID of the space.
+            query: Search query for content blocks.
+            limit: Maximum number of results to return (1-50, default 10).
+            threshold: Cosine distance threshold (0=identical, 2=opposite).
+
+        Returns:
+            List of SearchResultBlockItem objects matching the query.
+        """
+        params = build_params(query=query, limit=limit, threshold=threshold)
+        data = await self._requester.request(
+            "GET", f"/space/{space_id}/semantic_grep", params=params or None
+        )
+        return [SearchResultBlockItem.model_validate(item) for item in data]

acontext-0.0.1.dev6/src/acontext/resources/spaces.py

@@ -0,0 +1,186 @@
+"""
+Spaces endpoints.
+"""
+
+from collections.abc import Mapping
+from typing import Any, List
+
+from .._utils import build_params
+from ..client_types import RequesterProtocol
+from ..types.space import (
+    ListSpacesOutput,
+    SearchResultBlockItem,
+    Space,
+    SpaceSearchResult,
+)
+
+
+class SpacesAPI:
+    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,
+    ) -> ListSpacesOutput:
+        """List all spaces in the project.
+
+        Args:
+            limit: Maximum number of spaces to return. 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:
+            ListSpacesOutput containing the list of spaces and pagination information.
+        """
+        params = build_params(limit=limit, cursor=cursor, time_desc=time_desc)
+        data = self._requester.request("GET", "/space", params=params or None)
+        return ListSpacesOutput.model_validate(data)
+
+    def create(self, *, configs: Mapping[str, Any] | None = None) -> Space:
+        """Create a new space.
+
+        Args:
+            configs: Optional space configuration dictionary. Defaults to None.
+
+        Returns:
+            The created Space object.
+        """
+        payload: dict[str, Any] = {}
+        if configs is not None:
+            payload["configs"] = configs
+        data = self._requester.request("POST", "/space", json_data=payload)
+        return Space.model_validate(data)
+
+    def delete(self, space_id: str) -> None:
+        """Delete a space by its ID.
+
+        Args:
+            space_id: The UUID of the space to delete.
+        """
+        self._requester.request("DELETE", f"/space/{space_id}")
+
+    def update_configs(
+        self,
+        space_id: str,
+        *,
+        configs: Mapping[str, Any],
+    ) -> None:
+        """Update space configurations.
+
+        Args:
+            space_id: The UUID of the space.
+            configs: Space configuration dictionary.
+        """
+        payload = {"configs": configs}
+        self._requester.request("PUT", f"/space/{space_id}/configs", json_data=payload)
+
+    def get_configs(self, space_id: str) -> Space:
+        """Get space configurations.
+
+        Args:
+            space_id: The UUID of the space.
+
+        Returns:
+            Space object containing the configurations.
+        """
+        data = self._requester.request("GET", f"/space/{space_id}/configs")
+        return Space.model_validate(data)
+
+    def experience_search(
+        self,
+        space_id: str,
+        *,
+        query: str,
+        limit: int | None = None,
+        mode: str | None = None,
+        semantic_threshold: float | None = None,
+        max_iterations: int | None = None,
+    ) -> SpaceSearchResult:
+        """Perform experience search within a space.
+
+        This is the most advanced search option that can operate in two modes:
+        - fast: Quick semantic search (default)
+        - agentic: Iterative search with AI-powered refinement
+
+        Args:
+            space_id: The UUID of the space.
+            query: The search query string.
+            limit: Maximum number of results to return (1-50, default 10).
+            mode: Search mode, either "fast" or "agentic" (default "fast").
+            semantic_threshold: Cosine distance threshold (0=identical, 2=opposite).
+            max_iterations: Maximum iterations for agentic search (1-100, default 16).
+
+        Returns:
+            SpaceSearchResult containing cited blocks and optional final answer.
+        """
+        params = build_params(
+            query=query,
+            limit=limit,
+            mode=mode,
+            semantic_threshold=semantic_threshold,
+            max_iterations=max_iterations,
+        )
+        data = self._requester.request(
+            "GET", f"/space/{space_id}/experience_search", params=params or None
+        )
+        return SpaceSearchResult.model_validate(data)
+
+    def semantic_global(
+        self,
+        space_id: str,
+        *,
+        query: str,
+        limit: int | None = None,
+        threshold: float | None = None,
+    ) -> List[SearchResultBlockItem]:
+        """Perform semantic global (glob) search for page/folder titles.
+
+        Searches specifically for page/folder titles using semantic similarity,
+        similar to a semantic version of the glob command.
+
+        Args:
+            space_id: The UUID of the space.
+            query: Search query for page/folder titles.
+            limit: Maximum number of results to return (1-50, default 10).
+            threshold: Cosine distance threshold (0=identical, 2=opposite).
+
+        Returns:
+            List of SearchResultBlockItem objects matching the query.
+        """
+        params = build_params(query=query, limit=limit, threshold=threshold)
+        data = self._requester.request(
+            "GET", f"/space/{space_id}/semantic_global", params=params or None
+        )
+        return [SearchResultBlockItem.model_validate(item) for item in data]
+
+    def semantic_grep(
+        self,
+        space_id: str,
+        *,
+        query: str,
+        limit: int | None = None,
+        threshold: float | None = None,
+    ) -> List[SearchResultBlockItem]:
+        """Perform semantic grep search for content blocks.
+
+        Searches through content blocks (actual text content) using semantic similarity,
+        similar to a semantic version of the grep command.
+
+        Args:
+            space_id: The UUID of the space.
+            query: Search query for content blocks.
+            limit: Maximum number of results to return (1-50, default 10).
+            threshold: Cosine distance threshold (0=identical, 2=opposite).
+
+        Returns:
+            List of SearchResultBlockItem objects matching the query.
+        """
+        params = build_params(query=query, limit=limit, threshold=threshold)
+        data = self._requester.request(
+            "GET", f"/space/{space_id}/semantic_grep", params=params or None
+        )
+        return [SearchResultBlockItem.model_validate(item) for item in data]

{acontext-0.0.1.dev4 → acontext-0.0.1.dev6}/src/acontext/types/__init__.py

@@ -23,7 +23,9 @@ from .session import (
 from .block import Block
 from .space import (
     ListSpacesOutput,
+    SearchResultBlockItem,
     Space,
+    SpaceSearchResult,
 )
 
 __all__ = [
@@ -47,8 +49,9 @@ __all__ = [
     "Task",
     # Space types
     "ListSpacesOutput",
+    "SearchResultBlockItem",
     "Space",
+    "SpaceSearchResult",
     # Block types
     "Block",
 ]
-

{acontext-0.0.1.dev4 → acontext-0.0.1.dev6}/src/acontext/types/session.py

@@ -53,7 +53,9 @@ class Session(BaseModel):
     id: str = Field(..., description="Session UUID")
     project_id: str = Field(..., description="Project UUID")
     space_id: str | None = Field(None, description="Space UUID, optional")
-    configs: dict[str, Any] = Field(..., description="Session configuration dictionary")
+    configs: dict[str, Any] | None = Field(
+        None, description="Session configuration dictionary"
+    )
     created_at: str = Field(..., description="ISO 8601 formatted creation timestamp")
     updated_at: str = Field(..., description="ISO 8601 formatted update timestamp")
 
@@ -120,4 +122,3 @@ class GetTasksOutput(BaseModel):
     items: list[Task] = Field(..., description="List of tasks")
     next_cursor: str | None = Field(None, description="Cursor for pagination")
     has_more: bool = Field(..., description="Whether there are more items")
-

acontext-0.0.1.dev6/src/acontext/types/space.py

@@ -0,0 +1,46 @@
+"""Type definitions for space resources."""
+
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class Space(BaseModel):
+    """Space model representing a space resource."""
+
+    id: str = Field(..., description="Space UUID")
+    project_id: str = Field(..., description="Project UUID")
+    configs: dict[str, Any] | None = Field(
+        None, description="Space configuration dictionary"
+    )
+    created_at: str = Field(..., description="ISO 8601 formatted creation timestamp")
+    updated_at: str = Field(..., description="ISO 8601 formatted update timestamp")
+
+
+class ListSpacesOutput(BaseModel):
+    """Response model for listing spaces."""
+
+    items: list[Space] = Field(..., description="List of spaces")
+    next_cursor: str | None = Field(None, description="Cursor for pagination")
+    has_more: bool = Field(..., description="Whether there are more items")
+
+
+class SearchResultBlockItem(BaseModel):
+    """Search result block item model."""
+
+    block_id: str = Field(..., description="Block UUID")
+    title: str = Field(..., description="Block title")
+    type: str = Field(..., description="Block type")
+    props: dict[str, Any] = Field(..., description="Block properties")
+    distance: float | None = Field(
+        None, description="Cosine distance (0=identical, 2=opposite)"
+    )
+
+
+class SpaceSearchResult(BaseModel):
+    """Experience search result model."""
+
+    cited_blocks: list[SearchResultBlockItem] = Field(
+        ..., description="List of cited blocks"
+    )
+    final_answer: str | None = Field(None, description="AI-generated final answer")

acontext-0.0.1.dev4/README.md

@@ -1,78 +0,0 @@
-## acontext client for python
-
-Python SDK for interacting with the Acontext REST API.
-
-### Installation
-
-```bash
-pip install acontext
-```
-
-> Requires Python 3.10 or newer.
-
-### Quickstart
-
-```python
-from acontext import AcontextClient, MessagePart
-
-with AcontextClient(api_key="sk_project_token") as client:
-    # List spaces for the authenticated project
-    spaces = client.spaces.list()
-
-    # Create a session bound to the first space
-    session = client.sessions.create(space_id=spaces[0]["id"])
-
-    # Send a text message to the session
-    client.sessions.send_message(
-        session["id"],
-        role="user",
-        parts=[MessagePart.text_part("Hello from Python!")],
-    )
-```
-
-See the inline docstrings for the full list of helpers covering sessions, spaces, disks, and artifact uploads.
-
-### Managing disks and artifacts
-
-Artifacts now live under project disks. Create a disk first, then upload files through the disk-scoped helper:
-
-```python
-from acontext import AcontextClient, FileUpload
-
-client = AcontextClient(api_key="sk_project_token")
-try:
-    disk = client.disks.create()
-    client.disks.artifacts.upsert(
-        disk["id"],
-        file=FileUpload(
-            filename="retro_notes.md",
-            content=b"# Retro Notes\nWe shipped file uploads successfully!\n",
-            content_type="text/markdown",
-        ),
-        file_path="/notes/",
-        meta={"source": "readme-demo"},
-    )
-finally:
-    client.close()
-```
-
-### Working with blocks
-
-```python
-from acontext import AcontextClient
-
-client = AcontextClient(api_key="sk_project_token")
-
-space = client.spaces.create()
-try:
-    page = client.blocks.create(space["id"], block_type="page", title="Kick-off Notes")
-    client.blocks.create(
-        space["id"],
-        parent_id=page["id"],
-        block_type="text",
-        title="First block",
-        props={"text": "Plan the sprint goals"},
-    )
-finally:
-    client.close()
-```

acontext-0.0.1.dev4/src/acontext/resources/async_spaces.py

@@ -1,90 +0,0 @@
-"""
-Spaces endpoints (async).
-"""
-
-from collections.abc import Mapping
-from typing import Any
-
-from .._utils import build_params
-from ..client_types import AsyncRequesterProtocol
-from ..types.space import (
-    ListSpacesOutput,
-    Space,
-)
-
-
-class AsyncSpacesAPI:
-    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,
-    ) -> ListSpacesOutput:
-        """List all spaces in the project.
-        
-        Args:
-            limit: Maximum number of spaces to return. 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:
-            ListSpacesOutput containing the list of spaces and pagination information.
-        """
-        params = build_params(limit=limit, cursor=cursor, time_desc=time_desc)
-        data = await self._requester.request("GET", "/space", params=params or None)
-        return ListSpacesOutput.model_validate(data)
-
-    async def create(self, *, configs: Mapping[str, Any] | None = None) -> Space:
-        """Create a new space.
-        
-        Args:
-            configs: Optional space configuration dictionary. Defaults to None.
-            
-        Returns:
-            The created Space object.
-        """
-        payload: dict[str, Any] = {}
-        if configs is not None:
-            payload["configs"] = configs
-        data = await self._requester.request("POST", "/space", json_data=payload)
-        return Space.model_validate(data)
-
-    async def delete(self, space_id: str) -> None:
-        """Delete a space by its ID.
-        
-        Args:
-            space_id: The UUID of the space to delete.
-        """
-        await self._requester.request("DELETE", f"/space/{space_id}")
-
-    async def update_configs(
-        self,
-        space_id: str,
-        *,
-        configs: Mapping[str, Any],
-    ) -> None:
-        """Update space configurations.
-        
-        Args:
-            space_id: The UUID of the space.
-            configs: Space configuration dictionary.
-        """
-        payload = {"configs": configs}
-        await self._requester.request("PUT", f"/space/{space_id}/configs", json_data=payload)
-
-    async def get_configs(self, space_id: str) -> Space:
-        """Get space configurations.
-        
-        Args:
-            space_id: The UUID of the space.
-            
-        Returns:
-            Space object containing the configurations.
-        """
-        data = await self._requester.request("GET", f"/space/{space_id}/configs")
-        return Space.model_validate(data)
-

acontext-0.0.1.dev4/src/acontext/resources/spaces.py

@@ -1,89 +0,0 @@
-"""
-Spaces endpoints.
-"""
-
-from collections.abc import Mapping
-from typing import Any
-
-from .._utils import build_params
-from ..client_types import RequesterProtocol
-from ..types.space import (
-    ListSpacesOutput,
-    Space,
-)
-
-
-class SpacesAPI:
-    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,
-    ) -> ListSpacesOutput:
-        """List all spaces in the project.
-        
-        Args:
-            limit: Maximum number of spaces to return. 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:
-            ListSpacesOutput containing the list of spaces and pagination information.
-        """
-        params = build_params(limit=limit, cursor=cursor, time_desc=time_desc)
-        data = self._requester.request("GET", "/space", params=params or None)
-        return ListSpacesOutput.model_validate(data)
-
-    def create(self, *, configs: Mapping[str, Any] | None = None) -> Space:
-        """Create a new space.
-        
-        Args:
-            configs: Optional space configuration dictionary. Defaults to None.
-            
-        Returns:
-            The created Space object.
-        """
-        payload: dict[str, Any] = {}
-        if configs is not None:
-            payload["configs"] = configs
-        data = self._requester.request("POST", "/space", json_data=payload)
-        return Space.model_validate(data)
-
-    def delete(self, space_id: str) -> None:
-        """Delete a space by its ID.
-        
-        Args:
-            space_id: The UUID of the space to delete.
-        """
-        self._requester.request("DELETE", f"/space/{space_id}")
-
-    def update_configs(
-        self,
-        space_id: str,
-        *,
-        configs: Mapping[str, Any],
-    ) -> None:
-        """Update space configurations.
-        
-        Args:
-            space_id: The UUID of the space.
-            configs: Space configuration dictionary.
-        """
-        payload = {"configs": configs}
-        self._requester.request("PUT", f"/space/{space_id}/configs", json_data=payload)
-
-    def get_configs(self, space_id: str) -> Space:
-        """Get space configurations.
-        
-        Args:
-            space_id: The UUID of the space.
-            
-        Returns:
-            Space object containing the configurations.
-        """
-        data = self._requester.request("GET", f"/space/{space_id}/configs")
-        return Space.model_validate(data)

acontext-0.0.1.dev4/src/acontext/types/space.py

@@ -1,24 +0,0 @@
-"""Type definitions for space resources."""
-
-from typing import Any
-
-from pydantic import BaseModel, Field
-
-
-class Space(BaseModel):
-    """Space model representing a space resource."""
-
-    id: str = Field(..., description="Space UUID")
-    project_id: str = Field(..., description="Project UUID")
-    configs: dict[str, Any] = Field(..., description="Space configuration dictionary")
-    created_at: str = Field(..., description="ISO 8601 formatted creation timestamp")
-    updated_at: str = Field(..., description="ISO 8601 formatted update timestamp")
-
-
-class ListSpacesOutput(BaseModel):
-    """Response model for listing spaces."""
-
-    items: list[Space] = Field(..., description="List of spaces")
-    next_cursor: str | None = Field(None, description="Cursor for pagination")
-    has_more: bool = Field(..., description="Whether there are more items")
-