@lightcone-ai/daemon 0.15.53 → 0.15.55

package/mcp-servers/official/video-narration-planner/core.js

@@ -1,1403 +0,0 @@
-import path from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { readFileSync } from 'node:fs';
-
-export const VISUAL_ACTION_TYPES = Object.freeze([
-  'scroll_to_dwell',
-  'linear_scroll_during',
-  'cursor_focus',
-  'scroll_back',
-]);
-
-const VISUAL_ACTION_SET = new Set(VISUAL_ACTION_TYPES);
-const PLANNER_CONFIG = loadPlannerConfig();
-const DEFAULT_OUTRO_VIDEO_ID = PLANNER_CONFIG.default_outro_video_id;
-const SENTENCE_MIN_CHARS = PLANNER_CONFIG.sentence_char_range.min;
-const SENTENCE_MAX_CHARS = PLANNER_CONFIG.sentence_char_range.max;
-const PLATFORM_PROFILES = PLANNER_CONFIG.platform_profiles;
-const PLATFORM_LOOKUP = buildPlatformLookup(PLATFORM_PROFILES);
-const SENTENCE_FILLERS = PLANNER_CONFIG.sentence_fillers;
-
-const SEMANTIC_SLOT_KEYS = Object.freeze([
-  'company',
-  'published_at',
-  'recruitment_type',
-  'cohort',
-  'job_directions',
-  'locations',
-  'target_or_requirements',
-  'process',
-  'entry_or_cta',
-]);
-
-const NARRATION_MODES = PLANNER_CONFIG.narration_modes;
-
-const NARRATION_MODE_SET = new Set(NARRATION_MODES);
-const SLOT_STATUS_SET = new Set(['present', 'missing']);
-
-const RECRUITMENT_KEYWORDS = buildKeywordRegex(PLANNER_CONFIG.recruitment_keyword_terms);
-const RECRUITMENT_TYPE_LABELS = PLANNER_CONFIG.recruitment_type_labels;
-const SLOT_LABELS = PLANNER_CONFIG.slot_labels;
-const MODE_SEVERITY = PLANNER_CONFIG.mode_severity;
-const MODE_MIN_CONFIDENCE = PLANNER_CONFIG.mode_min_confidence;
-const RECRUITMENT_FAIL_CLOSED_GROUPS = PLANNER_CONFIG.recruitment_fail_closed_groups;
-
-function isPlainObject(value) {
-  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
-}
-
-function deepFreeze(value) {
-  if (!value || typeof value !== 'object') return value;
-  if (Object.isFrozen(value)) return value;
-  if (Array.isArray(value)) {
-    value.forEach(item => deepFreeze(item));
-    return Object.freeze(value);
-  }
-  for (const key of Object.keys(value)) {
-    deepFreeze(value[key]);
-  }
-  return Object.freeze(value);
-}
-
-function normalizeStringArray(value) {
-  if (!Array.isArray(value)) return [];
-  return value
-    .map(item => String(item ?? '').trim())
-    .filter(Boolean);
-}
-
-function normalizeNumberPair(value, fallback = [100, 150]) {
-  if (!Array.isArray(value) || value.length < 2) return [...fallback];
-  const first = Number(value[0]);
-  const second = Number(value[1]);
-  if (!Number.isFinite(first) || !Number.isFinite(second)) return [...fallback];
-  const min = Math.min(first, second);
-  const max = Math.max(first, second);
-  return [Math.round(min), Math.round(max)];
-}
-
-function normalizeGroupList(groups) {
-  if (!Array.isArray(groups)) return [];
-  return groups
-    .map((group) => {
-      if (!isPlainObject(group)) return null;
-      const id = String(group.id ?? '').trim();
-      const keys = normalizeStringArray(group.keys);
-      if (!id || keys.length === 0) return null;
-      return { id, keys };
-    })
-    .filter(Boolean);
-}
-
-function normalizeLabelMap(value) {
-  if (!isPlainObject(value)) return {};
-  const normalized = {};
-  for (const [key, raw] of Object.entries(value)) {
-    const normalizedKey = String(key ?? '').trim();
-    const normalizedValue = String(raw ?? '').trim();
-    if (!normalizedKey || !normalizedValue) continue;
-    normalized[normalizedKey] = normalizedValue;
-  }
-  return normalized;
-}
-
-function buildPlatformLookup(profiles) {
-  const map = new Map();
-  for (const profile of Object.values(profiles ?? {})) {
-    const id = String(profile?.id ?? '').trim().toLowerCase();
-    if (!id) continue;
-    map.set(id, id);
-    const aliases = normalizeStringArray(profile.aliases);
-    for (const alias of aliases) {
-      map.set(alias.toLowerCase(), id);
-    }
-  }
-  return map;
-}
-
-function escapeRegexToken(value) {
-  return String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function buildKeywordRegex(terms) {
-  const normalizedTerms = normalizeStringArray(terms);
-  if (normalizedTerms.length === 0) return /招聘|校招|实习|职位|岗位|career|jobs|intern|campus/i;
-  return new RegExp(normalizedTerms.map(escapeRegexToken).join('|'), 'i');
-}
-
-function loadPlannerConfig() {
-  let parsed = null;
-  try {
-    parsed = JSON.parse(
-      readFileSync(new URL('./planner-config.json', import.meta.url), 'utf8')
-    );
-  } catch (error) {
-    throw new Error(`video_narration_planner_config_load_failed:${error.message}`);
-  }
-  if (!isPlainObject(parsed)) {
-    throw new Error('video_narration_planner_config_invalid:root_object_required');
-  }
-
-  const platformProfiles = isPlainObject(parsed.platform_profiles) ? parsed.platform_profiles : {};
-  if (!isPlainObject(platformProfiles.xiaohongshu)) {
-    throw new Error('video_narration_planner_config_invalid:platform_profiles.xiaohongshu_required');
-  }
-
-  const sentenceRange = normalizeNumberPair(
-    [parsed?.sentence_char_range?.min, parsed?.sentence_char_range?.max],
-    [100, 150]
-  );
-
-  const failClosedGroups = normalizeGroupList(parsed.recruitment_fail_closed_groups);
-  if (failClosedGroups.length === 0) {
-    throw new Error('video_narration_planner_config_invalid:recruitment_fail_closed_groups_required');
-  }
-
-  const narrationModes = normalizeStringArray(parsed.narration_modes);
-  if (narrationModes.length === 0) {
-    throw new Error('video_narration_planner_config_invalid:narration_modes_required');
-  }
-
-  const sentenceFillers = normalizeStringArray(parsed.sentence_fillers);
-  if (sentenceFillers.length === 0) {
-    throw new Error('video_narration_planner_config_invalid:sentence_fillers_required');
-  }
-
-  return deepFreeze({
-    default_outro_video_id: String(parsed.default_outro_video_id ?? 'outro-default-zh').trim() || 'outro-default-zh',
-    sentence_char_range: {
-      min: sentenceRange[0],
-      max: sentenceRange[1],
-    },
-    platform_profiles: platformProfiles,
-    sentence_fillers: sentenceFillers,
-    narration_modes: narrationModes,
-    recruitment_keyword_terms: normalizeStringArray(parsed.recruitment_keyword_terms),
-    recruitment_type_labels: normalizeLabelMap(parsed.recruitment_type_labels),
-    slot_labels: normalizeLabelMap(parsed.slot_labels),
-    mode_severity: isPlainObject(parsed.mode_severity) ? parsed.mode_severity : {},
-    mode_min_confidence: isPlainObject(parsed.mode_min_confidence) ? parsed.mode_min_confidence : {},
-    recruitment_fail_closed_groups: failClosedGroups,
-  });
-}
-
-function clampNumber(value, min, max, fallback) {
-  const num = Number(value);
-  if (!Number.isFinite(num)) return fallback;
-  return Math.max(min, Math.min(max, num));
-}
-
-function clampInt(value, min, max, fallback) {
-  return Math.round(clampNumber(value, min, max, fallback));
-}
-
-function toSafeString(value) {
-  if (value == null) return '';
-  return String(value).trim();
-}
-
-function toFiniteNumber(value) {
-  const num = Number(value);
-  return Number.isFinite(num) ? num : null;
-}
-
-function toCharLength(text) {
-  return Array.from(String(text ?? '')).length;
-}
-
-function trimToChars(text, maxChars) {
-  const chars = Array.from(String(text ?? ''));
-  if (chars.length <= maxChars) return chars.join('');
-  return chars.slice(0, maxChars).join('');
-}
-
-function withSentencePunctuation(text) {
-  const value = toSafeString(text);
-  if (!value) return value;
-  if (/[。！？!?]$/.test(value)) return value;
-  return `${value}。`;
-}
-
-function ensureSentenceLength(text, minChars = SENTENCE_MIN_CHARS, maxChars = SENTENCE_MAX_CHARS) {
-  let output = withSentencePunctuation(text);
-  let pointer = 0;
-  while (toCharLength(output) < minChars) {
-    const filler = SENTENCE_FILLERS[pointer % SENTENCE_FILLERS.length];
-    output = withSentencePunctuation(`${output}${filler}`);
-    pointer += 1;
-  }
-
-  if (toCharLength(output) > maxChars) {
-    output = trimToChars(output, maxChars);
-    output = output.replace(/[，,；;：:]?[^，。！？!?]*$/, '');
-    if (!output) {
-      output = trimToChars(text, maxChars);
-    }
-    output = withSentencePunctuation(output);
-  }
-
-  return output;
-}
-
-function normalizeTargetPlatform(value) {
-  const raw = toSafeString(value).toLowerCase();
-  if (!raw) return 'xiaohongshu';
-  return PLATFORM_LOOKUP.get(raw) ?? 'xiaohongshu';
-}
-
-function getPlatformProfile(platform) {
-  const normalized = normalizeTargetPlatform(platform);
-  return PLATFORM_PROFILES[normalized] ?? PLATFORM_PROFILES.xiaohongshu;
-}
-
-function normalizeYRange(value) {
-  if (!Array.isArray(value) || value.length < 2) return null;
-  const start = toFiniteNumber(value[0]);
-  const end = toFiniteNumber(value[1]);
-  if (start == null || end == null) return null;
-  const low = Math.min(start, end);
-  const high = Math.max(start, end);
-  return [Math.round(low), Math.round(high)];
-}
-
-function midpoint(range, fallback = 0) {
-  if (!Array.isArray(range) || range.length < 2) return fallback;
-  return Math.round((Number(range[0]) + Number(range[1])) / 2);
-}
-
-function coerceRangeByY(centerY, span = 220) {
-  const center = toFiniteNumber(centerY);
-  if (center == null) return null;
-  const half = Math.max(60, Math.round(span / 2));
-  return [Math.round(center - half), Math.round(center + half)];
-}
-
-function inAnyRange(y, ranges = []) {
-  return ranges.some(([start, end]) => y >= start && y <= end);
-}
-
-function normalizeModeHint(value) {
-  const mode = toSafeString(value);
-  return NARRATION_MODE_SET.has(mode) ? mode : null;
-}
-
-function normalizeSlotValue(value) {
-  if (Array.isArray(value)) {
-    const output = [];
-    const seen = new Set();
-    for (const item of value) {
-      const text = toSafeString(item);
-      if (!text) continue;
-      const key = text.toLowerCase();
-      if (seen.has(key)) continue;
-      seen.add(key);
-      output.push(text);
-    }
-    return output.length > 0 ? output : null;
-  }
-  const text = toSafeString(value);
-  return text || null;
-}
-
-function normalizeSemanticSlot(rawSlot = {}) {
-  const value = normalizeSlotValue(rawSlot?.value);
-  const statusRaw = toSafeString(rawSlot?.status);
-  const status = SLOT_STATUS_SET.has(statusRaw) ? statusRaw : (value == null ? 'missing' : 'present');
-  return {
-    value,
-    status,
-    confidence: Number(clampNumber(rawSlot?.confidence, 0, 1, 0).toFixed(2)),
-    focus_region: normalizeYRange(rawSlot?.focus_region ?? rawSlot?.focusRegion),
-    source_type: toSafeString(rawSlot?.source_type || rawSlot?.sourceType || 'heuristic') || 'heuristic',
-  };
-}
-
-function collectSemanticSlots(understanding = {}) {
-  const raw = understanding?.semantic_slots;
-  const source = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {};
-  const slots = {};
-  for (const key of SEMANTIC_SLOT_KEYS) {
-    slots[key] = normalizeSemanticSlot(source[key]);
-  }
-  return slots;
-}
-
-function slotHasValue(slot) {
-  if (!slot || slot.status === 'missing') return false;
-  if (Array.isArray(slot.value)) return slot.value.length > 0;
-  return Boolean(toSafeString(slot.value));
-}
-
-function slotConfidence(slot) {
-  const confidence = Number(slot?.confidence);
-  if (!Number.isFinite(confidence)) return 0;
-  return Math.max(0, Math.min(1, confidence));
-}
-
-function slotHasMinConfidence(slot, min = 0) {
-  return slotHasValue(slot) && slotConfidence(slot) >= min;
-}
-
-function slotValueToText(slot, { maxItems = 3 } = {}) {
-  if (!slotHasValue(slot)) return '';
-  if (!Array.isArray(slot.value)) return toSafeString(slot.value);
-  const picked = slot.value.slice(0, maxItems).map(item => toSafeString(item)).filter(Boolean);
-  if (picked.length <= 0) return '';
-  if (slot.value.length > picked.length) return `${picked.join('、')}等`;
-  return picked.join('、');
-}
-
-function slotLabel(key) {
-  return SLOT_LABELS[key] || key;
-}
-
-function formatRecruitmentType(slot) {
-  const raw = toSafeString(Array.isArray(slot?.value) ? slot.value[0] : slot?.value).toLowerCase();
-  if (!raw) return '';
-  return RECRUITMENT_TYPE_LABELS[raw] || raw;
-}
-
-function averageSlotConfidence(slots = []) {
-  const values = slots
-    .map(slot => Number(slot?.confidence))
-    .filter(value => Number.isFinite(value) && value > 0);
-  if (values.length <= 0) return 0;
-  return Number((values.reduce((sum, value) => sum + value, 0) / values.length).toFixed(2));
-}
-
-function hasAnySemanticSlot(slots = {}) {
-  return SEMANTIC_SLOT_KEYS.some(key => slotHasValue(slots[key]));
-}
-
-function detectRecruitmentRelated({ understanding = {}, slots = {} } = {}) {
-  const pageType = toSafeString(understanding?.page_type || understanding?.pageType).toLowerCase();
-  if (pageType === 'job_detail') return true;
-
-  const url = toSafeString(understanding?.url);
-  if (RECRUITMENT_KEYWORDS.test(url)) return true;
-
-  const coreMessage = toSafeString(understanding?.core_message || understanding?.coreMessage || understanding?.title);
-  if (RECRUITMENT_KEYWORDS.test(coreMessage)) return true;
-
-  return ['company', 'recruitment_type', 'job_directions', 'locations', 'process']
-    .some(key => slotHasValue(slots[key]));
-}
-
-function shouldApplyRecruitmentFailClosed(understanding = {}) {
-  const pageType = toSafeString(understanding?.page_type || understanding?.pageType).toLowerCase();
-  if (pageType === 'job_detail') return true;
-
-  const url = toSafeString(understanding?.url);
-  if (RECRUITMENT_KEYWORDS.test(url)) return true;
-
-  const headline = toSafeString(understanding?.core_message || understanding?.coreMessage || understanding?.title);
-  if (RECRUITMENT_KEYWORDS.test(headline)) return true;
-
-  return false;
-}
-
-function deriveModeFromSlots({ understanding = {}, slots = {} } = {}) {
-  const recruitmentRelated = detectRecruitmentRelated({ understanding, slots });
-
-  const companyStrong = slotHasMinConfidence(slots.company, MODE_MIN_CONFIDENCE.strong);
-  const publishedStrong = slotHasMinConfidence(slots.published_at, MODE_MIN_CONFIDENCE.strong);
-  const cohortSupport = slotHasMinConfidence(slots.cohort, MODE_MIN_CONFIDENCE.support);
-  const jobDirectionsSupport = slotHasMinConfidence(slots.job_directions, MODE_MIN_CONFIDENCE.support);
-  const locationsSupport = slotHasMinConfidence(slots.locations, MODE_MIN_CONFIDENCE.support);
-  const processSignal = slotHasMinConfidence(slots.process, MODE_MIN_CONFIDENCE.weakSignal);
-  const recruitmentTypeValue = toSafeString(Array.isArray(slots.recruitment_type?.value)
-    ? slots.recruitment_type.value[0]
-    : slots.recruitment_type?.value);
-  const recruitmentTypeKnown = ['campus', 'intern', 'experienced'].includes(recruitmentTypeValue);
-  const recruitmentTypePresent = recruitmentTypeKnown || recruitmentTypeValue === 'job_posting_unknown';
-  const recruitmentTypeStrong = recruitmentTypeKnown
-    && slotHasMinConfidence(slots.recruitment_type, MODE_MIN_CONFIDENCE.strong);
-  const recruitmentTypeSignal = recruitmentTypePresent
-    && slotHasMinConfidence(slots.recruitment_type, MODE_MIN_CONFIDENCE.weakSignal);
-
-  const keySlots = [slots.company, slots.published_at, slots.recruitment_type, slots.job_directions, slots.locations, slots.process];
-  const confidence = averageSlotConfidence(keySlots);
-  const reliableSignalCount = [
-    companyStrong,
-    publishedStrong,
-    recruitmentTypeSignal,
-    jobDirectionsSupport,
-    locationsSupport,
-    processSignal,
-  ].filter(Boolean).length;
-
-  if (companyStrong && ((publishedStrong && recruitmentTypeStrong) || (cohortSupport && jobDirectionsSupport) || (recruitmentTypeStrong && locationsSupport))) {
-    return { mode: 'job_intel_broadcast', confidence: Number(Math.max(0.7, confidence).toFixed(2)) };
-  }
-
-  if (companyStrong && publishedStrong && recruitmentTypeSignal) {
-    return { mode: 'job_alert', confidence: Number(Math.max(0.6, confidence).toFixed(2)) };
-  }
-
-  if (recruitmentRelated
-    && reliableSignalCount > 0
-    && confidence >= MODE_MIN_CONFIDENCE.floor) {
-    return { mode: 'info_summary', confidence: Number(Math.max(0.42, confidence).toFixed(2)) };
-  }
-
-  return { mode: 'refuse_auto_broadcast', confidence: Number(Math.max(0.2, confidence * 0.6).toFixed(2)) };
-}
-
-function evaluateRecruitmentFailClosed(slots = {}) {
-  const checks = {
-    company: slotHasMinConfidence(slots.company, MODE_MIN_CONFIDENCE.strong),
-    published_at: slotHasMinConfidence(slots.published_at, MODE_MIN_CONFIDENCE.support),
-    recruitment_type: slotHasMinConfidence(slots.recruitment_type, MODE_MIN_CONFIDENCE.weakSignal),
-    cohort: slotHasMinConfidence(slots.cohort, MODE_MIN_CONFIDENCE.support),
-    job_directions: slotHasMinConfidence(slots.job_directions, MODE_MIN_CONFIDENCE.support),
-    locations: slotHasMinConfidence(slots.locations, MODE_MIN_CONFIDENCE.support),
-  };
-
-  let bestGroup = null;
-  for (const group of RECRUITMENT_FAIL_CLOSED_GROUPS) {
-    const hitCount = group.keys.filter(key => checks[key]).length;
-    if (!bestGroup || hitCount > bestGroup.hitCount) {
-      bestGroup = { ...group, hitCount };
-    }
-    if (hitCount === group.keys.length) {
-      return {
-        passed: true,
-        matched_group: group.id,
-        missing_keys: [],
-      };
-    }
-  }
-
-  const missingKeys = bestGroup
-    ? bestGroup.keys.filter(key => !checks[key])
-    : ['company', 'published_at', 'recruitment_type'];
-
-  return {
-    passed: false,
-    matched_group: null,
-    missing_keys: missingKeys,
-    required_groups: RECRUITMENT_FAIL_CLOSED_GROUPS.map(group => [...group.keys]),
-  };
-}
-
-function resolveNarrationMode({ understanding = {}, slots = {} } = {}) {
-  const hintMode = normalizeModeHint(understanding?.mode_hint ?? understanding?.modeHint);
-  const hintConfidence = Number(clampNumber(understanding?.mode_hint_confidence ?? understanding?.modeHintConfidence, 0, 1, 0));
-  const derived = deriveModeFromSlots({ understanding, slots });
-
-  if (!hintMode) {
-    return {
-      mode: derived.mode,
-      confidence: derived.confidence,
-      source: 'derived',
-    };
-  }
-
-  if (hintMode === derived.mode) {
-    return {
-      mode: hintMode,
-      confidence: Number(Math.max(hintConfidence, derived.confidence).toFixed(2)),
-      source: 'hint+derived',
-    };
-  }
-
-  const hintedScore = MODE_SEVERITY[hintMode] ?? 1;
-  const derivedScore = MODE_SEVERITY[derived.mode] ?? 1;
-  const conservativeMode = hintedScore <= derivedScore ? hintMode : derived.mode;
-  const conservativeConfidence = conservativeMode === hintMode ? hintConfidence : derived.confidence;
-  return {
-    mode: conservativeMode,
-    confidence: Number(conservativeConfidence.toFixed(2)),
-    source: 'conservative_merge',
-    hinted_mode: hintMode,
-    derived_mode: derived.mode,
-  };
-}
-
-function focusRegionToHighlight({ focusRegion, fallbackY, id, text, confidence = 0.5 }) {
-  const yRange = normalizeYRange(focusRegion) ?? coerceRangeByY(fallbackY, 260);
-  if (!yRange) return null;
-  return {
-    id,
-    text: toSafeString(text) || null,
-    y_range: yRange,
-    target_y: midpoint(yRange, fallbackY ?? 0),
-    confidence: Number(clampNumber(confidence, 0, 1, 0).toFixed(2)),
-    type: 'semantic_slot',
-  };
-}
-
-function parseHotspot(raw, index = 0) {
-  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return null;
-
-  const id = toSafeString(raw.id || raw.hotspot_id || raw.name) || `hotspot_${index + 1}`;
-  const text = toSafeString(raw.text_excerpt || raw.textExcerpt || raw.text || raw.reason || raw.label);
-  const weight = clampNumber(raw.weight ?? raw.score ?? raw.priority ?? raw.rank ?? 1, 0, 10, 1);
-
-  let yRange = normalizeYRange(raw.y_range ?? raw.yRange ?? raw.range);
-  if (!yRange) {
-    const center = raw.y_center ?? raw.yCenter ?? raw.target_y ?? raw.targetY ?? raw.y;
-    yRange = coerceRangeByY(center);
-  }
-
-  if (!yRange) return null;
-  const targetY = midpoint(yRange, 0);
-
-  return {
-    id,
-    text,
-    weight,
-    y_range: yRange,
-    target_y: targetY,
-    type: toSafeString(raw.type || raw.kind) || null,
-  };
-}
-
-function collectHotspots(understanding = {}) {
-  const pools = [
-    understanding.visual_hotspots,
-    understanding.visualHotspots,
-    understanding.hotspots,
-    understanding.candidate_hotspots,
-    understanding.candidateHotspots,
-    understanding.highlights,
-  ];
-
-  const rows = [];
-  for (const pool of pools) {
-    if (!Array.isArray(pool)) continue;
-    for (const item of pool) {
-      rows.push(item);
-    }
-  }
-
-  return rows
-    .map((item, index) => parseHotspot(item, index))
-    .filter(Boolean);
-}
-
-function collectSkipZones(understanding = {}) {
-  const pools = [
-    understanding.skip_zones,
-    understanding.skipZones,
-    understanding.ignore_zones,
-    understanding.ignoreZones,
-  ];
-
-  const ranges = [];
-  for (const pool of pools) {
-    if (!Array.isArray(pool)) continue;
-    for (const item of pool) {
-      const range = normalizeYRange(item?.y_range ?? item?.yRange ?? item?.range ?? item);
-      if (range) ranges.push(range);
-    }
-  }
-  return ranges;
-}
-
-function resolveCoreRange(understanding = {}, hotspots = []) {
-  const direct = normalizeYRange(understanding.core_y_range ?? understanding.coreYRange);
-  if (direct) return direct;
-
-  if (hotspots.length > 0) {
-    const ys = hotspots.flatMap(item => item.y_range);
-    const minY = Math.min(...ys);
-    const maxY = Math.max(...ys);
-    if (Number.isFinite(minY) && Number.isFinite(maxY) && maxY > minY) {
-      return [Math.max(0, Math.round(minY - 120)), Math.round(maxY + 120)];
-    }
-  }
-
-  const totalHeight = clampInt(understanding.total_height_px ?? understanding.totalHeightPx ?? 2400, 1200, 12000, 2400);
-  return [0, totalHeight];
-}
-
-function pickHighlightHotspots({ hotspots, skipZones, coreRange, maxHighlights = 3 }) {
-  const [coreStart, coreEnd] = coreRange;
-  const candidates = hotspots
-    .filter((item) => item.target_y >= coreStart && item.target_y <= coreEnd)
-    .filter((item) => !inAnyRange(item.target_y, skipZones))
-    .sort((a, b) => {
-      if (b.weight !== a.weight) return b.weight - a.weight;
-      return a.target_y - b.target_y;
-    });
-
-  const picked = [];
-  for (const candidate of candidates) {
-    if (picked.length >= maxHighlights) break;
-    const tooClose = picked.some(existing => Math.abs(existing.target_y - candidate.target_y) < 260);
-    if (tooClose) continue;
-    picked.push(candidate);
-  }
-
-  if (picked.length > 0) return picked;
-
-  const fallbackY = clampInt((coreStart + coreEnd) / 2, coreStart, coreEnd, coreStart);
-  return [{
-    id: 'fallback_center',
-    text: '核心信息总览',
-    weight: 1,
-    y_range: coerceRangeByY(fallbackY, 240) ?? [fallbackY - 120, fallbackY + 120],
-    target_y: fallbackY,
-    type: 'fallback',
-  }];
-}
-
-function roundDuration(value) {
-  return Number(clampNumber(value, 1, 120, 1).toFixed(1));
-}
-
-function roundSpeed(value) {
-  return Number(clampNumber(value, 0.5, 2.0, 1).toFixed(2));
-}
-
-function computeTotalDuration({ requestedDuration, understanding, profile }) {
-  const [minS, maxS] = profile.duration_range_s;
-
-  const direct = toFiniteNumber(requestedDuration ?? understanding?.target_duration_s ?? understanding?.targetDurationS);
-  if (direct != null) return clampInt(direct, minS, maxS, profile.default_total_duration_s);
-
-  const recommended = understanding?.recommended_duration_s ?? understanding?.recommendedDurationS;
-  const range = normalizeYRange(recommended);
-  if (range) {
-    const mid = Math.round((range[0] + range[1]) / 2);
-    return clampInt(mid, minS, maxS, profile.default_total_duration_s);
-  }
-
-  const recommendedSingle = toFiniteNumber(recommended);
-  if (recommendedSingle != null) {
-    return clampInt(recommendedSingle, minS, maxS, profile.default_total_duration_s);
-  }
-
-  return profile.default_total_duration_s;
-}
-
-function distributeHighlightDurations({ totalDuration, profile, highlightCount }) {
-  const hook = profile.hook_duration_s;
-  const cta = profile.cta_duration_s;
-
-  if (highlightCount <= 0) {
-    return {
-      hook,
-      cta: Math.max(profile.cta_duration_s, totalDuration - hook),
-      highlights: [],
-    };
-  }
-
-  const remaining = Math.max(totalDuration - hook - cta, profile.min_highlight_duration_s * highlightCount);
-  const rawEach = remaining / highlightCount;
-  const each = Math.max(profile.min_highlight_duration_s, rawEach);
-  const highlights = new Array(highlightCount).fill(0).map(() => roundDuration(each));
-
-  const consumed = hook + cta + highlights.reduce((sum, item) => sum + item, 0);
-  const delta = roundDuration(totalDuration - consumed);
-  if (Math.abs(delta) >= 0.1 && highlights.length > 0) {
-    highlights[highlights.length - 1] = roundDuration(highlights[highlights.length - 1] + delta);
-  }
-
-  return { hook, cta, highlights };
-}
-
-function buildHookAction({ coreRange, firstHighlight }) {
-  if (firstHighlight?.id) {
-    return {
-      type: 'cursor_focus',
-      target_hotspot: firstHighlight.id,
-      target_y: firstHighlight.target_y,
-      reason: '聚焦第一关键点，建立开场锚点',
-    };
-  }
-  return {
-    type: 'scroll_to_dwell',
-    target_y: coreRange[0],
-    transition_ms: 700,
-    reason: '无显式热点时先定位核心区起点',
-  };
-}
-
-function buildHighlightAction({ highlight, index, previousY }) {
-  const currentY = highlight.target_y;
-
-  if (index === 0 || previousY == null) {
-    return {
-      type: 'scroll_to_dwell',
-      target_hotspot: highlight.id,
-      target_y: currentY,
-      transition_ms: 800,
-    };
-  }
-
-  const distance = Math.abs(currentY - previousY);
-  if (distance >= 420) {
-    return {
-      type: 'linear_scroll_during',
-      target_hotspot: highlight.id,
-      from_y: previousY,
-      to_y: currentY,
-    };
-  }
-
-  return {
-    type: 'cursor_focus',
-    target_hotspot: highlight.id,
-    target_y: currentY,
-  };
-}
-
-function buildCtaAction({ coreRange }) {
-  return {
-    type: 'scroll_back',
-    target_y: coreRange[0],
-    transition_ms: 900,
-    reason: '收尾回到核心起点，承接 CTA',
-  };
-}
-
-function buildNarrativeArc(highlights = []) {
-  return [
-    'hook',
-    ...highlights.map((_, index) => `highlight_${index + 1}`),
-    'cta',
-  ];
-}
-
-function resolveFallbackY({ coreRange, hotspots, index = 0 }) {
-  if (Array.isArray(hotspots) && hotspots[index]?.target_y != null) {
-    return hotspots[index].target_y;
-  }
-  return midpoint(coreRange, coreRange[0] ?? 0);
-}
-
-function pickFirstAvailableSlot(slots, keys = []) {
-  for (const key of keys) {
-    if (slotHasValue(slots[key])) return key;
-  }
-  return null;
-}
-
-function pickSlotKeysForMode({ mode, slots }) {
-  if (mode === 'job_intel_broadcast') {
-    const ordered = ['job_directions', 'locations', 'process', 'target_or_requirements', 'cohort'];
-    return ordered.filter(key => slotHasValue(slots[key])).slice(0, 3);
-  }
-  if (mode === 'job_alert') {
-    const ordered = ['job_directions', 'locations', 'cohort'];
-    return ordered.filter(key => slotHasValue(slots[key])).slice(0, 1);
-  }
-  if (mode === 'info_summary') {
-    const ordered = ['target_or_requirements', 'process', 'job_directions'];
-    return ordered.filter(key => slotHasValue(slots[key])).slice(0, 1);
-  }
-  return [];
-}
-
-function buildSlotBackedHighlights({
-  slots,
-  slotKeys = [],
-  hotspots = [],
-  coreRange = [0, 0],
-}) {
-  const highlights = [];
-  const usedTargets = [];
-  for (let i = 0; i < slotKeys.length; i += 1) {
-    const key = slotKeys[i];
-    const slot = slots[key];
-    const fallbackY = resolveFallbackY({ coreRange, hotspots, index: i });
-    const text = key === 'recruitment_type'
-      ? formatRecruitmentType(slot)
-      : slotValueToText(slot);
-    const base = focusRegionToHighlight({
-      focusRegion: slot?.focus_region,
-      fallbackY,
-      id: `slot_${key}`,
-      text: text || `${slotLabel(key)}线索`,
-      confidence: slot?.confidence ?? 0.5,
-    });
-    if (!base) continue;
-    const tooClose = usedTargets.some(target => Math.abs(target - base.target_y) < 220);
-    if (tooClose) continue;
-    highlights.push({
-      ...base,
-      semantic_slot: key,
-      slot_confidence: Number(clampNumber(slot?.confidence, 0, 1, 0).toFixed(2)),
-    });
-    usedTargets.push(base.target_y);
-  }
-  return highlights;
-}
-
-function buildSemanticSummary(slots = {}) {
-  return {
-    company: slotValueToText(slots.company),
-    published_at: slotValueToText(slots.published_at),
-    recruitment_type: formatRecruitmentType(slots.recruitment_type) || slotValueToText(slots.recruitment_type),
-    cohort: slotValueToText(slots.cohort),
-    job_directions: slotValueToText(slots.job_directions),
-    locations: slotValueToText(slots.locations),
-    target_or_requirements: slotValueToText(slots.target_or_requirements),
-    process: slotValueToText(slots.process),
-    entry_or_cta: slotValueToText(slots.entry_or_cta),
-  };
-}
-
-function describeCameraMotion(actionType) {
-  if (actionType === 'linear_scroll_during') return 'narrated_pan';
-  if (actionType === 'cursor_focus') return 'cursor_focus';
-  if (actionType === 'scroll_back') return 'return_anchor';
-  return 'focus_hold';
-}
-
-export function planVideo({
-  understanding = {},
-  persona = '',
-  target_platform = 'xiaohongshu',
-  total_duration_s = null,
-} = {}) {
-  const profile = getPlatformProfile(target_platform);
-  const normalizedPersona = toSafeString(persona || understanding?.persona || '目标受众');
-  const coreMessage = toSafeString(understanding?.core_message || understanding?.coreMessage || understanding?.title) || '本页价值点概览';
-
-  const hotspots = collectHotspots(understanding);
-  const baseSkipZones = collectSkipZones(understanding);
-  const coreRange = resolveCoreRange(understanding, hotspots);
-  const semanticSlots = collectSemanticSlots(understanding);
-  const recruitmentFailClosedEnabled = shouldApplyRecruitmentFailClosed(understanding);
-  const failClosedGate = evaluateRecruitmentFailClosed(semanticSlots);
-  if (recruitmentFailClosedEnabled && !failClosedGate.passed) {
-    const missingLabels = failClosedGate.missing_keys
-      .map(key => slotLabel(key))
-      .filter(Boolean);
-    const requiredLabels = RECRUITMENT_FAIL_CLOSED_GROUPS
-      .map(group => group.keys.map(key => slotLabel(key)).join('+'))
-      .join(' | ');
-    throw new Error(
-      `recruitment_fail_closed:missing=${missingLabels.join('、') || '关键槽位'};required_any_of=${requiredLabels}`
-    );
-  }
-  const hasSemanticSlots = hasAnySemanticSlot(semanticSlots);
-  const modeInfo = resolveNarrationMode({ understanding, slots: semanticSlots });
-  const semanticSummary = buildSemanticSummary(semanticSlots);
-
-  const isRecruitmentMode = modeInfo.mode === 'job_intel_broadcast' || modeInfo.mode === 'job_alert';
-  // For recruitment pages, treat the entry/CTA region as a hard skip zone so the
-  // camera never scrolls into the QR-code / application-link area.
-  const entrySkipRange = isRecruitmentMode
-    ? normalizeYRange(semanticSlots.entry_or_cta?.focus_region)
-    : null;
-  const skipZones = entrySkipRange
-    ? [...baseSkipZones, entrySkipRange]
-    : baseSkipZones;
-
-  const hotspotHighlights = pickHighlightHotspots({
-    hotspots,
-    skipZones,
-    coreRange,
-    maxHighlights: 3,
-  }).slice(0, 3);
-
-  const totalDuration = computeTotalDuration({
-    requestedDuration: total_duration_s,
-    understanding,
-    profile,
-  });
-
-  const maxHighlightsByBudget = Math.max(
-    1,
-    Math.floor(
-      Math.max(totalDuration - profile.hook_duration_s - profile.cta_duration_s, profile.min_highlight_duration_s)
-      / profile.min_highlight_duration_s
-    )
-  );
-  const semanticHighlightKeys = pickSlotKeysForMode({
-    mode: modeInfo.mode,
-    slots: semanticSlots,
-  });
-  const semanticHighlights = buildSlotBackedHighlights({
-    slots: semanticSlots,
-    slotKeys: semanticHighlightKeys,
-    hotspots: hotspotHighlights,
-    coreRange,
-  });
-
-  let normalizedHighlights = semanticHighlights;
-  if (!hasSemanticSlots || normalizedHighlights.length === 0) {
-    normalizedHighlights = hotspotHighlights.map(item => ({
-      ...item,
-      semantic_slot: null,
-      slot_confidence: null,
-    }));
-  }
-
-  const expectedHighlights = modeInfo.mode === 'refuse_auto_broadcast'
-    ? 0
-    : Math.max(1, Math.min(3, maxHighlightsByBudget));
-  normalizedHighlights = normalizedHighlights.slice(0, expectedHighlights);
-
-  const allocation = distributeHighlightDurations({
-    totalDuration,
-    profile,
-    highlightCount: normalizedHighlights.length,
-  });
-
-  const phasePlan = [];
-  const hookSlotKey = pickFirstAvailableSlot(semanticSlots, ['company', 'published_at', 'recruitment_type', 'cohort']);
-  const hookSlot = hookSlotKey ? semanticSlots[hookSlotKey] : null;
-  const hookAnchor = focusRegionToHighlight({
-    focusRegion: hookSlot?.focus_region,
-    fallbackY: resolveFallbackY({ coreRange, hotspots: hotspotHighlights, index: 0 }),
-    id: hookSlotKey ? `slot_${hookSlotKey}` : 'hook_anchor',
-    text: hookSlotKey === 'recruitment_type'
-      ? (formatRecruitmentType(hookSlot) || slotLabel(hookSlotKey))
-      : (slotValueToText(hookSlot) || slotLabel(hookSlotKey || 'company')),
-    confidence: hookSlot?.confidence ?? 0.4,
-  });
-
-  phasePlan.push({
-    phase_id: 'hook',
-    role: 'hook',
-    duration_s: roundDuration(allocation.hook),
-    visual_action: buildHookAction({
-      coreRange,
-      firstHighlight: hookAnchor ?? normalizedHighlights[0],
-    }),
-    semantic_slot: hookSlotKey,
-    focus_region: hookAnchor?.y_range ?? null,
-    confidence: hookSlot ? Number(clampNumber(hookSlot.confidence, 0, 1, 0).toFixed(2)) : null,
-    guidance: `开场先说结论，语气为${profile.tone}`,
-  });
-
-  let previousY = hookAnchor?.target_y ?? null;
-  for (let i = 0; i < normalizedHighlights.length; i += 1) {
-    const highlight = normalizedHighlights[i];
-    const phaseId = `highlight_${i + 1}`;
-    phasePlan.push({
-      phase_id: phaseId,
-      role: 'highlight',
-      highlight_index: i + 1,
-      duration_s: roundDuration(allocation.highlights[i] ?? profile.min_highlight_duration_s),
-      visual_action: buildHighlightAction({
-        highlight,
-        index: i,
-        previousY,
-      }),
-      highlight: {
-        id: highlight.id,
-        text: highlight.text || null,
-        y_range: highlight.y_range,
-        target_y: highlight.target_y,
-      },
-      semantic_slot: toSafeString(highlight.semantic_slot) || null,
-      focus_region: normalizeYRange(highlight.y_range),
-      confidence: highlight.slot_confidence == null
-        ? Number(clampNumber(highlight.confidence, 0, 1, 0).toFixed(2))
-        : Number(clampNumber(highlight.slot_confidence, 0, 1, 0).toFixed(2)),
-      guidance: '讲清这段信息的结论、证据与行动意义',
-    });
-    previousY = highlight.target_y;
-  }
-
-  // Recruitment pages: never navigate to entry/QR-code area for CTA.
-  const ctaSlotCandidates = isRecruitmentMode
-    ? ['process', 'company']
-    : ['entry_or_cta', 'process', 'company'];
-  const ctaSlotKey = pickFirstAvailableSlot(semanticSlots, ctaSlotCandidates);
-  const ctaSlot = ctaSlotKey ? semanticSlots[ctaSlotKey] : null;
-  const ctaAnchor = focusRegionToHighlight({
-    focusRegion: ctaSlot?.focus_region,
-    fallbackY: resolveFallbackY({ coreRange, hotspots: hotspotHighlights, index: 2 }),
-    id: ctaSlotKey ? `slot_${ctaSlotKey}` : 'cta_anchor',
-    text: ctaSlotKey ? (slotValueToText(ctaSlot) || slotLabel(ctaSlotKey)) : '收尾行动',
-    confidence: ctaSlot?.confidence ?? 0.38,
-  });
-  // Recruitment mode: always scroll back to core start — never scroll to entry/QR area.
-  const ctaAction = isRecruitmentMode
-    ? buildCtaAction({ coreRange })
-    : (ctaAnchor && modeInfo.mode !== 'refuse_auto_broadcast'
-      ? {
-        type: 'scroll_to_dwell',
-        target_hotspot: ctaAnchor.id,
-        target_y: ctaAnchor.target_y,
-        transition_ms: 900,
-        reason: '收尾聚焦行动提示',
-      }
-      : buildCtaAction({ coreRange }));
-
-  phasePlan.push({
-    phase_id: 'cta',
-    role: 'cta',
-    duration_s: roundDuration(allocation.cta),
-    visual_action: ctaAction,
-    semantic_slot: ctaSlotKey,
-    focus_region: ctaAnchor?.y_range ?? null,
-    confidence: ctaSlot ? Number(clampNumber(ctaSlot.confidence, 0, 1, 0).toFixed(2)) : null,
-    guidance: '介绍完最后一个信息点直接结束，禁止加任何收口语（不说"感兴趣去原文查看""截止见正文"等），禁止提及 URL、网址、二维码或投递入口',
-  });
-
-  const cappedPlan = phasePlan.slice(0, 5);
-  const highlightPhases = cappedPlan.filter(item => item.role === 'highlight');
-
-  return {
-    version: 'video-narration-plan/v1',
-    plan_video_version: 1,
-    target_platform: profile.id,
-    persona: normalizedPersona,
-    core_message: coreMessage,
-    narrative_arc: buildNarrativeArc(highlightPhases),
-    narration_mode: modeInfo.mode,
-    narration_mode_confidence: modeInfo.confidence,
-    narration_mode_source: modeInfo.source,
-    semantic_slots: semanticSlots,
-    semantic_summary: semanticSummary,
-    duration_range_s: profile.duration_range_s,
-    total_duration_s: roundDuration(
-      cappedPlan.reduce((sum, phase) => sum + Number(phase.duration_s || 0), 0)
-    ),
-    phase_plan: cappedPlan,
-    constraints: {
-      max_phases: 5,
-      max_highlights: 3,
-      phase_count: cappedPlan.length,
-      highlight_count: highlightPhases.length,
-    },
-    context: {
-      page_type: toSafeString(understanding?.page_type || understanding?.pageType) || null,
-      url: toSafeString(understanding?.url) || null,
-      hotspot_count: hotspots.length,
-      skip_zone_count: skipZones.length,
-      core_y_range: coreRange,
-      has_semantic_slots: hasSemanticSlots,
-      mode_hint: normalizeModeHint(understanding?.mode_hint ?? understanding?.modeHint),
-      mode_hint_confidence: Number(clampNumber(understanding?.mode_hint_confidence ?? understanding?.modeHintConfidence, 0, 1, 0).toFixed(2)),
-    },
-  };
-}
-
-function resolveVoiceForPhase({ profile, role, index = 0 }) {
-  const baseSpeed = profile.speed;
-
-  if (role === 'hook') {
-    return {
-      voice_preset: profile.voice_preset,
-      speed: roundSpeed(baseSpeed + 0.03),
-    };
-  }
-
-  if (role === 'cta') {
-    const delta = profile.id === 'douyin' ? -0.02 : -0.04;
-    return {
-      voice_preset: profile.voice_preset,
-      speed: roundSpeed(baseSpeed + delta),
-    };
-  }
-
-  const modulation = index % 2 === 0 ? 0 : -0.01;
-  return {
-    voice_preset: profile.voice_preset,
-    speed: roundSpeed(baseSpeed + modulation),
-  };
-}
-
-
-function estimateDurationMs(text, speed = 1) {
-  const chars = Math.max(1, toCharLength(text));
-  const cps = clampNumber(28 * Number(speed || 1), 12, 48, 28);
-  return Math.max(1500, Math.round((chars / cps) * 1000));
-}
-
-function resolveAudioId(payload = {}, fallbackPrefix = 'audio') {
-  const direct = toSafeString(payload.audio_id || payload.audioId);
-  if (direct) return direct;
-
-  const audioPath = toSafeString(payload.audio_path || payload.audioPath);
-  if (audioPath) {
-    const base = path.basename(audioPath, path.extname(audioPath));
-    if (base) return base;
-  }
-
-  const audioUrl = toSafeString(payload.audio_url || payload.audioUrl);
-  if (audioUrl) {
-    try {
-      const parsed = new URL(audioUrl);
-      const base = path.posix.basename(parsed.pathname || '', path.posix.extname(parsed.pathname || ''));
-      if (base) return base;
-    } catch {
-      // ignore URL parse failure
-    }
-  }
-
-  return `${fallbackPrefix}-${randomUUID().slice(0, 8)}`;
-}
-
-async function callGenerateVoiceover({
-  env,
-  fetchFn,
-  workspaceId,
-  text,
-  voicePreset,
-  speed,
-  format,
-  credentialId,
-}) {
-  const serverUrl = toSafeString(env?.SERVER_URL);
-  const machineApiKey = toSafeString(env?.MACHINE_API_KEY);
-  const agentId = toSafeString(env?.AGENT_ID);
-
-  if (!serverUrl || !machineApiKey || !agentId) {
-    throw new Error('tts_runtime_env_missing');
-  }
-
-  const targetWorkspaceId = toSafeString(workspaceId || env?.WORKSPACE_ID);
-  if (!targetWorkspaceId) {
-    throw new Error('tts_workspace_id_missing');
-  }
-
-  const payload = {
-    workspace_id: targetWorkspaceId,
-    text,
-    voice_preset: voicePreset,
-    speed,
-    format,
-  };
-  if (credentialId) payload.credential_id = credentialId;
-
-  const url = `${serverUrl.replace(/\/+$/, '')}/internal/agent/${encodeURIComponent(agentId)}/tts/voiceover`;
-  const response = await fetchFn(url, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      Authorization: `Bearer ${machineApiKey}`,
-    },
-    body: JSON.stringify(payload),
-  });
-
-  const textBody = await response.text();
-  let data = null;
-  try {
-    data = JSON.parse(textBody);
-  } catch {
-    data = null;
-  }
-
-  if (!response.ok) {
-    const errorText = toSafeString(data?.error || textBody).slice(0, 240);
-    throw new Error(`tts_http_${response.status}:${errorText || 'unknown_error'}`);
-  }
-
-  const duration = toFiniteNumber(data?.duration_ms);
-  if (duration == null || duration <= 0) {
-    throw new Error('tts_duration_missing');
-  }
-
-  return {
-    audio_id: resolveAudioId(data, 'voiceover'),
-    duration_ms: Math.round(duration),
-    audio_url: toSafeString(data?.audio_url) || null,
-    audio_path: toSafeString(data?.audio_path) || null,
-    provider: toSafeString(data?.provider) || null,
-    format: toSafeString(data?.format) || format,
-    voice_preset: toSafeString(data?.voice_preset) || voicePreset,
-  };
-}
-
-function normalizePhaseList(strategy = {}) {
-  const phases = Array.isArray(strategy?.phase_plan) ? strategy.phase_plan : [];
-  if (phases.length > 0) return phases.slice(0, 5);
-
-  return [
-    {
-      phase_id: 'hook',
-      role: 'hook',
-      duration_s: 6,
-      visual_action: { type: 'scroll_to_dwell', target_y: 0 },
-    },
-    {
-      phase_id: 'cta',
-      role: 'cta',
-      duration_s: 6,
-      visual_action: { type: 'scroll_back', target_y: 0 },
-    },
-  ];
-}
-
-function normalizeVisualAction(rawAction = {}, fallbackType = 'scroll_to_dwell') {
-  const typeRaw = toSafeString(rawAction?.type).toLowerCase();
-  const type = VISUAL_ACTION_SET.has(typeRaw) ? typeRaw : fallbackType;
-  return {
-    ...rawAction,
-    type,
-  };
-}
-
-function shouldTryTts({ env, workspaceId }) {
-  const serverUrl = toSafeString(env?.SERVER_URL);
-  const machineApiKey = toSafeString(env?.MACHINE_API_KEY);
-  const agentId = toSafeString(env?.AGENT_ID);
-  const targetWorkspaceId = toSafeString(workspaceId || env?.WORKSPACE_ID);
-  return Boolean(serverUrl && machineApiKey && agentId && targetWorkspaceId);
-}
-
-export async function detailSections({
-  strategy = {},
-  sentences = null,
-  workspace_id = null,
-  credential_id = null,
-  format = 'mp3',
-  strict_tts = false,
-} = {}, {
-  env = process.env,
-  fetchFn = globalThis.fetch,
-} = {}) {
-  if (isPlainObject(strategy) && !strategy.plan_video_version) {
-    throw new Error(
-      'pipeline_violation: strategy must come from plan_video output. '
-      + 'Required pipeline: analyze_page → plan_video → detail_sections → record_url_narration → compose_video → submit_to_library. '
-      + 'Do not hand-write strategy or bypass plan_video.'
-    );
-  }
-
-  if (!Array.isArray(sentences) || sentences.length === 0) {
-    throw new Error(
-      'sentences are required. Write one narration sentence per phase '
-      + '(hook, highlight_1…N, cta) based on the semantic_slots and persona from plan_video. '
-      + 'Use natural peer-voice tone for the target platform — not a news broadcast.'
-    );
-  }
-
-  const sentenceMap = {};
-  for (const item of sentences) {
-    const phaseId = toSafeString(item?.phase_id);
-    const text = toSafeString(item?.text);
-    if (phaseId && text) sentenceMap[phaseId] = text;
-  }
-
-  const profile = getPlatformProfile(strategy?.target_platform);
-  const phases = normalizePhaseList(strategy);
-
-  const sections = [];
-  const ttsErrors = [];
-  let usedLiveTts = false;
-
-  for (let i = 0; i < phases.length; i += 1) {
-    const phase = phases[i];
-    const phaseId = toSafeString(phase.phase_id) || `phase_${i + 1}`;
-    const role = toSafeString(phase?.role).toLowerCase() || (phaseId === 'cta' ? 'cta' : (phaseId === 'hook' ? 'hook' : 'highlight'));
-
-    const sentence = sentenceMap[phaseId];
-    if (!sentence) {
-      throw new Error(
-        `missing sentence for phase "${phaseId}". Provide a text sentence for every phase in the plan.`
-      );
-    }
-
-    const charLen = toCharLength(sentence);
-    if (charLen < SENTENCE_MIN_CHARS) {
-      throw new Error(`sentence for "${phaseId}" too short (${charLen} chars, min ${SENTENCE_MIN_CHARS}).`);
-    }
-    if (charLen > SENTENCE_MAX_CHARS) {
-      throw new Error(`sentence for "${phaseId}" too long (${charLen} chars, max ${SENTENCE_MAX_CHARS}). Shorten to fit one TTS segment.`);
-    }
-
-    const voice = resolveVoiceForPhase({ profile, role, index: i });
-    const phaseBudgetMs = clampInt((toFiniteNumber(phase?.duration_s) ?? 6) * 1000, 1000, 180000, 6000);
-
-    let audio = null;
-    const tryTts = shouldTryTts({ env, workspaceId: workspace_id });
-
-    if (tryTts) {
-      try {
-        audio = await callGenerateVoiceover({
-          env,
-          fetchFn,
-          workspaceId: workspace_id,
-          text: sentence,
-          voicePreset: voice.voice_preset,
-          speed: voice.speed,
-          format: toSafeString(format).toLowerCase() || 'mp3',
-          credentialId: toSafeString(credential_id) || null,
-        });
-        usedLiveTts = true;
-      } catch (error) {
-        const message = toSafeString(error?.message) || 'tts_call_failed';
-        ttsErrors.push({ phase_id: phaseId, error: message });
-        if (strict_tts) {
-          throw new Error(`detail_sections_tts_failed:${phaseId}:${message}`);
-        }
-      }
-    }
-
-    if (!audio) {
-      const estimatedDuration = estimateDurationMs(sentence, voice.speed);
-      audio = {
-        audio_id: `estimated-${phaseId}`,
-        duration_ms: estimatedDuration,
-        audio_url: null,
-        audio_path: null,
-        provider: 'estimated',
-        format: toSafeString(format).toLowerCase() || 'mp3',
-        voice_preset: voice.voice_preset,
-      };
-    }
-
-    const durationMs = clampInt(audio.duration_ms, 300, 180000, phaseBudgetMs);
-    const dwellMs = Math.max(durationMs, phaseBudgetMs);
-
-    const visualAction = normalizeVisualAction(phase.visual_action, role === 'cta' ? 'scroll_back' : 'scroll_to_dwell');
-    const phaseFocusRegion = normalizeYRange(
-      phase.focus_region
-      ?? phase.highlight?.y_range
-      ?? phase.semantic_focus_region
-      ?? phase.semanticFocusRegion
-    );
-
-    sections.push({
-      phase_id: phaseId,
-      visual_action: visualAction,
-      sentence,
-      voice_preset: voice.voice_preset,
-      speed: voice.speed,
-      audio_id: audio.audio_id,
-      duration_ms: durationMs,
-      dwell_ms: dwellMs,
-      audio_url: audio.audio_url,
-      audio_path: audio.audio_path,
-      semantic_slot: toSafeString(phase.semantic_slot) || null,
-      focus_region: phaseFocusRegion,
-      confidence: toFiniteNumber(phase.confidence) != null
-        ? Number(clampNumber(phase.confidence, 0, 1, 0).toFixed(2))
-        : null,
-      camera_motion: describeCameraMotion(visualAction.type),
-    });
-  }
-
-  const totalDurationMs = sections.reduce((sum, item) => sum + item.dwell_ms, 0);
-
-  return {
-    detail_sections_version: 1,
-    sections,
-    outro_video_id: toSafeString(strategy?.outro_video_id || strategy?.outroVideoId) || DEFAULT_OUTRO_VIDEO_ID,
-    total_duration_ms: totalDurationMs,
-    constraints: {
-      sections_count: sections.length,
-      max_sections: 5,
-      dwell_covers_audio: sections.every(item => item.dwell_ms >= item.duration_ms),
-      sentence_char_range: [SENTENCE_MIN_CHARS, SENTENCE_MAX_CHARS],
-    },
-    meta: {
-      target_platform: profile.id,
-      tts_mode: usedLiveTts ? 'live_or_partial_live' : 'estimated',
-      tts_errors: ttsErrors,
-    },
-  };
-}
-
-export function createVideoNarrationPlanner(runtime = {}) {
-  const env = runtime.env ?? process.env;
-  const fetchFn = runtime.fetchFn ?? globalThis.fetch;
-
-  return {
-    planVideo: (input = {}) => planVideo(input),
-    detailSections: (input = {}) => detailSections(input, { env, fetchFn }),
-  };
-}
-
-export { normalizeTargetPlatform, getPlatformProfile, ensureSentenceLength };