omnius 1.0.19 → 1.0.21

package/dist/index.js

@@ -15546,8 +15546,8 @@ function deleteCustomToolDefinition(name10, scope, repoRoot) {
   const dir = scope === "project" && repoRoot ? projectToolsDir(repoRoot) : globalToolsDir();
   const filePath = join24(dir, `${name10}.json`);
   if (existsSync19(filePath)) {
-    const { unlinkSync: unlinkSync25 } = __require("node:fs");
-    unlinkSync25(filePath);
+    const { unlinkSync: unlinkSync26 } = __require("node:fs");
+    unlinkSync26(filePath);
     return true;
   }
   return false;
@@ -25254,7 +25254,7 @@ function ecdsa(Point, hash, ecdsaOpts = {}) {
     bits2int_modN: "function"
   });
   ecdsaOpts = Object.assign({}, ecdsaOpts);
-  const randomBytes25 = ecdsaOpts.randomBytes || randomBytes7;
+  const randomBytes26 = ecdsaOpts.randomBytes || randomBytes7;
   const hmac2 = ecdsaOpts.hmac || ((key, msg) => hmac(hash, key, msg));
   const { Fp, Fn } = Point;
   const { ORDER: CURVE_ORDER, BITS: fnBits } = Fn;
@@ -25396,7 +25396,7 @@ function ecdsa(Point, hash, ecdsaOpts = {}) {
       throw new Error("invalid private key");
     const seedArgs = [int2octets(d2), int2octets(h1int)];
     if (extraEntropy != null && extraEntropy !== false) {
-      const e2 = extraEntropy === true ? randomBytes25(lengths.secretKey) : extraEntropy;
+      const e2 = extraEntropy === true ? randomBytes26(lengths.secretKey) : extraEntropy;
       seedArgs.push(abytes(e2, void 0, "extraEntropy"));
     }
     const seed = concatBytes(...seedArgs);
@@ -61906,9 +61906,9 @@ var init_cookies = __esm({
 
 // ../node_modules/@libp2p/http-peer-id-auth/dist/src/utils.js
 function generateChallenge() {
-  const randomBytes25 = new Uint8Array(32);
-  crypto.getRandomValues(randomBytes25);
-  return toString2(randomBytes25, "base64urlpad");
+  const randomBytes26 = new Uint8Array(32);
+  crypto.getRandomValues(randomBytes26);
+  return toString2(randomBytes26, "base64urlpad");
 }
 function encodeAuthParams(params) {
   const encodedParams = Object.entries(params).map(([key, value2]) => `${key}="${value2}"`).join(", ");
@@ -234104,7 +234104,7 @@ var require_websocket2 = __commonJS({
     var http6 = __require("http");
     var net5 = __require("net");
     var tls2 = __require("tls");
-    var { randomBytes: randomBytes25, createHash: createHash24 } = __require("crypto");
+    var { randomBytes: randomBytes26, createHash: createHash24 } = __require("crypto");
     var { Duplex: Duplex3, Readable } = __require("stream");
     var { URL: URL3 } = __require("url");
     var PerMessageDeflate3 = require_permessage_deflate2();
@@ -234634,7 +234634,7 @@ var require_websocket2 = __commonJS({
         }
       }
       const defaultPort = isSecure ? 443 : 80;
-      const key = randomBytes25(16).toString("base64");
+      const key = randomBytes26(16).toString("base64");
       const request = isSecure ? https4.request : http6.request;
       const protocolSet = /* @__PURE__ */ new Set();
       let perMessageDeflate;
@@ -250375,6 +250375,22 @@ function optionalNumberArg(value2) {
   const n2 = Number(value2);
   return Number.isFinite(n2) ? n2 : void 0;
 }
+function booleanArg(value2, fallback) {
+  if (typeof value2 === "boolean")
+    return value2;
+  if (typeof value2 === "string") {
+    if (/^(1|true|yes|on)$/i.test(value2.trim()))
+      return true;
+    if (/^(0|false|no|off)$/i.test(value2.trim()))
+      return false;
+  }
+  return fallback;
+}
+function generationFallbackEnabled(args) {
+  if (booleanArg(args["strict_model"] ?? args["strictModel"] ?? args["strict"], false))
+    return false;
+  return booleanArg(args["fallback"] ?? args["allow_fallback"] ?? args["allowFallback"], true);
+}
 function isBackend(value2) {
   return value2 === "auto" || value2 === "ollama" || value2 === "diffusers" || value2 === "sdcpp";
 }
@@ -250383,6 +250399,9 @@ function getImageGenerationPreset(model) {
     return void 0;
   return IMAGE_GENERATION_MODEL_PRESETS.find((preset) => preset.id === model);
 }
+function imageGenerationQualityLadder() {
+  return IMAGE_GENERATION_QUALITY_LADDER.map((id) => getImageGenerationPreset(id)).filter((preset) => Boolean(preset));
+}
 function inferImageGenerationBackend(model, requested) {
   if (requested && isBackend(requested))
     return requested;
@@ -250399,6 +250418,40 @@ function inferImageGenerationBackend(model, requested) {
     return "sdcpp";
   return "diffusers";
 }
+function imageCandidateFor(model, requestedBackend) {
+  let backend = inferImageGenerationBackend(model, requestedBackend);
+  if (backend === "auto")
+    backend = "diffusers";
+  return {
+    model,
+    backend,
+    preset: getImageGenerationPreset(model)
+  };
+}
+function imageGenerationFallbackCandidates(requestedModel, requestedBackend, allowFallback = true) {
+  const ladder = imageGenerationQualityLadder();
+  const candidates = [];
+  const add2 = (candidate) => {
+    const key = `${candidate.backend}:${candidate.model}`;
+    if (!candidates.some((existing) => `${existing.backend}:${existing.model}` === key))
+      candidates.push(candidate);
+  };
+  if (requestedModel) {
+    add2(imageCandidateFor(requestedModel, requestedBackend));
+  } else if (requestedBackend && requestedBackend !== "auto") {
+    const firstForBackend = ladder.find((preset) => preset.backend === requestedBackend);
+    add2(imageCandidateFor(firstForBackend?.id ?? (requestedBackend === "ollama" ? DEFAULT_OLLAMA_IMAGE_MODEL : DEFAULT_DIFFUSERS_IMAGE_MODEL), requestedBackend));
+  } else if (!allowFallback) {
+    add2(imageCandidateFor(DEFAULT_DIFFUSERS_IMAGE_MODEL, requestedBackend));
+  }
+  if (!allowFallback)
+    return candidates.length ? candidates : [imageCandidateFor(DEFAULT_DIFFUSERS_IMAGE_MODEL, requestedBackend)];
+  const primaryIndex = requestedModel ? ladder.findIndex((preset) => preset.id === requestedModel) : requestedBackend && requestedBackend !== "auto" ? ladder.findIndex((preset) => preset.backend === requestedBackend) : 0;
+  const fallbackTail = primaryIndex >= 0 ? ladder.slice(primaryIndex) : ladder;
+  for (const preset of fallbackTail)
+    add2(imageCandidateFor(preset.id));
+  return candidates;
+}
 function imageGenerationDir(repoRoot = ".") {
   return join36(repoRoot, ".omnius", "image-gen");
 }
@@ -250653,6 +250706,33 @@ function formatSuccessOutput(args) {
     `  Prompt: "${prompt}"`
   ].filter(Boolean).join("\n");
 }
+function summarizeToolResult(result) {
+  return trimProcessText(String(result.error || result.output || "unknown error"), 700).replace(/\s+/g, " ").trim();
+}
+function formatImageAttempt(candidate, reason, index) {
+  return `${index + 1}. ${candidate.model} [${candidate.backend}] - ${reason}`;
+}
+function formatImageFallbackFailure(failed) {
+  return [
+    "No image generation model in the fallback ladder completed successfully.",
+    "Attempted, highest quality to lowest:",
+    ...failed.map((attempt, index) => `  ${formatImageAttempt(attempt.candidate, attempt.reason, index)}`)
+  ].join("\n");
+}
+function annotateImageFallbackSuccess(result, failed, winner) {
+  if (failed.length === 0)
+    return result;
+  const prefix = [
+    `Fallback ladder succeeded with ${winner.model} [${winner.backend}] after ${failed.length} failed attempt(s).`,
+    "Failed attempts:",
+    ...failed.map((attempt, index) => `  ${formatImageAttempt(attempt.candidate, attempt.reason, index)}`),
+    ""
+  ].join("\n");
+  return {
+    ...result,
+    output: prefix + result.output
+  };
+}
 function parseRunnerJson(stdout) {
   const lines = stdout.trim().split(/\r?\n/).reverse();
   for (const line of lines) {
@@ -250665,7 +250745,7 @@ function parseRunnerJson(stdout) {
   }
   return null;
 }
-var DEFAULT_DIFFUSERS_IMAGE_MODEL, DEFAULT_OLLAMA_IMAGE_MODEL, DIFFUSERS_PYTHON_PACKAGES, SDCPP_PYTHON_PACKAGES, IMAGE_GENERATION_MODEL_PRESETS, OLLAMA_IMAGE_MODELS, DIFFUSERS_RUNNER, SDCPP_RUNNER, ImageGenerateTool;
+var DEFAULT_DIFFUSERS_IMAGE_MODEL, DEFAULT_OLLAMA_IMAGE_MODEL, DIFFUSERS_PYTHON_PACKAGES, SDCPP_PYTHON_PACKAGES, IMAGE_GENERATION_MODEL_PRESETS, IMAGE_GENERATION_QUALITY_LADDER, OLLAMA_IMAGE_MODELS, DIFFUSERS_RUNNER, SDCPP_RUNNER, ImageGenerateTool;
 var init_image_generate = __esm({
   "packages/execution/dist/tools/image-generate.js"() {
     "use strict";
@@ -250989,6 +251069,21 @@ var init_image_generate = __esm({
         note: "CPU/GGUF/checkpoint route; requires a local model path."
       }
     ];
+    IMAGE_GENERATION_QUALITY_LADDER = [
+      "black-forest-labs/FLUX.1-dev",
+      "stabilityai/stable-diffusion-3.5-large",
+      DEFAULT_OLLAMA_IMAGE_MODEL,
+      "black-forest-labs/FLUX.1-schnell",
+      "stabilityai/stable-diffusion-3.5-large-turbo",
+      "Tongyi-MAI/Z-Image-Turbo",
+      "black-forest-labs/FLUX.2-klein-4B",
+      DEFAULT_DIFFUSERS_IMAGE_MODEL,
+      "Efficient-Large-Model/Sana_Sprint_0.6B_1024px_diffusers",
+      "SimianLuo/LCM_Dreamshaper_v7",
+      "stabilityai/sd-turbo",
+      "segmind/tiny-sd",
+      "nota-ai/bk-sdm-tiny-2m"
+    ];
     OLLAMA_IMAGE_MODELS = IMAGE_GENERATION_MODEL_PRESETS.filter((preset) => preset.backend === "ollama").map((preset) => preset.id);
     DIFFUSERS_RUNNER = String.raw`#!/usr/bin/env python3
 import argparse
@@ -251170,7 +251265,7 @@ if __name__ == "__main__":
 `;
     ImageGenerateTool = class {
       name = "generate_image";
-      description = "Generate an image from a text prompt using a local image-generation backend. Supports Ollama image models (x/z-image-turbo, x/flux2-klein), Python Diffusers models (SDXL Turbo default, FLUX.1 dev, SD3.5 Large, Tiny-SD, LCM, Sana Sprint), and stable-diffusion.cpp local checkpoints/GGUF. Saves a PNG under .omnius/images and returns the file path.";
+      description = "Generate an image from a text prompt using a local image-generation backend. Supports Ollama image models (x/z-image-turbo, x/flux2-klein), Python Diffusers models (SDXL Turbo default, FLUX.1 dev, SD3.5 Large, Tiny-SD, LCM, Sana Sprint), and stable-diffusion.cpp local checkpoints/GGUF. When fallback is enabled, auto generation tries ranked high-quality candidates first and falls back to smaller models if setup, download, or generation fails. Saves a PNG under .omnius/images and returns the file path.";
       parameters = {
         type: "object",
         properties: {
@@ -251215,6 +251310,14 @@ if __name__ == "__main__":
             type: "string",
             enum: ["generate", "list_models", "setup"],
             description: "Optional utility action. Default is generate."
+          },
+          fallback: {
+            type: "boolean",
+            description: "Whether to try the ranked quality ladder if the selected model/backend fails. Defaults true."
+          },
+          strict_model: {
+            type: "boolean",
+            description: "When true, use only the requested model/backend and do not fall back. Defaults false."
           }
         },
         required: ["prompt"]
@@ -251257,7 +251360,7 @@ if __name__ == "__main__":
         if (action === "list_models") {
           return {
             success: true,
-            output: IMAGE_GENERATION_MODEL_PRESETS.map((preset2) => `${preset2.id} [${preset2.backend}] - ${preset2.note}`).join("\n"),
+            output: IMAGE_GENERATION_MODEL_PRESETS.map((preset) => `${preset.id} [${preset.backend}] - ${preset.note}`).join("\n"),
             durationMs: performance.now() - start2
           };
         }
@@ -251281,19 +251384,8 @@ if __name__ == "__main__":
           const rawModel2 = args["model_path"] ? String(args["model_path"]) : args["model"] ? String(args["model"]) : this.defaultModel;
           const requestedModel2 = rawModel2 === "auto" ? void 0 : rawModel2;
           const requestedBackend2 = args["backend"] ? String(args["backend"]) : this.defaultBackend;
-          let backend = inferImageGenerationBackend(requestedModel2, requestedBackend2);
-          if (backend === "auto") {
-            backend = inferImageGenerationBackend(requestedModel2, void 0);
-            if (backend === "auto")
-              backend = "diffusers";
-          }
-          const model = requestedModel2 ?? (backend === "diffusers" ? DEFAULT_DIFFUSERS_IMAGE_MODEL : DEFAULT_OLLAMA_IMAGE_MODEL);
-          this.emitProgress({ stage: "setup", message: `Preparing image model ${model} (${backend})` });
-          if (backend === "ollama")
-            return await this.prewarmOllama({ model, start: start2 });
-          if (backend === "sdcpp")
-            return await this.prewarmSdCpp({ model, start: start2, python: args["python"] });
-          return await this.prewarmDiffusers({ model, start: start2, python: args["python"] });
+          const candidates2 = imageGenerationFallbackCandidates(requestedModel2, requestedBackend2, generationFallbackEnabled(args));
+          return await this.prewarmCandidateLadder({ candidates: candidates2, args, start: start2 });
         }
         const prompt = String(args["prompt"] ?? "").trim();
         if (!prompt) {
@@ -251302,31 +251394,10 @@ if __name__ == "__main__":
         const rawModel = args["model_path"] ? String(args["model_path"]) : args["model"] ? String(args["model"]) : this.defaultModel;
         const requestedModel = rawModel === "auto" ? void 0 : rawModel;
         const requestedBackend = args["backend"] ? String(args["backend"]) : this.defaultBackend;
-        const preset = getImageGenerationPreset(requestedModel);
-        const width = numberArg(args["width"], preset?.width ?? 1024);
-        const height = numberArg(args["height"], preset?.height ?? 1024);
-        const steps = optionalNumberArg(args["steps"]) ?? preset?.steps;
-        const guidance = optionalNumberArg(args["guidance"]) ?? preset?.guidance;
         const seed = optionalNumberArg(args["seed"]);
+        const candidates = imageGenerationFallbackCandidates(requestedModel, requestedBackend, generationFallbackEnabled(args));
         try {
-          let backend = inferImageGenerationBackend(requestedModel, requestedBackend);
-          let model = requestedModel;
-          if (backend === "auto") {
-            backend = inferImageGenerationBackend(model, void 0);
-            if (backend === "auto")
-              backend = "diffusers";
-          }
-          if (!model) {
-            model = backend === "diffusers" ? DEFAULT_DIFFUSERS_IMAGE_MODEL : DEFAULT_OLLAMA_IMAGE_MODEL;
-          }
-          this.emitProgress({ stage: "setup", message: `Using image model ${model} (${backend})` });
-          if (backend === "ollama") {
-            return await this.generateWithOllama({ prompt, model, width, height, steps, start: start2 });
-          }
-          if (backend === "sdcpp") {
-            return await this.generateWithSdCpp({ prompt, model, width, height, steps, seed, start: start2, python: args["python"] });
-          }
-          return await this.generateWithDiffusers({ prompt, model, width, height, steps, guidance, seed, start: start2, python: args["python"] });
+          return await this.generateCandidateLadder({ candidates, prompt, args, seed, start: start2 });
         } catch (err) {
           return {
             success: false,
@@ -251335,6 +251406,64 @@ if __name__ == "__main__":
           };
         }
       }
+      async prewarmCandidateLadder(args) {
+        const failed = [];
+        for (let index = 0; index < args.candidates.length; index++) {
+          const candidate = args.candidates[index];
+          this.emitProgress({
+            stage: "setup",
+            message: `Preparing image model ${candidate.model} (${candidate.backend}) [${index + 1}/${args.candidates.length}]`
+          });
+          const result = candidate.backend === "ollama" ? await this.prewarmOllama({ model: candidate.model, start: args.start }) : candidate.backend === "sdcpp" ? await this.prewarmSdCpp({ model: candidate.model, start: args.start, python: args.args["python"] }) : await this.prewarmDiffusers({ model: candidate.model, start: args.start, python: args.args["python"] });
+          if (result.success)
+            return annotateImageFallbackSuccess(result, failed, candidate);
+          failed.push({ candidate, reason: summarizeToolResult(result) });
+          if (index < args.candidates.length - 1) {
+            this.emitProgress({
+              stage: "setup",
+              message: `${candidate.model} failed; trying ${args.candidates[index + 1].model}`
+            });
+          }
+        }
+        const output = formatImageFallbackFailure(failed);
+        return {
+          success: false,
+          output,
+          error: output,
+          durationMs: performance.now() - args.start
+        };
+      }
+      async generateCandidateLadder(args) {
+        const failed = [];
+        for (let index = 0; index < args.candidates.length; index++) {
+          const candidate = args.candidates[index];
+          const width = numberArg(args.args["width"], candidate.preset?.width ?? 1024);
+          const height = numberArg(args.args["height"], candidate.preset?.height ?? 1024);
+          const steps = optionalNumberArg(args.args["steps"]) ?? candidate.preset?.steps;
+          const guidance = optionalNumberArg(args.args["guidance"]) ?? candidate.preset?.guidance;
+          this.emitProgress({
+            stage: "setup",
+            message: `Using image model ${candidate.model} (${candidate.backend}) [${index + 1}/${args.candidates.length}]`
+          });
+          const result = candidate.backend === "ollama" ? await this.generateWithOllama({ prompt: args.prompt, model: candidate.model, width, height, steps, start: args.start }) : candidate.backend === "sdcpp" ? await this.generateWithSdCpp({ prompt: args.prompt, model: candidate.model, width, height, steps, seed: args.seed, start: args.start, python: args.args["python"] }) : await this.generateWithDiffusers({ prompt: args.prompt, model: candidate.model, width, height, steps, guidance, seed: args.seed, start: args.start, python: args.args["python"] });
+          if (result.success)
+            return annotateImageFallbackSuccess(result, failed, candidate);
+          failed.push({ candidate, reason: summarizeToolResult(result) });
+          if (index < args.candidates.length - 1) {
+            this.emitProgress({
+              stage: "setup",
+              message: `${candidate.model} failed; falling back to ${args.candidates[index + 1].model}`
+            });
+          }
+        }
+        const output = formatImageFallbackFailure(failed);
+        return {
+          success: false,
+          output,
+          error: output,
+          durationMs: performance.now() - args.start
+        };
+      }
       async prewarmOllama(args) {
         const model = args.model || DEFAULT_OLLAMA_IMAGE_MODEL;
         if (await this.ollamaHasModel(model)) {
@@ -251830,7 +251959,7 @@ function backendImportCheck(backend) {
   if (backend === "audiocraft")
     return "import torch, torchaudio, audiocraft\nfrom audiocraft.models import MusicGen, AudioGen\n";
   if (backend === "stable-audio")
-    return "import torch, torchaudio, stable_audio_tools\n";
+    return "import torch, torchaudio, diffusers, scipy\nfrom diffusers import StableAudioPipeline\n";
   if (backend === "tangoflux")
     return "import torch, torchaudio\nfrom tangoflux import TangoFluxInference\n";
   return "import torch, diffusers, scipy\nfrom diffusers import AudioLDMPipeline\n";
@@ -252160,11 +252289,31 @@ function playbackRequested(args) {
     return false;
   return true;
 }
+function booleanArg2(value2, fallback) {
+  if (typeof value2 === "boolean")
+    return value2;
+  if (typeof value2 === "string") {
+    if (/^(1|true|yes|on)$/i.test(value2.trim()))
+      return true;
+    if (/^(0|false|no|off)$/i.test(value2.trim()))
+      return false;
+  }
+  return fallback;
+}
+function generationFallbackEnabled2(args) {
+  if (booleanArg2(args["strict_model"] ?? args["strictModel"] ?? args["strict"], false))
+    return false;
+  return booleanArg2(args["fallback"] ?? args["allow_fallback"] ?? args["allowFallback"], true);
+}
 function getAudioGenerationPreset(model, kind) {
   if (!model)
     return void 0;
   return AUDIO_GENERATION_MODEL_PRESETS.find((preset) => preset.id === model && (!kind || preset.kind === kind)) ?? AUDIO_GENERATION_MODEL_PRESETS.find((preset) => preset.id === model);
 }
+function audioGenerationQualityLadder(kind) {
+  const ids = kind === "music" ? MUSIC_GENERATION_QUALITY_LADDER : SOUND_GENERATION_QUALITY_LADDER;
+  return ids.map((id) => getAudioGenerationPreset(id, kind)).filter((preset) => Boolean(preset));
+}
 function inferAudioGenerationBackend(model, requested) {
   if (requested && requested !== "auto") {
     if (requested === "diffusers" || requested === "transformers" || requested === "audiocraft" || requested === "stable-audio" || requested === "tangoflux" || requested === "project")
@@ -252188,6 +252337,41 @@ function inferAudioGenerationBackend(model, requested) {
     return "project";
   return "diffusers";
 }
+function audioCandidateFor(kind, model, requestedBackend) {
+  const backend = inferAudioGenerationBackend(model, requestedBackend);
+  const resolvedBackend = backend === "auto" ? kind === "music" ? "transformers" : "diffusers" : backend;
+  return {
+    kind,
+    model,
+    backend: resolvedBackend,
+    preset: getAudioGenerationPreset(model, kind)
+  };
+}
+function audioGenerationFallbackCandidates(kind, requestedModel, requestedBackend, allowFallback = true) {
+  const ladder = audioGenerationQualityLadder(kind);
+  const candidates = [];
+  const add2 = (candidate) => {
+    const key = `${candidate.kind}:${candidate.backend}:${candidate.model}`;
+    if (!candidates.some((existing) => `${existing.kind}:${existing.backend}:${existing.model}` === key)) {
+      candidates.push(candidate);
+    }
+  };
+  if (requestedModel) {
+    add2(audioCandidateFor(kind, requestedModel, requestedBackend));
+  } else if (requestedBackend && requestedBackend !== "auto") {
+    const firstForBackend = ladder.find((preset) => preset.backend === requestedBackend);
+    add2(audioCandidateFor(kind, firstForBackend?.id ?? (kind === "music" ? DEFAULT_MUSIC_MODEL : DEFAULT_SOUND_MODEL), requestedBackend));
+  } else if (!allowFallback) {
+    add2(audioCandidateFor(kind, kind === "music" ? DEFAULT_MUSIC_MODEL : DEFAULT_SOUND_MODEL, requestedBackend));
+  }
+  if (!allowFallback)
+    return candidates.length ? candidates : [audioCandidateFor(kind, kind === "music" ? DEFAULT_MUSIC_MODEL : DEFAULT_SOUND_MODEL, requestedBackend)];
+  const primaryIndex = requestedModel ? ladder.findIndex((preset) => preset.id === requestedModel) : requestedBackend && requestedBackend !== "auto" ? ladder.findIndex((preset) => preset.backend === requestedBackend) : 0;
+  const fallbackTail = primaryIndex >= 0 ? ladder.slice(primaryIndex) : ladder;
+  for (const preset of fallbackTail)
+    add2(audioCandidateFor(kind, preset.id));
+  return candidates;
+}
 function audioGenerationSetupPlan(kind, backend, repoRoot = ".", model) {
   const commandName = kind === "music" ? "music" : "sound";
   const fallback = kind === "music" ? DEFAULT_MUSIC_MODEL : DEFAULT_SOUND_MODEL;
@@ -252261,6 +252445,7 @@ function audioGenerationSetupPlan(kind, backend, repoRoot = ".", model) {
       ],
       notes: [
         "Use this path for Stable Audio Open 1.0, the serious stereo audio/music baseline.",
+        "Omnius uses Diffusers StableAudioPipeline here; stable-audio-tools is intentionally not installed because it often pulls build-from-source dependencies.",
         "Expect larger model downloads and higher VRAM pressure than AudioLDM or MusicGen small."
       ]
     };
@@ -252296,7 +252481,34 @@ function audioGenerationSetupPlan(kind, backend, repoRoot = ".", model) {
     ]
   };
 }
-var DEFAULT_SOUND_MODEL, DEFAULT_MUSIC_MODEL, DIFFUSERS_AUDIO_PACKAGES, TRANSFORMERS_AUDIO_PACKAGES, AUDIOCRAFT_PACKAGES, STABLE_AUDIO_PACKAGES, TANGOFLUX_PACKAGES, AUDIO_GENERATION_MODEL_PRESETS, DIFFUSERS_AUDIO_RUNNER, AUDIOCRAFT_RUNNER, TRANSFORMERS_AUDIO_RUNNER, TANGOFLUX_RUNNER, AudioGenerateTool;
+function summarizeToolResult2(result) {
+  return trimProcessText2(String(result.error || result.output || "unknown error"), 700).replace(/\s+/g, " ").trim();
+}
+function formatAudioAttempt(candidate, reason, index) {
+  return `${index + 1}. ${candidate.model} [${candidate.backend}] - ${reason}`;
+}
+function formatAudioFallbackFailure(kind, failed) {
+  return [
+    `No ${kind} generation model in the fallback ladder completed successfully.`,
+    "Attempted, highest quality to lowest:",
+    ...failed.map((attempt, index) => `  ${formatAudioAttempt(attempt.candidate, attempt.reason, index)}`)
+  ].join("\n");
+}
+function annotateAudioFallbackSuccess(result, failed, winner) {
+  if (failed.length === 0)
+    return result;
+  const prefix = [
+    `Fallback ladder succeeded with ${winner.model} [${winner.backend}] after ${failed.length} failed attempt(s).`,
+    "Failed attempts:",
+    ...failed.map((attempt, index) => `  ${formatAudioAttempt(attempt.candidate, attempt.reason, index)}`),
+    ""
+  ].join("\n");
+  return {
+    ...result,
+    output: prefix + result.output
+  };
+}
+var DEFAULT_SOUND_MODEL, DEFAULT_MUSIC_MODEL, DIFFUSERS_AUDIO_PACKAGES, TRANSFORMERS_AUDIO_PACKAGES, AUDIOCRAFT_PACKAGES, STABLE_AUDIO_PACKAGES, TANGOFLUX_PACKAGES, AUDIO_GENERATION_MODEL_PRESETS, SOUND_GENERATION_QUALITY_LADDER, MUSIC_GENERATION_QUALITY_LADDER, DIFFUSERS_AUDIO_RUNNER, AUDIOCRAFT_RUNNER, TRANSFORMERS_AUDIO_RUNNER, TANGOFLUX_RUNNER, AudioGenerateTool;
 var init_audio_generate = __esm({
   "packages/execution/dist/tools/audio-generate.js"() {
     "use strict";
@@ -252338,7 +252550,6 @@ var init_audio_generate = __esm({
       "accelerate",
       "scipy",
       "soundfile",
-      "stable-audio-tools",
       "einops"
     ];
     TANGOFLUX_PACKAGES = [
@@ -252644,6 +252855,21 @@ var init_audio_generate = __esm({
         note: "Legacy specialized music-generation path."
       }
     ];
+    SOUND_GENERATION_QUALITY_LADDER = [
+      "stabilityai/stable-audio-open-1.0",
+      "cvssp/audioldm2-large",
+      "cvssp/audioldm2",
+      "facebook/audiogen-medium",
+      "declare-lab/TangoFlux",
+      DEFAULT_SOUND_MODEL
+    ];
+    MUSIC_GENERATION_QUALITY_LADDER = [
+      "stabilityai/stable-audio-open-1.0",
+      "facebook/musicgen-stereo-large",
+      "facebook/musicgen-large",
+      "facebook/musicgen-medium",
+      DEFAULT_MUSIC_MODEL
+    ];
     DIFFUSERS_AUDIO_RUNNER = String.raw`#!/usr/bin/env python3
 import argparse, json, sys, time
 from pathlib import Path
@@ -253030,7 +253256,7 @@ if __name__ == "__main__":
 `;
     AudioGenerateTool = class {
       name = "generate_audio";
-      description = "Generate a sound effect or music clip from a text prompt using local audio-generation backends. Supports Diffusers AudioLDM/AudioLDM2, Transformers MusicGen, AudioCraft AudioGen, Stable Audio Open deployment paths, and explicit research-project profiles. Saves WAV files under .omnius/audio and returns the file path.";
+      description = "Generate a sound effect or music clip from a text prompt using local audio-generation backends. Supports Diffusers AudioLDM/AudioLDM2, Transformers MusicGen, AudioCraft AudioGen, Stable Audio Open deployment paths, and explicit research-project profiles. When fallback is enabled, auto generation tries ranked high-quality candidates first and gracefully falls back to smaller models if setup, download, or generation fails. Saves WAV files under .omnius/audio and returns the file path.";
       parameters = {
         type: "object",
         properties: {
@@ -253044,6 +253270,14 @@ if __name__ == "__main__":
           playback: {
             type: "boolean",
             description: "Whether the TUI should play generated audio after saving it. Defaults true; set false for silent generation."
+          },
+          fallback: {
+            type: "boolean",
+            description: "Whether to try the ranked quality ladder if the selected model/backend fails. Defaults true."
+          },
+          strict_model: {
+            type: "boolean",
+            description: "When true, use only the requested model/backend and do not fall back. Defaults false."
           }
         },
         required: ["prompt"]
@@ -253147,14 +253381,14 @@ if __name__ == "__main__":
         if (action === "list_models") {
           return {
             success: true,
-            output: AUDIO_GENERATION_MODEL_PRESETS.filter((preset2) => preset2.kind === kind).map((preset2) => `${preset2.id} [${preset2.backend}] - ${preset2.note}`).join("\n"),
+            output: AUDIO_GENERATION_MODEL_PRESETS.filter((preset) => preset.kind === kind).map((preset) => `${preset.id} [${preset.backend}] - ${preset.note}`).join("\n"),
             durationMs: performance.now() - start2
           };
         }
         if (action === "setup") {
           const requested = String(args["backend"] ?? (kind === "music" ? this.defaults.musicBackend : this.defaults.soundBackend) ?? (kind === "music" ? "transformers" : "diffusers"));
-          const backend2 = inferAudioGenerationBackend(typeof args["model"] === "string" ? args["model"] : void 0, requested);
-          const resolvedBackend = backend2 === "auto" ? kind === "music" ? "transformers" : "diffusers" : backend2;
+          const backend = inferAudioGenerationBackend(typeof args["model"] === "string" ? args["model"] : void 0, requested);
+          const resolvedBackend = backend === "auto" ? kind === "music" ? "transformers" : "diffusers" : backend;
           const plan = audioGenerationSetupPlan(kind, resolvedBackend, this.cwd, typeof args["model"] === "string" ? args["model"] : void 0);
           return {
             success: true,
@@ -253173,37 +253407,9 @@ if __name__ == "__main__":
           const defaultBackend2 = kind === "music" ? this.defaults.musicBackend : this.defaults.soundBackend;
           const rawModel2 = args["model"] ? String(args["model"]) : defaultModel2;
           const requestedModel2 = rawModel2 === "auto" ? void 0 : rawModel2;
-          let backend2 = inferAudioGenerationBackend(requestedModel2, args["backend"] ? String(args["backend"]) : defaultBackend2);
-          if (backend2 === "auto")
-            backend2 = kind === "music" ? "transformers" : "diffusers";
-          const model2 = requestedModel2 ?? (kind === "music" ? DEFAULT_MUSIC_MODEL : DEFAULT_SOUND_MODEL);
-          const preset2 = getAudioGenerationPreset(model2, kind);
-          const duration2 = numberArg2(args["duration"], preset2?.defaultDurationSec ?? (kind === "music" ? 20 : 8));
-          if (backend2 === "project") {
-            const plan = audioGenerationSetupPlan(kind, "project", this.cwd, model2);
-            return {
-              success: false,
-              output: [
-                `${preset2?.label ?? model2} is a project deployment profile, not an automatic generic runner.`,
-                "",
-                "Setup path:",
-                ...plan.commands.map((cmd) => `  ${cmd}`),
-                "",
-                ...plan.notes.map((note) => `- ${note}`)
-              ].join("\n"),
-              durationMs: performance.now() - start2
-            };
-          }
-          this.emitProgress({ stage: "setup", message: `Preparing ${kind} model ${model2} (${backend2})` });
-          return await this.prewarmPythonBackend({
-            kind,
-            backend: backend2,
-            runnerBackend: backend2,
-            model: model2,
-            duration: duration2,
-            start: start2,
-            python: args["python"]
-          });
+          const requestedBackend2 = args["backend"] ? String(args["backend"]) : defaultBackend2;
+          const candidates2 = audioGenerationFallbackCandidates(kind, requestedModel2, requestedBackend2, generationFallbackEnabled2(args));
+          return await this.prewarmCandidateLadder({ kind, candidates: candidates2, args, start: start2 });
         }
         const prompt = String(args["prompt"] ?? "").trim();
         if (!prompt) {
@@ -253213,45 +253419,12 @@ if __name__ == "__main__":
         const defaultBackend = kind === "music" ? this.defaults.musicBackend : this.defaults.soundBackend;
         const rawModel = args["model"] ? String(args["model"]) : defaultModel;
         const requestedModel = rawModel === "auto" ? void 0 : rawModel;
-        let backend = inferAudioGenerationBackend(requestedModel, args["backend"] ? String(args["backend"]) : defaultBackend);
-        if (backend === "auto")
-          backend = kind === "music" ? "transformers" : "diffusers";
-        const model = requestedModel ?? (kind === "music" ? DEFAULT_MUSIC_MODEL : DEFAULT_SOUND_MODEL);
-        const preset = getAudioGenerationPreset(model, kind);
-        const duration = numberArg2(args["duration"], preset?.defaultDurationSec ?? (kind === "music" ? 20 : 8));
-        const steps = optionalNumberArg2(args["steps"]) ?? preset?.defaultSteps;
+        const requestedBackend = args["backend"] ? String(args["backend"]) : defaultBackend;
+        const candidates = audioGenerationFallbackCandidates(kind, requestedModel, requestedBackend, generationFallbackEnabled2(args));
         const seed = optionalNumberArg2(args["seed"]);
         const playback = playbackRequested(args);
         try {
-          this.emitProgress({ stage: "setup", message: `Using ${kind} model ${model} (${backend})` });
-          if (backend === "project") {
-            const plan = audioGenerationSetupPlan(kind, "project", this.cwd, model);
-            return {
-              success: false,
-              output: [
-                `${preset?.label ?? model} is a project deployment profile, not an automatic generic runner.`,
-                "",
-                "Setup path:",
-                ...plan.commands.map((cmd) => `  ${cmd}`),
-                "",
-                ...plan.notes.map((note) => `- ${note}`)
-              ].join("\n"),
-              durationMs: performance.now() - start2
-            };
-          }
-          if (backend === "tangoflux") {
-            return await this.generateWithPythonBackend({ kind, backend, runnerBackend: "tangoflux", prompt, model, duration, steps, seed, playback, start: start2, python: args["python"] });
-          }
-          if (backend === "transformers") {
-            return await this.generateWithPythonBackend({ kind, backend, runnerBackend: "transformers", prompt, model, duration, steps, seed, playback, start: start2, python: args["python"] });
-          }
-          if (backend === "audiocraft") {
-            return await this.generateWithPythonBackend({ kind, backend, runnerBackend: "audiocraft", prompt, model, duration, steps, seed, playback, start: start2, python: args["python"] });
-          }
-          if (backend === "stable-audio") {
-            return await this.generateWithPythonBackend({ kind, backend, runnerBackend: "stable-audio", prompt, model, duration, steps, seed, playback, start: start2, python: args["python"] });
-          }
-          return await this.generateWithPythonBackend({ kind, backend: "diffusers", runnerBackend: "diffusers", prompt, model, duration, steps, seed, playback, start: start2, python: args["python"] });
+          return await this.generateCandidateLadder({ kind, candidates, prompt, args, seed, playback, start: start2 });
         } catch (err) {
           return {
             success: false,
@@ -253260,6 +253433,96 @@ if __name__ == "__main__":
           };
         }
       }
+      async prewarmCandidateLadder(args) {
+        const failed = [];
+        for (let index = 0; index < args.candidates.length; index++) {
+          const candidate = args.candidates[index];
+          const duration = numberArg2(args.args["duration"], candidate.preset?.defaultDurationSec ?? (args.kind === "music" ? 20 : 8));
+          this.emitProgress({
+            stage: "setup",
+            message: `Preparing ${args.kind} model ${candidate.model} (${candidate.backend}) [${index + 1}/${args.candidates.length}]`
+          });
+          const result = candidate.backend === "project" ? this.projectProfileResult(args.kind, candidate, args.start) : await this.prewarmPythonBackend({
+            kind: args.kind,
+            backend: candidate.backend,
+            runnerBackend: candidate.backend,
+            model: candidate.model,
+            duration,
+            start: args.start,
+            python: args.args["python"]
+          });
+          if (result.success)
+            return annotateAudioFallbackSuccess(result, failed, candidate);
+          failed.push({ candidate, reason: summarizeToolResult2(result) });
+          if (index < args.candidates.length - 1) {
+            this.emitProgress({
+              stage: "setup",
+              message: `${candidate.model} failed; trying ${args.candidates[index + 1].model}`
+            });
+          }
+        }
+        return {
+          success: false,
+          output: formatAudioFallbackFailure(args.kind, failed),
+          error: formatAudioFallbackFailure(args.kind, failed),
+          durationMs: performance.now() - args.start
+        };
+      }
+      async generateCandidateLadder(args) {
+        const failed = [];
+        for (let index = 0; index < args.candidates.length; index++) {
+          const candidate = args.candidates[index];
+          const duration = numberArg2(args.args["duration"], candidate.preset?.defaultDurationSec ?? (args.kind === "music" ? 20 : 8));
+          const steps = optionalNumberArg2(args.args["steps"]) ?? candidate.preset?.defaultSteps;
+          this.emitProgress({
+            stage: "setup",
+            message: `Using ${args.kind} model ${candidate.model} (${candidate.backend}) [${index + 1}/${args.candidates.length}]`
+          });
+          const result = candidate.backend === "project" ? this.projectProfileResult(args.kind, candidate, args.start) : await this.generateWithPythonBackend({
+            kind: args.kind,
+            backend: candidate.backend,
+            runnerBackend: candidate.backend,
+            prompt: args.prompt,
+            model: candidate.model,
+            duration,
+            steps,
+            seed: args.seed,
+            playback: args.playback,
+            start: args.start,
+            python: args.args["python"]
+          });
+          if (result.success)
+            return annotateAudioFallbackSuccess(result, failed, candidate);
+          failed.push({ candidate, reason: summarizeToolResult2(result) });
+          if (index < args.candidates.length - 1) {
+            this.emitProgress({
+              stage: "setup",
+              message: `${candidate.model} failed; falling back to ${args.candidates[index + 1].model}`
+            });
+          }
+        }
+        return {
+          success: false,
+          output: formatAudioFallbackFailure(args.kind, failed),
+          error: formatAudioFallbackFailure(args.kind, failed),
+          durationMs: performance.now() - args.start
+        };
+      }
+      projectProfileResult(kind, candidate, start2) {
+        const plan = audioGenerationSetupPlan(kind, "project", this.cwd, candidate.model);
+        return {
+          success: false,
+          output: [
+            `${candidate.preset?.label ?? candidate.model} is a project deployment profile, not an automatic generic runner.`,
+            "",
+            "Setup path:",
+            ...plan.commands.map((cmd) => `  ${cmd}`),
+            "",
+            ...plan.notes.map((note) => `- ${note}`)
+          ].join("\n"),
+          durationMs: performance.now() - start2
+        };
+      }
       async generateWithPythonBackend(args) {
         const runner = await ensureAudioRunner(this.cwd, args.runnerBackend);
         await mkdir12(audioOutputDir(this.cwd), { recursive: true });
@@ -255836,8 +256099,8 @@ var init_browser_action = __esm({
               const afterDom = await apiCall("/dom", "GET");
               const afterTitle = (afterDom.dom || "").match(/<title[^>]*>([^<]*)<\/title>/i)?.[1] || "";
               try {
-                const { unlinkSync: unlinkSync25 } = await import("node:fs");
-                unlinkSync25(imagePath);
+                const { unlinkSync: unlinkSync26 } = await import("node:fs");
+                unlinkSync26(imagePath);
               } catch {
               }
               return {
@@ -507359,6 +507622,18 @@ function supertonicInferScript() {
 function mlxVenvPy() {
   return process.platform === "win32" ? join58(voiceDir(), "mlx-venv", "Scripts", "python.exe") : join58(voiceDir(), "mlx-venv", "bin", "python3");
 }
+function luxttsVenvDir() {
+  return join58(voiceDir(), "luxtts-venv");
+}
+function luxttsVenvPy() {
+  return process.platform === "win32" ? join58(luxttsVenvDir(), "Scripts", "python.exe") : join58(luxttsVenvDir(), "bin", "python3");
+}
+function luxttsRepoDir() {
+  return join58(voiceDir(), "LuxTTS");
+}
+function luxttsInferScript() {
+  return join58(voiceDir(), "luxtts-infer.py");
+}
 function piperVenvDir() {
   return join58(voiceDir(), "piper-venv");
 }
@@ -507385,7 +507660,7 @@ function ensureSupertonicInstalled() {
 }
 function ensureMlxInstalled() {
   if (process.platform !== "darwin" || process.arch !== "arm64") {
-    throw new Error("MLX TTS requires macOS on Apple Silicon. Use luxtts, supertonic, onnx/piper, or espeak on this machine.");
+    throw new Error("MLX TTS requires macOS on Apple Silicon. Use luxtts, supertonic, onnx/piper, or backend=auto on this machine.");
   }
   const venvPy = mlxVenvPy();
   if (!existsSync40(venvPy)) {
@@ -507402,6 +507677,81 @@ function ensureMlxInstalled() {
   }
   return venvPy;
 }
+function pythonCanImportLuxTts(venvPy) {
+  try {
+    execFileSync2(venvPy, [
+      "-c",
+      "import sys, os; sys.path.insert(0, os.environ['LUXTTS_REPO_PATH']); from zipvoice.luxvoice import LuxTTS; print('ok')"
+    ], {
+      stdio: "pipe",
+      timeout: 3e4,
+      env: { ...process.env, LUXTTS_REPO_PATH: luxttsRepoDir() }
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function pipInstall(venvPy, packages, timeout2 = 9e5) {
+  execFileSync2(venvPy, ["-m", "pip", "install", "--prefer-binary", ...packages], {
+    stdio: "pipe",
+    timeout: timeout2,
+    env: process.env
+  });
+}
+function ensureLuxttsInstalled() {
+  const venvPy = luxttsVenvPy();
+  const repoDir = luxttsRepoDir();
+  mkdirSync16(voiceDir(), { recursive: true });
+  if (existsSync40(venvPy) && existsSync40(join58(repoDir, "zipvoice", "luxvoice.py")) && pythonCanImportLuxTts(venvPy)) {
+    writeFileSync16(luxttsInferScript(), LUXTTS_DAEMON_PY, "utf-8");
+    return venvPy;
+  }
+  const py = findPython32();
+  if (!py)
+    throw new Error("python3 is required to set up LuxTTS voice cloning.");
+  if (!existsSync40(venvPy)) {
+    execFileSync2(py, ["-m", "venv", luxttsVenvDir()], { stdio: "pipe", timeout: 18e4 });
+  }
+  execFileSync2(venvPy, ["-m", "pip", "install", "--upgrade", "pip", "wheel", "setuptools<81"], {
+    stdio: "pipe",
+    timeout: 3e5
+  });
+  pipInstall(venvPy, ["torch", "torchaudio"], 12e5);
+  if (!existsSync40(join58(repoDir, "zipvoice", "luxvoice.py"))) {
+    if (!hasCommand3("git"))
+      throw new Error("git is required to set up LuxTTS voice cloning.");
+    execFileSync2("git", ["clone", "--depth", "1", "https://github.com/ysharma3501/LuxTTS.git", repoDir], {
+      stdio: "pipe",
+      timeout: 3e5
+    });
+  }
+  pipInstall(venvPy, [
+    "lhotse",
+    "huggingface_hub",
+    "safetensors",
+    "pydub",
+    "onnxruntime",
+    "librosa",
+    "transformers<=4.57.6",
+    "inflect",
+    "numpy",
+    "vocos",
+    "jieba",
+    "pypinyin",
+    "cn2an"
+  ], 12e5);
+  try {
+    pipInstall(venvPy, ["git+https://github.com/ysharma3501/LinaCodec.git"], 12e5);
+  } catch {
+  }
+  pipInstall(venvPy, ["-e", repoDir], 6e5);
+  writeFileSync16(luxttsInferScript(), LUXTTS_DAEMON_PY, "utf-8");
+  if (!pythonCanImportLuxTts(venvPy)) {
+    throw new Error(`LuxTTS setup completed but import still fails in ${luxttsVenvDir()}.`);
+  }
+  return venvPy;
+}
 function ensurePiperInstalled() {
   if (hasCommand3("piper"))
     return "piper";
@@ -507435,6 +507785,28 @@ function saveCloneRefFromSample(sample, cloneName) {
   copyFileSync2(source, dest);
   return dest;
 }
+function cloneSampleArg(args) {
+  for (const key of ["sample", "source_audio", "voice_sample", "reference_audio", "ref_audio", "clone_sample"]) {
+    const value2 = args[key];
+    if (typeof value2 === "string" && value2.trim())
+      return value2.trim();
+  }
+  return "";
+}
+function wantsVoiceClone(args) {
+  if (cloneSampleArg(args))
+    return true;
+  if (typeof args["clone_ref"] === "string" && args["clone_ref"].trim())
+    return true;
+  const voice = typeof args["voice"] === "string" ? args["voice"].trim() : "";
+  return /\.(wav|mp3|flac|ogg|m4a)$/i.test(voice) || voice.startsWith("/") || voice.startsWith("./") || voice.startsWith("../") || voice.startsWith("~/");
+}
+function cloneRefForSynthesis(args) {
+  const sample = cloneSampleArg(args);
+  if (sample)
+    return saveCloneRefFromSample(sample, typeof args["clone_name"] === "string" ? args["clone_name"] : void 0);
+  return resolveCloneRef(args["clone_ref"] ?? args["voice"]);
+}
 function ensureLuxttsDaemon() {
   if (_luxttsDaemon && !_luxttsDaemon.killed && _luxttsReady)
     return Promise.resolve(true);
@@ -507448,14 +507820,23 @@ function ensureLuxttsDaemon() {
   }
   if (_luxttsStarting)
     return Promise.resolve(false);
-  const venvPy = join58(homedir14(), ".omnius", "voice", "luxtts-venv", "bin", "python3");
-  const inferScript = join58(homedir14(), ".omnius", "voice", "luxtts-infer.py");
-  const repoDir = join58(homedir14(), ".omnius", "voice", "LuxTTS");
+  const venvPy = luxttsVenvPy();
+  const inferScript = luxttsInferScript();
+  const repoDir = luxttsRepoDir();
   if (!existsSync40(venvPy) || !existsSync40(inferScript))
     return Promise.resolve(false);
   _luxttsStarting = true;
   return new Promise((resolve48) => {
-    const timeout2 = setTimeout(() => {
+    let settled = false;
+    let timeout2;
+    const finish = (ready) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timeout2);
+      resolve48(ready);
+    };
+    timeout2 = setTimeout(() => {
       _luxttsStarting = false;
       if (_luxttsDaemon && !_luxttsReady) {
         try {
@@ -507464,7 +507845,7 @@ function ensureLuxttsDaemon() {
         }
         _luxttsDaemon = null;
       }
-      resolve48(false);
+      finish(false);
     }, 12e4);
     const daemon = spawn16(venvPy, [inferScript], {
       stdio: ["pipe", "pipe", "pipe"],
@@ -507486,8 +507867,7 @@ function ensureLuxttsDaemon() {
           if (msg.type === "ready") {
             _luxttsReady = true;
             _luxttsStarting = false;
-            clearTimeout(timeout2);
-            resolve48(true);
+            finish(true);
           } else if (msg.type === "result" && msg.id) {
             const pending = _luxttsPending.get(msg.id);
             if (pending) {
@@ -507509,13 +507889,13 @@ function ensureLuxttsDaemon() {
       _luxttsDaemon = null;
       _luxttsReady = false;
       _luxttsStarting = false;
+      finish(false);
     });
     daemon.on("error", () => {
       _luxttsDaemon = null;
       _luxttsReady = false;
       _luxttsStarting = false;
-      clearTimeout(timeout2);
-      resolve48(false);
+      finish(false);
     });
   });
 }
@@ -507545,7 +507925,7 @@ function luxttsSynthesize(text, cloneRef, outputPath2, speed = 1) {
     _luxttsDaemon.stdin.write(req2 + "\n");
   });
 }
-var _luxttsDaemon, _luxttsReady, _luxttsRequestId, _luxttsPending, _luxttsBuffer, _luxttsStarting, SUPERTONIC_INFER_PY, AudioPlaybackTool, TtsGenerateTool, SoundPlaybackTool;
+var _luxttsDaemon, _luxttsReady, _luxttsRequestId, _luxttsPending, _luxttsBuffer, _luxttsStarting, SUPERTONIC_INFER_PY, LUXTTS_DAEMON_PY, AudioPlaybackTool, TtsGenerateTool, SoundPlaybackTool;
 var init_audio_playback = __esm({
   "packages/execution/dist/tools/audio-playback.js"() {
     "use strict";
@@ -507585,10 +507965,45 @@ try:
 except Exception as exc:
     print(json.dumps({"ok": False, "error": str(exc), "trace": traceback.format_exc(limit=3)}))
     sys.exit(1)
+`;
+    LUXTTS_DAEMON_PY = String.raw`
+import json, os, sys, traceback, wave
+import numpy as np
+import torch
+repo = os.environ.get("LUXTTS_REPO_PATH") or ""
+if repo:
+    sys.path.insert(0, repo)
+from zipvoice.luxvoice import LuxTTS
+device = "cuda" if torch.cuda.is_available() else "cpu"
+tts = LuxTTS(model_path="YatharthS/LuxTTS", device=device, threads=4)
+print(json.dumps({"type": "ready", "device": device}), flush=True)
+for line in sys.stdin:
+    if not line.strip():
+        continue
+    req = json.loads(line)
+    if req.get("action") == "quit":
+        break
+    rid = req.get("id")
+    try:
+        text = str(req.get("text") or "").strip()
+        clone_ref = str(req.get("clone_ref") or "")
+        output = str(req.get("output_path") or "")
+        speed = float(req.get("speed") or 1.0)
+        enc = tts.encode_prompt(clone_ref, duration=5, rms=0.001)
+        wav = tts.generate_speech(text, enc, num_steps=4, guidance_scale=3.0, t_shift=0.5, speed=speed)
+        data = (np.clip(wav.cpu().numpy().squeeze(), -1, 1) * 32767).astype(np.int16)
+        with wave.open(output, "wb") as f:
+            f.setnchannels(1)
+            f.setsampwidth(2)
+            f.setframerate(48000)
+            f.writeframes(data.tobytes())
+        print(json.dumps({"type": "result", "id": rid, "path": output}), flush=True)
+    except Exception as exc:
+        print(json.dumps({"type": "error", "id": rid, "error": str(exc), "trace": traceback.format_exc(limit=3)}), flush=True)
 `;
     AudioPlaybackTool = class {
       name = "audio_playback";
-      description = "Play audio through speakers, synthesize text-to-speech, and manage TTS clone voices. Actions: 'play' to play an audio file (WAV/MP3/OGG — including recordings from memory episodes), 'speak' to synthesize and play text, 'synthesize' to save TTS to a WAV file, 'clone' to register a voice-clone sample, 'list_voices' to inspect available clone refs/backends, 'volume' to get or set system volume, 'list' to enumerate audio output devices. TTS backends are explicit: auto, luxtts, supertonic, mlx, onnx/piper, or espeak. Neural TTS backends self-provision into ~/.omnius/voice on first use where supported. Use generate_tts when the task is specifically to create a TTS file; do not use shell speech commands or generate_audio for spoken TTS.";
+      description = "Play audio through speakers, synthesize text-to-speech, and manage TTS clone voices. Actions: 'play' to play an audio file (WAV/MP3/OGG — including recordings from memory episodes), 'speak' to synthesize and play text, 'synthesize' to save TTS to a WAV file, 'clone' to register a voice-clone source clip, 'list_voices' to inspect available clone refs/backends, 'volume' to get or set system volume, 'list' to enumerate audio output devices. TTS backends include auto, LuxTTS voice cloning, Supertonic, MLX, ONNX/Piper, and a local fallback. Neural TTS backends self-provision into ~/.omnius/voice on first use where supported. For cloned speech from a source clip, call generate_tts or audio_playback action=synthesize with sample/source_audio/voice_sample and backend=auto or luxtts. Use generate_tts when the task is specifically to create a TTS file; do not use shell speech commands or generate_audio for spoken TTS.";
       parameters = {
         type: "object",
         properties: {
@@ -507615,8 +508030,8 @@ except Exception as exc:
           },
           backend: {
             type: "string",
-            enum: ["auto", "luxtts", "supertonic", "mlx", "onnx", "piper", "espeak"],
-            description: "TTS backend. auto tries LuxTTS clone, Supertonic, MLX on Apple Silicon, Piper/ONNX, then espeak."
+            enum: ["auto", "luxtts", "supertonic", "mlx", "onnx", "piper"],
+            description: "TTS backend. auto tries LuxTTS clone, Supertonic, MLX on Apple Silicon, Piper/ONNX, then a local fallback."
           },
           output: {
             type: "string",
@@ -507632,11 +508047,31 @@ except Exception as exc:
           },
           sample: {
             type: "string",
-            description: "Audio sample path to register as a clone voice for action=clone."
+            description: "Audio source clip path to register or use as a LuxTTS clone voice."
+          },
+          source_audio: {
+            type: "string",
+            description: "Alias for sample. Use this for cloned speech from a source voice clip."
+          },
+          voice_sample: {
+            type: "string",
+            description: "Alias for sample/source_audio."
+          },
+          reference_audio: {
+            type: "string",
+            description: "Alias for sample/source_audio."
+          },
+          ref_audio: {
+            type: "string",
+            description: "Alias for sample/source_audio."
+          },
+          clone_sample: {
+            type: "string",
+            description: "Alias for sample/source_audio."
           },
           clone_name: {
             type: "string",
-            description: "Friendly filename stem for action=clone."
+            description: "Friendly filename stem for action=clone or for registering a source clip during synthesis."
           },
           model: {
             type: "string",
@@ -507652,11 +508087,11 @@ except Exception as exc:
           },
           speed: {
             type: "number",
-            description: "Speech speed. espeak uses words per minute; neural backends use a multiplier."
+            description: "Speech speed. Neural backends use a multiplier; local fallback uses its backend-specific rate."
           },
           voice: {
             type: "string",
-            description: "Voice id/name. Examples: Supertonic voice M4, MLX voice af_heart, espeak voice en-us, or Piper/ONNX model path."
+            description: "Voice id/name. Examples: Supertonic voice M4, MLX voice af_heart, a source audio path for cloning, or Piper/ONNX model path."
           },
           lang: {
             type: "string",
@@ -507720,9 +508155,9 @@ except Exception as exc:
         return await this.synthesizeText(args, start2, true);
       }
       cloneVoice(args, start2) {
-        const sample = typeof args["sample"] === "string" ? args["sample"] : typeof args["file"] === "string" ? args["file"] : "";
+        const sample = cloneSampleArg(args) || (typeof args["file"] === "string" ? args["file"] : "");
         if (!sample.trim()) {
-          return { success: false, output: "", error: "Missing 'sample' parameter. Provide a local audio sample to register as a clone voice.", durationMs: performance.now() - start2 };
+          return { success: false, output: "", error: "Missing source audio. Provide sample=<file> or source_audio=<file> to register as a clone voice.", durationMs: performance.now() - start2 };
         }
         const saved = saveCloneRefFromSample(sample, typeof args["clone_name"] === "string" ? args["clone_name"] : void 0);
         return {
@@ -507739,10 +508174,11 @@ except Exception as exc:
         const lines = [
           "TTS backends:",
           `  luxtts: ${existsSync40(join58(voiceDir(), "luxtts-venv", "bin", "python3")) ? "installed" : "not installed"}; clone refs: ${refs.length}`,
+          "    clone from source clip: generate_tts text=<words> source_audio=<wav/mp3/flac/ogg/m4a> backend=auto",
           `  supertonic: ${existsSync40(supertonicVenvPy()) ? "installed" : "not installed"}; voices include M1, M2, M3, M4 when package assets are available`,
           `  mlx: ${existsSync40(mlxVenvPy()) ? "installed" : "not installed"}; Apple Silicon only; default model mlx-community/Kokoro-82M-bf16`,
           `  piper/onnx: ${hasCommand3("piper") || existsSync40(piperVenvBin()) ? "available" : "not installed"}; first use installs piper-tts into ${piperVenvDir()}; pass model=<path.onnx> for raw ONNX voices`,
-          `  espeak: ${hasCommand3("espeak-ng") ? "available" : "not found"}`,
+          `  local fallback: ${hasCommand3("espeak-ng") ? "available" : "not found"}`,
           "",
           "Registered clone refs:",
           ...refs.length ? refs.map((ref) => `  ${ref}`) : ["  none"]
@@ -507756,11 +508192,20 @@ except Exception as exc:
         }
         const requestedBackend = normalizeTtsBackend(args["backend"]);
         const strictBackend = boolArg(args["strict_backend"] ?? args["strictBackend"], false);
+        const cloneRequested = wantsVoiceClone(args);
+        if (cloneRequested && requestedBackend !== "auto" && requestedBackend !== "luxtts") {
+          return {
+            success: false,
+            output: "",
+            error: "Voice cloning from a source clip requires backend=auto or backend=luxtts.",
+            durationMs: performance.now() - start2
+          };
+        }
         const playback = playbackArg(args, speakDefault);
         const outputPath2 = ttsOutputPath(args, requestedBackend);
         const device = typeof args["device"] === "string" ? args["device"] : "default";
         const tried = [];
-        const autoCandidates = ["luxtts", "supertonic", ...process.platform === "darwin" && process.arch === "arm64" ? ["mlx"] : [], "piper", "espeak"];
+        const autoCandidates = cloneRequested ? ["luxtts"] : ["luxtts", "supertonic", ...process.platform === "darwin" && process.arch === "arm64" ? ["mlx"] : [], "piper", "espeak"];
         const candidates = requestedBackend === "auto" ? autoCandidates : strictBackend ? [requestedBackend] : [requestedBackend, ...autoCandidates.filter((backend) => backend !== requestedBackend)];
         let usedBackend = "";
         let voiceSummary = "";
@@ -507823,21 +508268,19 @@ ${tried.map((line) => `- ${line}`).join("\n")}`,
         };
       }
       async synthesizeLuxtts(text, outputPath2, args) {
-        const cloneRef = resolveCloneRef(args["clone_ref"] ?? args["voice"] ?? args["sample"]);
+        const cloneRef = cloneRefForSynthesis(args);
         if (!cloneRef)
-          throw new Error(`No LuxTTS clone reference found. Register one with audio_playback action=clone sample=<file>.`);
+          throw new Error(`No LuxTTS clone source found. Provide source_audio=<voice clip> or clone_ref=<registered clip>.`);
         const speed = numberArg3(args["speed"], 1);
+        ensureLuxttsInstalled();
         const daemonReady = await ensureLuxttsDaemon();
         if (daemonReady) {
           await luxttsSynthesize(text, cloneRef, outputPath2, speed);
           if (existsSync40(outputPath2))
             return `${basename12(cloneRef)} (LuxTTS daemon)`;
         }
-        const venvPy = join58(voiceDir(), "luxtts-venv", "bin", "python3");
-        const repoDir = join58(voiceDir(), "LuxTTS");
-        if (!existsSync40(venvPy) || !existsSync40(repoDir)) {
-          throw new Error("LuxTTS is not installed in the managed voice environment yet.");
-        }
+        const venvPy = luxttsVenvPy();
+        const repoDir = luxttsRepoDir();
         const pyScript = [
           "import json, sys, wave",
           "import numpy as np, torch",
@@ -507913,7 +508356,7 @@ ${tried.map((line) => `- ${line}`).join("\n")}`,
       }
       synthesizeEspeak(text, outputPath2, args) {
         if (!hasCommand3("espeak-ng"))
-          throw new Error("espeak-ng command not found.");
+          throw new Error("Local fallback TTS command not found.");
         const voice = typeof args["voice"] === "string" ? args["voice"] : "en";
         const speed = Math.round(numberArg3(args["speed"], 160));
         execFileSync2("espeak-ng", ["-v", voice, "-s", String(speed), "-w", outputPath2, text], {
@@ -507995,20 +508438,27 @@ ${devices.join("\n")}`,
     };
     TtsGenerateTool = class {
       name = "generate_tts";
-      description = "Generate text-to-speech audio as a WAV file, optionally playing it after synthesis. Supports explicit backends: auto, luxtts voice cloning, supertonic, mlx, onnx/piper, and espeak. Neural TTS backends self-provision into ~/.omnius/voice on first use where supported. Use clone_ref to select a registered LuxTTS voice, sample+clone_name to register a clone sample via audio_playback action=clone, and playback=false for silent file generation. Use this tool for speech/TTS requests; do not use shell commands or generate_audio as a TTS fallback.";
+      description = "Generate text-to-speech audio as a WAV file, optionally playing it after synthesis. Supports explicit backends: auto, LuxTTS voice cloning, Supertonic, MLX, ONNX/Piper, and local fallback. Neural TTS backends self-provision into ~/.omnius/voice on first use where supported. For voice cloning, pass source_audio/sample/voice_sample with the reference clip and backend=auto or luxtts; clone_name can register it for reuse. Use clone_ref to select a registered LuxTTS voice and playback=false for silent file generation. Use this tool for speech/TTS requests; do not use shell commands or generate_audio as a TTS fallback.";
       parameters = {
         type: "object",
         properties: {
           text: { type: "string", description: "Text to synthesize" },
           input: { type: "string", description: "Alias for text." },
           prompt: { type: "string", description: "Alias for text." },
-          backend: { type: "string", enum: ["auto", "luxtts", "supertonic", "mlx", "onnx", "piper", "espeak"] },
+          backend: { type: "string", enum: ["auto", "luxtts", "supertonic", "mlx", "onnx", "piper"] },
           output: { type: "string", description: "Output WAV path. Defaults to ~/.omnius/voice/generated/tts-*.wav." },
           path: { type: "string", description: "Alias for output." },
           playback: { type: "boolean", description: "Whether to play after generating. Defaults false for generate_tts." },
           strict_backend: { type: "boolean", description: "When true, fail instead of falling back if the requested backend is unavailable. Defaults false." },
           voice: { type: "string", description: "Voice id/name, or raw Piper/ONNX path when backend=onnx/piper." },
           clone_ref: { type: "string", description: "LuxTTS clone reference path, filename, or registered clone name." },
+          sample: { type: "string", description: "Voice source clip path for cloned speech. Alias: source_audio." },
+          source_audio: { type: "string", description: "Voice source clip path for cloned speech." },
+          voice_sample: { type: "string", description: "Alias for source_audio." },
+          reference_audio: { type: "string", description: "Alias for source_audio." },
+          ref_audio: { type: "string", description: "Alias for source_audio." },
+          clone_sample: { type: "string", description: "Alias for source_audio." },
+          clone_name: { type: "string", description: "Optional name to register the source clip for later reuse." },
           model: { type: "string", description: "Backend model id or raw ONNX/Piper model path." },
           lang: { type: "string", description: "Language code for Supertonic/MLX where supported." },
           speed: { type: "number", description: "Speech speed multiplier or backend-specific rate." },
@@ -542582,7 +543032,7 @@ ${result}`
             let resizedBase64 = null;
             try {
               const { execSync: execSync60 } = await import("node:child_process");
-              const { writeFileSync: writeFileSync71, readFileSync: readFileSync102, unlinkSync: unlinkSync25 } = await import("node:fs");
+              const { writeFileSync: writeFileSync71, readFileSync: readFileSync102, unlinkSync: unlinkSync26 } = await import("node:fs");
               const { join: join142 } = await import("node:path");
               const { tmpdir: tmpdir23 } = await import("node:os");
               const tmpIn = join142(tmpdir23(), `omnius_img_in_${Date.now()}.png`);
@@ -542595,11 +543045,11 @@ ${result}`
               const resizedBuf = readFileSync102(tmpOut);
               resizedBase64 = `data:image/jpeg;base64,${resizedBuf.toString("base64")}`;
               try {
-                unlinkSync25(tmpIn);
+                unlinkSync26(tmpIn);
               } catch {
               }
               try {
-                unlinkSync25(tmpOut);
+                unlinkSync26(tmpOut);
               } catch {
               }
             } catch {
@@ -551117,7 +551567,7 @@ var require_websocket3 = __commonJS({
     var http6 = __require("http");
     var net5 = __require("net");
     var tls2 = __require("tls");
-    var { randomBytes: randomBytes25, createHash: createHash24 } = __require("crypto");
+    var { randomBytes: randomBytes26, createHash: createHash24 } = __require("crypto");
     var { Duplex: Duplex3, Readable } = __require("stream");
     var { URL: URL3 } = __require("url");
     var PerMessageDeflate3 = require_permessage_deflate3();
@@ -551647,7 +552097,7 @@ var require_websocket3 = __commonJS({
         }
       }
       const defaultPort = isSecure ? 443 : 80;
-      const key = randomBytes25(16).toString("base64");
+      const key = randomBytes26(16).toString("base64");
       const request = isSecure ? https4.request : http6.request;
       const protocolSet = /* @__PURE__ */ new Set();
       let perMessageDeflate;
@@ -575357,19 +575807,19 @@ function modelOnnxPath(id) {
 function modelConfigPath(id) {
   return join109(modelDir(id), "config.json");
 }
-function luxttsVenvDir() {
+function luxttsVenvDir2() {
   return join109(voiceDir2(), "luxtts-venv");
 }
-function luxttsVenvPy() {
-  return platform5() === "win32" ? join109(luxttsVenvDir(), "Scripts", "python.exe") : join109(luxttsVenvDir(), "bin", "python3");
+function luxttsVenvPy2() {
+  return platform5() === "win32" ? join109(luxttsVenvDir2(), "Scripts", "python.exe") : join109(luxttsVenvDir2(), "bin", "python3");
 }
-function luxttsRepoDir() {
+function luxttsRepoDir2() {
   return join109(voiceDir2(), "LuxTTS");
 }
 function luxttsCloneRefsDir() {
   return join109(voiceDir2(), "clone-refs");
 }
-function luxttsInferScript() {
+function luxttsInferScript2() {
   return join109(voiceDir2(), "luxtts-infer.py");
 }
 function supertonicVenvDir() {
@@ -577936,12 +578386,12 @@ Error: ${err2 instanceof Error ? err2.message : String(err2)}`
             "python3 not found. LuxTTS requires Python 3.10+. Try: apt install python3 / brew install python3"
           );
         }
-        const venvDir = luxttsVenvDir();
-        const venvPy = luxttsVenvPy();
+        const venvDir = luxttsVenvDir2();
+        const venvPy = luxttsVenvPy2();
         if (existsSync95(venvPy)) {
           try {
             const quotedPy = `"${venvPy}"`;
-            const repoPath = luxttsRepoDir().replace(/\\/g, "/");
+            const repoPath = luxttsRepoDir2().replace(/\\/g, "/");
             await this.asyncShell(
               `${quotedPy} -c "import sys; sys.path.insert(0, '${repoPath}'); from zipvoice.luxvoice import LuxTTS; print('ok')"`,
               3e4
@@ -578055,7 +578505,7 @@ Error: ${err2 instanceof Error ? err2.message : String(err2)}`
             }
           }
         }
-        const repoDir = luxttsRepoDir();
+        const repoDir = luxttsRepoDir2();
         if (!existsSync95(join109(repoDir, "zipvoice", "luxvoice.py"))) {
           renderInfo("  Cloning LuxTTS repository...");
           try {
@@ -578479,18 +578929,18 @@ def main():
 if __name__ == '__main__':
     main()
 `;
-        const scriptPath2 = luxttsInferScript();
+        const scriptPath2 = luxttsInferScript2();
         mkdirSync52(voiceDir2(), { recursive: true });
         writeFileSync49(scriptPath2, script);
       }
       /** Ensure the LuxTTS daemon is running, spawn if needed */
       async ensureLuxttsDaemon() {
         if (this._luxttsDaemon && !this._luxttsDaemon.killed) return true;
-        const venvPy = luxttsVenvPy();
+        const venvPy = luxttsVenvPy2();
         if (!existsSync95(venvPy)) return false;
         return new Promise((resolve48) => {
-          const env2 = { ...process.env, LUXTTS_REPO_PATH: luxttsRepoDir() };
-          const daemon = nodeSpawn(venvPy, [luxttsInferScript()], {
+          const env2 = { ...process.env, LUXTTS_REPO_PATH: luxttsRepoDir2() };
+          const daemon = nodeSpawn(venvPy, [luxttsInferScript2()], {
             stdio: ["pipe", "pipe", "pipe"],
             cwd: tmpdir20(),
             env: env2
@@ -579688,11 +580138,11 @@ async function handleSlashCommand(input, ctx3) {
         }
         if (action === "new") {
           try {
-            const { randomBytes: randomBytes25 } = await import("node:crypto");
+            const { randomBytes: randomBytes26 } = await import("node:crypto");
             const { homedir: homedir48 } = await import("node:os");
             const { mkdirSync: mkdirSync76, writeFileSync: writeFileSync71 } = await import("node:fs");
             const { join: join142 } = await import("node:path");
-            const newKey = randomBytes25(16).toString("hex");
+            const newKey = randomBytes26(16).toString("hex");
             process.env["OMNIUS_API_KEY"] = newKey;
             const dir = join142(homedir48(), ".omnius");
             mkdirSync76(dir, { recursive: true });
@@ -579949,8 +580399,8 @@ async function handleSlashCommand(input, ctx3) {
           }
           process.env["OMNIUS_ACCESS"] = val2;
           if (val2 === "any" && !process.env["OMNIUS_API_KEY"]) {
-            const { randomBytes: randomBytes25 } = await import("node:crypto");
-            const apiKey = randomBytes25(16).toString("hex");
+            const { randomBytes: randomBytes26 } = await import("node:crypto");
+            const apiKey = randomBytes26(16).toString("hex");
             process.env["OMNIUS_API_KEY"] = apiKey;
             renderInfo(`Generated API key: ${c3.bold(c3.yellow(apiKey))}`);
             renderInfo(
@@ -580069,8 +580519,8 @@ async function handleSlashCommand(input, ctx3) {
       }
       process.env["OMNIUS_ACCESS"] = val;
       if (val === "any" && !process.env["OMNIUS_API_KEY"]) {
-        const { randomBytes: randomBytes25 } = await import("node:crypto");
-        const apiKey = randomBytes25(16).toString("hex");
+        const { randomBytes: randomBytes26 } = await import("node:crypto");
+        const apiKey = randomBytes26(16).toString("hex");
         process.env["OMNIUS_API_KEY"] = apiKey;
         renderInfo(`Generated API key: ${c3.bold(c3.yellow(apiKey))}`);
         renderInfo(
@@ -590377,11 +590827,11 @@ var init_commands = __esm({
           process.env["OMNIUS_ACCESS"] = val;
           if (val === "any" && !process.env["OMNIUS_API_KEY"]) {
             try {
-              const { randomBytes: randomBytes25 } = await import("node:crypto");
+              const { randomBytes: randomBytes26 } = await import("node:crypto");
               const { homedir: homedir48 } = await import("node:os");
               const { mkdirSync: mkdirSync76, writeFileSync: writeFileSync71 } = await import("node:fs");
               const { join: join142 } = await import("node:path");
-              const apiKey = randomBytes25(16).toString("hex");
+              const apiKey = randomBytes26(16).toString("hex");
               process.env["OMNIUS_API_KEY"] = apiKey;
               const dir = join142(homedir48(), ".omnius");
               mkdirSync76(dir, { recursive: true });
@@ -596404,11 +596854,13 @@ var init_tool_policy = __esm({
 });
 
 // packages/cli/src/tui/telegram-creative-tools.ts
+import { createCipheriv as createCipheriv4, createDecipheriv as createDecipheriv4, randomBytes as randomBytes21 } from "node:crypto";
 import {
   existsSync as existsSync104,
   mkdirSync as mkdirSync59,
   readFileSync as readFileSync85,
   statSync as statSync35,
+  unlinkSync as unlinkSync19,
   writeFileSync as writeFileSync55
 } from "node:fs";
 import { mkdir as mkdir17 } from "node:fs/promises";
@@ -596435,6 +596887,7 @@ function formatTelegramCreativeWorkspacePrompt(root) {
     `Workspace root: ${root}`,
     "Creative file tools are scoped to that folder only.",
     "Allowed: create and send non-executable creative artifacts in this workspace.",
+    "At rest, artifacts are stored as random internal blobs with random header bytes; requested filenames are logical names restored only during Telegram upload.",
     "Forbidden: delete files, create scripts/executables, access paths outside this workspace, mutate the project tree, run shell/Python/code commands, or touch system state.",
     "When a user asks for an artifact to be sent, create it here and then call telegram_send_file. The bridge also auto-attaches recorded artifacts as a fallback. Refer to the attachment naturally; do not expose filesystem paths unless the admin explicitly asks."
   ].join("\n");
@@ -596461,7 +596914,7 @@ function collectGeneratedArtifactPathsFromText(text, root) {
     const value2 = match[1];
     if (!value2) continue;
     const guarded = guardPath(rootAbs, value2);
-    if (guarded.ok && existsSync104(guarded.path.abs) && safeStatFile(guarded.path.abs)) {
+    if (guarded.ok && (isManifestArtifact(rootAbs, guarded.path.rel) || existsSync104(guarded.path.abs) && safeStatFile(guarded.path.abs))) {
       paths.add(guarded.path.abs);
     }
   }
@@ -596470,7 +596923,7 @@ function collectGeneratedArtifactPathsFromText(text, root) {
     const value2 = marker?.[1]?.trim().replace(/^["']|["']$/g, "");
     if (!value2) continue;
     const guarded = guardPath(rootAbs, value2);
-    if (guarded.ok && existsSync104(guarded.path.abs) && safeStatFile(guarded.path.abs)) {
+    if (guarded.ok && (isManifestArtifact(rootAbs, guarded.path.rel) || existsSync104(guarded.path.abs) && safeStatFile(guarded.path.abs))) {
       paths.add(guarded.path.abs);
     }
   }
@@ -596480,11 +596933,7 @@ function buildTelegramCreativeTools(repoRoot, chatId, backendUrl, imageDefaults
   const root = telegramCreativeWorkspaceRoot(repoRoot, chatId);
   ensureManifest(root);
   return [
-    scopedTool(new FileReadTool(root), root, "read"),
-    scopedTool(new ListDirectoryTool(root), root, "list"),
     scopedTool(new FileWriteTool(root), root, "create"),
-    scopedTool(new FileEditTool(root), root, "edit"),
-    scopedTool(new FilePatchTool(root), root, "edit"),
     scopedTool(new StructuredFileTool(root), root, "create"),
     scopedTool(new ImageGenerateTool(root, backendUrl, imageDefaults), root, "generate"),
     scopedTool(new AudioGenerateTool(root, audioDefaults), root, "generate"),
@@ -596501,6 +596950,7 @@ function scopedTool(base3, root, mode) {
     async execute(args) {
       const next = { ...args };
       if (base3.name === "generate_image" || base3.name === "generate_audio" || base3.name === "generate_tts") {
+        const cleanup = [];
         const localModel = typeof next["model_path"] === "string" ? String(next["model_path"]) : typeof next["model"] === "string" && looksLikeLocalPath(String(next["model"])) ? String(next["model"]) : "";
         if (localModel) {
           const guarded = guardPath(rootAbs, localModel);
@@ -596509,6 +596959,22 @@ function scopedTool(base3, root, mode) {
           else next["model"] = guarded.path.abs;
         }
         if (base3.name === "generate_tts") {
+          for (const key of TTS_CLONE_SOURCE_KEYS) {
+            const value2 = next[key];
+            if (typeof value2 !== "string" || !value2.trim()) continue;
+            const materialized = materializeTelegramCreativeArtifactForSend(rootAbs, value2.trim());
+            if (!materialized.ok) return denied(materialized.error);
+            next[key] = materialized.path;
+            if (materialized.cleanup) cleanup.push(materialized.cleanup);
+          }
+          for (const key of ["clone_ref", "voice"]) {
+            const value2 = next[key];
+            if (typeof value2 !== "string" || !value2.trim() || !looksLikeAudioPath(value2.trim())) continue;
+            const materialized = materializeTelegramCreativeArtifactForSend(rootAbs, value2.trim());
+            if (!materialized.ok) return denied(materialized.error);
+            next[key] = materialized.path;
+            if (materialized.cleanup) cleanup.push(materialized.cleanup);
+          }
           const rawOutput = typeof next["output"] === "string" && String(next["output"]).trim() ? String(next["output"]) : typeof next["output_path"] === "string" && String(next["output_path"]).trim() ? String(next["output_path"]) : `tts-${Date.now()}.wav`;
           const guardedOutput = guardPath(rootAbs, rawOutput);
           if (!guardedOutput.ok) return denied(guardedOutput.error);
@@ -596518,16 +596984,20 @@ function scopedTool(base3, root, mode) {
           next["output"] = guardedOutput.path.abs;
           next["playback"] = false;
         }
-        const result2 = await base3.execute(next);
-        if (result2.success) {
-          if (base3.name === "generate_tts" && typeof next["output"] === "string") {
-            rememberCreated(rootAbs, String(next["output"]));
-          }
-          for (const path11 of collectGeneratedArtifactPathsFromText(result2.output, rootAbs)) {
-            rememberCreated(rootAbs, path11);
+        try {
+          const result2 = await base3.execute(next);
+          if (result2.success) {
+            if (base3.name === "generate_tts" && typeof next["output"] === "string") {
+              rememberCreated(rootAbs, String(next["output"]));
+            }
+            for (const path11 of collectGeneratedArtifactPathsFromText(result2.output, rootAbs)) {
+              rememberCreated(rootAbs, path11);
+            }
           }
+          return result2;
+        } finally {
+          for (const fn of cleanup) fn();
         }
-        return result2;
       }
       const pathKey = PATH_KEYS.find((key) => typeof next[key] === "string" && String(next[key]).trim());
       if (pathKey) {
@@ -596592,6 +597062,9 @@ function isInside(root, path11) {
 function looksLikeLocalPath(value2) {
   return value2.startsWith("/") || value2.startsWith("./") || value2.startsWith("../");
 }
+function looksLikeAudioPath(value2) {
+  return looksLikeLocalPath(value2) || value2.startsWith("~/") || /\.(wav|mp3|flac|ogg|m4a)$/i.test(value2);
+}
 function manifestPath(root) {
   return join119(root, MANIFEST_FILE);
 }
@@ -596606,12 +597079,21 @@ function readManifest(root) {
   ensureManifest(root);
   try {
     const parsed = JSON.parse(readFileSync85(manifestPath(root), "utf8"));
+    const objects = parsed.objects && typeof parsed.objects === "object" ? Object.fromEntries(
+      Object.entries(parsed.objects).filter((entry) => {
+        const value2 = entry[1];
+        return Boolean(
+          value2 && typeof value2.logicalRel === "string" && typeof value2.storedRel === "string" && typeof value2.originalName === "string" && typeof value2.prefixBytes === "number" && typeof value2.size === "number"
+        );
+      })
+    ) : {};
     return {
       files: Array.isArray(parsed.files) ? parsed.files.filter((file) => typeof file === "string") : [],
+      objects,
       updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : (/* @__PURE__ */ new Date()).toISOString()
     };
   } catch {
-    return { files: [], updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    return { files: [], objects: {}, updatedAt: (/* @__PURE__ */ new Date()).toISOString() };
   }
 }
 function writeManifest(root, manifest) {
@@ -596620,18 +597102,114 @@ function writeManifest(root, manifest) {
 }
 function manifestHas(root, relPath) {
   const rel = relPath.replace(/\\/g, "/");
-  return readManifest(root).files.includes(rel);
+  const manifest = readManifest(root);
+  return manifest.files.includes(rel) || Boolean(manifest.objects?.[rel]);
 }
 function rememberCreated(root, absPath) {
   const guarded = guardPath(root, absPath);
   if (!guarded.ok || guarded.path.rel === ".") return;
   const manifest = readManifest(root);
   const rel = guarded.path.rel.replace(/\\/g, "/");
+  if (publicCreativeArtifactPolicyError(guarded.path.abs)) return;
+  if (existsSync104(guarded.path.abs) && safeStatFile(guarded.path.abs)) {
+    const previous = manifest.objects?.[rel];
+    if (previous) {
+      const previousPath = resolve38(root, previous.storedRel);
+      if (isInside(resolve38(root), previousPath) && existsSync104(previousPath)) {
+        try {
+          unlinkSync19(previousPath);
+        } catch {
+        }
+      }
+    }
+    mkdirSync59(join119(root, OBJECTS_DIR), { recursive: true });
+    const data = readFileSync85(guarded.path.abs);
+    const prefix = randomBytes21(48);
+    const key = randomBytes21(32);
+    const iv = randomBytes21(12);
+    const cipher = createCipheriv4("aes-256-gcm", key, iv);
+    const encrypted = Buffer.concat([cipher.update(data), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    const storedRel = join119(OBJECTS_DIR, `${Date.now()}-${randomBytes21(12).toString("hex")}.blob`).replace(/\\/g, "/");
+    const storedAbs = join119(root, storedRel);
+    writeFileSync55(storedAbs, Buffer.concat([prefix, encrypted]));
+    try {
+      unlinkSync19(guarded.path.abs);
+    } catch {
+    }
+    manifest.objects = manifest.objects || {};
+    manifest.objects[rel] = {
+      logicalRel: rel,
+      storedRel,
+      originalName: basename22(guarded.path.abs),
+      prefixBytes: prefix.length,
+      encrypted: true,
+      key: key.toString("base64"),
+      iv: iv.toString("base64"),
+      tag: tag.toString("base64"),
+      size: data.length,
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+  }
   if (!manifest.files.includes(rel)) manifest.files.push(rel);
   manifest.files.sort();
   manifest.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   writeManifest(root, manifest);
 }
+function isManifestArtifact(root, relPath) {
+  return manifestHas(root, relPath);
+}
+function materializeTelegramCreativeArtifactForSend(root, rawPath) {
+  const rootAbs = resolve38(root);
+  const guarded = guardPath(rootAbs, rawPath);
+  if (!guarded.ok) return { ok: false, error: guarded.error };
+  const policyError = publicCreativeArtifactPolicyError(guarded.path.abs);
+  if (policyError) return { ok: false, error: policyError };
+  const manifest = readManifest(rootAbs);
+  const rel = guarded.path.rel.replace(/\\/g, "/");
+  const object = manifest.objects?.[rel];
+  if (object) {
+    const storedAbs = resolve38(rootAbs, object.storedRel);
+    if (!isInside(rootAbs, storedAbs) || !existsSync104(storedAbs) || !safeStatFile(storedAbs)) {
+      return { ok: false, error: `Scoped artifact storage is missing for ${rel}.` };
+    }
+    const blob = readFileSync85(storedAbs);
+    if (blob.length < object.prefixBytes) {
+      return { ok: false, error: `Scoped artifact storage is corrupt for ${rel}.` };
+    }
+    let payload = blob.subarray(object.prefixBytes);
+    if (object.encrypted) {
+      if (!object.key || !object.iv || !object.tag) {
+        return { ok: false, error: `Scoped artifact encryption metadata is missing for ${rel}.` };
+      }
+      const decipher = createDecipheriv4(
+        "aes-256-gcm",
+        Buffer.from(object.key, "base64"),
+        Buffer.from(object.iv, "base64")
+      );
+      decipher.setAuthTag(Buffer.from(object.tag, "base64"));
+      payload = Buffer.concat([decipher.update(payload), decipher.final()]);
+    }
+    const stageDir = join119(rootAbs, SEND_DIR, `${Date.now()}-${randomBytes21(8).toString("hex")}`);
+    mkdirSync59(stageDir, { recursive: true });
+    const staged = join119(stageDir, object.originalName || basename22(rel));
+    writeFileSync55(staged, payload);
+    return {
+      ok: true,
+      path: staged,
+      cleanup: () => {
+        try {
+          unlinkSync19(staged);
+        } catch {
+        }
+      }
+    };
+  }
+  if (existsSync104(guarded.path.abs) && safeStatFile(guarded.path.abs)) {
+    return { ok: true, path: guarded.path.abs };
+  }
+  return { ok: false, error: `Scoped artifact not found in manifest: ${rawPath}` };
+}
 function safeStatFile(path11) {
   try {
     return statSync35(path11).isFile();
@@ -596649,14 +597227,16 @@ function denied(error) {
     mutatedFiles: []
   };
 }
-var MANIFEST_FILE, PATH_KEYS, MEDIA_PATH_RE, PUBLIC_EXECUTABLE_ARTIFACT_EXTENSIONS, CreativeAudioFileTool;
+var MANIFEST_FILE, OBJECTS_DIR, SEND_DIR, PATH_KEYS, TTS_CLONE_SOURCE_KEYS, MEDIA_PATH_RE, PUBLIC_EXECUTABLE_ARTIFACT_EXTENSIONS, CreativeAudioFileTool;
 var init_telegram_creative_tools = __esm({
   "packages/cli/src/tui/telegram-creative-tools.ts"() {
     "use strict";
-    init_typed_node_events();
     init_dist5();
     MANIFEST_FILE = ".omnius-creative-manifest.json";
+    OBJECTS_DIR = ".objects";
+    SEND_DIR = ".send";
     PATH_KEYS = ["path", "file", "file_path", "filename", "filepath", "filePath"];
+    TTS_CLONE_SOURCE_KEYS = ["sample", "source_audio", "voice_sample", "reference_audio", "ref_audio", "clone_sample"];
     MEDIA_PATH_RE = /(?:^|[\s([])(\/[^\s<>"')\]]+\.[A-Za-z0-9]{1,12})(?:$|[\s),.\]])/g;
     PUBLIC_EXECUTABLE_ARTIFACT_EXTENSIONS = /* @__PURE__ */ new Set([
       ".sh",
@@ -596731,9 +597311,16 @@ var init_telegram_creative_tools = __esm({
           input: { type: "string", description: "Alias for text" },
           prompt: { type: "string", description: "Alias for text" },
           path: { type: "string", description: "Output .wav path inside the creative workspace" },
-          backend: { type: "string", enum: ["auto", "luxtts", "supertonic", "mlx", "onnx", "piper", "espeak"], description: "TTS backend. Defaults to auto." },
-          voice: { type: "string", description: "Voice id/name for the selected TTS backend" },
+          backend: { type: "string", enum: ["auto", "luxtts", "supertonic", "mlx", "onnx", "piper"], description: "TTS backend. Defaults to auto." },
+          voice: { type: "string", description: "Voice id/name for the selected TTS backend, or a scoped source audio path for cloning" },
           clone_ref: { type: "string", description: "Optional LuxTTS clone reference" },
+          sample: { type: "string", description: "Voice source clip path inside the creative workspace" },
+          source_audio: { type: "string", description: "Alias for sample" },
+          voice_sample: { type: "string", description: "Alias for sample" },
+          reference_audio: { type: "string", description: "Alias for sample" },
+          ref_audio: { type: "string", description: "Alias for sample" },
+          clone_sample: { type: "string", description: "Alias for sample" },
+          clone_name: { type: "string", description: "Optional name to register the source clip for later reuse" },
           model: { type: "string", description: "Optional backend model id or raw Piper/ONNX path" },
           speed: { type: "number", description: "Speech speed multiplier or backend-specific rate" }
         },
@@ -596752,26 +597339,57 @@ var init_telegram_creative_tools = __esm({
         if (!guarded.path.abs.toLowerCase().endsWith(".wav")) {
           return denied("create_audio_file currently writes WAV files; use a .wav output path.");
         }
-        await mkdir17(dirname33(guarded.path.abs), { recursive: true });
-        const tts = new TtsGenerateTool();
-        const result = await tts.execute({
-          text,
-          output: guarded.path.abs,
-          playback: false,
-          backend: args["backend"],
-          voice: args["voice"],
-          clone_ref: args["clone_ref"],
-          model: args["model"],
-          speed: args["speed"]
-        });
-        if (!result.success || !existsSync104(guarded.path.abs)) {
-          return {
-            success: false,
-            output: "",
-            error: `Audio synthesis failed through generate_tts.
+        const cloneArgs = {};
+        const cleanup = [];
+        for (const key of TTS_CLONE_SOURCE_KEYS) {
+          const value2 = args[key];
+          if (typeof value2 !== "string" || !value2.trim()) continue;
+          const materialized = materializeTelegramCreativeArtifactForSend(this.root, value2.trim());
+          if (!materialized.ok) return denied(materialized.error);
+          cloneArgs[key] = materialized.path;
+          if (materialized.cleanup) cleanup.push(materialized.cleanup);
+        }
+        for (const key of ["clone_ref", "voice"]) {
+          const value2 = args[key];
+          if (typeof value2 !== "string" || !value2.trim() || !looksLikeAudioPath(value2.trim())) continue;
+          const materialized = materializeTelegramCreativeArtifactForSend(this.root, value2.trim());
+          if (!materialized.ok) return denied(materialized.error);
+          cloneArgs[key] = materialized.path;
+          if (materialized.cleanup) cleanup.push(materialized.cleanup);
+        }
+        let result;
+        try {
+          await mkdir17(dirname33(guarded.path.abs), { recursive: true });
+          const tts = new TtsGenerateTool();
+          result = await tts.execute({
+            text,
+            output: guarded.path.abs,
+            playback: false,
+            backend: args["backend"],
+            voice: cloneArgs["voice"] ?? args["voice"],
+            clone_ref: cloneArgs["clone_ref"] ?? args["clone_ref"],
+            ...cloneArgs,
+            sample: cloneArgs["sample"],
+            source_audio: cloneArgs["source_audio"],
+            voice_sample: cloneArgs["voice_sample"],
+            reference_audio: cloneArgs["reference_audio"],
+            ref_audio: cloneArgs["ref_audio"],
+            clone_sample: cloneArgs["clone_sample"],
+            clone_name: args["clone_name"],
+            model: args["model"],
+            speed: args["speed"]
+          });
+          if (!result.success || !existsSync104(guarded.path.abs)) {
+            return {
+              success: false,
+              output: "",
+              error: `Audio synthesis failed through generate_tts.
 ${(result.error || result.output || "").slice(0, 1200)}`,
-            durationMs: performance.now() - start2
-          };
+              durationMs: performance.now() - start2
+            };
+          }
+        } finally {
+          for (const fn of cleanup) fn();
         }
         rememberCreated(this.root, guarded.path.abs);
         const sizeKB = Math.round(statSync35(guarded.path.abs).size / 1024);
@@ -596800,7 +597418,7 @@ __export(vision_ingress_exports, {
   runVisionIngress: () => runVisionIngress
 });
 import { execFileSync as execFileSync4 } from "node:child_process";
-import { existsSync as existsSync105, readFileSync as readFileSync86, unlinkSync as unlinkSync19 } from "node:fs";
+import { existsSync as existsSync105, readFileSync as readFileSync86, unlinkSync as unlinkSync20 } from "node:fs";
 import { join as join120 } from "node:path";
 function isTesseractAvailable() {
   try {
@@ -596858,7 +597476,7 @@ function advancedOcr(imagePath) {
         const text = readFileSync86(txtFile, "utf-8").trim();
         if (text.length > 0) results.push(text);
         try {
-          unlinkSync19(txtFile);
+          unlinkSync20(txtFile);
         } catch {
         }
       }
@@ -596943,7 +597561,7 @@ var init_vision_ingress = __esm({
 });
 
 // packages/cli/src/tui/telegram-bridge.ts
-import { mkdirSync as mkdirSync60, existsSync as existsSync106, unlinkSync as unlinkSync20, readdirSync as readdirSync36, statSync as statSync36, readFileSync as readFileSync87, writeFileSync as writeFileSync57 } from "node:fs";
+import { mkdirSync as mkdirSync60, existsSync as existsSync106, unlinkSync as unlinkSync21, readdirSync as readdirSync36, statSync as statSync36, readFileSync as readFileSync87, writeFileSync as writeFileSync57 } from "node:fs";
 import { join as join121, resolve as resolve39, basename as basename23, relative as relative13, isAbsolute as isAbsolute7 } from "node:path";
 import { writeFile as writeFileAsync } from "node:fs/promises";
 import { createHash as createHash19, randomInt } from "node:crypto";
@@ -600325,6 +600943,8 @@ Scoped workspace: ${scopedRoot}`,
                 error: `Telegram file upload failed: ${err instanceof Error ? err.message : String(err)}`,
                 durationMs: performance.now() - start2
               };
+            } finally {
+              file.cleanup?.();
             }
           }
         };
@@ -600378,14 +600998,12 @@ ${knownList}` : "Private-user telegram_send_file target must be this DM or a kno
       resolveTelegramFilePath(rawPath, repoRoot, scopedRoot) {
         const base3 = scopedRoot ? resolve39(scopedRoot) : resolve39(repoRoot);
         const trimmed = rawPath.trim().replace(/^["']|["']$/g, "");
-        const abs = isAbsolute7(trimmed) ? resolve39(trimmed) : resolve39(base3, trimmed);
-        if (scopedRoot && !isPathInside(base3, abs)) {
-          return { ok: false, error: `Public/group telegram_send_file can only send files inside ${base3}.` };
-        }
         if (scopedRoot) {
-          const policyError = publicCreativeArtifactPolicyError(abs);
-          if (policyError) return { ok: false, error: policyError };
+          const materialized = materializeTelegramCreativeArtifactForSend(base3, trimmed);
+          if (!materialized.ok) return materialized;
+          return materialized;
         }
+        const abs = isAbsolute7(trimmed) ? resolve39(trimmed) : resolve39(base3, trimmed);
         if (!existsSync106(abs)) return { ok: false, error: `File does not exist: ${trimmed}` };
         if (!statSync36(abs).isFile()) return { ok: false, error: `Path is not a file: ${trimmed}` };
         return { ok: true, path: abs };
@@ -600546,7 +601164,7 @@ ${visionContext}]`;
         for (const [key, entry] of this.mediaCache) {
           if (now - entry.cachedAt > MEDIA_CACHE_TTL_MS) {
             try {
-              unlinkSync20(entry.localPath);
+              unlinkSync21(entry.localPath);
             } catch {
             }
             this.mediaCache.delete(key);
@@ -600713,15 +601331,22 @@ Content-Type: ${contentType}\r
           const abs = resolve39(path11);
           if (!isPathInside(rootAbs, abs)) continue;
           if (!includeMentioned && alreadySentByText.has(abs)) continue;
-          if (!existsSync106(abs) || !statSync36(abs).isFile()) continue;
-          const kind = classifyMedia(abs) ?? "document";
+          const materialized = materializeTelegramCreativeArtifactForSend(rootAbs, abs);
+          if (!materialized.ok) continue;
+          if (!existsSync106(materialized.path) || !statSync36(materialized.path).isFile()) {
+            materialized.cleanup?.();
+            continue;
+          }
+          const kind = classifyMedia(materialized.path) ?? "document";
           await this.sendMediaReference(msg.chatId, {
-            original: abs,
-            value: abs,
+            original: materialized.path,
+            value: materialized.path,
             kind,
             source: "file",
             audioAsVoice: kind === "voice"
-          }).catch(() => null);
+          }).catch(() => null).finally(() => {
+            materialized.cleanup?.();
+          });
         }
       }
       async uploadTelegramFiles(method, fields, files) {
@@ -601163,7 +601788,7 @@ import {
   writeFileSync as writeFileSync58,
   renameSync as renameSync5,
   mkdirSync as mkdirSync61,
-  unlinkSync as unlinkSync21
+  unlinkSync as unlinkSync22
 } from "node:fs";
 import { join as join122 } from "node:path";
 import { homedir as homedir36 } from "node:os";
@@ -601201,7 +601826,7 @@ function persistInFlight(j) {
 function deleteInFlightFile(id) {
   try {
     const p2 = inFlightPath(id);
-    if (existsSync107(p2)) unlinkSync21(p2);
+    if (existsSync107(p2)) unlinkSync22(p2);
   } catch {
   }
 }
@@ -601422,7 +602047,7 @@ function drainCheckins(sessionId) {
   try {
     const raw = readFileSync88(fp, "utf-8");
     try {
-      unlinkSync21(fp);
+      unlinkSync22(fp);
     } catch {
     }
     if (!raw.trim()) return [];
@@ -601460,7 +602085,7 @@ function listSessions2() {
 function deleteSession2(id) {
   try {
     const p2 = sessionPath(id);
-    if (existsSync107(p2)) unlinkSync21(p2);
+    if (existsSync107(p2)) unlinkSync22(p2);
   } catch {
   }
   deleteInFlightFile(id);
@@ -602396,7 +603021,7 @@ var init_access_policy = __esm({
 
 // packages/cli/src/api/project-preferences.ts
 import { createHash as createHash20 } from "node:crypto";
-import { existsSync as existsSync109, mkdirSync as mkdirSync63, readFileSync as readFileSync90, renameSync as renameSync7, writeFileSync as writeFileSync60, unlinkSync as unlinkSync22 } from "node:fs";
+import { existsSync as existsSync109, mkdirSync as mkdirSync63, readFileSync as readFileSync90, renameSync as renameSync7, writeFileSync as writeFileSync60, unlinkSync as unlinkSync23 } from "node:fs";
 import { homedir as homedir38 } from "node:os";
 import { join as join124, resolve as resolve41 } from "node:path";
 import { randomUUID as randomUUID15 } from "node:crypto";
@@ -602457,7 +603082,7 @@ function writeProjectPreferences(root, partial) {
     } catch {
     }
     try {
-      unlinkSync22(tmp);
+      unlinkSync23(tmp);
     } catch {
     }
     throw err;
@@ -602468,7 +603093,7 @@ function deleteProjectPreferences(root) {
   try {
     const file = prefsPath(root);
     if (!existsSync109(file)) return false;
-    unlinkSync22(file);
+    unlinkSync23(file);
     return true;
   } catch {
     return false;
@@ -604515,7 +605140,7 @@ __export(runtime_keys_exports, {
 import { existsSync as existsSync113, readFileSync as readFileSync93, writeFileSync as writeFileSync61, mkdirSync as mkdirSync66, chmodSync } from "node:fs";
 import { join as join127 } from "node:path";
 import { homedir as homedir40 } from "node:os";
-import { randomBytes as randomBytes21 } from "node:crypto";
+import { randomBytes as randomBytes22 } from "node:crypto";
 function ensureDir2() {
   const dir = join127(homedir40(), ".omnius");
   if (!existsSync113(dir)) mkdirSync66(dir, { recursive: true });
@@ -604541,7 +605166,7 @@ function persistAll(records) {
 }
 function mintKey(args) {
   const records = loadAll();
-  const key = `omnius_${randomBytes21(32).toString("hex")}`;
+  const key = `omnius_${randomBytes22(32).toString("hex")}`;
   const record = {
     key,
     scope: args.scope,
@@ -607849,11 +608474,11 @@ async function handleAimsIncidentPost(ctx3) {
       }));
       return true;
     }
-    const { randomBytes: randomBytes25 } = await import("node:crypto");
+    const { randomBytes: randomBytes26 } = await import("node:crypto");
     const record = await withAimsLock("incidents.json", () => {
       const existing = readAimsFile("incidents.json", []);
       const rec = {
-        id: `INC-${Date.now()}-${randomBytes25(4).toString("hex")}`,
+        id: `INC-${Date.now()}-${randomBytes26(4).toString("hex")}`,
         ts: (/* @__PURE__ */ new Date()).toISOString(),
         raised_by: user ?? "anonymous",
         status: "open",
@@ -617014,10 +617639,10 @@ var init_usage_tracker = __esm({
 });
 
 // packages/cli/src/api/profiles.ts
-import { existsSync as existsSync118, readFileSync as readFileSync97, writeFileSync as writeFileSync64, mkdirSync as mkdirSync69, readdirSync as readdirSync40, unlinkSync as unlinkSync23 } from "node:fs";
+import { existsSync as existsSync118, readFileSync as readFileSync97, writeFileSync as writeFileSync64, mkdirSync as mkdirSync69, readdirSync as readdirSync40, unlinkSync as unlinkSync24 } from "node:fs";
 import { join as join132 } from "node:path";
 import { homedir as homedir43 } from "node:os";
-import { createCipheriv as createCipheriv4, createDecipheriv as createDecipheriv4, randomBytes as randomBytes22, scryptSync as scryptSync3 } from "node:crypto";
+import { createCipheriv as createCipheriv5, createDecipheriv as createDecipheriv5, randomBytes as randomBytes23, scryptSync as scryptSync3 } from "node:crypto";
 function globalProfileDir() {
   return join132(homedir43(), ".omnius", "profiles");
 }
@@ -617095,16 +617720,16 @@ function deleteProfile(name10, scope = "global", projectDir2) {
   const dir = scope === "project" ? projectProfileDir(projectDir2) : globalProfileDir();
   const filePath = join132(dir, `${sanitized}.json`);
   if (existsSync118(filePath)) {
-    unlinkSync23(filePath);
+    unlinkSync24(filePath);
     return true;
   }
   return false;
 }
 function encryptProfile(profile, password) {
-  const salt = randomBytes22(32);
+  const salt = randomBytes23(32);
   const key = scryptSync3(password, salt, 32);
-  const iv = randomBytes22(16);
-  const cipher = createCipheriv4("aes-256-gcm", key, iv);
+  const iv = randomBytes23(16);
+  const cipher = createCipheriv5("aes-256-gcm", key, iv);
   const plaintext = JSON.stringify(profile);
   const encrypted = Buffer.concat([cipher.update(plaintext, "utf8"), cipher.final()]);
   const tag = cipher.getAuthTag();
@@ -617123,7 +617748,7 @@ function decryptProfile(enc, password) {
     const salt = Buffer.from(enc.salt, "hex");
     const key = scryptSync3(password, salt, 32);
     const iv = Buffer.from(enc.iv, "hex");
-    const decipher = createDecipheriv4("aes-256-gcm", key, iv);
+    const decipher = createDecipheriv5("aes-256-gcm", key, iv);
     decipher.setAuthTag(Buffer.from(enc.tag, "hex"));
     const decrypted = Buffer.concat([
       decipher.update(Buffer.from(enc.data, "hex")),
@@ -617755,8 +618380,8 @@ import { fileURLToPath as fileURLToPath17 } from "node:url";
 import { dirname as dirname37, join as join135, resolve as resolve43 } from "node:path";
 import { homedir as homedir45 } from "node:os";
 import { spawn as spawn29, execSync as execSync57 } from "node:child_process";
-import { mkdirSync as mkdirSync71, writeFileSync as writeFileSync66, readFileSync as readFileSync98, readdirSync as readdirSync41, existsSync as existsSync120, watch as fsWatch3, renameSync as renameSync8, unlinkSync as unlinkSync24 } from "node:fs";
-import { randomBytes as randomBytes23, randomUUID as randomUUID16 } from "node:crypto";
+import { mkdirSync as mkdirSync71, writeFileSync as writeFileSync66, readFileSync as readFileSync98, readdirSync as readdirSync41, existsSync as existsSync120, watch as fsWatch3, renameSync as renameSync8, unlinkSync as unlinkSync25 } from "node:fs";
+import { randomBytes as randomBytes24, randomUUID as randomUUID16 } from "node:crypto";
 import { createHash as createHash23 } from "node:crypto";
 function getVersion3() {
   try {
@@ -618505,13 +619130,13 @@ function pruneOldJobs() {
       const ts = ageRef ? Date.parse(ageRef) : NaN;
       if (Number.isFinite(ts) && ts < cutoffMs) {
         try {
-          unlinkSync24(path11);
+          unlinkSync25(path11);
         } catch {
         }
         const outFile = path11.replace(/\.json$/, ".output");
         if (existsSync120(outFile)) {
           try {
-            unlinkSync24(outFile);
+            unlinkSync25(outFile);
           } catch {
           }
         }
@@ -618521,7 +619146,7 @@ function pruneOldJobs() {
       }
     } catch {
       try {
-        unlinkSync24(path11);
+        unlinkSync25(path11);
         pruned++;
       } catch {
       }
@@ -618813,7 +619438,7 @@ function atomicJobWrite(dir, id, job) {
     } catch {
     }
     try {
-      unlinkSync24(tmpPath);
+      unlinkSync25(tmpPath);
     } catch {
     }
   }
@@ -619378,7 +620003,7 @@ ${messages2[firstSystemIdx].content}`
       messages2.unshift({ role: "system", content: SYSTEM_FACTUAL_FIRST });
     }
   }
-  const chatId = `chatcmpl-${randomBytes23(12).toString("hex")}`;
+  const chatId = `chatcmpl-${randomBytes24(12).toString("hex")}`;
   const turnsLog = [];
   for (let turn = 1; turn <= maxTurns; turn++) {
     if (Date.now() > totalDeadline) {
@@ -619643,7 +620268,7 @@ async function handleV1ChatCompletions(req2, res, ollamaUrl) {
       "Cache-Control": "no-cache",
       "Connection": "keep-alive"
     });
-    const chatId = `chatcmpl-${randomBytes23(12).toString("hex")}`;
+    const chatId = `chatcmpl-${randomBytes24(12).toString("hex")}`;
     let buffer2 = "";
     ollamaStream(
       targetUrl,
@@ -619685,7 +620310,7 @@ async function handleV1ChatCompletions(req2, res, ollamaUrl) {
               if (ollamaChunk.message.content) delta.content = ollamaChunk.message.content;
               if (ollamaChunk.message.tool_calls) {
                 delta.tool_calls = ollamaChunk.message.tool_calls.map((tc, idx) => ({
-                  id: tc.id || `call_${randomBytes23(8).toString("hex")}`,
+                  id: tc.id || `call_${randomBytes24(8).toString("hex")}`,
                   type: "function",
                   function: {
                     name: tc?.function?.name ?? tc?.name ?? "",
@@ -619764,14 +620389,14 @@ async function handleV1ChatCompletions(req2, res, ollamaUrl) {
       if (ollamaResp.eval_count) metrics.totalTokensOut += ollamaResp.eval_count;
       if (ollamaResp.prompt_eval_count) metrics.totalTokensIn += ollamaResp.prompt_eval_count;
       trackTokens("local", ollamaResp.prompt_eval_count ?? 0, ollamaResp.eval_count ?? 0);
-      const chatId = `chatcmpl-${randomBytes23(12).toString("hex")}`;
+      const chatId = `chatcmpl-${randomBytes24(12).toString("hex")}`;
       const responseMessage = {
         role: ollamaResp.message?.role ?? "assistant",
         content: ollamaResp.message?.content ?? ""
       };
       if (ollamaResp.message?.tool_calls && ollamaResp.message.tool_calls.length > 0) {
         responseMessage.tool_calls = ollamaResp.message.tool_calls.map((tc, idx) => ({
-          id: tc.id || `call_${randomBytes23(8).toString("hex")}`,
+          id: tc.id || `call_${randomBytes24(8).toString("hex")}`,
           type: "function",
           function: {
             name: tc?.function?.name ?? tc?.name ?? "",
@@ -620556,7 +621181,7 @@ async function handleV1Run(req2, res) {
       return;
     }
   }
-  const id = `job-${randomBytes23(8).toString("hex")}`;
+  const id = `job-${randomBytes24(8).toString("hex")}`;
   const dir = jobsDir();
   const workingDir = requestBody["working_directory"] || req2.headers["x-working-directory"];
   const isolate = requestBody["isolate"] === true;
@@ -621723,7 +622348,7 @@ async function handleRequest(req2, res, ollamaUrl, verbose) {
           return;
         }
         const { tmpdir: tmpdir23 } = await import("node:os");
-        const { writeFileSync: writeFileSync71, unlinkSync: unlinkSync25 } = await import("node:fs");
+        const { writeFileSync: writeFileSync71, unlinkSync: unlinkSync26 } = await import("node:fs");
         const { join: pjoin } = await import("node:path");
         const tmpPath = pjoin(tmpdir23(), `omnius-clone-upload-${Date.now()}-${safeName2}`);
         writeFileSync71(tmpPath, buf);
@@ -621738,7 +622363,7 @@ async function handleRequest(req2, res, ollamaUrl, verbose) {
           });
         } finally {
           try {
-            unlinkSync25(tmpPath);
+            unlinkSync26(tmpPath);
           } catch {
           }
         }
@@ -624191,8 +624816,8 @@ function startApiServer(options2 = {}) {
             const job = JSON.parse(readFileSync98(jobPath, "utf-8"));
             const jobTime = new Date(job.startedAt ?? job.completedAt ?? 0).getTime();
             if (jobTime > 0 && jobTime < cutoff && job.status !== "running") {
-              const { unlinkSync: unlinkSync25 } = require4("node:fs");
-              unlinkSync25(jobPath);
+              const { unlinkSync: unlinkSync26 } = require4("node:fs");
+              unlinkSync26(jobPath);
             }
           } catch {
           }
@@ -633676,7 +634301,7 @@ __export(run_exports, {
 import { resolve as resolve45 } from "node:path";
 import { spawn as spawn30 } from "node:child_process";
 import { mkdirSync as mkdirSync74, writeFileSync as writeFileSync69, readFileSync as readFileSync101, readdirSync as readdirSync43, existsSync as existsSync122 } from "node:fs";
-import { randomBytes as randomBytes24 } from "node:crypto";
+import { randomBytes as randomBytes25 } from "node:crypto";
 import { join as join138 } from "node:path";
 function jobsDir2(repoPath) {
   const root = resolve45(repoPath ?? process.cwd());
@@ -633774,7 +634399,7 @@ function extractSummary(captured) {
   return lines.slice(-3).join(" ").slice(0, 200);
 }
 async function runBackground(task, config, opts) {
-  const id = `job-${randomBytes24(3).toString("hex")}`;
+  const id = `job-${randomBytes25(3).toString("hex")}`;
   const dir = jobsDir2(opts.repoPath);
   const repoRoot = resolve45(opts.repoPath ?? process.cwd());
   const job = {