@nevescloud/pip 3.8.2 → 3.8.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nevescloud/pip",
-  "version": "3.8.2",
+  "version": "3.8.3",
   "description": "Floating assistant bubble + panel + chat runtime. ESM, no build.",
   "type": "module",
   "main": "pip-core.esm.js",

package/runtime.esm.js

@@ -236,12 +236,27 @@ export function createRuntime({
       return { clearedUI: true };
     }
     if (cmd === 'tools') {
-      // The slash autocomplete dropdown enumerates registered tools via
-      // complete() — listing them as a chat turn duplicates that surface
-      // and pollutes history. Reopen the dropdown in arg-mode instead;
-      // same primitive /help and /model adopted via openCompletions.
+      // No-arg form opens the autocomplete dropdown (same surface /help and
+      // /model adopted via openCompletions) so users can browse without
+      // polluting chat history. With an arg the user picked a specific
+      // tool — render its description + schema as a reply so the dropdown
+      // selection has a meaningful outcome instead of looping back.
       if (registeredTools.size === 0) return { reply: 'No tools registered.' };
-      return { openCompletions: true };
+      const arg = args.trim();
+      if (!arg) return { openCompletions: true };
+      const tool = registeredTools.get(arg);
+      if (!tool) {
+        const all = Array.from(registeredTools.keys()).map((n) => `\`${n}\``).join(', ');
+        return { reply: `Unknown tool \`${arg}\`. Available: ${all}` };
+      }
+      const lines = [`**\`${tool.name}\`** — ${tool.description || '(no description)'}`];
+      const schema = tool.schema || tool.input_schema;
+      if (schema && Object.keys(schema.properties || {}).length > 0) {
+        lines.push('', '```json', JSON.stringify(schema, null, 2), '```');
+      } else if (schema) {
+        lines.push('', '(no arguments)');
+      }
+      return { reply: lines.join('\n') };
     }
     if (cmd === 'model' && models.length) {
       const arg = args.trim();