ima2-gen 1.1.18 → 1.1.19

package/README.md

@@ -16,9 +16,9 @@
 
 `ima2-gen` is a local image generation studio for people who want the ChatGPT/Codex image workflow in a small desktop-like web app.
 
-Run it with `npx`, sign in with Codex OAuth, type a prompt, and keep iterating with history, references, node branches, multimode batches, and Canvas Mode cleanup. No OpenAI API key is required for the default path, but API-key generation and bundled Grok generation are also supported when configured.
+Run it with `npx`, sign in with ChatGPT OAuth or Grok OAuth, and start generating images and videos. Iterate with history, references, node branches, multimode batches, Canvas Mode cleanup, and Grok Video generation. No API key required — free ChatGPT OAuth and SuperGrok subscription cover everything.
 
-![ima2-gen classic generation screen with prompt composer, generated image, compact model label, and result metadata.](assets/screenshots/classic-generate-light.png)
+![ima2-gen video playback with gallery sidebar showing generated images and videos.](assets/screenshots/classic-generate-light.png)
 
 ## Quick Start
 

package/bin/commands/video.js

@@ -14,6 +14,7 @@ const SPEC = {
         resolution: { type: "string", default: "480p" },
         "aspect-ratio": { type: "string", default: "auto" },
         model: { type: "string" },
+        topic: { type: "string" },
         ref: { type: "string", repeatable: true },
         out: { short: "o", type: "string" },
         "out-dir": { short: "d", type: "string" },
@@ -34,6 +35,7 @@ const HELP = `
         --resolution <480p|720p>        Default: 480p
         --aspect-ratio <ratio|auto>     1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, auto. Default: auto
         --model <name>                  grok-imagine-video, grok-imagine-video-1.5-preview
+        --topic <text>                  Series topic for prompt chain continuity
         --ref <file>                    Attach source/reference image (repeatable, max 7)
     -o, --out <file>                    Output file path
     -d, --out-dir <dir>                 Output directory
@@ -102,6 +104,8 @@ export default async function videoCmd(argv) {
         body.model = args.model;
     if (args.session)
         body.sessionId = args.session;
+    if (args.topic)
+        body.topic = args.topic;
     if (referenceImages.length === 1) {
         body.sourceImage = referenceImages[0];
     }

package/bin/commands/video.ts

@@ -16,6 +16,7 @@ const SPEC = {
     resolution:    { type: "string", default: "480p" },
     "aspect-ratio": { type: "string", default: "auto" },
     model:         { type: "string" },
+    topic:         { type: "string" },
     ref:           { type: "string", repeatable: true },
     out:           { short: "o", type: "string" },
     "out-dir":     { short: "d", type: "string" },
@@ -37,6 +38,7 @@ const HELP = `
         --resolution <480p|720p>        Default: 480p
         --aspect-ratio <ratio|auto>     1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, auto. Default: auto
         --model <name>                  grok-imagine-video, grok-imagine-video-1.5-preview
+        --topic <text>                  Series topic for prompt chain continuity
         --ref <file>                    Attach source/reference image (repeatable, max 7)
     -o, --out <file>                    Output file path
     -d, --out-dir <dir>                 Output directory
@@ -101,6 +103,7 @@ export default async function videoCmd(argv: string[]) {
   };
   if (args.model) body.model = args.model;
   if (args.session) body.sessionId = args.session;
+  if (args.topic) body.topic = args.topic;
   if (referenceImages.length === 1) {
     body.sourceImage = referenceImages[0];
   } else if (referenceImages.length > 1) {

package/docs/README.ja.md

@@ -8,9 +8,9 @@
 >
 > **他の言語で読む**: [English](../README.md) · [한국어](README.ko.md) · [简体中文](README.zh-CN.md)
 
-`ima2-gen` は、ChatGPT/Codex OAuth の画像生成ワークフローをローカルの小さなデスクトップアプリのように使える画像生成スタジオです。
+`ima2-gen` は、無料の ChatGPT と SuperGrok だけで画像と動画を作れるローカル AI スタジオです。
 
-`npx` で起動し、Codex OAuth でログインして、プロンプトを書きながら履歴や参照画像、ノード分岐、multimode batch、Canvas Mode cleanup を活用して試行錯誤（イテレーション）が可能です。通常の画像生成には OpenAI API key は不要です。
+`npx` で起動し、ChatGPT または Grok OAuth でログインすれば、すぐに画像・動画生成を始められます。API キー不要で、ノード分岐、multimode batch、Grok Video、Canvas Mode まで全機能が使えます。
 
 ![プロンプト入力、生成画像、モデル表示、結果メタデータが見える ima2-gen classic 画面](../assets/screenshots/classic-generate-light.png)
 

package/docs/README.ko.md

@@ -10,9 +10,9 @@
 >
 > **다른 언어로 읽기**: [English](../README.md) · [日本語](README.ja.md) · [简体中文](README.zh-CN.md)
 
-`ima2-gen`은 ChatGPT/Codex OAuth 이미지 생성 흐름을 로컬 웹앱처럼 쓸 수 있게 만든 이미지 생성 스튜디오입니다.
+`ima2-gen`은 무료 ChatGPT와 SuperGrok만으로 이미지와 영상을 만드는 로컬 AI 스튜디오입니다.
 
-`npx`로 실행하고, Codex OAuth로 로그인한 뒤, 프롬프트를 입력하면서 히스토리, 레퍼런스, 노드 브랜치, 멀티모드 배치, Canvas Mode 정리 작업으로 계속 이어갈 수 있습니다. 기본 이미지 생성 경로에서는 OpenAI API 키가 필요하지 않으며, 설정된 경우 OpenAI API-key 경로와 번들 Grok 경로도 사용할 수 있습니다.
+`npx` 한 줄로 실행하고, ChatGPT 또는 Grok OAuth로 로그인하면 바로 시작됩니다. API 키 없이 이미지 생성, 비디오 생성, 노드 분기, 멀티모드 배치, Canvas 정리까지 전부 가능합니다.
 
 ![프롬프트 작성창, 생성 이미지, 모델 표시, 결과 메타데이터가 보이는 ima2-gen 클래식 생성 화면](../assets/screenshots/classic-generate-light.png)
 
@@ -40,12 +40,24 @@ npm install -g ima2-gen
 ima2 serve
 ```
 
+### 설정
+
+`ima2 setup`으로 인증 방식을 선택합니다:
+
+1. **GPT OAuth** — ChatGPT 계정으로 로그인 (무료, 이미지만)
+2. **Grok OAuth** — xAI/Grok 계정으로 로그인 (이미지 + 영상)
+3. **Both** — GPT + Grok 둘 다 (전체 기능)
+4. **API Key** — OpenAI API 키 입력 (유료)
+
+영상 생성은 Grok OAuth(2번 또는 3번)가 필요합니다.
+
 ## 무엇을 할 수 있나요?
 
 - **Classic mode**: 빠르게 이미지를 만들고, 수정하고, 현재 결과를 다시 레퍼런스로 사용합니다.
 - **Node mode**: 마음에 드는 이미지를 여러 방향으로 분기해 실험합니다.
 - **Multimode batches**: 하나의 프롬프트에서 여러 후보 슬롯을 동시에 만들고, 가장 좋은 결과에서 이어갑니다.
 - **Canvas Mode**: 확대/이동, 주석, 지우개, 배경 정리, 투명 체크보드 미리보기, alpha/matte export를 지원합니다.
+- **Video 생성**: 텍스트, 이미지, 또는 여러 레퍼런스에서 짧은 영상을 만듭니다. 기획→제출→진행률→완료까지 실시간으로 보여줍니다.
 - **Local gallery**: 생성물을 내 컴퓨터에 저장하고 세션별 히스토리로 봅니다.
 - **Reference images**: 레퍼런스를 드래그, 붙여넣기, 파일 선택으로 추가합니다. 큰 이미지는 업로드 전에 자동 압축됩니다.
 - **Prompt library imports**: 로컬 prompt pack, GitHub folder, curated GPT-image hint를 내장 prompt library로 가져옵니다.
@@ -62,7 +74,7 @@ ima2 serve
 
 Grok은 Classic, Node, Agent 흐름을 지원합니다. Classic 레퍼런스, Node 부모 이미지, Agent 현재 이미지가 있으면 최종 Grok 호출은 xAI image edit 경로로 전환되어 image-to-image 맥락을 유지합니다. 기본 모델은 `grok-imagine-image`이고, `quality: "high"`에서는 `grok-imagine-image-quality`를 사용합니다.
 
-Grok video 생성(T2V/I2V)은 `1.1.15`에 포함되지 않았습니다. `docs/grok-video-i2v-plan.md`와 `docs/grok-video-i2v-research.md`는 구현 계획과 조사 문서이며, 공개 런타임은 아직 이미지 생성만 지원합니다.
+Grok video 생성(T2V/I2V/ref2v)은 v1.1.16부터 사용 가능합니다. 텍스트 프롬프트, 단일 이미지, 또는 최대 7장의 레퍼런스에서 짧은 영상을 만들 수 있으며, 실시간 진행률 스트리밍을 지원합니다.
 
 설정 화면에 **API key provider available**이나 **Grok provider available**이 보이면 해당 공급자가 감지됐고 생성 요청에 사용할 수 있다는 뜻입니다.
 

package/docs/README.zh-CN.md

@@ -8,9 +8,9 @@
 >
 > **其他语言**: [English](../README.md) · [한국어](README.ko.md) · [日本語](README.ja.md)
 
-`ima2-gen` 是一个本地图像生成工作室，为你提供类似小型桌面应用的 ChatGPT/Codex OAuth 图像生成体验。
+`ima2-gen` 是一个本地 AI 工作室，只需免费 ChatGPT 和 SuperGrok 即可生成图像和视频。
 
-用 `npx` 启动，登录 Codex OAuth，输入 prompt，然后通过历史记录、参考图、节点分支、multimode 批量候选和 Canvas Mode 清理持续迭代。默认图像生成路径不需要 OpenAI API key。
+用 `npx` 启动，通过 ChatGPT 或 Grok OAuth 登录即可开始生成图像和视频。无需 API 密钥，节点分支、multimode 批量、Grok Video、Canvas Mode 全部可用。
 
 ![显示 prompt 输入区、生成图片、模型标签和结果元数据的 ima2-gen classic 界面](../assets/screenshots/classic-generate-light.png)
 

package/lib/agentGenerationPlanner.js

@@ -34,6 +34,19 @@ export function deriveAgentGenerationPlan({ prompt, settings, command = null })
             assistantText: null,
         };
     }
+    if (isVideoIntent(prompt)) {
+        return {
+            mode: "video",
+            prompts: [prompt],
+            requestedVariants: 1,
+            plannedVariants: 1,
+            plannedParallelism: 1,
+            source: "auto-request",
+            reason: "Video generation detected from prompt keywords.",
+            command: command?.name ?? null,
+            assistantText: null,
+        };
+    }
     const variantDecision = decideVariantCount(prompt, settings, command);
     const plannedParallelism = resolvePlannedParallelism(settings, variantDecision.count, command);
     const prompts = buildGenerationPrompts(prompt, variantDecision.count);
@@ -58,7 +71,7 @@ export function normalizeAgentGenerationPlan(prompt, value, settings) {
     const requestedParallelism = cleanCount(input.plannedParallelism, settings.parallelism, 1, HARD_MAX_VARIANTS);
     const plannedParallelism = resolvePlannedParallelism({ ...settings, parallelism: requestedParallelism }, plannedVariants, null);
     return {
-        mode: input.mode === "question" ? "question" : prompts.length > 1 ? "fanout" : "single",
+        mode: input.mode === "question" ? "question" : input.mode === "video" ? "video" : prompts.length > 1 ? "fanout" : "single",
         prompts,
         requestedVariants: cleanCount(input.requestedVariants, plannedVariants, 0, HARD_MAX_VARIANTS),
         plannedVariants,
@@ -183,3 +196,7 @@ function cleanCount(value, fallback, min, max) {
 function clampCount(value, max) {
     return Math.max(1, Math.min(max, Math.round(value)));
 }
+const VIDEO_INTENT_PATTERN = /\b(?:video|animate|animation|동영상|비디오|영상|애니메이트|움직이|클립)\b/iu;
+function isVideoIntent(prompt) {
+    return VIDEO_INTENT_PATTERN.test(prompt);
+}

package/lib/agentGenerationPlanner.ts

@@ -56,6 +56,20 @@ export function deriveAgentGenerationPlan({ prompt, settings, command = null }:
     };
   }
 
+  if (isVideoIntent(prompt)) {
+    return {
+      mode: "video",
+      prompts: [prompt],
+      requestedVariants: 1,
+      plannedVariants: 1,
+      plannedParallelism: 1,
+      source: "auto-request",
+      reason: "Video generation detected from prompt keywords.",
+      command: command?.name ?? null,
+      assistantText: null,
+    };
+  }
+
   const variantDecision = decideVariantCount(prompt, settings, command);
   const plannedParallelism = resolvePlannedParallelism(settings, variantDecision.count, command);
   const prompts = buildGenerationPrompts(prompt, variantDecision.count);
@@ -85,7 +99,7 @@ export function normalizeAgentGenerationPlan(
   const requestedParallelism = cleanCount(input.plannedParallelism, settings.parallelism, 1, HARD_MAX_VARIANTS);
   const plannedParallelism = resolvePlannedParallelism({ ...settings, parallelism: requestedParallelism }, plannedVariants, null);
   return {
-    mode: input.mode === "question" ? "question" : prompts.length > 1 ? "fanout" : "single",
+    mode: input.mode === "question" ? "question" : input.mode === "video" ? "video" : prompts.length > 1 ? "fanout" : "single",
     prompts,
     requestedVariants: cleanCount(input.requestedVariants, plannedVariants, 0, HARD_MAX_VARIANTS),
     plannedVariants,
@@ -227,3 +241,9 @@ function cleanCount(value: unknown, fallback: number, min: number, max: number):
 function clampCount(value: number, max: number): number {
   return Math.max(1, Math.min(max, Math.round(value)));
 }
+
+const VIDEO_INTENT_PATTERN = /\b(?:video|animate|animation|동영상|비디오|영상|애니메이트|움직이|클립)\b/iu;
+
+function isVideoIntent(prompt: string): boolean {
+  return VIDEO_INTENT_PATTERN.test(prompt);
+}

package/lib/agentRuntime.js

@@ -9,6 +9,7 @@ import { detectImageMimeFromB64 } from "./refs.js";
 import { resolveProviderOptions } from "./providerOptions.js";
 import { generateViaResponses } from "./responsesImageAdapter.js";
 import { generateViaGrok } from "./grokImageAdapter.js";
+import { generateVideoViaGrok } from "./grokVideoAdapter.js";
 import { appendAgentTurn, buildImageContextManifest, getAgentImages, getAgentSession, importAgentImage, recordAgentWebFinding, restartAgentRuntimeSession, } from "./agentStore.js";
 import { AGENT_ALLOWED_TOOLS, } from "./agentTypes.js";
 import { errInfo } from "./errInfo.js";
@@ -46,7 +47,7 @@ export async function runAgentGenerationPlan(ctx, sessionId, prompt, plan, optio
     const webSearchEnabled = options.provider === "grok" ? true : options.webSearchEnabled ?? session.webSearchEnabled;
     const enabledTools = webSearchEnabled
         ? [...AGENT_ALLOWED_TOOLS]
-        : ["ima2.get_image_context", "ima2.generate_image"];
+        : ["ima2.get_image_context", "ima2.generate_image", "ima2.generate_video"];
     assertAgentAllowedTools(enabledTools);
     if (behavior.appendUserTurn !== false) {
         appendAgentTurn({ sessionId, role: "user", text: prompt, status: "complete" });
@@ -62,6 +63,13 @@ export async function runAgentGenerationPlan(ctx, sessionId, prompt, plan, optio
         });
         return { assistantTurn, imageIds: [], webFindingIds: [] };
     }
+    if (plan.mode === "video") {
+        return runAgentVideoGeneration(ctx, sessionId, prompt, {
+            ...options,
+            requestId: options.requestId ?? `agent_video_${ulid()}`,
+            skipUserTurn: true,
+        });
+    }
     const manifest = buildImageContextManifest(sessionId);
     const contextStartedAt = Date.now();
     appendAgentTurn({
@@ -306,6 +314,102 @@ async function persistAgentImage(ctx, sessionId, prompt, format, requestId, resp
         createdAt: Date.now(),
     });
 }
+export async function runAgentVideoGeneration(ctx, sessionId, prompt, options = {}) {
+    const session = getAgentSession(sessionId);
+    if (!session)
+        throw notFound(sessionId);
+    if (!options.skipUserTurn) {
+        appendAgentTurn({ sessionId, role: "user", text: prompt, status: "complete" });
+    }
+    const requestId = options.requestId ?? `agent_video_${ulid()}`;
+    const startedAt = Date.now();
+    // Auto I2V: if session has a last image, use it as source
+    let sourceImage;
+    let mode = "text-to-video";
+    if (session.lastImageId) {
+        const images = getAgentImages(sessionId);
+        const lastImage = images.find((img) => img.id === session.lastImageId);
+        if (lastImage?.filename && !lastImage.filename.endsWith(".mp4")) {
+            try {
+                const { loadAssetB64 } = await import("./nodeStore.js");
+                sourceImage = await loadAssetB64(ctx.rootDir, lastImage.filename, ctx.config.storage.generatedDir);
+                mode = "image-to-video";
+            }
+            catch { /* fallback to T2V */ }
+        }
+    }
+    const result = await generateVideoViaGrok(prompt, ctx, {
+        model: "grok-imagine-video",
+        mode,
+        sourceImage,
+        duration: 5,
+        resolution: "480p",
+        aspectRatio: "auto",
+        requestId,
+        signal: options.signal ?? undefined,
+    });
+    const video = await persistAgentVideo(ctx, sessionId, prompt, requestId, result);
+    const finishedAt = Date.now();
+    const toolCall = {
+        id: `tc_video_${ulid()}`,
+        name: "ima2.generate_video",
+        status: "complete",
+        startedAt,
+        finishedAt,
+        durationMs: finishedAt - startedAt,
+        requestId,
+        inputSummary: prompt,
+        outputSummary: `Generated video ${video.filename}.`,
+        imageIds: [video.id],
+    };
+    appendAgentTurn({
+        sessionId,
+        role: "tool",
+        text: "ima2.generate_video",
+        imageIds: [video.id],
+        status: "complete",
+        raw: { toolCalls: [toolCall] },
+    });
+    const assistantTurn = appendAgentTurn({
+        sessionId,
+        role: "assistant",
+        text: `Generated 1 video artifact. ${result.revisedPrompt}`,
+        imageIds: [video.id],
+        status: "complete",
+    });
+    return { assistantTurn, imageIds: [video.id], webFindingIds: [] };
+}
+async function persistAgentVideo(ctx, sessionId, prompt, requestId, result) {
+    await mkdir(ctx.config.storage.generatedDir, { recursive: true });
+    const rand = randomBytes(ctx.config.ids.generatedHexBytes).toString("hex");
+    const filename = `${Date.now()}_${rand}_agent.mp4`;
+    const meta = {
+        kind: "agent",
+        mediaType: "video",
+        requestId,
+        sessionId,
+        prompt,
+        userPrompt: prompt,
+        revisedPrompt: result.revisedPrompt,
+        provider: "grok",
+        model: "grok-imagine-video",
+        createdAt: Date.now(),
+        usage: result.usage,
+        webSearchCalls: result.webSearchCalls,
+    };
+    await writeFile(join(ctx.config.storage.generatedDir, filename), result.videoBuffer);
+    await writeFile(join(ctx.config.storage.generatedDir, `${filename}.json`), JSON.stringify(meta)).catch(() => { });
+    invalidateHistoryIndex();
+    logEvent("agent", "video_saved", { requestId, sessionId, filename });
+    return importAgentImage(sessionId, {
+        id: `ai_${ulid()}`,
+        filename,
+        url: `/generated/${filename}`,
+        prompt,
+        revisedPrompt: result.revisedPrompt,
+        createdAt: Date.now(),
+    });
+}
 function recordSearchFindings(sessionId, prompt, count, provider) {
     if (!count)
         return [];

package/lib/agentRuntime.ts

@@ -9,6 +9,7 @@ import { detectImageMimeFromB64 } from "./refs.js";
 import { resolveProviderOptions } from "./providerOptions.js";
 import { generateViaResponses } from "./responsesImageAdapter.js";
 import { generateViaGrok, type GrokReferenceImage } from "./grokImageAdapter.js";
+import { generateVideoViaGrok } from "./grokVideoAdapter.js";
 import {
   appendAgentTurn,
   buildImageContextManifest,
@@ -95,7 +96,7 @@ export async function runAgentGenerationPlan(
   const webSearchEnabled = options.provider === "grok" ? true : options.webSearchEnabled ?? session.webSearchEnabled;
   const enabledTools: AgentToolName[] = webSearchEnabled
     ? [...AGENT_ALLOWED_TOOLS]
-    : ["ima2.get_image_context", "ima2.generate_image"];
+    : ["ima2.get_image_context", "ima2.generate_image", "ima2.generate_video"];
   assertAgentAllowedTools(enabledTools);
   if (behavior.appendUserTurn !== false) {
     appendAgentTurn({ sessionId, role: "user", text: prompt, status: "complete" });
@@ -111,6 +112,13 @@ export async function runAgentGenerationPlan(
     });
     return { assistantTurn, imageIds: [], webFindingIds: [] };
   }
+  if (plan.mode === "video") {
+    return runAgentVideoGeneration(ctx, sessionId, prompt, {
+      ...options,
+      requestId: options.requestId ?? `agent_video_${ulid()}`,
+      skipUserTurn: true,
+    });
+  }
   const manifest = buildImageContextManifest(sessionId);
   const contextStartedAt = Date.now();
   appendAgentTurn({
@@ -397,6 +405,115 @@ async function persistAgentImage(
   });
 }
 
+export async function runAgentVideoGeneration(
+  ctx: RuntimeContext,
+  sessionId: string,
+  prompt: string,
+  options: AgentRunOptions & { skipUserTurn?: boolean } = {},
+) {
+  const session = getAgentSession(sessionId);
+  if (!session) throw notFound(sessionId);
+  if (!options.skipUserTurn) {
+    appendAgentTurn({ sessionId, role: "user", text: prompt, status: "complete" });
+  }
+  const requestId = options.requestId ?? `agent_video_${ulid()}`;
+  const startedAt = Date.now();
+
+  // Auto I2V: if session has a last image, use it as source
+  let sourceImage: string | undefined;
+  let mode: "text-to-video" | "image-to-video" = "text-to-video";
+  if (session.lastImageId) {
+    const images = getAgentImages(sessionId);
+    const lastImage = images.find((img) => img.id === session.lastImageId);
+    if (lastImage?.filename && !lastImage.filename.endsWith(".mp4")) {
+      try {
+        const { loadAssetB64 } = await import("./nodeStore.js");
+        sourceImage = await loadAssetB64(ctx.rootDir, lastImage.filename, ctx.config.storage.generatedDir);
+        mode = "image-to-video";
+      } catch { /* fallback to T2V */ }
+    }
+  }
+
+  const result = await generateVideoViaGrok(prompt, ctx, {
+    model: "grok-imagine-video",
+    mode,
+    sourceImage,
+    duration: 5,
+    resolution: "480p",
+    aspectRatio: "auto",
+    requestId,
+    signal: options.signal ?? undefined,
+  });
+  const video = await persistAgentVideo(ctx, sessionId, prompt, requestId, result);
+  const finishedAt = Date.now();
+  const toolCall: AgentToolCallSummary = {
+    id: `tc_video_${ulid()}`,
+    name: "ima2.generate_video",
+    status: "complete",
+    startedAt,
+    finishedAt,
+    durationMs: finishedAt - startedAt,
+    requestId,
+    inputSummary: prompt,
+    outputSummary: `Generated video ${video.filename}.`,
+    imageIds: [video.id],
+  };
+  appendAgentTurn({
+    sessionId,
+    role: "tool",
+    text: "ima2.generate_video",
+    imageIds: [video.id],
+    status: "complete",
+    raw: { toolCalls: [toolCall] },
+  });
+  const assistantTurn = appendAgentTurn({
+    sessionId,
+    role: "assistant",
+    text: `Generated 1 video artifact. ${result.revisedPrompt}`,
+    imageIds: [video.id],
+    status: "complete",
+  });
+  return { assistantTurn, imageIds: [video.id], webFindingIds: [] };
+}
+
+async function persistAgentVideo(
+  ctx: RuntimeContext,
+  sessionId: string,
+  prompt: string,
+  requestId: string,
+  result: { videoBuffer: Buffer; revisedPrompt: string; usage: Record<string, number> | null; webSearchCalls: number },
+) {
+  await mkdir(ctx.config.storage.generatedDir, { recursive: true });
+  const rand = randomBytes(ctx.config.ids.generatedHexBytes).toString("hex");
+  const filename = `${Date.now()}_${rand}_agent.mp4`;
+  const meta = {
+    kind: "agent",
+    mediaType: "video",
+    requestId,
+    sessionId,
+    prompt,
+    userPrompt: prompt,
+    revisedPrompt: result.revisedPrompt,
+    provider: "grok",
+    model: "grok-imagine-video",
+    createdAt: Date.now(),
+    usage: result.usage,
+    webSearchCalls: result.webSearchCalls,
+  };
+  await writeFile(join(ctx.config.storage.generatedDir, filename), result.videoBuffer);
+  await writeFile(join(ctx.config.storage.generatedDir, `${filename}.json`), JSON.stringify(meta)).catch(() => {});
+  invalidateHistoryIndex();
+  logEvent("agent", "video_saved", { requestId, sessionId, filename });
+  return importAgentImage(sessionId, {
+    id: `ai_${ulid()}`,
+    filename,
+    url: `/generated/${filename}`,
+    prompt,
+    revisedPrompt: result.revisedPrompt,
+    createdAt: Date.now(),
+  });
+}
+
 function recordSearchFindings(sessionId: string, prompt: string, count: number, provider: string) {
   if (!count) return [];
   const isGrok = provider === "grok";

package/lib/agentTypes.js

@@ -2,4 +2,5 @@ export const AGENT_ALLOWED_TOOLS = [
     "ima2.get_image_context",
     "ima2.web_search",
     "ima2.generate_image",
+    "ima2.generate_video",
 ];

package/lib/agentTypes.ts

@@ -2,6 +2,7 @@ export const AGENT_ALLOWED_TOOLS = [
   "ima2.get_image_context",
   "ima2.web_search",
   "ima2.generate_image",
+  "ima2.generate_video",
 ] as const;
 
 export type AgentToolName = typeof AGENT_ALLOWED_TOOLS[number];
@@ -11,7 +12,7 @@ export type AgentToolCallStatus = "queued" | "running" | "complete" | "error";
 export type AgentQueueStatus = "queued" | "running" | "succeeded" | "failed" | "canceled";
 export type AgentSessionRunStatus = "idle" | "queued" | "running" | "error";
 export type AgentGenerationStrategy = "auto" | "manual";
-export type AgentGenerationPlanMode = "single" | "fanout" | "question";
+export type AgentGenerationPlanMode = "single" | "fanout" | "question" | "video";
 export type AgentGenerationPlanSource = "auto-default" | "auto-request" | "manual-settings" | "slash-command" | "question-command";
 export type AgentSlashCommandName = "question" | "help" | "variants" | "generate" | "parallelism";
 

package/lib/assetLifecycle.js

@@ -1,5 +1,5 @@
 import { getDb } from "./db.js";
-import { rename, unlink, access } from "fs/promises";
+import { mkdir, rename, unlink, access } from "fs/promises";
 import { resolve, sep } from "path";
 import { moveToSystemTrash } from "./systemTrash.js";
 import { config } from "../config.js";
@@ -87,21 +87,25 @@ export async function trashAsset(rootDir, filename) {
         paths.push(sidecar);
     }
     catch { }
+    let trashMethod = "system";
     try {
         await moveToSystemTrash(paths);
     }
-    catch (cause) {
-        const err = new Error("Could not move asset to system trash");
-        err.status = 500;
-        err.code = "SYSTEM_TRASH_FAILED";
-        err.cause = cause;
-        throw err;
+    catch {
+        trashMethod = "internal";
+        const trashDir = resolve(config.storage.trashDir);
+        await mkdir(trashDir, { recursive: true });
+        const trashId = `${Date.now()}_${filename}`;
+        for (const p of paths) {
+            const dest = resolve(trashDir, p.endsWith(".json") ? `${trashId}.json` : trashId);
+            await rename(p, dest);
+        }
     }
     const summary = markNodesAssetMissing(filename);
     return {
         ok: true,
         filename,
-        trash: "system",
+        trash: trashMethod,
         undoableInApp: false,
         sessionsTouched: summary.sessionsTouched,
         nodesTouched: summary.nodesTouched,

package/lib/assetLifecycle.ts

@@ -1,5 +1,5 @@
 import { getDb } from "./db.js";
-import { rename, unlink, access } from "fs/promises";
+import { mkdir, rename, unlink, access } from "fs/promises";
 import { resolve, sep } from "path";
 import { moveToSystemTrash } from "./systemTrash.js";
 import { config } from "../config.js";
@@ -84,21 +84,25 @@ export async function trashAsset(rootDir: string, filename: string) {
     paths.push(sidecar);
   } catch {}
 
+  let trashMethod: "system" | "internal" = "system";
   try {
     await moveToSystemTrash(paths);
-  } catch (cause) {
-    const err: any = new Error("Could not move asset to system trash");
-    err.status = 500;
-    err.code = "SYSTEM_TRASH_FAILED";
-    err.cause = cause;
-    throw err;
+  } catch {
+    trashMethod = "internal";
+    const trashDir = resolve(config.storage.trashDir);
+    await mkdir(trashDir, { recursive: true });
+    const trashId = `${Date.now()}_${filename}`;
+    for (const p of paths) {
+      const dest = resolve(trashDir, p.endsWith(".json") ? `${trashId}.json` : trashId);
+      await rename(p, dest);
+    }
   }
 
   const summary = markNodesAssetMissing(filename);
   return {
     ok: true,
     filename,
-    trash: "system",
+    trash: trashMethod,
     undoableInApp: false,
     sessionsTouched: summary.sessionsTouched,
     nodesTouched: summary.nodesTouched,

package/lib/capabilities.js

@@ -106,7 +106,7 @@ export function buildIma2Capabilities({ appConfig = runtimeConfigDefault, packag
             i2i: "Use --ref for reference generation, or ima2 edit <file> --prompt \"<text>\" for image edits.",
             defaults: "Use ima2 defaults set model/reasoning for persistent defaults; request flags remain per-call overrides.",
             promptBuilder: "Use ima2 prompt build --message \"...\" to refine prompt intent. Use ima2 gen / ima2 multimode to generate images. Workspace profile settings are UI-only.",
-            video: "Use ima2 video \"<prompt>\" to generate video. Supports --ref for image-to-video and reference-to-video modes.",
+            video: "Use ima2 video \"<prompt>\" to generate video. Supports --ref for image-to-video and reference-to-video modes. Use --topic for series continuity across multiple generations.",
         },
     };
 }

package/lib/capabilities.ts

@@ -120,7 +120,7 @@ export function buildIma2Capabilities({
       i2i: "Use --ref for reference generation, or ima2 edit <file> --prompt \"<text>\" for image edits.",
       defaults: "Use ima2 defaults set model/reasoning for persistent defaults; request flags remain per-call overrides.",
       promptBuilder: "Use ima2 prompt build --message \"...\" to refine prompt intent. Use ima2 gen / ima2 multimode to generate images. Workspace profile settings are UI-only.",
-      video: "Use ima2 video \"<prompt>\" to generate video. Supports --ref for image-to-video and reference-to-video modes.",
+      video: "Use ima2 video \"<prompt>\" to generate video. Supports --ref for image-to-video and reference-to-video modes. Use --topic for series continuity across multiple generations.",
     },
   };
 }