feat(tools): clawmes_info — agent-callable bridge for read-only commands (v0.17.0)

[clawnchdev]

Why

You launched the desktop and saw no clawmes commands in the / menu, and the ones you typed rendered as a gray, non-selectable status line. Traced to the desktop source: desktop-slash-commands.ts filters the slash autocomplete to a built-in allowlist, so plugin slash commands are excluded by design and their output renders as a status notice rather than a chat bubble.

The desktop is built around natural-language chat where the agent calls tools — and tool results render as proper, selectable cards (where our links + preview cards live). So this re-exposes the key informational commands as an agent-callable tool.

What

clawmes_info (tool #53, read-only, toolset clawmes-trading):

• op (enum) + optional args. Ops: wallet, balance, portfolio, research, scan, trending, leaderboard, my_launches.
• The agent invokes it from phrases like "what's my wallet balance" or "research CLAWNCH" → renders as a normal tool card.
• Any HTML card the underlying command generates (e.g. /research) is surfaced as a preview attachment via json_result(preview=...) — so the cards render in the desktop too.
• Bridges to the existing async command handlers via an async-safe runner that works whether or not an event loop is already running (both branches tested).

Read-only by design — write actions keep their own gated tools (defi_swap, transfer). This also sidesteps the gray-status-line issue: tool results are first-class cards.

Changes

• New clawmes/tools/clawmes_info.py + wired into register_all.
• Tool count 52 → 53: updated the doctor test, the release smoke assertion, and plugin.yaml (both copies).

Verification

• 4574 passed, 8 skipped; 100% line coverage (16,249 stmts, 0 missing)
• ruff check + ruff format --check clean repo-wide
• plugin.yaml byte-identical
• Doctor test (counts real registered tools) passes at 53

Note

Wallet connection (/connect) still needs WALLETCONNECT_PROJECT_ID in ~/.hermes/.env regardless of surface. Scheduler/write commands (/dca, /buy, etc.) intentionally remain gated tools / slash commands, not in this read bridge.