@maudecode/talaria-web-contracts 1.17.2 → 1.19.0

package/fixtures/sidecar/commands.json

@@ -17,7 +17,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "clear",
@@ -28,7 +29,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "redraw",
@@ -39,7 +41,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "history",
@@ -50,7 +53,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "save",
@@ -61,7 +65,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "retry",
@@ -72,7 +77,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "prompt",
@@ -85,7 +91,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "undo",
@@ -96,7 +103,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "title",
@@ -107,7 +115,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "handoff",
@@ -118,20 +127,22 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "branch",
-            "description": "Branch the current session (explore a different path)",
+            "description": "Branch the current session (new thread on Discord/Telegram/Slack/Matrix; --here stays here)",
             "category": "Session",
             "aliases": [
               "fork"
             ],
-            "args_hint": "[name]",
+            "args_hint": "[--here] [name]",
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "worktree",
@@ -146,7 +157,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "compress",
@@ -159,7 +171,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "rollback",
@@ -170,7 +183,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "snapshot",
@@ -183,7 +197,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "export",
@@ -194,7 +209,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "import",
@@ -205,7 +221,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "stop",
@@ -216,7 +233,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "bg",
@@ -227,7 +245,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "btw",
@@ -238,7 +257,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "agents",
@@ -251,7 +271,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "journey",
@@ -269,7 +290,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "queue",
@@ -289,29 +311,34 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "steer",
             "description": "Inject a message after the next tool call without interrupting",
             "category": "Session",
-            "aliases": [],
+            "aliases": [
+              "s"
+            ],
             "args_hint": "<prompt>",
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "goal",
             "description": "Set a standing goal Hermes works on across turns until achieved",
             "category": "Session",
             "aliases": [],
-            "args_hint": "[text | draft <text> | show | gate add <cmd> | pause | resume | clear | status | wait <pid> | unwait]",
+            "args_hint": "[text | -- <text> | draft <text> | show | gate add <cmd> | pause | resume | clear | status | wait <pid> | unwait]",
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "heartbeat",
@@ -329,7 +356,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "refine",
@@ -340,7 +368,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "review",
@@ -351,7 +380,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "loop",
@@ -364,7 +394,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "plan",
@@ -375,7 +406,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": "expand"
           },
           {
             "name": "moa",
@@ -386,7 +418,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "subgoal",
@@ -397,7 +430,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "status",
@@ -408,7 +442,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "egress",
@@ -421,7 +456,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "context",
@@ -436,7 +472,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "whoami",
@@ -447,7 +484,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "profile",
@@ -458,7 +496,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "resume",
@@ -469,7 +508,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "sessions",
@@ -480,7 +520,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "config",
@@ -491,7 +532,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "model",
@@ -502,7 +544,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "codex-runtime",
@@ -515,7 +558,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": true
+            "exec": true,
+            "prompt": null
           },
           {
             "name": "personality",
@@ -526,7 +570,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "statusbar",
@@ -539,7 +584,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "battery",
@@ -554,7 +600,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "timestamps",
@@ -571,7 +618,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "diff",
@@ -586,7 +634,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "verbose",
@@ -597,7 +646,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "focus",
@@ -612,7 +662,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "footer",
@@ -627,7 +678,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "yolo",
@@ -638,7 +690,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "approvals",
@@ -653,7 +706,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "reasoning",
@@ -680,19 +734,22 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "fast",
-            "description": "Fast mode — OpenAI Priority Processing / Anthropic Fast Mode (normal/fast/auto/cold)",
+            "description": "Fast mode — OpenAI Priority Processing / Anthropic Fast Mode (normal/fast/auto/cold/ultrafast)",
             "category": "Configuration",
             "aliases": [],
-            "args_hint": "[normal|fast|auto|cold|status] [--global]",
+            "args_hint": "[normal|fast|auto|cold|ultrafast|status] [--global]",
             "subcommands": [
               "normal",
               "fast",
               "auto",
               "cold",
+              "ultrafast",
+              "ultra",
               "status",
               "on",
               "off",
@@ -700,7 +757,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "skin",
@@ -711,7 +769,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "indicator",
@@ -727,7 +786,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "voice",
@@ -743,7 +803,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "wake",
@@ -758,7 +819,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "busy",
@@ -774,7 +836,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "tools",
@@ -785,7 +848,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "toolsets",
@@ -796,7 +860,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "skills",
@@ -818,7 +883,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "memory",
@@ -834,7 +900,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "bundles",
@@ -845,7 +912,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "pet",
@@ -861,7 +929,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "hatch",
@@ -874,7 +943,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "learn",
@@ -885,7 +955,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": "expand"
           },
           {
             "name": "init",
@@ -896,7 +967,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": "expand"
           },
           {
             "name": "cron",
@@ -916,7 +988,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "suggestions",
@@ -934,7 +1007,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "blueprint",
@@ -947,7 +1021,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": "unsupported"
           },
           {
             "name": "curator",
@@ -967,7 +1042,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "kanban",
@@ -1012,7 +1088,8 @@
             ],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "reload",
@@ -1023,7 +1100,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "reload-mcp",
@@ -1036,7 +1114,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": true
+            "exec": true,
+            "prompt": null
           },
           {
             "name": "reload-skills",
@@ -1049,7 +1128,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": true
+            "exec": true,
+            "prompt": null
           },
           {
             "name": "browser",
@@ -1065,7 +1145,8 @@
             ],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "plugins",
@@ -1076,7 +1157,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "help",
@@ -1087,7 +1169,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "palette",
@@ -1098,7 +1181,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "usage",
@@ -1109,7 +1193,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "subscription",
@@ -1122,7 +1207,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "login",
@@ -1133,7 +1219,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "topup",
@@ -1144,7 +1231,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "insights",
@@ -1155,7 +1243,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "platforms",
@@ -1168,7 +1257,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "copy",
@@ -1179,7 +1269,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "paste",
@@ -1190,7 +1281,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "image",
@@ -1201,7 +1293,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "version",
@@ -1214,7 +1307,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "debug",
@@ -1225,7 +1319,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "quit",
@@ -1238,7 +1333,8 @@
             "subcommands": [],
             "cli_only": true,
             "gateway_only": false,
-            "exec": false
+            "exec": false,
+            "prompt": null
           },
           {
             "name": "credits",
@@ -1249,7 +1345,8 @@
             "subcommands": [],
             "cli_only": false,
             "gateway_only": false,
-            "exec": true
+            "exec": true,
+            "prompt": null
           }
         ]
       }
@@ -1331,5 +1428,67 @@
         }
       }
     }
+  ],
+  "commands.expand_prompt": [
+    {
+      "params": {
+        "profile_home": "<home>",
+        "command": "/etc/hosts looks wrong",
+        "workspace": "<home>",
+        "enabled_toolsets": null
+      },
+      "result": {
+        "name": null,
+        "message": null
+      }
+    },
+    {
+      "params": {
+        "profile_home": "<home>",
+        "command": "/plan add a dark mode",
+        "workspace": "<home>",
+        "enabled_toolsets": null
+      },
+      "result": {
+        "name": "plan",
+        "message": "[/plan — plan mode]\n\nFor this turn, you are in PLAN MODE — planning only.\n\n- Do not implement code.\n- Do not edit project files except the plan markdown file itself.\n- Do not run mutating terminal commands, commit, push, or perform external\n  actions.\n- You may inspect the repo or other context with read-only commands/tools\n  when needed.\n- Your deliverable is a markdown plan saved inside the active workspace under\n  `.hermes/plans/YYYY-MM-DD_HHMMSS-<slug>.md` (create the directory if\n  needed; Hermes file tools are backend-aware, so this relative path keeps\n  the plan with the workspace on local, docker, ssh, modal, and daytona\n  backends). If the runtime provides a specific target path, use that exact\n  path instead.\n\nTask to plan:\nadd a dark mode\n\nWrite the plan for an implementer with zero context for the codebase and\nquestionable taste. A good plan makes implementation obvious — if someone has\nto guess, the plan is incomplete.\n\nStructure (include the sections that are relevant):\n- Goal — one sentence.\n- Current context / assumptions.\n- Architecture / proposed approach — 2-3 sentences.\n- Step-by-step tasks. Each task is bite-sized (2-5 minutes of focused work),\n  names exact file paths (`src/models/user.py`, not \"the model file\"),\n  includes complete copy-pasteable code where code is needed, and exact\n  commands with expected output for verification.\n- Tests / validation — for code tasks, follow the TDD cycle per task: write\n  the failing test, run it to verify failure, implement minimally, run to\n  verify pass, commit.\n- Risks, tradeoffs, and open questions.\n\nPrinciples: DRY, YAGNI, TDD, frequent commits. Avoid vague tasks (\"add\nauthentication\"), incomplete code (\"add validation here\"), and unverifiable\nsteps (\"test it works\" — instead: the exact command and its expected output).\n\nInteraction style:\n- If the request is clear enough, write the plan directly.\n- If it is genuinely underspecified, ask a brief clarifying question instead\n  of guessing.\n- After saving the plan, reply briefly with what you planned and the saved\n  path, and offer to execute it (e.g. via subagent-driven development) —\n  but do not start executing in this turn."
+      }
+    }
+  ],
+  "commands.bundles": [
+    {
+      "params": {
+        "profile_home": "<profile>"
+      },
+      "result": {
+        "bundles": [
+          {
+            "name": "media-kit",
+            "description": "Find media",
+            "skill_count": 2,
+            "source": "bundle"
+          }
+        ]
+      }
+    }
+  ],
+  "commands.bundle_resolve": [
+    {
+      "params": {
+        "profile_home": "<profile>",
+        "command": "/media-kit find a cat"
+      },
+      "result": {
+        "name": "media-kit",
+        "source": "bundle",
+        "message": "[IMPORTANT: The user has invoked the \"media-kit\" skill bundle, loading 1 skills together. Treat every skill below as active guidance for this turn.]\n\nBundle: media-kit\nSkills loaded: gif-search\nSkills missing (skipped): not-installed\n\nUser instruction: find a cat\n\n[Loaded as part of the \"media-kit\" skill bundle.]\n\n---\nname: gif-search\ndescription: \"Search/download GIFs from Tenor via curl + jq.\"\nversion: 1.1.0\nauthor: Hermes Agent\nlicense: MIT\nplatforms: [linux, macos, windows]\nprerequisites:\n  env_vars: [TENOR_API_KEY]\n  commands: [curl, jq]\nmetadata:\n  hermes:\n    tags: [GIF, Media, Search, Tenor, API]\n---\n\n# GIF Search (Tenor API)\n\nSearch and download GIFs directly via the Tenor API using curl. No extra tools needed.\n\n## When to use\n\nUseful for finding reaction GIFs, creating visual content, and sending GIFs in chat.\n\n## Setup\n\nSet your Tenor API key in your environment (add to `${HERMES_HOME:-~/.hermes}/.env`):\n\n```bash\nTENOR_API_KEY=your_key_here\n```\n\nGet a free API key at https://developers.google.com/tenor/guides/quickstart — the Google Cloud Console Tenor API key is free and has generous rate limits.\n\n## Prerequisites\n\n- `curl` and `jq` (both standard on macOS/Linux)\n- `TENOR_API_KEY` environment variable\n\n## Search for GIFs\n\n```bash\n# Search and get GIF URLs\ncurl -s \"https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}\" | jq -r '.results[].media_formats.gif.url'\n\n# Get smaller/preview versions\ncurl -s \"https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}\" | jq -r '.results[].media_formats.tinygif.url'\n```\n\n## Download a GIF\n\n```bash\n# Search and download the top result\nURL=$(curl -s \"https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}\" | jq -r '.results[0].media_formats.gif.url')\ncurl -sL \"$URL\" -o celebration.gif\n```\n\n## Get Full Metadata\n\n```bash\ncurl -s \"https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}\" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}'\n```\n\n## API Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| `q` | Search query (URL-encode spaces as `+`) |\n| `limit` | Max results (1-50, default 20) |\n| `key` | API key (from `$TENOR_API_KEY` env var) |\n| `media_filter` | Filter formats: `gif`, `tinygif`, `mp4`, `tinymp4`, `webm` |\n| `contentfilter` | Safety: `off`, `low`, `medium`, `high` |\n| `locale` | Language: `en_US`, `es`, `fr`, etc. |\n\n## Available Media Formats\n\nEach result has multiple formats under `.media_formats`:\n\n| Format | Use case |\n|--------|----------|\n| `gif` | Full quality GIF |\n| `tinygif` | Small preview GIF |\n| `mp4` | Video version (smaller file size) |\n| `tinymp4` | Small preview video |\n| `webm` | WebM video |\n| `nanogif` | Tiny thumbnail |\n\n## Notes\n\n- URL-encode the query: spaces as `+`, special chars as `%XX`\n- For sending in chat, `tinygif` URLs are lighter weight\n- GIF URLs can be used directly in markdown: `![alt](url)`\n\n[Skill directory: <profile>/skills/media/gif-search]\nResolve any relative paths in this skill (e.g. `scripts/foo.js`, `templates/config.yaml`) against that directory, then run them with the terminal tool using the absolute path.\n\n[Skill setup note: Setup needed before using this skill: missing env $TENOR_API_KEY.]",
+        "loaded_skills": [
+          "gif-search"
+        ],
+        "missing_skills": [
+          "not-installed"
+        ]
+      }
+    }
   ]
 }