@ouro.bot/cli 0.1.0-alpha.154 → 0.1.0-alpha.155

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.155",
+      "changes": [
+        "polish(debug): dynamic toggle, richer descriptions, human-readable results"
+      ]
+    },
     {
       "version": "0.1.0-alpha.154",
       "changes": [

package/dist/heart/tool-activity-callbacks.js

@@ -8,22 +8,28 @@ function createToolActivityCallbacks(options) {
         component: "engine",
         event: "engine.tool_activity_callbacks_created",
         message: "tool activity callbacks initialized",
-        meta: { isDebug: options.isDebug },
+        meta: {},
     });
+    // Track the last description so we can reference it in END messages
+    let lastDescription = null;
     return {
         onToolStart(name, args) {
             const description = (0, tool_description_1.humanReadableToolDescription)(name, args);
             if (description === null)
-                return; // hidden tool (settle, rest)
+                return; // hidden tool (settle, rest, descend)
+            lastDescription = description;
             options.onDescription(description);
         },
         onToolEnd(name, summary, success) {
+            const desc = lastDescription ?? name;
+            // Strip trailing "..." from description for the result line
+            const cleanDesc = desc.endsWith("...") ? desc.slice(0, -3) : desc;
             if (!success) {
-                options.onFailure(`${name} failed: ${summary}`);
+                options.onFailure(`\u2717 ${cleanDesc} — ${summary}`);
                 return;
             }
-            if (options.isDebug) {
-                options.onResult(`${name}: ${summary}`);
+            if (options.isDebug()) {
+                options.onResult(`\u2713 ${cleanDesc}`);
             }
         },
     };

package/dist/heart/tool-description.js

@@ -12,6 +12,7 @@ function truncate(text, max) {
     return text.slice(0, max - 1) + "\u2026";
 }
 const TOOL_DESCRIPTIONS = {
+    // File operations
     shell: (args) => {
         const cmd = args.command;
         if (!cmd)
@@ -36,11 +37,11 @@ const TOOL_DESCRIPTIONS = {
             return "editing a file...";
         return `editing ${basename(fp)}...`;
     },
-    recall: (args) => {
-        const q = args.query;
-        if (!q)
-            return "searching memory...";
-        return `searching memory for '${truncate(q, 40)}'...`;
+    glob: (args) => {
+        const p = args.pattern;
+        if (!p)
+            return "searching for files...";
+        return `searching for ${truncate(p, 40)}...`;
     },
     grep: (args) => {
         const p = args.pattern;
@@ -48,21 +49,65 @@ const TOOL_DESCRIPTIONS = {
             return "searching code...";
         return `searching code for '${truncate(p, 40)}'...`;
     },
-    glob: (args) => {
-        const p = args.pattern;
-        if (!p)
-            return "searching for files...";
-        return `searching for ${truncate(p, 40)}...`;
+    // Memory and knowledge
+    recall: (args) => {
+        const q = args.query;
+        if (!q)
+            return "searching memory...";
+        return `searching memory for '${truncate(q, 40)}'...`;
+    },
+    diary_write: (args) => {
+        const about = args.about;
+        return about ? `noting something about ${truncate(about, 30)}...` : "noting something down...";
+    },
+    save_friend_note: () => "making a note about you...",
+    get_friend_note: () => "checking my notes...",
+    load_skill: (args) => {
+        const name = args.name || args.skill;
+        return name ? `loading ${name} skill...` : "loading a skill...";
+    },
+    // Session and context
+    query_session: (args) => {
+        const mode = args.mode;
+        if (mode === "search")
+            return `searching session for '${truncate(args.query || "", 30)}'...`;
+        if (mode === "status")
+            return "checking inner dialog status...";
+        return "checking session history...";
+    },
+    web_search: (args) => {
+        const q = args.query;
+        return q ? `searching the web for '${truncate(q, 35)}'...` : "searching the web...";
+    },
+    coding_spawn: (args) => {
+        const runner = args.runner;
+        return runner ? `starting ${runner} coding session...` : "starting coding session...";
+    },
+    coding_status: () => "checking coding sessions...",
+    coding_tail: () => "reading coding output...",
+    coding_kill: () => "stopping coding session...",
+    bridge_manage: () => "managing conversation bridge...",
+    // Communication
+    send_message: (args) => {
+        const to = args.to;
+        return to ? `sending a message to ${to}...` : "sending a message...";
+    },
+    surface: () => "sharing a thought...",
+    // Metacognitive (agent's inner life)
+    ponder: (args) => {
+        const thought = args.thought;
+        return thought ? `thinking about ${truncate(thought, 40)}...` : "thinking deeper...";
     },
-    query_session: () => "checking session history...",
-    web_search: () => "searching the web...",
-    coding_spawn: () => "starting coding session...",
-    ponder: () => "thinking deeper...",
     observe: () => "listening...",
-    diary_write: () => "noting something down...",
-    save_friend_note: () => "making a note...",
+    claude: () => "reasoning...",
+    set_reasoning_effort: (args) => {
+        const level = args.level;
+        return level ? `setting thinking depth to ${level}...` : "adjusting thinking depth...";
+    },
+    // Hidden — these ARE the response or end-of-turn
     settle: () => null,
     rest: () => null,
+    descend: () => null,
 };
 function humanReadableToolDescription(name, args) {
     (0, runtime_1.emitNervesEvent)({

package/dist/senses/bluebubbles.js

@@ -408,8 +408,8 @@ function createBlueBubblesCallbacks(client, chat, replyTarget, isGroupChat) {
         /* v8 ignore next -- onResult only called in debug mode; tested via tool-activity-callbacks.test.ts @preserve */
         onResult: (text) => sendStatus(text),
         /* v8 ignore next -- onFailure only called on tool failure; tested via tool-activity-callbacks.test.ts @preserve */
-        onFailure: (text) => sendStatus(`\u2717 ${text}`),
-        isDebug: (0, commands_1.getDebugMode)(),
+        onFailure: (text) => sendStatus(text),
+        isDebug: commands_1.getDebugMode,
     });
     return {
         onModelStart() {

package/dist/senses/commands.js

@@ -87,11 +87,16 @@ function registerDefaultCommands(registry) {
     });
     registry.register({
         name: "debug",
-        description: "toggle debug mode (verbose tool output)",
-        channels: ["cli", "teams", "bluebubbles"],
+        description: "toggle debug mode — see more detail about what I'm doing",
+        channels: ["cli", "teams", "bluebubbles", "mcp"],
         handler: () => {
             _debugMode = !_debugMode;
-            return { action: "response", message: `debug mode: ${_debugMode ? "ON" : "OFF"}` };
+            return {
+                action: "response",
+                message: _debugMode
+                    ? "debug mode on — you'll see more detail about what I'm doing"
+                    : "debug mode off — back to clean output",
+            };
         },
     });
     (0, runtime_1.emitNervesEvent)({

package/dist/senses/teams.js

@@ -433,8 +433,8 @@ function createTeamsCallbacks(stream, controller, sendMessage, options) {
                 /* v8 ignore next -- onResult only called in debug mode; tested via tool-activity-callbacks.test.ts @preserve */
                 onResult: (text) => safeUpdate(text),
                 /* v8 ignore next -- onFailure tested via onToolEnd failure test @preserve */
-                onFailure: (text) => safeUpdate(`\u2717 ${text}`),
-                isDebug: (0, commands_2.getDebugMode)(),
+                onFailure: (text) => safeUpdate(text),
+                isDebug: commands_2.getDebugMode,
             });
             return {
                 onToolStart: (name, args) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.154",
+  "version": "0.1.0-alpha.155",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",