@project-ava-supernova/core 0.2.71

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/tools/browser.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;AA+B5D;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,IAAI;IACtC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,kGAA6F;IACjH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAe;IAChD,QAAQ,CAAC,WAAW,EAAG,WAAW,CAAU;IAC5C,QAAQ,CAAC,oBAAoB,QAAQ;IAGrC,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,IAAI,CAAa;IAEzB,QAAQ,CAAC,MAAM,EAAE,cAAc,CA+C7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;YAwCnF,aAAa;YAmCb,UAAU;YA8BV,OAAO;YAgBP,MAAM;YAkBN,YAAY;YAiCZ,SAAS;YA4BT,UAAU;IAmBxB,+CAA+C;IAC/C,YAAY,IAAI,UAAU;CAmB3B"}

package/dist/tools/browser.js

@@ -0,0 +1,307 @@
+const NAVIGATION_TIMEOUT_MS = 30_000;
+const ACTION_TIMEOUT_MS = 10_000;
+const MAX_EXTRACT_LENGTH = 20_000;
+const ALLOWED_ACTIONS = new Set(['navigate', 'click', 'fill', 'screenshot', 'extract', 'evaluate', 'close']);
+/**
+ * Block requests to internal-only IP ranges (SSRF protection).
+ * localhost and 127.0.0.0/8 are explicitly ALLOWED because Ava runs locally
+ * and dev servers always bind to localhost. We only block private network
+ * ranges (10.x, 172.16-31.x, 192.168.x) that could reach internal services.
+ */
+function isPrivateHost(hostname) {
+    // localhost / 127.x.x.x / [::1] are ALLOWED — dev servers run here
+    if (hostname === 'localhost' || hostname === '[::1]')
+        return false;
+    const parts = hostname.split('.').map(Number);
+    if (parts.length === 4 && parts.every(n => !isNaN(n))) {
+        if (parts[0] === 127)
+            return false; // loopback — allowed
+        if (parts[0] === 10)
+            return true;
+        if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31)
+            return true;
+        if (parts[0] === 192 && parts[1] === 168)
+            return true;
+        if (parts[0] === 169 && parts[1] === 254)
+            return true;
+        if (parts[0] === 0)
+            return true;
+    }
+    return false;
+}
+/**
+ * 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 class BrowserTool {
+    name = 'browser';
+    description = 'Automate browser interactions — navigate, click, fill, screenshot, extract text, run JS';
+    riskLevel = 'dangerous';
+    outputTrust = 'untrusted';
+    requiresConfirmation = true;
+    // Persistent state across calls
+    browser = null;
+    page = null;
+    schema = {
+        name: 'browser',
+        description: 'Automate browser interactions using Playwright (headless Chromium). ' +
+            'The browser persists across calls so you can navigate, then interact with the page. ' +
+            'Actions: navigate (go to URL), click (CSS selector), fill (type into input), ' +
+            'screenshot (capture page as PNG), extract (get page text), evaluate (run JS), close (cleanup). ' +
+            'Requires Playwright. If it is not installed (common on fresh machines), the install needs ' +
+            'a few hundred MB of disk for the browser binaries — surface the install plainly and let the ' +
+            'user approve via the standard bash confirmation. Install with the project\'s package manager ' +
+            '(`pnpm add playwright` or `npm install playwright`), then `npx playwright install chromium` ' +
+            'for the browser binary, then call browser again. Do not call any of these without going ' +
+            'through bash, and do not skip the confirmation card — the disk-space cost is meaningful ' +
+            'and the user should see it.',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['navigate', 'click', 'fill', 'screenshot', 'extract', 'evaluate', 'close'],
+                    description: 'Action to perform. navigate: go to URL. click: click element. fill: type text. ' +
+                        'screenshot: capture page. extract: get page text. evaluate: run JS. close: cleanup browser.',
+                },
+                url: {
+                    type: 'string',
+                    description: 'URL to navigate to (required for navigate action).',
+                },
+                selector: {
+                    type: 'string',
+                    description: 'CSS selector for the target element (required for click, fill; optional for screenshot, extract).',
+                },
+                value: {
+                    type: 'string',
+                    description: 'Text to type (required for fill action).',
+                },
+                script: {
+                    type: 'string',
+                    description: 'JavaScript to evaluate in the page context (required for evaluate action). Has no Node.js access.',
+                },
+                full_page: {
+                    type: 'boolean',
+                    description: 'Capture full scrollable page instead of viewport only (for screenshot). Default: false (viewport only — smaller, usually what you want). Set true only when you genuinely need content below the fold.',
+                },
+            },
+            required: ['action'],
+        },
+    };
+    async execute(args, _context) {
+        const action = args.action;
+        if (!ALLOWED_ACTIONS.has(action)) {
+            return {
+                success: false,
+                output: `Invalid action "${action}". Use one of: ${[...ALLOWED_ACTIONS].join(', ')}`,
+            };
+        }
+        // Close action doesn't need browser to be open
+        if (action === 'close') {
+            return this.closeBrowser();
+        }
+        // Ensure browser is running for all other actions
+        try {
+            await this.ensureBrowser();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { success: false, output: message };
+        }
+        try {
+            switch (action) {
+                case 'navigate': return await this.doNavigate(args);
+                case 'click': return await this.doClick(args);
+                case 'fill': return await this.doFill(args);
+                case 'screenshot': return await this.doScreenshot(args);
+                case 'extract': return await this.doExtract(args);
+                case 'evaluate': return await this.doEvaluate(args);
+                default:
+                    return { success: false, output: `Unknown action: ${action}` };
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { success: false, output: `Browser action "${action}" failed: ${message}` };
+        }
+    }
+    async ensureBrowser() {
+        if (this.browser && this.page)
+            return;
+        let playwright;
+        try {
+            // webpackIgnore, because playwright is an OPTIONAL peer resolved at
+            // runtime and only on the machine that actually drives a browser.
+            // Without it a bundler follows the bare specifier anyway — being lazy in
+            // JS does not make it lazy to webpack — and drags in playwright-core,
+            // electron, and the recorder's binary .ttf assets. That is what breaks
+            // `next build` in packages/web, which imports core for entirely
+            // unrelated reasons and will never open a browser. The cost of that was
+            // not the bundle: it was losing the ability to build the web app
+            // locally, so every deploy went out proven only on Render.
+            playwright = await import(/* webpackIgnore: true */ 'playwright');
+        }
+        catch {
+            throw new Error('Playwright is not installed. This is the standard browser automation backend ' +
+                'and installing it is PRE-AUTHORIZED — you do not need to ask the user for ' +
+                'permission. Install it now and retry the browser action:\n' +
+                "  1. Add the package via the project's package manager:\n" +
+                '       pnpm add playwright    (if pnpm-lock.yaml exists)\n' +
+                '       npm install playwright (otherwise)\n' +
+                '  2. Download the Chromium browser binary:\n' +
+                '       npx playwright install chromium\n' +
+                'After both commands succeed, call the browser tool again with the original action.');
+        }
+        const chromium = playwright.default?.chromium || playwright.chromium;
+        this.browser = await chromium.launch({ headless: true });
+        this.page = await this.browser.newPage();
+        this.page.setDefaultTimeout(ACTION_TIMEOUT_MS);
+    }
+    async doNavigate(args) {
+        const url = args.url;
+        if (!url) {
+            return { success: false, output: 'URL is required for navigate action.' };
+        }
+        // Validate URL — http/https only, no private hosts
+        try {
+            const parsed = new URL(url);
+            if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+                return { success: false, output: `Unsupported protocol: ${parsed.protocol}. Only http:// and https:// are allowed.` };
+            }
+            if (isPrivateHost(parsed.hostname)) {
+                return { success: false, output: `Blocked: navigation to private/internal addresses is not allowed (${parsed.hostname}).` };
+            }
+        }
+        catch {
+            return { success: false, output: `Invalid URL: ${url}` };
+        }
+        await this.page.goto(url, { timeout: NAVIGATION_TIMEOUT_MS, waitUntil: 'domcontentloaded' });
+        const title = await this.page.title();
+        const currentUrl = this.page.url();
+        return {
+            success: true,
+            output: `Navigated to: ${currentUrl}\nTitle: ${title}`,
+            metadata: { url: currentUrl, title },
+        };
+    }
+    async doClick(args) {
+        const selector = args.selector;
+        if (!selector) {
+            return { success: false, output: 'Selector is required for click action.' };
+        }
+        await this.page.click(selector);
+        // Brief wait for any navigation or JS triggered by click
+        await this.page.waitForTimeout(500);
+        return {
+            success: true,
+            output: `Clicked: ${selector}\nCurrent URL: ${this.page.url()}`,
+        };
+    }
+    async doFill(args) {
+        const selector = args.selector;
+        const value = args.value;
+        if (!selector) {
+            return { success: false, output: 'Selector is required for fill action.' };
+        }
+        if (value === undefined || value === null) {
+            return { success: false, output: 'Value is required for fill action.' };
+        }
+        await this.page.fill(selector, value);
+        return {
+            success: true,
+            output: `Filled "${selector}" with text (${value.length} chars)`,
+        };
+    }
+    async doScreenshot(args) {
+        // Default to viewport only (not fullPage). Full-page screenshots of
+        // scrollable pages can be 5-10x larger than viewport captures and the
+        // visible area is almost always what the model needs. Callers who
+        // genuinely need the whole scrollable page can pass full_page: true.
+        const fullPage = args.full_page ?? false;
+        const selector = args.selector;
+        let buffer;
+        if (selector) {
+            const element = await this.page.$(selector);
+            if (!element) {
+                return { success: false, output: `Element not found: ${selector}` };
+            }
+            buffer = await element.screenshot({ type: 'png' });
+        }
+        else {
+            buffer = await this.page.screenshot({ type: 'png', fullPage });
+        }
+        const base64 = buffer.toString('base64');
+        const sizeKB = Math.round(buffer.length / 1024);
+        return {
+            success: true,
+            output: `Screenshot captured (${sizeKB} KB PNG${selector ? `, element: ${selector}` : fullPage ? ', full page' : ', viewport'}). The image is available for vision analysis.`,
+            metadata: {
+                base64_image: base64,
+                mime_type: 'image/png',
+                size_bytes: buffer.length,
+            },
+        };
+    }
+    async doExtract(args) {
+        const selector = args.selector;
+        let text;
+        if (selector) {
+            const element = await this.page.$(selector);
+            if (!element) {
+                return { success: false, output: `Element not found: ${selector}` };
+            }
+            text = await element.innerText();
+        }
+        else {
+            text = await this.page.innerText('body');
+        }
+        if (text.length > MAX_EXTRACT_LENGTH) {
+            text = text.slice(0, MAX_EXTRACT_LENGTH) + '\n... (text truncated)';
+        }
+        const title = await this.page.title();
+        const url = this.page.url();
+        return {
+            success: true,
+            output: `Page: ${title} (${url})\n\n${text}`,
+            metadata: { url, title, textLength: text.length },
+        };
+    }
+    async doEvaluate(args) {
+        const script = args.script;
+        if (!script) {
+            return { success: false, output: 'Script is required for evaluate action.' };
+        }
+        const result = await this.page.evaluate(script);
+        const output = result === undefined ? '(undefined)'
+            : result === null ? '(null)'
+                : typeof result === 'object' ? JSON.stringify(result, null, 2)
+                    : String(result);
+        return {
+            success: true,
+            output: `Result: ${output}`,
+            metadata: { result },
+        };
+    }
+    /** Close the browser and release resources. */
+    closeBrowser() {
+        if (!this.browser) {
+            return { success: true, output: 'No browser session to close.' };
+        }
+        try {
+            // Fire-and-forget close — don't await to avoid hanging on already-closed browsers
+            const b = this.browser;
+            this.browser = null;
+            this.page = null;
+            b.close().catch(() => { });
+            return { success: true, output: 'Browser session closed.' };
+        }
+        catch {
+            this.browser = null;
+            this.page = null;
+            return { success: true, output: 'Browser session cleaned up.' };
+        }
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/tools/browser.js.map

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

package/dist/tools/conversation-recall.d.ts

@@ -0,0 +1,43 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+/**
+ * conversation_recall — the recoverability backstop for context compression.
+ *
+ * When a long session crosses the compression threshold, older turns are
+ * replaced in the *working context* by a summary (for speed and cost). The
+ * full transcript is never lost, though — it's the caller's canonical
+ * conversation, which Agent.run receives in full at the start of every turn
+ * and which HistoryManager persists verbatim to ~/.ava/history. This tool lets
+ * Ava read that full transcript on demand.
+ *
+ * The point: an imperfect summary stops being a context-loss bug. Instead of
+ * confabulating or re-asking "what did you want again?", Ava searches the real
+ * record and answers from it. That's the difference between "lossy" (detail
+ * left the working window) and "lost" (detail is unrecoverable).
+ *
+ * Source priority:
+ *   1. sharedState.recallTranscript — the uncompressed turn-start transcript
+ *      the agent stashes each run (freshest, in-process, no IO).
+ *   2. On-disk history by conversationId — fallback for contexts without the
+ *      stash (e.g. spawned sub-agents).
+ */
+export declare class ConversationRecallTool implements Tool {
+    readonly name = "conversation_recall";
+    readonly description: string;
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = false;
+    readonly outputTrust: "trusted";
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    /** Stash first, disk second. Returns null when neither source has anything. */
+    private resolveTranscript;
+    /** True for our own compression/continuation scaffolding messages. */
+    private isMetaInjection;
+    /**
+     * Return a readable window around the first query hit, so a long message
+     * doesn't flood the result. Falls back to the head of the message when no
+     * single term is found inline (e.g. only the whole-phrase scorer fired).
+     */
+    private excerptAround;
+}
+//# sourceMappingURL=conversation-recall.d.ts.map

package/dist/tools/conversation-recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-recall.d.ts","sourceRoot":"","sources":["../../src/tools/conversation-recall.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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,sBAAuB,YAAW,IAAI;IACjD,QAAQ,CAAC,IAAI,yBAAyB;IACtC,QAAQ,CAAC,WAAW,SAI8D;IAClF,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAU;IAC3C,QAAQ,CAAC,oBAAoB,SAAS;IAGtC,QAAQ,CAAC,WAAW,EAAG,SAAS,CAAU;IAE1C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAsB7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAqEhG,+EAA+E;YACjE,iBAAiB;IAmB/B,sEAAsE;IACtE,OAAO,CAAC,eAAe;IAUvB;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAoBtB"}

package/dist/tools/conversation-recall.js

@@ -0,0 +1,177 @@
+import { getTextContent } from '../core/types.js';
+import { HistoryManager } from '../history/history-manager.js';
+/**
+ * conversation_recall — the recoverability backstop for context compression.
+ *
+ * When a long session crosses the compression threshold, older turns are
+ * replaced in the *working context* by a summary (for speed and cost). The
+ * full transcript is never lost, though — it's the caller's canonical
+ * conversation, which Agent.run receives in full at the start of every turn
+ * and which HistoryManager persists verbatim to ~/.ava/history. This tool lets
+ * Ava read that full transcript on demand.
+ *
+ * The point: an imperfect summary stops being a context-loss bug. Instead of
+ * confabulating or re-asking "what did you want again?", Ava searches the real
+ * record and answers from it. That's the difference between "lossy" (detail
+ * left the working window) and "lost" (detail is unrecoverable).
+ *
+ * Source priority:
+ *   1. sharedState.recallTranscript — the uncompressed turn-start transcript
+ *      the agent stashes each run (freshest, in-process, no IO).
+ *   2. On-disk history by conversationId — fallback for contexts without the
+ *      stash (e.g. spawned sub-agents).
+ */
+export class ConversationRecallTool {
+    name = 'conversation_recall';
+    description = 'Search the earlier part of THIS conversation — including turns that were ' +
+        'compressed out of your working context. Use this the moment you are unsure ' +
+        'what the user said earlier, what was decided, or what a value/path/name was, ' +
+        'instead of guessing or asking them to repeat. This reads the real transcript.';
+    riskLevel = 'safe';
+    requiresConfirmation = false;
+    // The conversation is the user's own record (their messages, your replies),
+    // not freshly-fetched third-party content — trusted, like memory_recall.
+    outputTrust = 'trusted';
+    schema = {
+        name: 'conversation_recall',
+        description: 'Search this conversation\'s full transcript (including compressed-away turns) ' +
+            'for what was said earlier. Returns the matching messages with who said them. ' +
+            'Prefer this over asking the user to repeat themselves.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'What to look for — keywords, a topic, a file/value name, or a phrase ' +
+                        'the user used. Matched case-insensitively across earlier messages.',
+                },
+                max_results: {
+                    type: 'number',
+                    description: 'Maximum matching messages to return (default 5).',
+                },
+            },
+            required: ['query'],
+        },
+    };
+    async execute(args, context) {
+        const query = args.query?.trim();
+        const maxResults = Math.max(1, Math.min(20, args.max_results ?? 5));
+        if (!query) {
+            return { success: false, output: 'A query is required — say what to look for.' };
+        }
+        const transcript = await this.resolveTranscript(context);
+        if (!transcript || transcript.length === 0) {
+            return {
+                success: true,
+                output: 'No earlier conversation is available to search — this looks like the start of the session.',
+            };
+        }
+        const terms = query
+            .toLowerCase()
+            .split(/\s+/)
+            .map((t) => t.replace(/[^\w]/g, ''))
+            .filter((t) => t.length > 1);
+        // Score every non-system message by how many query terms it contains.
+        // Position is kept so the model gets a sense of "how far back" a match is.
+        const scored = [];
+        transcript.forEach((m, index) => {
+            if (m.role === 'system')
+                return;
+            const text = getTextContent(m.content);
+            if (!text)
+                return;
+            const lower = text.toLowerCase();
+            // Skip our own synthetic injections (compression headers, task blocks)
+            // so recall returns real conversation, not the scaffolding around it.
+            if (this.isMetaInjection(lower))
+                return;
+            let score = 0;
+            for (const term of terms) {
+                if (lower.includes(term))
+                    score += 1;
+            }
+            // A whole-phrase hit is worth more than scattered term hits.
+            if (terms.length > 1 && lower.includes(query.toLowerCase()))
+                score += terms.length;
+            if (score > 0)
+                scored.push({ index, role: m.role, text, score });
+        });
+        if (scored.length === 0) {
+            return {
+                success: true,
+                output: `Nothing in the earlier conversation matched "${query}". It may not have been discussed, or try different keywords.`,
+            };
+        }
+        // Highest score first; on a tie, the more recent message wins.
+        scored.sort((a, b) => (b.score - a.score) || (b.index - a.index));
+        const top = scored.slice(0, maxResults);
+        const total = transcript.length;
+        const lines = top.map((hit) => {
+            const who = hit.role === 'user' ? 'User' : hit.role === 'assistant' ? 'Ava' : hit.role;
+            const fromEnd = total - hit.index;
+            const excerpt = this.excerptAround(hit.text, terms, query);
+            return `[${who}, ~${fromEnd} message(s) back]\n${excerpt}`;
+        });
+        return {
+            success: true,
+            output: `Found ${scored.length} earlier message(s) matching "${query}" (showing ${top.length}):\n\n${lines.join('\n\n---\n\n')}`,
+            metadata: { matches: scored.length, returned: top.length, query },
+        };
+    }
+    /** Stash first, disk second. Returns null when neither source has anything. */
+    async resolveTranscript(context) {
+        const stashed = context.sharedState?.recallTranscript;
+        if (Array.isArray(stashed) && stashed.length > 0)
+            return stashed;
+        const conversationId = context.conversationId;
+        if (!conversationId)
+            return null;
+        try {
+            // Prefer the surface's account-scoped HistoryManager (extension puts it
+            // in sharedState) so we read the right transcripts; fall back to the
+            // default ~/.ava/history for the CLI / anonymous local use.
+            const hm = context.sharedState?.historyManager ?? new HistoryManager();
+            await hm.init();
+            const record = await hm.resumeConversation(conversationId);
+            return record?.messages ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** True for our own compression/continuation scaffolding messages. */
+    isMetaInjection(lowerText) {
+        return (lowerText.startsWith('[context was compressed') ||
+            lowerText.startsWith('[') && lowerText.includes('earlier messages compressed') ||
+            lowerText.startsWith('[original request at session start]') ||
+            lowerText.startsWith('[system notice]') ||
+            lowerText.startsWith('[resume the task'));
+    }
+    /**
+     * Return a readable window around the first query hit, so a long message
+     * doesn't flood the result. Falls back to the head of the message when no
+     * single term is found inline (e.g. only the whole-phrase scorer fired).
+     */
+    excerptAround(text, terms, query) {
+        const WINDOW = 320;
+        if (text.length <= WINDOW)
+            return text.trim();
+        const lower = text.toLowerCase();
+        let hit = lower.indexOf(query.toLowerCase());
+        if (hit === -1) {
+            for (const term of terms) {
+                hit = lower.indexOf(term);
+                if (hit !== -1)
+                    break;
+            }
+        }
+        if (hit === -1)
+            return text.slice(0, WINDOW).trim() + ' …';
+        const start = Math.max(0, hit - WINDOW / 3);
+        const end = Math.min(text.length, hit + (WINDOW * 2) / 3);
+        const prefix = start > 0 ? '… ' : '';
+        const suffix = end < text.length ? ' …' : '';
+        return prefix + text.slice(start, end).trim() + suffix;
+    }
+}
+//# sourceMappingURL=conversation-recall.js.map

package/dist/tools/conversation-recall.js.map

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

package/dist/tools/creative-asset-sync.d.ts

@@ -0,0 +1,33 @@
+import type { ToolExecutionContext } from './types.js';
+/**
+ * Cloud-sync a creative asset after the generator has written it locally.
+ *
+ * Local-first is sacred: the caller's writeFile always happens first. This
+ * function fires a non-blocking POST to `/api/creative-assets` so the asset
+ * shows up on the Library across the web dashboard and companion when the
+ * user has Data Mode set to Cloud or Both. A failed sync never rolls back
+ * the on-disk copy — disk is the source of truth.
+ *
+ * Gated on two pieces of sharedState wired by the extension host:
+ *   - platformKey          — user is signed in
+ *   - generationLocalOnly  — Data Mode resolved to local (or the user
+ *                            turned off generation sync specifically)
+ *
+ * When either is missing or localOnly is truthy, the push is skipped.
+ * Same pattern used by learning, memory, tasks, journal.
+ *
+ * This helper exists so every generator tool (generate_image / _music /
+ * _video / _voice / remove_background) shares a single upload path — one
+ * place to tune, one place to audit, no four-way drift.
+ */
+export type CreativeAssetKind = 'image' | 'music' | 'video' | 'voice' | 'document' | 'spreadsheet';
+export interface PersistCreativeAssetOptions {
+    assetType: CreativeAssetKind;
+    filename: string;
+    contentType: string;
+    bytes: Uint8Array | Buffer;
+    title?: string;
+    prompt?: string;
+}
+export declare function persistCreativeAsset(context: ToolExecutionContext, opts: PersistCreativeAssetOptions): void;
+//# sourceMappingURL=creative-asset-sync.d.ts.map

package/dist/tools/creative-asset-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-asset-sync.d.ts","sourceRoot":"","sources":["../../src/tools/creative-asset-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;AAEnG,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,iBAAiB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAC7B,IAAI,EAAE,2BAA2B,GAChC,IAAI,CAoCN"}

package/dist/tools/creative-asset-sync.js

@@ -0,0 +1,39 @@
+export function persistCreativeAsset(context, opts) {
+    const shared = context.sharedState ?? {};
+    const platformKey = shared.platformKey;
+    const localOnly = shared.generationLocalOnly;
+    if (!platformKey || localOnly)
+        return;
+    // Fire-and-forget. Any rejection here must not bubble — the tool has
+    // already reported success to the caller via its own return value, and
+    // the local file is on disk. Cloud is additive, not authoritative.
+    void (async () => {
+        try {
+            // Supabase Storage hard-caps uploads at 25 MB via the endpoint.
+            // Large videos above that stay local-only for now; a streaming
+            // upload path is the follow-up for large media.
+            const MAX_BYTES = 25 * 1024 * 1024;
+            if (opts.bytes.length > MAX_BYTES)
+                return;
+            const contentBase64 = Buffer.from(opts.bytes).toString('base64');
+            await fetch('https://avasupernova.com/api/creative-assets', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${platformKey}`,
+                    'X-Ava-Client': shared.clientSurface ?? 'extension',
+                },
+                body: JSON.stringify({
+                    filename: opts.filename,
+                    contentType: opts.contentType,
+                    contentBase64,
+                    assetType: opts.assetType,
+                    title: opts.title ?? opts.filename,
+                    prompt: opts.prompt ?? '',
+                }),
+            });
+        }
+        catch { /* non-critical — local copy is the source of truth */ }
+    })();
+}
+//# sourceMappingURL=creative-asset-sync.js.map

package/dist/tools/creative-asset-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"creative-asset-sync.js","sourceRoot":"","sources":["../../src/tools/creative-asset-sync.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,oBAAoB,CAClC,OAA6B,EAC7B,IAAiC;IAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAiC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,mBAA0C,CAAC;IACpE,IAAI,CAAC,WAAW,IAAI,SAAS;QAAE,OAAO;IAEtC,qEAAqE;IACrE,uEAAuE;IACvE,mEAAmE;IACnE,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,gEAAgE;YAChE,+DAA+D;YAC/D,gDAAgD;YAChD,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;YACnC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS;gBAAE,OAAO;YAE1C,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACjE,MAAM,KAAK,CAAC,8CAA8C,EAAE;gBAC1D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,eAAe,EAAE,UAAU,WAAW,EAAE;oBACxC,cAAc,EAAG,MAAM,CAAC,aAAoC,IAAI,WAAW;iBAC5E;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,aAAa;oBACb,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ;oBAClC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;iBAC1B,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC,CAAC,sDAAsD,CAAC,CAAC;IACpE,CAAC,CAAC,EAAE,CAAC;AACP,CAAC"}