osborn 0.5.2 → 0.5.3

package/dist/claude-llm.js

@@ -452,14 +452,25 @@ class ClaudeLLMStream extends llm.LLMStream {
                 // Research mode system prompt — always injected
                 systemPrompt: getResearchSystemPrompt(workspacePath),
                 canUseTool: async (toolName, input, _options) => {
-                    // Auto-approve writes to session workspace
+                    // Auto-approve writes to session workspace (but block spec.md and library/ — fast brain manages those)
                     if (toolName === 'Write' || toolName === 'Edit') {
                         const filePath = String(input?.file_path || '');
                         if (filePath.includes('.osborn/sessions/') || filePath.includes('.osborn/research/')) {
+                            // Block writes to spec.md and library/ — the fast brain manages these
+                            const fileName = filePath.split('/').pop() || '';
+                            if (fileName === 'spec.md' || filePath.includes('/library/')) {
+                                console.log(`🚫 Blocked research agent write to managed file: ${filePath} (fast brain handles spec.md and library/)`);
+                                return { behavior: 'deny', message: 'spec.md and library/ are managed by the fast brain sub-agent. Do NOT write to them. Return your findings in your response text — the fast brain will organize them into spec.md and library/ automatically.' };
+                            }
                             console.log(`✅ Auto-approved ${toolName} to workspace: ${filePath}`);
                             return { behavior: 'allow', updatedInput: input };
                         }
                     }
+                    // Auto-approve AskUserQuestion — research agent should freely ask clarifying questions
+                    if (toolName === 'AskUserQuestion') {
+                        console.log(`✅ Auto-approved ${toolName}`);
+                        return { behavior: 'allow', updatedInput: input };
+                    }
                     // Auto-deny tools the research agent should never use
                     if (toolName === 'EnterPlanMode' || toolName === 'ExitPlanMode') {
                         console.log(`🚫 Auto-denied ${toolName} (not used in research mode)`);

package/dist/config.d.ts

@@ -245,7 +245,7 @@ export declare function listLibraryFiles(projectPath: string, sessionId: string)
 export interface ResearchArtifact {
     fileName: string;
     filePath: string;
-    type: 'plan' | 'diagram' | 'notes' | 'image' | 'summary' | 'other';
+    type: 'plan' | 'diagram' | 'notes' | 'image' | 'summary' | 'html' | 'other';
     size: number;
     updatedAt: string;
 }

package/dist/config.js

@@ -842,6 +842,8 @@ function classifyFile(fileName) {
         return 'plan';
     if (ext === 'mmd' || ext === 'mermaid')
         return 'diagram';
+    if (ext === 'html' || ext === 'htm')
+        return 'html';
     if (ext === 'md')
         return 'notes';
     if (['png', 'jpg', 'jpeg', 'svg', 'gif', 'webp'].includes(ext))

package/dist/fast-brain.d.ts

@@ -26,6 +26,13 @@
  * Returns null for tools with no useful content (Write confirmations, etc.)
  */
 export declare function extractToolContent(toolName: string, toolInput: any, toolResponse: any): string | null;
+/** A single voice conversation turn from the realtime LLM's chatCtx */
+export interface ConversationTurn {
+    role: 'user' | 'assistant';
+    text: string;
+}
+/** No-op — history is now sourced live from agent.chatCtx, passed per-call */
+export declare function clearFastBrainHistory(): void;
 /**
  * Ask the fast brain a question with access to session files and web search.
  * Returns an answer or "NEEDS_DEEPER_RESEARCH: ..." for escalation.
@@ -35,7 +42,7 @@ export declare function extractToolContent(toolName: string, toolInput: any, too
  * @param researchContext - Optional snapshot of the live research log.
  * ~2 second response time for most queries.
  */
-export declare function askHaiku(workingDir: string, sessionId: string, question: string, researchContext?: string): Promise<string>;
+export declare function askHaiku(workingDir: string, sessionId: string, question: string, researchContext?: string, chatHistory?: ConversationTurn[]): Promise<string>;
 /**
  * Process a batch of research content chunks through the fast brain.
  * Updates spec.md and library/ files incrementally during research.
@@ -46,6 +53,14 @@ export declare function processResearchChunk(workingDir: string, sessionId: stri
     spec: string | null;
     libraryFiles: string[];
 } | null>;
+/**
+ * Augment agent SDK research results with context from spec.md.
+ * Passes ALL specific details through verbatim — only ADDS context annotations.
+ * The voice model downstream handles summarization for speech.
+ *
+ * Falls back to returning the original result if the fast brain is unavailable.
+ */
+export declare function augmentResearchResult(workingDir: string, sessionId: string, task: string, agentResult: string): Promise<string>;
 /**
  * Update spec.md and library/ files after research completes.
  * Reads FULL untruncated data directly from Claude Agent SDK JSONL files
@@ -62,3 +77,46 @@ export declare function updateSpecFromJSONL(workingDir: string, sessionId: strin
     spec: string | null;
     libraryFiles: string[];
 } | null>;
+/**
+ * Fire-and-forget: Write a user question to spec.md Open Questions > From User
+ * before the agent starts researching. Ensures every escalated question is tracked.
+ *
+ * Uses a simple LLM call to fuzzy-match existing questions and avoid duplicates.
+ * Skips if spec.md doesn't exist yet or no provider is available.
+ */
+export declare function writeQuestionToSpec(workingDir: string, sessionId: string, question: string): Promise<void>;
+/**
+ * Fire-and-forget: Check if substantial agent output answers any open questions in spec.md.
+ * Debounced (3s) to prevent flooding during rapid tool_result sequences.
+ *
+ * When a question is answered, marks it with [x] and moves the answer to Findings.
+ */
+export declare function checkOutputAgainstQuestions(workingDir: string, sessionId: string, output: string, outputType: 'tool_result' | 'assistant_text'): Promise<void>;
+/**
+ * Generate a natural, contextualized voice update from raw research events.
+ * Called by scheduleResearchBatch() instead of injecting raw events directly.
+ *
+ * Returns a natural 1-2 sentence update, or null if nothing interesting to say.
+ * 3-second timeout — returns null if the LLM is too slow.
+ */
+export declare function contextualizeResearchUpdate(workingDir: string, sessionId: string, task: string, batchEvents: string[], researchLog: string[]): Promise<string | null>;
+/**
+ * Generate a proactive conversational prompt to keep the user engaged during research.
+ * Called periodically (every 15s) during active research.
+ *
+ * Can ask open questions, discuss implications of findings, or give progress with depth.
+ * Returns null/NOTHING if nothing interesting to say.
+ * 3-second timeout.
+ */
+export declare function generateProactivePrompt(workingDir: string, sessionId: string, task: string, researchLog: string[], previousPrompts: string[]): Promise<string | null>;
+/**
+ * Generate a structured visual document (comparison table, Mermaid diagram,
+ * analysis, or summary) from research findings.
+ *
+ * Reads spec.md, JSONL results, and library for context.
+ * Writes the result to library/ and returns the filename + content.
+ */
+export declare function generateVisualDocument(workingDir: string, sessionId: string, request: string, documentType: 'comparison' | 'diagram' | 'analysis' | 'summary'): Promise<{
+    fileName: string;
+    content: string;
+} | null>;