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

acontext/resources/async_spaces.py

@@ -1,200 +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 (
-    ExperienceConfirmation,
-    ListExperienceConfirmationsOutput,
-    ListSpacesOutput,
-    Space,
-    SpaceSearchResult,
-)
-
-
-class AsyncSpacesAPI:
-    def __init__(self, requester: AsyncRequesterProtocol) -> None:
-        self._requester = requester
-
-    async def list(
-        self,
-        *,
-        user: str | None = None,
-        limit: int | None = None,
-        cursor: str | None = None,
-        time_desc: bool | None = None,
-    ) -> ListSpacesOutput:
-        """List all spaces in the project.
-
-        Args:
-            user: Filter by user identifier. Defaults to None.
-            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(user=user, 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,
-        *,
-        user: str | None = None,
-        configs: Mapping[str, Any] | None = None,
-    ) -> Space:
-        """Create a new space.
-
-        Args:
-            user: Optional user identifier string. Defaults to None.
-            configs: Optional space configuration dictionary. Defaults to None.
-
-        Returns:
-            The created Space object.
-        """
-        payload: dict[str, Any] = {}
-        if user is not None:
-            payload["user"] = user
-        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 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(
-            "PUT",
-            f"/space/{space_id}/experience_confirmations/{experience_id}",
-            json_data=payload,
-        )
-        if data is None:
-            return None
-        return ExperienceConfirmation.model_validate(data)

acontext/resources/blocks.py

@@ -1,163 +0,0 @@
-"""
-Block endpoints.
-"""
-
-from collections.abc import Mapping
-from typing import Any
-
-from ..client_types import RequesterProtocol
-from ..types.block import Block
-from ..types.tool import InsertBlockResponse
-
-
-class BlocksAPI:
-    def __init__(self, requester: RequesterProtocol) -> None:
-        self._requester = requester
-
-    def list(
-        self,
-        space_id: str,
-        *,
-        parent_id: str | None = None,
-        block_type: str | None = None,
-    ) -> list[Block]:
-        """List blocks in a space.
-        
-        Args:
-            space_id: The UUID of the space.
-            parent_id: Filter blocks by parent ID. Defaults to None.
-            block_type: Filter blocks by type (e.g., "page", "folder", "text", "sop"). Defaults to None.
-            
-        Returns:
-            List of Block objects.
-        """
-        params: dict[str, Any] = {}
-        if parent_id is not None:
-            params["parent_id"] = parent_id
-        if block_type is not None:
-            params["type"] = block_type
-        data = self._requester.request("GET", f"/space/{space_id}/block", params=params or None)
-        return [Block.model_validate(item) for item in data]
-
-    def create(
-        self,
-        space_id: str,
-        *,
-        block_type: str,
-        parent_id: str | None = None,
-        title: str | None = None,
-        props: Mapping[str, Any] | None = None,
-    ) -> InsertBlockResponse:
-        """Create a new block in a space.
-        
-        Args:
-            space_id: The UUID of the space.
-            block_type: The type of block (e.g., "page", "folder", "text", "sop").
-            parent_id: Optional parent block ID. Defaults to None.
-            title: Optional block title. Defaults to None.
-            props: Optional block properties dictionary. Defaults to None.
-            
-        Returns:
-            InsertBlockResponse containing the new block ID.
-        """
-        payload: dict[str, Any] = {"type": block_type}
-        if parent_id is not None:
-            payload["parent_id"] = parent_id
-        if title is not None:
-            payload["title"] = title
-        if props is not None:
-            payload["props"] = props
-        data = self._requester.request("POST", f"/space/{space_id}/block", json_data=payload)
-        return InsertBlockResponse.model_validate(data)
-
-    def delete(self, space_id: str, block_id: str) -> None:
-        """Delete a block by its ID.
-        
-        Args:
-            space_id: The UUID of the space.
-            block_id: The UUID of the block to delete.
-        """
-        self._requester.request("DELETE", f"/space/{space_id}/block/{block_id}")
-
-    def get_properties(self, space_id: str, block_id: str) -> Block:
-        """Get block properties.
-        
-        Args:
-            space_id: The UUID of the space.
-            block_id: The UUID of the block.
-            
-        Returns:
-            Block object containing the properties.
-        """
-        data = self._requester.request("GET", f"/space/{space_id}/block/{block_id}/properties")
-        return Block.model_validate(data)
-
-    def update_properties(
-        self,
-        space_id: str,
-        block_id: str,
-        *,
-        title: str | None = None,
-        props: Mapping[str, Any] | None = None,
-    ) -> None:
-        """Update block properties.
-        
-        Args:
-            space_id: The UUID of the space.
-            block_id: The UUID of the block.
-            title: Optional block title. Defaults to None.
-            props: Optional block properties dictionary. Defaults to None.
-            
-        Raises:
-            ValueError: If both title and props are None.
-        """
-        payload: dict[str, Any] = {}
-        if title is not None:
-            payload["title"] = title
-        if props is not None:
-            payload["props"] = props
-        if not payload:
-            raise ValueError("title or props must be provided")
-        self._requester.request("PUT", f"/space/{space_id}/block/{block_id}/properties", json_data=payload)
-
-    def move(
-        self,
-        space_id: str,
-        block_id: str,
-        *,
-        parent_id: str | None = None,
-        sort: int | None = None,
-    ) -> None:
-        """Move a block by updating its parent or sort order.
-        
-        Args:
-            space_id: The UUID of the space.
-            block_id: The UUID of the block to move.
-            parent_id: Optional new parent block ID. Defaults to None.
-            sort: Optional new sort order. Defaults to None.
-            
-        Raises:
-            ValueError: If both parent_id and sort are None.
-        """
-        payload: dict[str, Any] = {}
-        if parent_id is not None:
-            payload["parent_id"] = parent_id
-        if sort is not None:
-            payload["sort"] = sort
-        if not payload:
-            raise ValueError("parent_id or sort must be provided")
-        self._requester.request("PUT", f"/space/{space_id}/block/{block_id}/move", json_data=payload)
-
-    def update_sort(self, space_id: str, block_id: str, *, sort: int) -> None:
-        """Update block sort order.
-        
-        Args:
-            space_id: The UUID of the space.
-            block_id: The UUID of the block.
-            sort: The new sort order.
-        """
-        self._requester.request(
-            "PUT",
-            f"/space/{space_id}/block/{block_id}/sort",
-            json_data={"sort": sort},
-        )

acontext/resources/spaces.py

@@ -1,198 +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 (
-    ExperienceConfirmation,
-    ListExperienceConfirmationsOutput,
-    ListSpacesOutput,
-    Space,
-    SpaceSearchResult,
-)
-
-
-class SpacesAPI:
-    def __init__(self, requester: RequesterProtocol) -> None:
-        self._requester = requester
-
-    def list(
-        self,
-        *,
-        user: str | None = None,
-        limit: int | None = None,
-        cursor: str | None = None,
-        time_desc: bool | None = None,
-    ) -> ListSpacesOutput:
-        """List all spaces in the project.
-
-        Args:
-            user: Filter by user identifier. Defaults to None.
-            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(user=user, 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,
-        *,
-        user: str | None = None,
-        configs: Mapping[str, Any] | None = None,
-    ) -> Space:
-        """Create a new space.
-
-        Args:
-            user: Optional user identifier string. Defaults to None.
-            configs: Optional space configuration dictionary. Defaults to None.
-
-        Returns:
-            The created Space object.
-        """
-        payload: dict[str, Any] = {}
-        if user is not None:
-            payload["user"] = user
-        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 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(
-            "PUT",
-            f"/space/{space_id}/experience_confirmations/{experience_id}",
-            json_data=payload,
-        )
-        if data is None:
-            return None
-        return ExperienceConfirmation.model_validate(data)

acontext/types/block.py

@@ -1,26 +0,0 @@
-"""Type definitions for block resources."""
-
-from typing import Any
-
-from pydantic import BaseModel, Field
-
-
-class Block(BaseModel):
-    """Block model representing a block in a space."""
-
-    id: str = Field(..., description="Block UUID")
-    space_id: str = Field(..., description="Space UUID")
-    type: str = Field(..., description="Block type: 'page', 'folder', 'text', 'sop', etc.")
-    parent_id: str | None = Field(None, description="Parent block UUID, optional")
-    title: str = Field(..., description="Block title")
-    props: dict[str, Any] = Field(..., description="Block properties dictionary")
-    sort: int = Field(..., description="Sort order")
-    is_archived: bool = Field(..., description="Whether the block is archived")
-    created_at: str = Field(..., description="ISO 8601 formatted creation timestamp")
-    updated_at: str = Field(..., description="ISO 8601 formatted update timestamp")
-    children: list["Block"] | None = Field(None, description="List of child blocks, optional")
-
-
-# Rebuild model to resolve forward references
-Block.model_rebuild()
-

acontext/types/space.py

@@ -1,70 +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")
-    user_id: str | None = Field(None, description="User 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")
-
-
-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")