osborn 0.8.0 → 0.8.2

package/dist/fast-brain.js

@@ -5,7 +5,7 @@
  * The realtime voice model is a thin teleprompter — it speaks what this module returns.
  *
  * Capabilities:
- * - Read/write session files (spec.md + library/)
+ * - Read/write session files (spec.md)
  * - Web search for quick factual lookups
  * - Record user decisions and preferences into spec.md
  * - Trigger deep research (via callbacks to index.ts)
@@ -24,10 +24,10 @@
 import Anthropic from '@anthropic-ai/sdk';
 import { query as sdkQuery, tool as sdkTool, createSdkMcpServer } from '@anthropic-ai/claude-agent-sdk';
 import { GoogleGenAI } from '@google/genai';
-import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { dirname, basename } from 'path';
 import { z } from 'zod';
-import { getSessionWorkspace, readSessionSpec, listLibraryFiles } from './config.js';
+import { getSessionWorkspace, readSessionSpec } from './config.js';
 import { FAST_BRAIN_SYSTEM_PROMPT, CHUNK_PROCESS_SYSTEM, REFINEMENT_PROCESS_SYSTEM, AUGMENT_RESULT_SYSTEM, CONTEXTUALIZE_UPDATE_SYSTEM, PROACTIVE_PROMPT_SYSTEM, VISUAL_DOCUMENT_SYSTEM, RESEARCH_COMPLETION_SYSTEM, buildFastBrainSdkPrompt } from './prompts.js';
 import { getRecentToolResults, readSessionHistory, getSubagentTranscripts, getConversationText, getSessionTranscripts, searchSessionJsonl, getSessionStats } from './session-access.js';
 // ============================================================
@@ -164,18 +164,6 @@ function executeTool(toolName, toolInput, workspace, sessionId, workingDir, send
                 console.log(`📝 Fast brain wrote ${relPath} (${content.length} chars)`);
                 return `Written: ${relPath} (${content.length} chars)`;
             }
-            case 'list_library': {
-                const libraryDir = `${workspace}/library`;
-                if (!existsSync(libraryDir))
-                    return 'Library is empty — no research files yet.';
-                try {
-                    const items = readdirSync(libraryDir);
-                    return items.length > 0 ? items.join('\n') : 'Library is empty — no research files yet.';
-                }
-                catch {
-                    return 'Library is empty — no research files yet.';
-                }
-            }
             case 'read_agent_results': {
                 if (!sessionId || !workingDir)
                     return 'Error: no active research session';
@@ -328,7 +316,7 @@ function buildAnthropicTools() {
     return [
         {
             name: 'read_file',
-            description: 'Read a file from the session workspace. Use relative paths like "spec.md" or "library/react-guide.md".',
+            description: 'Read a file from the session workspace. Use "spec.md" to read the session spec.',
             input_schema: {
                 type: 'object',
                 properties: {
@@ -349,11 +337,6 @@ function buildAnthropicTools() {
                 required: ['path', 'content']
             }
         },
-        {
-            name: 'list_library',
-            description: 'List all files in the research library directory.',
-            input_schema: { type: 'object', properties: {} }
-        },
         {
             name: 'read_agent_results',
             description: 'Read the research agent\'s FULL memory — complete untruncated tool outputs including entire file contents the agent read, full bash command outputs, web search results, and web page fetches. This is the agent\'s raw data. Use this FIRST when asked about anything the agent just researched. Default: last 40 results.',
@@ -460,7 +443,7 @@ function buildGeminiTools() {
             functionDeclarations: [
                 {
                     name: 'read_file',
-                    description: 'Read a file from the session workspace. Use relative paths like "spec.md" or "library/react-guide.md".',
+                    description: 'Read a file from the session workspace. Use "spec.md" to read the session spec.',
                     parameters: {
                         type: 'object',
                         properties: {
@@ -481,11 +464,6 @@ function buildGeminiTools() {
                         required: ['path', 'content']
                     }
                 },
-                {
-                    name: 'list_library',
-                    description: 'List all files in the research library directory.',
-                    parameters: { type: 'object', properties: {} }
-                },
                 {
                     name: 'web_search',
                     description: 'Search the web for current information. Use for factual questions like "current version of X", "what is X", definitions, etc.',
@@ -886,7 +864,7 @@ async function askViaGemini(question, workspace, researchContext, sessionId, wor
  */
 export async function askHaiku(workingDir, sessionId, question, researchContext, chatHistory, sendToChat, sessionBaseDir) {
     initProvider();
-    // workspace uses sessionBaseDir (Osborn install dir) for spec.md/library
+    // workspace uses workingDir for spec.md (under ~/.claude/projects/{slug}/osb/)
     // workingDir is for JSONL access (matches Claude SDK cwd)
     const wsDir = sessionBaseDir || workingDir;
     const workspace = getSessionWorkspace(wsDir, sessionId);
@@ -917,7 +895,7 @@ export async function askFastBrain(workingDir, sessionId, question, opts) {
         try {
             const result = await generateVisualDocument(workingDir, sessionId, question, docMatch, wsDir);
             if (result) {
-                const fullPath = `${wsDir}/.osborn/sessions/${sessionId}/library/${result.fileName}`;
+                const fullPath = `${getSessionWorkspace(wsDir, sessionId)}/${result.fileName}`;
                 callbacks.sendToFrontend({
                     type: 'research_artifact_updated',
                     filePath: fullPath,
@@ -1064,7 +1042,7 @@ function generateResearchAck(question, chatHistory) {
 // ============================================================
 /**
  * Process a batch of research content chunks through the fast brain.
- * Updates spec.md and library/ files incrementally during research.
+ * Updates spec.md incrementally during research.
  *
  * @param isRefinement - true for the final post-research consolidation pass (higher token budget)
  */
@@ -1089,30 +1067,8 @@ export async function processResearchChunk(workingDir, sessionId, task, contentC
             return null;
         }
         const currentSpec = readFileSync(specPath, 'utf-8');
-        const libraryDir = `${workspace}/library`;
-        // Only read library files during refinement pass (final consolidation)
-        // Mid-research: skip library entirely to stay fast and avoid file proliferation
-        let existingSection = '';
-        if (isRefinement) {
-            const existingFiles = listLibraryFiles(wsDir, sessionId);
-            const existingContents = [];
-            for (const file of existingFiles) {
-                const filePath = `${libraryDir}/${file}`;
-                if (existsSync(filePath)) {
-                    try {
-                        const content = readFileSync(filePath, 'utf-8');
-                        existingContents.push(`--- ${file} ---\n${content}`);
-                    }
-                    catch { /* skip */ }
-                }
-            }
-            existingSection = existingContents.length > 0
-                ? `\n\nExisting library/ files:\n${existingContents.join('\n\n')}`
-                : '';
-        }
         // No content capping — models handle 200K+ tokens (Haiku) / 1M+ (Gemini Flash)
         const chunksText = contentChunks.join('\n\n---\n\n');
-        // Use different prompts: mid-research = spec only, refinement = spec + library
         const systemPrompt = isRefinement ? REFINEMENT_PROCESS_SYSTEM : CHUNK_PROCESS_SYSTEM;
         const userMessage = `Research task: "${task}"
 
@@ -1120,7 +1076,6 @@ Current spec.md:
 \`\`\`markdown
 ${currentSpec}
 \`\`\`
-${existingSection}
 
 Content chunks from research:
 ${chunksText}
@@ -1151,7 +1106,6 @@ Return ONLY valid JSON — no code fences, no explanation.`;
         if (!parsed)
             return null;
         let updatedSpec = null;
-        const writtenFiles = [];
         // Write spec.md
         if (parsed.spec && typeof parsed.spec === 'string' && parsed.spec.length > 50) {
             writeFileSync(specPath, parsed.spec, 'utf-8');
@@ -1159,22 +1113,9 @@ Return ONLY valid JSON — no code fences, no explanation.`;
             const label = isRefinement ? 'refinement pass' : 'chunk';
             console.log(`📋 Fast brain processed research ${label} — spec.md updated (${parsed.spec.length} chars)`);
         }
-        // Write library files — ONLY during refinement pass (prevents file proliferation)
-        if (isRefinement && parsed.library && Array.isArray(parsed.library) && parsed.library.length > 0) {
-            mkdirSync(libraryDir, { recursive: true });
-            for (const file of parsed.library) {
-                if (!file.filename || !file.content)
-                    continue;
-                const safeName = file.filename.replace(/[^a-zA-Z0-9._-]/g, '-');
-                const filePath = `${libraryDir}/${safeName}`;
-                writeFileSync(filePath, file.content, 'utf-8');
-                console.log(`📝 Fast brain wrote library/${safeName} (${file.content.length} chars)`);
-                writtenFiles.push(safeName);
-            }
-        }
         const label = isRefinement ? 'refinement' : `${contentChunks.length} content items`;
         console.log(`📋 Fast brain processed research chunk (${label})`);
-        return { spec: updatedSpec, libraryFiles: writtenFiles };
+        return { spec: updatedSpec, libraryFiles: [] };
     }
     catch (err) {
         console.error('❌ processResearchChunk failed:', err);
@@ -1254,18 +1195,14 @@ export async function augmentResearchResult(workingDir, sessionId, task, agentRe
     try {
         // Read spec for context
         const specContent = readSessionSpec(workingDir, sessionId);
-        const libraryFiles = listLibraryFiles(workingDir, sessionId);
         const specSection = specContent
             ? `\n\nCurrent spec.md:\n${specContent}`
             : '';
-        const libSection = libraryFiles.length > 0
-            ? `\n\nLibrary files available: ${libraryFiles.join(', ')}`
-            : '';
         const userMessage = `Research task: "${task}"
 
 Agent findings:
 ${agentResult}
-${specSection}${libSection}
+${specSection}
 
 Augment the agent's findings with relevant context from the spec. Pass ALL details through verbatim.`;
         let responseText = null;
@@ -1303,7 +1240,7 @@ Augment the agent's findings with relevant context from the spec. Pass ALL detai
 // updateSpecFromJSONL — Post-research spec consolidation via JSONL
 // ============================================================
 /**
- * Update spec.md and library/ files after research completes.
+ * Update spec.md after research completes.
  * Reads FULL untruncated data directly from Claude Agent SDK JSONL files
  * instead of receiving pre-truncated content chunks.
  *
@@ -1312,7 +1249,7 @@ Augment the agent's findings with relevant context from the spec. Pass ALL detai
  * - readSessionHistory() — last 50 assistant messages (agent reasoning/analysis)
  * - getSubagentTranscripts() — all sub-agent findings
  *
- * Returns { spec, libraryFiles } or null if update failed.
+ * Returns { spec } or null if update failed.
  */
 export async function updateSpecFromJSONL(workingDir, sessionId, task, researchLog, sessionBaseDir) {
     initProvider();
@@ -1692,8 +1629,8 @@ ${previousPrompts.length > 0 ? previousPrompts.join('\n') : '(none yet)'}`;
  * 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.
+ * Reads spec.md and JSONL results for context.
+ * Writes the result to workspace and returns the filename + content.
  */
 export async function generateVisualDocument(workingDir, sessionId, request, documentType, sessionBaseDir) {
     initProvider();
@@ -1703,20 +1640,6 @@ export async function generateVisualDocument(workingDir, sessionId, request, doc
     try {
         const workspace = getSessionWorkspace(wsDir, sessionId);
         const specContent = readSessionSpec(wsDir, sessionId) || '';
-        const libraryFiles = listLibraryFiles(wsDir, sessionId);
-        // Read library contents for context
-        const libraryDir = `${workspace}/library`;
-        const libraryContents = [];
-        for (const file of libraryFiles.slice(0, 5)) {
-            const filePath = `${libraryDir}/${file}`;
-            if (existsSync(filePath)) {
-                try {
-                    const content = readFileSync(filePath, 'utf-8');
-                    libraryContents.push(`--- ${file} ---\n${content.substring(0, 3000)}`);
-                }
-                catch { /* skip */ }
-            }
-        }
         // Read recent JSONL results for raw data
         const toolResults = getRecentToolResults(sessionId, workingDir, 20);
         const toolResultsSummary = toolResults.map(tr => {
@@ -1729,8 +1652,6 @@ Document type: ${documentType}
 Session spec:
 ${specContent}
 
-${libraryContents.length > 0 ? `Library files:\n${libraryContents.join('\n\n')}` : ''}
-
 Recent research data:
 ${toolResultsSummary}
 
@@ -1780,11 +1701,10 @@ Return JSON: {"fileName": "descriptive-name.md", "content": "full markdown conte
         }
         if (!parsed.fileName || !parsed.content)
             return null;
-        // Write to library
+        // Write to workspace
         const safeName = parsed.fileName.replace(/[^a-zA-Z0-9._-]/g, '-');
-        const libraryPath = `${workspace}/library`;
-        mkdirSync(libraryPath, { recursive: true });
-        const filePath = `${libraryPath}/${safeName}`;
+        mkdirSync(workspace, { recursive: true });
+        const filePath = `${workspace}/${safeName}`;
         writeFileSync(filePath, parsed.content, 'utf-8');
         console.log(`📊 generateVisualDocument: wrote ${safeName} (${parsed.content.length} chars)`);
         return { fileName: safeName, content: parsed.content };

package/dist/index.js

@@ -13,7 +13,7 @@ import { createServer } from 'http';
 import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { createPatch } from 'diff';
-import { loadConfig, getMcpServers, getEnabledMcpServerNames, getVoiceMode, getRealtimeConfig, getDirectConfig, listSessions, getMostRecentSessionId, sessionExists, cleanupOrphanedMetadata, getSessionSummary, getConversationHistory, ensureSessionWorkspace, getMcpServerStatusList, buildMcpServersForKeys, listWorkspaceArtifacts } from './config.js';
+import { loadConfig, getMcpServers, getEnabledMcpServerNames, getVoiceMode, getRealtimeConfig, getDirectConfig, listAllClaudeSessions, getMostRecentSessionId, sessionExists, getSessionSummary, getConversationHistory, ensureSessionWorkspace, getSessionWorkspace, getMcpServerStatusList, buildMcpServersForKeys, listWorkspaceArtifacts } from './config.js';
 import { createSTT, createTTS, createRealtimeModelFromConfig, DIRECT_MODE_STT, DIRECT_MODE_TTS } from './voice-io.js';
 import { createClaudeLLM } from './claude-llm.js';
 import { clearPipelineFastBrainSession, prewarmBM25Index } from './pipeline-fastbrain.js';
@@ -150,14 +150,18 @@ function startApiServer(workingDir, port) {
         const url = new URL(req.url || '/', `http://localhost:${port}`);
         if (req.method === 'GET' && url.pathname === '/sessions') {
             try {
-                await cleanupOrphanedMetadata(workingDir);
-                const sessions = await listSessions(workingDir);
+                const limit = parseInt(url.searchParams.get('limit') || '100', 10);
+                const sessions = await listAllClaudeSessions(limit);
                 const payload = {
                     sessions: sessions.map(s => ({
                         sessionId: s.sessionId,
+                        projectSlug: s.projectSlug,
+                        projectPath: s.projectPath,
+                        cwd: s.cwd,
                         timestamp: s.timestamp.toISOString(),
                         lastMessage: s.lastMessage,
                         messageCount: s.messageCount,
+                        fileSize: s.fileSize,
                     })),
                     total: sessions.length,
                 };
@@ -215,6 +219,14 @@ function startApiServer(workingDir, port) {
             res.end(JSON.stringify({ roomCode: currentRoomCode }));
             return;
         }
+        // POST /restart — graceful process restart (process manager will restart)
+        if (req.method === 'POST' && url.pathname === '/restart') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ success: true, message: 'Agent restarting...' }));
+            console.log('🔄 Restart requested via HTTP — exiting for process manager restart');
+            setTimeout(() => process.exit(0), 150);
+            return;
+        }
         res.writeHead(404, { 'Content-Type': 'application/json' });
         res.end(JSON.stringify({ error: 'Not found' }));
     });
@@ -655,7 +667,7 @@ async function main() {
                 const voiceSid = currentLLM?.sessionId;
                 if (voiceSid) {
                     const chatHistory = getChatHistory(10);
-                    handleResearchBatch(workingDir, voiceSid, lastTaskRequest || '', updates, activeResearch.researchLog, chatHistory, sessionBaseDir)
+                    handleResearchBatch(workingDir, voiceSid, lastTaskRequest || '', updates, activeResearch.researchLog, chatHistory, workingDir)
                         .then(script => {
                         if (script && activeResearch) {
                             activeResearch.voiceUpdateCount++;
@@ -776,12 +788,12 @@ async function main() {
         sessionAlwaysAllowPaths = new Set();
         // For resumed sessions, eagerly create workspace (we know the real ID)
         if (resumeSessionId) {
-            const workspace = ensureSessionWorkspace(sessionBaseDir, resumeSessionId);
+            const workspace = ensureSessionWorkspace(workingDir, resumeSessionId);
             console.log(`📁 Session workspace (resumed): ${workspace}`);
         }
         // For new sessions, create workspace when SDK assigns real session ID
         directLLM.events.once('session_id', ({ sessionId }) => {
-            const workspace = ensureSessionWorkspace(sessionBaseDir, sessionId);
+            const workspace = ensureSessionWorkspace(workingDir, sessionId);
             console.log(`📁 Session workspace created: ${workspace}`);
             // Pipeline mode: pre-warm BM25 index so first fast brain query is fast
             if (currentVoiceMode === 'pipeline') {
@@ -812,7 +824,7 @@ async function main() {
             // Detect research artifact writes (session workspace or legacy research dir)
             if ((data.name === 'Write' || data.name === 'Edit') && data.input?.file_path) {
                 const fp = data.input.file_path;
-                if (fp.includes('.osborn/sessions/') || fp.includes('.osborn/research/')) {
+                if (fp.includes('/osb/') || fp.includes('.osborn/sessions/') || fp.includes('.osborn/research/')) {
                     sendToFrontend({
                         type: 'research_artifact_updated',
                         filePath: fp,
@@ -938,10 +950,13 @@ async function main() {
                 diff: diffString,
             });
             // Speak the descriptive request so user knows to respond
-            if (currentSession) {
-                const ttsMessage = `${description} Say yes, no, or always.`;
-                currentSession.say?.(ttsMessage);
-            }
+            //do not delete!! Leave this section commented out
+            // say permission, request permission, ask for permission with session.say
+            // if (currentSession) {
+            //   const ttsMessage = `${description} Say yes, no, or always.`
+            //   // ;(currentSession as any).say?.(ttsMessage).catch(() => {})
+            //   ;(currentSession as any).say?.(ttsMessage)
+            // }
         });
         // Wire up TTS say — bypass LiveKit's BufferedTokenStream, speak directly via session.say()
         // Each text block from Claude gets spoken immediately as it arrives, no internal buffering
@@ -1046,12 +1061,12 @@ async function main() {
         currentLLM = realtimeClaudeHandler;
         // For resumed sessions, eagerly create workspace (we know the real ID)
         if (resumeSessionId) {
-            const workspace = ensureSessionWorkspace(sessionBaseDir, resumeSessionId);
+            const workspace = ensureSessionWorkspace(workingDir, resumeSessionId);
             console.log(`📁 Session workspace (resumed): ${workspace}`);
         }
         // For new sessions, create workspace when SDK assigns real session ID
         realtimeClaudeHandler.events.once('session_id', ({ sessionId }) => {
-            const workspace = ensureSessionWorkspace(sessionBaseDir, sessionId);
+            const workspace = ensureSessionWorkspace(workingDir, sessionId);
             console.log(`📁 Session workspace created: ${workspace}`);
         });
         // Wire up MCP server changes to frontend
@@ -1074,7 +1089,7 @@ async function main() {
             // Detect research artifact writes (session workspace or legacy research dir)
             if ((data.name === 'Write' || data.name === 'Edit') && data.input?.file_path) {
                 const fp = data.input.file_path;
-                if (fp.includes('.osborn/sessions/') || fp.includes('.osborn/research/')) {
+                if (fp.includes('/osb/') || fp.includes('.osborn/sessions/') || fp.includes('.osborn/research/')) {
                     sendToFrontend({
                         type: 'research_artifact_updated',
                         filePath: fp,
@@ -1157,7 +1172,7 @@ async function main() {
             // Fire-and-forget: write user question to spec.md BEFORE agent starts
             const questionSid = currentLLM?.sessionId || resumeSessionId;
             if (questionSid) {
-                writeQuestionToSpec(sessionBaseDir, questionSid, task).catch(err => console.error('❌ writeQuestionToSpec failed:', err));
+                writeQuestionToSpec(workingDir, questionSid, task).catch(err => console.error('❌ writeQuestionToSpec failed:', err));
             }
             // Clean up previous research UI tracking — but let the SDK query complete in background.
             // The SDK has an internal queue: new query() calls enqueue behind running ones.
@@ -1229,7 +1244,7 @@ async function main() {
                 if (resultText.length > ANSWER_CHECK_THRESHOLD) {
                     const sid = currentLLM?.sessionId || resumeSessionId;
                     if (sid)
-                        checkOutputAgainstQuestions(sessionBaseDir, sid, resultText, 'tool_result').catch(() => { });
+                        checkOutputAgainstQuestions(workingDir, sid, resultText, 'tool_result').catch(() => { });
                 }
                 // When AskUserQuestion completes, the user's answer is a decision — track it in spec
                 if (data.name === 'AskUserQuestion' && data.response) {
@@ -1238,7 +1253,7 @@ async function main() {
                         const questionText = JSON.stringify(data.input?.questions || data.input || {});
                         const answerText = typeof data.response === 'string' ? data.response : JSON.stringify(data.response);
                         const specUpdate = `User answered a clarifying question during research.\nQuestion: ${questionText}\nAnswer: ${answerText}\nRecord this as a user decision in spec.md.`;
-                        askHaiku(workingDir, sid, specUpdate, undefined, undefined, undefined, sessionBaseDir).catch(err => console.error('❌ Failed to record AskUserQuestion answer in spec:', err));
+                        askHaiku(workingDir, sid, specUpdate, undefined, undefined, undefined, workingDir).catch(err => console.error('❌ Failed to record AskUserQuestion answer in spec:', err));
                         console.log(`📝 AskUserQuestion answer forwarded to fast brain for spec tracking`);
                     }
                 }
@@ -1255,7 +1270,7 @@ async function main() {
                     if (text.length > ANSWER_CHECK_THRESHOLD) {
                         const sid = currentLLM?.sessionId || resumeSessionId;
                         if (sid)
-                            checkOutputAgainstQuestions(sessionBaseDir, sid, text, 'assistant_text').catch(() => { });
+                            checkOutputAgainstQuestions(workingDir, sid, text, 'assistant_text').catch(() => { });
                     }
                 }
             };
@@ -1368,7 +1383,7 @@ async function main() {
                     sendToFrontend({ type: 'assistant_response', text });
                 };
                 if (voiceSid) {
-                    processResearchCompletion(workingDir, voiceSid, task, result, chatHistory, completionSendToChat, sessionBaseDir)
+                    processResearchCompletion(workingDir, voiceSid, task, result, chatHistory, completionSendToChat, workingDir)
                         .then(script => {
                         queueVoiceInjection(getScriptInjection(script));
                     })
@@ -1384,28 +1399,18 @@ async function main() {
                 // Reads FULL untruncated data from JSONL — no content buffer, no truncation
                 const postResearchSessionId = currentLLM?.sessionId || resumeSessionId;
                 if (postResearchSessionId) {
-                    updateSpecFromJSONL(workingDir, postResearchSessionId, task, researchLog, sessionBaseDir)
+                    updateSpecFromJSONL(workingDir, postResearchSessionId, task, researchLog, workingDir)
                         .then(updateResult => {
                         if (!updateResult)
                             return;
                         // Notify frontend about spec.md update
                         if (updateResult.spec) {
-                            const specPath = `${sessionBaseDir}/.osborn/sessions/${postResearchSessionId}/spec.md`;
+                            const specPath = join(getSessionWorkspace(workingDir, postResearchSessionId), 'spec.md');
                             sendToFrontend({
                                 type: 'research_artifact_updated',
                                 filePath: specPath,
                                 fileName: 'spec.md',
                             });
-                            // Voice model is a teleprompter — fast brain reads spec directly, no ChatCtx injection needed
-                        }
-                        // Notify frontend about each library file written by the fast brain
-                        for (const libFile of updateResult.libraryFiles) {
-                            const libPath = `${sessionBaseDir}/.osborn/sessions/${postResearchSessionId}/library/${libFile}`;
-                            sendToFrontend({
-                                type: 'research_artifact_updated',
-                                filePath: libPath,
-                                fileName: libFile,
-                            });
                         }
                     });
                 }
@@ -2091,16 +2096,20 @@ async function main() {
             console.log('💓 Sending agent_ready signal...');
             let readySent = false;
             const provider = sessionVoiceMode === 'realtime' ? realtimeConfig.provider : 'claude';
-            // Fetch full session list for startup session browser
-            const allSessions = await listSessions(workingDir);
+            // Fetch full session list for startup session browser (all Claude projects)
+            const allSessions = await listAllClaudeSessions(50);
             const recentSessionId = allSessions.length > 0 ? allSessions[0].sessionId : null;
             const hasRecentSession = allSessions.length > 0;
             // Prepare sessions for frontend (up to 50)
             const sessionsForFrontend = allSessions.slice(0, 50).map(s => ({
                 sessionId: s.sessionId,
+                projectSlug: s.projectSlug,
+                projectPath: s.projectPath,
+                cwd: s.cwd,
                 timestamp: s.timestamp.toISOString(),
                 lastMessage: s.lastMessage,
                 messageCount: s.messageCount,
+                fileSize: s.fileSize,
             }));
             const sendReady = async () => {
                 if (readySent)
@@ -2157,7 +2166,7 @@ async function main() {
                         success: true,
                     });
                     // Send existing workspace artifacts to frontend (session-scoped)
-                    const preArtifacts = listWorkspaceArtifacts(sessionBaseDir, preSelectedSessionId);
+                    const preArtifacts = listWorkspaceArtifacts(workingDir, preSelectedSessionId);
                     if (preArtifacts.length > 0) {
                         console.log(`📁 Sending ${preArtifacts.length} workspace artifacts to frontend`);
                         await sendToFrontend({
@@ -2177,7 +2186,7 @@ async function main() {
                         try {
                             if (sessionVoiceMode === 'realtime') {
                                 const historyForScript = conversationHistory.map(e => ({ role: e.role, text: e.content }));
-                                const script = await prepareBriefingScript(sessionBaseDir, preSelectedSessionId, historyForScript);
+                                const script = await prepareBriefingScript(workingDir, preSelectedSessionId, historyForScript);
                                 await session.generateReply({ instructions: getScriptInjection(script) });
                             }
                             else {
@@ -2274,30 +2283,51 @@ async function main() {
                 }
             }
             else if (data.type === 'user_text' && currentSession) {
-                console.log(`📝 Text: "${data.content}"`);
+                // Build message content — include attached files (URLs, text content)
+                let fullContent = String(data.content || '');
+                const files = data.files;
+                if (files && files.length > 0) {
+                    for (const f of files) {
+                        if (f.url) {
+                            fullContent += `\n\n[${f.type === 'image' ? 'Image' : 'File'}: ${f.name}](${f.url})`;
+                        }
+                        else if (f.type === 'text' && f.content) {
+                            fullContent += `\n\n[File: ${f.name}]\n${f.content}`;
+                        }
+                        else if (f.type === 'image' && f.content) {
+                            fullContent += `\n\n[Image attached: ${f.name}]`;
+                        }
+                    }
+                    console.log(`📝 Text + ${files.length} file(s): "${fullContent.substring(0, 100)}"`);
+                }
+                else {
+                    console.log(`📝 Text: "${fullContent.substring(0, 100)}"`);
+                }
                 // Skip interrupt for Gemini — disrupts state machine (hangs in speaking state)
                 if (currentProvider !== 'gemini') {
                     currentSession.interrupt();
                 }
-                await currentSession.generateReply({ userInput: data.content });
+                await currentSession.generateReply({ userInput: fullContent });
             }
             // ============================================================
             // SESSION MANAGEMENT HANDLERS
             // ============================================================
             else if (data.type === 'list_sessions') {
-                // List available sessions for this project
-                console.log('📋 Listing available sessions...');
+                // List available sessions across all Claude projects
+                console.log('📋 Listing available sessions (all projects)...');
                 try {
-                    // Clean up orphaned metadata entries before listing
-                    await cleanupOrphanedMetadata(workingDir);
-                    const sessions = await listSessions(workingDir);
+                    const sessions = await listAllClaudeSessions(100);
                     await sendToFrontend({
                         type: 'sessions_list',
                         sessions: sessions.map(s => ({
                             sessionId: s.sessionId,
+                            projectSlug: s.projectSlug,
+                            projectPath: s.projectPath,
+                            cwd: s.cwd,
                             timestamp: s.timestamp.toISOString(),
                             lastMessage: s.lastMessage,
                             messageCount: s.messageCount,
+                            fileSize: s.fileSize,
                         })),
                         count: sessions.length,
                     });
@@ -2327,7 +2357,7 @@ async function main() {
                         success: true,
                     });
                     // Send existing session artifacts to frontend (session-scoped)
-                    const artifacts = listWorkspaceArtifacts(sessionBaseDir, sessionId);
+                    const artifacts = listWorkspaceArtifacts(workingDir, sessionId);
                     if (artifacts.length > 0) {
                         console.log(`📁 Sending ${artifacts.length} session artifacts to frontend`);
                         await sendToFrontend({
@@ -2366,7 +2396,7 @@ async function main() {
                         success: true,
                     });
                     // Send existing session artifacts to frontend (session-scoped)
-                    const artifacts = listWorkspaceArtifacts(sessionBaseDir, recentId);
+                    const artifacts = listWorkspaceArtifacts(workingDir, recentId);
                     if (artifacts.length > 0) {
                         console.log(`📁 Sending ${artifacts.length} session artifacts to frontend`);
                         await sendToFrontend({
@@ -2386,7 +2416,7 @@ async function main() {
                         try {
                             if (currentVoiceMode === 'realtime') {
                                 const historyForScript = conversationHistory.map(e => ({ role: e.role, text: e.content }));
-                                const script = await prepareBriefingScript(sessionBaseDir, recentId, historyForScript);
+                                const script = await prepareBriefingScript(workingDir, recentId, historyForScript);
                                 await currentSession.generateReply({ instructions: getScriptInjection(script) });
                             }
                             else {
@@ -2431,7 +2461,7 @@ async function main() {
                         conversationHistory,
                     });
                     // Step 3.5: Send existing session artifacts to frontend (session-scoped)
-                    const switchArtifacts = listWorkspaceArtifacts(sessionBaseDir, sessionId);
+                    const switchArtifacts = listWorkspaceArtifacts(workingDir, sessionId);
                     if (switchArtifacts.length > 0) {
                         console.log(`📁 Sending ${switchArtifacts.length} session artifacts to frontend`);
                         await sendToFrontend({
@@ -2451,7 +2481,7 @@ async function main() {
                         try {
                             if (currentVoiceMode === 'realtime') {
                                 const historyForScript = conversationHistory.map(e => ({ role: e.role, text: e.content }));
-                                const briefingScript = await prepareBriefingScript(sessionBaseDir, sessionId, historyForScript, 'switch');
+                                const briefingScript = await prepareBriefingScript(workingDir, sessionId, historyForScript, 'switch');
                                 queueVoiceInjection(getScriptInjection(briefingScript));
                             }
                             else {
@@ -2486,7 +2516,7 @@ async function main() {
             else if (data.type === 'get_session_artifacts') {
                 const sessionId = data.sessionId;
                 if (sessionId) {
-                    const artifacts = listWorkspaceArtifacts(sessionBaseDir, sessionId);
+                    const artifacts = listWorkspaceArtifacts(workingDir, sessionId);
                     console.log(`📁 Sending ${artifacts.length} session artifacts for ${sessionId.substring(0, 8)}`);
                     await sendToFrontend({
                         type: 'session_artifacts',
@@ -2518,7 +2548,7 @@ async function main() {
             }
             else if (data.type === 'get_research_artifact') {
                 const filePath = data.filePath;
-                if (filePath && (filePath.includes('.osborn/sessions/') || filePath.includes('.osborn/research/'))) {
+                if (filePath && (filePath.includes('/osb/') || filePath.includes('.osborn/sessions/') || filePath.includes('.osborn/research/'))) {
                     try {
                         const fs = await import('fs');
                         const fileName = filePath.split('/').pop() || '';
@@ -2705,7 +2735,7 @@ async function main() {
                         success: true,
                     });
                     // Send existing session artifacts to frontend (session-scoped)
-                    const gateArtifacts = listWorkspaceArtifacts(sessionBaseDir, sessionId);
+                    const gateArtifacts = listWorkspaceArtifacts(workingDir, sessionId);
                     if (gateArtifacts.length > 0) {
                         console.log(`📁 Sending ${gateArtifacts.length} session artifacts to frontend`);
                         await sendToFrontend({
@@ -2725,7 +2755,7 @@ async function main() {
                         try {
                             if (currentVoiceMode === 'realtime') {
                                 const historyForScript = conversationHistory.map(e => ({ role: e.role, text: e.content }));
-                                const briefingScript = await prepareBriefingScript(sessionBaseDir, sessionId, historyForScript, 'resume');
+                                const briefingScript = await prepareBriefingScript(workingDir, sessionId, historyForScript, 'resume');
                                 queueVoiceInjection(getScriptInjection(briefingScript));
                             }
                             else {