@project-ava-supernova/core 0.2.71

package/dist/tools/generate-video.d.ts

@@ -0,0 +1,21 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class GenerateVideoTool implements Tool {
+    readonly name = "generate_video";
+    readonly description = "Generate a short AI video with synced audio from a text prompt using Wan 2.5.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    /**
+     * Poll the platform's async video status route until the job finishes.
+     * Runs in the core process (CLI / extension host) with no serverless
+     * timeout, on a 5s cadence with an ~8-minute ceiling. Transient poll
+     * failures are tolerated — only an explicit `failed` status or the
+     * timeout ends the loop.
+     */
+    private pollVideoStatus;
+    private downloadVideo;
+    private resolveKey;
+}
+//# sourceMappingURL=generate-video.d.ts.map

package/dist/tools/generate-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-video.d.ts","sourceRoot":"","sources":["../../src/tools/generate-video.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAgB5D,qBAAa,iBAAkB,YAAW,IAAI;IAC5C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,mFAAmF;IACvG,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAI5C,QAAQ,CAAC,oBAAoB,QAAQ;IAErC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAgC7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAmGhG;;;;;;OAMG;YACW,eAAe;YA6Bf,aAAa;IAW3B,OAAO,CAAC,UAAU;CAQnB"}

package/dist/tools/generate-video.js

@@ -0,0 +1,197 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { persistCreativeAsset } from './creative-asset-sync.js';
+import { join, dirname } from 'node:path';
+import { startGenerationTracking } from '../dataset/generation-emit.js';
+import { chargeCredits } from '../billing/meter.js';
+/**
+ * Generate a short AI video (with synchronized audio) from a text prompt
+ * using Wan 2.5 on the Ava platform.
+ *
+ * Supports 5-second and 10-second clips at 720P. The platform submit
+ * endpoint is async — it returns a task_id and the clip is produced over
+ * the next 1–6 minutes — so this tool submits, then polls the status
+ * route until the job reaches a terminal state.
+ */
+const PLATFORM_URL = 'https://avasupernova.com/api';
+export class GenerateVideoTool {
+    name = 'generate_video';
+    description = 'Generate a short AI video with synced audio from a text prompt using Wan 2.5.';
+    riskLevel = 'write';
+    // Media generation costs credits — confirm before running so Ava never
+    // spends the user's balance without an explicit yes (palette click or
+    // chat confirmation).
+    requiresConfirmation = true;
+    schema = {
+        name: 'generate_video',
+        description: 'Generate a short AI video with synchronized audio (5s or 10s) from a prompt and save to project.',
+        parameters: {
+            type: 'object',
+            properties: {
+                prompt: {
+                    type: 'string',
+                    description: 'Video description — scene, style, mood, action',
+                },
+                filename: {
+                    type: 'string',
+                    description: 'Output filename without extension (e.g. "intro-clip")',
+                },
+                duration: {
+                    type: 'number',
+                    enum: [5, 10],
+                    description: 'Duration in seconds. 5 or 10, with synchronized audio. Default: 5.',
+                },
+                resolution: {
+                    type: 'string',
+                    enum: ['720P', '1080P'],
+                    description: 'Output resolution. 720P (default) or 1080P (~2× the credit cost).',
+                },
+                target_path: {
+                    type: 'string',
+                    description: 'Exact path relative to project root for the video. Overrides default .ava/creative/video/ folder.',
+                },
+            },
+            required: ['prompt', 'filename'],
+        },
+    };
+    async execute(args, context) {
+        const prompt = args.prompt;
+        const filename = args.filename.replace(/\.\w+$/, '');
+        const duration = args.duration === 10 ? 10 : 5;
+        const resolution = args.resolution === '1080P' ? '1080P' : '720P';
+        const targetPath = args.target_path;
+        const genManager = context.sharedState?.generationManager;
+        const jobId = `vid-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+        const defaultPath = `.ava/creative/video/${filename}.mp4`;
+        genManager?.create({ id: jobId, type: 'video', prompt, filename, targetPath: targetPath || defaultPath });
+        const resolved = this.resolveKey(context);
+        if (!resolved) {
+            genManager?.fail(jobId, 'No API key');
+            return {
+                success: false,
+                output: 'Video generation requires an Ava platform account.',
+            };
+        }
+        genManager?.update(jobId, { status: 'generating', progress: 10 });
+        context.onOutput?.('Generating video (this may take a few minutes)...\n');
+        const tracker = startGenerationTracking({
+            type: 'video',
+            model: 'wan2.5-t2v-preview',
+            prompt,
+            paramsSummary: `duration=${duration}s, resolution=${resolution}`,
+        });
+        try {
+            // Submit the async job — the platform returns a task_id immediately.
+            const submitRes = await fetch(`${PLATFORM_URL}/generate-video`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${resolved.key}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ prompt, duration, resolution }),
+            });
+            if (!submitRes.ok) {
+                const errText = await submitRes.text();
+                throw new Error(`Video generation API error (${submitRes.status}): ${errText}`);
+            }
+            const submitData = await submitRes.json();
+            if (submitData.error)
+                throw new Error(submitData.error);
+            // Poll the status route until the clip is ready (Wan runs 1–6 min).
+            // A synchronous `url` (legacy path) is honoured if ever present.
+            let videoUrl = submitData.url;
+            if (!videoUrl && submitData.task_id) {
+                videoUrl = await this.pollVideoStatus(submitData.task_id, resolved.key, genManager, jobId, context);
+            }
+            if (!videoUrl)
+                throw new Error('No video URL returned from API');
+            // Download video buffer
+            genManager?.update(jobId, { status: 'downloading', progress: 70 });
+            const videoBuffer = await this.downloadVideo(videoUrl);
+            // Save to project — use target_path if provided
+            const relativePath = targetPath || `.ava/creative/video/${filename}.mp4`;
+            const savePath = join(context.cwd, relativePath);
+            await mkdir(dirname(savePath), { recursive: true });
+            await writeFile(savePath, videoBuffer);
+            const sizeMb = (videoBuffer.length / (1024 * 1024)).toFixed(1);
+            context.onOutput?.(`Video saved: ${relativePath} (${sizeMb} MB)\n`);
+            const meta = { path: relativePath, absolutePath: savePath, size: videoBuffer.length, duration, resolution, prompt };
+            genManager?.complete(jobId, meta);
+            tracker.complete({ fileSizeBytes: videoBuffer.length });
+            persistCreativeAsset(context, {
+                assetType: 'video',
+                filename: relativePath.split(/[\\/]/).pop() || 'video.mp4',
+                contentType: 'video/mp4',
+                bytes: videoBuffer,
+                title: prompt.slice(0, 100),
+                prompt,
+            });
+            chargeCredits('video_gen');
+            return {
+                success: true,
+                output: `Generated ${duration}s ${resolution} video and saved to ${relativePath}`,
+                metadata: meta,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            genManager?.fail(jobId, message);
+            tracker.fail(message);
+            return { success: false, output: `Video generation failed: ${message}` };
+        }
+    }
+    /**
+     * Poll the platform's async video status route until the job finishes.
+     * Runs in the core process (CLI / extension host) with no serverless
+     * timeout, on a 5s cadence with an ~8-minute ceiling. Transient poll
+     * failures are tolerated — only an explicit `failed` status or the
+     * timeout ends the loop.
+     */
+    async pollVideoStatus(taskId, key, genManager, jobId, context) {
+        const statusUrl = `${PLATFORM_URL}/generate-video/status/${encodeURIComponent(taskId)}`;
+        const intervalMs = 5000;
+        const maxAttempts = 96; // ~8 min ceiling — well past a typical Wan clip
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            await new Promise(r => setTimeout(r, intervalMs));
+            let data;
+            try {
+                const res = await fetch(statusUrl, { headers: { 'Authorization': `Bearer ${key}` } });
+                if (!res.ok)
+                    continue; // transient — keep polling
+                data = await res.json();
+            }
+            catch {
+                continue; // network blip — keep polling until the ceiling
+            }
+            if (data?.status === 'success' && data?.url)
+                return data.url;
+            if (data?.status === 'failed')
+                throw new Error(data?.error || 'Video generation failed');
+            // status === 'processing' — surface progress and keep going
+            genManager?.update(jobId, { status: 'generating', progress: Math.min(60, 10 + attempt * 3) });
+            context.onOutput?.('.');
+        }
+        throw new Error('Video generation timed out');
+    }
+    async downloadVideo(url) {
+        if (url.startsWith('data:')) {
+            const base64 = url.split(',')[1];
+            if (!base64)
+                throw new Error('Invalid data URI');
+            return Buffer.from(base64, 'base64');
+        }
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Failed to download video (${res.status})`);
+        return Buffer.from(await res.arrayBuffer());
+    }
+    resolveKey(context) {
+        // Video runs on Wan 2.5 via the platform route, which uses the server's
+        // DashScope key — so this is platform-only (no provider BYOK path).
+        const state = context.sharedState;
+        const platformKey = state?.platformKey;
+        if (platformKey)
+            return { key: platformKey, via: 'platform' };
+        return null;
+    }
+}
+//# sourceMappingURL=generate-video.js.map

package/dist/tools/generate-video.js.map

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

package/dist/tools/generate-voice.d.ts

@@ -0,0 +1,13 @@
+import type { Tool, ToolResult, ToolExecutionContext, ToolRiskLevel } from './types.js';
+import type { FunctionSchema } from '../providers/types.js';
+export declare class GenerateVoiceTool implements Tool {
+    readonly name = "generate_voice";
+    readonly description = "Generate AI voice/speech from text via Qwen3-TTS.";
+    readonly riskLevel: ToolRiskLevel;
+    readonly requiresConfirmation = true;
+    readonly schema: FunctionSchema;
+    execute(args: Record<string, unknown>, context: ToolExecutionContext): Promise<ToolResult>;
+    private downloadAudio;
+    private resolveKey;
+}
+//# sourceMappingURL=generate-voice.d.ts.map

package/dist/tools/generate-voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-voice.d.ts","sourceRoot":"","sources":["../../src/tools/generate-voice.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAa5D,qBAAa,iBAAkB,YAAW,IAAI;IAC5C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,uDAAuD;IAC3E,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAW;IAI5C,QAAQ,CAAC,oBAAoB,QAAQ;IAErC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAiC7B;IAEI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;YA4FlF,aAAa;IAW3B,OAAO,CAAC,UAAU;CASnB"}

package/dist/tools/generate-voice.js

@@ -0,0 +1,156 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { persistCreativeAsset } from './creative-asset-sync.js';
+import { join, dirname } from 'node:path';
+import { startGenerationTracking } from '../dataset/generation-emit.js';
+import { chargeCredits } from '../billing/meter.js';
+/**
+ * Generate AI voice/speech from text via Qwen3-TTS.
+ *
+ * You author the script and the delivery; pick a voice from the roster and set
+ * the spoken language. Routes through the Ava platform API.
+ */
+const PLATFORM_URL = 'https://avasupernova.com/api';
+export class GenerateVoiceTool {
+    name = 'generate_voice';
+    description = 'Generate AI voice/speech from text via Qwen3-TTS.';
+    riskLevel = 'write';
+    // Media generation costs credits — confirm before running so Ava never
+    // spends the user's balance without an explicit yes (palette click or
+    // chat confirmation).
+    requiresConfirmation = true;
+    schema = {
+        name: 'generate_voice',
+        description: 'Generate AI voice/speech from text and save to project. Pick a voice from the roster; set the spoken language and delivery instructions.',
+        parameters: {
+            type: 'object',
+            properties: {
+                text: {
+                    type: 'string',
+                    description: 'The exact words to speak, verbatim.',
+                },
+                filename: {
+                    type: 'string',
+                    description: 'Output filename without extension (e.g. "intro-narration")',
+                },
+                voice: {
+                    type: 'string',
+                    enum: ['Cherry', 'Serena', 'Vivian', 'Maia', 'Bellona', 'Ethan', 'Moon', 'Vincent', 'Neil', 'Kai'],
+                    description: 'Voice from the Qwen3-TTS roster. Default: Cherry.',
+                },
+                language: {
+                    type: 'string',
+                    description: 'The spoken language (e.g. "English", "French", "Japanese"). Default "English". To voice a translated read, translate the text yourself and set this — the same voice speaks it.',
+                },
+                instructions: {
+                    type: 'string',
+                    description: 'Delivery direction: tone, pace, emotion, energy (e.g. "warm, unhurried, reassuring"). There is no numeric speed knob — shape the read here.',
+                },
+            },
+            required: ['text', 'filename'],
+        },
+    };
+    async execute(args, context) {
+        const text = args.text;
+        const filename = args.filename.replace(/\.\w+$/, '');
+        const voice = args.voice || 'Cherry';
+        const language = args.language || 'English';
+        const instructions = args.instructions || undefined;
+        const targetPath = args.target_path;
+        const genManager = context.sharedState?.generationManager;
+        const jobId = `vox-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+        const defaultPath = `.ava/creative/voice/${filename}.mp3`;
+        genManager?.create({ id: jobId, type: 'voice', prompt: text.slice(0, 100), filename, targetPath: targetPath || defaultPath });
+        const resolved = this.resolveKey(context);
+        if (!resolved) {
+            genManager?.fail(jobId, 'No API key');
+            return {
+                success: false,
+                output: 'Voice generation requires a Qwen API key (BYOK) or platform account.',
+            };
+        }
+        genManager?.update(jobId, { status: 'generating', progress: 10 });
+        context.onOutput?.('Generating voice...\n');
+        const tracker = startGenerationTracking({
+            type: 'voice',
+            model: 'qwen3-tts',
+            prompt: text,
+            paramsSummary: `voice=${voice}, language=${language}`,
+        });
+        try {
+            const res = await fetch(`${PLATFORM_URL}/generate-voice`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Bearer ${resolved.key}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ text, voice, language_type: language, instructions }),
+            });
+            if (!res.ok) {
+                const errText = await res.text();
+                throw new Error(`Voice generation API error (${res.status}): ${errText}`);
+            }
+            const data = await res.json();
+            if (data.error)
+                throw new Error(data.error);
+            if (!data.url)
+                throw new Error('No audio URL returned from API');
+            // Download audio buffer
+            genManager?.update(jobId, { status: 'downloading', progress: 70 });
+            const audioBuffer = await this.downloadAudio(data.url);
+            // Save to project — use target_path if provided
+            const relativePath = targetPath || defaultPath;
+            const savePath = join(context.cwd, relativePath);
+            await mkdir(dirname(savePath), { recursive: true });
+            await writeFile(savePath, audioBuffer);
+            const sizeKb = (audioBuffer.length / 1024).toFixed(1);
+            context.onOutput?.(`Voice saved: ${relativePath} (${sizeKb} KB)\n`);
+            const meta = { path: relativePath, absolutePath: savePath, size: audioBuffer.length, voice, language, textLength: text.length };
+            genManager?.complete(jobId, meta);
+            tracker.complete({ fileSizeBytes: audioBuffer.length });
+            persistCreativeAsset(context, {
+                assetType: 'voice',
+                filename: relativePath.split(/[\\/]/).pop() || 'voice.mp3',
+                contentType: 'audio/mpeg',
+                bytes: audioBuffer,
+                title: text.slice(0, 100),
+                prompt: text,
+            });
+            chargeCredits('voice_gen');
+            return {
+                success: true,
+                output: `Generated voice and saved to ${relativePath}`,
+                metadata: meta,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            genManager?.fail(jobId, message);
+            tracker.fail(message);
+            return { success: false, output: `Voice generation failed: ${message}` };
+        }
+    }
+    async downloadAudio(url) {
+        if (url.startsWith('data:')) {
+            const base64 = url.split(',')[1];
+            if (!base64)
+                throw new Error('Invalid data URI');
+            return Buffer.from(base64, 'base64');
+        }
+        const res = await fetch(url);
+        if (!res.ok)
+            throw new Error(`Failed to download audio (${res.status})`);
+        return Buffer.from(await res.arrayBuffer());
+    }
+    resolveKey(context) {
+        const state = context.sharedState;
+        const getKey = state?.getProviderKey;
+        const qwenKey = getKey?.('qwen');
+        if (qwenKey)
+            return { key: qwenKey, via: 'qwen' };
+        const platformKey = state?.platformKey;
+        if (platformKey)
+            return { key: platformKey, via: 'platform' };
+        return null;
+    }
+}
+//# sourceMappingURL=generate-voice.js.map

package/dist/tools/generate-voice.js.map

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

package/dist/tools/generation-manager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * GenerationManager — tracks creative generation jobs across the session.
+ *
+ * Jobs persist in memory on the extension/IDE host so they survive
+ * page navigation. State is written to ~/.ava/generation-jobs.json
+ * so in-flight jobs can be recovered after a restart.
+ *
+ * The generation tools register their jobs here before starting work.
+ * The extension/IDE reads active jobs to show global progress.
+ */
+export type GenerationType = 'image' | 'video' | 'music' | 'voice' | 'background-removal';
+export type GenerationStatus = 'queued' | 'generating' | 'downloading' | 'complete' | 'failed';
+export interface GenerationJob {
+    id: string;
+    type: GenerationType;
+    status: GenerationStatus;
+    prompt: string;
+    filename: string;
+    targetPath: string;
+    progress: number;
+    startedAt: string;
+    completedAt?: string;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+export type GenerationEventHandler = (jobs: GenerationJob[]) => void;
+export declare class GenerationManager {
+    private jobs;
+    private listeners;
+    private saveTimer;
+    /**
+     * Register a new generation job. Call this before starting the API request.
+     */
+    create(job: Omit<GenerationJob, 'status' | 'progress' | 'startedAt'>): GenerationJob;
+    /**
+     * Update a job's status and progress.
+     */
+    update(id: string, patch: Partial<Pick<GenerationJob, 'status' | 'progress' | 'error' | 'completedAt' | 'metadata'>>): void;
+    /**
+     * Mark a job as complete with final metadata.
+     */
+    complete(id: string, metadata?: Record<string, unknown>): void;
+    /**
+     * Mark a job as failed.
+     */
+    fail(id: string, error: string): void;
+    /**
+     * Get all active (non-complete, non-failed) jobs.
+     */
+    getActive(): GenerationJob[];
+    /**
+     * Get all jobs (including completed).
+     */
+    getAll(): GenerationJob[];
+    /**
+     * Get a specific job by ID.
+     */
+    get(id: string): GenerationJob | undefined;
+    /**
+     * Clear completed/failed jobs older than the given age (default 1 hour).
+     */
+    cleanup(maxAgeMs?: number): void;
+    /**
+     * Subscribe to job updates. Returns an unsubscribe function.
+     */
+    onUpdate(handler: GenerationEventHandler): () => void;
+    /**
+     * Load persisted jobs from disk (call on startup).
+     */
+    load(): Promise<void>;
+    private emit;
+    private debounceSave;
+    private save;
+}
+//# sourceMappingURL=generation-manager.d.ts.map

package/dist/tools/generation-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-manager.d.ts","sourceRoot":"","sources":["../../src/tools/generation-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,oBAAoB,CAAC;AAE1F,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE/F,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;AAMrE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,SAAS,CAA8C;IAE/D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,aAAa;IAapF;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC,CAAC,GAAG,IAAI;IAW3H;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,SAAS,IAAI,aAAa,EAAE;IAI5B;;OAEG;IACH,MAAM,IAAI,aAAa,EAAE;IAMzB;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C;;OAEG;IACH,OAAO,CAAC,QAAQ,SAAW,GAAG,IAAI;IAalC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAKrD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,YAAY;YAKN,IAAI;CASnB"}

package/dist/tools/generation-manager.js

@@ -0,0 +1,150 @@
+/**
+ * GenerationManager — tracks creative generation jobs across the session.
+ *
+ * Jobs persist in memory on the extension/IDE host so they survive
+ * page navigation. State is written to ~/.ava/generation-jobs.json
+ * so in-flight jobs can be recovered after a restart.
+ *
+ * The generation tools register their jobs here before starting work.
+ * The extension/IDE reads active jobs to show global progress.
+ */
+import { join } from 'node:path';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { AVA_HOME } from '../core/constants.js';
+import { logger } from '../core/logger.js';
+// ─── Manager ────────────────────────────────────────────────────────────────
+const JOBS_PATH = join(AVA_HOME, 'generation-jobs.json');
+export class GenerationManager {
+    jobs = new Map();
+    listeners = new Set();
+    saveTimer = null;
+    /**
+     * Register a new generation job. Call this before starting the API request.
+     */
+    create(job) {
+        const full = {
+            ...job,
+            status: 'queued',
+            progress: 0,
+            startedAt: new Date().toISOString(),
+        };
+        this.jobs.set(job.id, full);
+        this.emit();
+        this.debounceSave();
+        return full;
+    }
+    /**
+     * Update a job's status and progress.
+     */
+    update(id, patch) {
+        const job = this.jobs.get(id);
+        if (!job)
+            return;
+        Object.assign(job, patch);
+        if (patch.status === 'complete' || patch.status === 'failed') {
+            job.completedAt = job.completedAt || new Date().toISOString();
+        }
+        this.emit();
+        this.debounceSave();
+    }
+    /**
+     * Mark a job as complete with final metadata.
+     */
+    complete(id, metadata) {
+        this.update(id, { status: 'complete', progress: 100, metadata, completedAt: new Date().toISOString() });
+    }
+    /**
+     * Mark a job as failed.
+     */
+    fail(id, error) {
+        this.update(id, { status: 'failed', error });
+    }
+    /**
+     * Get all active (non-complete, non-failed) jobs.
+     */
+    getActive() {
+        return Array.from(this.jobs.values()).filter(j => j.status !== 'complete' && j.status !== 'failed');
+    }
+    /**
+     * Get all jobs (including completed).
+     */
+    getAll() {
+        return Array.from(this.jobs.values()).sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime());
+    }
+    /**
+     * Get a specific job by ID.
+     */
+    get(id) {
+        return this.jobs.get(id);
+    }
+    /**
+     * Clear completed/failed jobs older than the given age (default 1 hour).
+     */
+    cleanup(maxAgeMs = 3600_000) {
+        const now = Date.now();
+        for (const [id, job] of this.jobs) {
+            if ((job.status === 'complete' || job.status === 'failed') && job.completedAt) {
+                if (now - new Date(job.completedAt).getTime() > maxAgeMs) {
+                    this.jobs.delete(id);
+                }
+            }
+        }
+        this.emit();
+        this.debounceSave();
+    }
+    /**
+     * Subscribe to job updates. Returns an unsubscribe function.
+     */
+    onUpdate(handler) {
+        this.listeners.add(handler);
+        return () => this.listeners.delete(handler);
+    }
+    /**
+     * Load persisted jobs from disk (call on startup).
+     */
+    async load() {
+        try {
+            const raw = await readFile(JOBS_PATH, 'utf-8');
+            const saved = JSON.parse(raw);
+            for (const job of saved) {
+                // Mark any previously-active jobs as failed (they didn't survive the restart)
+                if (job.status === 'queued' || job.status === 'generating' || job.status === 'downloading') {
+                    job.status = 'failed';
+                    job.error = 'Interrupted — application restarted during generation.';
+                    job.completedAt = new Date().toISOString();
+                }
+                this.jobs.set(job.id, job);
+            }
+            logger.debug(`[generation] Loaded ${saved.length} jobs from disk`);
+        }
+        catch {
+            // No saved jobs — fresh start
+        }
+    }
+    // ─── Internal ────────────────────────────────────────────────────────────
+    emit() {
+        const all = this.getAll();
+        for (const listener of this.listeners) {
+            try {
+                listener(all);
+            }
+            catch { /* non-fatal */ }
+        }
+    }
+    debounceSave() {
+        if (this.saveTimer)
+            clearTimeout(this.saveTimer);
+        this.saveTimer = setTimeout(() => this.save(), 1000);
+    }
+    async save() {
+        try {
+            await mkdir(AVA_HOME, { recursive: true });
+            const data = JSON.stringify(this.getAll(), null, 2);
+            await writeFile(JOBS_PATH, data, 'utf-8');
+        }
+        catch (err) {
+            logger.debug(`[generation] Failed to save jobs: ${err}`);
+        }
+    }
+}
+//# sourceMappingURL=generation-manager.js.map