@maudecode/talaria-web-contracts 1.18.0 → 1.20.0

package/fixtures/sidecar/state_db.json

@@ -60,7 +60,10 @@
         "session_id": "cli-1"
       },
       "result": {
-        "ok": true
+        "ok": true,
+        "deleted_ids": [
+          "cli-1"
+        ]
       }
     },
     {
@@ -69,7 +72,31 @@
         "session_id": "missing"
       },
       "result": {
-        "ok": true
+        "ok": true,
+        "deleted_ids": [
+          "missing"
+        ]
+      }
+    },
+    {
+      "params": {
+        "profile_home": "<home>",
+        "session_id": "cli-root",
+        "include_compression_lineage": true
+      },
+      "result": {
+        "ok": false,
+        "refused": "runtime_history_unsupported"
+      }
+    }
+  ],
+  "state_db.prune_advice": [
+    {
+      "params": {
+        "profile_home": "<home>"
+      },
+      "result": {
+        "advice": null
       }
     }
   ]

package/fixtures/sidecar/stt.json

@@ -6,7 +6,68 @@
       },
       "result": {
         "available": false,
-        "provider": "none"
+        "provider": "none",
+        "streaming": false,
+        "warm_supported": false
+      }
+    }
+  ],
+  "stt.warm": [
+    {
+      "params": {
+        "profile_home": "<home>"
+      },
+      "result": {
+        "provider": "none",
+        "warmed": false,
+        "action": "noop"
+      }
+    }
+  ],
+  "stt.stream": [
+    {
+      "params": {
+        "profile_home": "<home>",
+        "sample_rate": 48000
+      },
+      "result": {
+        "transcript": "final 3200 bytes",
+        "filtered": false,
+        "provider": "fake-live"
+      },
+      "stream": [
+        {
+          "event": "ready",
+          "data": {
+            "stream_id": "q0N8m3V1xY2zA4bC5dE6fG"
+          }
+        },
+        {
+          "event": "partial",
+          "data": {
+            "text": "heard 3200 bytes"
+          }
+        }
+      ]
+    }
+  ],
+  "stt.stream_audio": [
+    {
+      "params": {
+        "stream_id": "q0N8m3V1xY2zA4bC5dE6fG",
+        "audio_b64": "EAAQABAAEAA="
+      },
+      "result": {
+        "ok": true
+      }
+    },
+    {
+      "params": {
+        "stream_id": "q0N8m3V1xY2zA4bC5dE6fG",
+        "end": true
+      },
+      "result": {
+        "ok": true
       }
     }
   ]

package/fixtures/sidecar/text.json

@@ -5,11 +5,11 @@
         "profile_home": "<home>"
       },
       "result": {
-        "client_tag": "client=hermes-client-v0.21.6",
+        "client_tag": "client=hermes-client-v0.22.1",
         "conversation_tag": null,
         "tags": [
           "product=hermes-agent",
-          "client=hermes-client-v0.21.6"
+          "client=hermes-client-v0.22.1"
         ]
       }
     }
@@ -27,5 +27,23 @@
         "supports_vision": true
       }
     }
+  ],
+  "text.spoken": [
+    {
+      "params": {
+        "text": "Saved peyton-sample-20260922.wav to /tmp/out/9f2c1e7a-3b4d-4c2e-8f1a-0b9e2d7c6a51.json, see https://example.com/a/b?x=1 and commit 4bf46b7c8."
+      },
+      "result": {
+        "spoken_text": "Saved to, see and commit 4bf46b7c8."
+      }
+    },
+    {
+      "params": {
+        "text": "Meet Ana on 2026-10-14 at ana@example.com; the ratio is 3:2, a well-known plan."
+      },
+      "result": {
+        "spoken_text": "Meet Ana on 2026-10-14 at ana@example.com; the ratio is 3:2, a well-known plan."
+      }
+    }
   ]
 }

package/fixtures/sidecar/toolsets.json

@@ -0,0 +1,468 @@
+{
+  "toolsets.catalog": [
+    {
+      "params": {
+        "profile_home": "<home>",
+        "enabled_toolsets": null
+      },
+      "result": {
+        "toolsets": [
+          {
+            "name": "a2a",
+            "description": "Plugin toolset: a2a",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "bot_room",
+            "description": "Verified text-only Group Chat turn capabilities",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "browser",
+            "description": "Browser automation for web interaction (navigate, click, type, scroll, iframes, hold-click)",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "browser-cdp",
+            "description": "Plugin toolset: browser-cdp",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "browser-use",
+            "description": "Plugin toolset: browser-use",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "catalog",
+            "description": "Desktop catalog plugin/skill install requests through the approval card (GUI sessions only)",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "clarify",
+            "description": "Ask the user clarifying questions (multiple-choice or open-ended)",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "code_execution",
+            "description": "Run Python scripts that call tools programmatically (reduces LLM round trips)",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "coding",
+            "description": "Coding-focused toolset: files, terminal, search, web docs, skills, todo, delegate, vision, browser",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "computer_use",
+            "description": "Background desktop control via cua-driver (macOS/Windows/Linux) — screenshots, mouse, keyboard, scroll, drag. Does NOT steal the user's cursor or keyboard focus. Works with any tool-capable model.",
+            "available": false,
+            "selected": true,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "connections",
+            "description": "Remote connector discovery, execution, and account authorization",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "context_engine",
+            "description": "Runtime tools exposed by the active context engine",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "cronjob",
+            "description": "Cronjob management tool - create, list, update, pause, resume, remove, and trigger scheduled tasks",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "debugging",
+            "description": "Debugging and troubleshooting toolkit",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "delegation",
+            "description": "Spawn subagents with isolated context for complex subtasks",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "desktop_ui",
+            "description": "Desktop GUI affordances — in-app terminal/browser panes, pane focus, reactions, appearance (GUI sessions only)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "discord",
+            "description": "Discord read and participate tools (fetch messages, search members, create threads)",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "discord_admin",
+            "description": "Discord server management (list channels/roles, pin messages, assign roles)",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "feishu_doc",
+            "description": "Read Feishu/Lark document content",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "feishu_drive",
+            "description": "Feishu/Lark document comment operations (list, reply, add)",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "file",
+            "description": "File manipulation tools: read, write, patch (with fuzzy matching), and search (content + files)",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-acp",
+            "description": "Editor integration (VS Code, Zed, JetBrains) — coding-focused tools without messaging, audio, or clarify UI",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-api-server",
+            "description": "OpenAI-compatible API server — full agent tools accessible via HTTP (no interactive UI tools like clarify or send_message)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-bluebubbles",
+            "description": "BlueBubbles iMessage bot toolset - Apple iMessage via local BlueBubbles server",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-cli",
+            "description": "Full interactive CLI toolset - all default tools plus cronjob management",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-cron",
+            "description": "Default cron toolset - same core tools as hermes-cli; gated by `hermes tools`",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-dingtalk",
+            "description": "DingTalk bot toolset - enterprise messaging platform (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-discord",
+            "description": "Discord bot toolset - full access (terminal has safety checks via dangerous command approval)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-email",
+            "description": "Email bot toolset - interact with Hermes via email (IMAP/SMTP)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-feishu",
+            "description": "Feishu/Lark bot toolset - enterprise messaging via Feishu/Lark (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-gateway",
+            "description": "Gateway toolset - union of all messaging platform tools",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-matrix",
+            "description": "Matrix bot toolset - decentralized encrypted messaging (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-mattermost",
+            "description": "Mattermost bot toolset - self-hosted team messaging (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-qqbot",
+            "description": "QQBot toolset - QQ messaging via Official Bot API v2 (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-signal",
+            "description": "Signal bot toolset - encrypted messaging platform (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-slack",
+            "description": "Slack bot toolset - full access for workspace use (terminal has safety checks)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-sms",
+            "description": "SMS bot toolset - interact with Hermes via SMS (Twilio)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-telegram",
+            "description": "Telegram bot toolset - full access for personal use (terminal has safety checks)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-webhook",
+            "description": "Webhook toolset - receive and process external webhook events",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-wecom",
+            "description": "WeCom bot toolset - enterprise WeChat messaging (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-wecom-callback",
+            "description": "WeCom callback toolset - enterprise self-built app messaging (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-weixin",
+            "description": "Weixin bot toolset - personal WeChat messaging via iLink (full access)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-whatsapp",
+            "description": "WhatsApp bot toolset - similar to Telegram (personal messaging, more trusted)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "hermes-yuanbao",
+            "description": "Yuanbao Bot 元宝消息平台工具集 - 群信息、成员查询、私聊、贴纸表情",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "image_gen",
+            "description": "Creative generation tools (images)",
+            "available": false,
+            "selected": true,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "kanban",
+            "description": "Kanban multi-agent coordination — only active when the agent is spawned by the kanban dispatcher (HERMES_KANBAN_TASK env set). The dispatcher runs inside the gateway by default; see `kanban.dispatch_in_gateway` in config.yaml. Lets workers mark tasks done with structured handoffs, enter first-class review (request_review — not a block), return review changes, block for human input, heartbeat during long ops, comment on threads, attach files, and (for orchestrators) list, unblock, and fan out tasks.",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "memory",
+            "description": "Persistent memory across sessions (personal notes + user profile)",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "onboarding",
+            "description": "First-run onboarding cards; folded in only for the onboarding chat (tui_gateway/methods_onboarding.py)",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "project",
+            "description": "Desktop Projects — create/switch named workspaces (GUI sessions only)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "safe",
+            "description": "Safe toolkit without terminal access",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "search",
+            "description": "Web search only (no content extraction/scraping)",
+            "available": true,
+            "selected": false,
+            "unavailable_reason": null
+          },
+          {
+            "name": "session_search",
+            "description": "Search and recall past conversations with summarization",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "skills",
+            "description": "Access, create, edit, and manage skill documents with specialized instructions and knowledge",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "terminal",
+            "description": "Terminal/command execution and process management tools",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "todo",
+            "description": "Task planning and tracking for multi-step work",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "tts",
+            "description": "Text-to-speech: convert text to audio with Edge TTS (free), ElevenLabs, OpenAI, or xAI",
+            "available": false,
+            "selected": true,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "video",
+            "description": "Video analysis and understanding tools (opt-in, not in default toolset)",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "video_gen",
+            "description": "Video generation tools. Single ``video_generate`` tool covers text-to-video (prompt only) and image-to-video (prompt + image_url), plus reference-to-video. Provider-specific edit/extend workflows may appear as separate tools. Configure via ``hermes tools`` → Video Generation.",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "vision",
+            "description": "Image analysis and vision tools",
+            "available": false,
+            "selected": true,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "web",
+            "description": "Web research and content extraction tools",
+            "available": true,
+            "selected": true,
+            "unavailable_reason": null
+          },
+          {
+            "name": "x_search",
+            "description": "Search X (Twitter) posts and threads via xAI's built-in x_search Responses tool. Read-only public X discovery; use the xurl skill for authenticated X API reads and account actions. Available when xAI credentials are configured (SuperGrok OAuth or XAI_API_KEY). Off by default; enable in `hermes tools` → X (Twitter) Search.",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          },
+          {
+            "name": "yuanbao",
+            "description": "Yuanbao platform tools - group info, member queries, DM, stickers",
+            "available": false,
+            "selected": false,
+            "unavailable_reason": "unavailable"
+          }
+        ],
+        "selected_toolsets": [
+          "browser",
+          "clarify",
+          "code_execution",
+          "computer_use",
+          "connections",
+          "cronjob",
+          "delegation",
+          "file",
+          "image_gen",
+          "memory",
+          "session_search",
+          "skills",
+          "terminal",
+          "todo",
+          "tts",
+          "vision",
+          "web"
+        ],
+        "using_defaults": true
+      }
+    }
+  ]
+}

package/fixtures/sidecar/usage.json

@@ -17,7 +17,8 @@
         "provider": "deepseek"
       },
       "result": {
-        "entries": []
+        "entries": [],
+        "has_api_key": false
       }
     }
   ],
@@ -27,7 +28,8 @@
         "profile_home": "<home>"
       },
       "result": {
-        "providers": []
+        "providers": [],
+        "keys": {}
       }
     }
   ],
@@ -47,5 +49,23 @@
         "windows": []
       }
     }
+  ],
+  "usage.limits": [
+    {
+      "params": {
+        "profile_home": "<home>",
+        "providers": [
+          {
+            "slug": "deepseek",
+            "models": [
+              "deepseek-chat"
+            ]
+          }
+        ]
+      },
+      "result": {
+        "limits": {}
+      }
+    }
   ]
 }