@crievo/omni 0.0.0-stage → 0.1.1

package/studio/api/routes/references.ts

@@ -0,0 +1,40 @@
+/* The reference library (ReferencesPage, ReferencePage, ReferenceActions, ReferenceTexts): list,
+   detail, enable, edit a text, delete and the chat with the reference's session. */
+
+import { json } from "../lib/validate";
+import { router } from "../lib/hono";
+import { result, shaped } from "../lib/result";
+import { notFound } from "../lib/errors";
+import {
+  deleteReference,
+  getReference,
+  listReferences,
+  saveReferenceText,
+  setReferenceEnabled,
+} from "../services/references";
+import { chatWith } from "../services/create";
+import { emptyBody, messageBody } from "../../shared/schemas/common";
+import { referenceEnableBody, referenceTextBody } from "../../shared/schemas/references";
+import type { ReferenceDetail, ReferenceSummary } from "../../shared/types/api";
+
+export const references = router()
+  .get("/references", c => {
+    const list = shaped<ReferenceSummary[]>(listReferences());
+    return c.json(list);
+  })
+  .get("/references/:name", c => {
+    const r = shaped<ReferenceDetail | null>(getReference(c.req.param("name")));
+    if (!r) throw notFound();
+    return c.json(r);
+  })
+  .post("/references/:name/enable", json(referenceEnableBody), c =>
+    result(c, setReferenceEnabled(c.req.param("name"), c.req.valid("json").enabled)),
+  )
+  .post("/references/:name/text", json(referenceTextBody), c => {
+    const b = c.req.valid("json");
+    return result(c, saveReferenceText(c.req.param("name"), b.path, b.text));
+  })
+  .post("/references/:name/delete", json(emptyBody), c => result(c, deleteReference(c.req.param("name"))))
+  .post("/references/:name/claude", json(messageBody), c =>
+    result(c, chatWith("reference", c.req.param("name"), c.req.valid("json").message ?? "")),
+  );

package/studio/api/routes/runner.ts

@@ -0,0 +1,17 @@
+/* Whether the studio answering is connected: this one, opened at 127.0.0.1, always is. The hosted
+   studio's hub answers the same path itself (cloud/studio/src/worker.mjs) with online and since, and,
+   while the Mac is away, when it was last connected and what kept it out: what StudioOffline reads. */
+
+import type { RunnerProblem } from "../../shared/types/api";
+import { router } from "../lib/hono";
+
+export const runner = router().get("/runner", c =>
+  c.json({
+    local: true as boolean,
+    online: true as boolean,
+    since: null as string | null,
+    name: null as string | null,
+    last_seen: null as string | null,
+    problem: null as RunnerProblem | null,
+  }),
+);

package/studio/api/routes/schedule.ts

@@ -0,0 +1,47 @@
+/* Scheduled publishing (PublishForm, ScheduledInfo, SchedulePage, settings Publicação): schedule,
+   cancel, reschedule, the schedule list and its launchd agent. Cloud candidate. */
+
+import { json } from "../lib/validate";
+import { router } from "../lib/hono";
+import { result, shaped } from "../lib/result";
+import { videoDir } from "../lib/video";
+import { noTimeout } from "../middleware/no-timeout";
+import {
+  cancelScheduledPublish,
+  getSchedule,
+  reschedulePublish,
+  schedulePublish,
+  setScheduleAgent,
+} from "../services/publish";
+import { refreshStatus } from "../services/videos";
+import { emptyBody, enableBody } from "../../shared/schemas/common";
+import { rescheduleBody, scheduleBody } from "../../shared/schemas/publish";
+import type { Schedule } from "../../shared/types/api";
+
+export const schedule = router()
+  /* writes the text through Claude if the title is missing: seconds */
+  .post("/videos/:slug/publish/schedule", noTimeout, json(scheduleBody), async c => {
+    const slug = c.req.param("slug");
+    const r = await schedulePublish(videoDir(slug), c.req.valid("json"));
+    if (r.ok) await refreshStatus(slug);
+    return result(c, r);
+  })
+  .post("/videos/:slug/publish/schedule/cancel", json(emptyBody), async c => {
+    const slug = c.req.param("slug");
+    const r = await cancelScheduledPublish(videoDir(slug));
+    if (r.ok) await refreshStatus(slug);
+    return result(c, r);
+  })
+  .post("/videos/:slug/publish/schedule/reschedule", json(rescheduleBody), async c => {
+    const slug = c.req.param("slug");
+    const r = await reschedulePublish(videoDir(slug), c.req.valid("json"));
+    if (r.ok) await refreshStatus(slug);
+    return result(c, r);
+  })
+  .get("/publish/schedule", async c => {
+    const s = shaped<Schedule>(await getSchedule());
+    return c.json(s);
+  })
+  .post("/publish/schedule/agent", json(enableBody), async c =>
+    result(c, await setScheduleAgent(c.req.valid("json").enable)),
+  );

package/studio/api/routes/services.ts

@@ -0,0 +1,11 @@
+/* Machine services (ServicesPanel and the voice/clone hints): voices, VoiceStudio, Premiere, memory. */
+
+import { router } from "../lib/hono";
+import { shaped } from "../lib/result";
+import { getServices } from "../services/services";
+import type { Services } from "../../shared/types/api";
+
+export const services = router().get("/services", async c => {
+  const s = shaped<Services>(await getServices());
+  return c.json(s);
+});

package/studio/api/routes/sessions.ts

@@ -0,0 +1,27 @@
+/* Agent sessions (SessionPanel, the side panels): list, detail with the turn history, the live log,
+   reply and stop. */
+
+import { json } from "../lib/validate";
+import { router } from "../lib/hono";
+import { result, shaped } from "../lib/result";
+import { notFound } from "../lib/errors";
+import { noTimeout } from "../middleware/no-timeout";
+import { getSession, listSessions, replyToSession, stopSession, streamSessionLog } from "../services/sessions";
+import { emptyBody, messageBody } from "../../shared/schemas/common";
+import type { Session } from "../../shared/types/api";
+
+export const sessions = router()
+  .get("/sessions", c => {
+    const list = shaped<Session[]>(listSessions());
+    return c.json(list);
+  })
+  .get("/sessions/:id", c => {
+    const s = getSession(c.req.param("id"));
+    if (!s) throw notFound();
+    return c.json(s);
+  })
+  .get("/sessions/:id/log", noTimeout, c => streamSessionLog(c.req.param("id"), c.req.raw))
+  .post("/sessions/:id/reply", json(messageBody), c =>
+    result(c, replyToSession(c.req.param("id"), c.req.valid("json").message ?? "")),
+  )
+  .post("/sessions/:id/stop", json(emptyBody), c => result(c, stopSession(c.req.param("id"))));

package/studio/api/routes/settings.ts

@@ -0,0 +1,102 @@
+/* Settings (SettingsPage, voice components): keys, voice providers and profiles, models, agent accounts,
+   publishing and omnichat options, and the voice samples ("Ouvir voz"). */
+
+import { json } from "../lib/validate";
+import { router } from "../lib/hono";
+import { result, shaped } from "../lib/result";
+import { serveWav } from "../lib/files";
+import { noTimeout } from "../middleware/no-timeout";
+import {
+  getSettings,
+  removeProfile,
+  clearAgentLimit,
+  loginAgent,
+  saveAgents,
+  saveKey,
+  saveModels,
+  saveOmnichatSettings,
+  saveProfile,
+  savePublishSettings,
+  setCartesiaPlan,
+  setDefaultProfile,
+  setDefaultVoice,
+  setFishModel,
+  setFishPrice,
+  setVoiceId,
+  voiceSample,
+} from "../services/settings";
+import { originalRecording } from "../services/clone";
+import { sampleWavFile } from "../services/media";
+import {
+  cartesiaPlanBody,
+  agentIdBody,
+  agentsBody,
+  defaultVoiceBody,
+  fishModelBody,
+  fishPriceBody,
+  keyBody,
+  modelsBody,
+  omnichatSettingsBody,
+  profileIdBody,
+  publishSettingsBody,
+  voiceIdBody,
+  voiceProfileBody,
+  voiceSampleBody,
+} from "../../shared/schemas/settings";
+import type { Settings } from "../../shared/types/api";
+
+export const settings = router()
+  .get("/settings", c => c.json(shaped<Settings>(getSettings())))
+  .post("/settings/key", json(keyBody), c => {
+    const b = c.req.valid("json");
+    return result(c, saveKey(b.name, b.value));
+  })
+  .post("/settings/fish-model", json(fishModelBody), c => {
+    const b = c.req.valid("json");
+    return result(c, setFishModel(b.model, b.fallback ?? null));
+  })
+  .post("/settings/cartesia-plan", json(cartesiaPlanBody), c => {
+    const b = c.req.valid("json");
+    return result(c, setCartesiaPlan(b.plan, b.quota, b.day));
+  })
+  .post("/settings/fish-price", json(fishPriceBody), c => result(c, setFishPrice(c.req.valid("json").value)))
+  .post("/settings/default-voice", json(defaultVoiceBody), c =>
+    result(c, setDefaultVoice(c.req.valid("json").provider)),
+  )
+  .post("/settings/voice-id", json(voiceIdBody), c => {
+    const b = c.req.valid("json");
+    return result(c, setVoiceId(b.provider, b.voice_id));
+  })
+  .post("/settings/voice-profile", json(voiceProfileBody), c => result(c, saveProfile(c.req.valid("json"))))
+  .post("/settings/voice-profile/default", json(profileIdBody), c =>
+    result(c, setDefaultProfile(c.req.valid("json").id)),
+  )
+  .post("/settings/voice-profile/remove", json(profileIdBody), async c =>
+    result(c, await removeProfile(c.req.valid("json").id)),
+  )
+  /* "original": the user's recording; a voice without a recording (Voice ID only) falls back to the
+     main provider's sample */
+  .post("/settings/voice-profile/sample", noTimeout, json(voiceSampleBody), async c => {
+    const b = c.req.valid("json");
+    if (b.provider === "original") {
+      const o = await originalRecording(b.id);
+      if (o.ok) return c.json({ ok: true, output: "gravação original", url: o.url, provider: "original" }, 200);
+      return result(c, await voiceSample(b.id));
+    }
+    return result(c, await voiceSample(b.id, b.provider));
+  })
+  .get("/voice-sample/:file", c => serveWav(sampleWavFile(c.req.param("file"))))
+  .post("/settings/models", json(modelsBody), c => result(c, saveModels(c.req.valid("json"))))
+  .post("/settings/agents", json(agentsBody), c => result(c, saveAgents(c.req.valid("json"))))
+  .post("/settings/agents/login", json(agentIdBody), async c => {
+    const r = await loginAgent(c.req.valid("json").id);
+    return r.ok ? c.json({ ok: true as const, output: r.output, url: r.url ?? null }, 200) : result(c, r);
+  })
+  .post("/settings/agents/clear-limit", json(agentIdBody), c => result(c, clearAgentLimit(c.req.valid("json").id)))
+  .post("/settings/publish", json(publishSettingsBody), c => {
+    const b = c.req.valid("json");
+    return result(c, savePublishSettings(b.section, b.values));
+  })
+  .post("/settings/omnichat", json(omnichatSettingsBody), c =>
+    result(c, saveOmnichatSettings(c.req.valid("json").values)),
+  );

package/studio/api/routes/sound.ts

@@ -0,0 +1,45 @@
+/* Sound timeline (SoundTimeline): data, the draft plan (sound.mjs), save to scenes.json, reassemble
+   and adding an Epidemic effect. */
+
+import { json } from "../lib/validate";
+import { router } from "../lib/hono";
+import { result, shaped } from "../lib/result";
+import { videoDir } from "../lib/video";
+import { captureFromPage, downloadEffect, getSoundData, planDraft, reassemble, saveSound } from "../services/sound";
+import { refreshStatus } from "../services/videos";
+import { emptyBody } from "../../shared/schemas/common";
+import { soundCaptureBody, soundDownloadBody, soundDraftBody } from "../../shared/schemas/sound";
+import type { SoundData } from "../../shared/types/api";
+
+export const sound = router()
+  .get("/videos/:slug/sound", c => {
+    const dir = videoDir(c.req.param("slug"));
+    try {
+      return c.json(shaped<SoundData>(getSoundData(dir)), 200);
+    } catch (e) {
+      return c.json({ error: (e as Error).message }, 400);
+    }
+  })
+  .post("/videos/:slug/sound", json(soundDraftBody), async c => {
+    const slug = c.req.param("slug");
+    const r = saveSound(videoDir(slug), c.req.valid("json"));
+    if (r.ok) await refreshStatus(slug);
+    return result(c, r);
+  })
+  .post("/videos/:slug/sound/plan", json(soundDraftBody), c => {
+    const slug = c.req.param("slug");
+    return result(c, planDraft(slug, videoDir(slug), c.req.valid("json")));
+  })
+  /* adds an Epidemic effect (captured URL) to the video's sound list */
+  .post("/videos/:slug/sound/download", json(soundDownloadBody), async c =>
+    result(c, await downloadEffect(videoDir(c.req.param("slug")), c.req.valid("json"))),
+  )
+  /* adds a track from an Epidemic page: the editor's agent opens it in Chrome and captures the URL */
+  .post("/videos/:slug/sound/capture", json(soundCaptureBody), c => {
+    const slug = c.req.param("slug");
+    videoDir(slug);
+    return result(c, captureFromPage(slug, c.req.valid("json")));
+  })
+  .post("/videos/:slug/sound/reassemble", json(emptyBody), async c =>
+    result(c, await reassemble(videoDir(c.req.param("slug")))),
+  );

package/studio/api/routes/thumbnail.ts

@@ -0,0 +1,18 @@
+/* Thumbnails on request (ThumbnailPanel): ask for versions or a change, choose the cover. */
+
+import { json } from "../lib/validate";
+import { router } from "../lib/hono";
+import { result } from "../lib/result";
+import { videoDir } from "../lib/video";
+import { chooseThumbnail, requestThumbnail } from "../services/thumbnail";
+import { chooseThumbnailBody, thumbnailBody } from "../../shared/schemas/videos";
+
+export const thumbnail = router()
+  .post("/videos/:slug/thumbnail", json(thumbnailBody), c => {
+    const slug = c.req.param("slug");
+    const b = c.req.valid("json");
+    return result(c, requestThumbnail(slug, videoDir(slug), b.mode, b.instruction, b.version));
+  })
+  .post("/videos/:slug/thumbnail/choose", json(chooseThumbnailBody), async c =>
+    result(c, await chooseThumbnail(videoDir(c.req.param("slug")), c.req.valid("json").version)),
+  );

package/studio/api/routes/usage.ts

@@ -0,0 +1,13 @@
+/* Paid voice usage (settings Uso): the summary, and asking the platforms now. */
+
+import { router } from "../lib/hono";
+import { shaped } from "../lib/result";
+import { json } from "../lib/validate";
+import { getUsage } from "../services/usage";
+import { emptyBody } from "../../shared/schemas/common";
+import type { Usage } from "../../shared/types/api";
+
+export const usage = router()
+  .get("/usage", async c => c.json(shaped<Usage>(await getUsage())))
+  /* POST: asks the platforms now, so it goes through the Origin and JSON check */
+  .post("/usage/refresh", json(emptyBody), async c => c.json(shaped<Usage>(await getUsage(true))));

package/studio/api/routes/videos.ts

@@ -0,0 +1,41 @@
+/* Video list and detail (VideosPage, VideoPage), the chat with the video's sessions and the
+   reference swap (SwapReference). */
+
+import { json } from "../lib/validate";
+import { router } from "../lib/hono";
+import { result, shaped } from "../lib/result";
+import { notFound } from "../lib/errors";
+import { videoDir } from "../lib/video";
+import { listVideos, videoDetail } from "../services/videos";
+import { getQueue } from "../services/queue";
+import { chatWith, swapReference } from "../services/create";
+import { messageBody } from "../../shared/schemas/common";
+import { swapReferenceBody } from "../../shared/schemas/videos";
+import type { VideoDetail, VideoSummary } from "../../shared/types/api";
+
+export const videos = router()
+  .get("/videos", async c => {
+    const list = shaped<VideoSummary[]>(await listVideos(getQueue()));
+    return c.json(list);
+  })
+  .get("/videos/:slug", async c => {
+    const d = shaped<VideoDetail | null>(await videoDetail(c.req.param("slug"), getQueue()));
+    if (!d) throw notFound();
+    return c.json(d);
+  })
+  /* swapping the style reference after starting: becomes a request to the video session */
+  .post("/videos/:slug/reference", json(swapReferenceBody), async c => {
+    const b = c.req.valid("json");
+    return result(c, await swapReference(c.req.param("slug"), b.reference, b.note ?? ""));
+  })
+  /* the editor's edit chat (vibe edit): a session of its own, separate from the pipeline's */
+  .post("/videos/:slug/edit/claude", json(messageBody), c => {
+    const slug = c.req.param("slug");
+    videoDir(slug);
+    return result(c, chatWith("edit", slug, c.req.valid("json").message ?? ""));
+  })
+  .post("/videos/:slug/claude", json(messageBody), c => {
+    const slug = c.req.param("slug");
+    videoDir(slug);
+    return result(c, chatWith("video", slug, c.req.valid("json").message ?? ""));
+  });

package/studio/api/routes/voices.ts

@@ -0,0 +1,71 @@
+/* Voice stage (VideoVoicePicker, LineTakes, LineTextEditor, VoicePauseBanner). */
+
+import { json } from "../lib/validate";
+import { router } from "../lib/hono";
+import { result } from "../lib/result";
+import { videoDir } from "../lib/video";
+import { chooseVoice } from "../services/create";
+import { refreshStatus } from "../services/videos";
+import {
+  editLineText,
+  generateAllLines,
+  proceedWithVoices,
+  regenerateAllLines,
+  regenerateLine,
+  removeLine,
+  selectTake,
+} from "../services/voices";
+import { emptyBody } from "../../shared/schemas/common";
+import {
+  chooseVoiceBody,
+  lineTextBody,
+  regenerateLineBody,
+  removeLineBody,
+  useTakeBody,
+} from "../../shared/schemas/voices";
+
+export const voices = router()
+  .post("/videos/:slug/voice", json(chooseVoiceBody), async c => {
+    const slug = c.req.param("slug");
+    const r = chooseVoice(videoDir(slug), c.req.valid("json"));
+    if (r.ok) await refreshStatus(slug);
+    return result(c, r);
+  })
+  .post("/videos/:slug/voice/regenerate", json(regenerateLineBody), async c => {
+    const b = c.req.valid("json");
+    return result(c, await regenerateLine(videoDir(c.req.param("slug")), b.line, b.provider || undefined));
+  })
+  /* "Seguir com estas vozes": lifts the voice-change pause and resumes Claude */
+  .post("/videos/:slug/voice/proceed", json(emptyBody), async c => {
+    const slug = c.req.param("slug");
+    const r = await proceedWithVoices(videoDir(slug), slug);
+    if (r.ok) await refreshStatus(slug);
+    return result(c, r);
+  })
+  .post("/videos/:slug/voice/generate", json(emptyBody), async c =>
+    result(c, await generateAllLines(videoDir(c.req.param("slug")))),
+  )
+  .post("/videos/:slug/voice/regenerate-all", json(emptyBody), async c =>
+    result(c, await regenerateAllLines(videoDir(c.req.param("slug")))),
+  )
+  .post("/videos/:slug/voice/use", json(useTakeBody), async c => {
+    const slug = c.req.param("slug");
+    const b = c.req.valid("json");
+    const r = await selectTake(videoDir(slug), b.line, b.version);
+    if (r.ok) await refreshStatus(slug);
+    return result(c, r);
+  })
+  .post("/videos/:slug/line/text", json(lineTextBody), async c => {
+    const slug = c.req.param("slug");
+    const b = c.req.valid("json");
+    const r = await editLineText(videoDir(slug), slug, b.line, b.text);
+    if (r.ok) await refreshStatus(slug);
+    return result(c, r);
+  })
+  /* takes the line out of the narration and asks Claude to redo from timing on */
+  .post("/videos/:slug/line/remove", json(removeLineBody), async c => {
+    const slug = c.req.param("slug");
+    const r = await removeLine(videoDir(slug), slug, c.req.valid("json").line);
+    await refreshStatus(slug);
+    return result(c, r);
+  });

package/studio/api/services/admin.ts

@@ -0,0 +1,113 @@
+/* The admin panel (/admin): settings that hold for every user of this studio, local or hosted. Today,
+   Omni: on or off, the engine, the voice, the voice model and the cascade's OpenRouter model, all in
+   agent.* of omnivideo.config.json. Changing one tells every open page (the "agent" event), which
+   follows it: a conversation on the old engine, or with Omni switched off, ends.
+
+   Who is admin: whoever uses the studio on this Mac (127.0.0.1) always; through the hosted studio,
+   the signed-in emails in admin.emails. The runner marks what came from the cloud (x-ov-via) and the
+   hub passes the signed-in email (x-ov-user), which a browser can't set (the Worker drops x-ov-*). */
+
+import {
+  FISH_MODELS,
+  FISH_VOICES,
+  GROK_VOICES,
+  OMNI_ENGINES,
+  OMNI_LLMS,
+  type OmniEngine,
+  engineOf,
+} from "../../shared/omni-admin";
+import { agentConfig } from "./agent";
+import { cascadeConfig } from "./agent-cascade";
+import { agentChanged } from "./events";
+import { readConfig, writeConfig } from "./settings";
+
+export type Viewer = { admin: boolean; email: string | null; hosted: boolean };
+
+const adminEmails = (): Set<string> =>
+  new Set(
+    ((readConfig()?.admin?.emails as unknown[] | undefined) ?? [])
+      .filter((e): e is string => typeof e === "string")
+      .map(e => e.trim().toLowerCase()),
+  );
+
+export function viewerOf(req: Request): Viewer {
+  const hosted = req.headers.get("x-ov-via") === "cloud";
+  const email = hosted ? (req.headers.get("x-ov-user")?.trim().toLowerCase() ?? null) || null : null;
+  return { admin: !hosted || (!!email && adminEmails().has(email)), email, hosted };
+}
+
+export type OmniAdmin = {
+  enabled: boolean;
+  engine: OmniEngine;
+  /* Grok's voice (ara, rex) or the cascade's Fish voice id, whichever the engine uses */
+  voice: string;
+  fish_model: string;
+  llm: string;
+};
+
+export function omniAdmin(): OmniAdmin {
+  const a = agentConfig();
+  const c = cascadeConfig();
+  return {
+    enabled: a.enabled,
+    engine: a.engine,
+    voice: a.engine === "grok" ? a.voices[a.gender] : (c.voice ?? c.voices[a.gender]),
+    fish_model: c.fish_model,
+    llm: c.llm,
+  };
+}
+
+type Result = { ok: true; output: string; omni: OmniAdmin } | { ok: false; error: string };
+
+/* one change at a time, from the panel; each field is checked against the lists in shared/omni-admin */
+export function setOmniAdmin(change: Partial<OmniAdmin>): Result {
+  const cfg = readConfig() ?? {};
+  const agent = { ...(cfg.agent ?? {}) };
+  const cascade = { ...(agent.cascade ?? {}) };
+  const said: string[] = [];
+  if (change.enabled !== undefined) {
+    agent.enabled = change.enabled;
+    said.push(change.enabled ? "Omni ligada para todos" : "Omni desligada para todos");
+  }
+  /* the voice belongs to an engine: read it against the engine this change leaves */
+  const engine = change.engine ?? engineOf(agent);
+  if (change.engine !== undefined) {
+    const e = OMNI_ENGINES.find(x => x.id === change.engine);
+    if (!e) return { ok: false, error: "engine desconhecida" };
+    agent.engine = e.id;
+    delete agent.grok;
+    said.push(`engine: ${e.label}`);
+  }
+  if (change.voice !== undefined) {
+    if (engine === "grok") {
+      const v = GROK_VOICES.find(x => x.id === change.voice);
+      if (!v) return { ok: false, error: "voz do Grok desconhecida" };
+      agent.voices = { ...(agent.voices ?? {}), [v.gender]: v.id };
+      agent.gender = v.gender;
+      said.push(`voz: ${v.label}`);
+    } else {
+      const v = FISH_VOICES.find(x => x.id === change.voice);
+      if (!v) return { ok: false, error: "voz da Fish desconhecida" };
+      cascade.voice = v.id;
+      agent.gender = v.gender;
+      said.push(`voz: ${v.label}`);
+    }
+  }
+  if (change.fish_model !== undefined) {
+    const m = FISH_MODELS.find(x => x.id === change.fish_model);
+    if (!m) return { ok: false, error: "modelo de voz desconhecido" };
+    cascade.fish_model = m.id;
+    said.push(`modelo de voz: ${m.label}`);
+  }
+  if (change.llm !== undefined) {
+    const m = OMNI_LLMS.find(x => x.id === change.llm);
+    if (!m) return { ok: false, error: "modelo do OpenRouter desconhecido" };
+    cascade.llm = m.id;
+    said.push(`modelo: ${m.label}`);
+  }
+  if (!said.length) return { ok: false, error: "nada para mudar" };
+  agent.cascade = cascade;
+  writeConfig({ ...cfg, agent });
+  agentChanged();
+  return { ok: true, output: said.join("; "), omni: omniAdmin() };
+}