ima2-gen 1.1.21 → 1.1.22

package/bin/lib/config-store.ts

@@ -1,120 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
-import { config as runtimeConfig } from "../../config.js";
-import {
-  AUTH_CONFIG_KEYS,
-  KEY_TO_ENV,
-  WRITABLE_CONFIG_KEYS,
-  isSensitiveConfigKey as isSensitiveConfigKeyShared,
-} from "../../lib/configKeys.js";
-
-export { KEY_TO_ENV, WRITABLE_CONFIG_KEYS };
-
-export const CONFIG_FILE = runtimeConfig.storage.configFile;
-export const CONFIG_DIR = runtimeConfig.storage.configDir;
-
-export const AUTH_KEYS = AUTH_CONFIG_KEYS;
-
-export function isAuthConfigKey(key: string): boolean {
-  return AUTH_CONFIG_KEYS.has(key);
-}
-
-export function isWritableConfigKey(key: string): boolean {
-  return WRITABLE_CONFIG_KEYS.has(key);
-}
-
-export function isSensitiveConfigKey(key: string): boolean {
-  return isSensitiveConfigKeyShared(key);
-}
-
-export function redactValue(key: string, value: unknown): unknown {
-  if (isSensitiveConfigKey(key)) return value ? "<redacted>" : value;
-  return value;
-}
-
-export function loadFileCfg(): Record<string, unknown> {
-  if (!existsSync(CONFIG_FILE)) return {};
-  try {
-    return JSON.parse(readFileSync(CONFIG_FILE, "utf-8")) as Record<string, unknown>;
-  } catch {
-    return {};
-  }
-}
-
-export function saveFileCfg(cfg: Record<string, unknown>): void {
-  mkdirSync(CONFIG_DIR, { recursive: true });
-  writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2));
-}
-
-export function getNestedKey(obj: unknown, dotKey: string): unknown {
-  const parts = dotKey.split(".");
-  let cur: unknown = obj;
-  for (const p of parts) {
-    if (cur == null || typeof cur !== "object") return undefined;
-    cur = (cur as Record<string, unknown>)[p];
-  }
-  return cur;
-}
-
-export function setNestedKey(obj: Record<string, unknown>, dotKey: string, value: unknown): void {
-  const parts = dotKey.split(".");
-  let cur: Record<string, unknown> = obj;
-  for (let i = 0; i < parts.length - 1; i++) {
-    const part = parts[i];
-    const next = cur[part];
-    if (next == null || typeof next !== "object" || Array.isArray(next)) cur[part] = {};
-    cur = cur[part] as Record<string, unknown>;
-  }
-  cur[parts[parts.length - 1]] = value;
-}
-
-export function deleteNestedKey(obj: Record<string, unknown>, dotKey: string): boolean {
-  const parts = dotKey.split(".");
-  let cur: unknown = obj;
-  for (let i = 0; i < parts.length - 1; i++) {
-    if (cur == null || typeof cur !== "object") return false;
-    cur = (cur as Record<string, unknown>)[parts[i]];
-  }
-  if (cur == null || typeof cur !== "object") return false;
-  const last = parts[parts.length - 1];
-  if (!(last in cur)) return false;
-  delete (cur as Record<string, unknown>)[last];
-  return true;
-}
-
-export function stripSets(value: unknown): unknown {
-  if (value instanceof Set) return [...value].map(stripSets);
-  if (Array.isArray(value)) return value.map(stripSets);
-  if (value && typeof value === "object") {
-    const result: Record<string, unknown> = {};
-    for (const [key, nested] of Object.entries(value)) result[key] = stripSets(nested);
-    return result;
-  }
-  return value;
-}
-
-export function buildEffectiveConfig(): Record<string, unknown> {
-  return stripSets(runtimeConfig) as Record<string, unknown>;
-}
-
-export function parseConfigValue(rawValue: string): unknown {
-  try {
-    return JSON.parse(rawValue);
-  } catch {
-    return rawValue;
-  }
-}
-
-export function envOverrideForKey(key: string): { envVar: string; value: string } | null {
-  const envVar = KEY_TO_ENV[key];
-  if (!envVar || process.env[envVar] === undefined) return null;
-  return { envVar, value: String(process.env[envVar]) };
-}
-
-export function displayPath(p: string): string {
-  const home = process.env.HOME || "";
-  return home && p.startsWith(home) ? p.replace(home, "~") : p;
-}
-
-export function restartNotice(): string {
-  return "note: server must be restarted to pick up config changes (run `ima2 serve`)";
-}

package/bin/lib/destructive-confirm.ts

@@ -1,19 +0,0 @@
-import { createInterface } from "readline/promises";
-
-export async function confirmDestructiveAction(
-  message: string,
-  yes: boolean,
-): Promise<boolean> {
-  if (yes) return true;
-  if (!process.stdin.isTTY) {
-    throw new Error("destructive action requires --yes in non-interactive mode");
-  }
-
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const ans = await rl.question(`${message} [y/N] `);
-    return ans.trim().toLowerCase().startsWith("y");
-  } finally {
-    rl.close();
-  }
-}

package/bin/lib/doctor-checks.ts

@@ -1,91 +0,0 @@
-import { createRequire } from "module";
-import { createServer } from "net";
-import { existsSync, statSync } from "fs";
-import { join } from "path";
-import { config as runtimeConfig } from "../../config.js";
-import { isSensitiveConfigKey } from "../../lib/configKeys.js";
-
-export type DoctorCheckLine = {
-  kind: "pass" | "fail" | "warn" | "info";
-  text: string;
-};
-
-function hasSensitiveValue(value: unknown, path = ""): boolean {
-  if (!value || typeof value !== "object") return false;
-  for (const [key, nested] of Object.entries(value)) {
-    const nextPath = path ? `${path}.${key}` : key;
-    if (isSensitiveConfigKey(nextPath) && nested) return true;
-    if (hasSensitiveValue(nested, nextPath)) return true;
-  }
-  return false;
-}
-
-async function probePort(host: string, port: number): Promise<boolean> {
-  return new Promise((resolve) => {
-    const server = createServer();
-    server.once("error", () => resolve(false));
-    server.once("listening", () => {
-      server.close(() => resolve(true));
-    });
-    server.listen(port, host);
-  });
-}
-
-function probeBetterSqlite(root: string): DoctorCheckLine {
-  try {
-    const requireFromRoot = createRequire(join(root, "package.json"));
-    const mod = requireFromRoot("better-sqlite3") as { default?: unknown };
-    const Database = (mod.default ?? mod) as new (path: string) => { close: () => void };
-    const db = new Database(":memory:");
-    db.close();
-    return { kind: "pass", text: "better-sqlite3 native binding loads" };
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return { kind: "fail", text: `better-sqlite3 native binding failed: ${message}` };
-  }
-}
-
-function configPermissionLine(configFile: string, fileConfig: unknown): DoctorCheckLine | null {
-  if (process.platform === "win32" || !existsSync(configFile) || !hasSensitiveValue(fileConfig)) {
-    return null;
-  }
-  const mode = statSync(configFile).mode;
-  if ((mode & 0o077) === 0) return null;
-  return {
-    kind: "warn",
-    text: `${configFile} is readable by group/other; consider chmod 600`,
-  };
-}
-
-export async function buildHardeningDoctorLines({
-  root,
-  configFile,
-  fileConfig,
-}: {
-  root: string;
-  configFile: string;
-  fileConfig: unknown;
-}): Promise<DoctorCheckLine[]> {
-  const lines: DoctorCheckLine[] = [];
-  const portAvailable = await probePort(runtimeConfig.server.host, runtimeConfig.server.port);
-  lines.push({
-    kind: "info",
-    text: `Preferred backend port ${runtimeConfig.server.port}: ${portAvailable ? "available" : "in use"}`,
-  });
-  lines.push({
-    kind: "info",
-    text: `Card News: ${runtimeConfig.features.cardNews ? "enabled" : "disabled"}`,
-  });
-
-  const skillPath = join(root, "skills", "ima2", "SKILL.md");
-  lines.push(
-    existsSync(skillPath)
-      ? { kind: "pass", text: `packaged skill found: ${skillPath}` }
-      : { kind: "fail", text: `packaged skill missing: ${skillPath}` },
-  );
-  lines.push(probeBetterSqlite(root));
-
-  const perm = configPermissionLine(configFile, fileConfig);
-  if (perm) lines.push(perm);
-  return lines;
-}

package/bin/lib/error-hints.ts

@@ -1,23 +0,0 @@
-const HINTS: Record<string, string> = {
-  SERVER_UNREACHABLE: "Start `ima2 serve`, or pass `--server <url>`.",
-  APIKEY_DISABLED: "API-key generation is supported in current builds; switch providers or update the configured API key.",
-  IMAGE_MODEL_UNSUPPORTED:
-    "This model is visible but cannot generate images here. Use gpt-5.4 or gpt-5.4-mini.",
-  INVALID_IMAGE_MODEL: "Use one of: gpt-5.5, gpt-5.4, gpt-5.4-mini.",
-  OAUTH_UNAVAILABLE: "GPT OAuth proxy is unavailable. Check `ima2 doctor` and restart `ima2 serve`.",
-  NETWORK_FAILED: "Network/proxy failed. This is not a moderation refusal.",
-  SAFETY_REFUSAL: "The image backend refused this generation.",
-  MODERATION_REFUSED: "The prompt or image was rejected by moderation.",
-  AUTH_CHATGPT_EXPIRED: "Re-run `ima2 setup` (option 1), then restart `ima2 serve`.",
-  REF_TOO_LARGE: "Reference image is too large. Resize/compress it and retry.",
-  REF_NOT_BASE64: "Reference payload is invalid. Use a normal PNG/JPEG/WebP file.",
-};
-
-export function hintForErrorCode(code: string | null | undefined): string | null {
-  return code ? HINTS[code] || null : null;
-}
-
-export function formatErrorWithHint(message: string, code: string | null | undefined): string {
-  const hint = hintForErrorCode(code);
-  return hint ? `${message}\nHint: ${hint}` : message;
-}

package/bin/lib/files.ts

@@ -1,39 +0,0 @@
-import { readFile, writeFile, mkdir } from "node:fs/promises";
-import { dirname, extname } from "node:path";
-
-const MIME: Record<string, string> = {
-  png: "image/png",
-  jpg: "image/jpeg",
-  jpeg: "image/jpeg",
-  webp: "image/webp",
-};
-
-export async function fileToDataUri(path: string): Promise<string> {
-  const b64 = (await readFile(path)).toString("base64");
-  const ext = extname(path).slice(1).toLowerCase();
-  const mime = MIME[ext] || "image/png";
-  return `data:${mime};base64,${b64}`;
-}
-
-export async function dataUriToFile(dataUri: string, outPath: string): Promise<string> {
-  const m = dataUri.match(/^data:([^;]+);base64,(.+)$/);
-  const raw = m ? m[2] : dataUri;
-  await mkdir(dirname(outPath) || ".", { recursive: true });
-  await writeFile(outPath, Buffer.from(raw, "base64"));
-  return outPath;
-}
-
-export function defaultOutName(index: number, total: number, ext = "png"): string {
-  const now = new Date();
-  const pad = (n: number) => String(n).padStart(2, "0");
-  const stamp = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
-  if (total <= 1) return `ima2-${stamp}.${ext}`;
-  return `ima2-${stamp}-${index}.${ext}`;
-}
-
-export async function readStdin() {
-  if (process.stdin.isTTY) return "";
-  const chunks: Buffer[] = [];
-  for await (const c of process.stdin) chunks.push(c as Buffer);
-  return Buffer.concat(chunks).toString("utf-8").trim();
-}

package/bin/lib/output.ts

@@ -1,73 +0,0 @@
-import { formatErrorWithHint } from "./error-hints.js";
-
-const isTty = process.stdout.isTTY && !process.env.NO_COLOR;
-
-export const color = {
-  dim:    (s: unknown) => (isTty ? `\x1b[2m${s}\x1b[0m` : String(s)),
-  bold:   (s: unknown) => (isTty ? `\x1b[1m${s}\x1b[0m` : String(s)),
-  red:    (s: unknown) => (isTty ? `\x1b[31m${s}\x1b[0m` : String(s)),
-  green:  (s: unknown) => (isTty ? `\x1b[32m${s}\x1b[0m` : String(s)),
-  yellow: (s: unknown) => (isTty ? `\x1b[33m${s}\x1b[0m` : String(s)),
-  cyan:   (s: unknown) => (isTty ? `\x1b[36m${s}\x1b[0m` : String(s)),
-};
-
-export function out(msg = "") { process.stdout.write(msg + "\n"); }
-export function err(msg = "") { process.stderr.write(msg + "\n"); }
-
-export function die(code: number, msg?: string): never {
-  if (msg) err(color.red("✗ ") + msg);
-  process.exit(code);
-}
-
-export interface ErrorLike {
-  message?: string;
-  code?: string | null;
-  status?: number;
-  name?: string;
-}
-
-export function dieWithError(e: unknown): never {
-  const err = e as ErrorLike;
-  return die(exitCodeForError(e), formatErrorWithHint(err?.message || String(e), err?.code));
-}
-
-export function json(obj: unknown) {
-  process.stdout.write(JSON.stringify(obj) + "\n");
-}
-
-export interface TableColumn<R = Record<string, unknown>> {
-  key: string;
-  label: string;
-  format?: (value: unknown, row: R) => unknown;
-}
-
-export function table<R extends Record<string, unknown>>(rows: R[], columns: TableColumn<R>[]): void {
-  if (rows.length === 0) return;
-  const widths = columns.map((c) =>
-    Math.max(c.label.length, ...rows.map((r) => {
-      const v = c.format ? c.format(r[c.key], r) : r[c.key];
-      return String(v ?? "").length;
-    })),
-  );
-  const pad = (s: unknown, w: number) => String(s ?? "").padEnd(w);
-  out(color.dim(columns.map((c, i) => pad(c.label, widths[i])).join("  ")));
-  out(color.dim(widths.map((w) => "─".repeat(w)).join("  ")));
-  for (const r of rows) {
-    out(columns.map((c, i) => pad(c.format ? c.format(r[c.key], r) : r[c.key], widths[i])).join("  "));
-  }
-}
-
-export function exitCodeForError(e: unknown): number {
-  const err = e as ErrorLike;
-  if (err?.code === "SERVER_UNREACHABLE") return 3;
-  if (err?.code === "APIKEY_DISABLED") return 4;
-  if (err?.code === "AUTH_CHATGPT_EXPIRED" || err?.code === "OAUTH_UNAVAILABLE") return 4;
-  if (err?.code === "NETWORK_FAILED") return 6;
-  if (err?.code === "REF_TOO_LARGE" || err?.code === "REF_NOT_BASE64") return 5;
-  if (err?.code === "SAFETY_REFUSAL") return 7;
-  if (err?.code === "MODERATION_REFUSED") return 7;
-  if (err?.name === "TimeoutError" || /abort/i.test(err?.message || "")) return 8;
-  if ((err?.status ?? 0) >= 500) return 6;
-  if ((err?.status ?? 0) >= 400) return 5;
-  return 1;
-}

package/bin/lib/platform.ts

@@ -1,99 +0,0 @@
-// Cross-platform helpers (Windows / macOS / Linux / WSL).
-// Keep this file tiny & dependency-free. Node 18+ only.
-
-import { spawn, execSync } from "node:child_process";
-import { readFileSync } from "node:fs";
-
-import { errInfo } from "../../lib/errInfo.js";
-export const isWin = process.platform === "win32";
-export const isMac = process.platform === "darwin";
-export const isLinux = !isWin && !isMac;
-
-let _wslCached: boolean | null = null;
-export function isWsl() {
-  if (_wslCached !== null) return _wslCached;
-  if (!isLinux) return (_wslCached = false);
-  try {
-    _wslCached = readFileSync("/proc/version", "utf-8").toLowerCase().includes("microsoft");
-  } catch {
-    _wslCached = false;
-  }
-  return _wslCached;
-}
-
-export function hasDesktopSession() {
-  return Boolean(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
-}
-
-/**
- * Resolve an executable name that differs between Windows and Unix.
- * On Windows, npm global shims are .cmd files; spawn() without shell:true
- * cannot resolve them and fails with ENOENT.
- */
-export function resolveBin(name: string) {
-  return isWin ? `${name}.cmd` : name;
-}
-
-/**
- * spawn() wrapper that works for npm/npx/any PATH-resolved exe on Windows.
- */
-export function spawnBin(name: string, args: string[], opts: Parameters<typeof spawn>[2] = {}) {
-  if (isWin) {
-    // Node 24 on Windows can throw EINVAL when spawning PATH-resolved .cmd
-    // shims directly with piped stdio. Routing through cmd.exe avoids that.
-    return spawn("cmd.exe", ["/d", "/s", "/c", `${name} ${args.join(" ")}`], {
-      windowsHide: true,
-      ...opts,
-    });
-  }
-  return spawn(resolveBin(name), args, { windowsHide: true, ...opts });
-}
-
-/**
- * Open a URL in the user's default browser.
- * Returns { ok: boolean, error?: string }.
- * Handles WSL (via powershell.exe) and refuses on headless Linux without DISPLAY.
- */
-export function openUrl(url: string): { ok: boolean; error?: string } {
-  try {
-    if (isMac) {
-      execSync(`open ${JSON.stringify(url)}`, { stdio: "ignore" });
-    } else if (isWin) {
-      execSync(`cmd /c start "" ${JSON.stringify(url)}`, { stdio: "ignore" });
-    } else if (isWsl()) {
-      // WSL: hand off to Windows via powershell
-      execSync(`powershell.exe -NoProfile -Command Start-Process ${JSON.stringify(url)}`, { stdio: "ignore" });
-    } else {
-      if (!hasDesktopSession()) {
-        return { ok: false, error: "no desktop session (DISPLAY/WAYLAND_DISPLAY unset)" };
-      }
-      execSync(`xdg-open ${JSON.stringify(url)}`, { stdio: "ignore" });
-    }
-    return { ok: true };
-  } catch (e) {
-    const err = errInfo(e);
-    return { ok: false, error: err.message || String(e) };
-  }
-}
-
-/**
- * Register graceful shutdown handlers.
- * Windows does NOT raise SIGTERM from the OS — SIGINT (Ctrl+C) and SIGBREAK
- * (Ctrl+Break) are the observable signals. We still register SIGTERM so that
- * Node-internal `child.kill("SIGTERM")` calls work in tests.
- */
-export function onShutdown(handler: (signal: NodeJS.Signals) => void) {
-  const signals: NodeJS.Signals[] = isWin
-    ? ["SIGINT", "SIGTERM", "SIGBREAK"]
-    : ["SIGINT", "SIGTERM", "SIGHUP"];
-  for (const sig of signals) {
-    try {
-      process.on(sig, () => {
-        try { handler(sig); } finally { process.exit(0); }
-      });
-    } catch {
-      // Some signals aren't installable on certain platforms; ignore.
-    }
-  }
-}
-

package/bin/lib/recover-output.ts

@@ -1,139 +0,0 @@
-import { copyFile, mkdir } from "node:fs/promises";
-import { join, dirname, basename } from "node:path";
-import { config } from "../../config.js";
-import { request } from "./client.js";
-
-export type RecoverOutputTarget = {
-  explicitOut?: string | null;
-  outDir?: string | null;
-  expectedCount?: number;
-  json?: boolean;
-};
-
-export type RecoverOutputResult = {
-  recovered: boolean;
-  paths: string[];
-  requestId: string;
-  source: "terminal" | "history" | "active" | "none";
-  message?: string;
-};
-
-export function createCliRequestId(prefix = "req_cli"): string {
-  return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
-}
-
-function expectedRecoveryCount(target: RecoverOutputTarget): number {
-  const count = Number.isFinite(target.expectedCount) ? Number(target.expectedCount) : 1;
-  return Math.max(1, Math.min(500, count));
-}
-
-function filenamesFromMeta(meta: unknown): string[] {
-  if (!meta || typeof meta !== "object") return [];
-  const record = meta as Record<string, unknown>;
-  if (Array.isArray(record.filenames)) {
-    return record.filenames.filter((name): name is string => typeof name === "string" && name.length > 0);
-  }
-  if (typeof record.filename === "string" && record.filename.length > 0) return [record.filename];
-  return [];
-}
-
-async function copyFilesToTarget(
-  filenames: string[],
-  target: RecoverOutputTarget,
-  generatedDir: string,
-): Promise<string[]> {
-  const saved: string[] = [];
-  for (let i = 0; i < filenames.length; i++) {
-    const name = basename(filenames[i]);
-    const src = join(generatedDir, name);
-    let dest: string;
-    if (target.explicitOut && i === 0) {
-      dest = target.explicitOut;
-    } else if (target.outDir) {
-      dest = join(target.outDir, name);
-    } else {
-      saved.push(src);
-      continue;
-    }
-    await mkdir(dirname(dest), { recursive: true });
-    await copyFile(src, dest);
-    saved.push(dest);
-  }
-  return saved;
-}
-
-async function tryTerminalRecovery(
-  base: string,
-  requestId: string,
-  target: RecoverOutputTarget,
-): Promise<RecoverOutputResult | null> {
-  const inflight = await request(base, "/api/inflight?includeTerminal=1");
-  const jobs = Array.isArray(inflight.jobs) ? (inflight.jobs as any[]) : [];
-  const terminalJobs = Array.isArray(inflight.terminalJobs) ? (inflight.terminalJobs as any[]) : [];
-
-  const activeMatch = jobs.find((j) => j.requestId === requestId);
-  if (activeMatch) {
-    return {
-      recovered: false,
-      paths: [],
-      requestId,
-      source: "active",
-      message: `Generation in progress (requestId: ${requestId}). Check: ima2 ps --json`,
-    };
-  }
-
-  const termMatch = terminalJobs.find((j) => j.requestId === requestId);
-  if (!termMatch) return null;
-
-  const filenames = filenamesFromMeta(termMatch.meta);
-  if (filenames.length === 0) return null;
-
-  const paths = await copyFilesToTarget(filenames, target, config.storage.generatedDir);
-  return { recovered: paths.length > 0, paths, requestId, source: "terminal" };
-}
-
-async function tryHistoryRecovery(
-  base: string,
-  requestId: string,
-  target: RecoverOutputTarget,
-): Promise<RecoverOutputResult | null> {
-  const limit = expectedRecoveryCount(target);
-  const hist = await request(base, `/api/history?limit=${limit}&requestId=${encodeURIComponent(requestId)}`);
-  const items = Array.isArray(hist.items) ? (hist.items as any[]) : [];
-  const filenames = items
-    .filter((it) => it.requestId === requestId && typeof it.filename === "string")
-    .map((it) => String(it.filename))
-    .slice(0, limit);
-  if (filenames.length === 0) return null;
-
-  const paths = await copyFilesToTarget(filenames, target, config.storage.generatedDir);
-  return { recovered: paths.length > 0, paths, requestId, source: "history" };
-}
-
-export async function recoverGeneratedOutputs(
-  base: string,
-  requestId: string,
-  target: RecoverOutputTarget,
-): Promise<RecoverOutputResult> {
-  try {
-    const result = await tryTerminalRecovery(base, requestId, target);
-    if (result) return result;
-  } catch {}
-
-  try {
-    const result = await tryHistoryRecovery(base, requestId, target);
-    if (result) return result;
-  } catch {}
-
-  return { recovered: false, paths: [], requestId, source: "none" };
-}
-
-export function formatRecoveryHint(result: RecoverOutputResult): string {
-  if (result.source === "active") {
-    return result.message ?? `Generation in progress (requestId: ${result.requestId})`;
-  }
-  if (result.recovered) {
-    return `Recovered ${result.paths.length} file(s) via ${result.source} (requestId: ${result.requestId})`;
-  }
-  return `Could not recover output (requestId: ${result.requestId}). Check ${config.storage.generatedDir}/`;
-}

package/bin/lib/sse.ts

@@ -1,73 +0,0 @@
-// SSE consumer for CLI streaming endpoints. Plain fetch + line-based parser, no external libs.
-
-let CLI_VERSION = "0.0.0";
-export function setCliVersion(v: string) { CLI_VERSION = v; }
-
-export type SseEvent = { event: string; data: any };
-
-export interface SseInit {
-  method?: string;
-  body?: any;
-  headers?: Record<string, string>;
-  signal?: AbortSignal;
-}
-
-/**
- * Stream events from an SSE endpoint, yielding parsed events as `{ event, data }`.
- * - method defaults to "POST"
- * - JSON body is auto-stringified
- * - sets `Accept: text/event-stream` and `Content-Type: application/json` automatically
- * - parses chunk boundaries; partial events at EOF are dropped (not yielded)
- * - aborts cleanly on AbortSignal
- */
-export async function* streamSse(url: string, init: SseInit = {}): AsyncGenerator<SseEvent> {
-  const headers: Record<string, string> = {
-    Accept: "text/event-stream",
-    "Content-Type": "application/json",
-    "X-ima2-client": `cli/${CLI_VERSION}`,
-    ...(init.headers || {}),
-  };
-  const res = await fetch(url, {
-    method: init.method || "POST",
-    headers,
-    body: init.body !== undefined ? JSON.stringify(init.body) : undefined,
-    signal: init.signal,
-  });
-  if (!res.ok) {
-    const text = await res.text().catch(() => "");
-    let parsed: any = null;
-    try { parsed = JSON.parse(text); } catch {}
-    const err: any = new Error(parsed?.error || `SSE failed: HTTP ${res.status}`);
-    err.status = res.status;
-    err.code = parsed?.code || null;
-    throw err;
-  }
-  if (!res.body) return;
-
-  const decoder = new TextDecoder();
-  let buf = "";
-  for await (const chunk of res.body as any) {
-    buf += decoder.decode(chunk, { stream: true });
-    let idx;
-    while ((idx = buf.indexOf("\n\n")) !== -1) {
-      const frame = buf.slice(0, idx);
-      buf = buf.slice(idx + 2);
-      const ev = parseFrame(frame);
-      if (ev) yield ev;
-    }
-  }
-}
-
-function parseFrame(frame: string): SseEvent | null {
-  let event = "message";
-  const dataLines: string[] = [];
-  for (const line of frame.split(/\r?\n/)) {
-    if (line.startsWith(":")) continue;
-    if (line.startsWith("event:")) event = line.slice(6).trim();
-    else if (line.startsWith("data:")) dataLines.push(line.slice(5).replace(/^\s/, ""));
-  }
-  if (dataLines.length === 0) return null;
-  const raw = dataLines.join("\n");
-  try { return { event, data: JSON.parse(raw) }; }
-  catch { return { event, data: raw }; }
-}