@trenchwork/erosolar 1.1.16

package/dist/tools/heliaControl.js

@@ -0,0 +1,93 @@
+/**
+ * Helia control client.
+ *
+ * The Helia browser runs a local HTTP control server bound to 127.0.0.1:59998
+ * and writes a per-install bearer token to its userData directory. The CLI
+ * is on the same machine, so there is no "pairing" step — we just read the
+ * token off disk and use it.
+ *
+ * The control server still requires the token (constant-time compare) so
+ * the surface stays safe against drive-by browser attacks (a malicious
+ * page can hit 127.0.0.1 but cannot read a file under the user's home).
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+const HOST = '127.0.0.1';
+const PORT = 59998;
+/**
+ * Mirrors Helia's `STABLE_USER_DATA_NAME = 'Helia'` pinning in
+ * Erosolar_Browser/main.js, so the CLI finds the token in the same
+ * directory Helia writes it to, regardless of the package.json `name`.
+ */
+function userDataDir() {
+    const home = os.homedir();
+    switch (os.platform()) {
+        case 'darwin':
+            return path.join(home, 'Library', 'Application Support', 'Helia');
+        case 'win32':
+            return path.join(process.env['APPDATA'] || path.join(home, 'AppData', 'Roaming'), 'Helia');
+        default:
+            return path.join(process.env['XDG_CONFIG_HOME'] || path.join(home, '.config'), 'Helia');
+    }
+}
+export function tokenPath() {
+    return path.join(userDataDir(), 'pairing-token');
+}
+export function readToken() {
+    try {
+        const t = fs.readFileSync(tokenPath(), 'utf8').trim();
+        return t || null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function ping() {
+    try {
+        const r = await fetch(`http://${HOST}:${PORT}/helia/ping`);
+        if (!r.ok)
+            return null;
+        return (await r.json());
+    }
+    catch {
+        return null;
+    }
+}
+async function call(method, route, body) {
+    const token = readToken();
+    if (!token) {
+        throw new Error(`Helia is not running (no token file at ${tokenPath()}). Launch Helia.app first.`);
+    }
+    const url = new URL(`http://${HOST}:${PORT}${route}`);
+    url.searchParams.set('token', token);
+    const r = await fetch(url, {
+        method,
+        headers: { 'Content-Type': 'application/json' },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!r.ok) {
+        let payload = {};
+        try {
+            payload = (await r.json());
+        }
+        catch { /* ignore */ }
+        throw new Error(payload.error || `HTTP ${r.status}`);
+    }
+    return (await r.json());
+}
+export const heliaControl = {
+    ping,
+    tokenPath,
+    tabs: () => call('GET', '/helia/tabs'),
+    openTab: (url) => call('POST', '/helia/tab/new', { url }),
+    closeTab: (id) => call('POST', '/helia/tab/close', { id }),
+    switchTab: (id) => call('POST', '/helia/tab/switch', { id }),
+    reload: (id) => call('POST', '/helia/tab/reload', id ? { id } : {}),
+    navigate: (url) => call('POST', '/helia/nav/load', { url }),
+    pageContext: () => call('GET', '/helia/page/context'),
+    prompt: (text) => call('POST', '/helia/agent/prompt', { text }),
+    focus: () => call('POST', '/helia/window/focus'),
+    openSidebar: () => call('POST', '/helia/sidebar/open'),
+};
+//# sourceMappingURL=heliaControl.js.map

package/dist/tools/heliaControl.js.map

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

package/dist/tools/hitlTools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * HITL Tools - The ONLY human-in-the-loop tools in the repository
+ * Provides decision points for critical operations
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createHITLTools(): ToolDefinition<any>[];
+//# sourceMappingURL=hitlTools.d.ts.map

package/dist/tools/hitlTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitlTools.d.ts","sourceRoot":"","sources":["../../src/tools/hitlTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAwC7D,wBAAgB,eAAe,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAgNvD"}

package/dist/tools/hitlTools.js

@@ -0,0 +1,185 @@
+/**
+ * HITL Tools - The ONLY human-in-the-loop tools in the repository
+ * Provides decision points for critical operations
+ */
+import { getHITL, hitl } from '../core/hitl.js';
+export function createHITLTools() {
+    return [
+        {
+            name: 'HITL_Decision',
+            description: 'Pause execution and ask the human to choose between 4 distinct alternatives YOU generate. Always provide exactly 4 substantively different options that span the realistic decision space (e.g. conservative vs. aggressive, narrow vs. broad scope, fast vs. thorough). The UI also offers an "Enter your own" write-in, so the user can always reject all 4 and propose their own plan. Use HITL_YesNo for genuine binary decisions instead.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Decision title/question' },
+                    description: { type: 'string', description: 'Detailed description of the decision' },
+                    context: { type: 'string', description: 'Additional context information' },
+                    options: {
+                        type: 'array',
+                        description: 'Exactly 4 distinct candidate options. The UI automatically appends an "Enter your own" write-in so the user can also propose an alternative.',
+                        minItems: 4,
+                        maxItems: 4,
+                        items: {
+                            type: 'object',
+                            properties: {
+                                id: { type: 'string' },
+                                label: { type: 'string' },
+                                description: { type: 'string' },
+                                shortcut: { type: 'string' }
+                            },
+                            required: ['id', 'label', 'description']
+                        }
+                    },
+                    defaultOptionId: { type: 'string', description: 'Default option ID' },
+                    requiresExplicitChoice: { type: 'boolean', description: 'Require explicit user choice' },
+                    autoPause: { type: 'boolean', description: 'Auto-pause execution for decision' },
+                    timeoutMs: { type: 'number', description: 'Timeout in milliseconds (0 = no timeout)' }
+                },
+                required: ['title', 'description', 'options']
+            },
+            handler: async (args) => {
+                const typedArgs = args;
+                const hitlSystem = getHITL({
+                    autoPause: typedArgs.autoPause ?? true,
+                    timeoutMs: typedArgs.timeoutMs ?? 0,
+                    logLevel: 'detailed'
+                });
+                const options = (typedArgs.options || []).map(opt => ({
+                    id: opt.id,
+                    label: opt.label,
+                    description: opt.description,
+                    shortcut: opt.shortcut
+                }));
+                // Enforce the 4-option contract at runtime — schemas can be ignored
+                // by some LLM providers. The "Enter your own" write-in is added by
+                // the HITL UI, so the human always sees 5 menu items.
+                if (options.length !== 4) {
+                    throw new Error(`HITL_Decision requires exactly 4 options, got ${options.length}. ` +
+                        `Generate 4 substantively different alternatives spanning the realistic decision space ` +
+                        `(e.g. conservative vs. aggressive, narrow vs. broad scope, fast vs. thorough). ` +
+                        `Use HITL_YesNo for binary decisions instead.`);
+                }
+                const selectedOptionId = await hitlSystem.requestDecision({
+                    id: `hitl-tool-${Date.now()}-${Math.random().toString(36).substring(2, 7)}`,
+                    title: typedArgs.title,
+                    description: typedArgs.description,
+                    context: typedArgs.context || '',
+                    options,
+                    defaultOptionId: typedArgs.defaultOptionId,
+                    requiresExplicitChoice: typedArgs.requiresExplicitChoice ?? true
+                });
+                const selectedOption = options.find(opt => opt.id === selectedOptionId);
+                return `HITL decision: ${selectedOption?.label || selectedOptionId}
+Selected option ID: ${selectedOptionId}
+Timestamp: ${new Date().toISOString()}
+Note: HITL decision recorded. This is the ONLY human-in-the-loop system in the repository.`;
+            }
+        },
+        {
+            name: 'HITL_YesNo',
+            description: 'Simple yes/no decision point',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Decision title/question' },
+                    description: { type: 'string', description: 'Detailed description' },
+                    context: { type: 'string', description: 'Additional context' },
+                    defaultYes: { type: 'boolean', description: 'Default to yes (true) or no (false)' }
+                },
+                required: ['title', 'description']
+            },
+            handler: async (args) => {
+                const typedArgs = args;
+                const result = await hitl.askYesNo(typedArgs.title, typedArgs.description, typedArgs.context || '', typedArgs.defaultYes ?? true);
+                return `HITL yes/no decision: ${result ? 'yes' : 'no'}
+Approved: ${result}
+Timestamp: ${new Date().toISOString()}
+Note: HITL yes/no decision recorded`;
+            }
+        },
+        {
+            name: 'HITL_Select',
+            description: 'Select from multiple options',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Selection title' },
+                    description: { type: 'string', description: 'Detailed description' },
+                    options: { type: 'string', description: 'JSON array of options: [{id, label, description}]' },
+                    context: { type: 'string', description: 'Additional context' },
+                    defaultOptionId: { type: 'string', description: 'Default option ID' }
+                },
+                required: ['title', 'description', 'options']
+            },
+            handler: async (args) => {
+                const typedArgs = args;
+                let options;
+                try {
+                    options = JSON.parse(typedArgs.options);
+                }
+                catch (error) {
+                    throw new Error(`Invalid options JSON: ${error}`);
+                }
+                const result = await hitl.selectOption(typedArgs.title, typedArgs.description, options, typedArgs.context || '', typedArgs.defaultOptionId);
+                const selectedOption = options.find(opt => opt.id === result);
+                return `HITL selection: ${selectedOption?.label || result}
+Selected option ID: ${result}
+Timestamp: ${new Date().toISOString()}
+Note: HITL selection recorded`;
+            }
+        },
+        {
+            name: 'HITL_Approval',
+            description: 'Request approval for risky operation',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Approval title' },
+                    riskDescription: { type: 'string', description: 'Description of risks' },
+                    operationDetails: { type: 'string', description: 'Detailed operation description' }
+                },
+                required: ['title', 'riskDescription']
+            },
+            handler: async (args) => {
+                const typedArgs = args;
+                const result = await hitl.requestApproval(typedArgs.title, typedArgs.riskDescription, typedArgs.operationDetails || '');
+                return `HITL approval: ${result ? 'approved' : 'rejected'}
+Approved: ${result}
+Timestamp: ${new Date().toISOString()}
+Note: ${result ? 'Operation approved via HITL' : 'Operation rejected via HITL'}`;
+            }
+        },
+        {
+            name: 'HITL_Status',
+            description: 'Get HITL system status and history',
+            parameters: {
+                type: 'object',
+                properties: {
+                    clearHistory: { type: 'boolean', description: 'Clear decision history' }
+                }
+            },
+            handler: async (args) => {
+                const hitlSystem = getHITL();
+                if (args.clearHistory) {
+                    hitlSystem.clearHistory();
+                    return `HITL history cleared
+Timestamp: ${new Date().toISOString()}`;
+                }
+                const history = hitlSystem.getHistory();
+                const recentDecisions = history.slice(-5).map(decision => ({
+                    requestId: decision.requestId,
+                    selectedOptionId: decision.selectedOptionId,
+                    timestamp: decision.timestamp.toISOString(),
+                    hasCustomInput: !!decision.userInput
+                }));
+                return `HITL System Status
+Status: active
+Total decisions: ${history.length}
+Recent decisions:
+${recentDecisions.map(d => `  • ${d.selectedOptionId} at ${d.timestamp}${d.hasCustomInput ? ' (custom input)' : ''}`).join('\n')}
+Note: This is the ONLY human-in-the-loop system in the repository`;
+            }
+        }
+    ];
+}
+//# sourceMappingURL=hitlTools.js.map

package/dist/tools/hitlTools.js.map

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

package/dist/tools/localExplore.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Local Explore - Minimal stub for backward compatibility
+ */
+export type AIEnhancer = (prompt: string) => Promise<string>;
+export declare function setGlobalAIEnhancer(enhancer: AIEnhancer | null): void;
+export declare function getGlobalAIEnhancer(): AIEnhancer | null;
+export interface CodebaseIndex {
+    version: number;
+    createdAt: string;
+    rootDir: string;
+    hash: string;
+    files: IndexedFile[];
+    symbols: SymbolIndex;
+    imports: ImportGraph;
+    patterns: DetectedPatterns;
+}
+export interface IndexedFile {
+    path: string;
+    hash: string;
+    lastModified: number;
+}
+export interface SymbolIndex {
+    functions: Map<string, string[]>;
+    classes: Map<string, string[]>;
+    exports: Map<string, string[]>;
+}
+export interface ImportGraph {
+    nodes: string[];
+    edges: [string, string][];
+}
+export interface DetectedPatterns {
+    frameworks: string[];
+    testFrameworks: string[];
+    buildTools: string[];
+}
+export declare function buildCodebaseIndex(_rootDir: string): Promise<CodebaseIndex>;
+export declare function searchIndex(_index: CodebaseIndex, _query: string): Promise<string[]>;
+//# sourceMappingURL=localExplore.d.ts.map

package/dist/tools/localExplore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localExplore.d.ts","sourceRoot":"","sources":["../../src/tools/localExplore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAI7D,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAErE;AAED,wBAAgB,mBAAmB,IAAI,UAAU,GAAG,IAAI,CAEvD;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAejF;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB"}

package/dist/tools/localExplore.js

@@ -0,0 +1,30 @@
+/**
+ * Local Explore - Minimal stub for backward compatibility
+ */
+let _globalAIEnhancer = null;
+export function setGlobalAIEnhancer(enhancer) {
+    _globalAIEnhancer = enhancer;
+}
+export function getGlobalAIEnhancer() {
+    return _globalAIEnhancer;
+}
+export async function buildCodebaseIndex(_rootDir) {
+    return {
+        version: 1,
+        createdAt: new Date().toISOString(),
+        rootDir: _rootDir,
+        hash: '',
+        files: [],
+        symbols: {
+            functions: new Map(),
+            classes: new Map(),
+            exports: new Map(),
+        },
+        imports: { nodes: [], edges: [] },
+        patterns: { frameworks: [], testFrameworks: [], buildTools: [] },
+    };
+}
+export async function searchIndex(_index, _query) {
+    return [];
+}
+//# sourceMappingURL=localExplore.js.map

package/dist/tools/localExplore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localExplore.js","sourceRoot":"","sources":["../../src/tools/localExplore.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,IAAI,iBAAiB,GAAsB,IAAI,CAAC;AAEhD,MAAM,UAAU,mBAAmB,CAAC,QAA2B;IAC7D,iBAAiB,GAAG,QAAQ,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAoCD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,QAAQ;QACjB,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,EAAE;QACT,OAAO,EAAE;YACP,SAAS,EAAE,IAAI,GAAG,EAAE;YACpB,OAAO,EAAE,IAAI,GAAG,EAAE;YAClB,OAAO,EAAE,IAAI,GAAG,EAAE;SACnB;QACD,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QACjC,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAqB,EACrB,MAAc;IAEd,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/tools/memoryTools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Persistent memory tools — save/recall facts across CLI sessions.
+ * Mirrors the Claude Agent SDK memory pattern: a per-project
+ * directory of markdown files, each with a name + brief description,
+ * indexed so the agent can browse and selectively load.
+ *
+ * Storage layout (all paths relative to the working directory):
+ *   .erosolar/memory/
+ *     MEMORY.md         — index file the agent maintains
+ *     <name>.md         — individual memory entries
+ *
+ * Tools provided:
+ *   memory_save(name, content, description?)
+ *   memory_list()
+ *   memory_load(name)
+ *   memory_delete(name)
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createMemoryTools(workingDir: string): ToolDefinition[];
+//# sourceMappingURL=memoryTools.d.ts.map

package/dist/tools/memoryTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryTools.d.ts","sourceRoot":"","sources":["../../src/tools/memoryTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA0B7D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CAoGtE"}

package/dist/tools/memoryTools.js

@@ -0,0 +1,180 @@
+/**
+ * Persistent memory tools — save/recall facts across CLI sessions.
+ * Mirrors the Claude Agent SDK memory pattern: a per-project
+ * directory of markdown files, each with a name + brief description,
+ * indexed so the agent can browse and selectively load.
+ *
+ * Storage layout (all paths relative to the working directory):
+ *   .erosolar/memory/
+ *     MEMORY.md         — index file the agent maintains
+ *     <name>.md         — individual memory entries
+ *
+ * Tools provided:
+ *   memory_save(name, content, description?)
+ *   memory_list()
+ *   memory_load(name)
+ *   memory_delete(name)
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+function memoryDir(workingDir) {
+    return join(workingDir, '.erosolar', 'memory');
+}
+function ensureDir(workingDir) {
+    const dir = memoryDir(workingDir);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+/** Sanitize a memory name for use as a filename. Strict allow-list. */
+function safeName(name) {
+    if (typeof name !== 'string')
+        return null;
+    const trimmed = name.trim();
+    if (!trimmed)
+        return null;
+    // Allow letters, digits, underscore, hyphen. Reject path traversal,
+    // dots (so the name can't escape .md), spaces.
+    if (!/^[A-Za-z0-9_-]+$/.test(trimmed))
+        return null;
+    if (trimmed.length > 80)
+        return null;
+    return trimmed;
+}
+export function createMemoryTools(workingDir) {
+    return [
+        {
+            name: 'memory_save',
+            description: 'Save a piece of context (project facts, user preferences, prior decisions) to persistent memory so it survives across CLI sessions. Use for non-obvious facts the user shares OR validated approaches you want to repeat. Overwrites any existing entry with the same name.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Unique short identifier ([A-Za-z0-9_-]+, max 80 chars). Becomes the filename.' },
+                    content: { type: 'string', description: 'The memory body. Markdown is fine.' },
+                    description: { type: 'string', description: 'One-line summary used for the index. Optional but recommended.' },
+                },
+                required: ['name', 'content'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const name = safeName(args['name']);
+                if (!name)
+                    return 'Error: name must match [A-Za-z0-9_-]+ (letters, digits, _, -).';
+                const content = args['content'];
+                if (typeof content !== 'string')
+                    return 'Error: content must be a string.';
+                const description = args['description'];
+                const dir = ensureDir(workingDir);
+                const filePath = join(dir, `${name}.md`);
+                const body = description && typeof description === 'string'
+                    ? `> ${description.trim()}\n\n${content}`
+                    : content;
+                writeFileSync(filePath, body, 'utf-8');
+                // Update MEMORY.md index — append/replace this entry.
+                rebuildIndex(dir);
+                return `⏺ memory_save(${name}) — saved (${Buffer.byteLength(body, 'utf8')} bytes)`;
+            },
+        },
+        {
+            name: 'memory_list',
+            description: 'List all saved memories with their one-line descriptions. Use BEFORE memory_load to see what\'s available.',
+            parameters: { type: 'object', properties: {}, additionalProperties: false },
+            handler: async () => {
+                const dir = memoryDir(workingDir);
+                if (!existsSync(dir))
+                    return 'No memories saved yet.';
+                const entries = readdirSync(dir).filter((f) => f.endsWith('.md') && f !== 'MEMORY.md');
+                if (entries.length === 0)
+                    return 'No memories saved yet.';
+                const lines = [`Memories (${entries.length}):`];
+                for (const file of entries.sort()) {
+                    const name = file.slice(0, -3);
+                    let desc = '';
+                    try {
+                        const body = readFileSync(join(dir, file), 'utf-8');
+                        const firstLine = body.split('\n')[0]?.trim() ?? '';
+                        if (firstLine.startsWith('>')) {
+                            desc = firstLine.slice(1).trim();
+                        }
+                    }
+                    catch { /* skip */ }
+                    lines.push(`  - ${name}${desc ? ` — ${desc}` : ''}`);
+                }
+                return lines.join('\n');
+            },
+        },
+        {
+            name: 'memory_load',
+            description: 'Load the full content of a previously saved memory by name. Use after memory_list to pull in relevant context.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'The memory identifier passed to memory_save.' },
+                },
+                required: ['name'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const name = safeName(args['name']);
+                if (!name)
+                    return 'Error: name must match [A-Za-z0-9_-]+.';
+                const filePath = join(memoryDir(workingDir), `${name}.md`);
+                if (!existsSync(filePath))
+                    return `Memory not found: ${name}. Use memory_list to see what's saved.`;
+                return readFileSync(filePath, 'utf-8');
+            },
+        },
+        {
+            name: 'memory_delete',
+            description: 'Delete a memory permanently. Use sparingly — prefer overwriting via memory_save with the same name.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'The memory identifier to remove.' },
+                },
+                required: ['name'],
+                additionalProperties: false,
+            },
+            handler: async (args) => {
+                const name = safeName(args['name']);
+                if (!name)
+                    return 'Error: name must match [A-Za-z0-9_-]+.';
+                const dir = memoryDir(workingDir);
+                const filePath = join(dir, `${name}.md`);
+                if (!existsSync(filePath))
+                    return `Memory not found: ${name}.`;
+                unlinkSync(filePath);
+                rebuildIndex(dir);
+                return `⏺ memory_delete(${name}) — removed.`;
+            },
+        },
+    ];
+}
+/**
+ * Rebuild MEMORY.md from the current set of entries. The index is a
+ * simple bulleted list — agents that load all of MEMORY.md at the
+ * start of a session see the catalogue without reading every entry.
+ */
+function rebuildIndex(dir) {
+    if (!existsSync(dir))
+        return;
+    const entries = readdirSync(dir).filter((f) => f.endsWith('.md') && f !== 'MEMORY.md').sort();
+    const lines = ['# Memory index', '', 'Saved entries:', ''];
+    for (const file of entries) {
+        const name = file.slice(0, -3);
+        let desc = '';
+        try {
+            const body = readFileSync(join(dir, file), 'utf-8');
+            const firstLine = body.split('\n')[0]?.trim() ?? '';
+            if (firstLine.startsWith('>'))
+                desc = firstLine.slice(1).trim();
+        }
+        catch { /* skip */ }
+        lines.push(`- [${name}](./${name}.md)${desc ? ` — ${desc}` : ''}`);
+    }
+    if (entries.length === 0)
+        lines.push('_(empty)_');
+    writeFileSync(join(dir, 'MEMORY.md'), lines.join('\n') + '\n', 'utf-8');
+}
+//# sourceMappingURL=memoryTools.js.map

package/dist/tools/memoryTools.js.map

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

package/dist/tools/notebookTools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Notebook tools — Claude-Code-parity for .ipynb editing.
+ *
+ * Jupyter notebooks are JSON files where the bulk of useful content
+ * lives in `cells: [{ cell_type, source: string|string[], … }]`. Doing
+ * source edits via the generic Edit tool is brittle because the
+ * `source` field is sometimes a string and sometimes a string[],
+ * and surrounding JSON whitespace varies. This module exposes a
+ * structured tool — `NotebookEdit` — that addresses cells by index
+ * and rewrites just that cell's source while preserving everything
+ * else.
+ *
+ * Capabilities:
+ *   NotebookEdit({ notebook_path, cell_index, new_source, mode? })
+ *     mode: "replace" (default), "insert", "delete"
+ *     Returns a short summary of the change.
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function createNotebookTools(workingDir: string): ToolDefinition[];
+//# sourceMappingURL=notebookTools.d.ts.map

package/dist/tools/notebookTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebookTools.d.ts","sourceRoot":"","sources":["../../src/tools/notebookTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA4C7D,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,EAAE,CAmGxE"}