@sunilp-org/jam-cli 0.1.0 → 0.1.1

package/dist/utils/index-builder.js

@@ -0,0 +1,241 @@
+/**
+ * Symbol index builder — lightweight file→symbol mapping for faster retrieval.
+ *
+ * Scans source files for exported symbols (functions, classes, interfaces,
+ * types, constants) and builds an index file at `.jam/symbol-index.json`.
+ *
+ * The index is used by the planner and enrichment stages to suggest specific
+ * files to the model based on symbol names, reducing wasted search rounds.
+ */
+import { readdir, readFile, writeFile, mkdir, stat } from 'node:fs/promises';
+import { join, extname, relative } from 'node:path';
+// ── File scanning ─────────────────────────────────────────────────────────────
+const IGNORED_DIRS = new Set([
+    'node_modules', 'dist', 'build', '.git', '.jam', 'coverage',
+    '__pycache__', '.next', '.nuxt', 'target', 'out', '.venv', 'venv',
+]);
+const CODE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs', '.java',
+]);
+/**
+ * Recursively collect all source files in a workspace.
+ */
+async function collectSourceFiles(dir, rootDir, files = [], maxFiles = 500) {
+    if (files.length >= maxFiles)
+        return files;
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return files;
+    }
+    for (const entry of entries) {
+        if (files.length >= maxFiles)
+            break;
+        const name = String(entry.name);
+        if (entry.isDirectory()) {
+            if (!IGNORED_DIRS.has(name) && !name.startsWith('.')) {
+                await collectSourceFiles(join(dir, name), rootDir, files, maxFiles);
+            }
+        }
+        else if (CODE_EXTENSIONS.has(extname(name))) {
+            files.push(join(dir, name));
+        }
+    }
+    return files;
+}
+// ── Symbol extraction (TypeScript / JavaScript) ───────────────────────────────
+/**
+ * Extract exported symbols from a TypeScript/JavaScript file using regex.
+ * This is intentionally simple — no AST parsing needed for an index.
+ */
+function extractTsSymbols(content, filePath) {
+    const symbols = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        // export function foo(
+        const funcMatch = line.match(/export\s+(?:async\s+)?function\s+(\w+)/);
+        if (funcMatch) {
+            symbols.push({ name: funcMatch[1], kind: 'function', file: filePath, line: lineNum });
+            continue;
+        }
+        // export class Foo
+        const classMatch = line.match(/export\s+(?:abstract\s+)?class\s+(\w+)/);
+        if (classMatch) {
+            symbols.push({ name: classMatch[1], kind: 'class', file: filePath, line: lineNum });
+            continue;
+        }
+        // export interface Foo
+        const ifaceMatch = line.match(/export\s+interface\s+(\w+)/);
+        if (ifaceMatch) {
+            symbols.push({ name: ifaceMatch[1], kind: 'interface', file: filePath, line: lineNum });
+            continue;
+        }
+        // export type Foo =
+        const typeMatch = line.match(/export\s+type\s+(\w+)/);
+        if (typeMatch) {
+            symbols.push({ name: typeMatch[1], kind: 'type', file: filePath, line: lineNum });
+            continue;
+        }
+        // export enum Foo
+        const enumMatch = line.match(/export\s+enum\s+(\w+)/);
+        if (enumMatch) {
+            symbols.push({ name: enumMatch[1], kind: 'enum', file: filePath, line: lineNum });
+            continue;
+        }
+        // export const FOO = / export const foo =
+        const constMatch = line.match(/export\s+const\s+(\w+)/);
+        if (constMatch) {
+            symbols.push({ name: constMatch[1], kind: 'const', file: filePath, line: lineNum });
+            continue;
+        }
+        // Non-exported but significant: class Foo
+        const plainClassMatch = line.match(/^(?:abstract\s+)?class\s+(\w+)/);
+        if (plainClassMatch && !line.includes('export')) {
+            symbols.push({ name: plainClassMatch[1], kind: 'class', file: filePath, line: lineNum });
+            continue;
+        }
+    }
+    return symbols;
+}
+/**
+ * Extract symbols from a Python file.
+ */
+function extractPySymbols(content, filePath) {
+    const symbols = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        // def foo( — top-level only (no leading whitespace)
+        const funcMatch = line.match(/^(?:async\s+)?def\s+(\w+)/);
+        if (funcMatch) {
+            symbols.push({ name: funcMatch[1], kind: 'function', file: filePath, line: lineNum });
+            continue;
+        }
+        // class Foo
+        const classMatch = line.match(/^class\s+(\w+)/);
+        if (classMatch) {
+            symbols.push({ name: classMatch[1], kind: 'class', file: filePath, line: lineNum });
+            continue;
+        }
+    }
+    return symbols;
+}
+// ── Index builder ─────────────────────────────────────────────────────────────
+const INDEX_DIR = '.jam';
+const INDEX_FILE = 'symbol-index.json';
+/**
+ * Build a symbol index for the workspace.
+ * Scans all source files and extracts exported symbols.
+ */
+export async function buildSymbolIndex(workspaceRoot) {
+    const files = await collectSourceFiles(workspaceRoot, workspaceRoot);
+    const allSymbols = [];
+    for (const absPath of files) {
+        let content;
+        try {
+            content = await readFile(absPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const relPath = relative(workspaceRoot, absPath);
+        const ext = extname(absPath);
+        let symbols;
+        if (['.ts', '.tsx', '.js', '.jsx'].includes(ext)) {
+            symbols = extractTsSymbols(content, relPath);
+        }
+        else if (ext === '.py') {
+            symbols = extractPySymbols(content, relPath);
+        }
+        else {
+            // Skip unsupported languages for now
+            continue;
+        }
+        allSymbols.push(...symbols);
+    }
+    const index = {
+        builtAt: new Date().toISOString(),
+        filesScanned: files.length,
+        totalSymbols: allSymbols.length,
+        symbols: allSymbols,
+    };
+    // Write index to disk
+    const indexDir = join(workspaceRoot, INDEX_DIR);
+    await mkdir(indexDir, { recursive: true });
+    await writeFile(join(indexDir, INDEX_FILE), JSON.stringify(index, null, 2), 'utf-8');
+    return index;
+}
+/**
+ * Load the cached symbol index from disk.
+ * Returns null if no index exists or it's too stale.
+ */
+export async function loadSymbolIndex(workspaceRoot, maxAge = 30 * 60 * 1000) {
+    const indexPath = join(workspaceRoot, INDEX_DIR, INDEX_FILE);
+    try {
+        const fileStat = await stat(indexPath);
+        const age = Date.now() - fileStat.mtimeMs;
+        if (age > maxAge)
+            return null; // Too stale
+        const raw = await readFile(indexPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load or build the symbol index (builds if missing/stale).
+ */
+export async function getOrBuildIndex(workspaceRoot) {
+    const cached = await loadSymbolIndex(workspaceRoot);
+    if (cached)
+        return cached;
+    return buildSymbolIndex(workspaceRoot);
+}
+/**
+ * Search the symbol index for symbols matching a query.
+ * Returns matching symbols sorted by relevance.
+ */
+export function searchSymbols(index, query, maxResults = 20) {
+    const lower = query.toLowerCase();
+    const terms = lower.split(/\s+/).filter(t => t.length > 1);
+    if (terms.length === 0)
+        return [];
+    // Score each symbol
+    const scored = index.symbols.map(sym => {
+        const nameLower = sym.name.toLowerCase();
+        let score = 0;
+        for (const term of terms) {
+            if (nameLower === term)
+                score += 10; // Exact match
+            else if (nameLower.includes(term))
+                score += 5; // Partial match
+            else if (sym.file.toLowerCase().includes(term))
+                score += 2; // File match
+        }
+        return { sym, score };
+    });
+    return scored
+        .filter(s => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, maxResults)
+        .map(s => s.sym);
+}
+/**
+ * Format symbol search results for injection into context.
+ */
+export function formatSymbolResults(symbols) {
+    if (symbols.length === 0)
+        return '';
+    const lines = ['**Relevant symbols found in the codebase:**', ''];
+    for (const sym of symbols) {
+        lines.push(`- \`${sym.name}\` (${sym.kind}) → \`${sym.file}:${sym.line}\``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=index-builder.js.map

package/dist/utils/index-builder.js.map

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

package/dist/utils/memory.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Working memory management for the agentic loop.
+ *
+ * Provides:
+ * - **Context compaction** — summarize old tool results when approaching the
+ *   context window limit.
+ * - **Scratchpad** — periodic "what have I learned" prompts that create a
+ *   running working memory the model can reference.
+ * - **Tool result capping** — truncate oversized tool outputs before injection.
+ *
+ * The core idea: instead of feeding the LLM an ever-growing message array,
+ * we periodically compress old rounds into a compact summary and carry only
+ * recent rounds + the summary forward.
+ */
+import type { Message } from '../providers/base.js';
+import type { ProviderAdapter } from '../providers/base.js';
+/** After this many tool rounds, inject a scratchpad prompt. */
+export declare const SCRATCHPAD_INTERVAL = 3;
+/** Max token budget for a single tool result injection. */
+export declare const MAX_TOOL_RESULT_TOKENS = 1500;
+/**
+ * Cap a tool output to prevent oversized injections into the message array.
+ * Call this BEFORE pushing the tool result into `messages`.
+ */
+export declare function capToolResult(toolName: string, output: string): string;
+/**
+ * Check if it's time to inject a scratchpad prompt.
+ * Returns true every SCRATCHPAD_INTERVAL tool rounds.
+ */
+export declare function shouldInjectScratchpad(toolRound: number): boolean;
+/**
+ * Build the scratchpad injection message.
+ */
+export declare function buildScratchpadPrompt(): Message;
+/**
+ * Check whether the message array needs compaction.
+ */
+export declare function needsCompaction(messages: Message[], systemPrompt: string | undefined, model?: string): boolean;
+/**
+ * Compact the message array by summarizing old tool rounds.
+ *
+ * Strategy:
+ * 1. Keep the first message (original user query) and the last N messages (recent context).
+ * 2. Summarize everything in between via a cheap LLM call.
+ * 3. Replace the middle messages with a single summary message.
+ *
+ * Falls back to a simple truncation if the LLM call fails.
+ */
+export declare function compactMessages(messages: Message[], provider: ProviderAdapter, options: {
+    model?: string;
+    keepRecent?: number;
+}): Promise<Message[]>;
+/**
+ * WorkingMemory manages the conversation's context budget throughout
+ * the agentic loop.  Commands use it like:
+ *
+ * ```ts
+ * const memory = new WorkingMemory(provider, model, systemPrompt);
+ * // In the tool loop:
+ * memory.addToolResult(toolName, output, messages);
+ * if (memory.shouldScratchpad(round)) messages.push(memory.scratchpadPrompt());
+ * if (memory.shouldCompact(messages)) messages = await memory.compact(messages);
+ * ```
+ */
+export declare class WorkingMemory {
+    private provider;
+    private model?;
+    private systemPrompt?;
+    private readFiles;
+    private searchQueries;
+    private factsLearned;
+    constructor(provider: ProviderAdapter, model?: string, systemPrompt?: string);
+    /**
+     * Process and cap a tool result before injection into messages.
+     * Also tracks which files/searches have been done.
+     */
+    processToolResult(toolName: string, args: Record<string, unknown>, output: string): string;
+    /**
+     * Check if we should inject a scratchpad prompt at this round.
+     */
+    shouldScratchpad(round: number): boolean;
+    /**
+     * Build the scratchpad prompt.
+     */
+    scratchpadPrompt(): Message;
+    /**
+     * Check if messages need compaction.
+     */
+    shouldCompact(messages: Message[]): boolean;
+    /**
+     * Compact the messages array.
+     */
+    compact(messages: Message[]): Promise<Message[]>;
+    /**
+     * Get a summary of what has been accessed (for diagnostics / JAM.md updates).
+     */
+    getAccessLog(): {
+        readFiles: string[];
+        searchQueries: string[];
+    };
+    /** Reset for a new turn (multi-turn chat). */
+    reset(): void;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/utils/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/utils/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQ5D,+DAA+D;AAC/D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAKrC,2DAA2D;AAC3D,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAO3C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAcD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAID;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EAAE,EACnB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAGT;AAgBD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,OAAO,EAAE,CAAC,CAuDpB;AAID;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,YAAY,CAAgB;gBAExB,QAAQ,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAM5E;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAa1F;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO;IAI3C;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAItD;;OAEG;IACH,YAAY,IAAI;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE;IAOhE,8CAA8C;IAC9C,KAAK,IAAI,IAAI;CAGd"}

package/dist/utils/memory.js

@@ -0,0 +1,215 @@
+/**
+ * Working memory management for the agentic loop.
+ *
+ * Provides:
+ * - **Context compaction** — summarize old tool results when approaching the
+ *   context window limit.
+ * - **Scratchpad** — periodic "what have I learned" prompts that create a
+ *   running working memory the model can reference.
+ * - **Tool result capping** — truncate oversized tool outputs before injection.
+ *
+ * The core idea: instead of feeding the LLM an ever-growing message array,
+ * we periodically compress old rounds into a compact summary and carry only
+ * recent rounds + the summary forward.
+ */
+import { checkBudget, truncateToolOutput, } from './tokens.js';
+// ── Configuration ─────────────────────────────────────────────────────────────
+/** After this many tool rounds, inject a scratchpad prompt. */
+export const SCRATCHPAD_INTERVAL = 3;
+/** When messages exceed this fraction of the context budget, compact. */
+const COMPACTION_THRESHOLD = 0.70;
+/** Max token budget for a single tool result injection. */
+export const MAX_TOOL_RESULT_TOKENS = 1500;
+/** Max token budget for compacted summary. */
+const _MAX_SUMMARY_TOKENS = 800;
+// ── Tool result capping (P0-2) ────────────────────────────────────────────────
+/**
+ * Cap a tool output to prevent oversized injections into the message array.
+ * Call this BEFORE pushing the tool result into `messages`.
+ */
+export function capToolResult(toolName, output) {
+    return truncateToolOutput(toolName, output, MAX_TOOL_RESULT_TOKENS);
+}
+// ── Scratchpad (P1-4) ────────────────────────────────────────────────────────
+const SCRATCHPAD_PROMPT = `[WORKING MEMORY CHECKPOINT]
+
+Pause and organize what you have learned so far.  Write a brief, structured note:
+
+1. **Files examined**: List every file path you have read or searched.
+2. **Key findings**: List the most important facts you found (function names, patterns, locations).
+3. **Still needed**: What information do you still need to answer the user's question?
+
+Keep this under 200 words.  This note will stay in your context as working memory.`;
+/**
+ * Check if it's time to inject a scratchpad prompt.
+ * Returns true every SCRATCHPAD_INTERVAL tool rounds.
+ */
+export function shouldInjectScratchpad(toolRound) {
+    return toolRound > 0 && toolRound % SCRATCHPAD_INTERVAL === 0;
+}
+/**
+ * Build the scratchpad injection message.
+ */
+export function buildScratchpadPrompt() {
+    return { role: 'user', content: SCRATCHPAD_PROMPT };
+}
+// ── Context compaction / summarization (P0-3) ─────────────────────────────────
+/**
+ * Check whether the message array needs compaction.
+ */
+export function needsCompaction(messages, systemPrompt, model) {
+    const { budget, currentTokens } = checkBudget(messages, systemPrompt, model);
+    return currentTokens > budget * COMPACTION_THRESHOLD;
+}
+const SUMMARIZER_SYSTEM_PROMPT = `You are a context summarizer for a code assistant. You will receive a conversation between a user and an assistant that includes tool calls and their results.
+
+Your job is to produce a COMPACT summary of all the information gathered so far. Include:
+1. Files that were examined (paths only)
+2. Key code facts discovered (function names, class names, patterns, important line numbers)
+3. Any errors or dead-ends encountered
+
+Rules:
+- Be extremely concise — bullet points only
+- Include file paths and line numbers where relevant
+- Do NOT include opinions or analysis — just facts
+- Do NOT include the full contents of files — just what was found
+- Stay under 300 words`;
+/**
+ * Compact the message array by summarizing old tool rounds.
+ *
+ * Strategy:
+ * 1. Keep the first message (original user query) and the last N messages (recent context).
+ * 2. Summarize everything in between via a cheap LLM call.
+ * 3. Replace the middle messages with a single summary message.
+ *
+ * Falls back to a simple truncation if the LLM call fails.
+ */
+export async function compactMessages(messages, provider, options) {
+    const keepRecent = options.keepRecent ?? 6; // Keep last 6 messages (3 rounds)
+    // Not enough messages to compact
+    if (messages.length <= keepRecent + 2)
+        return messages;
+    const firstMessage = messages[0];
+    const middleMessages = messages.slice(1, -keepRecent);
+    const recentMessages = messages.slice(-keepRecent);
+    // Build a condensed representation of middle messages for the summarizer
+    const middleText = middleMessages
+        .map((m) => `[${m.role}] ${m.content.slice(0, 500)}${m.content.length > 500 ? '…' : ''}`)
+        .join('\n---\n');
+    // Try to summarize via LLM
+    try {
+        const summaryRequest = {
+            messages: [{
+                    role: 'user',
+                    content: `Summarize the following conversation context:\n\n${middleText}`,
+                }],
+            model: options.model,
+            temperature: 0.1, // Very focused
+            maxTokens: 500,
+            systemPrompt: SUMMARIZER_SYSTEM_PROMPT,
+        };
+        let summary = '';
+        const stream = provider.streamCompletion(summaryRequest);
+        for await (const chunk of stream) {
+            if (!chunk.done)
+                summary += chunk.delta;
+        }
+        const trimmedSummary = summary.trim();
+        if (trimmedSummary.length > 20) {
+            // Successfully summarized — replace middle with summary
+            const summaryMessage = {
+                role: 'user',
+                content: `[CONTEXT SUMMARY — earlier tool results compressed]\n\n${trimmedSummary}\n\n[End of summary — recent context follows]`,
+            };
+            return [firstMessage, summaryMessage, ...recentMessages];
+        }
+    }
+    catch {
+        // Summarization failed — fall back to simple truncation
+    }
+    // Fallback: just keep first + truncated middle + recent
+    const fallbackSummary = {
+        role: 'user',
+        content: `[CONTEXT NOTE: ${middleMessages.length} earlier messages were compressed to save context space. Key info may need to be re-discovered if not in recent messages.]`,
+    };
+    return [firstMessage, fallbackSummary, ...recentMessages];
+}
+// ── Combined memory manager ───────────────────────────────────────────────────
+/**
+ * WorkingMemory manages the conversation's context budget throughout
+ * the agentic loop.  Commands use it like:
+ *
+ * ```ts
+ * const memory = new WorkingMemory(provider, model, systemPrompt);
+ * // In the tool loop:
+ * memory.addToolResult(toolName, output, messages);
+ * if (memory.shouldScratchpad(round)) messages.push(memory.scratchpadPrompt());
+ * if (memory.shouldCompact(messages)) messages = await memory.compact(messages);
+ * ```
+ */
+export class WorkingMemory {
+    provider;
+    model;
+    systemPrompt;
+    readFiles = new Set();
+    searchQueries = new Set();
+    factsLearned = [];
+    constructor(provider, model, systemPrompt) {
+        this.provider = provider;
+        this.model = model;
+        this.systemPrompt = systemPrompt;
+    }
+    /**
+     * Process and cap a tool result before injection into messages.
+     * Also tracks which files/searches have been done.
+     */
+    processToolResult(toolName, args, output) {
+        // Track what we've accessed
+        if (toolName === 'read_file' && args['path']) {
+            this.readFiles.add(String(args['path']));
+        }
+        if (toolName === 'search_text' && args['query']) {
+            this.searchQueries.add(String(args['query']));
+        }
+        // Cap the output
+        return capToolResult(toolName, output);
+    }
+    /**
+     * Check if we should inject a scratchpad prompt at this round.
+     */
+    shouldScratchpad(round) {
+        return shouldInjectScratchpad(round);
+    }
+    /**
+     * Build the scratchpad prompt.
+     */
+    scratchpadPrompt() {
+        return buildScratchpadPrompt();
+    }
+    /**
+     * Check if messages need compaction.
+     */
+    shouldCompact(messages) {
+        return needsCompaction(messages, this.systemPrompt, this.model);
+    }
+    /**
+     * Compact the messages array.
+     */
+    async compact(messages) {
+        return compactMessages(messages, this.provider, { model: this.model });
+    }
+    /**
+     * Get a summary of what has been accessed (for diagnostics / JAM.md updates).
+     */
+    getAccessLog() {
+        return {
+            readFiles: [...this.readFiles],
+            searchQueries: [...this.searchQueries],
+        };
+    }
+    /** Reset for a new turn (multi-turn chat). */
+    reset() {
+        // Don't reset readFiles/searchQueries — they're session-level
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/utils/memory.js.map

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

package/dist/utils/past-sessions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Past session search — find relevant Q&A from previous sessions.
+ *
+ * Uses a simple TF-IDF-like keyword overlap to find past conversations
+ * that are relevant to the current question.  No vector embeddings needed —
+ * this is a pragmatic approach for local-first CLI tools.
+ */
+export interface PastExchange {
+    /** The user's question from the past session. */
+    question: string;
+    /** The assistant's answer from the past session. */
+    answer: string;
+    /** The session name / id. */
+    sessionId: string;
+    /** Relevance score (0–1). */
+    score: number;
+}
+/**
+ * Search past sessions for Q&A exchanges relevant to the current question.
+ *
+ * @param question          The user's current question.
+ * @param workspaceRoot     Current workspace root (to scope sessions).
+ * @param maxResults        Maximum exchanges to return.
+ * @param minScore          Minimum relevance score to include.
+ */
+export declare function searchPastSessions(question: string, workspaceRoot: string, maxResults?: number, minScore?: number): Promise<PastExchange[]>;
+/**
+ * Format past exchanges as context to inject into the system prompt or messages.
+ */
+export declare function formatPastExchanges(exchanges: PastExchange[]): string;
+//# sourceMappingURL=past-sessions.d.ts.map

package/dist/utils/past-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"past-sessions.d.ts","sourceRoot":"","sources":["../../src/utils/past-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAyCD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,UAAU,GAAE,MAAU,EACtB,QAAQ,GAAE,MAAa,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CAwDzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,CAqBrE"}