kasaframe 0.0.0-stage → 0.1.3

package/packages/gen/src/image/codex.ts

@@ -0,0 +1,117 @@
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { join } from "node:path";
+import { KEY_BG } from "../media.ts";
+import type { ImageProvider, ImageRequest, RawResult } from "../types.ts";
+
+// ChatGPT 로그인으로 도는 codex CLI 의 내장 imagegen — API 키·요금 없이 구독 안에서 그린다(한 장 1–2분).
+// kasaterm pane 의 codex 는 pane 전용 홈을 세우는 래퍼라 PATH 에서 그 shim 을 빼고 순정 codex 를 찾는다
+export function codexBin(): string | null {
+  if (process.env.KF_CODEX) return existsSync(process.env.KF_CODEX) ? process.env.KF_CODEX : null;
+  const path = (process.env.PATH ?? "").split(":").filter((p) => !p.includes("kasaterm-shim-")).join(":");
+  const r = spawnSync("sh", ["-c", "command -v codex"], { encoding: "utf8", env: { ...process.env, PATH: path } });
+  const bin = r.stdout?.trim();
+  return r.status === 0 && bin ? bin : null;
+}
+
+export function codexLoggedIn(bin = codexBin()): boolean {
+  if (!bin) return false;
+  const r = spawnSync(bin, ["login", "status"], { encoding: "utf8", timeout: 10_000 });
+  return r.status === 0 && /logged in/i.test(`${r.stdout}${r.stderr}`);
+}
+
+// imagegen 이 받는 세 꼴 — 요청 크기와 비율이 가장 가까운 것으로 그린 뒤 generate.ts 가 잘라 맞춘다
+function orientation(size: string): string {
+  const [w, h] = size.split("x").map(Number);
+  const r = w / h;
+  return r > 1.2 ? "landscape 1536x1024" : r < 0.83 ? "portrait 1024x1536" : "square 1024x1024";
+}
+
+function run(bin: string, args: string[], cwd: string, timeoutMs: number): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const p = spawn(bin, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    const out: Buffer[] = [];
+    p.stdout.on("data", (b: Buffer) => out.push(b));
+    p.stderr.on("data", (b: Buffer) => out.push(b));
+    // codex 가 가끔 멈춘다 — 끊고 실패로 돌린다
+    const timer = setTimeout(() => p.kill("SIGKILL"), timeoutMs);
+    p.on("error", (e) => {
+      clearTimeout(timer);
+      reject(e);
+    });
+    p.on("close", (code) => {
+      clearTimeout(timer);
+      const log = Buffer.concat(out).toString();
+      if (code === 0) resolve(log);
+      else reject(new Error(`codex 실패(${code ?? "시간 초과"}): ${log.trim().split("\n").slice(-4).join(" / ").slice(0, 400)}`));
+    });
+  });
+}
+
+// 저장 지시를 안 따르면 codex 가 늘 쓰는 자리에서 이번에 생긴 그림을 찾는다
+function newestGenerated(since: number): string | null {
+  const root = join(homedir(), ".codex", "generated_images");
+  if (!existsSync(root)) return null;
+  let best: { p: string; t: number } | null = null;
+  const walk = (d: string) => {
+    for (const e of readdirSync(d, { withFileTypes: true })) {
+      const p = join(d, e.name);
+      if (e.isDirectory()) walk(p);
+      else if (/\.png$/i.test(e.name)) {
+        const t = statSync(p).mtimeMs;
+        if (t >= since && (!best || t > best.t)) best = { p, t };
+      }
+    }
+  };
+  walk(root);
+  return (best as { p: string } | null)?.p ?? null;
+}
+
+export function codexImage(): ImageProvider {
+  return {
+    id: "codex-imagegen",
+    kind: "img",
+    model: "codex imagegen (gpt-image, ChatGPT 요금제)",
+    license: "OpenAI 이용약관 — 출력물 권리는 사용자에게, 상업 사용 가능(ChatGPT 요금제 안, 추가 요금 없음)",
+    region: "ChatGPT 로그인(codex CLI) — 한국 사용 가능",
+    keyName: "codex",
+    available: () => codexLoggedIn(),
+    estimateUsd: () => 0,
+
+    async generate(o: ImageRequest): Promise<RawResult> {
+      const bin = codexBin();
+      if (!bin) throw new Error("codex CLI 가 없다 — npm i -g @openai/codex 뒤 codex login(ChatGPT 계정)");
+      const work = mkdtempSync(join(tmpdir(), "kf-codex-img-"));
+      const started = Date.now();
+      try {
+        const keyed = !!o.transparent;
+        const prompt = [
+          `Use $imagegen to create exactly one image, ${orientation(o.size)}, and save it as ./image.png in the current directory.`,
+          o.refs?.length ? "Use the attached image(s) as the reference — keep the same character, shapes and colors." : "",
+          o.prompt,
+          keyed ? KEY_BG : "",
+          "No text, letters, watermarks or logos unless the description above asks for them. Do not ask for confirmation. Do not create any other file.",
+        ].filter(Boolean).join("\n\n");
+        // -i 는 가변 인자라 프롬프트 앞에 두면 프롬프트까지 그림 파일로 먹는다 — 프롬프트 뒤에
+        const args = ["-c", "features.daemon_auto_start=false", "exec", "-s", "workspace-write", "--skip-git-repo-check", "-C", work, prompt];
+        if (o.refs?.length) args.push("-i", ...o.refs);
+        await run(bin, args, work, Number(process.env.KF_CODEX_TIMEOUT_MS ?? 420_000));
+        const file = existsSync(join(work, "image.png")) ? join(work, "image.png") : newestGenerated(started);
+        if (!file) throw new Error("codex 가 그림을 남기지 않았다(./image.png·~/.codex/generated_images 둘 다 없음)");
+        return {
+          bytes: readFileSync(file),
+          ext: "png",
+          model: "codex imagegen",
+          seed: null,
+          costUsd: 0,
+          costEstimated: false,
+          params: { size: orientation(o.size), refs: o.refs?.length ?? 0 },
+          notes: ["codex", ...(keyed ? ["chroma-key"] : [])],
+        };
+      } finally {
+        rmSync(work, { recursive: true, force: true });
+      }
+    },
+  };
+}

package/packages/gen/src/image/og.ts

@@ -0,0 +1,133 @@
+import { readKey } from "../keys.ts";
+import { KEY_BG, refJpeg } from "../media.ts";
+import type { ImageProvider, ImageRequest, RawResult } from "../types.ts";
+
+const HOST = process.env.KF_OG_HOST ?? "https://apis.opengateway.ai";
+
+// 1M 토큰당 달러. OpenAI 단가표(2026-09) — gpt-image-2 와 2.5 둘 다 같은 값이다.
+const PRICE = { textIn: 5, imageIn: 8, imageOut: 30 };
+
+// 2.5 는 background:transparent 를 직접 받는다(2026-10-08 실측, 알파 61%). 나머지는 단색 바탕 + 키잉.
+const TRANSPARENT_OK = /gpt-image-(2\.5|1\.5)/;
+
+export function costFromUsage(usage: any): number | null {
+  if (!usage) return null;
+  const inD = usage.input_tokens_details ?? {};
+  const outD = usage.output_tokens_details ?? {};
+  const imageIn = inD.image_tokens ?? 0;
+  const textIn = inD.text_tokens ?? Math.max(0, (usage.input_tokens ?? 0) - imageIn);
+  const imageOut = outD.image_tokens ?? usage.output_tokens ?? 0;
+  return (textIn * PRICE.textIn + imageIn * PRICE.imageIn + imageOut * PRICE.imageOut) / 1e6;
+}
+
+// gpt-image-2 계열이 받는 크기: 변이 16의 배수, 긴 변 3840 이하, 비율 3:1 이하, 픽셀 655,360..8,294,400.
+export function apiSize(size: string): { w: number; h: number } {
+  const m = /^(\d+)x(\d+)$/.exec(size);
+  if (!m) throw new Error(`크기는 1536x1024 꼴이어야 한다: ${size}`);
+  let w = Number(m[1]);
+  let h = Number(m[2]);
+  const ratio = Math.max(w, h) / Math.min(w, h);
+  if (ratio > 3) throw new Error(`비율 3:1 을 넘는 크기는 못 만든다: ${size}`);
+  const px = w * h;
+  const k = px < 655_360 ? Math.sqrt(655_360 / px) : px > 8_294_400 ? Math.sqrt(8_294_400 / px) : 1;
+  w *= k;
+  h *= k;
+  const longEdge = Math.max(w, h);
+  if (longEdge > 3840) {
+    w *= 3840 / longEdge;
+    h *= 3840 / longEdge;
+  }
+  const r16 = (v: number, up: boolean) => (up ? Math.ceil(v / 16) : Math.floor(v / 16)) * 16;
+  // 키운 쪽은 올림, 줄인 쪽은 내림 — 반올림하면 픽셀 한도를 살짝 넘어 400 이 난다.
+  return { w: r16(w, k >= 1), h: r16(h, k >= 1) };
+}
+
+async function call(path: string, init: RequestInit): Promise<any> {
+  const key = readKey("opengateway");
+  const r = await fetch(HOST + path, {
+    ...init,
+    headers: { Authorization: `Bearer ${key}`, ...(init.headers ?? {}) },
+  });
+  const text = await r.text();
+  if (!r.ok) {
+    // 413 은 본문이 비어 온다 — 상태 코드가 곧 원인이다.
+    const hint = r.status === 413 ? " (업로드가 크다)" : r.status === 402 ? " (OG 잔액 부족 — 충전하면 키가 자동 복구된다)" : "";
+    throw new Error(`OG ${path} ${r.status}${hint}: ${text.slice(0, 300)}`);
+  }
+  return JSON.parse(text);
+}
+
+function toRaw(j: any, model: string, params: Record<string, unknown>): RawResult {
+  const b64 = j.data?.[0]?.b64_json;
+  if (!b64) throw new Error(`OG 응답에 그림이 없다: ${JSON.stringify(j).slice(0, 200)}`);
+  const cost = costFromUsage(j.usage);
+  return {
+    bytes: Buffer.from(b64, "base64"),
+    ext: "png",
+    model,
+    seed: null,
+    costUsd: cost ?? 0,
+    costEstimated: cost === null,
+    params: { ...params, usage: j.usage },
+  };
+}
+
+export function ogImage(model = "openai/gpt-image-2.5-sunburst"): ImageProvider {
+  const nativeAlpha = TRANSPARENT_OK.test(model);
+
+  function body(o: ImageRequest) {
+    const { w, h } = apiSize(o.size);
+    const keyed = o.transparent && !nativeAlpha;
+    return {
+      keyed,
+      fields: {
+        model,
+        prompt: keyed ? `${o.prompt}\n\n${KEY_BG}` : o.prompt,
+        size: `${w}x${h}`,
+        quality: o.quality ?? "high",
+        output_format: "png",
+        n: 1,
+        ...(o.transparent && nativeAlpha ? { background: "transparent" } : {}),
+      },
+    };
+  }
+
+  return {
+    id: `og-${model.replace(/^openai\//, "")}`,
+    kind: "img",
+    model,
+    license: "OpenAI 이용약관 — 출력물 권리는 사용자에게, 상업 사용 가능",
+    region: "OG live(apis.opengateway.ai) 전 세계, 한국 사용 가능",
+    keyName: "opengateway",
+
+    async generate(o) {
+      const { keyed, fields } = body(o);
+      const j = await call("/v1/images/generations", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(fields),
+      });
+      const raw = toRaw(j, model, { ...fields, prompt: undefined });
+      if (keyed) raw.notes = ["chroma-key"];
+      return raw;
+    },
+
+    // 마스크 없는 참조 편집. 참조가 먹었는지는 usage.input_tokens_details.image_tokens 로만 알 수 있다.
+    async edit(o) {
+      if (!o.refs?.length) throw new Error("edit 에는 refs 가 필요하다");
+      const { keyed, fields } = body(o);
+      const form = new FormData();
+      for (const [k, v] of Object.entries(fields)) form.append(k, String(v));
+      const field = o.refs.length > 1 ? "image[]" : "image";
+      for (const [i, ref] of o.refs.entries()) {
+        const jpg = await refJpeg(ref);
+        form.append(field, new Blob([new Uint8Array(jpg)], { type: "image/jpeg" }), `ref${i}.jpg`);
+      }
+      const j = await call("/v1/images/edits", { method: "POST", body: form });
+      const raw = toRaw(j, model, { ...fields, prompt: undefined, refs: o.refs.length });
+      const used = j.usage?.input_tokens_details?.image_tokens ?? 0;
+      raw.notes = [...(keyed ? ["chroma-key"] : []), ...(used > 0 ? [] : ["refs-ignored"])];
+      return raw;
+    },
+  };
+}

package/packages/gen/src/index.ts

@@ -0,0 +1,26 @@
+export type { Asset, AssetKind, AssetMeta, ImageProvider, ImageRequest, ProviderInfo, RawResult, VideoProvider, VideoRequest } from "./types.ts";
+export { findKey, hasKey, howToGet, keyFile, MissingKeyError, readKey, whereToPut } from "./keys.ts";
+export { DEFAULT_IMAGE, imageProviders, pickImage, pickVideo, providerReady, videoProviders } from "./registry.ts";
+export { askTerminal, CAPABILITIES, parseAllow, WAIT, questionsMarkdown, questionsText, settle, type AnswerInput, type Capability, type Choice, type Question, type Settled } from "./ask.ts";
+export { capabilities, type CapabilityProvider, type CapabilityReport } from "./capabilities.ts";
+export { BLENDER_MIN, blenderLibDir, findBlender, hasBlenderLib } from "./blender.ts";
+export { codexBin, codexLoggedIn } from "./image/codex.ts";
+export { H3_RESTRICT } from "./video/h3.ts";
+export {
+  cacheDir,
+  cacheKey,
+  DEFAULT_IMAGE_MAX_USD,
+  DEFAULT_MAX_USD,
+  estimateImageUsd,
+  genImage,
+  genVideo,
+  NeedsApproval,
+  planVideo,
+  type GenContext,
+} from "./generate.ts";
+export { aspectOf, seam, seamFrames, still, type SeamOptions } from "./seam.ts";
+export { genSpecs, referencedIds, resolvePlan, type GenReport, type GenSpec } from "./plan.ts";
+export { retime } from "./media.ts";
+export { cutVoice, duration as audioDuration, findSilences, layVoices, voicedSpan } from "./audio.ts";
+export { alignWords, DEFAULT_STYLE, parseVoice, pickTts, speak, ttsProviders, voiceCapabilities, voiceQuestion, type Speech, type SpeechRequest, type TtsProvider, type Voice, type Word } from "./tts/index.ts";
+export { addToLibrary, byMood, genMusic, listLibrary, MOOD_PROMPT, MOOD_TAGS, musicDir, musicGenCapabilities, musicLength, musicProviders, musicQuestion, pickMusic, type MusicAsset, type MusicProvider, type Track } from "./music/index.ts";

package/packages/gen/src/keys.ts

@@ -0,0 +1,86 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+// 값은 이 모듈 밖으로 헤더에 실릴 때만 나간다. 오류 글에는 어디를 찾았는지만 적는다.
+const SOURCES: Record<string, { env: string[]; files: string[] }> = {
+  opengateway: { env: ["OPENGATEWAY_API_KEY", "OG_API_KEY"], files: ["~/.config/opengateway.key"] },
+  fal: { env: ["FAL_KEY"], files: ["~/.config/fal.key", "~/.secrets/gcp-sm/fal-ai-api-key"] },
+  minimax: { env: ["MINIMAX_API_KEY"], files: ["~/.config/minimax.key"] },
+  gemini: { env: ["GEMINI_API_KEY", "GOOGLE_API_KEY"], files: ["~/.config/gemini.key"] },
+  ltx: { env: ["LTX_API_KEY"], files: ["~/.config/ltx.key"] },
+  h3: { env: ["KF_H3_URL"], files: [] },
+  elevenlabs: { env: ["ELEVENLABS_API_KEY", "XI_API_KEY"], files: ["~/.config/elevenlabs.key"] },
+  dashscope: { env: ["DASHSCOPE_API_KEY"], files: ["~/.config/dashscope.key"] },
+  "qwen3-tts": { env: ["KF_QWEN3_TTS_URL"], files: [] },
+};
+
+// 없는 키를 물을 때 「어디서 받아 어디에 넣나」를 같이 보인다 — 받는 곳은 공급자 콘솔, 넣기는 kf setup key 가 값을 숨겨 받아 파일로
+const HELP: Record<string, { label: string; get: string }> = {
+  opengateway: { label: "OpenGateway 키", get: "OpenGateway 콘솔(opengateway.ai)에서 API 키" },
+  fal: { label: "fal 키", get: "fal.ai/dashboard/keys" },
+  minimax: { label: "MiniMax 키", get: "platform.minimax.io 의 API 키" },
+  gemini: { label: "Gemini 키", get: "aistudio.google.com/apikey" },
+  ltx: { label: "LTX 키", get: "ltx.io 콘솔의 API 키" },
+  h3: { label: "사내 H3 주소", get: "파드 운영자에게 SGLang 주소(닫힌 망이면 터널) — 걸음 수 KF_H3_STEPS(터보 LoRA 9·없으면 50)도 같이" },
+  elevenlabs: { label: "ElevenLabs 키", get: "elevenlabs.io/app/settings/api-keys" },
+  dashscope: { label: "DashScope 키", get: "Alibaba Cloud Model Studio(dashscope) 콘솔의 API 키" },
+  "qwen3-tts": { label: "로컬 Qwen3-TTS 서버 주소", get: "tools/tts 의 서버를 띄운 주소" },
+};
+
+// 주소(h3·로컬 서버)는 비밀이 아니라 환경 변수로, 나머지는 kf setup key 로
+export function howToGet(name: string): string {
+  const h = HELP[name];
+  const env = sources(name).env;
+  const put = name === "h3" || name.endsWith("-tts") ? `${env.join("·")}=<주소>` : `kf setup key ${name}(값을 숨겨 받아 ~/.config/kasaframe/keys/${name} 에) 또는 ${whereToPut(name)}`;
+  return `${h?.label ?? name}: ${h?.get ?? "공급자 콘솔"} → ${put}`;
+}
+
+export const keyFile = (name: string): string => expand(`~/.config/kasaframe/keys/${name}`);
+
+export class MissingKeyError extends Error {
+  keyName: string;
+  constructor(keyName: string) {
+    super(`키 없음: ${keyName} — ${whereToPut(keyName)}`);
+    this.keyName = keyName;
+  }
+}
+
+function expand(p: string): string {
+  return p.startsWith("~/") ? join(homedir(), p.slice(2)) : p;
+}
+
+function sources(name: string): { env: string[]; files: string[] } {
+  const s = SOURCES[name] ?? { env: [], files: [] };
+  return { env: s.env, files: [...s.files, `~/.config/kasaframe/keys/${name}`] };
+}
+
+export function whereToPut(name: string): string {
+  const s = sources(name);
+  return `환경 변수 ${s.env.join("·") || "(없음)"} 또는 파일 ${s.files.join("·")}`;
+}
+
+export function findKey(name: string): string | null {
+  const s = sources(name);
+  for (const e of s.env) {
+    const v = process.env[e]?.trim();
+    if (v) return v;
+  }
+  for (const f of s.files) {
+    const p = expand(f);
+    if (!existsSync(p)) continue;
+    const v = readFileSync(p, "utf8").trim();
+    if (v) return v;
+  }
+  return null;
+}
+
+export function hasKey(name: string): boolean {
+  return findKey(name) !== null;
+}
+
+export function readKey(name: string): string {
+  const v = findKey(name);
+  if (!v) throw new MissingKeyError(name);
+  return v;
+}

package/packages/gen/src/media.ts

@@ -0,0 +1,150 @@
+import { spawn } from "node:child_process";
+import { renameSync } from "node:fs";
+
+export function run(cmd: string, args: string[], input?: Uint8Array): Promise<Buffer> {
+  return new Promise((resolve, reject) => {
+    const p = spawn(cmd, args, { stdio: ["pipe", "pipe", "pipe"] });
+    const out: Buffer[] = [];
+    const err: Buffer[] = [];
+    p.stdout.on("data", (b: Buffer) => out.push(b));
+    p.stderr.on("data", (b: Buffer) => err.push(b));
+    p.on("error", reject);
+    p.on("close", (code) => {
+      if (code === 0) return resolve(Buffer.concat(out));
+      const tail = Buffer.concat(err).toString().trim().split("\n").slice(-4).join("\n");
+      reject(new Error(`${cmd} 실패(${code}): ${tail}`));
+    });
+    if (input) p.stdin.end(input);
+    else p.stdin.end();
+  });
+}
+
+const ff = (args: string[], input?: Uint8Array) => run("ffmpeg", ["-v", "error", "-y", ...args], input);
+
+export interface Probe {
+  width: number;
+  height: number;
+  duration?: number;
+  fps?: number;
+}
+
+export async function probe(path: string): Promise<Probe> {
+  const out = await run("ffprobe", [
+    "-v", "error", "-select_streams", "v:0",
+    "-show_entries", "stream=width,height,r_frame_rate:format=duration",
+    "-of", "json", path,
+  ]);
+  const j = JSON.parse(out.toString());
+  const s = j.streams?.[0] ?? {};
+  const [n, d] = String(s.r_frame_rate ?? "0/1").split("/").map(Number);
+  const duration = Number(j.format?.duration);
+  return {
+    width: s.width,
+    height: s.height,
+    duration: Number.isFinite(duration) ? duration : undefined,
+    fps: d ? n / d : undefined,
+  };
+}
+
+// 64x64 로 줄인 알파에서 거의 투명한 칸의 비율. 0 이면 투명 배경이 안 먹은 것이다.
+export async function transparentRatio(path: string): Promise<number> {
+  const raw = await ff(["-i", path, "-vf", "format=rgba,alphaextract,scale=64:64", "-f", "rawvideo", "-pix_fmt", "gray", "-"]);
+  let n = 0;
+  for (const v of raw) if (v < 250) n++;
+  return raw.length ? n / raw.length : 0;
+}
+
+// chromaKey 와 짝 — 투명 배경을 못 받는 모델에 이 문장을 붙여 그리게 한 뒤 키잉한다.
+export const KEY_BG =
+  "Place the subject on a perfectly flat, uniform pure green (#00FF00) background with no shadow, gradient or texture.";
+
+// ffmpeg 은 읽는 파일에 바로 쓰지 못한다 — 같은 경로면 옆 파일에 쓰고 바꿔 끼운다.
+async function toFile(src: string, dst: string, args: (out: string) => string[]): Promise<void> {
+  const out = src === dst ? dst.replace(/(\.[a-z0-9]+)$/i, ".work$1") : dst;
+  await ff(args(out));
+  if (out !== dst) renameSync(out, dst);
+}
+
+export async function chromaKey(src: string, dst: string, color = "0x00FF00"): Promise<void> {
+  await toFile(src, dst, (out) => ["-i", src, "-vf", `colorkey=${color}:0.28:0.08,despill=type=green,format=rgba`, "-frames:v", "1", out]);
+}
+
+// 참조 그림은 실루엣만 전하면 되고 OG 는 큰 업로드를 413 으로 자른다 — 흰 바탕에 얹은 512px JPEG 로 보낸다.
+export async function refJpeg(src: string, maxEdge = 512): Promise<Buffer> {
+  return ff([
+    "-i", src,
+    "-filter_complex",
+    `[0]format=rgba,scale='min(${maxEdge},iw)':'min(${maxEdge},ih)':force_original_aspect_ratio=decrease[fg];` +
+      `color=white:s=16x16[bg0];[bg0][fg]scale2ref[bg][fg2];[bg][fg2]overlay=format=auto,format=yuvj420p`,
+    "-frames:v", "1", "-q:v", "4", "-f", "image2", "-c:v", "mjpeg", "-",
+  ]);
+}
+
+export async function fitImage(src: string, dst: string, w: number, h: number): Promise<void> {
+  await toFile(src, dst, (out) => [
+    "-i", src,
+    "-vf", `scale=${w}:${h}:force_original_aspect_ratio=increase:flags=lanczos,crop=${w}:${h}`,
+    "-frames:v", "1", out,
+  ]);
+}
+
+// 생성 클립(16·24fps, 5초 남짓)을 장면 틈 길이·프로젝트 fps 에 정확히 맞춘다. 미디어 어댑터는 seek 만 하면 된다.
+// size 를 주면 비율을 무시하고 늘린다 — H3 는 16:9 입력을 1344x768(1.75:1)로 잘라 내지 않고 늘려 받으니,
+// 되늘려야 첫·끝 프레임이 앞뒤 장면과 픽셀 자리까지 겹친다(2026-10-08 실측).
+export async function retime(src: string, dst: string, dur: number, fps: number, o: { smooth?: boolean; size?: { w: number; h: number } } = {}): Promise<void> {
+  const p = await probe(src);
+  if (!p.duration) throw new Error(`길이를 못 읽음: ${src}`);
+  const factor = dur / p.duration;
+  const rate = o.smooth ? `minterpolate=fps=${fps}:mi_mode=mci` : `fps=${fps}`;
+  const scale = o.size && (o.size.w !== p.width || o.size.h !== p.height) ? `,scale=${o.size.w}:${o.size.h}:flags=lanczos,setsar=1` : "";
+  await toFile(src, dst, (out) => [
+    "-i", src, "-an",
+    "-vf", `setpts=${factor.toFixed(6)}*PTS,${rate}${scale}`,
+    "-t", dur.toFixed(4),
+    "-c:v", "libx264", "-pix_fmt", "yuv420p", "-crf", "16", "-preset", "medium", "-movflags", "+faststart",
+    out,
+  ]);
+}
+
+// 모델은 첫 키프레임은 꽉 붙잡지만 끝 키프레임은 몇 픽셀 밀리고 빛이 달라진다(H3 실측 PSNR 37.8 대 24.6 dB).
+// 양 끝 몇 프레임을 진짜 앞뒤 장면 프레임으로 녹여 넘겨 경계 프레임을 픽셀까지 같게 만든다.
+export async function snapEnds(
+  src: string,
+  dst: string,
+  o: { first?: string; last?: string; frames: number; fps: number; dur: number; w: number; h: number },
+): Promise<void> {
+  if (!o.first && !o.last) return;
+  const ramp = Math.max(1, o.frames - 1) / o.fps;
+  const inputs = ["-i", src];
+  const chains: string[] = [];
+  let cur = "[0]";
+  let n = 1;
+  if (o.first) {
+    inputs.push("-loop", "1", "-framerate", String(o.fps), "-t", o.dur.toFixed(4), "-i", o.first);
+    chains.push(`[${n}]scale=${o.w}:${o.h},format=rgba,fade=t=out:st=0:d=${ramp.toFixed(4)}:alpha=1[f]`, `${cur}[f]overlay=eof_action=pass[v${n}]`);
+    cur = `[v${n}]`;
+    n++;
+  }
+  if (o.last) {
+    inputs.push("-loop", "1", "-framerate", String(o.fps), "-t", o.dur.toFixed(4), "-i", o.last);
+    const st = o.dur - 1 / o.fps - ramp;
+    chains.push(`[${n}]scale=${o.w}:${o.h},format=rgba,fade=t=in:st=${st.toFixed(4)}:d=${ramp.toFixed(4)}:alpha=1[l]`, `${cur}[l]overlay=eof_action=pass[v${n}]`);
+    cur = `[v${n}]`;
+  }
+  await toFile(src, dst, (out) => [
+    ...inputs,
+    "-filter_complex", chains.join(";"),
+    "-map", cur, "-r", String(o.fps), "-frames:v", String(Math.round(o.dur * o.fps)),
+    "-c:v", "libx264", "-pix_fmt", "yuv420p", "-crf", "16", "-preset", "medium", "-movflags", "+faststart",
+    out,
+  ]);
+}
+
+export async function dataUri(src: string, maxEdge = 1280): Promise<string> {
+  const jpg = await ff([
+    "-i", src,
+    "-vf", `scale='min(${maxEdge},iw)':'min(${maxEdge},ih)':force_original_aspect_ratio=decrease,format=yuvj420p`,
+    "-frames:v", "1", "-q:v", "3", "-f", "image2", "-c:v", "mjpeg", "-",
+  ]);
+  return `data:image/jpeg;base64,${jpg.toString("base64")}`;
+}

package/packages/gen/src/music/elevenlabs.ts

@@ -0,0 +1,41 @@
+import { hasKey, readKey } from "../keys.ts";
+import type { MusicProvider } from "./types.ts";
+
+// 키가 없어 실호출로 검증하지 못했다 — 모양은 ElevenLabs API 문서(2026-10, music/compose) 그대로. 200 이면 소리 파일 날것이 온다
+const BASE = process.env.KF_ELEVENLABS_BASE ?? "https://api.elevenlabs.io";
+const MODEL = process.env.KF_ELEVENLABS_MUSIC_MODEL ?? "music_v2_5";
+// 1분에 $0.15 (elevenlabs.io/pricing/api)
+const PER_MIN = 0.15;
+
+export function elevenlabsMusic(): MusicProvider {
+  return {
+    id: "elevenlabs-music",
+    label: "Eleven Music",
+    model: MODEL,
+    keyName: "elevenlabs",
+    license: "Eleven Music 약관 — 유료 요금제는 온·오프라인 상업 가능(영화·TV·라디오는 Enterprise Music 만), 무료는 출처 표기·내려받기 불가",
+    region: "전 세계 API(유료 요금제)",
+    verified: false,
+    maxSec: 300,
+    ready: () => hasKey("elevenlabs"),
+    estimateUsd: (sec) => (sec / 60) * PER_MIN,
+
+    async compose(o) {
+      const ms = Math.min(600_000, Math.max(3000, Math.ceil(o.duration * 1000)));
+      const r = await fetch(`${BASE}/v1/music?output_format=mp3_44100_128`, {
+        method: "POST",
+        headers: { "xi-api-key": readKey("elevenlabs"), "Content-Type": "application/json" },
+        body: JSON.stringify({ prompt: o.prompt, music_length_ms: ms, model_id: MODEL, force_instrumental: true }),
+      });
+      if (!r.ok) throw new Error(`Eleven Music ${r.status}: ${(await r.text()).slice(0, 300)}`);
+      return {
+        bytes: new Uint8Array(await r.arrayBuffer()),
+        ext: "mp3",
+        model: MODEL,
+        costUsd: (ms / 60000) * PER_MIN,
+        costEstimated: true,
+        params: { music_length_ms: ms, force_instrumental: true },
+      };
+    },
+  };
+}