@mutirolabs/openclaw-brain 0.2.0 → 0.2.1

package/dist/src/signal-forwarder.js

@@ -0,0 +1,119 @@
+// Bridges OpenClaw's mid-turn reply-dispatch hooks into Mutiro's
+// signal.emit envelopes so the user sees a live "typing / searching /
+// remembering" indicator while the agent works. Fire-and-forget: signals
+// are transient UI chrome, not messages. No correlation required.
+//
+// Maps OpenClaw callbacks (from GetReplyOptions) to Mutiro's signal
+// vocabulary (SIGNAL_TYPE_* in spec/protobuf/shared/signal.proto).
+const REASONING_DEBOUNCE_MS = 500;
+const TOOL_DETAIL_MAX_CHARS = 120;
+const TOOL_SIGNAL_MAP = {
+    // Web
+    web_search: { signal: "SIGNAL_TYPE_WEB_SEARCHING", intent: "Searching web" },
+    web_fetch: { signal: "SIGNAL_TYPE_WEB_FETCHING", intent: "Fetching" },
+    fetch: { signal: "SIGNAL_TYPE_WEB_FETCHING", intent: "Fetching" },
+    // Memory / recall
+    recall: { signal: "SIGNAL_TYPE_RECALLING", intent: "Recalling" },
+    memory_search: { signal: "SIGNAL_TYPE_RECALLING", intent: "Searching memory" },
+    memory: { signal: "SIGNAL_TYPE_READING_MEMORY", intent: "Reading memory" },
+    memory_remember: { signal: "SIGNAL_TYPE_WRITING_MEMORY", intent: "Saving memory" },
+    memory_write: { signal: "SIGNAL_TYPE_WRITING_MEMORY", intent: "Saving memory" },
+    // Media
+    image_generate: { signal: "SIGNAL_TYPE_CREATING_IMAGE", intent: "Creating image" },
+    image: { signal: "SIGNAL_TYPE_CREATING_IMAGE", intent: "Working with image" },
+    // Scheduling / planning
+    cron: { signal: "SIGNAL_TYPE_SCHEDULING", intent: "Scheduling" },
+    update_plan: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Updating plan" },
+    // Mutiro-native channel tools
+    mutiro_send_voice_message: { signal: "SIGNAL_TYPE_SENDING_VOICE", intent: "Sending voice" },
+    mutiro_send_card: { signal: "SIGNAL_TYPE_ATTACHING_FILE", intent: "Preparing card" },
+    mutiro_forward_message: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Forwarding message" },
+    // File operations (coding profile). Mutiro has no dedicated SIGNAL_TYPE_*
+    // for file I/O; use CUSTOM + readable intent so the user still sees the
+    // action. Phase (e.g. the path being touched) is appended when present.
+    read: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Reading file" },
+    write: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Writing file" },
+    edit: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Editing file" },
+    apply_patch: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Applying patch" },
+    // Shell / process
+    exec: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Running command" },
+    bash: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Running command" },
+    process: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Managing process" },
+    // UI surfaces
+    canvas: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Updating canvas" },
+    browser: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Browsing" },
+    // Sessions / control plane
+    sessions_list: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Listing sessions" },
+    sessions_history: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Reading history" },
+    sessions_send: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Sending to session" },
+    session_status: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Checking status" },
+    message: { signal: "SIGNAL_TYPE_CUSTOM", intent: "Messaging" },
+};
+const truncateDetail = (raw) => {
+    const collapsed = raw.replace(/\s+/g, " ").trim();
+    if (collapsed.length <= TOOL_DETAIL_MAX_CHARS)
+        return collapsed;
+    return `${collapsed.slice(0, TOOL_DETAIL_MAX_CHARS - 1).trimEnd()}…`;
+};
+export const createSignalForwarder = (session, target) => {
+    let lastReasoningAt = 0;
+    const emit = (signalType, detail) => {
+        session.outbound.emitSignal(target, signalType, detail ?? "");
+    };
+    return {
+        thinking: () => emit("SIGNAL_TYPE_THINKING", "Processing…"),
+        typing: () => emit("SIGNAL_TYPE_TYPING", "Writing response…"),
+        reasoning: () => {
+            // onReasoningStream fires per-token; throttle so we ship at most one
+            // REASONING pulse every REASONING_DEBOUNCE_MS to avoid spamming the
+            // host + Mutiro clients.
+            const now = Date.now();
+            if (now - lastReasoningAt < REASONING_DEBOUNCE_MS)
+                return;
+            lastReasoningAt = now;
+            emit("SIGNAL_TYPE_REASONING", "Thinking…");
+        },
+        toolStart: (name, _phase) => {
+            const trimmedName = (name ?? "").trim();
+            if (!trimmedName) {
+                emit("SIGNAL_TYPE_TOOL_RUNNING");
+                return;
+            }
+            // `onToolStart.phase` is a lifecycle marker ("start"/"update"/"end"),
+            // not semantic payload — ignore it. Tools with args (read, write,
+            // exec, etc.) fire a follow-up `onItemEvent` whose `title` carries
+            // the real detail (e.g. "read src/x.ts"); itemEvent() refines the
+            // pill to that value. For tools that never emit an item event, the
+            // intent label alone is still meaningful.
+            const spec = TOOL_SIGNAL_MAP[trimmedName];
+            const intent = spec?.intent ?? trimmedName;
+            emit(spec?.signal ?? "SIGNAL_TYPE_CUSTOM", truncateDetail(intent));
+        },
+        itemStart: (params) => {
+            // Higher-fidelity source than toolStart: title resolves tool args
+            // into a display ("read src/x.ts", "exec pytest -k foo", etc.) via
+            // OpenClaw's inferToolMetaFromArgs. When we have both the tool
+            // signal type AND the rich title, emit with the specific signal
+            // type so the UI still shows the right pill style.
+            const name = (params.name ?? "").trim();
+            const title = (params.title ?? "").trim();
+            if (!name && !title)
+                return;
+            const spec = name ? TOOL_SIGNAL_MAP[name] : undefined;
+            const detail = truncateDetail(title || spec?.intent || name);
+            emit(spec?.signal ?? "SIGNAL_TYPE_CUSTOM", detail);
+        },
+        compactionStart: () => emit("SIGNAL_TYPE_REMEMBERING", "Organizing context…"),
+        compactionEnd: () => {
+            // No explicit clear — the next signal (or TURN_COMPLETE) replaces the
+            // visible pill on Mutiro clients.
+        },
+        planUpdate: (title) => {
+            const detail = (title ?? "").trim();
+            emit("SIGNAL_TYPE_CUSTOM", detail ? `Planning: ${truncateDetail(detail)}` : "Planning…");
+        },
+        custom: (detail) => emit("SIGNAL_TYPE_CUSTOM", truncateDetail(detail)),
+        turnComplete: () => emit("SIGNAL_TYPE_TURN_COMPLETE"),
+    };
+};
+//# sourceMappingURL=signal-forwarder.js.map

package/dist/src/signal-forwarder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-forwarder.js","sourceRoot":"","sources":["../../src/signal-forwarder.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,sEAAsE;AACtE,yEAAyE;AACzE,kEAAkE;AAClE,EAAE;AACF,oEAAoE;AACpE,mEAAmE;AAKnE,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAQlC,MAAM,eAAe,GAAmC;IACtD,MAAM;IACN,UAAU,EAAE,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,EAAE,eAAe,EAAE;IAC5E,SAAS,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,UAAU,EAAE;IACrE,KAAK,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,UAAU,EAAE;IAEjE,kBAAkB;IAClB,MAAM,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,EAAE;IAChE,aAAa,EAAE,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,EAAE,kBAAkB,EAAE;IAC9E,MAAM,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,gBAAgB,EAAE;IAC1E,eAAe,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,eAAe,EAAE;IAClF,YAAY,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,eAAe,EAAE;IAE/E,QAAQ;IACR,cAAc,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,gBAAgB,EAAE;IAClF,KAAK,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,oBAAoB,EAAE;IAE7E,wBAAwB;IACxB,IAAI,EAAE,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,EAAE,YAAY,EAAE;IAChE,WAAW,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,eAAe,EAAE;IAEtE,8BAA8B;IAC9B,yBAAyB,EAAE,EAAE,MAAM,EAAE,2BAA2B,EAAE,MAAM,EAAE,eAAe,EAAE;IAC3F,gBAAgB,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,MAAM,EAAE,gBAAgB,EAAE;IACpF,sBAAsB,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,EAAE;IAEtF,0EAA0E;IAC1E,wEAAwE;IACxE,wEAAwE;IACxE,IAAI,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,EAAE;IAC9D,KAAK,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,EAAE;IAC/D,IAAI,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,cAAc,EAAE;IAC9D,WAAW,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,gBAAgB,EAAE;IAEvE,kBAAkB;IAClB,IAAI,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE;IACjE,IAAI,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE;IACjE,OAAO,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,kBAAkB,EAAE;IAErE,cAAc;IACd,MAAM,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE;IACnE,OAAO,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,UAAU,EAAE;IAE7D,2BAA2B;IAC3B,aAAa,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,kBAAkB,EAAE;IAC3E,gBAAgB,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAC7E,aAAa,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,oBAAoB,EAAE;IAC7E,cAAc,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAC3E,OAAO,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,WAAW,EAAE;CAC/D,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,GAAW,EAAU,EAAE;IAC7C,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,SAAS,CAAC,MAAM,IAAI,qBAAqB;QAAE,OAAO,SAAS,CAAC;IAChE,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AACvE,CAAC,CAAC;AAeF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,OAAsB,EACtB,MAA4B,EACX,EAAE;IACnB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,MAAM,IAAI,GAAG,CAAC,UAAkB,EAAE,MAAe,EAAE,EAAE;QACnD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC;QAC3D,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,mBAAmB,CAAC;QAC7D,SAAS,EAAE,GAAG,EAAE;YACd,qEAAqE;YACrE,oEAAoE;YACpE,yBAAyB;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,GAAG,GAAG,eAAe,GAAG,qBAAqB;gBAAE,OAAO;YAC1D,eAAe,GAAG,GAAG,CAAC;YACtB,IAAI,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC;QAC7C,CAAC;QACD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAC1B,MAAM,WAAW,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,IAAI,CAAC,0BAA0B,CAAC,CAAC;gBACjC,OAAO;YACT,CAAC;YACD,sEAAsE;YACtE,kEAAkE;YAClE,mEAAmE;YACnE,kEAAkE;YAClE,mEAAmE;YACnE,0CAA0C;YAC1C,MAAM,IAAI,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,WAAW,CAAC;YAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,oBAAoB,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YACpB,kEAAkE;YAClE,mEAAmE;YACnE,+DAA+D;YAC/D,gEAAgE;YAChE,mDAAmD;YACnD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACtD,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,IAAI,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,oBAAoB,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,yBAAyB,EAAE,qBAAqB,CAAC;QAC7E,aAAa,EAAE,GAAG,EAAE;YAClB,sEAAsE;YACtE,kCAAkC;QACpC,CAAC;QACD,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE;YACpB,MAAM,MAAM,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QACtE,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC;KACtD,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mutirolabs/openclaw-brain",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "The official Mutiro Channel extension for OpenClaw. OpenClaw is the brain; Mutiro is the messaging surface, identity, and state.",
   "type": "module",
   "license": "ISC",
@@ -14,8 +14,10 @@
   },
   "scripts": {
     "check": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
     "gateway": "openclaw gateway run",
-    "prepublishOnly": "npm run check"
+    "prepublishOnly": "npm run check && npm run build"
   },
   "publishConfig": {
     "access": "public"
@@ -28,6 +30,7 @@
     "agent"
   ],
   "files": [
+    "dist",
     "index.ts",
     "src",
     "docs",