causantic 0.2.0

package/dist/ingest/edge-creator.js

@@ -0,0 +1,186 @@
+/**
+ * Edge creation with type-based weights.
+ * Creates both forward and backward edges for graph traversal.
+ */
+import { createEdges, createOrBoostEdges } from '../storage/edge-store.js';
+/**
+ * Initial weight by reference type.
+ * Higher weights for stronger evidence of continuation.
+ */
+export const TYPE_WEIGHTS = {
+    'file-path': 1.0, // Strong: explicit file reference
+    'code-entity': 0.8, // Good: shared code identifiers
+    'explicit-backref': 0.9, // Strong: explicit "the error", "that function"
+    'error-fragment': 0.9, // Strong: discussing specific error
+    'tool-output': 0.8, // Good: referencing tool results
+    'adjacent': 0.5, // Weak: just consecutive, no clear link
+    'cross-session': 0.7, // Medium: session continuation
+    'brief': 0.9, // Strong: parent spawning sub-agent
+    'debrief': 0.9, // Strong: sub-agent returning to parent
+};
+/**
+ * Create edges from detected transitions.
+ * Creates both backward (for retrieval) and forward (for prediction) edges.
+ *
+ * @param transitions - Detected transitions between chunks
+ * @param chunkIds - Array of chunk IDs corresponding to transition indices
+ * @param options - Edge creation options
+ * @returns Edge creation result
+ */
+export async function createEdgesFromTransitions(transitions, chunkIds, options = {}) {
+    const { vectorClock, useBoostMode = false } = options;
+    const edges = [];
+    for (const t of transitions) {
+        const sourceId = chunkIds[t.sourceIndex];
+        const targetId = chunkIds[t.targetIndex];
+        const weight = TYPE_WEIGHTS[t.type] * t.confidence;
+        // Backward edge: from target (later) to source (earlier)
+        // Used for retrieval: "what context led to this?"
+        edges.push({
+            sourceChunkId: targetId,
+            targetChunkId: sourceId,
+            edgeType: 'backward',
+            referenceType: t.type,
+            initialWeight: weight,
+            vectorClock,
+        });
+        // Forward edge: from source (earlier) to target (later)
+        // Used for prediction: "what comes after this?"
+        edges.push({
+            sourceChunkId: sourceId,
+            targetChunkId: targetId,
+            edgeType: 'forward',
+            referenceType: t.type,
+            initialWeight: weight,
+            vectorClock,
+        });
+    }
+    if (edges.length > 0) {
+        if (useBoostMode) {
+            createOrBoostEdges(edges);
+        }
+        else {
+            createEdges(edges);
+        }
+    }
+    return {
+        backwardCount: transitions.length,
+        forwardCount: transitions.length,
+        totalCount: edges.length,
+    };
+}
+/**
+ * Create a single edge pair (backward + forward) between two chunks.
+ */
+export async function createEdgePair(sourceChunkId, targetChunkId, referenceType, confidence = 1.0, vectorClock) {
+    const weight = TYPE_WEIGHTS[referenceType] * confidence;
+    createEdges([
+        {
+            sourceChunkId: targetChunkId,
+            targetChunkId: sourceChunkId,
+            edgeType: 'backward',
+            referenceType,
+            initialWeight: weight,
+            vectorClock,
+        },
+        {
+            sourceChunkId,
+            targetChunkId,
+            edgeType: 'forward',
+            referenceType,
+            initialWeight: weight,
+            vectorClock,
+        },
+    ]);
+}
+/**
+ * Create cross-session edges between final chunks of old session
+ * and first chunk of new (continued) session.
+ */
+export async function createCrossSessionEdges(previousFinalChunkIds, newFirstChunkId, vectorClock) {
+    const edges = [];
+    const weight = TYPE_WEIGHTS['cross-session'];
+    for (const prevChunkId of previousFinalChunkIds) {
+        // Backward: new session's first chunk can recall prev session context
+        edges.push({
+            sourceChunkId: newFirstChunkId,
+            targetChunkId: prevChunkId,
+            edgeType: 'backward',
+            referenceType: 'cross-session',
+            initialWeight: weight,
+            vectorClock,
+        });
+        // Forward: prev session's final chunks predict continuation
+        edges.push({
+            sourceChunkId: prevChunkId,
+            targetChunkId: newFirstChunkId,
+            edgeType: 'forward',
+            referenceType: 'cross-session',
+            initialWeight: weight,
+            vectorClock,
+        });
+    }
+    if (edges.length > 0) {
+        createEdges(edges);
+    }
+    return edges.length;
+}
+/**
+ * Create brief edges: parent chunk → sub-agent's first chunk.
+ * These represent the point where a sub-agent is spawned.
+ */
+export async function createBriefEdges(parentChunkId, subAgentFirstChunkId, vectorClock, spawnDepth = 0) {
+    // Apply depth penalty: deeper nesting = weaker connection
+    const depthPenalty = Math.pow(0.9, spawnDepth);
+    const weight = TYPE_WEIGHTS['brief'] * depthPenalty;
+    createEdges([
+        {
+            sourceChunkId: subAgentFirstChunkId,
+            targetChunkId: parentChunkId,
+            edgeType: 'backward',
+            referenceType: 'brief',
+            initialWeight: weight,
+            vectorClock,
+        },
+        {
+            sourceChunkId: parentChunkId,
+            targetChunkId: subAgentFirstChunkId,
+            edgeType: 'forward',
+            referenceType: 'brief',
+            initialWeight: weight,
+            vectorClock,
+        },
+    ]);
+}
+/**
+ * Create debrief edges: sub-agent's final chunk → parent chunk.
+ * These represent the point where a sub-agent returns to the parent.
+ */
+export async function createDebriefEdges(subAgentFinalChunkIds, parentChunkId, vectorClock, spawnDepth = 0) {
+    // Apply depth penalty: deeper nesting = weaker connection
+    const depthPenalty = Math.pow(0.9, spawnDepth);
+    const weight = TYPE_WEIGHTS['debrief'] * depthPenalty;
+    const edges = [];
+    for (const agentChunkId of subAgentFinalChunkIds) {
+        edges.push({
+            sourceChunkId: parentChunkId,
+            targetChunkId: agentChunkId,
+            edgeType: 'backward',
+            referenceType: 'debrief',
+            initialWeight: weight,
+            vectorClock,
+        });
+        edges.push({
+            sourceChunkId: agentChunkId,
+            targetChunkId: parentChunkId,
+            edgeType: 'forward',
+            referenceType: 'debrief',
+            initialWeight: weight,
+            vectorClock,
+        });
+    }
+    if (edges.length > 0) {
+        createEdges(edges);
+    }
+}
+//# sourceMappingURL=edge-creator.js.map

package/dist/ingest/edge-creator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-creator.js","sourceRoot":"","sources":["../../src/ingest/edge-creator.ts"],"names":[],"mappings":"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"}

package/dist/ingest/edge-detector.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Topic continuity detection for edge creation.
+ * Determines whether consecutive chunks should be connected.
+ * Reuses lexical classifier from topic continuity experiments.
+ */
+import type { ReferenceType } from '../storage/types.js';
+import type { Chunk } from '../parser/types.js';
+/**
+ * Result of transition detection between two chunks.
+ */
+export interface TransitionResult {
+    /** Index of source chunk in array */
+    sourceIndex: number;
+    /** Index of target chunk in array */
+    targetIndex: number;
+    /** Type of reference detected */
+    type: ReferenceType;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Evidence for the detection */
+    evidence: string;
+}
+/**
+ * Detect transitions/edges between consecutive chunks.
+ * Returns transitions that should become edges (continuations).
+ * Skips transitions that appear to be topic shifts.
+ */
+export declare function detectTransitions(chunks: Chunk[], options?: DetectionOptions): TransitionResult[];
+export interface DetectionOptions {
+    /** Time gap threshold in ms. Default: 30 minutes. */
+    timeGapThresholdMs?: number;
+}
+/**
+ * Get time gap between two timestamps in milliseconds.
+ */
+export declare function getTimeGapMs(chunk1: Chunk, chunk2: Chunk): number;
+//# sourceMappingURL=edge-detector.d.ts.map

package/dist/ingest/edge-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-detector.d.ts","sourceRoot":"","sources":["../../src/ingest/edge-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,EAAE,CAqCpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA0ND;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,CAIjE"}

package/dist/ingest/edge-detector.js

@@ -0,0 +1,234 @@
+/**
+ * Topic continuity detection for edge creation.
+ * Determines whether consecutive chunks should be connected.
+ * Reuses lexical classifier from topic continuity experiments.
+ */
+import { hasTopicShiftMarker, computeKeywordOverlap, extractFilePaths, extractKeywords, } from '../core/lexical-features.js';
+/**
+ * Default threshold for time gap (30 minutes) that indicates new topic.
+ */
+const DEFAULT_TIME_GAP_THRESHOLD_MS = 30 * 60 * 1000;
+/**
+ * Detect transitions/edges between consecutive chunks.
+ * Returns transitions that should become edges (continuations).
+ * Skips transitions that appear to be topic shifts.
+ */
+export function detectTransitions(chunks, options = {}) {
+    const { timeGapThresholdMs = DEFAULT_TIME_GAP_THRESHOLD_MS } = options;
+    const results = [];
+    for (let i = 1; i < chunks.length; i++) {
+        const prev = chunks[i - 1];
+        const curr = chunks[i];
+        // Calculate time gap
+        const prevEndTime = new Date(prev.metadata.endTime).getTime();
+        const currStartTime = new Date(curr.metadata.startTime).getTime();
+        const timeGapMs = currStartTime - prevEndTime;
+        // Large time gap indicates new topic
+        if (timeGapMs > timeGapThresholdMs) {
+            continue;
+        }
+        // Check for explicit topic shift markers in user text
+        const userText = extractUserText(curr.text);
+        if (hasTopicShiftMarker(userText)) {
+            continue;
+        }
+        // Detect reference type and evidence
+        const detection = detectReferenceType(prev.text, curr.text, timeGapMs);
+        results.push({
+            sourceIndex: i - 1,
+            targetIndex: i,
+            type: detection.type,
+            confidence: detection.confidence,
+            evidence: detection.evidence,
+        });
+    }
+    return results;
+}
+/**
+ * Detect the type of reference between two chunk texts.
+ */
+function detectReferenceType(prevText, currText, timeGapMs) {
+    // Extract structured data for analysis
+    const prevPaths = extractFilePaths(prevText);
+    const currPaths = extractFilePaths(currText);
+    const prevKeywords = extractKeywords(prevText);
+    const currKeywords = extractKeywords(currText);
+    // Check for file path references
+    const pathOverlap = computePathOverlap(prevPaths, currPaths);
+    if (pathOverlap > 0) {
+        const sharedPaths = [...currPaths].filter((p) => prevPaths.has(p));
+        return {
+            type: 'file-path',
+            confidence: Math.min(0.9, 0.7 + pathOverlap * 0.2),
+            evidence: `Shared paths: ${sharedPaths.slice(0, 3).join(', ')}`,
+        };
+    }
+    // Check for code entity references (function names, variables)
+    const codeEntities = detectCodeEntities(prevText, currText);
+    if (codeEntities.length > 0) {
+        return {
+            type: 'code-entity',
+            confidence: 0.8,
+            evidence: `Code entities: ${codeEntities.slice(0, 3).join(', ')}`,
+        };
+    }
+    // Check for error fragment references
+    const errorMatch = detectErrorReference(prevText, currText);
+    if (errorMatch) {
+        return {
+            type: 'error-fragment',
+            confidence: 0.9,
+            evidence: `Error: ${errorMatch.slice(0, 50)}`,
+        };
+    }
+    // Check for explicit backreferences
+    if (hasExplicitBackreference(currText)) {
+        return {
+            type: 'explicit-backref',
+            confidence: 0.85,
+            evidence: 'Explicit backreference detected',
+        };
+    }
+    // Check for tool output references
+    const toolRef = detectToolOutputReference(prevText, currText);
+    if (toolRef) {
+        return {
+            type: 'tool-output',
+            confidence: 0.8,
+            evidence: `Tool: ${toolRef}`,
+        };
+    }
+    // Default: adjacent with keyword overlap
+    const keywordOverlap = computeKeywordOverlap(prevText, currText);
+    const baseConfidence = timeGapMs < 5 * 60 * 1000 ? 0.6 : 0.4;
+    return {
+        type: 'adjacent',
+        confidence: Math.min(0.7, baseConfidence + keywordOverlap * 0.2),
+        evidence: `Adjacent, keyword overlap: ${(keywordOverlap * 100).toFixed(0)}%`,
+    };
+}
+/**
+ * Compute overlap between two path sets.
+ */
+function computePathOverlap(a, b) {
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const item of b) {
+        if (a.has(item))
+            intersection++;
+    }
+    return intersection / Math.min(a.size, b.size);
+}
+/**
+ * Detect shared code entities (function names, class names, etc.).
+ */
+function detectCodeEntities(prevText, currText) {
+    // Pattern for camelCase or PascalCase identifiers
+    const identifierPattern = /\b([a-z][a-zA-Z0-9]+|[A-Z][a-zA-Z0-9]+)\b/g;
+    const prevIds = new Set();
+    let match;
+    while ((match = identifierPattern.exec(prevText)) !== null) {
+        const id = match[1];
+        if (id.length >= 4 && !isCommonWord(id)) {
+            prevIds.add(id.toLowerCase());
+        }
+    }
+    const shared = [];
+    const currPattern = new RegExp(identifierPattern.source, 'g');
+    while ((match = currPattern.exec(currText)) !== null) {
+        const id = match[1];
+        if (prevIds.has(id.toLowerCase()) && !shared.includes(id)) {
+            shared.push(id);
+        }
+    }
+    return shared;
+}
+/**
+ * Check if an identifier is a common programming word.
+ */
+function isCommonWord(word) {
+    const common = new Set([
+        'function', 'const', 'let', 'var', 'return', 'import', 'export',
+        'async', 'await', 'class', 'interface', 'type', 'string', 'number',
+        'boolean', 'null', 'undefined', 'true', 'false', 'error', 'result',
+        'value', 'data', 'item', 'index', 'length', 'name', 'path', 'file',
+    ]);
+    return common.has(word.toLowerCase());
+}
+/**
+ * Detect error message reference between texts.
+ */
+function detectErrorReference(prevText, currText) {
+    // Look for error patterns in previous text
+    const errorPatterns = [
+        /Error:\s*(.+?)(?:\n|$)/gi,
+        /error\[.+?\]:\s*(.+?)(?:\n|$)/gi,
+        /TypeError:\s*(.+?)(?:\n|$)/gi,
+        /ReferenceError:\s*(.+?)(?:\n|$)/gi,
+        /SyntaxError:\s*(.+?)(?:\n|$)/gi,
+    ];
+    for (const pattern of errorPatterns) {
+        const prevMatches = [...prevText.matchAll(pattern)];
+        for (const match of prevMatches) {
+            const errorFragment = match[1].trim().slice(0, 30);
+            if (errorFragment.length > 5 && currText.includes(errorFragment)) {
+                return match[0].trim();
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Check for explicit backreference phrases.
+ */
+function hasExplicitBackreference(text) {
+    const patterns = [
+        /\b(the|that|this)\s+(error|issue|problem|bug|fix|solution|code|file|function)\b/i,
+        /\b(as|like)\s+(you|we)\s+(mentioned|discussed|said|showed)\b/i,
+        /\b(from|in)\s+(the|your)\s+(previous|last|earlier)\b/i,
+        /\b(still|again|same)\s+(error|issue|problem)\b/i,
+    ];
+    return patterns.some((p) => p.test(text));
+}
+/**
+ * Detect tool output reference (referencing specific tool results).
+ */
+function detectToolOutputReference(prevText, currText) {
+    // Look for tool result markers in previous text
+    const toolResultPattern = /\[Result:(\w+)\]/g;
+    const tools = new Set();
+    let match;
+    while ((match = toolResultPattern.exec(prevText)) !== null) {
+        tools.add(match[1]);
+    }
+    if (tools.size === 0)
+        return null;
+    // Check if current text references tool output
+    for (const tool of tools) {
+        const toolPatterns = [
+            new RegExp(`\\b(the|that|this)\\s+${tool}\\s*(output|result)`, 'i'),
+            new RegExp(`\\b(from|in)\\s+(the\\s+)?${tool}`, 'i'),
+        ];
+        if (toolPatterns.some((p) => p.test(currText))) {
+            return tool;
+        }
+    }
+    return null;
+}
+/**
+ * Extract user text from a chunk's rendered text.
+ */
+function extractUserText(chunkText) {
+    const match = chunkText.match(/\[User\]\n([\s\S]*?)(?=\n\n\[|$)/);
+    return match ? match[1] : '';
+}
+/**
+ * Get time gap between two timestamps in milliseconds.
+ */
+export function getTimeGapMs(chunk1, chunk2) {
+    const end1 = new Date(chunk1.metadata.endTime).getTime();
+    const start2 = new Date(chunk2.metadata.startTime).getTime();
+    return start2 - end1;
+}
+//# sourceMappingURL=edge-detector.js.map

package/dist/ingest/edge-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-detector.js","sourceRoot":"","sources":["../../src/ingest/edge-detector.ts"],"names":[],"mappings":"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"}

package/dist/ingest/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Session ingestion pipeline exports.
+ */
+export { ingestSession, chunkToInput } from './ingest-session.js';
+export type { IngestOptions, IngestResult } from './ingest-session.js';
+export { batchIngest, batchIngestDirectory, discoverSessions, filterAlreadyIngested, } from './batch-ingest.js';
+export type { BatchIngestOptions, BatchIngestResult } from './batch-ingest.js';
+export { detectTransitions, getTimeGapMs } from './edge-detector.js';
+export type { TransitionResult, DetectionOptions } from './edge-detector.js';
+export { createEdgesFromTransitions, createEdgePair, createCrossSessionEdges, TYPE_WEIGHTS, } from './edge-creator.js';
+export type { EdgeCreationResult } from './edge-creator.js';
+export { linkCrossSession, linkAllSessions, isContinuedSession, } from './cross-session-linker.js';
+export type { CrossSessionLinkResult } from './cross-session-linker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ingest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ingest/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EACL,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/ingest/index.js

@@ -0,0 +1,14 @@
+/**
+ * Session ingestion pipeline exports.
+ */
+// Main ingestion
+export { ingestSession, chunkToInput } from './ingest-session.js';
+// Batch ingestion
+export { batchIngest, batchIngestDirectory, discoverSessions, filterAlreadyIngested, } from './batch-ingest.js';
+// Edge detection
+export { detectTransitions, getTimeGapMs } from './edge-detector.js';
+// Edge creation
+export { createEdgesFromTransitions, createEdgePair, createCrossSessionEdges, TYPE_WEIGHTS, } from './edge-creator.js';
+// Cross-session linking
+export { linkCrossSession, linkAllSessions, isContinuedSession, } from './cross-session-linker.js';
+//# sourceMappingURL=index.js.map

package/dist/ingest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ingest/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGlE,kBAAkB;AAClB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,iBAAiB;AACjB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGrE,gBAAgB;AAChB,OAAO,EACL,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,wBAAwB;AACxB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,2BAA2B,CAAC"}

package/dist/ingest/ingest-session.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Session ingestion orchestrator.
+ * Parses, chunks, embeds, and stores a single session.
+ * Supports sub-agent discovery, vector clock tracking, and performance optimizations:
+ * - True batch embedding for faster inference
+ * - Content-hash caching to skip unchanged content
+ * - Incremental ingestion via checkpoints
+ * - File mtime checks to skip unchanged files
+ * - Streaming for large files
+ */
+import { type ChunkWithClock } from '../parser/chunker.js';
+import { Embedder } from '../models/embedder.js';
+import type { ChunkInput } from '../storage/types.js';
+import type { Chunk } from '../parser/types.js';
+/**
+ * Options for session ingestion.
+ */
+export interface IngestOptions {
+    /** Maximum tokens per chunk. Default: 4096. */
+    maxTokensPerChunk?: number;
+    /** Include thinking blocks. Default: true. */
+    includeThinking?: boolean;
+    /** Embedding model ID. Default: 'jina-small'. */
+    embeddingModel?: string;
+    /** Skip if already ingested. Default: true. */
+    skipIfExists?: boolean;
+    /** Create cross-session edges. Default: true. */
+    linkCrossSessions?: boolean;
+    /** Shared embedder instance (for batch processing). */
+    embedder?: Embedder;
+    /** Process sub-agents. Default: true. */
+    processSubAgents?: boolean;
+    /** Use vector clocks. Default: true. */
+    useVectorClocks?: boolean;
+    /** Use incremental ingestion (resume from checkpoints). Default: true. */
+    useIncrementalIngestion?: boolean;
+    /** Use embedding cache. Default: true. */
+    useEmbeddingCache?: boolean;
+    /** Override embedding device ('auto' | 'coreml' | 'cuda' | 'cpu' | 'wasm'). */
+    embeddingDevice?: string;
+}
+/**
+ * Result of session ingestion.
+ */
+export interface IngestResult {
+    /** Session ID */
+    sessionId: string;
+    /** Session slug */
+    sessionSlug: string;
+    /** Number of chunks created */
+    chunkCount: number;
+    /** Number of edges created */
+    edgeCount: number;
+    /** Number of cross-session edges created */
+    crossSessionEdges: number;
+    /** Number of brief/debrief edges created */
+    subAgentEdges: number;
+    /** Whether session was skipped (already existed) */
+    skipped: boolean;
+    /** Time taken in milliseconds */
+    durationMs: number;
+    /** Number of sub-agents processed */
+    subAgentCount: number;
+    /** Number of embedding cache hits */
+    cacheHits?: number;
+    /** Number of embedding cache misses */
+    cacheMisses?: number;
+    /** Reason for skip if skipped */
+    skipReason?: 'already_ingested' | 'unchanged_file' | 'no_new_turns';
+}
+/**
+ * Ingest a single session file.
+ */
+export declare function ingestSession(sessionPath: string, options?: IngestOptions): Promise<IngestResult>;
+/**
+ * Convert parser Chunk to storage ChunkInput.
+ */
+export declare function chunkToInput(chunk: Chunk): ChunkInput;
+/**
+ * Convert parser ChunkWithClock to storage ChunkInput.
+ */
+export declare function chunkWithClockToInput(chunk: ChunkWithClock): ChunkInput;
+//# sourceMappingURL=ingest-session.d.ts.map

package/dist/ingest/ingest-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-session.d.ts","sourceRoot":"","sources":["../../src/ingest/ingest-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAoCjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,oBAAoB,CAAC;AAKtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,0EAA0E;IAC1E,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,UAAU,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,cAAc,CAAC;CACrE;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA4XvB;AA6ED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAarD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAiBvE"}