discoclaw 1.2.0 → 1.2.1

package/README.md

@@ -77,6 +77,14 @@ Voice is **off by default**. Enable with `DISCOCLAW_VOICE_ENABLED=1` plus API ke
 
 Full setup guide: [docs/voice.md](docs/voice.md)
 
+## Self-management — the bot maintains itself
+
+- **Self-update** — `!update` checks for new npm versions; `!update apply` downloads, installs, and restarts without leaving Discord
+- **Health checks** — `!health`, `!doctor`, `!status` for diagnostics
+- **Secret management** — `!secret` manages `.env` entries from DMs
+- **Model switching** — `!models` swaps AI models per role at runtime
+- **Restart** — `!restart` restarts the service on demand
+
 ## How it works
 
 DiscoClaw orchestrates the flow between Discord and AI runtimes (Claude Code by default, with `gemini-api`, OpenAI, Codex, and OpenRouter adapters available via `PRIMARY_RUNTIME`). For 1.0, `Claude CLI` on a source checkout is the explicitly supported default path, and `Codex CLI` on a source checkout is the explicitly supported secondary path. See [docs/audit/provider-auth-1.0-matrix.md](docs/audit/provider-auth-1.0-matrix.md) for the full consolidated matrix. The OpenAI-compatible and OpenRouter adapters can expose optional tool use when `OPENAI_COMPAT_TOOLS_ENABLED=1` is set, but OpenRouter support claims stop at the narrower audited boundary described below. It doesn't contain intelligence itself — it decides *when* to call the AI, *what context* to give it, and *what to do* with the output. When you send a message, the orchestrator:
@@ -406,15 +414,22 @@ Do not treat `codex --version`, `OPENAI_API_KEY` presence, `pnpm preflight*`, or
 
 ## Updating
 
-**Global install:**
+DiscoClaw can check for and apply updates from inside Discord — no SSH or terminal needed.
+
+| Command | Description |
+|---------|-------------|
+| `!update` | Check if a newer version is available on npm |
+| `!update apply` | Download the update, reinstall, and restart the service |
+| `!update audit` | Show npm-managed runtime audit details |
+| `!update help` | Show usage |
 
-If DiscoClaw is running, update from Discord:
+**Global install (from Discord):**
 
 ```
 !update apply
 ```
 
-Or from the command line:
+**Global install (from the command line):**
 
 ```bash
 npm update -g discoclaw

package/dist/discord/tool-aware-queue.js

@@ -72,7 +72,10 @@ export class ToolAwareQueue {
         switch (this.state) {
             case 'idle':
             case 'buffering_text':
-                // Discard buffered narration text.
+                // Flush buffered narration text before switching to tool_active.
+                if (this.buffer) {
+                    this.emit({ type: 'stream_text', text: this.buffer });
+                }
                 this.buffer = '';
                 this.state = 'tool_active';
                 this.emit({ type: 'show_activity', label });

package/dist/discord/tool-aware-queue.test.js

@@ -96,15 +96,16 @@ describe('ToolAwareQueue', () => {
         expect(actions[1]).toEqual({ type: 'stream_text', text: '!' });
         taq.dispose();
     });
-    it('text then tool: narration discarded, activity shown', () => {
+    it('text then tool: narration flushed as stream_text, then activity shown', () => {
         const { actions, emit } = collect();
         const taq = new ToolAwareQueue(emit, { flushDelayMs: 800, postToolDelayMs: 500 });
         taq.handleEvent({ type: 'text_delta', text: 'Let me read the file...' });
         taq.handleEvent({ type: 'tool_start', name: 'Read', input: { file_path: '/tmp/foo.ts' } });
-        // Narration was discarded, only show_activity emitted.
-        expect(actions).toHaveLength(1);
-        expect(actions[0]).toMatchObject({ type: 'show_activity' });
-        expect(actions[0].label).toContain('Reading');
+        // Narration flushed as stream_text, then show_activity emitted.
+        expect(actions).toHaveLength(2);
+        expect(actions[0]).toEqual({ type: 'stream_text', text: 'Let me read the file...' });
+        expect(actions[1]).toMatchObject({ type: 'show_activity' });
+        expect(actions[1].label).toContain('Reading');
         taq.dispose();
     });
     it('tool then text: activity during tool, text streams after', () => {
@@ -176,7 +177,7 @@ describe('ToolAwareQueue', () => {
         vi.advanceTimersByTime(5000);
         expect(actions).toHaveLength(0);
     });
-    it('post-tool delay prevents flashing narration between tools', () => {
+    it('inter-tool narration is flushed before second tool activity', () => {
         const { actions, emit } = collect();
         const taq = new ToolAwareQueue(emit, { flushDelayMs: 800, postToolDelayMs: 500 });
         taq.handleEvent({ type: 'tool_start', name: 'Read' });
@@ -186,8 +187,12 @@ describe('ToolAwareQueue', () => {
         // Before post-tool delay fires, second tool starts.
         vi.advanceTimersByTime(200);
         taq.handleEvent({ type: 'tool_start', name: 'Bash' });
-        // The narration text should not have been streamed.
-        expect(actions.filter((a) => a.type === 'stream_text')).toHaveLength(0);
+        // Inter-tool narration flushed as stream_text before second tool.
+        expect(actions.filter((a) => a.type === 'stream_text')).toHaveLength(1);
+        expect(actions.filter((a) => a.type === 'stream_text')[0]).toEqual({
+            type: 'stream_text',
+            text: 'Now let me run...',
+        });
         // Two show_activity actions.
         expect(actions.filter((a) => a.type === 'show_activity')).toHaveLength(2);
         taq.dispose();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discoclaw",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Personal AI orchestrator that turns Discord into a persistent workspace",
   "license": "MIT",
   "repository": {