@clawpump/claw-agent 0.1.3 → 0.1.5

package/agent/cli.py

@@ -3347,6 +3347,9 @@ class HermesCLI:
         # _handle_update_command() so the relaunch happens on the main thread,
         # not the background process_loop thread.
         self._pending_relaunch: list[str] | None = None
+        # ClawPump: queued UsePod ("Pod") provider switch, applied post-turn by
+        # _activate_pending_pod() after usepod_provision auto-applies its token.
+        self._pending_pod_activation: dict | None = None
         self._last_ctrl_c_time = 0
         self._clarify_state = None
         self._clarify_freetext = False
@@ -5141,7 +5144,10 @@ class HermesCLI:
                 skip_memory=self.ignore_rules,
                 tool_progress_callback=self._on_tool_progress,
                 tool_start_callback=self._on_tool_start if self._inline_diffs_enabled else None,
-                tool_complete_callback=self._on_tool_complete if self._inline_diffs_enabled else None,
+                # Always wired: _on_tool_complete also drives ClawPump's UsePod
+                # ("Pod") auto-apply, which must not depend on the inline-diffs
+                # display toggle. Diff rendering inside it is still gated on it.
+                tool_complete_callback=self._on_tool_complete,
                 stream_delta_callback=self._stream_delta if self.streaming_enabled else None,
                 tool_gen_callback=self._on_tool_gen_start if self.streaming_enabled else None,
             )
@@ -7819,6 +7825,23 @@ class HermesCLI:
                 self._close_model_picker()
                 return
             provider_data = providers[selected]
+            # Distribution overlay (e.g. ClawPump): promoted providers that need
+            # a guided setup (UsePod "Pod" — a plugin api-key provider that can't
+            # be quick-switched) route to a step-by-step setup flow instead of a
+            # failing switch. Hand the agent the configure instruction.
+            if provider_data.get("clawpump_setup"):
+                self._close_model_picker()
+                try:
+                    from hermes_cli.distribution import usepod_setup_request_message
+                    _msg = usepod_setup_request_message()
+                except Exception:
+                    _msg = (
+                        "Help me set up the Pod (UsePod) provider step by step and "
+                        "fund it from my ClawPump wallet."
+                    )
+                if hasattr(self, "_pending_input"):
+                    self._pending_input.put(_msg)
+                return
             # Use the curated model list from list_authenticated_providers()
             # (same lists as `hermes model` and gateway pickers).
             # Only fall back to the live provider catalog when the curated
@@ -7933,6 +7956,15 @@ class HermesCLI:
             except Exception:
                 providers = []
 
+            # Distribution overlay (e.g. ClawPump): pin promoted providers
+            # (UsePod "Pod") so they're discoverable. Selecting one routes to a
+            # guided setup (see _handle_model_picker_selection). No-op on vanilla.
+            try:
+                from hermes_cli.distribution import promote_picker_providers
+                providers = promote_picker_providers(ctx, providers)
+            except Exception:
+                pass
+
             if not providers:
                 _cprint("  No authenticated providers found.")
                 _cprint("")
@@ -11076,7 +11108,41 @@ class HermesCLI:
             logger.debug("Edit snapshot capture failed for %s", function_name, exc_info=True)
 
     def _on_tool_complete(self, tool_call_id: str, function_name: str, function_args: dict, function_result: str):
-        """Render file edits with inline diff after write-capable tools complete."""
+        """Render file edits with inline diff after write-capable tools complete.
+
+        Also intercepts the ClawPump ``usepod_provision`` MCP tool to auto-apply
+        the returned Pod token (downstream overlay; no-op on vanilla Hermes).
+        Runs mid-turn in the agent thread, so it only persists credentials/config
+        and queues the live provider switch — the switch itself happens at the
+        post-turn boundary (``_activate_pending_pod``) to avoid mutating the
+        agent while it is still executing tools.
+        """
+        # ClawPump: auto-apply a freshly provisioned UsePod ("Pod") token.
+        try:
+            from hermes_cli import distribution as _dist
+
+            _tok = _dist.usepod_provision_token(function_name, function_result)
+            if _tok:
+                api_token, deposit_code = _tok
+                if _dist.persist_usepod_credentials(api_token, deposit_code):
+                    model, provider, base_url = _dist.usepod_pod_switch_target(
+                        api_token, current_model=getattr(self, "model", "") or ""
+                    )
+                    # Queue the switch; config.yaml is persisted in
+                    # _activate_pending_pod once we're on the main thread (so a
+                    # failed/invalid token never strands config on Pod).
+                    self._pending_pod_activation = {
+                        "model": model,
+                        "provider": provider,
+                        "base_url": base_url,
+                        "api_key": api_token,
+                    }
+                    _cprint(f"  ✓ Pod token applied — switching to Pod ({model}) after this turn.")
+        except Exception:
+            logger.debug("UsePod auto-apply failed", exc_info=True)
+
+        if not getattr(self, "_inline_diffs_enabled", True):
+            return
         snapshot = self._pending_edit_snapshots.pop(tool_call_id, None)
         try:
             from agent.display import render_edit_diff_with_delta
@@ -11091,6 +11157,68 @@ class HermesCLI:
         except Exception:
             logger.debug("Edit diff preview failed for %s", function_name, exc_info=True)
 
+    def _activate_pending_pod(self) -> None:
+        """Apply a queued UsePod ("Pod") provider switch at a post-turn boundary.
+
+        Mirrors ``_apply_model_switch_result``: updates the live agent + CLI
+        provider state so the next turn runs on Pod, with no relaunch and no
+        manual ``claw model`` paste. Set by ``_on_tool_complete`` when
+        ``usepod_provision`` returns a token. No-op when nothing is queued.
+        """
+        pending = getattr(self, "_pending_pod_activation", None)
+        if not pending:
+            return
+        self._pending_pod_activation = None
+        try:
+            old_model = self.model
+            model = pending["model"]
+            provider = pending["provider"]
+            base_url = pending.get("base_url") or ""
+            api_key = pending.get("api_key") or ""
+
+            self.model = model
+            self.provider = provider
+            self.requested_provider = provider
+            self._explicit_api_key = api_key
+            self._explicit_base_url = base_url
+            if api_key:
+                self.api_key = api_key
+            if base_url:
+                self.base_url = base_url
+
+            if self.agent is not None:
+                try:
+                    self.agent.switch_model(
+                        new_model=model,
+                        new_provider=provider,
+                        api_key=api_key,
+                        base_url=base_url,
+                    )
+                    # switch_model derives api_mode from provider+base_url when
+                    # not passed; sync the CLI's copy so a later re-resolution
+                    # (or relaunch) doesn't carry the old provider's wire mode.
+                    self.api_mode = getattr(self.agent, "api_mode", self.api_mode)
+                except Exception as exc:
+                    _cprint(f"  ⚠ Pod switch applied to next session ({exc}).")
+
+            # Persist the provider switch (model.default + model.provider) so a
+            # later relaunch boots onto Pod. base_url is intentionally NOT
+            # persisted — it's re-derived from USEPOD_API_KEY at startup.
+            try:
+                save_config_value("model.default", model)
+                save_config_value("model.provider", provider)
+            except Exception:
+                logger.debug("Pod config persist failed", exc_info=True)
+
+            self._pending_model_switch_note = (
+                f"[Note: the session was just switched from {old_model} to {model} "
+                f"running on your UsePod Pod (paid in USDC from your ClawPump "
+                f"wallet). Adjust your self-identification accordingly.]"
+            )
+            _cprint(f"  ✓ Now running on Pod: {model}")
+        except Exception:
+            logger.debug("Pod activation failed", exc_info=True)
+
     # ====================================================================
     # Voice mode methods
     # ====================================================================
@@ -12403,6 +12531,11 @@ class HermesCLI:
             # Update history with full conversation
             self.conversation_history = result.get("messages", self.conversation_history) if result else self.conversation_history
 
+            # ClawPump: apply a queued UsePod ("Pod") provider switch now that
+            # the agent thread has joined (safe post-turn boundary). No-op unless
+            # usepod_provision auto-applied a token during this turn.
+            self._activate_pending_pod()
+
             # If auto-compression fired mid-turn, the agent created a new
             # continuation session and mutated self.agent.session_id. Sync
             # the CLI's session_id so /status, /resume, title generation,

package/agent/hermes_cli/clawpump_cli.py

@@ -1,6 +1,6 @@
 """``hermes clawpump`` — one-command install/auth for the ClawPump MCP.
 
-ClawPump ships its full feature set (131 tools) as an MCP server, bundled in
+ClawPump ships its full feature set (133 tools) as an MCP server, bundled in
 the Hermes catalog as two entries:
 
   - ``clawpump``        remote OAuth over Streamable HTTP (browser, paste cpk_*)
@@ -59,7 +59,7 @@ def _cmd_setup(args) -> int:
     print()
     print(color("  ClawPump setup", Colors.GREEN + Colors.BOLD))
     print(color("  ──────────────", Colors.GREEN))
-    print("  ClawPump's 131 tools (agents, trading, perps, DCA, lending,")
+    print("  ClawPump's 133 tools (agents, trading, perps, DCA, lending,")
     print("  token launch, marketplace, predictions, gift cards, agent")
     print("  mail, intelligence) come in through an MCP server. Two ways")
     print("  to connect:")
@@ -221,7 +221,7 @@ def add_parser(subparsers) -> None:
         help="ClawPump (Solana token launch, trading, perps, DeFi) via MCP",
         description=(
             "Install and authenticate the ClawPump MCP server, then manage which "
-            "of its 131 tools are enabled. Subcommands: setup (default: status), "
+            "of its 133 tools are enabled. Subcommands: setup (default: status), "
             "login, status, tools."
         ),
     )

package/agent/hermes_cli/commands.py

@@ -123,7 +123,8 @@ COMMAND_REGISTRY: list[CommandDef] = [
     # Configuration
     CommandDef("config", "Show current configuration", "Configuration",
                cli_only=True),
-    CommandDef("model", "Switch model for this session", "Configuration",
+    CommandDef("model", "Switch model or provider for this session", "Configuration",
+               aliases=("provider",),
                args_hint="[model] [--provider name] [--global] [--refresh]"),
     CommandDef("codex-runtime", "Toggle codex app-server runtime for OpenAI/Codex models",
                "Configuration", aliases=("codex_runtime",),

package/agent/hermes_cli/distribution.py

@@ -228,3 +228,230 @@ def try_self_update(project_root: Any) -> bool:
         sys.exit(1)
     print("✓ ClawPump agent updated. Restart your session with `claw`.")
     return True
+
+
+# ── Model picker: promoted providers ──────────────────────────────────────
+# ClawPump pins UsePod ("Pod") to the top of the /model + /provider picker so
+# users can discover it. UsePod is a plugin api-key provider, so it can't be
+# quick-switched like a configured provider — selecting it instead triggers a
+# guided setup (the picker handler keys off the ``clawpump_setup`` flag and
+# hands the agent a "configure Pod" instruction). No-op on vanilla Hermes.
+PICKER_PROMOTED_PROVIDER = "usepod"
+# Honest, defensible value-prop (no fabricated savings %). Swap in a real,
+# backed figure here if/when there is one.
+PICKER_PROMOTED_TAGLINE = "pay-per-use USDC from your ClawPump wallet"
+PICKER_PROMOTED_DISPLAY = "Pod"
+
+
+def promote_picker_providers(ctx: Any, providers: Any) -> Any:
+    """Pin the promoted provider (UsePod) to the top of the model picker.
+
+    Adds a Pod row (seeded with the provider's fallback models) tagged with
+    ``clawpump_setup`` so the picker routes its selection to the guided setup
+    flow rather than a (failing) quick-switch. Idempotent; returns the list
+    unchanged on any error so the picker never breaks.
+    """
+    try:
+        rows = list(providers or [])
+    except Exception:
+        return providers
+
+    slug = PICKER_PROMOTED_PROVIDER
+    existing = next(
+        (r for r in rows if isinstance(r, dict) and r.get("slug") == slug), None
+    )
+    others = [
+        r for r in rows if not (isinstance(r, dict) and r.get("slug") == slug)
+    ]
+
+    if existing is None:
+        models = []
+        try:
+            from providers import get_provider_profile
+
+            pp = get_provider_profile(slug)
+            models = list(getattr(pp, "fallback_models", ()) or [])
+        except Exception:
+            models = []
+        existing = {
+            "slug": slug,
+            "name": PICKER_PROMOTED_DISPLAY,
+            "models": models,
+            "total_models": len(models),
+            "is_current": False,
+            "authenticated": False,
+        }
+
+    # Selecting Pod always routes to setup (it can't be quick-switched).
+    existing["clawpump_setup"] = True
+    name = str(existing.get("name") or PICKER_PROMOTED_DISPLAY)
+    if PICKER_PROMOTED_TAGLINE not in name:
+        existing["name"] = f"{name}  ·  {PICKER_PROMOTED_TAGLINE}"
+
+    return [existing] + others
+
+
+def usepod_setup_request_message() -> str:
+    """The instruction enqueued to the agent when a user picks Pod in the
+    picker but it isn't configured — drives the step-by-step setup + funding."""
+    return (
+        "I picked Pod (UsePod) in the model picker but it isn't set up yet. "
+        "Walk me through configuring it: (1) ask how much USDC to put on the pod "
+        "(e.g. 5) — optionally check get_balance first; (2) ask which ClawPump "
+        "agent wallet should fund it — call list_agents and let me pick one by "
+        "agent_id; (3) once I approve the amount, call usepod_provision with that "
+        "amount, the chosen agent_id, and confirm_deposit: true. It registers a "
+        "fresh pod and funds it in one call. I do NOT need to paste anything: the "
+        "moment usepod_provision returns the api_token, Hermes auto-applies it "
+        "(writes USEPOD_API_KEY) and switches this session onto Pod automatically. "
+        "Just confirm the amount before the on-chain spend and report the funding "
+        "signature."
+    )
+
+
+# ── UsePod "Pod" auto-apply (downstream) ──────────────────────────────────
+# When the agent calls the ClawPump MCP tool ``usepod_provision`` it gets back
+# ``{api_token, deposit_code, amount, signature, funding_error}``. Instead of
+# telling the user to paste the api_token via ``claw model``, the CLI intercepts
+# that result (cli.py ``_on_tool_complete``), persists the token, and switches
+# the live session onto Pod. These helpers hold the downstream-owned logic so
+# the cli.py touch points stay tiny and no-op on vanilla Hermes.
+USEPOD_PROVISION_TOOL_SUFFIX = "usepod_provision"
+
+
+def _is_clawpump_provision_tool(name: str) -> bool:
+    """True only for the ClawPump MCP's usepod_provision tool.
+
+    The runtime names MCP tools ``mcp_<server>_<tool>`` — the remote entry is
+    ``mcp_clawpump_usepod_provision`` and the stdio entry
+    ``mcp_clawpump_stdio_usepod_provision``; both start with ``mcp_clawpump``.
+    Binding to that namespace (rather than a bare ``endswith``) keeps a
+    differently-named MCP server from minting a result that auto-rewrites the
+    user's inference credential.
+    """
+    n = str(name or "")
+    if n == USEPOD_PROVISION_TOOL_SUFFIX:
+        return True
+    return n.startswith("mcp_clawpump") and n.endswith(USEPOD_PROVISION_TOOL_SUFFIX)
+
+
+def _unwrap_provision_payload(value: Any, _depth: int = 0):
+    """Return the innermost dict carrying ``api_token``, unwrapping envelopes.
+
+    Hermes' MCP client wraps a tool's text result as ``{"result": "<json>"}``
+    (and ``{"result": ..., "structuredContent": {...}}`` when the server sends
+    structured output) — see ``tools/mcp_tool.py``. The provision JSON therefore
+    arrives nested and string-escaped, so we re-parse ``result`` /
+    ``structuredContent`` until we find the object with the token.
+    """
+    if _depth > 4:
+        return None
+    if isinstance(value, str):
+        import json
+
+        try:
+            value = json.loads(value)
+        except Exception:
+            return None
+    if not isinstance(value, dict):
+        return None
+    if value.get("api_token"):
+        return value
+    for key in ("structuredContent", "result", "data"):
+        if key in value:
+            inner = _unwrap_provision_payload(value[key], _depth + 1)
+            if inner is not None:
+                return inner
+    return None
+
+
+def usepod_provision_token(function_name: str, function_result: Any):
+    """Extract ``(api_token, deposit_code)`` from a ``usepod_provision`` result.
+
+    Returns ``None`` unless *function_name* is the ClawPump MCP's
+    usepod_provision tool AND the result carries a usable ``api_token``.
+    Tolerant of the result arriving as a dict, a JSON string, or the
+    ``{"result": "<escaped json>"}`` envelope Hermes' MCP client emits.
+    """
+    if not _is_clawpump_provision_tool(function_name):
+        return None
+
+    api_token = ""
+    deposit_code = ""
+    payload = _unwrap_provision_payload(function_result)
+    if isinstance(payload, dict):
+        api_token = str(payload.get("api_token") or "").strip()
+        deposit_code = str(payload.get("deposit_code") or "").strip()
+
+    # Last-resort fallback: dig the fields straight out of the raw text. The
+    # quotes may be backslash-escaped (the JSON is a string value inside the
+    # ``{"result": "..."}`` envelope), so tolerate leading backslashes.
+    if not api_token and isinstance(function_result, str):
+        import re
+
+        m = re.search(r'\\*"api_token\\*"\s*:\s*\\*"([^"\\]+)', function_result)
+        if m:
+            api_token = m.group(1).strip()
+        m = re.search(r'\\*"deposit_code\\*"\s*:\s*\\*"([0-9a-fA-F]{16})', function_result)
+        if m:
+            deposit_code = m.group(1).strip()
+
+    if not api_token:
+        return None
+    # A funding_error means the deposit failed but the pod/token are still
+    # valid — applying the token is exactly right (the user funds later).
+    return (api_token, deposit_code)
+
+
+def usepod_pod_switch_target(api_token: str, current_model: str = ""):
+    """Return ``(model, provider, base_url)`` to switch onto for a Pod token.
+
+    Keeps the user's current model when UsePod's offline catalog lists it,
+    otherwise falls back to the provider's first advertised Pod model. The
+    secret-bearing base_url is derived from the token (never persisted to
+    config.yaml).
+    """
+    provider = "usepod"
+    models = []
+    try:
+        from providers import get_provider_profile
+
+        pp = get_provider_profile(provider)
+        models = list(getattr(pp, "fallback_models", ()) or [])
+    except Exception:
+        models = []
+
+    model = ""
+    cur = (current_model or "").strip()
+    if cur and cur in models:
+        model = cur
+    elif models:
+        model = models[0]
+    else:
+        model = cur or "claude-opus-4-8"
+
+    base_url = ""
+    try:
+        from hermes_cli.auth import _resolve_usepod_base_url
+
+        base_url = _resolve_usepod_base_url(api_token)
+    except Exception:
+        base_url = ""
+
+    return (model, provider, base_url)
+
+
+def persist_usepod_credentials(api_token: str, deposit_code: str = "") -> bool:
+    """Write USEPOD_API_KEY (+ deposit_code) to ~/.hermes/.env. Returns success."""
+    try:
+        from hermes_cli.config import save_env_value
+
+        save_env_value("USEPOD_API_KEY", api_token)
+        if deposit_code:
+            try:
+                save_env_value("USEPOD_DEPOSIT_CODE", deposit_code)
+            except Exception:
+                pass  # deposit_code is a convenience; the token is what matters
+        return True
+    except Exception:
+        return False

package/agent/optional-mcps/clawpump/manifest.yaml

@@ -3,7 +3,7 @@
 manifest_version: 1
 
 name: clawpump
-description: ClawPump — Solana AI agents, trading, perps, DCA, token launch, marketplace, lending, predictions, gift cards, agent mail, x402 paid APIs, market intelligence (131 tools).
+description: ClawPump — Solana AI agents, trading, perps, DCA, token launch, marketplace, lending, predictions, gift cards, agent mail, x402 paid APIs, UsePod pods, market intelligence (134 tools).
 source: https://mcp.clawpump.tech
 
 # ClawPump ships a remote MCP server: Streamable HTTP + native OAuth 2.1 +
@@ -29,13 +29,13 @@ auth:
   # first probe / first connect.
 
 # Tool selection at install time.
-# ClawPump exposes 131 tools; 37 of them move real funds or are irreversible
+# ClawPump exposes 134 tools; 38 of them move real funds or are irreversible
 # (perps orders, swaps, DCA/limit orders, lending deposit/withdraw, prediction
 # positions, marketplace bids, external-wallet changes, wallet transfers,
 # token launches, gift-card purchases/withdrawals, agent-mail
 # provisioning/sending, x402 paid-API execution).
 # Hermes does NOT auto-gate MCP tools by their destructiveHint, so we ship a
-# read-mostly default: the 94 safe tools below are pre-checked in the install
+# read-mostly default: the 96 safe tools below are pre-checked in the install
 # checklist (and applied directly if the server can't be probed before auth).
 # Users opt into the financial tools per their threat model in the checklist,
 # or later with `hermes mcp configure clawpump`.
@@ -118,6 +118,8 @@ tools:
     - pay_sh_search
     - pay_sh_provider_details
     - pay_sh_prepare_call
+    # dexter x402 marketplace discovery (free search; paid with the agent wallet)
+    - dexter_search
     # perps (read / preview only)
     - perps_markets
     - perps_market_data
@@ -155,6 +157,12 @@ tools:
     # whitelist
     - get_whitelist
     - add_to_whitelist
+    # usepod / Pod (set up + fund the user's own inference pod from the wallet)
+    # provision is the Pod-setup entry point. Its only fund-moving path (passing
+    # an `amount`) is double-gated by `confirm_deposit: true`, so it's safe to
+    # ship enabled. The standalone top-up tool `usepod_deposit` is a pure
+    # fund-mover and stays opt-in with the other financial tools below.
+    - usepod_provision
 
 post_install: |
   On first connection Hermes opens a browser to ClawPump — log in and it
@@ -168,8 +176,8 @@ post_install: |
   dca_create, limit_order_create, jup_lend_deposit/withdraw, predictions_open/
   close, place_bid / accept_marketplace_bid, set_external_wallet,
   wallet_transfer, agent_card_create/cancel/reveal/withdraw,
-  agent_mail_create/send, pay_sh_execute_approved, and the token-launch
-  tools). Several require explicit confirm flags (confirmRisk,
+  agent_mail_create/send, pay_sh_execute_approved, usepod_deposit, and the
+  token-launch tools). Several require explicit confirm flags (confirmRisk,
   confirm_launch, confirm_spend, confirm_send, confirm_transfer,
   confirm_payment, …).
   Enable the ones you want and review every call:

package/agent/optional-mcps/clawpump-stdio/manifest.yaml

@@ -3,7 +3,7 @@
 manifest_version: 1
 
 name: clawpump-stdio
-description: ClawPump (stdio) — the same 131 tools via the npm package, authed with a cpk_* API key (no browser).
+description: ClawPump (stdio) — the same 134 tools via the npm package, authed with a cpk_* API key (no browser).
 source: https://www.npmjs.com/package/@clawpump/agents
 
 # Same tool surface as the `clawpump` remote entry, but run locally over stdio
@@ -31,8 +31,8 @@ auth:
       secret: false
       default: ""
 
-# Same read-mostly default as the remote `clawpump` entry: 94 safe tools
-# pre-checked; the 37 financial/irreversible tools are opt-in. See the
+# Same read-mostly default as the remote `clawpump` entry: 96 safe tools
+# pre-checked; the 38 financial/irreversible tools are opt-in. See the
 # `clawpump` manifest for the rationale (Hermes does not auto-gate MCP tools
 # by destructiveHint).
 tools:
@@ -114,6 +114,8 @@ tools:
     - pay_sh_search
     - pay_sh_provider_details
     - pay_sh_prepare_call
+    # dexter x402 marketplace discovery (free search; paid with the agent wallet)
+    - dexter_search
     # perps (read / preview only)
     - perps_markets
     - perps_market_data
@@ -151,12 +153,18 @@ tools:
     # whitelist
     - get_whitelist
     - add_to_whitelist
+    # usepod / Pod (set up + fund the user's own inference pod from the wallet).
+    # provision is the Pod-setup entry point; its fund-moving path (an `amount`)
+    # is double-gated by `confirm_deposit: true`. The standalone top-up tool
+    # `usepod_deposit` is a pure fund-mover and stays opt-in (financial) below.
+    - usepod_provision
 
 post_install: |
   Requires Node.js / npx on PATH. Your cpk_* key is stored in ~/.hermes/.env
   and sent directly as a Bearer token to the ClawPump backend — no browser.
 
-  Financial / irreversible tools are OFF by default. Enable the ones you want:
+  Financial / irreversible tools (incl. usepod_deposit) are OFF by default.
+  Enable the ones you want:
     hermes mcp configure clawpump-stdio
 
   Start a new Hermes session to load the ClawPump tools.

package/agent/skills/clawpump/SKILL.md

@@ -14,7 +14,7 @@ metadata:
 ClawPump is a Solana platform for AI agents: each agent has a wallet and can
 trade, run perps, DCA, lend, launch tokens, buy gift cards, send email from
 its own inbox, and be bought/sold on a marketplace. Its full feature set
-reaches Hermes through the **ClawPump MCP server** (131 tools, 10 resources,
+reaches Hermes through the **ClawPump MCP server** (134 tools, 10 resources,
 10 prompts).
 
 ## Enabling ClawPump
@@ -44,7 +44,7 @@ Most tools act on a specific agent. Resolve it once with `list_agents`, then
 pass `agent_id`. If the user set `CLAWPUMP_DEFAULT_AGENT` (or has exactly one
 agent), `agent_id` can usually be omitted. When unsure which agent, ask.
 
-## What's available (131 tools, 20 groups)
+## What's available (134 tools, 21 groups)
 
 | Group | Representative tools |
 |-------|----------------------|
@@ -62,6 +62,8 @@ agent), `agent_id` can usually be omitted. When unsure which agent, ask.
 | Agent cards (Laso) | `agent_card_search_merchants`, `agent_card_search_gift_cards`, `agent_card_quote`, `agent_card_create`, `agent_card_list`, `agent_card_get`, `agent_card_status`, `agent_card_data`, `agent_card_balance`, `agent_card_reveal`, `agent_card_cancel`, `agent_card_refresh`, `agent_card_withdraw`, `agent_card_withdrawals`, `agent_card_connect`, `agent_card_connect_link` |
 | Agent mail | `agent_mail_create`, `agent_mail_get_address`, `agent_mail_send`, `agent_mail_list`, `agent_mail_read` |
 | Pay.sh x402 (agent-wallet paid APIs) | `pay_sh_search`, `pay_sh_provider_details`, `pay_sh_prepare_call`, `pay_sh_execute_approved` |
+| Dexter x402 marketplace (discovery) | `dexter_search` |
+| UsePod (run + fund your own inference pod) | `usepod_provision`, `usepod_deposit` |
 | Wallet & billing | `get_balance`, `get_budget`, `get_usage`, `get_transactions`, `get_wallet_summaries`, `get_wallet_history`, `get_private_wallet_balance`, `get_balance_history`, `sync_billing`, `wallet_transfer` |
 | Market intelligence | `intelligence_capabilities`, `intelligence_market`, `intelligence_signals`, `intelligence_macro`, `intelligence_perps` |
 | Integrations | `list_integrations`, `save_integration`, `remove_integration`, `get_linked_accounts` |
@@ -69,8 +71,10 @@ agent), `agent_id` can usually be omitted. When unsure which agent, ask.
 | Whitelist | `get_whitelist`, `add_to_whitelist`, `remove_from_whitelist` |
 | Utility | `get_model_catalog`, `get_news_feed` |
 
-By default only the **94 read-mostly** tools are enabled. The financial ones
-below are opt-in via `hermes mcp configure clawpump`.
+By default only the **95 read-mostly** tools are enabled (including
+`usepod_provision`, whose only fund-moving path is double-gated by
+`confirm_deposit`). The financial ones below are opt-in via
+`hermes mcp configure clawpump`.
 
 ## ⚠️ FINANCIAL & IRREVERSIBLE TOOLS — confirmation is mandatory
 
@@ -92,6 +96,7 @@ explicit confirm flag (e.g. `confirmRisk: true`, `confirm_launch: true`,
 - Agent mail: `agent_mail_create` (one-time ~$2 USDC from the agent wallet), `agent_mail_send` (outward-facing email; paid per send via x402 from the agent wallet)
 - Wallet: `wallet_transfer` (irreversible on-chain send; destination must be on the agent's whitelist via `add_to_whitelist`; quote the exact amount, token, and address, then `confirm_transfer: true`)
 - Pay.sh x402: `pay_sh_execute_approved` (pays USDC from the agent wallet via x402 — always `pay_sh_prepare_call` first; quote the exact endpoint + price; approval codes expire in 10 minutes; requires the `x402` skill on the agent)
+- UsePod: `usepod_deposit` (top up the user's own UsePod pod from the agent's ClawPump wallet, to pay for Hermes/agent inference usage — irreversible on-chain USDC deposit of the **full** amount, no fee; the user supplies their 16-hex `deposit_code` from UsePod `/v1/register`; double-check the code and amount, then `confirm_deposit: true`)
 
 **Always get a quote/preview first** (`swap_quote` before `swap_execute`,
 `perps_order_preview` before `perps_order_execute`, `agent_card_quote` before
@@ -136,3 +141,47 @@ Common patterns:
   - **Deliverability (avoid spam):** write genuine, complete messages — a specific subject, a greeting, 2–4 sentences of real purpose, and a sign-off. Never send one-word/empty bodies or test-like "hello": low-content mail from a fresh sender domain is the #1 spam trigger. Do **not** use fake-urgent or deceptive subjects ("IMPORTANT!!", "URGENT") to game filters — that backfires and is deceptive. Tell first-time recipients to mark "Not spam" + add the address to contacts; that trains their inbox fastest.
 - **Fund an external wallet (e.g. a pay.sh allowance):** `get_balance` → `add_to_whitelist` (user-approved address) → (confirm) `wallet_transfer`. See the `pay-sh` skill.
 - **Paid x402 API call (agent wallet pays):** `pay_sh_search` → `pay_sh_provider_details` (price) → `pay_sh_prepare_call` → (confirm price with user) → `pay_sh_execute_approved`. The agent needs the `x402` skill (`update_agent` with `enabled_skills`).
+- **Discover x402 APIs on Dexter:** `dexter_search` (free, by capability — e.g. "ETH price", "image generation") returns matching resources with their payable `resourceUrl`, HTTP method, per-call USDC price, and input schema. To use one, call its `resourceUrl` with the agent's x402 rail (same custodial wallet, capped per call) — quote the price and confirm with the user first. No separate Dexter wallet.
+- **Pay your Hermes inference from the ClawPump wallet (UsePod):** if the user runs Hermes on their own UsePod pod (`USEPOD_API_KEY` in `~/.hermes/.env`), they can top that pod up straight from their ClawPump wallet instead of funding it manually at usepod.ai. Flow: `get_balance` (confirm the agent wallet holds enough USDC) → ask for the amount + their 16-hex `deposit_code` (from UsePod `/v1/register`) → quote both back → (confirm) `usepod_deposit` with `confirm_deposit: true`. The full amount goes on-chain into that pod (no fee); UsePod then draws inference cost from it. This is **separate** from ClawPump's own hosted chat/credits — it just pays the user's own pod from their wallet.
+
+## Setting up Pod (UsePod) — auto flow
+
+When a user picks **Pod** in the `/provider` (or `/model`) picker and it isn't
+configured, the picker hands you a request to set it up. Pod is a drop-in
+inference provider whose usage is paid in USDC from the user's ClawPump wallet.
+**Make this as automatic as possible — there is nothing to paste and nothing to
+restart: the CLI auto-applies the token and switches the session onto Pod the
+moment `usepod_provision` returns.**
+
+1. **Ask the amount + which agent wallet.** "How much USDC do you want to put on
+   your Pod? (e.g. 5)" — optionally check `get_balance` first so you know it can
+   cover it. Then "Which ClawPump agent wallet should fund it?" — call
+   `list_agents` and let the user pick one; use its `agent_id`. (If there is only
+   one agent you may skip the question and omit `agent_id`.)
+2. **Create + fund in one call** — `usepod_provision` registers a brand-new pod
+   (no signup, no human step) and funds it from the chosen agent wallet. After
+   the user approves the amount, call `usepod_provision` with that `amount`, the
+   selected `agent_id`, and `confirm_deposit: true`. It returns `api_token` (the
+   pod credential) + `deposit_code` and the funding `signature`.
+3. **It's applied automatically** — in the interactive Hermes CLI, the instant
+   `usepod_provision` returns, Hermes writes `USEPOD_API_KEY` (+
+   `USEPOD_DEPOSIT_CODE`) to `~/.hermes/.env` and switches this session onto
+   Pod. No `claw model`, no paste, no restart. Watch for Hermes' own
+   confirmation line (`✓ Now running on Pod: …`) and then tell the user "Your
+   pod is funded and this session is now running on Pod — the next message bills
+   from your pod." Report the funding `signature`. Do **not** print the
+   `api_token` (it's a secret and is already applied). (On non-interactive
+   runtimes — bots/API — the credential is saved but the live switch happens on
+   the next start; say "restart to run on Pod" instead of claiming it switched.)
+
+Notes:
+- **Top up an existing pod** (user already set Pod up before): skip provisioning
+  — ask for the amount + their 16-hex `deposit_code`, then `usepod_deposit` with
+  `confirm_deposit: true`. (`usepod_deposit` is a fund-mover and is opt-in: if
+  it isn't available, the user enables it via `hermes mcp configure clawpump`.)
+- `usepod_provision` registers the pod first and funds best-effort, so if funding
+  fails the user still gets a valid `api_token` (look for `funding_error`) — the
+  token is still auto-applied; fund it afterward with `usepod_deposit`.
+- This is **separate** from ClawPump's hosted chat/credits — it pays the user's
+  own pod from their wallet. Always confirm the amount before the on-chain spend
+  and report the tx signature.

package/agent/uv.lock

@@ -1602,21 +1602,25 @@ version = "0.15.1"
 source = { editable = "." }
 dependencies = [
     { name = "croniter" },
+    { name = "fastapi" },
     { name = "fire" },
     { name = "httpx", extra = ["socks"] },
     { name = "jinja2" },
     { name = "openai" },
     { name = "prompt-toolkit" },
     { name = "psutil" },
+    { name = "ptyprocess", marker = "sys_platform != 'win32'" },
     { name = "pydantic" },
     { name = "pyjwt", extra = ["crypto"] },
     { name = "python-dotenv" },
+    { name = "pywinpty", marker = "sys_platform == 'win32'" },
     { name = "pyyaml" },
     { name = "requests" },
     { name = "rich" },
     { name = "ruamel-yaml" },
     { name = "tenacity" },
     { name = "tzdata", marker = "sys_platform == 'win32'" },
+    { name = "uvicorn", extra = ["standard"] },
 ]
 
 [package.optional-dependencies]
@@ -1632,11 +1636,9 @@ all = [
     { name = "google-auth-httplib2" },
     { name = "google-auth-oauthlib" },
     { name = "mcp" },
-    { name = "ptyprocess", marker = "sys_platform != 'win32'" },
     { name = "pytest" },
     { name = "pytest-asyncio" },
     { name = "pytest-timeout" },
-    { name = "pywinpty", marker = "sys_platform == 'win32'" },
     { name = "ruff" },
     { name = "setuptools" },
     { name = "simple-term-menu" },
@@ -1739,10 +1741,6 @@ modal = [
 parallel-web = [
     { name = "parallel-web" },
 ]
-pty = [
-    { name = "ptyprocess", marker = "sys_platform != 'win32'" },
-    { name = "pywinpty", marker = "sys_platform == 'win32'" },
-]
 slack = [
     { name = "aiohttp" },
     { name = "slack-bolt" },
@@ -1755,9 +1753,7 @@ termux = [
     { name = "agent-client-protocol" },
     { name = "honcho-ai" },
     { name = "mcp" },
-    { name = "ptyprocess", marker = "sys_platform != 'win32'" },
     { name = "python-telegram-bot", extra = ["webhooks"] },
-    { name = "pywinpty", marker = "sys_platform == 'win32'" },
     { name = "simple-term-menu" },
     { name = "starlette" },
 ]
@@ -1770,9 +1766,7 @@ termux-all = [
     { name = "google-auth-oauthlib" },
     { name = "honcho-ai" },
     { name = "mcp" },
-    { name = "ptyprocess", marker = "sys_platform != 'win32'" },
     { name = "python-telegram-bot", extra = ["webhooks"] },
-    { name = "pywinpty", marker = "sys_platform == 'win32'" },
     { name = "simple-term-menu" },
     { name = "starlette" },
     { name = "uvicorn", extra = ["standard"] },
@@ -1822,6 +1816,7 @@ requires-dist = [
     { name = "elevenlabs", marker = "extra == 'tts-premium'", specifier = "==1.59.0" },
     { name = "exa-py", marker = "extra == 'exa'", specifier = "==2.10.2" },
     { name = "fal-client", marker = "extra == 'fal'", specifier = "==0.13.1" },
+    { name = "fastapi", specifier = ">=0.104.0,<1" },
     { name = "fastapi", marker = "extra == 'web'", specifier = "==0.133.1" },
     { name = "faster-whisper", marker = "extra == 'voice'", specifier = "==1.2.1" },
     { name = "fire", specifier = "==0.7.1" },
@@ -1868,7 +1863,7 @@ requires-dist = [
     { name = "parallel-web", marker = "extra == 'parallel-web'", specifier = "==0.4.2" },
     { name = "prompt-toolkit", specifier = "==3.0.52" },
     { name = "psutil", specifier = "==7.2.2" },
-    { name = "ptyprocess", marker = "sys_platform != 'win32' and extra == 'pty'", specifier = "==0.7.0" },
+    { name = "ptyprocess", marker = "sys_platform != 'win32'", specifier = ">=0.7.0,<1" },
     { name = "pydantic", specifier = "==2.13.4" },
     { name = "pyjwt", extras = ["crypto"], specifier = "==2.12.1" },
     { name = "pytest", marker = "extra == 'dev'", specifier = "==9.0.2" },
@@ -1877,7 +1872,7 @@ requires-dist = [
     { name = "python-dotenv", specifier = "==1.2.2" },
     { name = "python-telegram-bot", extras = ["webhooks"], marker = "extra == 'messaging'", specifier = "==22.6" },
     { name = "python-telegram-bot", extras = ["webhooks"], marker = "extra == 'termux'", specifier = "==22.6" },
-    { name = "pywinpty", marker = "sys_platform == 'win32' and extra == 'pty'", specifier = "==2.0.15" },
+    { name = "pywinpty", marker = "sys_platform == 'win32'", specifier = ">=2.0.0,<3" },
     { name = "pyyaml", specifier = "==6.0.3" },
     { name = "qrcode", marker = "extra == 'dingtalk'", specifier = "==7.4.2" },
     { name = "qrcode", marker = "extra == 'feishu'", specifier = "==7.4.2" },
@@ -1900,6 +1895,7 @@ requires-dist = [
     { name = "tenacity", specifier = "==9.1.4" },
     { name = "ty", marker = "extra == 'dev'", specifier = "==0.0.21" },
     { name = "tzdata", marker = "sys_platform == 'win32'", specifier = "==2025.3" },
+    { name = "uvicorn", extras = ["standard"], specifier = ">=0.24.0,<1" },
     { name = "uvicorn", extras = ["standard"], marker = "extra == 'web'", specifier = "==0.41.0" },
     { name = "youtube-transcript-api", marker = "extra == 'youtube'", specifier = "==1.2.4" },
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawpump/claw-agent",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "publishConfig": {
     "access": "public"
   },