aimakeall-mcp 0.14.4 → 0.14.5

package/README.md

@@ -137,9 +137,125 @@ ElevenLabs의 실제 자막은 `options.includeAlignment:true`로 오디오와
 `get_generation_job` 완료 응답은 보호된 오디오 링크와 검증된 `subtitleLines`,
 `timingSource:"provider-character-alignment"`를 반환합니다. 응답이 끊겨도 같은 ID를
 조회하며 다른 공급자나 기존 동기 TTS로 다시 합성하지 않습니다. 이 비동기 도구가
-기존 `tts_narration_with_captions`의 로컬 파일·제작 핸들을 자동 갱신하는 것은 아닙니다.
+기존 제작 핸들을 갱신해야 한다면 아래 제작용 도구 흐름을 사용합니다.
+
+### 기존 음성 도구의 공유 실행 연결 (다음 릴리스용 변경, 아직 게시 전)
+
+- `tts_narration`과 `tts_narration_with_captions`는 인증된
+  `GET /api/tracker/tts/mcp-execution-capability`로 실행 방식을 먼저 확인합니다.
+  서버가 명시적으로 `binary`를 반환할 때만 기존 동기 합성을 사용합니다.
+  구형 서버의 404, 통신 실패, 알 수 없는 계약을 동기 합성 허용으로 해석하지 않습니다.
+  따라서 **대응 서버를 먼저 배포한 뒤 MCP를 게시·업데이트**해야 합니다.
+- 공유 유료 합성은 제작 핸들의 `productionId`로 안정된 작업 ID를 만들며,
+  핸들이 없으면 `requestId`(영문·숫자·`_`·`-`, 16~80자)가 필요합니다.
+  Typecast → ElevenLabs → Supertone → Edge → Supertonic2의 선택 우선순위와
+  저장된 캐스팅을 유지합니다. 접수 뒤 공급자 변경·자동 유료 재합성은 없습니다.
+- 접수 결과의 `generationJobId`로 `finish_speech_generation`을 호출합니다.
+  완료 전이면 상태만 반환하고, 완료되면 보호된 오디오를 PC에 저장하고 **새로운**
+  `productionPath`를 반환합니다. 이를 `stitch_timeline`에 전달하세요.
+  원래 제작 핸들의 제목·강조어·디자인·캐스팅은 보존하며 원본 파일을 덮어쓰지 않습니다.
+  ElevenLabs 자막은 공급자 문자 정렬, 나머지는 실제 오디오 길이에 따른 추정임을 표시합니다.
+- 제출 전에 비공개 로컬 기록을 저장합니다. 응답 유실·MCP 재연결 후에는 같은 기록의
+  작업을 조회·다운로드할 뿐 다시 POST하지 않습니다. 입력이 달라지면 자동으로 새 ID를
+  만들지 않습니다. 결과 불명을 해결하려고 기록 삭제·PAT 교체·새 ID 합성을 하지 마세요.
+  의도적으로 새 음성이 필요한 경우 기존 비용/상태를 확인한 뒤 별도 `requestId`를 지정합니다.
+- 기록은 `stateDir/speech-production-v1`에 저장되며 PAT 원문은 저장하지 않습니다.
+  다른 PAT/서버의 기록, 변조·불완전 파일은 거절합니다. 음성 파일의 TTL 정리와 달리
+  제출 기록은 자동 삭제하지 않습니다(최대 4,096건/합계 64MiB, 개별 2MiB).
+  한도에 도달하면 새 유료 접수를 차단하며,
+  기존 ID의 조회·다운로드는 계속 가능합니다.
+- 이 완료 도구는 위 두 제작 도구가 남긴 기록을 사용합니다. 독립 도구
+  `start_speech_generation`의 작업은 계속 `get_generation_job`으로 조회합니다.
+  리메이크/리뷰 행별 합성은 아래의 별도 작업 흐름을 사용합니다.
+
+### 리메이크·리뷰 행별 공유 음성 (다음 릴리스용 변경, 아직 게시 전)
+
+- `prepare_remake_timeline`, `prepare_review_timeline`은 인증된
+  `/api/tracker/mcp/narration/{remake|review}/execution-capability`를 먼저 확인합니다.
+  `binary`일 때만 기존 단일 서버 실행을 사용합니다. 구형 서버/통신 오류로 폴백하지
+  않으므로 대응 서버를 먼저 배포해야 합니다.
+- 공유 모드에서는 전체 행의 합성 비용에 동의한 뒤 시작하세요. 리메이크는 고정
+  `requestId`가 필요하고 리뷰는 제작 핸들의 `productionId`에서 작업 ID를 결정합니다.
+  Typecast·ElevenLabs·Supertone의 명시 보이스가 필요합니다. 공유 Edge/Supertonic2
+  행별 실행은 아직 지원하지 않으며 유료·동기 대체 실행을 하지 않습니다.
+- 반환된 `operationId`를 `continue_narrated_timeline`에 전달합니다. 이 도구는
+  **조회 전용이 아닙니다.** 기존 행을 확인한 후 아직 제출하지 않은 행을 호출당 최대
+  1건 합성합니다. 접수한 행은 같은 작업 ID로 조회만 하며 실패·응답 유실 시
+  다시 합성하지 않습니다. 완료 행의 비용 영수증도 함께 반환합니다.
+- 리뷰는 각 음성의 실제 길이가 원본 구간을 넘으면 다음 행을 합성하기 전에 멈춥니다.
+  최종 서버 조립에서도 소유권·입력·비용 확정·오디오 무결성·길이를 다시 확인합니다.
+  원래 제목·자막 디자인·자동 소재 편집·캐스팅을 유지하고, 로컬 원본 경로는 서버에
+  보내지 않습니다. 모두 완료되면 `payloadPath`를 `render_start`에 전달합니다.
+- `stateDir/narration-timeline-v1`에 서버/PAT에 결속한 기록을 저장합니다.
+  기록 삭제·PAT 교체·새 ID로 결과 불명을 우회하지 마세요. 기존 음성 조립은 새
+  TTS 비용을 발생시키지 않지만 서버의 렌더 이용 한도는 적용됩니다. 최종 미디어가
+  TTL로 정리되면 자동 재합성/재조립하지 않습니다. 보관 기록은 자동 삭제하지 않으며
+  4,096개/64MiB 한도에 이르면 새 접수를 중단합니다.
+
 - 이미지·영상·LLM 폴백은 대응 서버가 지원하는 동일 기능/입력 경로에서만 동작합니다. SUNO, 음성 클로닝, 정밀 정렬 등 모든 독점 기능에 호환 대체가 있는 것은 아닙니다. 상태 조회만으로 미확인 유료 작업을 재생성하지 마세요.
 
+### 보이스 추천 공유 실행 (다음 릴리스용 변경, 아직 게시 전)
+
+- `recommend_voice`는 대응 서버의 capability를 확인합니다. `legacy-sync`일 때만
+  기존 단일 서버 경로를 쓰며, 공유 모드에서는 샘플 관측/추천을 하나의 영속 작업으로
+  실행합니다. 대응 서버를 먼저 배포해야 하며 404·통신 실패를 동기 폴백으로 취급하지 않습니다.
+- 동일한 주제·대본·프로필·샘플·요청 공급자 조합은 재연결 후 기존 작업만 조회합니다.
+  새 유료 추천을 명시적으로 원할 때만 새 `requestId`(UUID)를 지정하세요. 불명 작업을
+  우회하려고 ID·PAT·기록을 변경하지 마세요. 응답의 `backgroundJobId`와 비용 영수증을 보존합니다.
+- Typecast → ElevenLabs → Supertone → Edge → Supertonic2 순서는 TTS 공급자 선택입니다.
+  공유 **추천 LLM**은 Gemini 3 Flash입니다. 계정의 사용 가능한 키를 기준으로 호출 전에
+  EvoLink를 우선 선택하고, 해당 키가 없으면 KIE를 선택합니다. KIE-only 계정의 샘플
+  스트리밍 분석도 지원합니다. 두 키 모두 없으면 무료 TTS 공급자의 샘플 없는 카탈로그
+  추천만 가능합니다. 호출 후 공급자를 바꾸거나 샘플 분석을 조용히 생략하지 않습니다.
+- 샘플은 앞 90초 이내만 관측하고 단계별 비용 기록 확인 후 다음 요청을 보냅니다.
+  요청 실패/비용 확인 불명/JSON 오류에는 자동 유료 재시도를 하지 않습니다.
+  보이스·자막 스타일·제작 프로필은 최신 `productionPath`로 다음 합성에 이어집니다.
+- `stateDir/voice-recommendation-v1`은 별도 비공개 journal입니다(최대 4,096건,
+  결과 파일당 64KiB). PAT 원문·카탈로그·샘플 오디오는 기록하지 않고 자동 삭제하지 않습니다.
+  저장소/서버 작업이 정리되거나 손상되면 자동 재추천하지 않으므로 고객지원에 문의하세요.
+
+### 리뷰 기획 공유 실행 (다음 릴리스용 변경, 아직 게시 전)
+
+- `plan_review_video`는 `/api/tracker/review/plan/execution-capability`의
+  명시적 `queue-v2`에 따라 영속 작업을 제출합니다. `legacy-sync`일 때만
+  기존 동기 기획을 사용합니다. 404·인증 실패·통신 오류로 유료 동기 기획을
+  대신 실행하지 않으므로 **대응 서버를 먼저 배포한 뒤 MCP를 업데이트**합니다.
+- 같은 `reviewSourcePath`·리뷰 설정·선택 장면으로 다시 호출하면 기존 작업만
+  조회합니다. 응답의 `backgroundJobId`와 비용 영수증을 보존하세요.
+  제출 결과가 불명확하거나 서버 기록이 만료되면 자동 재제출하지 않습니다.
+  기록 삭제·PAT 교체·새 핸들로 불명 작업을 우회하지 말고 고객지원에 문의하세요.
+- 전체 분석/원본 재검증 완료 조건, 전체 전사와 원본 구간 근거, 말투·자막의
+  사실/해석 구분을 유지합니다. 원본 핸들이 변경되거나 없어지면 이미 받은 결과와
+  섞지 않고 기존 작업 ID·확정 비용을 포함한 오류를 반환합니다. 선택한 TTS 공급자와
+  보이스는 제작 핸들에 보존하며 보이스만 변경해도 기획 LLM을 다시 호출하지 않습니다.
+- `stateDir/review-plan-v1`에는 비공개 제출·결과 기록을 저장합니다.
+  결과에는 원본 근거/전사가 포함되므로 민감한 자료처럼 보관하세요. PAT 원문과
+  로컬 원본 파일 경로는 저장하지 않습니다. 최대 32건/결과 파일당 20MiB이며
+  자동 삭제하지 않습니다. 한도에 이르면 새 제출을 차단하고 기존 작업 조회는 유지합니다.
+
+### 쇼츠·커머스·뮤직비디오 기획 공유 실행 (다음 릴리스용 변경, 아직 게시 전)
+
+- `plan_shorts_video`, `plan_commerce_video`, `plan_music_video`는 각각의 인증된
+  `/plan/execution-capability`에서 `queue-v2`를 확인하면 전용 `/plan/jobs`에
+  제출합니다. `legacy-sync`만 기존 동기 실행을 허용하며, 404·인증·통신 오류는
+  동기 폴백 허가가 아닙니다. 대응 서버 배포 후 MCP 새 버전을 게시해야 합니다.
+- 동일한 기획 옵션으로 다시 호출하면 알려진 작업 ID만 조회합니다. 접수 응답이
+  유실돼 ID가 불명확해도 자동 재제출하지 않습니다. 기록·PAT·입력을 바꾸어
+  불명 작업을 우회하지 마세요. 반환된 `backgroundJobId`와 비용 영수증을 보존합니다.
+- 커머스 기획은 파일을 열기 전에 기존 접수를 조회하고, 동일 경로의 상품/모델 사진
+  바이트까지 제출 당시 입력과 대조합니다. 사진 변경·삭제 시 기존 결과를 새 입력과
+  섞지 않으며 기존 작업 ID·비용을 포함한 오류를 반환합니다.
+- 자막·제작 프로필, 캐릭터, 이미지 소스/모션 선택, 채널 규격, 상품 조사 근거,
+  음악 구간을 유지합니다. 결과 핸들 경로는 새로 만들지만 복구된 기획의
+  `productionId`는 유지하므로 후속 영속 TTS를 새 제작으로 오인하지 않습니다.
+  리뷰 기획 복구에도 같은 제작 ID 보존을 적용합니다.
+- `stateDir/studio-plan-v1`은 비공개 기록입니다. 최대 32개/결과 파일당 10MiB이며
+  자동 정리하지 않습니다. 입력 원문/사진/PAT/로컬 파일 경로는 기록하지 않고
+  입력 digest와 기획 결과·확정 비용을 저장합니다. 결과에 민감한 내용이 있을 수
+  있으므로 보호하세요. 한도에 이르면 새 제출만 차단하고 기존 작업 조회는 유지합니다.
+- 이것은 시나리오 기획 연결이며 상품 웹 조사, 음악 생성/가사 정렬, 원본 영상 분석,
+  교사 비동기 과금 등 다른 경로까지 모두 공유 실행된다는 뜻은 아닙니다.
+
 ## 장면 이미지 준비와 영상 표현 선택
 
 다음 설정은 0.12.0부터 지원합니다. 구형 클라이언트는 위의 자동 업데이트 전환 안내에 따라 한 번 전환하고 유휴 상태에서 다시 연결해야 새 입력과 도구 안내를 사용할 수 있습니다. 이미지 모션 렌더에는 해당 기능을 지원하는 최신 컴패니언 런타임도 필요합니다.

package/lib/cloud-tools.mjs

@@ -1,4 +1,7 @@
 import { createChannelMeasurementClient } from "./durable-channel-client.mjs";
+import { createVoiceRecommendationClient } from "./voice-recommendation-client.mjs";
+import { createStudioPlanningClient, studioPlanReceipt, withStudioPlanReceipt } from './studio-plan-client.mjs';
+import { compactVoiceCatalog } from "./voice-catalog.mjs";
 
 import { createReadStream, readFileSync, statSync } from "node:fs";
 import path from "node:path";
@@ -26,6 +29,8 @@ import { canonicalYoutubeWatchUrl } from "./payload-guard.mjs";
 import { createUsageEventId } from "./usage-event.mjs";
 import { fetchGenerationJob, GENERATION_JOB_PATH, submitGenerationJob, requestGenerationJobAction } from "./generation-jobs.mjs";
 import { durableSpeechToolSchema, submitDurableSpeech, durableSpeechResult } from "./durable-speech.mjs";
+import { trySharedSpeechProduction, finishSpeechProduction } from "./speech-production.mjs";
+import { trySharedNarrationTimeline, continueNarratedTimeline } from "./narration-timeline.mjs";
 import { loudnessDbfsFromWav, silenceRatioFromWav } from "./wav-dsp.mjs";
 import { trimWavToSeconds } from "./wav-trim.mjs";
 import { registerComposerTools } from "./composer-tools.mjs";
@@ -101,6 +106,10 @@ function jsonResult(value) {
   return textResult(JSON.stringify(value, null, 2));
 }
 
+function speechProductionResult(value) {
+  return textResult(JSON.stringify(value, null, 2), { isError: !["pending", "running", "completed"].includes(value.status) });
+}
+
 // JSON + 이미지 블록 결과 — 비전 지원 클라이언트의 에이전트가 산출물을 "직접 보고"
 // QC(1층 검증)할 수 있게 한다. 비전 미지원 클라이언트는 이미지 블록을 무시한다.
 function jsonWithImagesResult(value, images = []) {
@@ -160,6 +169,10 @@ export function wrapCloudHandler(config, handler) {
     try {
       return await handler(args, extra);
     } catch (error) {
+      if (error?.paidReplayAllowed === false) return textResult(JSON.stringify({
+        error: describeLocalError(error), code: error.code, ...studioPlanReceipt(error),
+        guidance: "기존 작업 ID와 비용을 확인하세요. 결과 불명 작업을 자동으로 재제출하지 마세요.",
+      }), { isError: true });
       if (error instanceof AimakeallApiError) {
         const retry = error.retryAfterSeconds ? ` (${error.retryAfterSeconds}초 후 재시도)` : "";
         if (error.partialProviderUsage || error.accountCostEvents.length || error.fallbackStatus) {
@@ -177,6 +190,32 @@ export function wrapCloudHandler(config, handler) {
   };
 }
 
+async function runStudioPlan(config, api, operation, intent, buildBody, apply) {
+  const client = createStudioPlanningClient(config, api, operation, intent), recovered = await client.recover();
+  return withStudioPlanReceipt(recovered, async () => {
+    const body = await buildBody();
+    let payload = recovered;
+    if (payload) await client.assertInputMatches(body);
+    else {
+      const mode = await client.readCapability();
+      if (mode === 'legacy-sync') payload = await client.legacy(body);
+      else if (mode === 'queue-v2') payload = await client.run(body);
+      else throw Object.assign(Error('공유 시나리오 실행을 현재 사용할 수 없습니다.'), { code: 'STUDIO_PLAN_UNAVAILABLE', paidReplayAllowed: false });
+    }
+    return withStudioPlanReceipt(payload, () => apply(payload));
+  });
+}
+
+function studioPlanningContext(payload) {
+  return {
+    // Immutable local handles may have new paths, but a recovered plan is the
+    // same production. Downstream durable TTS must not get a fresh random ID.
+    ...(payload?.backgroundJobId ? { productionId: 'studio-plan:' + payload.backgroundJobId } : {}),
+    planningReceipt: studioPlanReceipt(payload),
+    charactersUsed: payload?.charactersUsed || [],
+  };
+}
+
 // 씬 응답에서 모델 컨텍스트에 유용한 필드만 추린다 (base64/내부 필드 제외).
 function trimPlanScenes(scenes) {
   return (Array.isArray(scenes) ? scenes : []).map((scene) => ({
@@ -271,6 +310,13 @@ export function registerCloudTools(server, config, api) {
     }),
   );
 
+  server.tool(
+    "finish_speech_generation",
+    "tts_narration/tts_narration_with_captions가 공유 모드에서 반환한 기존 작업만 조회해 완료 오디오와 자막을 PC에 저장하고 productionPath를 반환합니다. 합성 POST·재과금 없음. MCP 재시작 뒤에도 같은 ID를 사용하세요. start_speech_generation 단독 작업에는 해당 로컬 제작 기록이 없어 사용할 수 없습니다.",
+    { generationJobId: z.string().regex(/^[a-zA-Z0-9_-]{16,80}$/u) },
+    wrapCloudHandler(config, async ({ generationJobId }) => speechProductionResult(await finishSpeechProduction(api, config, generationJobId))),
+  );
+
   server.tool(
     "resume_generation_job",
     "내 계정의 기존 생성 작업에서 접수된 공급자 작업 상태·결과를 복구합니다. 원래 유료 생성은 다시 제출하지 않습니다. get_generation_job의 workflow.canResume이 true일 때 사용하세요.",
@@ -347,7 +393,7 @@ export function registerCloudTools(server, config, api) {
 
   server.tool(
     "plan_shorts_video",
-    "쇼츠 영상 기획(시나리오·씬별 이미지 프롬프트·내레이션)을 생성합니다. topic 또는 copy 중 하나는 필수. 결과 scenes의 imagePrompt는 generate_scene_image로, skill은 씬 영상 프롬프트의 videoStylePreset으로, emphasisKeywords는 stitch_timeline의 emphasisKeywords로 이어집니다(하단자막 단어 강조).",
+    "쇼츠 영상 기획(시나리오·씬별 이미지 프롬프트·내레이션)을 생성합니다. topic 또는 copy 중 하나는 필수. 결과 scenes의 imagePrompt는 generate_scene_image로, skill은 씬 영상 프롬프트의 videoStylePreset으로, emphasisKeywords는 stitch_timeline의 emphasisKeywords로 이어집니다(하단자막 단어 강조). 공유 모드에서는 제출 기록을 보존하고 같은 입력 재연결은 기존 작업만 조회합니다. 접수 불명 작업은 자동 재제출하지 않습니다.",
     {
       productionProfile: productionFields.productionProfile,
       ...visualProductionFields,
@@ -385,8 +431,9 @@ export function registerCloudTools(server, config, api) {
         return textResult("topic 또는 copy 중 하나는 입력해야 합니다.", { isError: true });
       }
       const visualSettings = resolveVisualSettings(null, { productionProfile, imageSourceMode, visualMotionMode });
-      const payload = await api.request("/api/tracker/shorts-video/plan", {
-        body: {
+      return runStudioPlan(config, api, 'shorts',
+        { ...visualSettings, productionProfile, durationTargetSec, categoryId, channelFingerprint, copy, sceneCount, characters, targetCustomer, tone, topic },
+        () => ({
           ...visualSettings,
           categoryId,
           productionProfile,
@@ -401,17 +448,16 @@ export function registerCloudTools(server, config, api) {
           targetCustomer,
           tone,
           topic,
-        },
-        method: "POST",
-        timeoutMs: 240_000,
-      });
+        }), payload => {
       const productionPath = saveProductionContext(config.stateDir, {
+        ...studioPlanningContext(payload),
         topic, visualSettings, autoCompose: productionProfile?.autoComposeEnabled ?? true,
         productionProfile: payload?.productionProfile, narrationScript: payload?.narrationScript,
         narrationSource: payload?.narrationSource, tagline: payload?.tagline, emphasisKeywords: payload?.emphasisKeywords || [],
         channelFingerprint, scenes: trimPlanScenes(payload?.scenes),
       });
       return jsonResult({
+        ...studioPlanReceipt(payload),
         productionPath,
         ...visualSettings,
         productionProfile: payload?.productionProfile,
@@ -427,6 +473,7 @@ export function registerCloudTools(server, config, api) {
         specWarnings: Array.isArray(payload?.specWarnings) && payload.specWarnings.length ? payload.specWarnings : undefined,
         tagline: payload?.tagline,
       });
+      });
     }),
   );
 
@@ -509,7 +556,7 @@ export function registerCloudTools(server, config, api) {
 
   server.tool(
     "plan_commerce_video",
-    "제품 홍보 영상 기획을 생성합니다. 제품 사진 파일 경로가 최소 1장 필요합니다 (이 PC의 로컬 경로).",
+    "제품 홍보 영상 기획을 생성합니다. 제품 사진 파일 경로가 최소 1장 필요합니다 (이 PC의 로컬 경로). 공유 모드에서는 같은 입력으로 다시 호출해 기존 작업만 조회하며 사진 변경 시 이전 결과를 적용하지 않습니다. 접수 불명 작업은 자동 재제출하지 않습니다.",
     {
       ...visualProductionFields,
       productionProfile: productionFields.productionProfile,
@@ -532,13 +579,16 @@ export function registerCloudTools(server, config, api) {
     },
     wrapCloudHandler(config, async ({ productName, productImagePaths, modelImagePath = "", description = "", targetCustomer = "", tone = "자동 추천", categoryId = "ecommerce", sceneCount = 6, researchBrief = "" , characters = [], productionProfile, imageSourceMode, visualMotionMode }) => {
       const visualSettings = resolveVisualSettings(null, { productionProfile, imageSourceMode, visualMotionMode });
+      return runStudioPlan(config, api, 'commerce',
+        { ...visualSettings, productionProfile, productName, productImagePaths: productImagePaths.map(file => path.resolve(file)),
+          modelImagePath: modelImagePath ? path.resolve(modelImagePath) : '', description, targetCustomer, tone, categoryId, sceneCount, researchBrief, characters },
+        () => {
       // 확장자 검증(임의 파일 업로드 차단) + 합산 크기 예산(서버 413 사전 차단).
       for (const filePath of productImagePaths) assertAllowedInputFile(filePath, ALLOWED_IMAGE_EXTS, { kind: "이미지" });
       if (modelImagePath) assertAllowedInputFile(modelImagePath, ALLOWED_IMAGE_EXTS, { kind: "모델 이미지" });
       assertEncodedBudget([...productImagePaths, modelImagePath], { context: "제품/모델 사진" });
 
-      const payload = await api.request("/api/tracker/commerce-video/plan", {
-        body: {
+      return {
           ...visualSettings, productionProfile,
           categoryId,
           description,
@@ -553,25 +603,27 @@ export function registerCloudTools(server, config, api) {
           skillOverride: null,
           targetCustomer,
           tone,
-        },
-        method: "POST",
-        timeoutMs: 300_000,
-      });
+        };
+      }, payload => {
       const productionPath = saveProductionContext(config.stateDir, {
+        ...studioPlanningContext(payload),
         topic: productName, visualSettings, autoCompose: productionProfile?.autoComposeEnabled ?? true,
         productionProfile: payload?.productionProfile || productionProfile,
         tagline: payload?.tagline, narrationScript: payload?.narrationScript,
         scenes: trimPlanScenes(payload?.scenes), featureKey: "commerceVideo",
       });
       return jsonResult({
+        ...studioPlanReceipt(payload),
         productionPath, ...visualSettings, productionProfile: payload?.productionProfile || productionProfile,
         analysis: trimAnalysis(payload?.analysis),
+        charactersUsed: payload?.charactersUsed,
         ctaText: payload?.ctaText,
         ok: payload?.ok,
         scenes: trimPlanScenes(payload?.scenes),
         skill: payload?.skill,
         tagline: payload?.tagline,
       });
+      });
     }),
   );
 
@@ -757,9 +809,10 @@ export function registerCloudTools(server, config, api) {
 
   server.tool(
     "tts_narration",
-    "내레이션 TTS를 합성해 이 PC에 저장합니다. 자동 순서: Typecast → ElevenLabs → Supertone → Edge → Supertonic2. 확정된 일시 거절에만 폴백하며, 명시 보이스는 fallbackVoices가 있어야 교체합니다. 접수 후 결과 불명·정책·인증 오류는 재합성하지 않습니다. 먼저 recommend_voice로 톤에 맞는 보이스를 고르세요.",
+    "내레이션 TTS. 자동 순서 Typecast→ElevenLabs→Supertone→Edge→Supertonic2. 공유 모드에서는 작업 ID를 반환하며 finish_speech_generation으로 PC 파일·제작 핸들을 완성합니다. 제작 핸들이 없으면 requestId 필수. 공유 모드의 공급자 폴백은 지원하지 않습니다. 단일 서버에서만 확정된 일시 거절에 허용된 폴백을 사용하며 결과 불명 시 재합성하지 않습니다.",
     {
       ...productionFields,
+      requestId: z.string().regex(/^[a-zA-Z0-9_-]{16,80}$/u).optional().describe("공유 모드에서 동일 요청에 유지할 ID. 제작 핸들이 있으면 자동 결정. 의도적인 새 합성만 새 ID를 지정하세요."),
       text: z.string().optional().describe("생략 시 productionPath의 기획 대본"),
       ...ttsFallbackFields,
       provider: z.enum(["auto", ...TTS_PROVIDERS]).optional().describe("기본 자동: Typecast→ElevenLabs→Supertone→Edge→Supertonic2. 명시 선택/저장된 보이스는 유지"),
@@ -768,11 +821,15 @@ export function registerCloudTools(server, config, api) {
       stability: z.number().min(0).max(1).optional(), style: z.number().min(0).max(1).optional(),
       modelId: z.string().optional(), similarityBoost: z.number().min(0).max(1).optional(), speakerBoost: z.boolean().optional(),
     },
-    wrapCloudHandler(config, async ({ text, provider, voice = "", speed, productionPath, productionProfile, stability, style, modelId, similarityBoost, speakerBoost, fallbackVoices, allowProviderFallback }) => {
+    wrapCloudHandler(config, async ({ requestId, text, provider, voice = "", speed, productionPath, productionProfile, stability, style, modelId, similarityBoost, speakerBoost, fallbackVoices, allowProviderFallback }) => {
       const context = readProductionContext(config.stateDir, productionPath);
+      const sharedSpeech = await trySharedSpeechProduction(api, config, { context, args: {
+        requestId, text, provider, voice, speed, productionPath, productionProfile, stability, style, modelId, similarityBoost, speakerBoost, fallbackVoices, allowProviderFallback,
+      } });
+      if (sharedSpeech?.result) return speechProductionResult(sharedSpeech.result);
       productionProfile = context?.productionProfile || productionProfile;
       text ??= context?.narrationScript;
-      const selection = await resolveTtsSelection(api, config, { provider, context });
+      const selection = sharedSpeech?.legacySelection || await resolveTtsSelection(api, config, { provider, context });
       provider = selection.provider;
       if (!voice && context?.voice?.provider && context.voice.provider !== provider) return textResult("보이스 공급자가 다릅니다. 선택한 provider용 voice를 다시 선정하세요.", { isError: true });
       voice ||= context?.voice?.voiceId || "";
@@ -1279,7 +1336,7 @@ export function registerCloudTools(server, config, api) {
   // ── 뮤직비디오 기획 ──────────────────────────────────────────────────────────
   server.tool(
     "plan_music_video",
-    "뮤직비디오 씬 플랜을 생성합니다. suno_music_download로 받은 곡의 가사·길이(durationSec)를 입력하세요. 결과 scenes의 imagePrompt는 generate_scene_image로 이어집니다.",
+    "뮤직비디오 씬 플랜을 생성합니다. suno_music_download로 받은 곡의 가사·길이(durationSec)를 입력하세요. 결과 scenes의 imagePrompt는 generate_scene_image로 이어집니다. 공유 모드에서는 같은 입력 재연결은 기존 작업만 조회하며 비용 영수증과 음악 구간을 보존합니다. 접수 불명 작업은 자동 재제출하지 않습니다.",
     {
       ...visualProductionFields,
       productionProfile: productionFields.productionProfile,
@@ -1304,8 +1361,9 @@ export function registerCloudTools(server, config, api) {
         return textResult("lyrics를 입력하거나 instrumental=true로 지정하세요.", { isError: true });
       }
       const visualSettings = resolveVisualSettings(null, { productionProfile, imageSourceMode, visualMotionMode });
-      const payload = await api.request("/api/tracker/music-video/plan", {
-        body: {
+      return runStudioPlan(config, api, 'music',
+        { ...visualSettings, productionProfile, durationSec, lyrics, conceptBrief, instrumental, sceneSeconds, splitMode, videoStylePreset, aspectRatio, characters },
+        () => ({
           ...visualSettings, productionProfile,
           alignedLines: [],
           aspectRatio,
@@ -1319,19 +1377,19 @@ export function registerCloudTools(server, config, api) {
           songMeta: {},
           splitMode,
           videoStylePreset,
-        },
-        method: "POST",
-        timeoutMs: 240_000,
-      });
-      // usage/원장 이벤트 등 컨텍스트 낭비 필드는 제거하고 기획 본문만 돌려준다.
-      const { accountCostEvents, providerUsage, usage, ...plan } = payload && typeof payload === "object" ? payload : {};
+        }), payload => {
+      // Keep settled public receipts for recovery; omit only raw provider detail.
+      const { providerUsage, ...plan } = payload && typeof payload === "object" ? payload : {};
       const scenes = trimPlanScenes(plan.scenes);
       const productionPath = saveProductionContext(config.stateDir, {
+        ...studioPlanningContext(payload),
         topic: conceptBrief, visualSettings, autoCompose: productionProfile?.autoComposeEnabled ?? true,
         productionProfile: plan.productionProfile || productionProfile,
+        musicPlan: { structure: plan.structure, sceneInputs: plan.sceneInputs, splitSource: plan.splitSource, inferredVibe: plan.inferredVibe },
         scenes, featureKey: "musicVideo",
       });
       return jsonResult({ ...plan, scenes, ...visualSettings, productionPath });
+      });
     }),
   );
 
@@ -1423,10 +1481,18 @@ export function registerCloudTools(server, config, api) {
   );
 
   // ── 짜집기 렌더 준비 — 컷 세트 → TTS + 타임라인 페이로드 ────────────────────
+  server.tool("continue_narrated_timeline",
+    "공유 리메이크·리뷰 나레이션을 이어갑니다. 기존 행은 조회만 하고, 완료 확인 후 아직 제출하지 않은 행을 호출당 최대 1건 유료 합성합니다. 전체 행 비용에 동의한 경우에만 사용하세요. 실패·결과 불명 행은 자동 재합성하지 않습니다. 모두 완료되면 기존 음성으로 타임라인을 조립합니다.",
+    { operationId: z.string().regex(/^[A-Za-z0-9_-]{16,80}$/u) },
+    wrapCloudHandler(config, async ({ operationId }) => {
+      const value = await continueNarratedTimeline(api, config, operationId);
+      return { ...jsonResult(value), ...(!["pending", "completed"].includes(value.status) ? { isError: true } : {}) };
+    }));
   server.tool(
     "prepare_remake_timeline",
     "짜집기(리메이크) 렌더 준비 — analyze_edit_points 의 sceneCatalog 에서 고른 컷들로 구성한 컷 세트를 서버에 보내 TTS 합성 + 렌더 타임라인을 만듭니다. 반환된 payloadPath 를 render_start 에 넘기면 이 PC 에서 원본 다운로드 + 렌더가 수행됩니다. [N]/[SN] 행의 audioContent 는 유료 TTS 로 합성되므로 실행 전 사용자 확인을 받으세요.",
     {
+      requestId: z.string().regex(/^[A-Za-z0-9_-]{16,80}$/u).optional().describe("공유 실행에서는 필수인 고정 요청 ID. 중단 후 같은 operationId로 continue_narrated_timeline을 호출하세요. 전체 행 TTS 비용에 동의한 뒤 시작하세요."),
       title: z.string().optional().describe("영상 상단 타이틀 텍스트 (없으면 생략)"),
       sourceVideos: z.array(z.object({
         id: z.string().describe("YouTube video id (11자)"),
@@ -1453,12 +1519,17 @@ export function registerCloudTools(server, config, api) {
       aspectRatio: z.enum(["9:16", "16:9", "1:1"]).optional().describe("기본 9:16"),
       subtitleCropMode: z.enum(["off", "always", "auto"]).optional().describe("원본 박힌 자막 하단 크롭 — auto 는 burnedSubtitle.present 소스만"),
     },
-    wrapCloudHandler(config, async ({ title = "", sourceVideos, rows, provider, voiceId = "", aspectRatio = "9:16", subtitleCropMode = "off" }) => {
+    wrapCloudHandler(config, async ({ requestId, title = "", sourceVideos, rows, provider, voiceId = "", aspectRatio = "9:16", subtitleCropMode = "off" }) => {
       const sourceIds = new Set(sourceVideos.map((source) => source.id));
       const badRef = rows.flatMap((row) => row.clipRefs).find((ref) => !sourceIds.has(ref.videoId));
       if (badRef) {
         return textResult(`clipRefs 의 videoId "${badRef.videoId}" 가 sourceVideos 에 없습니다.`, { isError: true });
       }
+      const version = { id: "mcp-remake", title, sourceVideos, rows: rows.map(row => ({ ...row,
+        clipRefs: row.clipRefs.map(ref => ({ ...ref, durationSec: Math.max(0.3, (ref.endMs - ref.startMs) / 1000) })) })) };
+      const shared = await trySharedNarrationTimeline(api, config, { kind: "remake", requestId, provider, voiceId,
+        body: { version, aspectRatio, subtitleCropMode } });
+      if (shared) return { ...jsonResult(shared), ...(!["pending", "completed"].includes(shared.status) ? { isError: true } : {}) };
       const hasNarration = rows.some((row) => ["N", "SN"].includes(row.mode) && row.audioContent?.trim());
       const selection = hasNarration ? await resolveTtsSelection(api, config, { provider }) : { provider: "typecast", executionTarget: "server" };
       provider = selection.provider;
@@ -1473,18 +1544,6 @@ export function registerCloudTools(server, config, api) {
         }
         preSynthesizedNarrations = { narrations, attempted: Object.keys(narrations).length, succeeded: Object.keys(narrations).length, lastError: "" };
       }
-      const version = {
-        id: "mcp-remake",
-        title,
-        sourceVideos,
-        rows: rows.map((row) => ({
-          ...row,
-          clipRefs: row.clipRefs.map((ref) => ({
-            ...ref,
-            durationSec: Math.max(0.3, (ref.endMs - ref.startMs) / 1000),
-          })),
-        })),
-      };
       const payload = await api.request("/api/tracker/remake/prepare", {
         body: {
           aspectRatio,
@@ -1519,9 +1578,10 @@ export function registerCloudTools(server, config, api) {
   // ── 시간 동기 자막 TTS — 쇼츠 하단자막용 ─────────────────────────────────────
   server.tool(
     "tts_narration_with_captions",
-    "TTS 오디오와 자막을 만듭니다. 순서 Typecast→ElevenLabs→Supertone→Edge→Supertonic2. 명시 목소리는 fallbackVoices 없이 변경하지 않습니다. ElevenLabs 선택 시 실제 char-level 타이밍을 유지하며 해당 정밀 기능은 대체하지 않습니다. 나머지는 실측 오디오 길이 기반 추정 자막이며 추가 STT 과금은 없습니다.",
+    "TTS 오디오와 자막. 순서 Typecast→ElevenLabs→Supertone→Edge→Supertonic2. 공유 모드에서는 ID를 반환하며 finish_speech_generation으로 PC 파일·제작 핸들을 완성합니다. 제작 핸들 없으면 requestId 필수, 공유 공급자 폴백 없음. ElevenLabs는 실제 문자 타이밍, 나머지는 오디오 길이 기반 추정 자막이며 추가 STT 과금은 없습니다.",
     {
       ...productionFields,
+      requestId: z.string().regex(/^[a-zA-Z0-9_-]{16,80}$/u).optional().describe("공유 모드의 고정 요청 ID. 제작 핸들이 없으면 필수. 같은 ID로 조회하며 새 유료 요청을 만들지 마세요."),
       text: z.string().optional().describe("생략 시 제작 핸들의 기획 대본 그대로 합성. 사실·인용을 바꾸거나 뉴스체로 재작성하지 마세요."),
       ...ttsFallbackFields,
       provider: z.enum(["auto", ...TTS_PROVIDERS]).optional().describe("기본 자동 선택 또는 제작 핸들에 선정된 공급자"),
@@ -1530,11 +1590,15 @@ export function registerCloudTools(server, config, api) {
       modelId: z.string().optional(), stability: z.number().min(0).max(1).optional(),
       style: z.number().min(0).max(1).optional(), similarityBoost: z.number().min(0).max(1).optional(), speakerBoost: z.boolean().optional(),
     },
-    wrapCloudHandler(config, async ({ text, provider, voice = "", speed, productionPath, productionProfile, modelId, stability, style, similarityBoost, speakerBoost, fallbackVoices, allowProviderFallback }) => {
+    wrapCloudHandler(config, async ({ requestId, text, provider, voice = "", speed, productionPath, productionProfile, modelId, stability, style, similarityBoost, speakerBoost, fallbackVoices, allowProviderFallback }) => {
       const context = readProductionContext(config.stateDir, productionPath);
+      const sharedSpeech = await trySharedSpeechProduction(api, config, { context, withCaptions: true, args: {
+        requestId, text, provider, voice, speed, productionPath, productionProfile, modelId, stability, style, similarityBoost, speakerBoost, fallbackVoices, allowProviderFallback,
+      } });
+      if (sharedSpeech?.result) return speechProductionResult(sharedSpeech.result);
       productionProfile = context?.productionProfile || productionProfile;
       text ??= context?.narrationScript;
-      const selection = await resolveTtsSelection(api, config, { provider, context });
+      const selection = sharedSpeech?.legacySelection || await resolveTtsSelection(api, config, { provider, context });
       provider = selection.provider;
       if (!voice && context?.voice?.provider && context.voice.provider !== provider) {
         return textResult("보이스 공급자가 다릅니다. 선택한 provider용 voice를 다시 선정하세요.", { isError: true });
@@ -1648,18 +1712,24 @@ export function registerCloudTools(server, config, api) {
       sampleVideoUrl: z.string().optional().describe("사용자가 샘플로 지정한 유튜브 URL 또는 11자 영상 ID"),
       provider: z.enum(["auto", ...TTS_PROVIDERS]).optional().describe("기본 자동: Typecast→ElevenLabs→Supertone→Edge→Supertonic2. 키가 없으면 다음 후보, 합성 실패 후 자동 재과금 없음"),
       sampleVoiceHints: z.string().optional().describe("사용자가 말한 보이스 요구 (예: 차분한 중년 남성)"),
+      requestId: z.string().uuid().optional().describe("새 추천을 명시적으로 요청할 때만 새 UUID를 지정합니다. 복구·재연결에는 같은 값을 유지하며 자동 변경하지 않습니다."),
     },
-    wrapCloudHandler(config, async ({ topic = "", scriptExcerpt = "", sampleVideoUrl = "", provider, sampleVoiceHints = "", productionPath, productionProfile }) => {
+    wrapCloudHandler(config, async ({ topic = "", scriptExcerpt = "", sampleVideoUrl = "", provider, sampleVoiceHints = "", productionPath, productionProfile, requestId }) => {
+      const requestedProvider = provider || 'auto';
       const context = readProductionContext(config.stateDir, productionPath);
       productionProfile = context?.productionProfile || productionProfile;
       const selection = await resolveTtsSelection(api, config, { provider, context });
       provider = selection.provider;
       topic ||= context?.topic || "";
       scriptExcerpt ||= context?.narrationScript?.slice(0, 2000) || "";
+      const casting = createVoiceRecommendationClient(config, api, { requestedProvider, topic, scriptExcerpt, sampleVideoUrl: canonicalYoutubeWatchUrl(sampleVideoUrl) || sampleVideoUrl, sampleVoiceHints, productionProfile, requestId });
+      const recovered = await casting.recover();
+      const castingMode = recovered ? 'queue-v2' : await casting.readCapability();
+      if (!['queue-v2', 'legacy-sync'].includes(castingMode)) throw Error('현재 서버에서 보이스 추천의 안전한 공유 실행을 사용할 수 없습니다.');
       const notes = [];
       let sampleAudioBase64 = "";
       const rawSample = String(sampleVideoUrl || "").trim();
-      if (rawSample) {
+      if (rawSample && !recovered) {
         // 모바일/뮤직/shorts/youtu.be 변형을 표준 watch URL 로 정규화 — 컴패니언의
         // 유튜브 전용 처리(봇 우회)가 표준 형태에서만 발동한다.
         const watchUrl = canonicalYoutubeWatchUrl(rawSample);
@@ -1676,18 +1746,27 @@ export function registerCloudTools(server, config, api) {
           );
         }
       }
-      if (!topic && !scriptExcerpt && !sampleVoiceHints && !sampleAudioBase64) {
+      if (!recovered && !topic && !scriptExcerpt && !sampleVoiceHints && !sampleAudioBase64) {
         // 샘플만 줬는데 추출이 실패한 경우: 누락 안내가 아니라 실패 사유를 그대로 전달한다.
         if (notes.length) {
           return textResult(`${notes.join("\n")}\n주제(topic)를 함께 주면 샘플 없이도 추천할 수 있습니다.`, { isError: true });
         }
         return textResult("topic, scriptExcerpt, sampleVoiceHints, sampleVideoUrl 중 하나는 필요합니다.", { isError: true });
       }
-      const payload = await api.request("/api/tracker/tts/recommend-voice", {
-        body: { provider, sampleAudioBase64, sampleVoiceHints, scriptExcerpt, topic, productionProfile, ...(selection.localVoices ? { localVoiceCatalog: selection.localVoices } : {}) },
-        method: "POST",
-        timeoutMs: 180_000,
-      });
+      let generated = recovered;
+      let payload;
+      if (!generated && castingMode === 'legacy-sync') payload = await casting.legacy({ provider, sampleAudioBase64, sampleVoiceHints, scriptExcerpt, topic, productionProfile,
+        ...(selection.localVoices ? { localVoiceCatalog: selection.localVoices } : {}) });
+      else {
+        if (!generated) {
+          const voices = selection.localVoices || (await api.request(`/api/tracker/tts/${provider}/voices`, { method: 'GET', timeoutMs: 30000 })).voices;
+          const voiceCatalog = compactVoiceCatalog(voices, provider);
+          generated = await casting.run({ ttsProvider: provider, voiceCatalog, sampleAudioBase64, sampleVoiceHints, scriptExcerpt, topic,
+            ...(productionProfile ? { productionProfile } : {}) });
+        }
+        if (generated.voiceRecommendation?.ttsProvider !== provider) throw Error('VOICE_RECOMMENDATION_PROVIDER_MISMATCH');
+        payload = { ...generated.voiceRecommendation, provider, ok: true };
+      }
       if (payload?.ok === false) {
         return textResult(
           `보이스 추천 실패: ${payload?.error || "알 수 없는 오류"}\n${payload?.guidance || ""}`.trim(),
@@ -1701,8 +1780,9 @@ export function registerCloudTools(server, config, api) {
         notes: [...notes, ...(Array.isArray(payload?.notes) ? payload.notes : [])],
         provider: payload?.provider || provider,
         recommendations: Array.isArray(payload?.recommendations) ? payload.recommendations : [],
-        sampleAnalyzed: Boolean(sampleAudioBase64 && payload?.sampleVoiceProfile),
+        sampleAnalyzed: Boolean(payload?.sampleVoiceProfile),
         sampleVoiceProfile: payload?.sampleVoiceProfile || null,
+        ...(generated ? { backgroundJobId: generated.backgroundJobId, usage: generated.usage, accountCostEvents: generated.accountCostEvents, recovered: Boolean(recovered), paidReplayAllowed: false } : {}),
       });
     }),
   );

package/lib/config.mjs

@@ -2,7 +2,7 @@ import { homedir } from "node:os";
 import path from "node:path";
 
 // 프록시 버전 — 서버가 X-AImakeAll-MCP-Version 으로 하한을 강제(426)할 수 있다.
-export const MCP_PROXY_VERSION = "0.14.4";
+export const MCP_PROXY_VERSION = "0.14.5";
 
 export const DEFAULT_API_BASE = "https://aimakeall.com";
 export const DEFAULT_COMPANION_URL = "http://127.0.0.1:9876";

package/lib/durable-channel-contract.mjs

@@ -1,11 +1,16 @@
 // Closed browser/worker channel-analysis contract. Never accepts a provider,
 // credential, arbitrary prompt, callback or model from the requester.
+import { VOICE_INPUT_FIELDS, validateVoiceRecommendationInput, validateVoiceRecommendationOutput } from './durable-voice-contract.mjs';
 export const DURABLE_CHANNEL_CONTRACT_VERSION = 1;
-export const DURABLE_CHANNEL_PATHS = Object.freeze({ 'channel-style': '/api/tracker/gemini/channel-style', 'channel-fingerprint': '/api/tracker/gemini/channel-fingerprint' });
+export const DURABLE_CHANNEL_PATHS = Object.freeze({ 'channel-style': '/api/tracker/gemini/channel-style', 'channel-fingerprint': '/api/tracker/gemini/channel-fingerprint', 'voice-recommend': '/api/tracker/tts/recommend-voice' });
 export const DURABLE_CHANNEL_TYPES = Object.freeze(Object.fromEntries(Object.keys(DURABLE_CHANNEL_PATHS).map(key => [key, `durable-channel:${key}`])));
-export const DURABLE_CHANNEL_MODEL = Object.freeze({ 'channel-style': 'gemini-2.5-flash-lite', 'channel-fingerprint': 'gemini-3-flash' });
+export const DURABLE_CHANNEL_MODEL = Object.freeze({ 'channel-style': 'gemini-2.5-flash-lite', 'channel-fingerprint': 'gemini-3-flash', 'voice-recommend': 'gemini-3-flash' });
+// Old channel clients compare this map exactly. Adding casting must not break
+// an already-installed client's channel capability handshake.
+export const durableChannelCapabilityModels = operation => operation === 'voice-recommend' ? DURABLE_CHANNEL_MODEL
+  : Object.freeze(Object.fromEntries(Object.entries(DURABLE_CHANNEL_MODEL).filter(([key]) => key !== 'voice-recommend')));
 export const DURABLE_CHANNEL_LIMITS = Object.freeze({ maxInputBytes: 16 * 1024 * 1024, maxOutputBytes: 1024 * 1024, maxProjectId: 160, maxTargetId: 240, maxStages: 24, maxVideos: 12, maxFrames: 8 });
-export const DURABLE_CHANNEL_OUTPUT_FIELDS = Object.freeze(['operation', 'projectId', 'targetId', 'profile', 'analysis', 'fingerprint']);
+export const DURABLE_CHANNEL_OUTPUT_FIELDS = Object.freeze(['operation', 'projectId', 'targetId', 'profile', 'analysis', 'fingerprint', 'voiceRecommendation']);
 const encoder = new TextEncoder();
 function fail(output = false) { const code = `DURABLE_CHANNEL_${output ? 'OUTPUT' : 'INPUT'}_INVALID`; throw Object.assign(new Error(code), { code, statusCode: output ? 502 : 400 }); }
 function record(value) { if (!value || ![Object.prototype, null].includes(Object.getPrototypeOf(value))) fail();
@@ -30,8 +35,9 @@ function analysis(value) { if (!value || typeof value !== 'object' || Array.isAr
   for (const key of ['topKeywords', 'highlights', 'videos']) if (value[key] !== undefined && !Array.isArray(value[key])) fail();
   if (value.topKeywords?.some(v => typeof v !== 'string') || value.highlights?.some(v => !v || typeof v !== 'object') || value.videos?.some(v => !v || typeof v !== 'object')) fail(); }
 export function captureDurableChannelInput(value) { const raw = record(value); identity(raw);
-  const body = capture(raw, ['operation', 'projectId', 'targetId', ...(raw.operation === 'channel-style' ? ['analysis'] : ['videos', 'measuredAt'])], DURABLE_CHANNEL_LIMITS.maxInputBytes);
-  if (body.operation === 'channel-style') { analysis(body.analysis); if (encoder.encode(JSON.stringify(body.analysis)).byteLength > 750000) fail(); }
+  const body = capture(raw, ['operation', 'projectId', 'targetId', ...(raw.operation === 'voice-recommend' ? VOICE_INPUT_FIELDS : raw.operation === 'channel-style' ? ['analysis'] : ['videos', 'measuredAt'])], DURABLE_CHANNEL_LIMITS.maxInputBytes);
+  if (body.operation === 'voice-recommend') { try { validateVoiceRecommendationInput(body); } catch { fail(); } }
+  else if (body.operation === 'channel-style') { analysis(body.analysis); if (encoder.encode(JSON.stringify(body.analysis)).byteLength > 750000) fail(); }
   else { if (!Array.isArray(body.videos) || !body.videos.length || body.videos.length > 12 || typeof body.measuredAt !== 'string' || !Number.isFinite(Date.parse(body.measuredAt)) || new Date(body.measuredAt).toISOString() !== body.measuredAt) fail();
     for (const v of body.videos) { if (!v || Array.isArray(v) || Object.keys(v).some(k => !VIDEO_FIELDS.includes(k))) fail();
       for (const k of NUMBERS) if (v[k] !== undefined && v[k] !== null && (typeof v[k] !== 'number' || Math.abs(v[k]) > 1e9)) fail();
@@ -43,7 +49,11 @@ export function captureDurableChannelInput(value) { const raw = record(value); i
     }
   } return Object.freeze({ body, jobType: DURABLE_CHANNEL_TYPES[body.operation] }); }
 export function captureDurableChannelOutput(value) { try { const raw = capture(value, DURABLE_CHANNEL_OUTPUT_FIELDS, DURABLE_CHANNEL_LIMITS.maxOutputBytes); identity(raw);
-  if (raw.operation === 'channel-style') { analysis(raw.analysis); if (!raw.profile || Array.isArray(raw.profile) || raw.fingerprint !== undefined) fail(true);
+  if (raw.operation === 'voice-recommend') {
+    if (Object.keys(raw).some(k => !['operation', 'projectId', 'targetId', 'voiceRecommendation'].includes(k))) fail(true);
+    validateVoiceRecommendationOutput(raw.voiceRecommendation);
+  } else if (raw.voiceRecommendation !== undefined) fail(true);
+  else if (raw.operation === 'channel-style') { analysis(raw.analysis); if (!raw.profile || Array.isArray(raw.profile) || raw.fingerprint !== undefined) fail(true);
     const strings = ['channelTitle', 'introPattern', 'outroPattern', 'pacing', 'recommendedFormat', 'recommendedStyleId', 'structurePattern', 'summary', 'toneGuide', 'toneLabel'];
     if (Object.keys(raw.profile).length !== strings.length + 2 || strings.some(k => typeof raw.profile[k] !== 'string') || !raw.profile.summary.trim()) fail(true);
     for (const [k, max] of [['referenceKeywords', 6], ['scriptDirectives', 5]]) if (!Array.isArray(raw.profile[k]) || raw.profile[k].length > max || raw.profile[k].some(v => typeof v !== 'string')) fail(true);