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

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypercli-sdk
-Version: 2026.6.16
+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
@@ -121,6 +121,7 @@ from openai import OpenAI
 sdk = HyperCLI(api_key="hyper_api_key", agent_api_key="sk-agent")
 plans = sdk.agent.plans()
 activation = sdk.agent.redeem_grant_code("PROMO123")
+renewal = sdk.agent.redeem_grant_code("PROMO123", extend_existing=True)
 
 client = OpenAI(
     api_key="your_hyperagent_api_key",
@@ -133,7 +134,7 @@ response = client.chat.completions.create(
 )
 ```
 
-`redeem_grant_code()` applies a promo/activation code to the current HyperClaw account and returns the created entitlement.
+`redeem_grant_code()` applies a promo/activation code to the current HyperClaw account and returns the created entitlement. Codes create new entitlements by default; pass `extend_existing=True` only for renewal/extension behavior.
 
 ## OpenClaw Agents
 
@@ -143,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.16 → hypercli_sdk-2026.6.26}/README.md

@@ -90,6 +90,7 @@ from openai import OpenAI
 sdk = HyperCLI(api_key="hyper_api_key", agent_api_key="sk-agent")
 plans = sdk.agent.plans()
 activation = sdk.agent.redeem_grant_code("PROMO123")
+renewal = sdk.agent.redeem_grant_code("PROMO123", extend_existing=True)
 
 client = OpenAI(
     api_key="your_hyperagent_api_key",
@@ -102,7 +103,7 @@ response = client.chat.completions.create(
 )
 ```
 
-`redeem_grant_code()` applies a promo/activation code to the current HyperClaw account and returns the created entitlement.
+`redeem_grant_code()` applies a promo/activation code to the current HyperClaw account and returns the created entitlement. Codes create new entitlements by default; pass `extend_existing=True` only for renewal/extension behavior.
 
 ## OpenClaw Agents
 
@@ -112,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.16 → hypercli_sdk-2026.6.26}/hypercli/__init__.py

@@ -39,9 +39,10 @@ from .voice import VoiceAPI
 from .models import Model, ModelsAPI
 from .x402 import X402Client, X402JobLaunch, X402FlowCreate, X402RenderCreate, FlowCatalogItem
 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,
@@ -82,7 +83,7 @@ from .gateway import (
     extract_gateway_chat_tool_calls,
     normalize_gateway_chat_message,
 )
-__version__ = "2026.6.16"
+__version__ = "2026.6.26"
 __all__ = [
     "HyperCLI",
     "configure",
@@ -129,6 +130,10 @@ __all__ = [
     # Files API
     "File",
     "AsyncFiles",
+    "User",
+    "UserAPI",
+    "AuthMe",
+    "RuntimeIdentity",
     "AsyncHTTPClient",
     # Job lookup utils
     "find_job",
@@ -156,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.16 → hypercli_sdk-2026.6.26}/hypercli/agent.py

@@ -884,11 +884,14 @@ class HyperAgent:
         response.raise_for_status()
         return response.json()
 
-    def redeem_grant_code(self, code: str) -> Dict[str, Any]:
+    def redeem_grant_code(self, code: str, *, extend_existing: bool | None = None) -> Dict[str, Any]:
+        payload: dict[str, Any] = {"code": str(code)}
+        if extend_existing is not None:
+            payload["extend_existing"] = bool(extend_existing)
         response = self._http._session.post(
             f"{self._control_base_url}/billing/grants/redeem",
             headers={"Authorization": f"Bearer {self._api_key}"},
-            json={"code": str(code)},
+            json=payload,
         )
         response.raise_for_status()
         return response.json()

{hypercli_sdk-2026.6.16 → 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,
@@ -1472,14 +1657,20 @@ class Deployments:
         *,
         duration: int,
         tags: list[str] | None = None,
+        extend_existing: bool | None = None,
     ) -> dict:
         payload: dict[str, Any] = {"duration": int(duration)}
         if tags is not None:
             payload["tags"] = list(tags)
+        if extend_existing is not None:
+            payload["extend_existing"] = bool(extend_existing)
         return self._post(f"/billing/balance/{quote(str(plan_id), safe='')}", json=payload)
 
-    def redeem_grant_code(self, code: str) -> dict:
-        return self._post("/billing/grants/redeem", json={"code": str(code)})
+    def redeem_grant_code(self, code: str, *, extend_existing: bool | None = None) -> dict:
+        payload: dict[str, Any] = {"code": str(code)}
+        if extend_existing is not None:
+            payload["extend_existing"] = bool(extend_existing)
+        return self._post("/billing/grants/redeem", json=payload)
 
     def logs_token(self, agent_id: str) -> dict:
         """Mint a short-lived JWT token for backend log streaming."""

{hypercli_sdk-2026.6.16 → hypercli_sdk-2026.6.26}/hypercli/user.py

@@ -25,6 +25,21 @@ class User:
         )
 
 
+@dataclass
+class RuntimeIdentity:
+    kind: str
+    agent_id: str | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict | None) -> "RuntimeIdentity | None":
+        if not isinstance(data, dict):
+            return None
+        kind = str(data.get("kind") or "").strip()
+        if not kind:
+            return None
+        return cls(kind=kind, agent_id=data.get("agent_id"))
+
+
 @dataclass
 class AuthMe:
     user_id: str
@@ -34,6 +49,8 @@ class AuthMe:
     email: str | None
     auth_type: str
     capabilities: list[str]
+    tags: list[str]
+    runtime: RuntimeIdentity | None
     has_active_subscription: bool
     key_id: str | None
     key_name: str | None
@@ -48,11 +65,23 @@ class AuthMe:
             email=data.get("email"),
             auth_type=data.get("auth_type", ""),
             capabilities=list(data.get("capabilities") or []),
+            tags=list(data.get("tags") or []),
+            runtime=RuntimeIdentity.from_dict(data.get("runtime")),
             has_active_subscription=bool(data.get("has_active_subscription")),
             key_id=data.get("key_id"),
             key_name=data.get("key_name"),
         )
 
+    @property
+    def is_runtime_agent(self) -> bool:
+        return self.runtime is not None and self.runtime.kind == "agent"
+
+    @property
+    def runtime_agent_id(self) -> str | None:
+        if not self.is_runtime_agent or self.runtime is None:
+            return None
+        return self.runtime.agent_id
+
 
 class UserAPI:
     """User API wrapper"""

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypercli-sdk"
-version = "2026.6.16"
+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.16 → 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
@@ -1111,6 +1187,35 @@ def test_agents_purchase_entitlement_from_balance(agents_client):
         assert mock_client.post.call_args[1]["json"] == {"duration": 3600, "tags": ["customer=acme"]}
 
 
+def test_agents_purchase_entitlement_from_balance_can_extend_existing(agents_client):
+    with patch("httpx.Client") as mock_client_class:
+        mock_client = MagicMock()
+        mock_response = Mock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {
+            "grant": {"id": "grant-1", "type": "BALANCE"},
+            "entitlement": {"id": "ent-1", "plan_id": "basic"},
+        }
+        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.purchase_entitlement_from_balance(
+            "basic",
+            duration=3600,
+            tags=["customer=acme"],
+            extend_existing=True,
+        )
+
+        assert mock_client.post.call_args[0][0].endswith("/billing/balance/basic")
+        assert mock_client.post.call_args[1]["json"] == {
+            "duration": 3600,
+            "tags": ["customer=acme"],
+            "extend_existing": True,
+        }
+
+
 def test_agents_redeem_grant_code(agents_client):
     with patch("httpx.Client") as mock_client_class:
         mock_client = MagicMock()
@@ -1132,6 +1237,26 @@ def test_agents_redeem_grant_code(agents_client):
         assert mock_client.post.call_args[1]["json"] == {"code": "promo-123"}
 
 
+def test_agents_redeem_grant_code_can_request_extension(agents_client):
+    with patch("httpx.Client") as mock_client_class:
+        mock_client = MagicMock()
+        mock_response = Mock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {
+            "grant": {"id": "grant-1", "type": "ACTIVATION_CODE", "code": "promo-123"},
+            "entitlement": {"id": "ent-1", "plan_id": "basic"},
+        }
+        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.redeem_grant_code("promo-123", extend_existing=True)
+
+        assert mock_client.post.call_args[0][0].endswith("/billing/grants/redeem")
+        assert mock_client.post.call_args[1]["json"] == {"code": "promo-123", "extend_existing": True}
+
+
 def test_openclaw_agent_resolve_gateway_token_uses_env_route():
     manager = Mock()
     manager.get.return_value = OpenClawAgent.from_dict({

{hypercli_sdk-2026.6.16 → hypercli_sdk-2026.6.26}/tests/test_claw.py

@@ -379,6 +379,22 @@ class TestHyperAgentClient:
             headers={"Authorization": "Bearer sk-hyper-test"},
             json={"code": "promo-123"},
         )
+
+    def test_redeem_grant_code_can_request_extension(self, mock_http):
+        mock_http._session.post.return_value.json.return_value = {
+            "grant": {"id": "grant-1", "code": "promo-123"},
+            "entitlement": {"id": "ent-1", "plan_id": "basic"},
+        }
+        mock_http._session.post.return_value.raise_for_status = Mock()
+
+        agent = HyperAgent(mock_http, agent_api_key="sk-hyper-test", agents_api_base_url="https://api.hypercli.com/agents")
+        agent.redeem_grant_code("promo-123", extend_existing=True)
+
+        mock_http._session.post.assert_called_with(
+            "https://api.hypercli.com/agents/billing/grants/redeem",
+            headers={"Authorization": "Bearer sk-hyper-test"},
+            json={"code": "promo-123", "extend_existing": True},
+        )
     
     def test_openai_client_creation(self, mock_http):
         """Test that OpenAI client is created with correct config."""

{hypercli_sdk-2026.6.16 → hypercli_sdk-2026.6.26}/tests/test_keys.py

@@ -118,6 +118,8 @@ def test_user_auth_me_returns_capabilities():
                 "email": "user@example.com",
                 "auth_type": "orchestra_key",
                 "capabilities": ["models:*", "voice:*"],
+                "tags": ["runtime=agent", "runtime_agent=agent-123"],
+                "runtime": {"kind": "agent", "agent_id": "agent-123"},
                 "has_active_subscription": True,
                 "key_id": "key-123",
                 "key_name": "runtime-key",
@@ -127,5 +129,8 @@ def test_user_auth_me_returns_capabilities():
 
     assert auth_me.user_id == "user-123"
     assert auth_me.capabilities == ["models:*", "voice:*"]
+    assert auth_me.tags == ["runtime=agent", "runtime_agent=agent-123"]
+    assert auth_me.is_runtime_agent is True
+    assert auth_me.runtime_agent_id == "agent-123"
     assert auth_me.has_active_subscription is True
     assert auth_me.key_id == "key-123"