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

package/changelog.json

@@ -1,6 +1,22 @@
 {
   "_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.156",
+      "changes": [
+        "polish: observe tool now hidden (like settle/rest/descend)",
+        "polish(bb): batch rapid tool status messages within 500ms debounce window",
+        "polish(tools): word-boundary truncation instead of mid-word cut",
+        "polish(commands): /commands output uses em dash separators",
+        "polish(bb): re-enable typing indicator after each status message"
+      ]
+    },
+    {
+      "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

@@ -9,9 +9,16 @@ function basename(filePath) {
 function truncate(text, max) {
     if (text.length <= max)
         return text;
-    return text.slice(0, max - 1) + "\u2026";
+    // Cut at last space before maxLen to avoid mid-word truncation
+    const slice = text.slice(0, max - 1);
+    const lastSpace = slice.lastIndexOf(" ");
+    if (lastSpace > 0)
+        return text.slice(0, lastSpace) + "\u2026";
+    // No space found (single long word) — hard truncate
+    return slice + "\u2026";
 }
 const TOOL_DESCRIPTIONS = {
+    // File operations
     shell: (args) => {
         const cmd = args.command;
         if (!cmd)
@@ -36,11 +43,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 +55,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...";
+    },
+    observe: () => null,
+    claude: () => "reasoning...",
+    set_reasoning_effort: (args) => {
+        const level = args.level;
+        return level ? `setting thinking depth to ${level}...` : "adjusting thinking depth...";
     },
-    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...",
+    // 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

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.enrichReactionText = enrichReactionText;
+exports.createStatusBatcher = createStatusBatcher;
 exports.handleBlueBubblesEvent = handleBlueBubblesEvent;
 exports.recoverMissedBlueBubblesMessages = recoverMissedBlueBubblesMessages;
 exports.createBlueBubblesWebhookHandler = createBlueBubblesWebhookHandler;
@@ -81,6 +82,44 @@ function enrichReactionText(baseText, originalText, maxLen) {
         : originalText;
     return `${baseText} to: "${truncated}"`;
 }
+/**
+ * Accumulates status descriptions and debounces them.
+ * If multiple descriptions arrive within `delayMs`, they are joined with ` · `
+ * and sent as a single message. Flush sends immediately and clears the timer.
+ */
+function createStatusBatcher(send, delayMs) {
+    (0, runtime_1.emitNervesEvent)({
+        component: "senses",
+        event: "senses.bluebubbles_status_batcher_created",
+        message: "status batcher initialized",
+        meta: { delayMs },
+    });
+    let pending = [];
+    let timer = null;
+    function fire() {
+        if (pending.length === 0)
+            return;
+        const combined = pending.join(" \u00b7 ");
+        pending = [];
+        timer = null;
+        send(combined);
+    }
+    return {
+        add(text) {
+            pending.push(text);
+            if (timer !== null)
+                clearTimeout(timer);
+            timer = setTimeout(fire, delayMs);
+        },
+        flush() {
+            if (timer !== null) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            fire();
+        },
+    };
+}
 const defaultDeps = {
     getAgentName: identity_1.getAgentName,
     buildSystem: prompt_1.buildSystem,
@@ -401,15 +440,18 @@ function createBlueBubblesCallbacks(client, chat, replyTarget, isGroupChat) {
                 text,
                 replyToMessageGuid: replyTarget.getReplyToMessageGuid(),
             });
+            // Re-enable typing indicator — sending a message clears the typing bubble
+            await client.setTyping(chat, true);
         });
     }
+    const statusBatcher = createStatusBatcher((text) => sendStatus(text), 500);
     const toolCallbacks = (0, tool_activity_callbacks_1.createToolActivityCallbacks)({
-        onDescription: (text) => sendStatus(text),
+        onDescription: (text) => statusBatcher.add(text),
         /* v8 ignore next -- onResult only called in debug mode; tested via tool-activity-callbacks.test.ts @preserve */
-        onResult: (text) => sendStatus(text),
+        onResult: (text) => { statusBatcher.flush(); 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) => { statusBatcher.flush(); sendStatus(text); },
+        isDebug: commands_1.getDebugMode,
     });
     return {
         onModelStart() {
@@ -471,6 +513,7 @@ function createBlueBubblesCallbacks(client, chat, replyTarget, isGroupChat) {
             textBuffer = "";
         },
         async flush() {
+            statusBatcher.flush();
             await queue;
             const trimmed = textBuffer.trim();
             if (!trimmed) {
@@ -495,6 +538,7 @@ function createBlueBubblesCallbacks(client, chat, replyTarget, isGroupChat) {
             });
         },
         async finish() {
+            statusBatcher.flush();
             if (!typingActive) {
                 await queue;
                 return;

package/dist/senses/commands.js

@@ -72,7 +72,7 @@ function registerDefaultCommands(registry) {
         channels: ["cli", "teams"],
         handler: (ctx) => {
             const cmds = registry.list(ctx.channel);
-            const lines = cmds.map((c) => `/${c.name} - ${c.description}`);
+            const lines = cmds.map((c) => `/${c.name} \u2014 ${c.description}`);
             return { action: "response", message: lines.join("\n") };
         },
     });
@@ -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.156",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",