acontext 0.0.1.dev0__tar.gz → 0.0.1.dev2__tar.gz

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/PKG-INFO

@@ -1,10 +1,12 @@
 Metadata-Version: 2.3
 Name: acontext
-Version: 0.0.1.dev0
+Version: 0.0.1.dev2
 Summary: Python SDK for the Acontext API
 Keywords: acontext,sdk,client,api
 Requires-Dist: httpx>=0.28.1
-Requires-Python: >=3.13
+Requires-Dist: openai>=2.6.1
+Requires-Dist: anthropic>=0.72.0
+Requires-Python: >=3.10
 Project-URL: Homepage, https://github.com/memodb-io/Acontext
 Project-URL: Issues, https://github.com/memodb-io/Acontext/issues
 Project-URL: Repository, https://github.com/memodb-io/Acontext
@@ -20,7 +22,7 @@ Python SDK for interacting with the Acontext REST API.
 pip install acontext
 ```
 
-> Requires Python 3.13 or newer.
+> Requires Python 3.10 or newer.
 
 ### Quickstart
 
@@ -42,9 +44,33 @@ with AcontextClient(api_key="sk_project_token") as client:
     )
 ```
 
-See the inline docstrings for the full list of helpers covering sessions, spaces, artifacts and file uploads.
+See the inline docstrings for the full list of helpers covering sessions, spaces, disks, and artifact uploads.
 
-### Working with pages and blocks
+### 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/retro.md",
+        meta={"source": "readme-demo"},
+    )
+finally:
+    client.close()
+```
+
+### Working with blocks
 
 ```python
 from acontext import AcontextClient
@@ -53,7 +79,7 @@ client = AcontextClient(api_key="sk_project_token")
 
 space = client.spaces.create()
 try:
-    page = client.pages.create(space["id"], title="Kick-off Notes")
+    page = client.blocks.create(space["id"], block_type="page", title="Kick-off Notes")
     client.blocks.create(
         space["id"],
         parent_id=page["id"],

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/README.md

@@ -8,7 +8,7 @@ Python SDK for interacting with the Acontext REST API.
 pip install acontext
 ```
 
-> Requires Python 3.13 or newer.
+> Requires Python 3.10 or newer.
 
 ### Quickstart
 
@@ -30,9 +30,33 @@ with AcontextClient(api_key="sk_project_token") as client:
     )
 ```
 
-See the inline docstrings for the full list of helpers covering sessions, spaces, artifacts and file uploads.
+See the inline docstrings for the full list of helpers covering sessions, spaces, disks, and artifact uploads.
 
-### Working with pages and blocks
+### 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/retro.md",
+        meta={"source": "readme-demo"},
+    )
+finally:
+    client.close()
+```
+
+### Working with blocks
 
 ```python
 from acontext import AcontextClient
@@ -41,7 +65,7 @@ client = AcontextClient(api_key="sk_project_token")
 
 space = client.spaces.create()
 try:
-    page = client.pages.create(space["id"], title="Kick-off Notes")
+    page = client.blocks.create(space["id"], block_type="page", title="Kick-off Notes")
     client.blocks.create(
         space["id"],
         parent_id=page["id"],

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/pyproject.toml

@@ -1,10 +1,14 @@
 [project]
 name = "acontext"
-version = "0.0.1.dev0"
+version = "0.0.1.dev2"
 description = "Python SDK for the Acontext API"
 readme = "README.md"
-requires-python = ">=3.13"
-dependencies = ["httpx>=0.28.1"]
+requires-python = ">=3.10"
+dependencies = [
+    "httpx>=0.28.1",
+    "openai>=2.6.1",
+    "anthropic>=0.72.0"
+]
 keywords = ["acontext", "sdk", "client", "api"]
 
 [project.urls]

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/__init__.py

@@ -5,23 +5,17 @@ Python SDK for the Acontext API.
 from importlib import metadata as _metadata
 
 from .client import AcontextClient, FileUpload, MessagePart
-from .resources import (
-    ArtifactFilesAPI,
-    ArtifactsAPI,
-    BlocksAPI,
-    PagesAPI,
-    SessionsAPI,
-    SpacesAPI,
-)
+from .messages import AcontextMessage
+from .resources import BlocksAPI, DiskArtifactsAPI, DisksAPI, SessionsAPI, SpacesAPI
 
 __all__ = [
     "AcontextClient",
     "FileUpload",
     "MessagePart",
-    "ArtifactsAPI",
-    "ArtifactFilesAPI",
+    "AcontextMessage",
+    "DisksAPI",
+    "DiskArtifactsAPI",
     "BlocksAPI",
-    "PagesAPI",
     "SessionsAPI",
     "SpacesAPI",
     "__version__",

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/client.py

@@ -2,7 +2,8 @@
 High-level synchronous client for the Acontext API.
 """
 
-from typing import Any, BinaryIO, Mapping, MutableMapping
+from collections.abc import Mapping, MutableMapping
+from typing import Any, BinaryIO
 
 import httpx
 
@@ -10,9 +11,8 @@ from ._constants import DEFAULT_BASE_URL, DEFAULT_USER_AGENT
 from .errors import APIError, TransportError
 from .messages import MessagePart as MessagePart
 from .uploads import FileUpload as FileUpload
-from .resources.artifacts import ArtifactsAPI as ArtifactsAPI
+from .resources.disks import DisksAPI as DisksAPI
 from .resources.blocks import BlocksAPI as BlocksAPI
-from .resources.pages import PagesAPI as PagesAPI
 from .resources.sessions import SessionsAPI as SessionsAPI
 from .resources.spaces import SpacesAPI as SpacesAPI
 
@@ -71,8 +71,8 @@ class AcontextClient:
 
         self.spaces = SpacesAPI(self)
         self.sessions = SessionsAPI(self)
-        self.artifacts = ArtifactsAPI(self)
-        self.pages = PagesAPI(self)
+        self.disks = DisksAPI(self)
+        self.artifacts = self.disks.artifacts
         self.blocks = BlocksAPI(self)
 
     @property

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/client_types.py

@@ -2,7 +2,8 @@
 Common typing helpers used by resource modules to avoid circular imports.
 """
 
-from typing import Any, BinaryIO, Mapping, MutableMapping, Protocol
+from collections.abc import Mapping, MutableMapping
+from typing import Any, BinaryIO, Protocol
 
 
 class RequesterProtocol(Protocol):

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/errors.py

@@ -2,7 +2,8 @@
 Custom exceptions raised by the acontext Python client.
 """
 
-from typing import Any, Mapping, MutableMapping
+from collections.abc import Mapping, MutableMapping
+from typing import Any
 
 
 class AcontextError(Exception):

acontext-0.0.1.dev2/src/acontext/messages.py

@@ -0,0 +1,83 @@
+"""
+Support for constructing session messages.
+"""
+
+from collections.abc import Mapping, MutableMapping, Sequence
+from dataclasses import dataclass
+from typing import Any, Literal
+
+@dataclass(slots=True)
+class MessagePart:
+    """
+    Represents a single message part for ``/session/{id}/messages``.
+
+    Args:
+        type: One of ``text``, ``image``, ``audio``, ``video``, ``file``, ``tool-call``,
+            ``tool-result`` or ``data``.
+        text: Optional textual payload for ``text`` parts.
+        meta: Optional metadata dictionary accepted by the API.
+        file_field: Optional field name to use in the multipart body. When omitted the
+            client will auto-generate deterministic field names.
+    """
+
+    type: str
+    text: str | None = None
+    meta: Mapping[str, Any] | None = None
+    file_field: str | None = None
+
+    @classmethod
+    def text_part(cls, text: str, *, meta: Mapping[str, Any] | None = None) -> "MessagePart":
+        return cls(type="text", text=text, meta=meta)
+    
+    @classmethod
+    def file_field_part(cls, file_field: str, *, meta: Mapping[str, Any] | None = None) -> "MessagePart":
+        return cls(type="file", file_field=file_field, meta=meta)
+
+@dataclass(slots=True)
+class AcontextMessage:
+    """
+    Represents an Acontext-format message payload.
+    """
+
+    role: Literal["user", "assistant", "system"]
+    parts: list[MessagePart]
+    meta: MutableMapping[str, Any] | None = None
+
+
+def build_acontext_message(
+    *,
+    role: Literal["user", "assistant", "system"],
+    parts: Sequence[MessagePart | str | Mapping[str, Any]],
+    meta: Mapping[str, Any] | None = None,
+) -> AcontextMessage:
+    """
+    Construct an Acontext-format message blob and associated multipart files.
+    """
+    if role not in {"user", "assistant", "system"}:
+        raise ValueError("role must be one of {'user', 'assistant', 'system'}")
+
+    normalized_parts = [normalize_message_part(part) for part in parts]
+
+    message = AcontextMessage(
+        role=role,
+        parts=normalized_parts,
+        meta=dict(meta) if meta is not None else None,
+    )
+    return message
+
+
+def normalize_message_part(part: MessagePart | str | Mapping[str, Any]) -> MessagePart:
+    if isinstance(part, MessagePart):
+        return part
+    if isinstance(part, str):
+        return MessagePart(type="text", text=part)
+    if isinstance(part, Mapping):
+        if "type" not in part:
+            raise ValueError("mapping message parts must include a 'type'")
+        return MessagePart(
+            type=str(part["type"]),
+            text=part.get("text"),
+            meta=part.get("meta"),
+            file_field=part.get("file_field"),
+        )
+    raise TypeError("unsupported message part type")

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/resources/__init__.py

@@ -1,19 +1,14 @@
 """Resource-specific API helpers for the Acontext client."""
 
-from .artifacts import (
-    ArtifactFilesAPI,
-    ArtifactsAPI,
-)
 from .blocks import BlocksAPI
-from .pages import PagesAPI
+from .disks import DisksAPI, DiskArtifactsAPI
 from .sessions import SessionsAPI
 from .spaces import SpacesAPI
 
 __all__ = [
-    "ArtifactsAPI",
-    "ArtifactFilesAPI",
+    "DisksAPI",
+    "DiskArtifactsAPI",
     "BlocksAPI",
-    "PagesAPI",
     "SessionsAPI",
     "SpacesAPI",
 ]

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/resources/blocks.py

@@ -2,7 +2,8 @@
 Block endpoints.
 """
 
-from typing import Any, Mapping, MutableMapping
+from collections.abc import Mapping, MutableMapping
+from typing import Any
 
 from ..client_types import RequesterProtocol
 
@@ -11,26 +12,34 @@ class BlocksAPI:
     def __init__(self, requester: RequesterProtocol) -> None:
         self._requester = requester
 
-    def list(self, space_id: str, *, parent_id: str) -> Any:
-        if not parent_id:
-            raise ValueError("parent_id is required")
-        params = {"parent_id": parent_id}
-        return self._requester.request("GET", f"/space/{space_id}/block", params=params)
+    def list(
+        self,
+        space_id: str,
+        *,
+        parent_id: str | None = None,
+        block_type: str | None = None,
+    ) -> Any:
+        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
+        return self._requester.request("GET", f"/space/{space_id}/block", params=params or None)
 
     def create(
         self,
         space_id: str,
         *,
-        parent_id: str,
         block_type: str,
+        parent_id: str | None = None,
         title: str | None = None,
         props: Mapping[str, Any] | MutableMapping[str, Any] | None = None,
     ) -> Any:
-        if not parent_id:
-            raise ValueError("parent_id is required")
         if not block_type:
             raise ValueError("block_type is required")
-        payload: dict[str, Any] = {"parent_id": parent_id, "type": block_type}
+        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:
@@ -65,14 +74,16 @@ class BlocksAPI:
         space_id: str,
         block_id: str,
         *,
-        parent_id: str,
+        parent_id: str | None = None,
         sort: int | None = None,
     ) -> None:
-        if not parent_id:
-            raise ValueError("parent_id is required")
-        payload: dict[str, Any] = {"parent_id": parent_id}
+        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:

acontext-0.0.1.dev2/src/acontext/resources/disks.py

@@ -0,0 +1,109 @@
+"""
+Disk and artifact endpoints.
+"""
+
+import json
+from collections.abc import Mapping, MutableMapping
+from typing import Any, BinaryIO, cast
+
+from ..client_types import RequesterProtocol
+from ..uploads import FileUpload, normalize_file_upload
+
+
+def _bool_to_str(value: bool) -> str:
+    return "true" if value else "false"
+
+
+class DisksAPI:
+    def __init__(self, requester: RequesterProtocol) -> None:
+        self._requester = requester
+        self.artifacts = DiskArtifactsAPI(requester)
+
+    def list(self) -> Any:
+        return self._requester.request("GET", "/disk")
+
+    def create(self) -> Any:
+        return self._requester.request("POST", "/disk")
+
+    def delete(self, disk_id: str) -> None:
+        self._requester.request("DELETE", f"/disk/{disk_id}")
+
+
+class DiskArtifactsAPI:
+    def __init__(self, requester: RequesterProtocol) -> None:
+        self._requester = requester
+
+    def upsert(
+        self,
+        disk_id: str,
+        *,
+        file: FileUpload
+        | tuple[str, BinaryIO | bytes]
+        | tuple[str, BinaryIO | bytes, str | None],
+        file_path: str | None = None,
+        meta: Mapping[str, Any] | MutableMapping[str, Any] | None = None,
+    ) -> Any:
+        upload = normalize_file_upload(file)
+        files = {"file": upload.as_httpx()}
+        form: dict[str, Any] = {}
+        if file_path:
+            form["file_path"] = file_path
+        if meta is not None:
+            form["meta"] = json.dumps(cast(Mapping[str, Any], meta))
+        return self._requester.request(
+            "POST",
+            f"/disk/{disk_id}/artifact",
+            data=form or None,
+            files=files,
+        )
+
+    def get(
+        self,
+        disk_id: str,
+        *,
+        file_path: str,
+        with_public_url: bool | None = None,
+        with_content: bool | None = None,
+        expire: int | None = None,
+    ) -> Any:
+        params: dict[str, Any] = {"file_path": file_path}
+        if with_public_url is not None:
+            params["with_public_url"] = _bool_to_str(with_public_url)
+        if with_content is not None:
+            params["with_content"] = _bool_to_str(with_content)
+        if expire is not None:
+            params["expire"] = expire
+        return self._requester.request("GET", f"/disk/{disk_id}/artifact", params=params)
+
+    def update(
+        self,
+        disk_id: str,
+        *,
+        file_path: str,
+        meta: Mapping[str, Any] | MutableMapping[str, Any],
+    ) -> Any:
+        payload = {
+            "file_path": file_path,
+            "meta": json.dumps(cast(Mapping[str, Any], meta)),
+        }
+        return self._requester.request("PUT", f"/disk/{disk_id}/artifact", json_data=payload)
+
+    def delete(
+        self,
+        disk_id: str,
+        *,
+        file_path: str,
+    ) -> None:
+        params = {"file_path": file_path}
+        self._requester.request("DELETE", f"/disk/{disk_id}/artifact", params=params)
+
+    def list(
+        self,
+        disk_id: str,
+        *,
+        path: str | None = None,
+    ) -> Any:
+        params: dict[str, Any] = {}
+        if path is not None:
+            params["path"] = path
+        return self._requester.request("GET", f"/disk/{disk_id}/artifact/ls", params=params or None)

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/resources/sessions.py

@@ -1,13 +1,18 @@
-"""
-Sessions endpoints.
-"""
+"""Sessions endpoints."""
 
 import json
-from typing import Any, Mapping, MutableMapping, Sequence
+from collections.abc import Mapping, MutableMapping
+from dataclasses import asdict
+from typing import Any, BinaryIO, Literal
 
-from .._constants import SUPPORTED_ROLES
-from ..messages import MessagePart, build_message_payload
 from ..client_types import RequesterProtocol
+from ..messages import AcontextMessage
+from ..uploads import FileUpload
+from openai.types.chat import ChatCompletionMessageParam
+from anthropic.types import MessageParam
+
+UploadPayload = FileUpload | tuple[str, BinaryIO | bytes] | tuple[str, BinaryIO | bytes, str | None]
+MessageBlob = AcontextMessage | ChatCompletionMessageParam | MessageParam
 
 
 class SessionsAPI:
@@ -59,30 +64,60 @@ class SessionsAPI:
         payload = {"space_id": space_id}
         self._requester.request("POST", f"/session/{session_id}/connect_to_space", json_data=payload)
 
+    def get_tasks(
+        self,
+        session_id: str,
+        *,
+        limit: int | None = None,
+        cursor: str | None = None,
+    ) -> Any:
+        params: dict[str, Any] = {}
+        if limit is not None:
+            params["limit"] = limit
+        if cursor is not None:
+            params["cursor"] = cursor
+        return self._requester.request(
+            "GET",
+            f"/session/{session_id}/task",
+            params=params or None,
+        )
+
     def send_message(
         self,
         session_id: str,
         *,
-        role: str,
-        parts: Sequence[MessagePart | str | Mapping[str, Any]],
+        blob: MessageBlob,
+        format: Literal["acontext", "openai", "anthropic"] = "acontext",
+        file_field: str | None = "",
+        file: FileUpload | None = None
     ) -> Any:
-        if role not in SUPPORTED_ROLES:
-            raise ValueError(f"role must be one of {SUPPORTED_ROLES!r}")
-        if not parts:
-            raise ValueError("parts must contain at least one entry")
+        if format not in {"acontext", "openai", "anthropic"}:
+            raise ValueError("format must be one of {'acontext', 'openai', 'anthropic'}")
+
+        payload = {
+            "format": format,
+        }
+        if format == "acontext":
+           payload["blob"] = asdict(blob)
+        else:
+           payload["blob"] = blob
 
-        payload_parts, files = build_message_payload(parts)
-        payload = {"role": role, "parts": payload_parts}
 
-        if files:
+        file_payload: dict[str, tuple[str, BinaryIO, str | None]] | None = None
+        if file:
+            # only support upload one file now
+            file_payload = {
+                file_field: file.as_httpx()
+            }
+
+        if file_payload:
             form_data = {"payload": json.dumps(payload)}
             return self._requester.request(
                 "POST",
                 f"/session/{session_id}/messages",
                 data=form_data,
-                files=files,
+                files=file_payload,
             )
-
         return self._requester.request(
             "POST",
             f"/session/{session_id}/messages",
@@ -96,6 +131,8 @@ class SessionsAPI:
         limit: int | None = None,
         cursor: str | None = None,
         with_asset_public_url: bool | None = None,
+        format: Literal["acontext", "openai", "anthropic"] = "acontext",
+        time_desc: bool | None = None,
     ) -> Any:
         params: dict[str, Any] = {}
         if limit is not None:
@@ -104,4 +141,8 @@ class SessionsAPI:
             params["cursor"] = cursor
         if with_asset_public_url is not None:
             params["with_asset_public_url"] = "true" if with_asset_public_url else "false"
+        if format is not None:
+            params["format"] = format
+        if time_desc is not None:
+            params["time_desc"] = "true" if time_desc else "false"
         return self._requester.request("GET", f"/session/{session_id}/messages", params=params or None)

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/resources/spaces.py

@@ -2,7 +2,8 @@
 Spaces endpoints.
 """
 
-from typing import Any, Mapping, MutableMapping
+from collections.abc import Mapping, MutableMapping
+from typing import Any
 
 from ..client_types import RequesterProtocol
 
@@ -14,6 +15,9 @@ class SpacesAPI:
     def list(self) -> Any:
         return self._requester.request("GET", "/space")
 
+    def status(self) -> Any:
+        return self._requester.request("GET", "/space/status")
+
     def create(self, *, configs: Mapping[str, Any] | MutableMapping[str, Any] | None = None) -> Any:
         payload: dict[str, Any] = {}
         if configs is not None:
@@ -34,3 +38,21 @@ class SpacesAPI:
 
     def get_configs(self, space_id: str) -> Any:
         return self._requester.request("GET", f"/space/{space_id}/configs")
+
+    def get_semantic_answer(self, space_id: str, *, query: str) -> Any:
+        if not query:
+            raise ValueError("query is required")
+        params = {"query": query}
+        return self._requester.request("GET", f"/space/{space_id}/semantic_answer", params=params)
+
+    def get_semantic_global(self, space_id: str, *, query: str) -> Any:
+        if not query:
+            raise ValueError("query is required")
+        params = {"query": query}
+        return self._requester.request("GET", f"/space/{space_id}/semantic_global", params=params)
+
+    def get_semantic_grep(self, space_id: str, *, query: str) -> Any:
+        if not query:
+            raise ValueError("query is required")
+        params = {"query": query}
+        return self._requester.request("GET", f"/space/{space_id}/semantic_grep", params=params)

{acontext-0.0.1.dev0 → acontext-0.0.1.dev2}/src/acontext/uploads.py

@@ -4,7 +4,7 @@ Utilities for working with file uploads.
 
 import io
 from dataclasses import dataclass
-from typing import BinaryIO, Tuple
+from typing import BinaryIO
 
 
 @dataclass(slots=True)
@@ -19,7 +19,7 @@ class FileUpload:
     content: BinaryIO | bytes
     content_type: str | None = None
 
-    def as_httpx(self) -> Tuple[str, BinaryIO, str | None]:
+    def as_httpx(self) -> tuple[str, BinaryIO, str | None]:
         """
         Convert to the tuple format expected by ``httpx``.
         """

acontext-0.0.1.dev0/src/acontext/messages.py

@@ -1,94 +0,0 @@
-"""
-Support for constructing session messages.
-"""
-
-from dataclasses import dataclass
-from typing import Any, BinaryIO, Mapping, MutableMapping, Sequence, Tuple
-
-from .uploads import FileUpload, normalize_file_upload
-
-
-@dataclass(slots=True)
-class MessagePart:
-    """
-    Represents a single message part for ``/session/{id}/messages``.
-
-    Args:
-        type: One of ``text``, ``image``, ``audio``, ``video``, ``file``, ``tool-call``,
-            ``tool-result`` or ``data``.
-        text: Optional textual payload for ``text`` parts.
-        meta: Optional metadata dictionary accepted by the API.
-        file: Optional file attachment; required for binary part types.
-        file_field: Optional field name to use in the multipart body. When omitted the
-            client will auto-generate deterministic field names.
-    """
-
-    type: str
-    text: str | None = None
-    meta: Mapping[str, Any] | None = None
-    file: FileUpload | tuple[str, BinaryIO | bytes] | tuple[str, BinaryIO | bytes, str | None] | None = None
-    file_field: str | None = None
-
-    @classmethod
-    def text_part(cls, text: str, *, meta: Mapping[str, Any] | None = None) -> "MessagePart":
-        return cls(type="text", text=text, meta=meta)
-
-    @classmethod
-    def file_part(
-        cls,
-        upload: FileUpload | tuple[str, BinaryIO | bytes] | tuple[str, BinaryIO | bytes, str | None],
-        *,
-        meta: Mapping[str, Any] | None = None,
-        type: str = "file",
-    ) -> "MessagePart":
-        return cls(type=type, file=upload, meta=meta)
-
-
-def normalize_message_part(part: MessagePart | str | Mapping[str, Any]) -> MessagePart:
-    if isinstance(part, MessagePart):
-        return part
-    if isinstance(part, str):
-        return MessagePart(type="text", text=part)
-    if isinstance(part, Mapping):
-        if "type" not in part:
-            raise ValueError("mapping message parts must include a 'type'")
-        file = part.get("file")
-        normalized_file: FileUpload | tuple[str, BinaryIO | bytes] | tuple[str, BinaryIO | bytes, str | None] | None
-        if file is None:
-            normalized_file = None
-        else:
-            normalized_file = file  # type: ignore[assignment]
-        return MessagePart(
-            type=str(part["type"]),
-            text=part.get("text"),
-            meta=part.get("meta"),
-            file=normalized_file,
-            file_field=part.get("file_field"),
-        )
-    raise TypeError("unsupported message part type")
-
-
-def build_message_payload(
-    parts: Sequence[MessagePart | str | Mapping[str, Any]],
-) -> tuple[list[MutableMapping[str, Any]], dict[str, Tuple[str, BinaryIO, str | None]]]:
-    payload_parts: list[MutableMapping[str, Any]] = []
-    files: dict[str, Tuple[str, BinaryIO, str | None]] = {}
-
-    for idx, raw_part in enumerate(parts):
-        part = normalize_message_part(raw_part)
-        payload: MutableMapping[str, Any] = {"type": part.type}
-
-        if part.meta is not None:
-            payload["meta"] = dict(part.meta)
-        if part.text is not None:
-            payload["text"] = part.text
-
-        if part.file is not None:
-            upload = normalize_file_upload(part.file)
-            field_name = part.file_field or f"file_{idx}"
-            payload["file_field"] = field_name
-            files[field_name] = upload.as_httpx()
-
-        payload_parts.append(payload)
-
-    return payload_parts, files

acontext-0.0.1.dev0/src/acontext/resources/artifacts.py

@@ -1,98 +0,0 @@
-"""
-Artifact and file endpoints.
-"""
-
-import json
-from typing import Any, BinaryIO, Mapping, MutableMapping
-
-from ..client_types import RequesterProtocol
-from ..uploads import FileUpload, normalize_file_upload
-
-
-class ArtifactsAPI:
-    def __init__(self, requester: RequesterProtocol) -> None:
-        self._requester = requester
-        self.files = ArtifactFilesAPI(requester)
-
-    def list(self) -> Any:
-        return self._requester.request("GET", "/artifact")
-
-    def create(self) -> Any:
-        return self._requester.request("POST", "/artifact")
-
-    def delete(self, artifact_id: str) -> None:
-        self._requester.request("DELETE", f"/artifact/{artifact_id}")
-
-
-class ArtifactFilesAPI:
-    def __init__(self, requester: RequesterProtocol) -> None:
-        self._requester = requester
-
-    def upload(
-        self,
-        artifact_id: str,
-        *,
-        file: FileUpload | tuple[str, BinaryIO | bytes] | tuple[str, BinaryIO | bytes, str | None],
-        file_path: str | None = None,
-        meta: Mapping[str, Any] | MutableMapping[str, Any] | None = None,
-    ) -> Any:
-        upload = normalize_file_upload(file)
-        files = {"file": upload.as_httpx()}
-        form: dict[str, Any] = {}
-        if file_path:
-            form["file_path"] = file_path
-        if meta is not None:
-            form["meta"] = json.dumps(meta)
-        return self._requester.request(
-            "POST",
-            f"/artifact/{artifact_id}/file",
-            data=form or None,
-            files=files,
-        )
-
-    def update(
-        self,
-        artifact_id: str,
-        *,
-        file_path: str,
-        file: FileUpload | tuple[str, BinaryIO | bytes] | tuple[str, BinaryIO | bytes, str | None],
-    ) -> Any:
-        upload = normalize_file_upload(file)
-        files = {"file": upload.as_httpx()}
-        form = {"file_path": file_path}
-        return self._requester.request(
-            "PUT",
-            f"/artifact/{artifact_id}/file",
-            data=form,
-            files=files,
-        )
-
-    def delete(self, artifact_id: str, *, file_path: str) -> None:
-        params = {"file_path": file_path}
-        self._requester.request("DELETE", f"/artifact/{artifact_id}/file", params=params)
-
-    def get(
-        self,
-        artifact_id: str,
-        *,
-        file_path: str,
-        with_public_url: bool | None = None,
-        expire: int | None = None,
-    ) -> Any:
-        params: dict[str, Any] = {"file_path": file_path}
-        if with_public_url is not None:
-            params["with_public_url"] = "true" if with_public_url else "false"
-        if expire is not None:
-            params["expire"] = expire
-        return self._requester.request("GET", f"/artifact/{artifact_id}/file", params=params)
-
-    def list(
-        self,
-        artifact_id: str,
-        *,
-        path: str | None = None,
-    ) -> Any:
-        params: dict[str, Any] = {}
-        if path is not None:
-            params["path"] = path
-        return self._requester.request("GET", f"/artifact/{artifact_id}/file/ls", params=params or None)

acontext-0.0.1.dev0/src/acontext/resources/pages.py

@@ -1,82 +0,0 @@
-"""
-Page endpoints.
-"""
-
-from typing import Any, Mapping, MutableMapping
-
-from ..client_types import RequesterProtocol
-
-
-class PagesAPI:
-    def __init__(self, requester: RequesterProtocol) -> None:
-        self._requester = requester
-
-    def list(self, space_id: str, *, parent_id: str | None = None) -> Any:
-        params: dict[str, Any] = {}
-        if parent_id is not None:
-            params["parent_id"] = parent_id
-        return self._requester.request("GET", f"/space/{space_id}/page", params=params or None)
-
-    def create(
-        self,
-        space_id: str,
-        *,
-        parent_id: str | None = None,
-        title: str | None = None,
-        props: Mapping[str, Any] | MutableMapping[str, Any] | None = None,
-    ) -> Any:
-        payload: dict[str, Any] = {}
-        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
-        return self._requester.request("POST", f"/space/{space_id}/page", json_data=payload)
-
-    def delete(self, space_id: str, page_id: str) -> None:
-        self._requester.request("DELETE", f"/space/{space_id}/page/{page_id}")
-
-    def get_properties(self, space_id: str, page_id: str) -> Any:
-        return self._requester.request("GET", f"/space/{space_id}/page/{page_id}/properties")
-
-    def update_properties(
-        self,
-        space_id: str,
-        page_id: str,
-        *,
-        title: str | None = None,
-        props: Mapping[str, Any] | MutableMapping[str, Any] | None = None,
-    ) -> 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}/page/{page_id}/properties", json_data=payload)
-
-    def move(
-        self,
-        space_id: str,
-        page_id: str,
-        *,
-        parent_id: str | None = None,
-        sort: int | None = None,
-    ) -> 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}/page/{page_id}/move", json_data=payload)
-
-    def update_sort(self, space_id: str, page_id: str, *, sort: int) -> None:
-        self._requester.request(
-            "PUT",
-            f"/space/{space_id}/page/{page_id}/sort",
-            json_data={"sort": sort},
-        )