@gobing-ai/knowledge-kit 0.0.16 → 0.0.18

package/plugins/generations/voice-gen/dist/index.js

@@ -14642,72 +14642,6 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/errors.js
-var ErrorCode;
-var init_errors3 = __esm(() => {
-  ErrorCode = {
-    NotFound: "NOT_FOUND",
-    Validation: "VALIDATION",
-    Conflict: "CONFLICT",
-    Internal: "INTERNAL"
-  };
-});
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/api-response.js
-var API_ERROR_CODES, ERROR_CODE_TO_HTTP, CLIENT_SAFE_CODES;
-var init_api_response = __esm(() => {
-  init_errors3();
-  API_ERROR_CODES = {
-    SUCCESS: 0,
-    NOT_FOUND: 404,
-    VALIDATION_ERROR: 422,
-    BAD_REQUEST: 400,
-    UNAUTHORIZED: 401,
-    FORBIDDEN: 403,
-    CONFLICT: 409,
-    INTERNAL_ERROR: 500
-  };
-  ERROR_CODE_TO_HTTP = {
-    [ErrorCode.NotFound]: API_ERROR_CODES.NOT_FOUND,
-    [ErrorCode.Validation]: API_ERROR_CODES.VALIDATION_ERROR,
-    [ErrorCode.Conflict]: API_ERROR_CODES.CONFLICT,
-    [ErrorCode.Internal]: API_ERROR_CODES.INTERNAL_ERROR
-  };
-  CLIENT_SAFE_CODES = new Set([ErrorCode.NotFound, ErrorCode.Validation, ErrorCode.Conflict]);
-});
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/cursor.js
-var init_cursor = () => {};
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/event-severity.js
-var init_event_severity = () => {};
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/output.js
-function processStream(name) {
-  const proc = globalThis.process;
-  const stream = proc?.[name];
-  if (stream === undefined) {
-    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
-  }
-  return stream;
-}
-function writeLine(message, target) {
-  target.write(`${message}
-`);
-}
-function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
-  writeLine(message, target);
-}
-var defaultStderrTarget;
-
-// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.39/node_modules/@gobing-ai/ts-utils/dist/index.js
-var init_dist = __esm(() => {
-  init_api_response();
-  init_cursor();
-  init_errors3();
-  init_event_severity();
-});
-
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -17612,15 +17546,15 @@ var require_timestamp = __commonJS((exports) => {
         throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");
       const [, year, month, day, hour, minute, second] = match.map(Number);
       const millisec = match[7] ? Number((match[7] + "00").substr(1, 3)) : 0;
-      let date6 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
+      let date5 = Date.UTC(year, month - 1, day, hour || 0, minute || 0, second || 0, millisec);
       const tz = match[8];
       if (tz && tz !== "Z") {
         let d = parseSexagesimal(tz, false);
         if (Math.abs(d) < 30)
           d *= 60;
-        date6 -= 60000 * d;
+        date5 -= 60000 * d;
       }
-      return new Date(date6);
+      return new Date(date5);
     },
     stringify: ({ value }) => value?.toISOString().replace(/(T00:00:00)?\.000Z$/, "") ?? ""
   };
@@ -19480,7 +19414,7 @@ var require_composer = __commonJS((exports) => {
   var node_process = __require("process");
   var directives = require_directives();
   var Document = require_Document();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var identity = require_identity();
   var composeDoc = require_compose_doc();
   var resolveEnd = require_resolve_end();
@@ -19531,9 +19465,9 @@ var require_composer = __commonJS((exports) => {
       this.onError = (source, code, message, warning) => {
         const pos = getErrorPos(source);
         if (warning)
-          this.warnings.push(new errors4.YAMLWarning(pos, code, message));
+          this.warnings.push(new errors3.YAMLWarning(pos, code, message));
         else
-          this.errors.push(new errors4.YAMLParseError(pos, code, message));
+          this.errors.push(new errors3.YAMLParseError(pos, code, message));
       };
       this.directives = new directives.Directives({ version: options.version || "1.2" });
       this.options = options;
@@ -19619,7 +19553,7 @@ ${cb}` : comment;
           break;
         case "error": {
           const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-          const error51 = new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+          const error51 = new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
           if (this.atDirectives || !this.doc)
             this.errors.push(error51);
           else
@@ -19629,7 +19563,7 @@ ${cb}` : comment;
         case "doc-end": {
           if (!this.doc) {
             const msg = "Unexpected doc-end without preceding document";
-            this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+            this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
             break;
           }
           this.doc.directives.docEnd = true;
@@ -19644,7 +19578,7 @@ ${end.comment}` : end.comment;
           break;
         }
         default:
-          this.errors.push(new errors4.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+          this.errors.push(new errors3.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
       }
     }
     *end(forceDoc = false, endOffset = -1) {
@@ -19670,7 +19604,7 @@ ${end.comment}` : end.comment;
 var require_cst_scalar = __commonJS((exports) => {
   var resolveBlockScalar = require_resolve_block_scalar();
   var resolveFlowScalar = require_resolve_flow_scalar();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var stringifyString = require_stringifyString();
   function resolveAsScalar(token, strict = true, onError) {
     if (token) {
@@ -19679,7 +19613,7 @@ var require_cst_scalar = __commonJS((exports) => {
         if (onError)
           onError(offset, code, message);
         else
-          throw new errors4.YAMLParseError([offset, offset + 1], code, message);
+          throw new errors3.YAMLParseError([offset, offset + 1], code, message);
       };
       switch (token.type) {
         case "scalar":
@@ -21559,7 +21493,7 @@ var require_parser = __commonJS((exports) => {
 var require_public_api = __commonJS((exports) => {
   var composer = require_composer();
   var Document = require_Document();
-  var errors4 = require_errors();
+  var errors3 = require_errors();
   var log = require_log();
   var identity = require_identity();
   var lineCounter = require_line_counter();
@@ -21576,8 +21510,8 @@ var require_public_api = __commonJS((exports) => {
     const docs = Array.from(composer$1.compose(parser$1.parse(source)));
     if (prettyErrors && lineCounter2)
       for (const doc2 of docs) {
-        doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-        doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+        doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
+        doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
       }
     if (docs.length > 0)
       return docs;
@@ -21592,13 +21526,13 @@ var require_public_api = __commonJS((exports) => {
       if (!doc2)
         doc2 = _doc;
       else if (doc2.options.logLevel !== "silent") {
-        doc2.errors.push(new errors4.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+        doc2.errors.push(new errors3.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
         break;
       }
     }
     if (prettyErrors && lineCounter2) {
-      doc2.errors.forEach(errors4.prettifyError(source, lineCounter2));
-      doc2.warnings.forEach(errors4.prettifyError(source, lineCounter2));
+      doc2.errors.forEach(errors3.prettifyError(source, lineCounter2));
+      doc2.warnings.forEach(errors3.prettifyError(source, lineCounter2));
     }
     return doc2;
   }
@@ -21650,12 +21584,12 @@ var require_public_api = __commonJS((exports) => {
 });
 
 // ../../node_modules/.bun/yaml@2.9.0/node_modules/yaml/dist/index.js
-var composer, Document, Schema, errors4, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
-var init_dist2 = __esm(() => {
+var composer, Document, Schema, errors3, Alias, identity, Pair, Scalar, YAMLMap, YAMLSeq, cst, lexer, lineCounter, parser, publicApi, visit, $Composer, $Document, $Schema, $YAMLError, $YAMLParseError, $YAMLWarning, $Alias, $isAlias, $isCollection, $isDocument, $isMap, $isNode, $isPair, $isScalar, $isSeq, $Pair, $Scalar, $YAMLMap, $YAMLSeq, $Lexer, $LineCounter, $Parser, $parse, $parseAllDocuments, $parseDocument, $stringify, $visit, $visitAsync;
+var init_dist = __esm(() => {
   composer = require_composer();
   Document = require_Document();
   Schema = require_Schema();
-  errors4 = require_errors();
+  errors3 = require_errors();
   Alias = require_Alias();
   identity = require_identity();
   Pair = require_Pair();
@@ -21671,9 +21605,9 @@ var init_dist2 = __esm(() => {
   $Composer = composer.Composer;
   $Document = Document.Document;
   $Schema = Schema.Schema;
-  $YAMLError = errors4.YAMLError;
-  $YAMLParseError = errors4.YAMLParseError;
-  $YAMLWarning = errors4.YAMLWarning;
+  $YAMLError = errors3.YAMLError;
+  $YAMLParseError = errors3.YAMLParseError;
+  $YAMLWarning = errors3.YAMLWarning;
   $Alias = Alias.Alias;
   $isAlias = identity.isAlias;
   $isCollection = identity.isCollection;
@@ -21701,7 +21635,7 @@ var init_dist2 = __esm(() => {
 // ../../node_modules/.bun/@gobing-ai+ts-runtime@0.4.39/node_modules/@gobing-ai/ts-runtime/dist/config.js
 var configSchema;
 var init_config = __esm(() => {
-  init_dist2();
+  init_dist();
   init_zod();
   configSchema = exports_external.object({
     app: exports_external.object({
@@ -21887,11 +21821,26 @@ var PluginManifestSchema = exports_external.object({
 init_file_system_node();
 init_config();
 
+// ../../node_modules/.bun/@gobing-ai+ts-utils@0.4.67/node_modules/@gobing-ai/ts-utils/dist/output.js
+var defaultStderrTarget;
+function processStream(name) {
+  const proc = globalThis.process;
+  const stream = proc?.[name];
+  if (stream === undefined) {
+    throw new Error(`No ${name} target available: set one via setDefaultOutputTargets or pass an explicit target`);
+  }
+  return stream;
+}
+function writeLine(message, target) {
+  target.write(`${message}
+`);
+}
+function echoError(message, target = defaultStderrTarget ?? processStream("stderr")) {
+  writeLine(message, target);
+}
+
 // ../../packages/kk-core/src/render-md.ts
 if (false) {}
-// ../../plugins/generations/voice-gen/src/index.ts
-init_dist();
-
 // ../../plugins/generations/voice-gen/src/concat.ts
 function parseWav(buffer) {
   if (buffer.length < 44) {
@@ -22007,21 +21956,21 @@ function concatWavs(wavBuffers, gapsMs = []) {
   }
   const headerSize = 44;
   const totalFileSize = headerSize + totalDataLength;
-  const output2 = new Uint8Array(totalFileSize);
-  const view = new DataView(output2.buffer, output2.byteOffset, output2.byteLength);
-  output2[0] = 82;
-  output2[1] = 73;
-  output2[2] = 70;
-  output2[3] = 70;
+  const output = new Uint8Array(totalFileSize);
+  const view = new DataView(output.buffer, output.byteOffset, output.byteLength);
+  output[0] = 82;
+  output[1] = 73;
+  output[2] = 70;
+  output[3] = 70;
   view.setUint32(4, 36 + totalDataLength, true);
-  output2[8] = 87;
-  output2[9] = 65;
-  output2[10] = 86;
-  output2[11] = 69;
-  output2[12] = 102;
-  output2[13] = 109;
-  output2[14] = 116;
-  output2[15] = 32;
+  output[8] = 87;
+  output[9] = 65;
+  output[10] = 86;
+  output[11] = 69;
+  output[12] = 102;
+  output[13] = 109;
+  output[14] = 116;
+  output[15] = 32;
   view.setUint32(16, 16, true);
   view.setUint16(20, first.audioFormat, true);
   view.setUint16(22, first.numChannels, true);
@@ -22029,17 +21978,44 @@ function concatWavs(wavBuffers, gapsMs = []) {
   view.setUint32(28, first.byteRate, true);
   view.setUint16(32, first.blockAlign, true);
   view.setUint16(34, first.bitsPerSample, true);
-  output2[36] = 100;
-  output2[37] = 97;
-  output2[38] = 116;
-  output2[39] = 97;
+  output[36] = 100;
+  output[37] = 97;
+  output[38] = 116;
+  output[39] = 97;
   view.setUint32(40, totalDataLength, true);
   let currentOffset = headerSize;
   for (const piece of pieces) {
-    output2.set(piece, currentOffset);
+    output.set(piece, currentOffset);
     currentOffset += piece.length;
   }
-  return output2;
+  return output;
+}
+function applySpeed(wav, speed) {
+  if (speed === 1)
+    return wav;
+  const proc = Bun.spawnSync([
+    "ffmpeg",
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-f",
+    "wav",
+    "-i",
+    "pipe:0",
+    "-filter:a",
+    `atempo=${speed}`,
+    "-f",
+    "wav",
+    "pipe:1"
+  ], {
+    stdin: Buffer.from(wav),
+    stdout: "pipe",
+    stderr: "pipe"
+  });
+  if (proc.exitCode !== 0 || !proc.stdout) {
+    throw new Error(`ffmpeg atempo failed (exit ${proc.exitCode}): ${proc.stderr?.toString().trim()}`);
+  }
+  return new Uint8Array(proc.stdout);
 }
 
 // ../../plugins/generations/voice-gen/src/mp3.ts
@@ -22715,6 +22691,40 @@ function mergeVoiceScripts(scripts, docs, envDefaultProfile) {
   }
   return result;
 }
+var CONTENT_ECHO_NOISE_RE = /[\uFF0C\u3002\u3001\uFF1A:\uFF1B;!\uFF01?\uFF1F\u2026\s\u300C\u300D\u300E\u300F\u3010\u3011]/g;
+var CONTENT_SCAFFOLD_LABEL_RE = /^(?:\*\*)?[\u300C\u300E]?(?:\u80CC\u666F|\u6F5C\u5728\u5F71\u54CD|\u53EF\u505A\u89D2\u5EA6|\u4E3A\u4EC0\u4E48\u73B0\u5728\u503C\u5F97\u6CE8\u610F|\u793E\u533A\u8BA8\u8BBA)[\u300D\u300F]?(?:\*\*)?(?:[\uFF1A:\uFF0C,]|\s|$)/;
+var CONTENT_TAG_TAIL_RE = /\u6807\u7B7E[\uFF1A:\uFF0C,]/;
+var CONTENT_URL_MANGLE_RE = /[\uFF0C\u3002]\/\//;
+function assertSegmentContent(script) {
+  const seen = new Map;
+  for (let idx = 0;idx < script.segments.length; idx++) {
+    const text = (script.segments[idx]?.text ?? "").trim();
+    if (text === "")
+      continue;
+    const previous = seen.get(text);
+    if (previous !== undefined) {
+      throw new Error(`content check failed: segment ${idx} duplicates segment ${previous} verbatim`);
+    }
+    seen.set(text, idx);
+    const lead = text.match(/^[^\u3010]*\u3010([^\u3011]{4,80})\u3011[\uFF0C\u3002\u3001\s]*/);
+    if (lead !== null) {
+      const bracketed = (lead[1] ?? "").replace(CONTENT_ECHO_NOISE_RE, "");
+      const rest = text.slice(lead[0].length).replace(CONTENT_ECHO_NOISE_RE, "");
+      if (bracketed.length >= 4 && rest.startsWith(bracketed)) {
+        throw new Error(`content check failed: segment ${idx} repeats its \u3010${lead[1]}\u3011 title in the body text`);
+      }
+    }
+    if (CONTENT_SCAFFOLD_LABEL_RE.test(text)) {
+      throw new Error(`content check failed: segment ${idx} opens with a research scaffold label`);
+    }
+    if (CONTENT_TAG_TAIL_RE.test(text)) {
+      throw new Error(`content check failed: segment ${idx} carries a \u6807\u7B7E metadata tail`);
+    }
+    if (CONTENT_URL_MANGLE_RE.test(text)) {
+      throw new Error(`content check failed: segment ${idx} has a colon-mangled URL`);
+    }
+  }
+}
 function validateVoiceScript(script) {
   if (!script || typeof script !== "object") {
     throw new Error("VoiceScript must be an object");
@@ -22783,6 +22793,11 @@ function validateVoiceScript(script) {
         throw new Error("gap_ms must be non-negative");
       }
     }
+    if (segment.speed !== undefined) {
+      if (typeof segment.speed !== "number" || segment.speed < 0.5 || segment.speed > 2) {
+        throw new Error("speed must be between 0.5 and 2.0");
+      }
+    }
     if (segment.seed !== undefined) {
       if (typeof segment.seed !== "number" || !Number.isInteger(segment.seed) || segment.seed < 0) {
         throw new Error("seed must be a non-negative integer");
@@ -22791,6 +22806,7 @@ function validateVoiceScript(script) {
     assertEngine(segment.engine, `Segment at index ${idx}`);
     assertLanguage(segment.language, `Segment at index ${idx}`);
   }
+  assertSegmentContent(script);
 }
 
 // ../../plugins/generations/voice-gen/src/index.ts
@@ -22944,18 +22960,20 @@ async function processGeneratorIO(inputPath, outputPath, clientOverride, transco
         throw lastError instanceof Error ? lastError : new Error(String(lastError ?? "no audio"));
       }
       const gap = segment.gap_ms ?? 0;
-      segmentWavs.push(wavBytes);
+      const speed = segment.speed ?? 1;
+      segmentWavs.push(applySpeed(wavBytes, speed));
       segmentGaps.push(gap);
-      totalDuration += segDuration + gap / 1000;
+      totalDuration += segDuration / speed + gap / 1000;
       segmentMetadata.push({
         generationId,
         profile: resolvedProfile.name,
         speaker: segment.speaker,
         emotion: rawEmotion,
-        duration: segDuration,
+        duration: segDuration / speed,
         verifyRetries,
         transcription,
-        loudnessDip
+        loudnessDip,
+        ...speed !== 1 ? { speed } : {}
       });
       echoError(`voice-gen: segment ${segIndex + 1}/${combinedScript.segments.length} done in ${((Date.now() - segStartedAt) / 1000).toFixed(1)}s${verifyRetries ? ` (${verifyRetries} verify ${verifyRetries === 1 ? "retry" : "retries"})` : ""}`);
     }
@@ -23036,6 +23054,7 @@ export {
   concatWavs,
   computeExpectedDurationRange,
   auditVoiceSegments,
+  applySpeed,
   VOICEBOX_TEXT_MAX,
   VOICEBOX_LANGUAGES,
   VOICEBOX_INSTRUCT_MAX,

package/plugins/generations/voice-gen/src/concat.ts

@@ -218,3 +218,37 @@ export function concatWavs(wavBuffers: Uint8Array[], gapsMs: number[] = []): Uin
 
     return output;
 }
+
+/**
+ * Resample a segment's playback rate with ffmpeg `atempo` (in-memory stdin/stdout).
+ * Voicebox has no rate parameter, so per-segment `speed` is a local post-step; 1.0 skips.
+ */
+export function applySpeed(wav: Uint8Array, speed: number): Uint8Array {
+    if (speed === 1) return wav;
+    const proc = Bun.spawnSync(
+        [
+            'ffmpeg',
+            '-hide_banner',
+            '-loglevel',
+            'error',
+            '-f',
+            'wav',
+            '-i',
+            'pipe:0',
+            '-filter:a',
+            `atempo=${speed}`,
+            '-f',
+            'wav',
+            'pipe:1',
+        ],
+        {
+            stdin: Buffer.from(wav),
+            stdout: 'pipe',
+            stderr: 'pipe',
+        },
+    );
+    if (proc.exitCode !== 0 || !proc.stdout) {
+        throw new Error(`ffmpeg atempo failed (exit ${proc.exitCode}): ${proc.stderr?.toString().trim()}`);
+    }
+    return new Uint8Array(proc.stdout);
+}

package/plugins/generations/voice-gen/src/index.ts

@@ -3,7 +3,7 @@ import { parseArgs } from 'node:util';
 import { type Content, ContentSchema, type Doc, DocListSchema } from '@gobing-ai/kk-core';
 import { createNodeFileSystem } from '@gobing-ai/ts-runtime';
 import { echoError } from '@gobing-ai/ts-utils';
-import { concatWavs } from './concat';
+import { applySpeed, concatWavs } from './concat';
 import { isMp3Requested, type Mp3Transcoder, transcodeWavToMp3 } from './mp3';
 import { auditVoiceSegments, detectLoudnessDip, TRANSCRIPTION_FIDELITY_FLOOR, transcriptionFidelity } from './qc';
 import { createVoiceboxClient, type VoiceboxClient, type VoiceboxGenerateBody } from './voicebox-client';
@@ -281,20 +281,22 @@ export async function processGeneratorIO(
             }
 
             const gap = segment.gap_ms ?? 0;
+            const speed = segment.speed ?? 1;
 
-            segmentWavs.push(wavBytes);
+            segmentWavs.push(applySpeed(wavBytes, speed));
             segmentGaps.push(gap);
 
-            totalDuration += segDuration + gap / 1000;
+            totalDuration += segDuration / speed + gap / 1000;
             segmentMetadata.push({
                 generationId,
                 profile: resolvedProfile.name,
                 speaker: segment.speaker,
                 emotion: rawEmotion,
-                duration: segDuration,
+                duration: segDuration / speed,
                 verifyRetries,
                 transcription,
                 loudnessDip,
+                ...(speed !== 1 ? { speed } : {}),
             });
             echoError(
                 `voice-gen: segment ${segIndex + 1}/${combinedScript.segments.length} done in ${((Date.now() - segStartedAt) / 1000).toFixed(1)}s${verifyRetries ? ` (${verifyRetries} verify ${verifyRetries === 1 ? 'retry' : 'retries'})` : ''}`,

package/plugins/generations/voice-gen/src/voicescript.ts

@@ -153,6 +153,8 @@ export interface VoiceSegment {
     engine?: string;
     language?: string;
     gap_ms?: number;
+    /** Playback rate multiplier (0.5–2.0); undefined/1 = generator default (VOICEBOX envs don't carry speed — local atempo). */
+    speed?: number;
     max_chunk_chars?: number;
     crossfade_ms?: number;
     personality?: boolean;
@@ -367,6 +369,57 @@ export function mergeVoiceScripts(scripts: VoiceScript[], docs: Doc[], envDefaul
     return result;
 }
 
+/**
+ * Content checks mirrored from `plugins/kk/scripts/validate-voicescript.ts` (0139 R3 SYNC contract).
+ * Keep the messages byte-identical to the kk copy — the daily workflow runs whichever copy the
+ * package resolves, and both must reject the same spoken-copy defects with the same reason.
+ */
+
+/** Punctuation/space the translator drifts between a title and its body restatement. */
+const CONTENT_ECHO_NOISE_RE = /[，。、：:；;!！?？…\s「」『』【】]/g;
+/** Research scaffold labels the plan-translate stage must not emit as spoken copy. */
+const CONTENT_SCAFFOLD_LABEL_RE =
+    /^(?:\*\*)?[「『]?(?:背景|潜在影响|可做角度|为什么现在值得注意|社区讨论)[」』]?(?:\*\*)?(?:[：:，,]|\s|$)/;
+/** `标签，` metadata tails — the plan item's tag line spoken aloud. */
+const CONTENT_TAG_TAIL_RE = /标签[：:，,]/;
+/** `wss，//` / `https。//` — the translator replacing a URL colon with a Chinese comma. */
+const CONTENT_URL_MANGLE_RE = /[，。]\/\//;
+
+function assertSegmentContent(script: VoiceScript): void {
+    const seen = new Map<string, number>();
+    for (let idx = 0; idx < script.segments.length; idx++) {
+        const text = (script.segments[idx]?.text ?? '').trim();
+        if (text === '') continue;
+
+        const previous = seen.get(text);
+        if (previous !== undefined) {
+            throw new Error(`content check failed: segment ${idx} duplicates segment ${previous} verbatim`);
+        }
+        seen.set(text, idx);
+
+        const lead = text.match(/^[^【]*【([^】]{4,80})】[，。、\s]*/);
+        if (lead !== null) {
+            const bracketed = (lead[1] ?? '').replace(CONTENT_ECHO_NOISE_RE, '');
+            const rest = text.slice(lead[0].length).replace(CONTENT_ECHO_NOISE_RE, '');
+            if (bracketed.length >= 4 && rest.startsWith(bracketed)) {
+                throw new Error(
+                    `content check failed: segment ${idx} repeats its 【${lead[1]}】 title in the body text`,
+                );
+            }
+        }
+
+        if (CONTENT_SCAFFOLD_LABEL_RE.test(text)) {
+            throw new Error(`content check failed: segment ${idx} opens with a research scaffold label`);
+        }
+        if (CONTENT_TAG_TAIL_RE.test(text)) {
+            throw new Error(`content check failed: segment ${idx} carries a 标签 metadata tail`);
+        }
+        if (CONTENT_URL_MANGLE_RE.test(text)) {
+            throw new Error(`content check failed: segment ${idx} has a colon-mangled URL`);
+        }
+    }
+}
+
 /**
  * Validate that a VoiceScript satisfies all Voicebox and plugin constraints.
  */
@@ -490,6 +543,12 @@ export function validateVoiceScript(script: VoiceScript): void {
             }
         }
 
+        if (segment.speed !== undefined) {
+            if (typeof segment.speed !== 'number' || segment.speed < 0.5 || segment.speed > 2.0) {
+                throw new Error('speed must be between 0.5 and 2.0');
+            }
+        }
+
         if (segment.seed !== undefined) {
             if (typeof segment.seed !== 'number' || !Number.isInteger(segment.seed) || segment.seed < 0) {
                 throw new Error('seed must be a non-negative integer');
@@ -499,4 +558,6 @@ export function validateVoiceScript(script: VoiceScript): void {
         assertEngine(segment.engine, `Segment at index ${idx}`);
         assertLanguage(segment.language, `Segment at index ${idx}`);
     }
+
+    assertSegmentContent(script);
 }