@trenchwork/erosolar 1.1.30 → 1.1.32

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/interactionTools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * AskUserQuestion + PushNotification — agent-callable user-interaction tools.
+ *
+ * AskUserQuestion presents structured single/multi-select prompts. The
+ * user's answer comes back as the tool result. The CLI surface uses
+ * src/utils/askUserPrompt for rendering; in non-interactive contexts
+ * (HITL pause / portal-driven runs) the prompt is queued for the host.
+ *
+ * PushNotification fires an OS-native desktop notification — useful
+ * when the agent is running detached (long fuzz job, scheduled run)
+ * and wants to flag the user without stealing focus.
+ */
+import type { ToolDefinition } from '../core/toolRuntime.js';
+export declare function pushNotification(title: string, body: string): Promise<'os' | 'fallback'>;
+export declare function createInteractionTools(): ToolDefinition[];
+//# sourceMappingURL=interactionTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactionTools.d.ts","sourceRoot":"","sources":["../../src/tools/interactionTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAiI7D,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,UAAU,CAAC,CAS9F;AAED,wBAAgB,sBAAsB,IAAI,cAAc,EAAE,CA0EzD"}

package/dist/tools/interactionTools.js

@@ -0,0 +1,207 @@
+/**
+ * AskUserQuestion + PushNotification — agent-callable user-interaction tools.
+ *
+ * AskUserQuestion presents structured single/multi-select prompts. The
+ * user's answer comes back as the tool result. The CLI surface uses
+ * src/utils/askUserPrompt for rendering; in non-interactive contexts
+ * (HITL pause / portal-driven runs) the prompt is queued for the host.
+ *
+ * PushNotification fires an OS-native desktop notification — useful
+ * when the agent is running detached (long fuzz job, scheduled run)
+ * and wants to flag the user without stealing focus.
+ */
+import { execFile, execFileSync } from 'node:child_process';
+import { platform } from 'node:os';
+import { createInterface } from 'node:readline';
+import { formatAskUserPrompt } from '../utils/askUserPrompt.js';
+import { callLambda } from '../utils/lambdaClient.js';
+const MAX_OPTIONS = 9;
+function parseSelection(raw, optionCount, multiSelect) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return [];
+    const tokens = multiSelect ? trimmed.split(/[,\s]+/) : [trimmed];
+    const out = [];
+    for (const token of tokens) {
+        const idx = Number.parseInt(token, 10) - 1;
+        if (Number.isFinite(idx) && idx >= 0 && idx < optionCount) {
+            out.push(idx);
+        }
+    }
+    return Array.from(new Set(out));
+}
+async function askViaPortal(question, header, options, multiSelect, timeoutMs) {
+    // Push the question to Firestore via Lambda; the portal renders it
+    // under the "Pending questions" panel. The user clicks an answer,
+    // which writes back through cliQuestionAnswer; we poll until the
+    // doc says answered or we hit the timeout.
+    const created = await callLambda('cliQuestionCreate', {
+        question, header, multiSelect, options,
+    });
+    if (!created.ok || !created.result?.id) {
+        return { selected: [], cancelled: true };
+    }
+    const id = created.result.id;
+    const deadline = Date.now() + timeoutMs;
+    const interval = 1500;
+    while (Date.now() < deadline) {
+        await new Promise((r) => setTimeout(r, interval));
+        const polled = await callLambda('cliQuestionPoll', { id });
+        if (polled.ok && polled.result?.found && polled.result.answered) {
+            return { selected: polled.result.selected ?? [], cancelled: false };
+        }
+    }
+    return { selected: [], cancelled: true };
+}
+async function askInternal(question, header, options, multiSelect) {
+    if (!process.stdin.isTTY) {
+        // HITL bridge: ask through the portal. 10-minute timeout by default
+        // so a forgotten detached agent eventually returns rather than
+        // hanging forever.
+        if (process.env['EROSOLAR_DISABLE_PORTAL_HITL'] === '1') {
+            return { selected: [], cancelled: true };
+        }
+        return askViaPortal(question, header, options, multiSelect, 10 * 60 * 1000);
+    }
+    const formatted = formatAskUserPrompt({ question, header, options, multiSelect });
+    process.stdout.write(formatted.lines.join('\n') + '\n');
+    process.stdout.write(multiSelect
+        ? 'Enter option numbers (comma-separated), or blank to cancel: '
+        : 'Enter option number, or blank to cancel: ');
+    const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+    try {
+        const line = await new Promise((resolve) => {
+            rl.once('line', (l) => resolve(l));
+            rl.once('close', () => resolve(''));
+        });
+        const indices = parseSelection(line, options.length, multiSelect);
+        if (indices.length === 0)
+            return { selected: [], cancelled: true };
+        return { selected: indices.map((i) => options[i].label), cancelled: false };
+    }
+    finally {
+        rl.close();
+    }
+}
+function notifyLinux(title, body) {
+    try {
+        execFileSync('notify-send', ['--', title, body], {
+            stdio: ['ignore', 'ignore', 'ignore'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function notifyMac(title, body) {
+    // osascript is built into macOS; no extra install required.
+    const escapedTitle = title.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    const escapedBody = body.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    const script = `display notification "${escapedBody}" with title "${escapedTitle}"`;
+    try {
+        execFileSync('osascript', ['-e', script], { stdio: ['ignore', 'ignore', 'ignore'] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function notifyFallback(title, body) {
+    // Last resort: ring the bell + write the title/body to stderr so the
+    // user at least sees it in the active terminal session.
+    process.stderr.write(`\x07[notify] ${title}\n${body}\n`);
+}
+export async function pushNotification(title, body) {
+    const t = title.trim();
+    const b = body.trim();
+    if (!t)
+        return 'fallback';
+    const os = platform();
+    if (os === 'linux' && notifyLinux(t, b))
+        return 'os';
+    if (os === 'darwin' && notifyMac(t, b))
+        return 'os';
+    notifyFallback(t, b);
+    return 'fallback';
+}
+export function createInteractionTools() {
+    return [
+        {
+            name: 'AskUserQuestion',
+            description: 'Ask the user a structured question (single or multi-select). ' +
+                'Use to disambiguate scope, pick between trade-offs, or confirm ' +
+                'an irreversible action. Each option needs a label + description.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    question: { type: 'string', description: 'The full question (≤200 chars).' },
+                    header: { type: 'string', description: 'Short label (≤24 chars).' },
+                    multiSelect: { type: 'boolean', description: 'Allow multiple answers.' },
+                    options: {
+                        type: 'array',
+                        description: `Between 2 and ${MAX_OPTIONS} options. Each: { label, description }.`,
+                        items: {
+                            type: 'object',
+                            properties: {
+                                label: { type: 'string' },
+                                description: { type: 'string' },
+                            },
+                            required: ['label', 'description'],
+                        },
+                    },
+                },
+                required: ['question', 'header', 'options'],
+            },
+            handler: async (args) => {
+                const question = String(args['question'] ?? '').trim();
+                const header = String(args['header'] ?? '').trim().slice(0, 24);
+                const multiSelect = Boolean(args['multiSelect']);
+                const rawOptions = Array.isArray(args['options']) ? args['options'] : [];
+                if (!question)
+                    return 'AskUserQuestion requires `question`.';
+                if (rawOptions.length < 2 || rawOptions.length > MAX_OPTIONS) {
+                    return `AskUserQuestion requires 2..${MAX_OPTIONS} options.`;
+                }
+                const options = rawOptions.map((raw) => {
+                    const r = (raw ?? {});
+                    return {
+                        label: String(r['label'] ?? '').trim() || '(unlabeled)',
+                        description: String(r['description'] ?? '').trim(),
+                    };
+                });
+                const answer = await askInternal(question, header, options, multiSelect);
+                if (answer.cancelled)
+                    return 'User cancelled the question.';
+                return JSON.stringify({ selected: answer.selected });
+            },
+        },
+        {
+            name: 'PushNotification',
+            description: 'Fire an OS-native desktop notification (Linux notify-send / macOS ' +
+                'osascript). Use when the agent is running detached and wants to ' +
+                'flag the user without stealing focus. Falls back to terminal-bell ' +
+                '+ stderr if no native channel is available.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Short notification title.' },
+                    body: { type: 'string', description: 'Body text.' },
+                },
+                required: ['title'],
+            },
+            handler: async (args) => {
+                const title = String(args['title'] ?? '').trim();
+                if (!title)
+                    return 'PushNotification requires a title.';
+                const body = String(args['body'] ?? '').trim();
+                const channel = await pushNotification(title, body);
+                return `Notification dispatched (${channel}): ${title}`;
+            },
+        },
+    ];
+}
+// Suppress "unused import" warnings for the shape execFile is here in case
+// callers want a non-blocking variant later; intentionally not deleted.
+void execFile;
+//# sourceMappingURL=interactionTools.js.map

package/dist/tools/interactionTools.js.map

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