@maudecode/talaria-web-contracts 1.16.1 → 1.18.0

package/fixtures/sidecar/commands.json

@@ -16,7 +16,8 @@
             "args_hint": "[name]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "clear",
@@ -26,7 +27,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "redraw",
@@ -36,7 +38,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "history",
@@ -46,7 +49,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "save",
@@ -56,7 +60,8 @@
             "args_hint": "<json|md|html> [filename] [redact]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "retry",
@@ -66,7 +71,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "prompt",
@@ -78,7 +84,8 @@
             "args_hint": "[initial text]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "undo",
@@ -88,7 +95,8 @@
             "args_hint": "[N]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "title",
@@ -98,7 +106,8 @@
             "args_hint": "[name]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "handoff",
@@ -108,19 +117,21 @@
             "args_hint": "<platform>",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "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
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "worktree",
@@ -134,7 +145,8 @@
               "prune"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "compress",
@@ -146,7 +158,8 @@
             "args_hint": "[here [N] | focus topic | --preview|--dry-run]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "rollback",
@@ -156,7 +169,8 @@
             "args_hint": "[number] [--all]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "snapshot",
@@ -168,7 +182,8 @@
             "args_hint": "[create|restore <id>|prune]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "export",
@@ -178,7 +193,8 @@
             "args_hint": "[profile] [-o output.tar.gz]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "import",
@@ -188,7 +204,8 @@
             "args_hint": "<archive.tar.gz> [--name <name>]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "stop",
@@ -198,7 +215,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "bg",
@@ -208,7 +226,8 @@
             "args_hint": "<prompt>",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "btw",
@@ -218,7 +237,8 @@
             "args_hint": "<question>",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "agents",
@@ -230,7 +250,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "journey",
@@ -247,7 +268,8 @@
               "edit"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "queue",
@@ -266,27 +288,32 @@
               "add"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "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
+            "gateway_only": false,
+            "exec": false
           },
           {
             "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
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "heartbeat",
@@ -303,7 +330,8 @@
               "clear"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "refine",
@@ -313,7 +341,8 @@
             "args_hint": "[focus instructions]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "review",
@@ -323,7 +352,8 @@
             "args_hint": "[review instructions]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "loop",
@@ -335,7 +365,8 @@
             "args_hint": "[interval] <prompt> [--times N] [--until <condition>] | status | pause | resume | stop",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "plan",
@@ -345,7 +376,21 @@
             "args_hint": "[task]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
+          },
+          {
+            "name": "initiate-setup",
+            "description": "Run the first-run setup: learn about you and set Hermes up around you",
+            "category": "Session",
+            "aliases": [
+              "initiate_setup"
+            ],
+            "args_hint": "",
+            "subcommands": [],
+            "cli_only": false,
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "moa",
@@ -355,7 +400,8 @@
             "args_hint": "<prompt>",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "subgoal",
@@ -365,7 +411,8 @@
             "args_hint": "[text | remove N | clear]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "status",
@@ -375,7 +422,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "egress",
@@ -387,7 +435,8 @@
               "status"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "context",
@@ -401,7 +450,8 @@
               "all"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "whoami",
@@ -411,7 +461,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "profile",
@@ -421,7 +472,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "resume",
@@ -431,7 +483,8 @@
             "args_hint": "[name]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "sessions",
@@ -441,7 +494,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "config",
@@ -451,7 +505,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "model",
@@ -461,7 +516,8 @@
             "args_hint": "[model] [--provider name] [--reasoning level] [--global|--session] [--refresh]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "codex-runtime",
@@ -473,7 +529,8 @@
             "args_hint": "[auto|codex_app_server]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": true
           },
           {
             "name": "personality",
@@ -483,7 +540,8 @@
             "args_hint": "[name]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "statusbar",
@@ -495,7 +553,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "battery",
@@ -509,7 +568,8 @@
               "status"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "timestamps",
@@ -525,7 +585,8 @@
               "status"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "diff",
@@ -539,7 +600,8 @@
               "session"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "verbose",
@@ -549,7 +611,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "focus",
@@ -563,7 +626,8 @@
               "status"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "footer",
@@ -577,7 +641,8 @@
               "status"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "yolo",
@@ -587,7 +652,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "approvals",
@@ -601,7 +667,8 @@
               "off"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "reasoning",
@@ -627,7 +694,8 @@
               "--global"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "fast",
@@ -646,7 +714,8 @@
               "--global"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "skin",
@@ -656,7 +725,8 @@
             "args_hint": "[name]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "indicator",
@@ -671,7 +741,8 @@
               "unicode"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "voice",
@@ -686,7 +757,8 @@
               "status"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "wake",
@@ -700,7 +772,8 @@
               "status"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "busy",
@@ -715,7 +788,8 @@
               "status"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "tools",
@@ -725,7 +799,8 @@
             "args_hint": "[list|disable|enable] [name...]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "toolsets",
@@ -735,7 +810,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "skills",
@@ -756,7 +832,8 @@
               "approval"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "memory",
@@ -771,7 +848,8 @@
               "approval"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "bundles",
@@ -781,7 +859,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "pet",
@@ -796,7 +875,8 @@
               "off"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "hatch",
@@ -808,7 +888,8 @@
             "args_hint": "[description]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "learn",
@@ -818,7 +899,8 @@
             "args_hint": "<what to learn from>",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "init",
@@ -828,7 +910,8 @@
             "args_hint": "[notes]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "cron",
@@ -847,7 +930,8 @@
               "remove"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "suggestions",
@@ -864,7 +948,8 @@
               "clear"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "blueprint",
@@ -876,7 +961,8 @@
             "args_hint": "[name] [slot=value ...]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "curator",
@@ -895,7 +981,8 @@
               "list-archived"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "kanban",
@@ -939,7 +1026,8 @@
               "gc"
             ],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "reload",
@@ -949,7 +1037,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "reload-mcp",
@@ -961,7 +1050,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": true
           },
           {
             "name": "reload-skills",
@@ -973,7 +1063,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": true
           },
           {
             "name": "browser",
@@ -988,7 +1079,8 @@
               "use"
             ],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "plugins",
@@ -998,7 +1090,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "help",
@@ -1008,7 +1101,8 @@
             "args_hint": "[skills|<filter>]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "palette",
@@ -1018,7 +1112,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "usage",
@@ -1028,7 +1123,8 @@
             "args_hint": "[reset [--force]]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "subscription",
@@ -1040,7 +1136,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "login",
@@ -1050,7 +1147,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "topup",
@@ -1060,7 +1158,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "insights",
@@ -1070,7 +1169,8 @@
             "args_hint": "[days]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "platforms",
@@ -1082,7 +1182,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "copy",
@@ -1092,7 +1193,8 @@
             "args_hint": "[number]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "paste",
@@ -1102,7 +1204,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "image",
@@ -1112,7 +1215,8 @@
             "args_hint": "<path>",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "version",
@@ -1124,7 +1228,8 @@
             "args_hint": "",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "debug",
@@ -1134,7 +1239,8 @@
             "args_hint": "[nous|local]",
             "subcommands": [],
             "cli_only": false,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
           },
           {
             "name": "quit",
@@ -1146,7 +1252,19 @@
             "args_hint": "[--delete]",
             "subcommands": [],
             "cli_only": true,
-            "gateway_only": false
+            "gateway_only": false,
+            "exec": false
+          },
+          {
+            "name": "credits",
+            "description": "Show your Nous credits",
+            "category": "Info",
+            "aliases": [],
+            "args_hint": "",
+            "subcommands": [],
+            "cli_only": false,
+            "gateway_only": false,
+            "exec": true
           }
         ]
       }
@@ -1228,5 +1346,41 @@
         }
       }
     }
+  ],
+  "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"
+        ]
+      }
+    }
   ]
 }