@project-ava-supernova/core 0.2.71

package/dist/tools/browse-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browse-library.d.ts","sourceRoot":"","sources":["../../src/tools/browse-library.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiD5D,qBAAa,iBAAkB,YAAW,IAAI;IAC5C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,gJAAiJ;IACrK,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAuB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;YAyFlF,aAAa;CAuC5B"}

package/dist/tools/browse-library.js

@@ -0,0 +1,188 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join, extname, relative } from 'node:path';
+/**
+ * Browse the user's creative asset library.
+ *
+ * Scans TWO places, because assets live in two:
+ *  1. The project — images/, .ava/creative/, public/, src/assets/ etc. Paths
+ *     come back relative to the project, ready to wire into code.
+ *  2. The Creative Studio library — everything made in the Studio is saved
+ *     account-scoped under <userDataDir>/creative/<kind>/, OUTSIDE any project.
+ *     The host passes that directory via sharedState.creativeDir; paths come
+ *     back absolute, because that's what they are.
+ *
+ * (2) used to be missing entirely: the tool only ever scanned project-relative
+ * dirs, so every icon, logo, image and voiceover the user made in the Studio
+ * was invisible to Ava — she'd report "no assets" and offer to generate a fresh
+ * one, burning credits on something they already owned.
+ */
+const ASSET_EXTENSIONS = {
+    // Images
+    '.png': 'image', '.jpg': 'image', '.jpeg': 'image', '.gif': 'image',
+    '.svg': 'image', '.webp': 'image', '.ico': 'image', '.bmp': 'image',
+    // Video
+    '.mp4': 'video', '.webm': 'video', '.mov': 'video',
+    // Audio
+    '.mp3': 'audio', '.wav': 'audio', '.ogg': 'audio', '.m4a': 'audio',
+    // Documents
+    '.pdf': 'document', '.docx': 'document',
+    '.xlsx': 'spreadsheet',
+};
+const SCAN_DIRS = [
+    'images',
+    '.ava/creative',
+    'public',
+    'src/assets',
+    'assets',
+    'static',
+    'media',
+];
+export class BrowseLibraryTool {
+    name = 'browse_library';
+    description = 'Browse the project\'s creative asset library to find and reuse existing assets (logos, images, video, audio, documents) by their real path.';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'browse_library',
+        description: 'List the project\'s creative assets — images, video, audio, documents the user has created ' +
+            '(logos, graphics, clips, voice-overs, music). Use this whenever the project needs an existing ' +
+            'asset: to find a user-made logo/image/media and wire it into code or UI by its REAL path. ' +
+            'Always browse_library to get the actual path — never invent or guess an asset filename. ' +
+            'Generation of new media is user-initiated (it costs credits), so reach for existing assets here ' +
+            'rather than assuming something needs to be created. Filter by type to narrow results.',
+        parameters: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    enum: ['all', 'image', 'video', 'audio', 'document', 'spreadsheet'],
+                    description: 'Filter by asset type. Default: all.',
+                },
+                directory: {
+                    type: 'string',
+                    description: 'Scan a specific directory relative to project root instead of the standard locations.',
+                },
+            },
+        },
+    };
+    async execute(args, context) {
+        const filterType = args.type || 'all';
+        const specificDir = args.directory;
+        const cwd = context.cwd;
+        const assets = [];
+        const dirsToScan = specificDir ? [specificDir] : SCAN_DIRS;
+        for (const dir of dirsToScan) {
+            const fullDir = join(cwd, dir);
+            try {
+                await this.scanDirectory(fullDir, cwd, assets, filterType);
+            }
+            catch {
+                // Directory doesn't exist — skip
+            }
+        }
+        // The Creative Studio library — account-scoped, outside the project. Only
+        // when the caller didn't ask for one specific project directory.
+        const studioAssets = [];
+        const creativeDir = typeof context.sharedState?.creativeDir === 'string'
+            ? context.sharedState.creativeDir
+            : undefined;
+        if (!specificDir && creativeDir) {
+            try {
+                // Root the relative-path calc AT the creative dir, so entries read
+                // "icons/foo.png" rather than a pile of ../../.. escaping the project.
+                await this.scanDirectory(creativeDir, creativeDir, studioAssets, filterType);
+            }
+            catch {
+                // No library yet — skip
+            }
+        }
+        if (assets.length === 0 && studioAssets.length === 0) {
+            return {
+                success: true,
+                output: filterType === 'all'
+                    ? 'No creative assets found. Checked the project (images/, .ava/creative/, public/, src/assets/, assets/, static/, media/) and the Creative Studio library.'
+                    : `No ${filterType} assets found in the project or the Creative Studio library.`,
+            };
+        }
+        const size = (n) => n < 1024 ? `${n} B`
+            : n < 1024 * 1024 ? `${(n / 1024).toFixed(1)} KB`
+                : `${(n / (1024 * 1024)).toFixed(1)} MB`;
+        const section = (entries, prefix = '') => {
+            const grouped = {};
+            for (const a of entries)
+                (grouped[a.type] ??= []).push(a);
+            let out = '';
+            for (const [type, items] of Object.entries(grouped).sort()) {
+                out += `${type.toUpperCase()} (${items.length})\n`;
+                for (const item of items.slice(0, 50)) { // Cap at 50 per type
+                    out += `  ${prefix}${item.path} (${size(item.size)})\n`;
+                }
+                if (items.length > 50)
+                    out += `  ... and ${items.length - 50} more\n`;
+                out += '\n';
+            }
+            return out;
+        };
+        let output = '';
+        if (assets.length > 0) {
+            output += `In the project (${assets.length} asset${assets.length !== 1 ? 's' : ''}) — paths are project-relative, use them as-is:\n\n`;
+            output += section(assets);
+        }
+        if (studioAssets.length > 0) {
+            // Absolute, and said so plainly: these live in the user's Creative Studio
+            // library outside the project, so a relative path would be a lie.
+            output += `In their Creative Studio library (${studioAssets.length} asset${studioAssets.length !== 1 ? 's' : ''}) — these live outside the project, so the path is absolute. To use one in the project, copy it in rather than referencing it from here:\n\n`;
+            output += section(studioAssets, `${creativeDir}/`);
+        }
+        const byType = {};
+        for (const a of [...assets, ...studioAssets])
+            byType[a.type] = (byType[a.type] ?? 0) + 1;
+        return {
+            success: true,
+            output,
+            metadata: {
+                totalAssets: assets.length + studioAssets.length,
+                projectAssets: assets.length,
+                studioAssets: studioAssets.length,
+                byType,
+            },
+        };
+    }
+    async scanDirectory(dir, cwd, assets, filterType, depth = 0) {
+        if (depth > 5)
+            return; // Prevent deep recursion
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                // Skip node_modules, .git, dist, etc.
+                if (entry.name.startsWith('.') && entry.name !== '.ava')
+                    continue;
+                if (['node_modules', 'dist', 'build', '.next', '__pycache__'].includes(entry.name))
+                    continue;
+                await this.scanDirectory(fullPath, cwd, assets, filterType, depth + 1);
+            }
+            else if (entry.isFile()) {
+                const ext = extname(entry.name).toLowerCase();
+                const type = ASSET_EXTENSIONS[ext];
+                if (!type)
+                    continue;
+                if (filterType !== 'all' && type !== filterType)
+                    continue;
+                try {
+                    const info = await stat(fullPath);
+                    assets.push({
+                        path: relative(cwd, fullPath).replace(/\\/g, '/'),
+                        type,
+                        size: info.size,
+                        name: entry.name,
+                    });
+                }
+                catch {
+                    // Stat failed — skip
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=browse-library.js.map

package/dist/tools/browse-library.js.map

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

package/dist/tools/browser-click.d.ts

@@ -0,0 +1,12 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class BrowserClickTool implements Tool {
+    readonly name = "browser_click";
+    readonly description = "Click an element on the current browser page by CSS selector (from browser_snapshot).";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly usesDynamicConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=browser-click.d.ts.map

package/dist/tools/browser-click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-click.d.ts","sourceRoot":"","sources":["../../src/tools/browser-click.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,qBAAa,gBAAiB,YAAW,IAAI;IAC3C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,2FAA2F;IAC/G,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAe;IAChD,QAAQ,CAAC,oBAAoB,SAAS;IACtC,QAAQ,CAAC,uBAAuB,QAAQ;IAExC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAmB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAmCjG"}

package/dist/tools/browser-click.js

@@ -0,0 +1,58 @@
+import { gateDesktopAction, tickBudget, blockedResult } from './desktop-safety-gate.js';
+export class BrowserClickTool {
+    name = 'browser_click';
+    description = 'Click an element on the current browser page by CSS selector (from browser_snapshot).';
+    riskLevel = 'dangerous';
+    requiresConfirmation = false;
+    usesDynamicConfirmation = true;
+    schema = {
+        name: 'browser_click',
+        description: 'Click an element in the Ava browser using a CSS selector. Always use selectors returned by browser_snapshot — do not invent your own. ' +
+            'Irreversible actions (submit, pay, send, delete) require fresh approval every time.',
+        parameters: {
+            type: 'object',
+            properties: {
+                selector: {
+                    type: 'string',
+                    description: `CSS selector from browser_snapshot (e.g. "button#login", 'a[href="/compose"]').`,
+                },
+                target_text: {
+                    type: 'string',
+                    description: 'Optional: the visible text of the element (from the snapshot), used for safety classification. Pass it so Ava can detect irreversible verbs like Send, Submit, Delete, Pay and prompt accordingly.',
+                },
+            },
+            required: ['selector'],
+        },
+    };
+    async execute(args, context) {
+        const selector = args.selector?.trim();
+        if (!selector) {
+            return { success: false, output: 'selector is required.' };
+        }
+        const state = (context.sharedState || {});
+        const browser = state.browserProvider;
+        if (!browser) {
+            return {
+                success: false,
+                output: 'Browser provider is not available in this host. browser_click requires the Ava IDE (Tauri) with the browser worker running.',
+            };
+        }
+        const targetText = args.target_text?.trim();
+        const gate = await gateDesktopAction({ kind: 'click', targetName: targetText || selector, targetType: 'button' }, this.name, args, context);
+        if (!gate.allowed)
+            return blockedResult(gate);
+        try {
+            await browser.click(selector);
+            tickBudget(context);
+            return {
+                success: true,
+                output: `Clicked ${selector}${targetText ? ` ("${targetText}")` : ''}.`,
+                metadata: { selector, targetText, classification: gate.classification },
+            };
+        }
+        catch (err) {
+            return { success: false, output: `click failed: ${err instanceof Error ? err.message : String(err)}. Re-run browser_snapshot — the selector may be stale.` };
+        }
+    }
+}
+//# sourceMappingURL=browser-click.js.map

package/dist/tools/browser-click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-click.js","sourceRoot":"","sources":["../../src/tools/browser-click.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAExF,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,uFAAuF,CAAC;IACtG,SAAS,GAAkB,WAAW,CAAC;IACvC,oBAAoB,GAAG,KAAK,CAAC;IAC7B,uBAAuB,GAAG,IAAI,CAAC;IAE/B,MAAM,GAAmB;QAChC,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,wIAAwI;YACxI,qFAAqF;QACvF,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iFAAiF;iBAC/F;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oMAAoM;iBAClN;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;KACF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,IAA6B,EAAE,OAA6B;QACxE,MAAM,QAAQ,GAAI,IAAI,CAAC,QAAmB,EAAE,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;QAC7D,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAA4B,CAAC;QACrE,MAAM,OAAO,GAAG,KAAK,CAAC,eAA8C,CAAC;QAErE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,6HAA6H;aACtI,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAI,IAAI,CAAC,WAAkC,EAAE,IAAI,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAClC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,IAAI,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,EAC3E,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CACzB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC9B,UAAU,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,WAAW,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG;gBACvE,QAAQ,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE;aACxE,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,wDAAwD,EAAE,CAAC;QAC/J,CAAC;IACH,CAAC;CACF"}

package/dist/tools/browser-close.d.ts

@@ -0,0 +1,11 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class BrowserCloseTool implements Tool {
+    readonly name = "browser_close";
+    readonly description = "Close the Ava browser window and release the Playwright worker.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(_args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=browser-close.d.ts.map

package/dist/tools/browser-close.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-close.d.ts","sourceRoot":"","sources":["../../src/tools/browser-close.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,qBAAa,gBAAiB,YAAW,IAAI;IAC3C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,qEAAqE;IACzF,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAM7B;IAEI,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAelG"}

package/dist/tools/browser-close.js

@@ -0,0 +1,27 @@
+export class BrowserCloseTool {
+    name = 'browser_close';
+    description = 'Close the Ava browser window and release the Playwright worker.';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'browser_close',
+        description: 'Shut down the Ava browser window. Call this when you\'re done with the web portion of a task so the Chromium process is released. ' +
+            'Safe to call even if the browser wasn\'t open.',
+        parameters: { type: 'object', properties: {}, required: [] },
+    };
+    async execute(_args, context) {
+        const state = (context.sharedState || {});
+        const browser = state.browserProvider;
+        if (!browser) {
+            return { success: true, output: 'Browser provider is not available — nothing to close.' };
+        }
+        try {
+            await browser.close();
+            return { success: true, output: 'Browser closed.' };
+        }
+        catch (err) {
+            return { success: false, output: `close failed: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+}
+//# sourceMappingURL=browser-close.js.map

package/dist/tools/browser-close.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-close.js","sourceRoot":"","sources":["../../src/tools/browser-close.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,iEAAiE,CAAC;IAChF,SAAS,GAAkB,MAAM,CAAC;IAClC,oBAAoB,GAAG,KAAK,CAAC;IAE7B,MAAM,GAAmB;QAChC,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,oIAAoI;YACpI,gDAAgD;QAClD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;KAC7D,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAA8B,EAAE,OAA6B;QACzE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAA4B,CAAC;QACrE,MAAM,OAAO,GAAG,KAAK,CAAC,eAA8C,CAAC;QAErE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,uDAAuD,EAAE,CAAC;QAC5F,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACzG,CAAC;IACH,CAAC;CACF"}

package/dist/tools/browser-navigate.d.ts

@@ -0,0 +1,12 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class BrowserNavigateTool implements Tool {
+    readonly name = "browser_navigate";
+    readonly description = "Open a URL in the Ava-driven browser window (visible, persistent).";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly usesDynamicConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=browser-navigate.d.ts.map

package/dist/tools/browser-navigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-navigate.d.ts","sourceRoot":"","sources":["../../src/tools/browser-navigate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,qBAAa,mBAAoB,YAAW,IAAI;IAC9C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,wEAAwE;IAC5F,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IACtC,QAAQ,CAAC,uBAAuB,QAAQ;IAExC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAe7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CA+CjG"}

package/dist/tools/browser-navigate.js

@@ -0,0 +1,66 @@
+import { gateDesktopAction, tickBudget, blockedResult } from './desktop-safety-gate.js';
+export class BrowserNavigateTool {
+    name = 'browser_navigate';
+    description = 'Open a URL in the Ava-driven browser window (visible, persistent).';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    usesDynamicConfirmation = true;
+    schema = {
+        name: 'browser_navigate',
+        description: 'Navigate the Ava browser to a URL. The browser is visible, persistent across calls, and driven via DOM selectors (not pixel clicking). ' +
+            'After navigating, call browser_snapshot to see the page\'s interactable elements.',
+        parameters: {
+            type: 'object',
+            properties: {
+                url: {
+                    type: 'string',
+                    description: 'Full URL including scheme (e.g. "https://gmail.com"). Non-http(s) URLs are rejected.',
+                },
+            },
+            required: ['url'],
+        },
+    };
+    async execute(args, context) {
+        const url = args.url?.trim();
+        if (!url) {
+            return { success: false, output: 'url is required.' };
+        }
+        let parsed;
+        try {
+            parsed = new URL(url);
+        }
+        catch {
+            return { success: false, output: `Invalid URL: "${url}".` };
+        }
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+            return { success: false, output: `Only http(s) URLs are allowed (got "${parsed.protocol}").` };
+        }
+        const state = (context.sharedState || {});
+        const browser = state.browserProvider;
+        if (!browser) {
+            return {
+                success: false,
+                output: 'Browser provider is not available in this host. browser_navigate requires the Ava IDE (Tauri) with the browser worker running.',
+            };
+        }
+        // URL substring signals for classification (payment, admin, settings paths
+        // lean irreversible). Baseline is mutative-reversible — the page hasn't
+        // done anything yet, the user can just close the tab.
+        const gate = await gateDesktopAction({ kind: 'navigate', targetName: parsed.hostname + parsed.pathname }, this.name, args, context);
+        if (!gate.allowed)
+            return blockedResult(gate);
+        try {
+            const result = await browser.navigate(url);
+            tickBudget(context);
+            return {
+                success: true,
+                output: `Navigated to ${result.url} — "${result.title}". Call browser_snapshot to see what's on the page.`,
+                metadata: { url: result.url, title: result.title, classification: gate.classification },
+            };
+        }
+        catch (err) {
+            return { success: false, output: `navigate failed: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+}
+//# sourceMappingURL=browser-navigate.js.map

package/dist/tools/browser-navigate.js.map

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

package/dist/tools/browser-snapshot.d.ts

@@ -0,0 +1,11 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class BrowserSnapshotTool implements Tool {
+    readonly name = "browser_snapshot";
+    readonly description = "Return the structured list of links, buttons, inputs, and other interactable elements on the current browser page with CSS selectors.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=browser-snapshot.d.ts.map

package/dist/tools/browser-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-snapshot.d.ts","sourceRoot":"","sources":["../../src/tools/browser-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK5D,qBAAa,mBAAoB,YAAW,IAAI;IAC9C,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,2IAA2I;IAC/J,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAEtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAgB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAoCjG"}

package/dist/tools/browser-snapshot.js

@@ -0,0 +1,56 @@
+const MAX_ELEMENTS_IN_OUTPUT = 80;
+export class BrowserSnapshotTool {
+    name = 'browser_snapshot';
+    description = 'Return the structured list of links, buttons, inputs, and other interactable elements on the current browser page with CSS selectors.';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    schema = {
+        name: 'browser_snapshot',
+        description: 'Get the DOM-derived list of interactable elements on the current Ava browser page. ' +
+            'Each element comes with a stable CSS selector you pass back to browser_click or browser_type. ' +
+            'This is the preferred way to "see" a web page in Desktop Automation mode — do NOT request a screenshot.',
+        parameters: {
+            type: 'object',
+            properties: {
+                filter_tag: {
+                    type: 'string',
+                    description: 'Optional: only return elements of a specific tag (link, button, input, textarea, select).',
+                },
+            },
+            required: [],
+        },
+    };
+    async execute(args, context) {
+        const filterTag = args.filter_tag?.toLowerCase();
+        const state = (context.sharedState || {});
+        const browser = state.browserProvider;
+        if (!browser) {
+            return {
+                success: false,
+                output: 'Browser provider is not available in this host. browser_snapshot requires the Ava IDE (Tauri) with the browser worker running.',
+            };
+        }
+        try {
+            const snap = await browser.snapshot();
+            const filtered = filterTag
+                ? snap.elements.filter(e => e.tag?.toLowerCase() === filterTag)
+                : snap.elements;
+            const capped = filtered.slice(0, MAX_ELEMENTS_IN_OUTPUT);
+            const lines = capped.map(e => {
+                const label = e.text || e.placeholder || e.value || e.href || '';
+                const preview = label.length > 60 ? `${label.slice(0, 60)}…` : label;
+                return `- [${e.tag}] "${preview}" → ${e.selector}`;
+            });
+            const header = `Page: ${snap.title} (${snap.url})\n${filtered.length} element${filtered.length === 1 ? '' : 's'} (showing ${capped.length})`;
+            return {
+                success: true,
+                output: `${header}\n${lines.join('\n')}`,
+                metadata: { url: snap.url, title: snap.title, count: filtered.length, shown: capped.length, elements: capped },
+            };
+        }
+        catch (err) {
+            return { success: false, output: `snapshot failed: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+}
+//# sourceMappingURL=browser-snapshot.js.map

package/dist/tools/browser-snapshot.js.map

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

package/dist/tools/browser-type.d.ts

@@ -0,0 +1,12 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class BrowserTypeTool implements Tool {
+    readonly name = "browser_type";
+    readonly description = "Type text into the currently focused browser input (focus it with browser_click first).";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly usesDynamicConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=browser-type.d.ts.map

package/dist/tools/browser-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-type.d.ts","sourceRoot":"","sources":["../../src/tools/browser-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM5D,qBAAa,eAAgB,YAAW,IAAI;IAC1C,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,6FAA6F;IACjH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAC5C,QAAQ,CAAC,oBAAoB,SAAS;IACtC,QAAQ,CAAC,uBAAuB,QAAQ;IAExC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAuB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;CAwCjG"}

package/dist/tools/browser-type.js

@@ -0,0 +1,68 @@
+import { gateDesktopAction, tickBudget, blockedResult } from './desktop-safety-gate.js';
+const MAX_CHARS = 10_000;
+export class BrowserTypeTool {
+    name = 'browser_type';
+    description = 'Type text into the currently focused browser input (focus it with browser_click first).';
+    riskLevel = 'write';
+    requiresConfirmation = false;
+    usesDynamicConfirmation = true;
+    schema = {
+        name: 'browser_type',
+        description: 'Type text into the focused element on the current browser page. Focus the target field first via browser_click on its selector. ' +
+            'For secrets (passwords, API keys, 2FA codes), use secret_request for a capability handle instead of passing raw values.',
+        parameters: {
+            type: 'object',
+            properties: {
+                text: {
+                    type: 'string',
+                    description: 'Text to type. For named keys or combos, use a separate flow — this tool sends literal characters.',
+                },
+                field_hint: {
+                    type: 'string',
+                    description: 'Optional: name/label/placeholder of the focused field (from browser_snapshot), used for safety classification — e.g. "Password", "Email". Pass it so Ava can detect sensitive fields and route secrets through the capability handle flow.',
+                },
+                field_is_password: {
+                    type: 'boolean',
+                    description: 'Set to true when the focused field is a password / masked input. Forces the safety gate to require the secret handle flow.',
+                },
+            },
+            required: ['text'],
+        },
+    };
+    async execute(args, context) {
+        const text = args.text;
+        if (typeof text !== 'string') {
+            return { success: false, output: 'text is required.' };
+        }
+        if (text.length > MAX_CHARS) {
+            return { success: false, output: `text is too long (${text.length} chars, max ${MAX_CHARS}).` };
+        }
+        const state = (context.sharedState || {});
+        const browser = state.browserProvider;
+        if (!browser) {
+            return {
+                success: false,
+                output: 'Browser provider is not available in this host. browser_type requires the Ava IDE (Tauri) with the browser worker running.',
+            };
+        }
+        const fieldHint = args.field_hint?.trim();
+        const isMaskedField = args.field_is_password === true;
+        const gate = await gateDesktopAction({ kind: 'type', fieldName: fieldHint, targetName: fieldHint, isMaskedField }, this.name, args, context);
+        if (!gate.allowed)
+            return blockedResult(gate);
+        try {
+            await browser.type(text);
+            tickBudget(context);
+            const preview = text.length > 60 ? `${text.slice(0, 60)}…` : text;
+            return {
+                success: true,
+                output: `Typed ${text.length} character${text.length === 1 ? '' : 's'}: "${preview}"`,
+                metadata: { length: text.length, classification: gate.classification },
+            };
+        }
+        catch (err) {
+            return { success: false, output: `type failed: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+}
+//# sourceMappingURL=browser-type.js.map

package/dist/tools/browser-type.js.map

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

package/dist/tools/browser.d.ts

@@ -0,0 +1,29 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * Browser automation tool using Playwright.
+ *
+ * Maintains a persistent browser instance across calls so actions like
+ * navigate → fill → click → screenshot work as a multi-step workflow.
+ */
+export declare class BrowserTool implements Tool {
+    readonly name = "browser";
+    readonly description = "Automate browser interactions \u2014 navigate, click, fill, screenshot, extract text, run JS";
+    readonly riskLevel: ToolRiskLevel;
+    readonly outputTrust: "untrusted";
+    readonly requiresConfirmation = true;
+    private browser;
+    private page;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, _context: ToolExecutionContext): Promise<ToolResult>;
+    private ensureBrowser;
+    private doNavigate;
+    private doClick;
+    private doFill;
+    private doScreenshot;
+    private doExtract;
+    private doEvaluate;
+    /** Close the browser and release resources. */
+    closeBrowser(): ToolResult;
+}
+//# sourceMappingURL=browser.d.ts.map