osborn 0.9.145 → 0.9.147

package/dist/claude-llm.d.ts

@@ -210,6 +210,12 @@ export declare class ClaudeLLM extends llm.LLM {
     setActiveQuery(q: any): void;
     /** Remove an active query (called from ClaudeLLMStream when query completes) */
     removeActiveQuery(q: any): void;
+    /**
+     * Stop a single dispatch flow by agent_id.
+     * Returns true if the agent was found and stopped; false if not found.
+     * Does NOT affect other active queries (use abortQuery() to kill all).
+     */
+    stopAgent(agentId: string): boolean;
     /** Whether a persistent session is alive and consuming messages */
     hasSession(): boolean;
     /**

package/dist/claude-llm.js

@@ -12,6 +12,7 @@ import { EventEmitter } from 'events';
 import { saveSessionMetadata, getSessionWorkspace } from './config.js';
 import { statusManager } from './status-manager.js';
 import { getResearchSystemPrompt, getDirectModeResearchPrompt } from './prompts.js';
+import { getIndexPath } from './summary-index.js';
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -555,6 +556,9 @@ export class ClaudeLLM extends llm.LLM {
     // Active queries — multiple can be running (SDK queues them internally).
     // We keep ALL references so interrupt() can stop whatever is currently executing.
     #activeQueries = new Set();
+    // Per-agent-id query map — allows targeted stop of a single dispatch flow.
+    // Strictly additive; abortQuery/interruptQuery still iterate #activeQueries (kill-all).
+    #activeQueriesById = new Map();
     // Dedup guard — prevents double-firing reviewer/gate if SubagentStop fires
     // more than once for the same agent_id (e.g. retry edge cases).
     #dispatchedFor = new Set();
@@ -888,6 +892,7 @@ export class ClaudeLLM extends llm.LLM {
             catch { }
         }
         this.#activeQueries.clear();
+        this.#activeQueriesById.clear();
         console.log('🛑 All queries aborted (Ctrl+C equivalent)');
     }
     /**
@@ -942,6 +947,23 @@ export class ClaudeLLM extends llm.LLM {
     removeActiveQuery(q) {
         this.#activeQueries.delete(q);
     }
+    /**
+     * Stop a single dispatch flow by agent_id.
+     * Returns true if the agent was found and stopped; false if not found.
+     * Does NOT affect other active queries (use abortQuery() to kill all).
+     */
+    stopAgent(agentId) {
+        const q = this.#activeQueriesById.get(agentId);
+        if (!q)
+            return false;
+        try {
+            q.return?.();
+        }
+        catch { }
+        this.#activeQueriesById.delete(agentId);
+        this.#activeQueries.delete(q);
+        return true;
+    }
     // ============================================================
     // PERSISTENT SESSION — V1 query() with AsyncIterable<SDKUserMessage>
     // Single subprocess per voice session. First chat() does JSONL cold
@@ -1133,9 +1155,13 @@ export class ClaudeLLM extends llm.LLM {
             return;
         this.#dispatchedFor.add(agentId);
         try {
+            const idxPathReviewer = (this.#sessionId && this.#opts.workingDirectory)
+                ? getIndexPath(this.#sessionId, this.#opts.workingDirectory)
+                : null;
             const prompt = [
                 'Use the reviewer sub-agent to review this writer output for correctness/spec-adherence/obvious bugs.',
                 'End your reply with exactly `VERDICT: ACCEPT` or `VERDICT: REJECT`.',
+                ...(idxPathReviewer ? [`The session index is at ${idxPathReviewer} — you MUST read it before reviewing.`] : []),
                 '',
                 '<writer_output>',
                 writerOutput.slice(0, 8000),
@@ -1148,8 +1174,11 @@ export class ClaudeLLM extends llm.LLM {
             const reviewerOptions = {
                 cwd: this.#opts.workingDirectory,
                 permissionMode: 'default',
+                systemPrompt: NAMED_AGENTS.reviewer.prompt,
+                allowedTools: ['Read', 'Glob', 'Grep', 'Bash', 'Write', 'Edit'],
                 hooks: {
-                    PreToolUse: [{
+                    PreToolUse: [
+                        {
                             matcher: '.*',
                             hooks: [async (input) => {
                                     const toolName = input?.tool_name || 'unknown';
@@ -1157,7 +1186,26 @@ export class ClaudeLLM extends llm.LLM {
                                     emitter.emit('tool_use', { name: toolName, input: toolInput, agentRole: 'reviewer' });
                                     return {};
                                 }],
-                        }],
+                        },
+                        {
+                            matcher: '.*',
+                            hooks: [async (input) => {
+                                    const toolName = input?.tool_name || '';
+                                    const toolInput = input?.tool_input;
+                                    if ((toolName === 'Write' || toolName === 'Edit' || toolName === 'MultiEdit') &&
+                                        !/\.(md|markdown|mdx|txt|rst|adoc)$/i.test(String(toolInput?.file_path))) {
+                                        return {
+                                            hookSpecificOutput: {
+                                                hookEventName: 'PreToolUse',
+                                                permissionDecision: 'deny',
+                                            },
+                                            reason: 'reviewer may only write documentation files (.md/.markdown/.mdx/.txt/.rst/.adoc)',
+                                        };
+                                    }
+                                    return {};
+                                }],
+                        },
+                    ],
                     PostToolUse: [{
                             matcher: '.*',
                             hooks: [async (input) => {
@@ -1173,6 +1221,7 @@ export class ClaudeLLM extends llm.LLM {
             console.log(`[DISPATCH] spawning reviewer for agentId=${agentId.slice(0, 8)}`);
             const reviewerQuery = query({ prompt, options: reviewerOptions });
             this.#activeQueries.add(reviewerQuery);
+            this.#activeQueriesById.set(agentId, reviewerQuery);
             let reviewerText = '';
             try {
                 for await (const msg of reviewerQuery) {
@@ -1184,6 +1233,7 @@ export class ClaudeLLM extends llm.LLM {
             }
             finally {
                 this.#activeQueries.delete(reviewerQuery);
+                this.#activeQueriesById.delete(agentId);
             }
             const verdictMatch = reviewerText.match(/VERDICT:\s*(ACCEPT|REJECT)/i);
             const verdict = verdictMatch ? verdictMatch[1].toUpperCase() : null;
@@ -1211,10 +1261,14 @@ export class ClaudeLLM extends llm.LLM {
             return;
         this.#dispatchedFor.add(agentId);
         try {
+            const idxPathGate = (this.#sessionId && this.#opts.workingDirectory)
+                ? getIndexPath(this.#sessionId, this.#opts.workingDirectory)
+                : null;
             const prompt = [
                 'Use the reasoner sub-agent to vet this research output.',
                 'Determine whether the research is sufficient to answer the original question.',
                 'End your reply with exactly `GATE: PASS` or `GATE: NEEDS-MORE`.',
+                ...(idxPathGate ? [`The session index is at ${idxPathGate} — you MUST read it before reviewing.`] : []),
                 '',
                 '<research_output>',
                 researchOutput.slice(0, 8000),
@@ -1227,6 +1281,7 @@ export class ClaudeLLM extends llm.LLM {
             const gateOptions = {
                 cwd: this.#opts.workingDirectory,
                 permissionMode: 'default',
+                systemPrompt: NAMED_AGENTS.reasoner.prompt,
                 hooks: {
                     PreToolUse: [{
                             matcher: '.*',
@@ -1252,6 +1307,7 @@ export class ClaudeLLM extends llm.LLM {
             console.log(`[DISPATCH] spawning research-gate for agentId=${agentId.slice(0, 8)}`);
             const gateQuery = query({ prompt, options: gateOptions });
             this.#activeQueries.add(gateQuery);
+            this.#activeQueriesById.set(agentId, gateQuery);
             let review = '';
             try {
                 for await (const msg of gateQuery) {
@@ -1263,6 +1319,7 @@ export class ClaudeLLM extends llm.LLM {
             }
             finally {
                 this.#activeQueries.delete(gateQuery);
+                this.#activeQueriesById.delete(agentId);
             }
             const gateMatch = review.match(/GATE:\s*(PASS|NEEDS-MORE)/i);
             const gateVerdict = gateMatch ? gateMatch[1].toUpperCase() : null;
@@ -1749,6 +1806,7 @@ class ClaudeLLMStream extends llm.LLMStream {
                             matcher: '.*',
                             hooks: [async (input) => {
                                     console.log('[LIFECYCLE-PROBE] SubagentStart', JSON.stringify(input));
+                                    this.#eventEmitter.emit('agent_started', { agent_type: input?.agent_type, agent_id: input?.agent_id });
                                     return {};
                                 }]
                         }],
@@ -1760,6 +1818,7 @@ class ClaudeLLMStream extends llm.LLMStream {
                                     const msg = String(input?.last_assistant_message ?? '');
                                     const aid = input?.agent_id ?? ('sa-' + Date.now());
                                     statusManager.upsertDispatch(aid, { subagentType: at, dispatchState: 'completed', artifact: msg });
+                                    this.#eventEmitter.emit('task_completed', { agent_type: at, agent_id: aid, last_assistant_message: String(msg).slice(0, 400) });
                                     // Infinite-loop guard — never re-dispatch the reviewer or reasoner.
                                     if (at === 'reviewer' || at === 'reasoner')
                                         return {};

package/dist/index.js

@@ -3096,6 +3096,19 @@ async function main() {
                 review: data.review,
             });
         });
+        // Dispatcher v1 — sub-agent completed → frontend (Feature A)
+        directLLM.events.on('task_completed', (d) => sendToFrontend({
+            type: 'task_completed',
+            agent_type: d.agent_type,
+            agent_id: d.agent_id,
+            last_assistant_message: d.last_assistant_message,
+        }));
+        // Dispatcher v1 — sub-agent started → frontend stop-key signal (Feature A2)
+        directLLM.events.on('agent_started', (d) => sendToFrontend({
+            type: 'agent_started',
+            agent_type: d.agent_type,
+            agent_id: d.agent_id,
+        }));
         // Create the Agent with instructions, STT, LLM, TTS
         // VAD (Silero ONNX) removed — caused 2-5s inference lag on CPU, making interruption detection worse
         // Turn detection is server-side (Deepgram endpointing), interruptions handled by STT
@@ -5515,6 +5528,10 @@ async function main() {
                     }
                 }
             }
+            // Feature B — per-flow stop (does NOT affect other running flows)
+            else if (data.type === 'stop_dispatch' && currentLLM) {
+                currentLLM.stopAgent?.(String(data.agentId));
+            }
             else if (data.type === 'join_meeting') {
                 const meetingUrl = data.url;
                 if (meetingUrl) {

package/dist/pipeline-direct-llm.d.ts

@@ -67,6 +67,7 @@ export declare class PipelineDirectLLM extends llm.LLM {
     abortAgent(): void;
     rewindAgent(checkpointId?: string): Promise<boolean>;
     hasActiveAgent(): boolean;
+    stopAgent(agentId: string): boolean;
     /** Send a new prompt to Claude via direct chat() — event listeners stay attached */
     sendPrompt(prompt: string): void;
     enableMcpServer(k: string, c: any): void;

package/dist/pipeline-direct-llm.js

@@ -120,6 +120,7 @@ export class PipelineDirectLLM extends llm.LLM {
     abortAgent() { this.#claudeLLM.abortQuery(); }
     async rewindAgent(checkpointId) { return this.#claudeLLM.rewindToCheckpoint(checkpointId); }
     hasActiveAgent() { return this.#claudeLLM.hasActiveQuery(); }
+    stopAgent(agentId) { return this.#claudeLLM.stopAgent(agentId); }
     /** Send a new prompt to Claude via direct chat() — event listeners stay attached */
     sendPrompt(prompt) {
         console.log(`📋 [pipeline] Sending prompt to Claude (${prompt.length} chars)`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osborn",
-  "version": "0.9.145",
+  "version": "0.9.147",
   "description": "Voice AI coding assistant - local agent that connects to Osborn frontend",
   "type": "module",
   "bin": {