fluncle 0.35.0 → 0.36.0

package/bin/fluncle.mjs

@@ -3789,7 +3789,7 @@ function parseVersion(version) {
 var currentVersion, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.35.0".trim() ? "0.35.0".trim() : "0.1.0";
+  currentVersion = "0.36.0".trim() ? "0.36.0".trim() : "0.1.0";
 });
 
 // src/commands/track.ts
@@ -3799,6 +3799,7 @@ __export(exports_track, {
   trackUpdateCommand: () => trackUpdateCommand,
   trackSocialUpdateCommand: () => trackSocialUpdateCommand,
   trackSocialShowCommand: () => trackSocialShowCommand,
+  trackObserveCommand: () => trackObserveCommand,
   trackGetCommand: () => trackGetCommand,
   trackDraftCommand: () => trackDraftCommand
 });
@@ -3892,6 +3893,25 @@ async function trackUpdateCommand(trackId, options) {
   }
   return adminApiPatch(`/api/admin/tracks/${encodeURIComponent(trackId)}`, body);
 }
+async function trackObserveCommand(idOrLogId, options) {
+  const body = { script: options.script };
+  if (options.voiceId !== undefined) {
+    body.voiceId = options.voiceId;
+  }
+  if (options.model !== undefined) {
+    body.model = options.model;
+  }
+  if (options.durationMs !== undefined) {
+    body.durationMs = options.durationMs;
+  }
+  if (options.durationTargetSec !== undefined) {
+    body.durationTargetSec = options.durationTargetSec;
+  }
+  if (options.contextNote !== undefined) {
+    body.contextNote = options.contextNote;
+  }
+  return adminApiPost(`/api/admin/tracks/${encodeURIComponent(idOrLogId)}/observe`, body);
+}
 var DEFAULT_VIDEO_MODEL = "anthropic/claude-opus-4-8", DEFAULT_VIDEO_REASONING = "high", FOUND_BASE = "https://found.fluncle.com", VIDEO_FIELDS;
 var init_track = __esm(() => {
   init_api();
@@ -4929,7 +4949,7 @@ function trackDetailLines(track) {
 var COORD_FALLBACK2 = "—";
 
 // src/cli.ts
-import { existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import path from "path";
 
 // ../../node_modules/.bun/commander@14.0.3/node_modules/commander/esm.mjs
@@ -5155,6 +5175,10 @@ function addAdminCommands(program2) {
     const { previewArchiveUploadCommand: previewArchiveUploadCommand2 } = await Promise.resolve().then(() => (init_preview_archive(), exports_preview_archive));
     await runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCommand2);
   });
+  adminTrack.command("observe").description("Render Fluncle's spoken field observation for a track (ElevenLabs, Worker-side)").argument("[idOrLogId]").option("--script <text>", "The voice-gated observation script (the spoken text)").option("--script-file <file>", "Read the observation script from a file (e.g. observation.txt)").option("--voice-id <id>", "Override the configured ElevenLabs voice id").option("--model <model>", "TTS model (eleven_multilingual_v2 | eleven_v3)").option("--duration-ms <ms>", "Probed audio duration in ms (the agent runs ffprobe)").option("--duration-target-sec <sec>", "Target observation length in seconds (20\u201345)").option("--context-note <text>", "Pre-fetched factual context (else the Worker firecrawls)").option("--json", "Print JSON", false).allowExcessArguments().action(async (idOrLogId, options) => {
+    const { trackObserveCommand: trackObserveCommand2 } = await Promise.resolve().then(() => (init_track(), exports_track));
+    await runTrackObserve(idOrLogId, options, trackObserveCommand2);
+  });
   const adminMixtapes = configureCommand(admin.command("mixtapes").description("Mixtape admin commands"));
   adminMixtapes.action(() => {
     adminMixtapes.outputHelp();
@@ -5265,6 +5289,36 @@ async function runTrackPreviewArchive(idOrLogId, options, previewArchiveUploadCo
   console.log(`  source: ${result.source}`);
   console.log(`  mime: ${result.mime}`);
 }
+async function runTrackObserve(idOrLogId, options, trackObserveCommand2) {
+  const script = options.scriptFile ? readFileSync2(options.scriptFile, "utf8") : options.script;
+  if (!idOrLogId || !script || !script.trim()) {
+    throw new Error("Usage: fluncle admin track observe <track_id|log_id> (--script <text> | --script-file <file>) [--voice-id <id>] [--model <model>] [--duration-ms <ms>] [--context-note <text>] [--json]");
+  }
+  const durationMs = options.durationMs === undefined ? undefined : Number.parseInt(options.durationMs, 10);
+  if (durationMs !== undefined && (!Number.isInteger(durationMs) || durationMs < 1)) {
+    throw new Error("--duration-ms must be a positive integer");
+  }
+  const durationTargetSec = options.durationTargetSec === undefined ? undefined : Number.parseInt(options.durationTargetSec, 10);
+  if (durationTargetSec !== undefined && (!Number.isInteger(durationTargetSec) || durationTargetSec < 1)) {
+    throw new Error("--duration-target-sec must be a positive integer");
+  }
+  const result = await trackObserveCommand2(idOrLogId, {
+    contextNote: options.contextNote,
+    durationMs,
+    durationTargetSec,
+    model: options.model,
+    script: script.trim(),
+    voiceId: options.voiceId
+  });
+  if (options.json) {
+    printJson(result);
+    return;
+  }
+  console.log(`Recorded observation for ${result.logId}`);
+  console.log(`  audio: ${result.audioUrl}`);
+  console.log(`  length: ${Math.round(result.durationMs / 1000)}s`);
+  console.log(`  voice: ${result.voiceId}`);
+}
 async function runPreviewArchiveBackfill(options, previewArchiveBackfillCommand2) {
   const limit = options.limit === undefined ? undefined : Number.parseInt(options.limit, 10);
   if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) {

package/package.json

@@ -31,5 +31,5 @@
     "url": "git+https://github.com/mauricekleine/fluncle.git"
   },
   "type": "module",
-  "version": "0.35.0"
+  "version": "0.36.0"
 }