hypercli-sdk 2026.6.21__tar.gz → 2026.6.26__tar.gz

{hypercli_sdk-2026.6.21 → hypercli_sdk-2026.6.26}/.gitignore

@@ -27,6 +27,7 @@ coverage
 # Misc
 .DS_Store
 .agents/
+.opencode/
 *.pem
 
 # IDE

{hypercli_sdk-2026.6.21 → hypercli_sdk-2026.6.26}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypercli-sdk
-Version: 2026.6.21
+Version: 2026.6.26
 Summary: Python SDK for HyperCLI - GPU orchestration and HyperAgent API
 Project-URL: Homepage, https://hypercli.com
 Project-URL: Documentation, https://docs.hypercli.com
@@ -144,14 +144,17 @@ OpenClaw uses the generic deployment launch surface. `registry_url`, `registry_a
 agent = client.deployments.create_openclaw(
     name="docs-demo",
     start=True,
-    heartbeat={"every": "0m"},  # disable upstream OpenClaw heartbeat runs
     registry_url="git.nedos.co",
     registry_auth={"username": "ci", "password": "token"},
 )
 ```
 
+Use `create_openclaw_pro(...)` for the desktop/browser image. It enables noVNC through the protected `desktop-<agent>.hypercli.app` route and sets `OPENCLAW_DESKTOP_ENABLED=1`.
+
 `heartbeat` maps directly to upstream OpenClaw config at `config.agents.defaults.heartbeat`. Omit it to keep upstream defaults, or pass values such as `heartbeat={"every": "1h", "target": "last"}`.
 
+Automatic memory indexing is off by default. Opt in with `memory_index={"on_session_start": True, "on_search": True, "watch": True, "watch_debounce_ms": 30000, "interval_minutes": 0}`.
+
 ## Error Handling
 
 ```python

{hypercli_sdk-2026.6.21 → hypercli_sdk-2026.6.26}/README.md

@@ -113,14 +113,17 @@ OpenClaw uses the generic deployment launch surface. `registry_url`, `registry_a
 agent = client.deployments.create_openclaw(
     name="docs-demo",
     start=True,
-    heartbeat={"every": "0m"},  # disable upstream OpenClaw heartbeat runs
     registry_url="git.nedos.co",
     registry_auth={"username": "ci", "password": "token"},
 )
 ```
 
+Use `create_openclaw_pro(...)` for the desktop/browser image. It enables noVNC through the protected `desktop-<agent>.hypercli.app` route and sets `OPENCLAW_DESKTOP_ENABLED=1`.
+
 `heartbeat` maps directly to upstream OpenClaw config at `config.agents.defaults.heartbeat`. Omit it to keep upstream defaults, or pass values such as `heartbeat={"every": "1h", "target": "last"}`.
 
+Automatic memory indexing is off by default. Opt in with `memory_index={"on_session_start": True, "on_search": True, "watch": True, "watch_debounce_ms": 30000, "interval_minutes": 0}`.
+
 ## Error Handling
 
 ```python

{hypercli_sdk-2026.6.21 → hypercli_sdk-2026.6.26}/hypercli/__init__.py

@@ -42,7 +42,7 @@ from .files import File, AsyncFiles
 from .user import AuthMe, RuntimeIdentity, User, UserAPI
 from .job import BaseJob, ComfyUIJob, GradioJob, apply_params, apply_graph_modes, find_node, find_nodes, load_template, graph_to_api, expand_subgraphs, DEFAULT_OBJECT_INFO
 from .logs import LogStream, stream_logs, fetch_logs
-from .agents import Deployments, Agent, OpenClawAgent, ExecResult, build_openclaw_routes
+from .agents import Deployments, Agent, OpenClawAgent, OpenClawProAgent, ExecResult, build_openclaw_routes, build_openclaw_memory_index_env
 from .shell import ShellSession, shell_connect
 from .agent import (
     HyperAgent,
@@ -83,7 +83,7 @@ from .gateway import (
     extract_gateway_chat_tool_calls,
     normalize_gateway_chat_message,
 )
-__version__ = "2026.6.21"
+__version__ = "2026.6.26"
 __all__ = [
     "HyperCLI",
     "configure",
@@ -161,8 +161,10 @@ __all__ = [
     "Deployments",
     "Agent",
     "OpenClawAgent",
+    "OpenClawProAgent",
     "ExecResult",
     "build_openclaw_routes",
+    "build_openclaw_memory_index_env",
     # Shell
     "ShellSession",
     "shell_connect",

{hypercli_sdk-2026.6.21 → hypercli_sdk-2026.6.26}/hypercli/agents.py

@@ -31,6 +31,15 @@ AGENTS_WS_URL = "wss://api.agents.hypercli.com/ws"
 DEV_AGENTS_API_BASE = "https://api.dev.hypercli.com/agents"
 DEV_AGENTS_WS_URL = "wss://api.agents.dev.hypercli.com/ws"
 DEFAULT_OPENCLAW_IMAGE = "ghcr.io/hypercli/hypercli-openclaw:prod"
+DEFAULT_OPENCLAW_PRO_IMAGE = "ghcr.io/hypercli/hypercli-openclaw:pro-prod"
+OPENCLAW_MEMORY_SEARCH_ENV_DEFAULTS = {
+    "OPENCLAW_MEMORY_SEARCH_ENABLED": "1",
+    "OPENCLAW_MEMORY_SEARCH_SYNC_ON_SESSION_START": "0",
+    "OPENCLAW_MEMORY_SEARCH_SYNC_ON_SEARCH": "0",
+    "OPENCLAW_MEMORY_SEARCH_SYNC_WATCH": "0",
+    "OPENCLAW_MEMORY_SEARCH_SYNC_WATCH_DEBOUNCE_MS": "30000",
+    "OPENCLAW_MEMORY_SEARCH_SYNC_INTERVAL_MINUTES": "0",
+}
 LAUNCH_CONFIG_KEYS = frozenset({"image", "env", "routes", "ports", "command", "entrypoint", "sync_root", "sync_enabled", "sync_uid", "sync_gid", "registry_url", "registry_auth"})
 DEFAULT_OPENCLAW_SYNC_ROOT = "/home/node"
 AGENT_FILE_MAX_BYTES = 50 * 1024 * 1024
@@ -87,6 +96,48 @@ def _resolve_openclaw_routes(
     return build_openclaw_routes(**dict(openclaw_route_options or {}))
 
 
+def _env_bool(value: object) -> str:
+    return "1" if bool(value) else "0"
+
+
+def _env_non_negative_int(name: str, value: object) -> str:
+    integer = int(value)
+    if integer < 0:
+        raise ValueError(f"{name} must be non-negative")
+    return str(integer)
+
+
+def build_openclaw_memory_index_env(memory_index: dict | None = None) -> dict[str, str]:
+    """Build OpenClaw memory-search indexing environment variables.
+
+    No env vars are emitted unless memory_index is provided; the image config
+    carries the no-auto-indexing defaults. Passing an empty dict explicitly
+    emits the default env block.
+    """
+    if memory_index is None:
+        return {}
+    env = dict(OPENCLAW_MEMORY_SEARCH_ENV_DEFAULTS)
+    if memory_index.get("enabled") is not None:
+        env["OPENCLAW_MEMORY_SEARCH_ENABLED"] = _env_bool(memory_index["enabled"])
+    if memory_index.get("on_session_start") is not None:
+        env["OPENCLAW_MEMORY_SEARCH_SYNC_ON_SESSION_START"] = _env_bool(memory_index["on_session_start"])
+    if memory_index.get("on_search") is not None:
+        env["OPENCLAW_MEMORY_SEARCH_SYNC_ON_SEARCH"] = _env_bool(memory_index["on_search"])
+    if memory_index.get("watch") is not None:
+        env["OPENCLAW_MEMORY_SEARCH_SYNC_WATCH"] = _env_bool(memory_index["watch"])
+    if memory_index.get("watch_debounce_ms") is not None:
+        env["OPENCLAW_MEMORY_SEARCH_SYNC_WATCH_DEBOUNCE_MS"] = _env_non_negative_int(
+            "watch_debounce_ms",
+            memory_index["watch_debounce_ms"],
+        )
+    if memory_index.get("interval_minutes") is not None:
+        env["OPENCLAW_MEMORY_SEARCH_SYNC_INTERVAL_MINUTES"] = _env_non_negative_int(
+            "interval_minutes",
+            memory_index["interval_minutes"],
+        )
+    return env
+
+
 def _default_gateway_timeout() -> float | None:
     raw = (
         os.environ.get("HYPERCLI_GATEWAY_TIMEOUT")
@@ -259,6 +310,16 @@ def _default_openclaw_image(image: str | None) -> str | None:
     return DEFAULT_OPENCLAW_IMAGE
 
 
+def _default_openclaw_pro_image(image: str | None) -> str | None:
+    if image is not None:
+        return image
+    return DEFAULT_OPENCLAW_PRO_IMAGE
+
+
+def _truthy_env(value: object) -> bool:
+    return str(value or "").strip().lower() in {"1", "true", "yes", "on", "enabled"}
+
+
 def _parse_dt(val):
     if isinstance(val, str) and val:
         return datetime.fromisoformat(val.replace("Z", "+00:00"))
@@ -317,6 +378,17 @@ def _is_openclaw_agent_data(data: dict) -> bool:
     return False
 
 
+def _is_openclaw_pro_agent_data(data: dict) -> bool:
+    launch_config = data.get("launch_config")
+    if not isinstance(launch_config, dict):
+        return False
+    env = launch_config.get("env")
+    if isinstance(env, dict) and _truthy_env(env.get("OPENCLAW_DESKTOP_ENABLED")):
+        return True
+    image = str(launch_config.get("image") or "")
+    return "hypercli-openclaw:pro" in image or image.endswith("-pro")
+
+
 @dataclass
 class Agent:
     """Generic agent returned by the HyperClaw backend."""
@@ -953,6 +1025,11 @@ class OpenClawAgent(Agent):
         return await self.channel_upsert("discord", channel_config, account_id=account_id)
 
 
+@dataclass
+class OpenClawProAgent(OpenClawAgent):
+    """OpenClaw agent launched with the pro desktop/browser preset."""
+
+
 @dataclass
 class ExecResult:
     """Result of a one-shot command execution."""
@@ -1009,7 +1086,9 @@ class Deployments:
         )
 
     def _hydrate_agent(self, data: dict) -> Agent:
-        if _is_openclaw_agent_data(data):
+        if _is_openclaw_pro_agent_data(data):
+            agent = OpenClawProAgent.from_dict(data)
+        elif _is_openclaw_agent_data(data):
             agent = OpenClawAgent.from_dict(data)
         else:
             agent = Agent.from_dict(data)
@@ -1182,8 +1261,9 @@ class Deployments:
         start: bool = True,
         openclaw_routes: dict | None = None,
         openclaw_route_options: dict | None = None,
+        memory_index: dict | None = None,
     ) -> Agent:
-        effective_env = dict(env or {})
+        effective_env = {**build_openclaw_memory_index_env(memory_index), **dict(env or {})}
         return self.create(
             name=name,
             size=size,
@@ -1212,6 +1292,62 @@ class Deployments:
             start=start,
         )
 
+    def create_openclaw_pro(
+        self,
+        name: str = None,
+        size: str = None,
+        config: dict = None,
+        tags: list[str] = None,
+        env: dict = None,
+        ports: list = None,
+        routes: dict = None,
+        command: list[str] = None,
+        entrypoint: list[str] = None,
+        image: str = None,
+        sync_root: str = None,
+        sync_enabled: bool = None,
+        sync_uid: int = None,
+        sync_gid: int = None,
+        registry_url: str = None,
+        registry_auth: dict = None,
+        gateway_token: str = None,
+        heartbeat: dict = None,
+        meta_ui: dict = None,
+        dry_run: bool = False,
+        start: bool = True,
+        openclaw_routes: dict | None = None,
+        openclaw_route_options: dict | None = None,
+        memory_index: dict | None = None,
+    ) -> Agent:
+        effective_env = {"OPENCLAW_DESKTOP_ENABLED": "1", **dict(env or {})}
+        effective_route_options = {"include_desktop": True, **dict(openclaw_route_options or {})}
+        return self.create_openclaw(
+            name=name,
+            size=size,
+            config=config,
+            tags=tags,
+            env=effective_env,
+            ports=ports,
+            routes=routes,
+            command=command,
+            entrypoint=entrypoint,
+            image=_default_openclaw_pro_image(image),
+            sync_root=sync_root,
+            sync_enabled=sync_enabled,
+            sync_uid=sync_uid,
+            sync_gid=sync_gid,
+            registry_url=registry_url,
+            registry_auth=registry_auth,
+            gateway_token=gateway_token,
+            heartbeat=heartbeat,
+            meta_ui=meta_ui,
+            dry_run=dry_run,
+            start=start,
+            openclaw_routes=openclaw_routes,
+            openclaw_route_options=effective_route_options,
+            memory_index=memory_index,
+        )
+
     def budget(self) -> dict:
         """Get the user's current agent resource budget and usage.
 
@@ -1345,8 +1481,9 @@ class Deployments:
         dry_run: bool = False,
         openclaw_routes: dict | None = None,
         openclaw_route_options: dict | None = None,
+        memory_index: dict | None = None,
     ) -> Agent:
-        effective_env = dict(env or {})
+        effective_env = {**build_openclaw_memory_index_env(memory_index), **dict(env or {})}
         return self.start(
             agent_id,
             config=config,
@@ -1371,6 +1508,54 @@ class Deployments:
             dry_run=dry_run,
         )
 
+    def start_openclaw_pro(
+        self,
+        agent_id: str,
+        config: dict = None,
+        env: dict = None,
+        ports: list = None,
+        routes: dict = None,
+        command: list[str] = None,
+        entrypoint: list[str] = None,
+        image: str = None,
+        sync_root: str = None,
+        sync_enabled: bool = None,
+        sync_uid: int = None,
+        sync_gid: int = None,
+        registry_url: str = None,
+        registry_auth: dict = None,
+        gateway_token: str = None,
+        heartbeat: dict = None,
+        dry_run: bool = False,
+        openclaw_routes: dict | None = None,
+        openclaw_route_options: dict | None = None,
+        memory_index: dict | None = None,
+    ) -> Agent:
+        effective_env = {"OPENCLAW_DESKTOP_ENABLED": "1", **dict(env or {})}
+        effective_route_options = {"include_desktop": True, **dict(openclaw_route_options or {})}
+        return self.start_openclaw(
+            agent_id,
+            config=config,
+            env=effective_env,
+            ports=ports,
+            routes=routes,
+            command=command,
+            entrypoint=entrypoint,
+            image=_default_openclaw_pro_image(image),
+            sync_root=sync_root,
+            sync_enabled=sync_enabled,
+            sync_uid=sync_uid,
+            sync_gid=sync_gid,
+            registry_url=registry_url,
+            registry_auth=registry_auth,
+            gateway_token=gateway_token,
+            heartbeat=heartbeat,
+            dry_run=dry_run,
+            openclaw_routes=openclaw_routes,
+            openclaw_route_options=effective_route_options,
+            memory_index=memory_index,
+        )
+
     def update(
         self,
         agent_id: str,

{hypercli_sdk-2026.6.21 → hypercli_sdk-2026.6.26}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypercli-sdk"
-version = "2026.6.21"
+version = "2026.6.26"
 description = "Python SDK for HyperCLI - GPU orchestration and HyperAgent API"
 readme = "README.md"
 requires-python = ">=3.10"

{hypercli_sdk-2026.6.21 → hypercli_sdk-2026.6.26}/tests/test_agents.py

@@ -15,8 +15,10 @@ from hypercli.agents import (
     AGENT_FILE_TRANSFER_CHUNK_BYTES,
     Agent,
     DEFAULT_OPENCLAW_IMAGE,
+    DEFAULT_OPENCLAW_PRO_IMAGE,
     Deployments,
     OpenClawAgent,
+    OpenClawProAgent,
     ExecResult,
     _build_agent_launch,
     build_openclaw_routes,
@@ -454,7 +456,7 @@ def test_build_agent_launch_includes_command_and_entrypoint():
 def test_build_agent_launch_merges_heartbeat_defaults():
     launch, _gateway_token = _build_agent_launch(
         {"agents": {"defaults": {"model": "openai/gpt-5.4", "heartbeat": {"target": "last"}}}},
-        heartbeat={"every": "0m", "includeSystemPromptSection": False},
+        heartbeat={"every": "1h", "target": "last"},
         gateway_token="gw-token",
     )
 
@@ -464,8 +466,7 @@ def test_build_agent_launch_merges_heartbeat_defaults():
                 "model": "openai/gpt-5.4",
                 "heartbeat": {
                     "target": "last",
-                    "every": "0m",
-                    "includeSystemPromptSection": False,
+                    "every": "1h",
                 },
             }
         }
@@ -543,6 +544,81 @@ def test_create_openclaw_respects_explicit_empty_routes(agents_client):
         assert posted_json["routes"] == {}
 
 
+def test_create_openclaw_pro_defaults_desktop_image_env_and_routes(agents_client):
+    with patch("httpx.Client") as mock_client_class, patch("hypercli.agents.secrets.token_hex", return_value="gw-token-123"):
+        mock_client = MagicMock()
+        mock_response = Mock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {
+            "id": "agent-123",
+            "user_id": "user-456",
+            "pod_id": "pod-789",
+            "pod_name": "test-pod",
+            "state": "starting",
+            "launch_config": {
+                "image": DEFAULT_OPENCLAW_PRO_IMAGE,
+                "env": {"OPENCLAW_DESKTOP_ENABLED": "1"},
+                "routes": {"openclaw": {"port": 18789, "auth": False, "prefix": ""}},
+            },
+        }
+        mock_client.post.return_value = mock_response
+        mock_client.__enter__.return_value = mock_client
+        mock_client.__exit__.return_value = False
+        mock_client_class.return_value = mock_client
+
+        agent = agents_client.create_openclaw_pro(name="test-agent")
+
+        posted_json = mock_client.post.call_args[1]["json"]
+        assert posted_json["image"] == DEFAULT_OPENCLAW_PRO_IMAGE
+        assert posted_json["env"]["OPENCLAW_DESKTOP_ENABLED"] == "1"
+        assert "OPENCLAW_MEMORY_SEARCH_SYNC_ON_SESSION_START" not in posted_json["env"]
+        assert posted_json["routes"] == {
+            "openclaw": {"port": 18789, "auth": False, "prefix": ""},
+            "desktop": {"port": 3000, "auth": True, "prefix": "desktop"},
+        }
+        assert isinstance(agent, OpenClawProAgent)
+
+
+def test_create_openclaw_accepts_memory_index_options(agents_client):
+    with patch("httpx.Client") as mock_client_class, patch("hypercli.agents.secrets.token_hex", return_value="gw-token-123"):
+        mock_client = MagicMock()
+        mock_response = Mock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {
+            "id": "agent-123",
+            "user_id": "user-456",
+            "pod_id": "pod-789",
+            "pod_name": "test-pod",
+            "state": "starting",
+            "launch_config": {
+                "env": {},
+                "routes": {"openclaw": {"port": 18789, "auth": False, "prefix": ""}},
+            },
+        }
+        mock_client.post.return_value = mock_response
+        mock_client.__enter__.return_value = mock_client
+        mock_client.__exit__.return_value = False
+        mock_client_class.return_value = mock_client
+
+        agents_client.create_openclaw(
+            name="test-agent",
+            memory_index={
+                "on_session_start": True,
+                "on_search": True,
+                "watch": True,
+                "watch_debounce_ms": 60000,
+                "interval_minutes": 120,
+            },
+        )
+
+        posted_json = mock_client.post.call_args[1]["json"]
+        assert posted_json["env"]["OPENCLAW_MEMORY_SEARCH_SYNC_ON_SESSION_START"] == "1"
+        assert posted_json["env"]["OPENCLAW_MEMORY_SEARCH_SYNC_ON_SEARCH"] == "1"
+        assert posted_json["env"]["OPENCLAW_MEMORY_SEARCH_SYNC_WATCH"] == "1"
+        assert posted_json["env"]["OPENCLAW_MEMORY_SEARCH_SYNC_WATCH_DEBOUNCE_MS"] == "60000"
+        assert posted_json["env"]["OPENCLAW_MEMORY_SEARCH_SYNC_INTERVAL_MINUTES"] == "120"
+
+
 def test_create_openclaw_includes_heartbeat_when_requested(agents_client):
     with patch("httpx.Client") as mock_client_class, patch("hypercli.agents.secrets.token_hex", return_value="gw-token-123"):
         mock_client = MagicMock()
@@ -562,13 +638,13 @@ def test_create_openclaw_includes_heartbeat_when_requested(agents_client):
 
         agents_client.create_openclaw(
             name="test-agent",
-            heartbeat={"every": "0m", "includeSystemPromptSection": False},
+            heartbeat={"every": "1h", "target": "last"},
         )
 
         posted_json = mock_client.post.call_args[1]["json"]
         assert posted_json["config"]["agents"]["defaults"]["heartbeat"] == {
-            "every": "0m",
-            "includeSystemPromptSection": False,
+            "every": "1h",
+            "target": "last",
         }
 
 @pytest.fixture