osborn 0.5.3 → 0.5.5

package/dist/session-access.d.ts

@@ -259,6 +259,30 @@ export interface SessionTranscripts {
  * @param opts.claudeDir - Override the claude directory path
  */
 export declare function getSessionPaths(sessionId: string, projectDir: string, opts?: SessionAccessOptions): SessionPaths;
+export interface SubAgentInfo {
+    agentId: string;
+    description: string;
+    status: string;
+    agentFile: string;
+    agentFileExists: boolean;
+    totalTokens: number;
+    totalToolUseCount: number;
+    durationMs: number;
+}
+/**
+ * Find all sub-agents spawned by a session.
+ * Extracts agentId from toolUseResult fields in the main JSONL,
+ * then checks for corresponding agent-{id}.jsonl files at the project level.
+ *
+ * Sub-agent files live at: ~/.claude/projects/{slug}/agent-{id}.jsonl
+ * (NOT inside the session subdirectory — that's only for the Osborn agent SDK path)
+ */
+export declare function getSessionSubAgents(sessionId: string, projectDir: string, opts?: SessionAccessOptions): SubAgentInfo[];
+/**
+ * Get all searchable file paths for a session — main JSONL + all sub-agent JSOLs.
+ * This is what the pipeline fast brain should ripgrep across.
+ */
+export declare function getSessionSearchPaths(sessionId: string, projectDir: string, opts?: SessionAccessOptions): string[];
 /**
  * Read raw JSON objects from a JSONL file — no parsing into SessionMessage.
  * Returns the actual JSON as-is so you can inspect the full object shapes.

package/dist/session-access.js

@@ -228,6 +228,80 @@ export function getSessionPaths(sessionId, projectDir, opts) {
         exists: existsSync(conversationPath),
     };
 }
+/**
+ * Find all sub-agents spawned by a session.
+ * Extracts agentId from toolUseResult fields in the main JSONL,
+ * then checks for corresponding agent-{id}.jsonl files at the project level.
+ *
+ * Sub-agent files live at: ~/.claude/projects/{slug}/agent-{id}.jsonl
+ * (NOT inside the session subdirectory — that's only for the Osborn agent SDK path)
+ */
+export function getSessionSubAgents(sessionId, projectDir, opts) {
+    const claudeDir = resolveClaudeDir(opts);
+    const slug = projectPathToSlug(projectDir);
+    const projectsDir = join(claudeDir, 'projects', slug);
+    const conversationPath = join(projectsDir, `${sessionId}.jsonl`);
+    if (!existsSync(conversationPath))
+        return [];
+    const agents = [];
+    const seenIds = new Set();
+    try {
+        const content = readFileSync(conversationPath, 'utf-8');
+        for (const line of content.split('\n')) {
+            if (!line.trim())
+                continue;
+            try {
+                const obj = JSON.parse(line);
+                const tur = obj.toolUseResult;
+                if (tur && typeof tur === 'object' && tur.agentId) {
+                    const id = tur.agentId;
+                    if (seenIds.has(id))
+                        continue;
+                    seenIds.add(id);
+                    const agentFile = join(projectsDir, `agent-${id}.jsonl`);
+                    agents.push({
+                        agentId: id,
+                        description: (tur.prompt || '').substring(0, 200),
+                        status: tur.status || '',
+                        agentFile,
+                        agentFileExists: existsSync(agentFile),
+                        totalTokens: tur.totalTokens || 0,
+                        totalToolUseCount: tur.totalToolUseCount || 0,
+                        durationMs: tur.totalDurationMs || 0,
+                    });
+                }
+            }
+            catch { }
+        }
+    }
+    catch { }
+    return agents;
+}
+/**
+ * Get all searchable file paths for a session — main JSONL + all sub-agent JSOLs.
+ * This is what the pipeline fast brain should ripgrep across.
+ */
+export function getSessionSearchPaths(sessionId, projectDir, opts) {
+    const paths = getSessionPaths(sessionId, projectDir, opts);
+    const files = [];
+    // Main conversation
+    if (existsSync(paths.conversation)) {
+        files.push(paths.conversation);
+    }
+    // Sub-agents from session subdirectory (Osborn agent SDK path)
+    for (const f of paths.subagents) {
+        if (existsSync(f))
+            files.push(f);
+    }
+    // Sub-agents at project level (Claude Code CLI path)
+    const agents = getSessionSubAgents(sessionId, projectDir, opts);
+    for (const a of agents) {
+        if (a.agentFileExists && !files.includes(a.agentFile)) {
+            files.push(a.agentFile);
+        }
+    }
+    return files;
+}
 // ============================================================
 // JSONL PARSING
 // ============================================================

package/dist/summary-index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * summary-index.ts — Builds a compact searchable summary of Claude JSONL sessions
+ *
+ * Instead of ripgrepping 80MB raw JSONL, we extract one-line summaries per message
+ * into a ~1MB plain text file. Ripgrep searches this in <5ms.
+ *
+ * Format: {lineNum}|{timestamp}|{source}|{msgType}|{summary}
+ *
+ * No LLM calls — pure heuristic extraction:
+ *   tool_use  → tool name + key params (file path, command, query)
+ *   tool_result → tool name + first 80 chars of output
+ *   user → raw text (already short from voice)
+ *   assistant → first 500 chars of text
+ *
+ * Per-session index stored at: .osborn/sessions/{sessionId}/.index/search-index.txt
+ */
+export interface IndexEntry {
+    lineNum: number;
+    byteOffset: number;
+    timestamp: string;
+    source: string;
+    msgType: string;
+    summary: string;
+}
+export interface SummaryIndexState {
+    indexPath: string;
+    metaPath: string;
+    main: {
+        jsonlPath: string;
+        byteOffset: number;
+        lineCount: number;
+        indexLineCount: number;
+    };
+    subAgents: Map<string, {
+        jsonlPath: string;
+        byteOffset: number;
+        lineCount: number;
+        indexLineCount: number;
+    }>;
+    toolUseIdMap: Map<string, string>;
+}
+export interface SummaryIndexMeta {
+    version: 1;
+    sessionId: string;
+    createdAt: string;
+    updatedAt: string;
+    main: {
+        jsonlPath: string;
+        byteOffset: number;
+        lineCount: number;
+        indexLineCount: number;
+    };
+    subAgents: Record<string, {
+        jsonlPath: string;
+        byteOffset: number;
+        lineCount: number;
+        indexLineCount: number;
+    }>;
+    toolUseIdMap: Record<string, string>;
+}
+export interface IndexWatcher {
+    stop(): void;
+    state: SummaryIndexState;
+}
+/**
+ * Build or resume a summary index for a session.
+ * Reads main JSONL + all sub-agent JSONLs, extracts summaries.
+ * If an existing index with metadata exists, resumes from last byte offset.
+ */
+export declare function buildSummaryIndex(sessionId: string, workingDir: string, sessionBaseDir: string, onProgress?: (msg: string) => void): SummaryIndexState;
+/**
+ * Poll-based incremental index updater (10s interval).
+ * Checks main JSONL + sub-agents for new content, indexes in one batch.
+ * No fs.watch — avoids race conditions with concurrent writers.
+ */
+export declare function startIndexWatcher(sessionId: string, workingDir: string, sessionBaseDir: string, state: SummaryIndexState): IndexWatcher;
+export declare function getIndexPath(sessionId: string, sessionBaseDir: string): string | null;
+/**
+ * Given index search results (with byte offsets + source tags),
+ * read FULL content from raw JSONL via targeted reads — 0.5ms per result.
+ * No readFileSync of the whole file. Strips JSON noise, returns clean text.
+ */
+export declare function readFullContent(results: {
+    lineNum: number;
+    byteOffset: number;
+    source: string;
+}[], sessionId: string, workingDir: string, sessionBaseDir: string, maxCharsPerResult?: number): string[];