blade-agent-kit 0.4.1__tar.gz

blade_agent_kit-0.4.1/.gitignore

@@ -0,0 +1,55 @@
+# === 环境与密钥 ===
+.env
+.envrc
+configs/oauth_config.yaml
+
+# === IDE / 编辑器 ===
+.vscode/
+.idea/
+.cursorignore
+.cursorindexingignore
+
+# === OS ===
+.DS_Store
+Thumbs.db
+
+# === 日志 ===
+*.log
+
+# === 本地数据 ===
+/workspace
+tmp_e2e_debug*/
+web/workspace/
+web/pnpm-*.tgz
+examples/react-sdk-example/vendor/
+examples/react-sdk-example/node_modules/
+.context/
+progress.md
+task_plan.md
+findings.md
+
+# === Python ===
+__pycache__/
+*.py[codz]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.venv
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.ruff_cache/
+.mypy_cache/
+.pytype/
+
+**/node_modules/*
+**/.pnpm-store/
+.claude/settings.local.json
+
+# === Tokenizer 本地缓存 ===
+host/src/blade_agent/host/tokenize/data/**/tokenizer.json
+.claude/scheduled_tasks.lock

blade_agent_kit-0.4.1/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: blade-agent-kit
+Version: 0.4.1
+Summary: REST client for Blade Agent (AgentKit Python, v1 without Socket.IO)
+Requires-Python: <3.13,>=3.12
+Requires-Dist: httpx>=0.28.1

blade_agent_kit-0.4.1/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "blade-agent-kit"
+version = "0.4.1"
+description = "REST client for Blade Agent (AgentKit Python, v1 without Socket.IO)"
+requires-python = ">=3.12,<3.13"
+dependencies = ["httpx>=0.28.1"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/blade_agent_kit"]

blade_agent_kit-0.4.1/src/blade_agent_kit/__init__.py

@@ -0,0 +1,3 @@
+from blade_agent_kit.client import BladeAgentClient
+
+__all__ = ["BladeAgentClient"]

blade_agent_kit-0.4.1/src/blade_agent_kit/client.py

@@ -0,0 +1,138 @@
+"""Minimal REST client for Blade Agent (v1: no Socket.IO)."""
+
+from __future__ import annotations
+
+from typing import Any
+
+import httpx
+
+
+class BladeAgentClient:
+    def __init__(
+        self,
+        base_url: str,
+        *,
+        token: str | None = None,
+        timeout: float = 60.0,
+    ) -> None:
+        self._base = base_url.rstrip("/")
+        self._token = token
+        self._timeout = timeout
+
+    def _headers(self) -> dict[str, str]:
+        h: dict[str, str] = {"Accept": "application/json"}
+        if self._token:
+            h["Authorization"] = f"Bearer {self._token}"
+        return h
+
+    def _client(self) -> httpx.Client:
+        return httpx.Client(
+            base_url=self._base,
+            timeout=self._timeout,
+            headers=self._headers(),
+        )
+
+    def health(self) -> dict[str, Any]:
+        with self._client() as c:
+            r = c.get("/api/health")
+            r.raise_for_status()
+            return r.json()
+
+    def list_sessions(
+        self,
+        *,
+        limit: int = 100,
+        offset: int = 0,
+        template_id_prefix: str | None = None,
+        q: str | None = None,
+    ) -> list[dict[str, Any]]:
+        """Return session items from paginated GET /api/sessions."""
+        params: dict[str, Any] = {"limit": limit, "offset": offset}
+        if template_id_prefix:
+            params["template_id_prefix"] = template_id_prefix
+        if q:
+            params["q"] = q.strip()
+        with self._client() as c:
+            r = c.get("/api/sessions", params=params)
+            r.raise_for_status()
+            payload = r.json()
+        if isinstance(payload, list):
+            return payload
+        if isinstance(payload, dict):
+            items = payload.get("items")
+            if isinstance(items, list):
+                return items
+        raise TypeError(f"unexpected /api/sessions response: {type(payload).__name__}")
+
+    def list_sessions_page(
+        self,
+        *,
+        limit: int = 20,
+        offset: int = 0,
+        template_id_prefix: str | None = None,
+        q: str | None = None,
+    ) -> dict[str, Any]:
+        """Return full paginated payload: items, total, limit, offset."""
+        params: dict[str, Any] = {"limit": limit, "offset": offset}
+        if template_id_prefix:
+            params["template_id_prefix"] = template_id_prefix
+        if q:
+            params["q"] = q.strip()
+        with self._client() as c:
+            r = c.get("/api/sessions", params=params)
+            r.raise_for_status()
+            payload = r.json()
+        if not isinstance(payload, dict):
+            raise TypeError(f"unexpected /api/sessions response: {type(payload).__name__}")
+        return payload
+
+    def get_session(self, session_id: str) -> dict[str, Any]:
+        with self._client() as c:
+            r = c.get(f"/api/sessions/{session_id}")
+            r.raise_for_status()
+            return r.json()
+
+    def get_history(self, session_id: str) -> dict[str, Any]:
+        with self._client() as c:
+            r = c.get(f"/api/sessions/{session_id}/history")
+            r.raise_for_status()
+            return r.json()
+
+    def create_session(self, intent: str = "") -> dict[str, Any]:
+        with self._client() as c:
+            r = c.post("/api/sessions", json={"intent": intent})
+            r.raise_for_status()
+            return r.json()
+
+    def delete_session(self, session_id: str) -> dict[str, Any]:
+        with self._client() as c:
+            r = c.delete(f"/api/sessions/{session_id}")
+            r.raise_for_status()
+            return r.json()
+
+    def list_dir(self, session_id: str, dir_path: str = ".") -> list[dict[str, Any]]:
+        with self._client() as c:
+            r = c.get(f"/api/sessions/{session_id}/ls/{_encode_ls_path(dir_path)}")
+            r.raise_for_status()
+            return r.json()
+
+    def get_checkpoints(self, session_id: str) -> dict[str, Any]:
+        with self._client() as c:
+            r = c.get(f"/api/sessions/{session_id}/checkpoints")
+            r.raise_for_status()
+            return r.json()
+
+
+def _encode_ls_path(dir_path: str) -> str:
+    """Encode path for GET /api/sessions/{id}/ls/{dir_path}.
+
+    Root ``.`` must be sent as ``%2E``: ``/ls/.`` is normalized to ``/ls`` by HTTP
+    clients and does not match the server route (404). Aligns with browser
+    ``encodeURIComponent`` for nested paths (``/`` → ``%2F``).
+    """
+    from urllib.parse import quote
+
+    normalized = (dir_path or ".").strip()
+    if normalized == ".":
+        return "%2E"
+    return quote(normalized, safe="")

blade_agent_kit-0.4.1/tests/test_list_sessions.py

@@ -0,0 +1,35 @@
+"""list_sessions pagination parsing."""
+
+from blade_agent_kit.client import BladeAgentClient
+
+
+def test_list_sessions_extracts_items(monkeypatch) -> None:
+    class FakeResponse:
+        def raise_for_status(self) -> None:
+            return None
+
+        def json(self) -> dict:
+            return {
+                "items": [{"id": "s1", "intent": "a"}],
+                "total": 1,
+                "limit": 20,
+                "offset": 0,
+            }
+
+    class FakeClient:
+        def get(self, path: str, params: dict | None = None) -> FakeResponse:
+            assert path == "/api/sessions"
+            assert params == {"limit": 100, "offset": 0}
+            return FakeResponse()
+
+        def __enter__(self):
+            return self
+
+        def __exit__(self, *args: object) -> None:
+            return None
+
+    client = BladeAgentClient("http://test")
+    monkeypatch.setattr(client, "_client", lambda: FakeClient())
+
+    sessions = client.list_sessions()
+    assert sessions == [{"id": "s1", "intent": "a"}]

blade_agent_kit-0.4.1/tests/test_ls_path.py

@@ -0,0 +1,16 @@
+"""blade-agent-kit client helpers."""
+
+from blade_agent_kit.client import BladeAgentClient, _encode_ls_path
+
+
+def test_encode_ls_path_root_dot() -> None:
+    assert _encode_ls_path(".") == "%2E"
+    assert _encode_ls_path("") == "%2E"
+
+
+def test_encode_ls_path_nested() -> None:
+    assert _encode_ls_path("workspace/foo") == "workspace%2Ffoo"
+
+
+def test_client_has_get_checkpoints() -> None:
+    assert hasattr(BladeAgentClient, "get_checkpoints")