videobook 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (565) hide show
  1. package/CHANGELOG.md +54 -0
  2. package/LICENSE +21 -0
  3. package/README.md +195 -2
  4. package/bin/videobook.js +7 -0
  5. package/dist/acestep/client.js +203 -0
  6. package/dist/acestep/config.js +62 -0
  7. package/dist/acestep/errors.js +8 -0
  8. package/dist/acestep/process.js +175 -0
  9. package/dist/alive-captions/analyze.js +117 -0
  10. package/dist/alive-captions/audio.js +179 -0
  11. package/dist/alive-captions/frames.js +59 -0
  12. package/dist/alive-captions/model.js +37 -0
  13. package/dist/alive-captions/schema.js +49 -0
  14. package/dist/alive-captions/track.js +9 -0
  15. package/dist/api-key.js +33 -0
  16. package/dist/app-state.js +56 -0
  17. package/dist/app.js +257 -0
  18. package/dist/archive-b2.js +332 -0
  19. package/dist/archive-store.js +169 -0
  20. package/dist/artifact-label.js +36 -0
  21. package/dist/artifact-refs.js +49 -0
  22. package/dist/asset-tag-extraction.js +169 -0
  23. package/dist/asset-tags.js +228 -0
  24. package/dist/asset-usage.js +23 -0
  25. package/dist/audio-cue.js +71 -0
  26. package/dist/audio-encoding.js +32 -0
  27. package/dist/audio-sync-request.js +1 -0
  28. package/dist/audio-sync.js +223 -0
  29. package/dist/audio-trim-range.js +31 -0
  30. package/dist/book-context.js +31 -0
  31. package/dist/book-manager.js +374 -0
  32. package/dist/catalog-gc.js +26 -0
  33. package/dist/chain-executor.js +815 -0
  34. package/dist/chain-generation.js +115 -0
  35. package/dist/chain-plan.js +746 -0
  36. package/dist/chain-step-review.js +60 -0
  37. package/dist/character-name.js +25 -0
  38. package/dist/chat-generation-routing.js +73 -0
  39. package/dist/chat-generation-settings.js +78 -0
  40. package/dist/chat-models.js +44 -0
  41. package/dist/chat-prompt-rewrite.js +67 -0
  42. package/dist/chat-router.js +628 -0
  43. package/dist/chat-view-actions.js +49 -0
  44. package/dist/cli/args.js +242 -0
  45. package/dist/cli/config-command.js +103 -0
  46. package/dist/cli/doctor-command.js +289 -0
  47. package/dist/cli/entry.js +2 -0
  48. package/dist/cli/key-report.js +16 -0
  49. package/dist/cli/main.js +104 -0
  50. package/dist/cli/mcp-command.js +88 -0
  51. package/dist/cli/mcp-relay.js +51 -0
  52. package/dist/cli/open-browser.js +14 -0
  53. package/dist/cli/run-command.js +231 -0
  54. package/dist/cli/serve-command.js +62 -0
  55. package/dist/cli/setup-command.js +60 -0
  56. package/dist/cli/stdio-guard.js +8 -0
  57. package/dist/cold-open-model.js +7 -0
  58. package/dist/cold-open.js +79 -0
  59. package/dist/command-reference.js +95 -0
  60. package/dist/content-store.js +74 -0
  61. package/dist/cost.js +8 -0
  62. package/dist/crop-geometry.js +23 -0
  63. package/dist/dancing-workflow.js +447 -0
  64. package/dist/data-home.js +44 -0
  65. package/dist/diagnostics.js +109 -0
  66. package/dist/dialog-quality.js +34 -0
  67. package/dist/downloads-dest.js +56 -0
  68. package/dist/editing-moments.js +194 -0
  69. package/dist/elevenlabs-audio-extension.js +66 -0
  70. package/dist/engine.js +54 -0
  71. package/dist/env-file.js +91 -0
  72. package/dist/env-secrets.js +148 -0
  73. package/dist/ffmpeg-binary.js +12 -0
  74. package/dist/ffmpeg.js +425 -0
  75. package/dist/ffprobe-binary.js +77 -0
  76. package/dist/forget-asset.js +216 -0
  77. package/dist/frame-utils.js +27 -0
  78. package/dist/generation-credit-error.js +11 -0
  79. package/dist/generation-input-mentions.js +117 -0
  80. package/dist/generation-input-policy.js +68 -0
  81. package/dist/generation-reference-mentions.js +97 -0
  82. package/dist/goal-characters.js +49 -0
  83. package/dist/goal-plan-v3.js +273 -0
  84. package/dist/goal-plan.js +220 -0
  85. package/dist/goal-planner-prompt.js +28 -0
  86. package/dist/goal-prompt-budget.js +4 -0
  87. package/dist/goal-reference-images.js +25 -0
  88. package/dist/goal-state.js +261 -0
  89. package/dist/goal-stills.js +153 -0
  90. package/dist/goal-store.js +144 -0
  91. package/dist/goal-styles.js +144 -0
  92. package/dist/goal-v3-runtime.js +157 -0
  93. package/dist/guides/character_schema_guide.md +70 -0
  94. package/dist/guides/gpt_image_2_5_prompting_guide.md +21 -0
  95. package/dist/guides/grok_imagine_prompting_guide.md +72 -0
  96. package/dist/guides/image_reproduction_guide.md +84 -0
  97. package/dist/guides/kling_3_0_prompting_guide.md +136 -0
  98. package/dist/guides/nano_banana_pro_prompting_guide.md +28 -0
  99. package/dist/guides/seedance_2_prompting_guide.md +172 -0
  100. package/dist/http-access.js +49 -0
  101. package/dist/http-byte-range.js +31 -0
  102. package/dist/hydration.js +56 -0
  103. package/dist/image-compress.js +77 -0
  104. package/dist/image-edit-default.js +1 -0
  105. package/dist/image-edit-models.js +41 -0
  106. package/dist/image-edit-settings.js +11 -0
  107. package/dist/image-region-edit.js +32 -0
  108. package/dist/image-subject-map.js +523 -0
  109. package/dist/image.js +46 -0
  110. package/dist/index.js +12 -0
  111. package/dist/job-deadline.js +60 -0
  112. package/dist/jobs/_alibaba-upload.js +30 -0
  113. package/dist/jobs/_audio-chunks.js +31 -0
  114. package/dist/jobs/_download-into-asset.js +15 -0
  115. package/dist/jobs/_fal-shared.js +22 -0
  116. package/dist/jobs/_fal-upload.js +35 -0
  117. package/dist/jobs/_image-edit-adapter.js +213 -0
  118. package/dist/jobs/_kie-poll.js +119 -0
  119. package/dist/jobs/_kie-upload.js +32 -0
  120. package/dist/jobs/_lease.js +163 -0
  121. package/dist/jobs/_persist-output.js +19 -0
  122. package/dist/jobs/_storage-retry.js +21 -0
  123. package/dist/jobs/_transcribe.js +245 -0
  124. package/dist/jobs/_translate-transcript.js +270 -0
  125. package/dist/jobs/analyze-alive-captions.js +10 -0
  126. package/dist/jobs/analyze-editing-moments.js +104 -0
  127. package/dist/jobs/analyze-jokes.js +143 -0
  128. package/dist/jobs/analyze-keyword-placement.js +155 -0
  129. package/dist/jobs/analyze-music.js +14 -0
  130. package/dist/jobs/analyze-video.js +282 -0
  131. package/dist/jobs/apply-cuts.js +83 -0
  132. package/dist/jobs/apply-sfx.js +107 -0
  133. package/dist/jobs/archive-clip.js +458 -0
  134. package/dist/jobs/assemble-goal.js +98 -0
  135. package/dist/jobs/audio-boost.js +71 -0
  136. package/dist/jobs/audio-mix.js +161 -0
  137. package/dist/jobs/backfill-asset-tags.js +144 -0
  138. package/dist/jobs/burn-watermark.js +316 -0
  139. package/dist/jobs/change-video-speed.js +176 -0
  140. package/dist/jobs/clean-video-audio.js +207 -0
  141. package/dist/jobs/cold-open.js +166 -0
  142. package/dist/jobs/combine-goal.js +108 -0
  143. package/dist/jobs/complete-provider-task.js +185 -0
  144. package/dist/jobs/copy-library-asset.js +33 -0
  145. package/dist/jobs/cost-estimate-assessment.js +113 -0
  146. package/dist/jobs/crop-image.js +47 -0
  147. package/dist/jobs/crop-video.js +71 -0
  148. package/dist/jobs/describe-image.js +181 -0
  149. package/dist/jobs/detect-scenes.js +33 -0
  150. package/dist/jobs/doctor-fix.js +100 -0
  151. package/dist/jobs/download-video.js +427 -0
  152. package/dist/jobs/enqueue-search-index.js +24 -0
  153. package/dist/jobs/even-split.js +122 -0
  154. package/dist/jobs/export-sequence.js +365 -0
  155. package/dist/jobs/extend-audio.js +229 -0
  156. package/dist/jobs/extract-audio.js +72 -0
  157. package/dist/jobs/extract-frame.js +58 -0
  158. package/dist/jobs/extract-notebook-audio.js +82 -0
  159. package/dist/jobs/extract-notebook-frame.js +93 -0
  160. package/dist/jobs/extract-video-clip.js +8 -0
  161. package/dist/jobs/extract-video-poster.js +55 -0
  162. package/dist/jobs/extract-waveform.js +25 -0
  163. package/dist/jobs/finish-goal.js +255 -0
  164. package/dist/jobs/forget-asset.js +11 -0
  165. package/dist/jobs/generate-acestep-cover.js +219 -0
  166. package/dist/jobs/generate-media.js +70 -0
  167. package/dist/jobs/image-subjects.js +1059 -0
  168. package/dist/jobs/index.js +18 -0
  169. package/dist/jobs/inject-first-frame.js +175 -0
  170. package/dist/jobs/isolate-vocals.js +69 -0
  171. package/dist/jobs/kie-paygate.js +177 -0
  172. package/dist/jobs/label-music-sections.js +5 -0
  173. package/dist/jobs/osg-placement.js +135 -0
  174. package/dist/jobs/pad-video.js +72 -0
  175. package/dist/jobs/plan-goal.js +97 -0
  176. package/dist/jobs/post-record.js +21 -0
  177. package/dist/jobs/post-to-x.js +21 -0
  178. package/dist/jobs/prepare-search-reference.js +190 -0
  179. package/dist/jobs/prepare-temporal-search.js +16 -0
  180. package/dist/jobs/process-audio.js +67 -0
  181. package/dist/jobs/process-image.js +58 -0
  182. package/dist/jobs/process-upload.js +166 -0
  183. package/dist/jobs/process-video.js +438 -0
  184. package/dist/jobs/register-all.js +161 -0
  185. package/dist/jobs/relayout-notebook.js +78 -0
  186. package/dist/jobs/remove-sound.js +299 -0
  187. package/dist/jobs/render-project.js +380 -0
  188. package/dist/jobs/render-qr-outro.js +138 -0
  189. package/dist/jobs/render-timeline.js +283 -0
  190. package/dist/jobs/repair-search-indexes.js +42 -0
  191. package/dist/jobs/replace-video-audio.js +64 -0
  192. package/dist/jobs/restore-archive-clip.js +53 -0
  193. package/dist/jobs/reverse-video.js +53 -0
  194. package/dist/jobs/rewrite-script.js +173 -0
  195. package/dist/jobs/run-notebook.js +3335 -0
  196. package/dist/jobs/semantic-index.js +797 -0
  197. package/dist/jobs/smooth-scene-concat.js +257 -0
  198. package/dist/jobs/splice-video.js +280 -0
  199. package/dist/jobs/split-video.js +127 -0
  200. package/dist/jobs/suggest-cuts.js +149 -0
  201. package/dist/jobs/suggest-sfx.js +135 -0
  202. package/dist/jobs/sync-video-to-audio.js +329 -0
  203. package/dist/jobs/tag-asset.js +266 -0
  204. package/dist/jobs/task-failure.js +16 -0
  205. package/dist/jobs/timewarp-video.js +152 -0
  206. package/dist/jobs/transcribe-video-audio.js +117 -0
  207. package/dist/jobs/transcribe.js +35 -0
  208. package/dist/jobs/translate-transcript.js +55 -0
  209. package/dist/jobs/trim-audio.js +133 -0
  210. package/dist/jobs/trim-video.js +291 -0
  211. package/dist/jobs/xai-paygate.js +26 -0
  212. package/dist/keyword-placement-cache.js +74 -0
  213. package/dist/lazy-render.js +142 -0
  214. package/dist/library-browse.js +78 -0
  215. package/dist/lightning-defaults.js +206 -0
  216. package/dist/load-env.js +12 -0
  217. package/dist/local-search-models.js +206 -0
  218. package/dist/local-upload.js +318 -0
  219. package/dist/logger.js +69 -0
  220. package/dist/media/adapters/alibaba.js +20 -0
  221. package/dist/media/adapters/elevenlabs.js +58 -0
  222. package/dist/media/adapters/fal.js +45 -0
  223. package/dist/media/adapters/index.js +26 -0
  224. package/dist/media/adapters/kie.js +120 -0
  225. package/dist/media/adapters/pending.js +21 -0
  226. package/dist/media/adapters/types.js +5 -0
  227. package/dist/media/adapters/xai.js +18 -0
  228. package/dist/media/catalog.js +236 -0
  229. package/dist/media/complete.js +191 -0
  230. package/dist/media/cost.js +45 -0
  231. package/dist/media/descriptor.js +157 -0
  232. package/dist/media/endpoints.js +11 -0
  233. package/dist/media/frame-options.js +18 -0
  234. package/dist/media/insert-video-timing.js +17 -0
  235. package/dist/media/json-schema.js +75 -0
  236. package/dist/media/legacy-task-types.js +129 -0
  237. package/dist/media/listing.js +24 -0
  238. package/dist/media/model-id.js +14 -0
  239. package/dist/media/preview.js +86 -0
  240. package/dist/media/prompt-dialects.js +65 -0
  241. package/dist/media/ref-fields.js +106 -0
  242. package/dist/media/refs.js +131 -0
  243. package/dist/media/request.js +188 -0
  244. package/dist/media/types.js +6 -0
  245. package/dist/media/wire.js +161 -0
  246. package/dist/media-library.js +535 -0
  247. package/dist/media-output-path.js +33 -0
  248. package/dist/multyculty-workflow.js +757 -0
  249. package/dist/notebook-action-catalog.js +608 -0
  250. package/dist/notebook-cell-outputs.js +726 -0
  251. package/dist/notebook-credit-retry.js +45 -0
  252. package/dist/notebook-fixtures.js +8 -0
  253. package/dist/notebook-generation-contract.js +77 -0
  254. package/dist/notebook-generation-controls.js +145 -0
  255. package/dist/notebook-goal-layout.js +40 -0
  256. package/dist/notebook-graph.js +37 -0
  257. package/dist/notebook-image-edit.js +84 -0
  258. package/dist/notebook-initial-generation-prompt.js +222 -0
  259. package/dist/notebook-live-analysis.js +941 -0
  260. package/dist/notebook-media-ops.js +579 -0
  261. package/dist/notebook-mutations.js +20 -0
  262. package/dist/notebook-placement.js +41 -0
  263. package/dist/notebook-provider-failure.js +87 -0
  264. package/dist/notebook-published-post.js +26 -0
  265. package/dist/notebook-reference-resolver.js +227 -0
  266. package/dist/notebook-relayout.js +270 -0
  267. package/dist/notebook-run-plan.js +519 -0
  268. package/dist/notebook-shots.js +162 -0
  269. package/dist/notebook-workflow.js +856 -0
  270. package/dist/one-password.js +200 -0
  271. package/dist/openai-intelligence.js +99 -0
  272. package/dist/original-media-file.js +12 -0
  273. package/dist/osg-assets.js +36 -0
  274. package/dist/osg-placement-cache.js +64 -0
  275. package/dist/osg-settings.js +27 -0
  276. package/dist/paid-tools.js +22 -0
  277. package/dist/platform-guidance.js +26 -0
  278. package/dist/posts/dropbox-auth.js +91 -0
  279. package/dist/posts/dropbox-upload.js +132 -0
  280. package/dist/posts/icloud-drive.js +134 -0
  281. package/dist/posts/icloud-status.js +64 -0
  282. package/dist/posts/post-contract.js +2 -0
  283. package/dist/posts/post-copy-format.js +43 -0
  284. package/dist/posts/post-copy.js +193 -0
  285. package/dist/posts/post-folder.js +18 -0
  286. package/dist/posts/post-metrics.js +119 -0
  287. package/dist/posts/post-store.js +340 -0
  288. package/dist/posts/x-post-target.js +43 -0
  289. package/dist/preview-payload.js +90 -0
  290. package/dist/prompt-surfaces.js +22 -0
  291. package/dist/provider-prompt-transform.js +77 -0
  292. package/dist/provider-status-link.js +21 -0
  293. package/dist/provider-task-record.js +78 -0
  294. package/dist/provider-task-status.js +47 -0
  295. package/dist/provider-usage.js +294 -0
  296. package/dist/queue.js +810 -0
  297. package/dist/reference-video-duration.js +17 -0
  298. package/dist/remotion/BlurFillVideo.js +51 -0
  299. package/dist/remotion/KeywordGraphicsOverlay.js +68 -0
  300. package/dist/remotion/OsgOverlay.js +30 -0
  301. package/dist/remotion/QrOutroComposition.js +47 -0
  302. package/dist/remotion/RenderComposition.js +11 -0
  303. package/dist/remotion/browser.js +59 -0
  304. package/dist/remotion/constants.js +35 -0
  305. package/dist/remotion/index.js +66 -0
  306. package/dist/remotion/keyword-graphics.js +151 -0
  307. package/dist/remotion/keyword-placement.js +182 -0
  308. package/dist/remotion/osg-spec.js +198 -0
  309. package/dist/remotion/public/qr-outro-impact.wav +0 -0
  310. package/dist/remotion/qr-outro-audio.js +1 -0
  311. package/dist/remotion/qr-outro-spec.js +211 -0
  312. package/dist/remotion/shared-bundle.js +37 -0
  313. package/dist/remotion/subtitles/AliveCaptions.js +83 -0
  314. package/dist/remotion/subtitles/Highlight.js +58 -0
  315. package/dist/remotion/subtitles/Impact.js +67 -0
  316. package/dist/remotion/subtitles/SubtitleOverlay.js +9 -0
  317. package/dist/remotion/subtitles/alive-layout.js +321 -0
  318. package/dist/remotion/subtitles/alive-types.js +17 -0
  319. package/dist/remotion/subtitles/chunker.js +68 -0
  320. package/dist/remotion/subtitles/segments.js +42 -0
  321. package/dist/remotion/subtitles/styles.js +4 -0
  322. package/dist/remotion/subtitles/types.js +1 -0
  323. package/dist/remotion/util.js +18 -0
  324. package/dist/remotion-cancellation.js +15 -0
  325. package/dist/rename-helpers.js +204 -0
  326. package/dist/rhythm/analyze.js +128 -0
  327. package/dist/rhythm/contract.js +14 -0
  328. package/dist/rhythm/draft-model.js +19 -0
  329. package/dist/rhythm/energy.js +133 -0
  330. package/dist/rhythm/fft.js +44 -0
  331. package/dist/rhythm/model.js +71 -0
  332. package/dist/rhythm/music-analysis.js +124 -0
  333. package/dist/rhythm/music-draft.js +261 -0
  334. package/dist/rhythm/onset.js +101 -0
  335. package/dist/rhythm/run-worker.js +51 -0
  336. package/dist/rhythm/score.js +47 -0
  337. package/dist/rhythm/section-labels.js +168 -0
  338. package/dist/rhythm/sequence-rhythm.js +67 -0
  339. package/dist/rhythm/synthesize.js +103 -0
  340. package/dist/rhythm/timing.js +98 -0
  341. package/dist/rhythm/track.js +320 -0
  342. package/dist/rhythm/visual-fit.js +4 -0
  343. package/dist/rhythm/worker.js +25 -0
  344. package/dist/scene-detect.js +200 -0
  345. package/dist/scene-transition.js +12 -0
  346. package/dist/scheduled-posts.js +200 -0
  347. package/dist/search-index-coverage.js +13 -0
  348. package/dist/search-index-media.js +71 -0
  349. package/dist/search-reference-store.js +60 -0
  350. package/dist/search-scoring.js +17 -0
  351. package/dist/serve.js +125 -0
  352. package/dist/server-lock.js +143 -0
  353. package/dist/server.js +42 -0
  354. package/dist/srt.js +16 -0
  355. package/dist/tag-backfill-state.js +121 -0
  356. package/dist/tag-settings.js +30 -0
  357. package/dist/tag-vocabulary.js +237 -0
  358. package/dist/test-queue-cleanup.js +1 -0
  359. package/dist/time-parse.js +50 -0
  360. package/dist/timeline-helpers.js +554 -0
  361. package/dist/timewarp.js +87 -0
  362. package/dist/tools/_image-inputs.js +9 -0
  363. package/dist/tools/_media-refs.js +84 -0
  364. package/dist/tools/_shared.js +59 -0
  365. package/dist/tools/_suggest-shared.js +279 -0
  366. package/dist/tools/add-timeline-audio.js +73 -0
  367. package/dist/tools/alive-captions.js +157 -0
  368. package/dist/tools/analyze-jokes.js +56 -0
  369. package/dist/tools/analyze-video.js +66 -0
  370. package/dist/tools/animate-keywords.js +217 -0
  371. package/dist/tools/api-status.js +42 -0
  372. package/dist/tools/application-commands.js +34 -0
  373. package/dist/tools/apply-cuts.js +112 -0
  374. package/dist/tools/apply-sfx.js +152 -0
  375. package/dist/tools/apply-watermark.js +670 -0
  376. package/dist/tools/archive-clip.js +74 -0
  377. package/dist/tools/asset-history.js +61 -0
  378. package/dist/tools/asset-manifest.js +24 -0
  379. package/dist/tools/asset-tags.js +151 -0
  380. package/dist/tools/assign-slot.js +97 -0
  381. package/dist/tools/audio-boost.js +107 -0
  382. package/dist/tools/audio-mix.js +121 -0
  383. package/dist/tools/book-usage.js +16 -0
  384. package/dist/tools/chain.js +136 -0
  385. package/dist/tools/change-video-speed.js +105 -0
  386. package/dist/tools/chat-history.js +5 -0
  387. package/dist/tools/chat.js +848 -0
  388. package/dist/tools/clean-video-audio.js +97 -0
  389. package/dist/tools/clear-failed-tasks.js +66 -0
  390. package/dist/tools/cold-open.js +114 -0
  391. package/dist/tools/command-plan.js +1680 -0
  392. package/dist/tools/commands.js +1666 -0
  393. package/dist/tools/concat-images.js +236 -0
  394. package/dist/tools/connect-service.js +55 -0
  395. package/dist/tools/copy-file-to-clipboard.js +58 -0
  396. package/dist/tools/create-character.js +114 -0
  397. package/dist/tools/create-qart.js +253 -0
  398. package/dist/tools/create-qr-outro.js +149 -0
  399. package/dist/tools/create-qrbtf.js +215 -0
  400. package/dist/tools/create-watermark.js +97 -0
  401. package/dist/tools/crop-asset.js +18 -0
  402. package/dist/tools/crop-image.js +120 -0
  403. package/dist/tools/crop-video.js +97 -0
  404. package/dist/tools/delete-asset.js +104 -0
  405. package/dist/tools/describe-image.js +69 -0
  406. package/dist/tools/detect-scenes.js +44 -0
  407. package/dist/tools/doctor.js +126 -0
  408. package/dist/tools/download-video.js +114 -0
  409. package/dist/tools/duplicate-asset.js +184 -0
  410. package/dist/tools/edit-timeline.js +59 -0
  411. package/dist/tools/editing-moments.js +105 -0
  412. package/dist/tools/estimate-cost.js +171 -0
  413. package/dist/tools/even-split.js +295 -0
  414. package/dist/tools/export-asset-file.js +22 -0
  415. package/dist/tools/export-asset.js +140 -0
  416. package/dist/tools/export-sequence.js +250 -0
  417. package/dist/tools/export-to-downloads.js +54 -0
  418. package/dist/tools/export-transcript-srt.js +79 -0
  419. package/dist/tools/extend-audio.js +100 -0
  420. package/dist/tools/extract-audio.js +174 -0
  421. package/dist/tools/extract-frame.js +108 -0
  422. package/dist/tools/extract-notebook-audio.js +173 -0
  423. package/dist/tools/extract-notebook-frame.js +160 -0
  424. package/dist/tools/extract-video-clip.js +101 -0
  425. package/dist/tools/generate-media.js +157 -0
  426. package/dist/tools/generation-payload.js +48 -0
  427. package/dist/tools/get-timeline.js +12 -0
  428. package/dist/tools/get-watermark-config.js +38 -0
  429. package/dist/tools/goal.js +644 -0
  430. package/dist/tools/image-subjects.js +711 -0
  431. package/dist/tools/index.js +323 -0
  432. package/dist/tools/inject-first-frame.js +154 -0
  433. package/dist/tools/invert-image.js +70 -0
  434. package/dist/tools/isolate-vocals.js +66 -0
  435. package/dist/tools/list-assets.js +98 -0
  436. package/dist/tools/list-cell-generations.js +225 -0
  437. package/dist/tools/list-elevenlabs-voices.js +163 -0
  438. package/dist/tools/log-wrapper.js +29 -0
  439. package/dist/tools/make-cover-song.js +95 -0
  440. package/dist/tools/mark-asset-seen.js +23 -0
  441. package/dist/tools/media-library.js +245 -0
  442. package/dist/tools/move-timeline-audio.js +35 -0
  443. package/dist/tools/music-analysis.js +60 -0
  444. package/dist/tools/music-draft.js +29 -0
  445. package/dist/tools/pad-video.js +87 -0
  446. package/dist/tools/post-record.js +83 -0
  447. package/dist/tools/post.js +168 -0
  448. package/dist/tools/prompt-history.js +164 -0
  449. package/dist/tools/provider-key-status.js +248 -0
  450. package/dist/tools/qrbtf-render.js +849 -0
  451. package/dist/tools/read-asset-metadata.js +26 -0
  452. package/dist/tools/read-file-at-commit.js +29 -0
  453. package/dist/tools/read-transcript.js +41 -0
  454. package/dist/tools/reconcile-project-work.js +1452 -0
  455. package/dist/tools/recover-asset.js +28 -0
  456. package/dist/tools/remove-sound.js +72 -0
  457. package/dist/tools/remove-timeline-audio.js +34 -0
  458. package/dist/tools/remove-timeline-slot.js +40 -0
  459. package/dist/tools/rename-all.js +434 -0
  460. package/dist/tools/rename-asset.js +34 -0
  461. package/dist/tools/render-settings.js +47 -0
  462. package/dist/tools/render-timeline.js +120 -0
  463. package/dist/tools/render.js +384 -0
  464. package/dist/tools/reorder-character-images.js +45 -0
  465. package/dist/tools/replace-video-audio.js +133 -0
  466. package/dist/tools/restore-archive-clips.js +209 -0
  467. package/dist/tools/restore-asset-version.js +37 -0
  468. package/dist/tools/retry-generation.js +54 -0
  469. package/dist/tools/reverse-video.js +74 -0
  470. package/dist/tools/rewrite-prompt.js +388 -0
  471. package/dist/tools/rewrite-script.js +67 -0
  472. package/dist/tools/schema-from-apicity.js +66 -0
  473. package/dist/tools/search-archive.js +150 -0
  474. package/dist/tools/semantic-search.js +1214 -0
  475. package/dist/tools/sequence-rhythm.js +43 -0
  476. package/dist/tools/set-character-metadata.js +84 -0
  477. package/dist/tools/set-env-secret.js +40 -0
  478. package/dist/tools/set-osg.js +143 -0
  479. package/dist/tools/show-folder.js +37 -0
  480. package/dist/tools/smooth-scene-concat.js +122 -0
  481. package/dist/tools/splice-video.js +149 -0
  482. package/dist/tools/split-video.js +202 -0
  483. package/dist/tools/suggest-cuts.js +45 -0
  484. package/dist/tools/suggest-sfx.js +43 -0
  485. package/dist/tools/sync-video-to-audio.js +115 -0
  486. package/dist/tools/tag-backfill.js +177 -0
  487. package/dist/tools/timewarp-video.js +85 -0
  488. package/dist/tools/tool-def.js +1 -0
  489. package/dist/tools/tool-json-schema.js +116 -0
  490. package/dist/tools/transcribe.js +90 -0
  491. package/dist/tools/translate-subtitles.js +59 -0
  492. package/dist/tools/trim-audio.js +139 -0
  493. package/dist/tools/trim-video.js +168 -0
  494. package/dist/tools/update-script.js +25 -0
  495. package/dist/tools/update-timeline-audio.js +40 -0
  496. package/dist/tools/upload-file.js +41 -0
  497. package/dist/tools/verify-x-mentions.js +141 -0
  498. package/dist/tools/video-editing-command-contract.js +291 -0
  499. package/dist/tools/video-source-reference.js +30 -0
  500. package/dist/tools/video-time-input.js +18 -0
  501. package/dist/tools/videobook-domain.js +2021 -0
  502. package/dist/tools/wait-for-asset-ready.js +143 -0
  503. package/dist/tools/workspace-actions.js +54 -0
  504. package/dist/transcript-projection.js +202 -0
  505. package/dist/transcript-srt.js +33 -0
  506. package/dist/upload.js +76 -0
  507. package/dist/usage-providers.js +25 -0
  508. package/dist/video-analysis-projection.js +46 -0
  509. package/dist/video-poster.js +33 -0
  510. package/dist/video-proxy.js +99 -0
  511. package/dist/vision-regions.js +111 -0
  512. package/dist/voice-actions.js +90 -0
  513. package/dist/voice-audio.js +55 -0
  514. package/dist/voice-config.js +122 -0
  515. package/dist/voice-continuation.js +54 -0
  516. package/dist/voice-contract.js +1 -0
  517. package/dist/voice-http.js +145 -0
  518. package/dist/voice-reply-progress.js +55 -0
  519. package/dist/voice-session.js +992 -0
  520. package/dist/watermark-badge.js +259 -0
  521. package/dist/watermark-config.js +111 -0
  522. package/dist/watermark-handle-position.js +55 -0
  523. package/dist/watermark-platform.js +15 -0
  524. package/dist/watermark-timing.js +16 -0
  525. package/dist/workspace-action-catalog.js +315 -0
  526. package/dist/workspace-action-contract.js +21 -0
  527. package/dist/workspace-action-groups.js +98 -0
  528. package/dist/workspace-action-surfaces.js +7 -0
  529. package/dist/x/account.js +88 -0
  530. package/dist/x/authenticated-handle.js +30 -0
  531. package/dist/x/oauth-flow.js +191 -0
  532. package/dist/x/post-contract.js +1 -0
  533. package/dist/x/post-metadata.js +44 -0
  534. package/dist/x/post-to-x.js +456 -0
  535. package/dist/x/published-post-cell.js +90 -0
  536. package/dist/x/x-tokens.js +69 -0
  537. package/dist/ytdlp-binary.js +65 -0
  538. package/dist/zod-slots.js +334 -0
  539. package/package.json +84 -4
  540. package/ui/assets/alive-captions-BWb5nLKj.css +1 -0
  541. package/ui/assets/alive-captions-DPEr1nKM.js +1 -0
  542. package/ui/assets/confirm-bodies-D8ouHXKy.js +1 -0
  543. package/ui/assets/confirm-bodies-DrMhaXC6.css +1 -0
  544. package/ui/assets/fullscreen-B7nw4YbE.js +1 -0
  545. package/ui/assets/goal-ui-DK-xTCK0.js +2 -0
  546. package/ui/assets/goal-ui-DXdUM2KF.css +1 -0
  547. package/ui/assets/index-DzPAnCUj.css +1 -0
  548. package/ui/assets/index-kS1905s5.js +37 -0
  549. package/ui/assets/inspector-MlzQbTVo.js +1 -0
  550. package/ui/assets/jobs-ui-CoinOWx0.js +1 -0
  551. package/ui/assets/music-video-Cbe80kmQ.js +1 -0
  552. package/ui/assets/music-video-DPaiKKEq.css +1 -0
  553. package/ui/assets/ui-Oirr9VOf.css +1 -0
  554. package/ui/assets/ui-xo_Y1yQg.js +2 -0
  555. package/ui/assets/vendor-D2rfiZ5j.css +1 -0
  556. package/ui/assets/vendor-DfTCWgKm.js +19 -0
  557. package/ui/assets/vendor-flow-BXbeWxW7.js +7 -0
  558. package/ui/assets/vendor-flow-BnuhLJ6X.css +1 -0
  559. package/ui/assets/vendor-icons-CGqhCIXV.js +1 -0
  560. package/ui/assets/vendor-mcp-BTlEJcHV.js +67 -0
  561. package/ui/assets/vendor-react-Dj7D1fD4.js +9 -0
  562. package/ui/assets/vendor-remotion-CH1HXrlc.js +95 -0
  563. package/ui/assets/videobook-Qlp9HQFu.js +20 -0
  564. package/ui/favicon.svg +8 -0
  565. package/ui/index.html +126 -0
@@ -0,0 +1,519 @@
1
+ import { v7 as uuidv7 } from "uuid";
2
+ import { notebookGridTag } from "videobook-engine/notebook-grid";
3
+ import { mutateNotebook } from "./notebook-mutations.js";
4
+ import { failQueuedNotebookCells, notebookCellDefinitionFingerprint, notebookCellIsPaid, notebookCellIsRunnable, notebookCellIsStale, notebookCellMediaType, prepareNotebookGeneration, topologicalOrder, } from "./jobs/run-notebook.js";
5
+ import { queue } from "./queue.js";
6
+ import { assessToolCallEstimate, logUnavailableCostEstimate, } from "./jobs/cost-estimate-assessment.js";
7
+ export function notebookRunPlanRecords(document) {
8
+ return (document.notebookRunPlans ?? []);
9
+ }
10
+ async function persistNotebookRunPlan(engine, notebookId, record) {
11
+ const result = await mutateNotebook(engine, notebookId, "persist_notebook_run_plan", (document) => ({
12
+ ...document,
13
+ notebookRunPlans: [
14
+ ...notebookRunPlanRecords(document).filter((candidate) => candidate.planId !== record.planId),
15
+ record,
16
+ ],
17
+ }), {
18
+ planId: record.planId,
19
+ status: record.status,
20
+ paidCellIds: record.paidCellIds,
21
+ knownCostUsd: record.knownCostUsd,
22
+ unknownCostCount: record.unknownCostCount,
23
+ });
24
+ if (!result.ok)
25
+ throw new Error(result.error.message);
26
+ }
27
+ async function estimateCall(engine, tool, input, correlation) {
28
+ const assessment = await assessToolCallEstimate(engine, tool, input);
29
+ if (!assessment.available) {
30
+ await logUnavailableCostEstimate({
31
+ assessment,
32
+ engine,
33
+ correlation: {
34
+ bookId: engine.book.get().bookId,
35
+ tool,
36
+ stage: correlation.stage,
37
+ ...(correlation.notebookId ? { notebookId: correlation.notebookId } : {}),
38
+ ...(correlation.cellId ? { cellId: correlation.cellId } : {}),
39
+ ...(correlation.provider ? { provider: correlation.provider } : {}),
40
+ ...(correlation.model ? { model: correlation.model } : {}),
41
+ },
42
+ });
43
+ return {
44
+ estimateUnavailable: true,
45
+ warnings: [],
46
+ };
47
+ }
48
+ return {
49
+ estimatedCostUsd: assessment.usd,
50
+ estimateUnavailable: false,
51
+ warnings: assessment.warnings,
52
+ };
53
+ }
54
+ function connectedMedia(document, cell) {
55
+ const cells = new Map(document.cells.map((candidate) => [
56
+ candidate.id,
57
+ candidate,
58
+ ]));
59
+ return document.edges
60
+ .filter((edge) => edge.target === cell.id)
61
+ .flatMap((edge) => {
62
+ const source = cells.get(edge.source);
63
+ if (!source)
64
+ return [];
65
+ const mediaType = notebookCellMediaType(source);
66
+ return [{
67
+ targetInput: edge.targetInput,
68
+ sourceCellId: source.id,
69
+ sourceType: source.type,
70
+ sourceOperation: source.operation ?? null,
71
+ artifactId: source.outputArtifactId ?? null,
72
+ disclosure: mediaType === "audio"
73
+ ? edge.targetInput === "replace_audio"
74
+ ? "local audio is used for post-generation soundtrack replacement"
75
+ : "audio-derived context only"
76
+ : mediaType === "image"
77
+ ? "image bytes are disclosed to the selected provider"
78
+ : mediaType === "video"
79
+ ? "video bytes are disclosed when the selected model requires them"
80
+ : "structured notebook context",
81
+ }];
82
+ });
83
+ }
84
+ function requiredSubgraphIds(document, targetCellId) {
85
+ const incoming = new Map();
86
+ for (const edge of document.edges) {
87
+ const sources = incoming.get(edge.target) ?? [];
88
+ sources.push(edge.source);
89
+ incoming.set(edge.target, sources);
90
+ }
91
+ const seen = new Set();
92
+ const stack = [targetCellId];
93
+ while (stack.length > 0) {
94
+ const id = stack.pop();
95
+ if (!id || seen.has(id))
96
+ continue;
97
+ seen.add(id);
98
+ for (const source of incoming.get(id) ?? [])
99
+ stack.push(source);
100
+ }
101
+ return seen;
102
+ }
103
+ function cellArtifactId(engine, cell) {
104
+ const artifactId = cell.outputArtifactId ?? null;
105
+ if (!artifactId)
106
+ return null;
107
+ return engine.artifacts.get(artifactId).ok ? artifactId : null;
108
+ }
109
+ export async function planSelectedNotebookSubgraph(engine, document, targetCellId, sourceSurface, actor) {
110
+ const target = document.cells.find((cell) => cell.id === targetCellId);
111
+ if (!target)
112
+ throw new Error(`Target cell not found: ${targetCellId}`);
113
+ const allowed = requiredSubgraphIds(document, targetCellId);
114
+ const ordered = topologicalOrder(document).filter((cell) => allowed.has(cell.id));
115
+ const planId = uuidv7();
116
+ const stages = [];
117
+ const fingerprints = {};
118
+ const paidCellIds = [];
119
+ let knownCostUsd = 0;
120
+ let unknownCostCount = 0;
121
+ const upstreamOutputs = new Map();
122
+ for (const cell of ordered) {
123
+ const missing = cellArtifactId(engine, cell) === null
124
+ && notebookCellIsRunnable(cell);
125
+ const stale = notebookCellIsStale(engine, document, cell);
126
+ const current = !stale && !missing && cellArtifactId(engine, cell) !== null;
127
+ const definitionFingerprint = notebookCellDefinitionFingerprint(document, cell);
128
+ fingerprints[cell.id] = definitionFingerprint;
129
+ const bindings = document.edges
130
+ .filter((edge) => edge.target === cell.id)
131
+ .map((edge) => {
132
+ const source = document.cells.find((candidate) => candidate.id === edge.source);
133
+ return {
134
+ targetInput: edge.targetInput,
135
+ sourceCellId: edge.source,
136
+ artifactId: source
137
+ ? upstreamOutputs.get(source.id) ?? cellArtifactId(engine, source)
138
+ : null,
139
+ };
140
+ });
141
+ if (current && cell.id !== target.id) {
142
+ const reused = cellArtifactId(engine, cell);
143
+ upstreamOutputs.set(cell.id, reused);
144
+ stages.push({
145
+ stageId: `${planId}:reuse:${stages.length}`,
146
+ kind: "reuse",
147
+ cellId: cell.id,
148
+ summary: `${notebookGridTag(cell.slot)} · reuse current output`,
149
+ cellDefinitionFingerprint: definitionFingerprint,
150
+ outputArtifactId: reused,
151
+ insertsOutput: false,
152
+ });
153
+ continue;
154
+ }
155
+ const paid = notebookCellIsPaid(cell);
156
+ const runnable = notebookCellIsRunnable(cell) || missing;
157
+ if (!runnable && cell.id !== target.id) {
158
+ upstreamOutputs.set(cell.id, cellArtifactId(engine, cell));
159
+ continue;
160
+ }
161
+ if (paid) {
162
+ paidCellIds.push(cell.id);
163
+ let tool = cell.tool ?? cell.operation ?? "unknown";
164
+ let provider = cell.provider ?? null;
165
+ let model = cell.model ?? null;
166
+ let actionInput = {};
167
+ let estimate = {
168
+ estimateUnavailable: true,
169
+ warnings: [],
170
+ };
171
+ try {
172
+ const prepared = await prepareNotebookGeneration(engine, document, cell, engine.book.get().bookId, { allowReferenceIssues: true });
173
+ tool = prepared.tool;
174
+ provider = prepared.provider;
175
+ model = prepared.model;
176
+ actionInput = prepared.input;
177
+ estimate = await estimateCall(engine, prepared.tool, prepared.input, {
178
+ notebookId: document.id,
179
+ cellId: cell.id,
180
+ provider: prepared.provider,
181
+ model: prepared.model,
182
+ stage: "plan-subgraph",
183
+ });
184
+ }
185
+ catch {
186
+ estimate = {
187
+ estimateUnavailable: true,
188
+ warnings: [],
189
+ };
190
+ }
191
+ if (estimate.estimateUnavailable)
192
+ unknownCostCount += 1;
193
+ else
194
+ knownCostUsd += estimate.estimatedCostUsd ?? 0;
195
+ stages.push({
196
+ stageId: `${planId}:paid:${stages.length}`,
197
+ kind: "queued",
198
+ cellId: cell.id,
199
+ summary: `${notebookGridTag(cell.slot)} · ${tool}`,
200
+ jobType: "generation",
201
+ tool,
202
+ input: {
203
+ notebook_id: document.id,
204
+ cell_id: cell.id,
205
+ action_input: actionInput,
206
+ connected_media: connectedMedia(document, cell),
207
+ cell_definition_fingerprint: definitionFingerprint,
208
+ upstream_bindings: bindings,
209
+ subgraph_run: true,
210
+ },
211
+ provider,
212
+ model,
213
+ requiresCoverage: true,
214
+ cellDefinitionFingerprint: definitionFingerprint,
215
+ ...(estimate.estimateUnavailable
216
+ ? { estimateUnavailable: true }
217
+ : { estimatedCostUsd: estimate.estimatedCostUsd }),
218
+ insertsOutput: false,
219
+ });
220
+ }
221
+ else {
222
+ stages.push({
223
+ stageId: `${planId}:local:${stages.length}`,
224
+ kind: "queued",
225
+ cellId: cell.id,
226
+ summary: `${notebookGridTag(cell.slot)} · automatic local rerun`,
227
+ jobType: "indexing",
228
+ tool: cell.tool ?? cell.operation ?? "run_notebook",
229
+ automatic: true,
230
+ cellDefinitionFingerprint: definitionFingerprint,
231
+ input: {
232
+ notebook_id: document.id,
233
+ cell_id: cell.id,
234
+ upstream_bindings: bindings,
235
+ subgraph_run: true,
236
+ },
237
+ insertsOutput: false,
238
+ });
239
+ }
240
+ upstreamOutputs.set(cell.id, null);
241
+ }
242
+ const confirmationRequired = paidCellIds.length > 0;
243
+ const plan = {
244
+ planVersion: 1,
245
+ planId,
246
+ sourceSurface,
247
+ actor,
248
+ bookId: engine.book.get().bookId,
249
+ summary: `Run selected subgraph for ${notebookGridTag(target.slot)}`,
250
+ normalizedReferences: [{
251
+ kind: "notebook",
252
+ targetId: document.id,
253
+ revision: engine.head,
254
+ }],
255
+ stages,
256
+ confirmation: {
257
+ required: confirmationRequired,
258
+ policy: confirmationRequired ? "always" : "reversible-single-step",
259
+ reason: confirmationRequired
260
+ ? unknownCostCount > 0
261
+ ? `This selected run has ${paidCellIds.length} provider calls; ${unknownCostCount} cannot be priced`
262
+ : `This selected run can incur up to $${knownCostUsd.toFixed(4)} in provider spend`
263
+ : "Only local reversible processing will run",
264
+ },
265
+ notebookRun: {
266
+ notebookId: document.id,
267
+ targetCellId,
268
+ mode: "subgraph",
269
+ subgraphCellIds: ordered.map((cell) => cell.id),
270
+ staleCellIds: stages
271
+ .filter((stage) => stage.kind === "queued")
272
+ .map((stage) => stage.cellId),
273
+ paidCellCount: paidCellIds.length,
274
+ knownCostUsd,
275
+ unknownCostCount,
276
+ noOp: stages.every((stage) => stage.kind === "reuse") && !notebookCellIsRunnable(target),
277
+ },
278
+ };
279
+ const now = new Date().toISOString();
280
+ await persistNotebookRunPlan(engine, document.id, {
281
+ planId,
282
+ status: "planned",
283
+ plan,
284
+ paidCellIds,
285
+ cellDefinitionFingerprints: fingerprints,
286
+ knownCostUsd,
287
+ unknownCostCount,
288
+ createdAt: now,
289
+ updatedAt: now,
290
+ });
291
+ return plan;
292
+ }
293
+ export async function planNotebookRun(engine, document, sourceSurface, actor, options = {}) {
294
+ const ordered = topologicalOrder(document);
295
+ const runnable = ordered.filter((cell) => notebookCellIsRunnable(cell)
296
+ && (options.force === true
297
+ || notebookCellIsStale(engine, document, cell)));
298
+ const paid = runnable.filter(notebookCellIsPaid);
299
+ const planId = uuidv7();
300
+ const stages = [];
301
+ const fingerprints = {};
302
+ let knownCostUsd = 0;
303
+ let unknownCostCount = 0;
304
+ for (const cell of paid) {
305
+ const prepared = await prepareNotebookGeneration(engine, document, cell, engine.book.get().bookId);
306
+ let estimate;
307
+ try {
308
+ estimate = await estimateCall(engine, prepared.tool, prepared.input, {
309
+ notebookId: document.id,
310
+ cellId: cell.id,
311
+ provider: prepared.provider,
312
+ model: prepared.model,
313
+ stage: "plan-workbook",
314
+ });
315
+ }
316
+ catch {
317
+ estimate = {
318
+ estimateUnavailable: true,
319
+ warnings: [],
320
+ };
321
+ }
322
+ if (estimate.estimateUnavailable) {
323
+ unknownCostCount += 1;
324
+ }
325
+ else {
326
+ knownCostUsd += estimate.estimatedCostUsd ?? 0;
327
+ }
328
+ const definitionFingerprint = notebookCellDefinitionFingerprint(document, cell);
329
+ fingerprints[cell.id] = definitionFingerprint;
330
+ stages.push({
331
+ stageId: `${planId}:queued:${stages.length}`,
332
+ kind: "queued",
333
+ summary: `${notebookGridTag(cell.slot)} · ${prepared.tool}`,
334
+ jobType: "generation",
335
+ tool: prepared.tool,
336
+ input: {
337
+ notebook_id: document.id,
338
+ cell_id: cell.id,
339
+ action_input: prepared.input,
340
+ connected_media: connectedMedia(document, cell),
341
+ cell_definition_fingerprint: definitionFingerprint,
342
+ workbook_run: true,
343
+ },
344
+ provider: prepared.provider,
345
+ model: prepared.model,
346
+ ...(estimate.estimateUnavailable
347
+ ? { estimateUnavailable: true }
348
+ : { estimatedCostUsd: estimate.estimatedCostUsd }),
349
+ insertsOutput: false,
350
+ });
351
+ }
352
+ if (stages.length === 0) {
353
+ stages.push({
354
+ stageId: `${planId}:queued:0`,
355
+ kind: "queued",
356
+ summary: runnable.length === 0
357
+ ? "Workbook is already current"
358
+ : `Run ${runnable.length} local workbook cells`,
359
+ jobType: "indexing",
360
+ tool: runnable.length === 0 ? "notebook_noop" : "run_notebook",
361
+ input: {
362
+ notebook_id: document.id,
363
+ workbook_run: true,
364
+ no_op: runnable.length === 0,
365
+ },
366
+ insertsOutput: false,
367
+ });
368
+ }
369
+ const plan = {
370
+ planVersion: 1,
371
+ planId,
372
+ sourceSurface,
373
+ actor,
374
+ bookId: engine.book.get().bookId,
375
+ summary: runnable.length === 0
376
+ ? "Workbook is fully current"
377
+ : `Run ${runnable.length} stale workbook cells`,
378
+ normalizedReferences: [{
379
+ kind: "notebook",
380
+ targetId: document.id,
381
+ revision: engine.head,
382
+ }],
383
+ stages,
384
+ confirmation: {
385
+ required: paid.length > 0,
386
+ policy: paid.length > 0 ? "always" : "reversible-single-step",
387
+ reason: paid.length > 0
388
+ ? unknownCostCount > 0
389
+ ? `This run has ${paid.length} provider calls; ${unknownCostCount} cannot be priced`
390
+ : `This run can incur up to $${knownCostUsd.toFixed(4)} in provider spend`
391
+ : runnable.length === 0
392
+ ? "No cells need to run"
393
+ : "Only local reversible processing will run",
394
+ },
395
+ notebookRun: {
396
+ notebookId: document.id,
397
+ staleCellIds: runnable.map((cell) => cell.id),
398
+ localCellCount: runnable.length - paid.length,
399
+ paidCellCount: paid.length,
400
+ knownCostUsd,
401
+ unknownCostCount,
402
+ noOp: runnable.length === 0,
403
+ force: options.force === true,
404
+ },
405
+ };
406
+ const now = new Date().toISOString();
407
+ await persistNotebookRunPlan(engine, document.id, {
408
+ planId,
409
+ status: "planned",
410
+ plan,
411
+ paidCellIds: paid.map((cell) => cell.id),
412
+ cellDefinitionFingerprints: fingerprints,
413
+ knownCostUsd,
414
+ unknownCostCount,
415
+ createdAt: now,
416
+ updatedAt: now,
417
+ });
418
+ return plan;
419
+ }
420
+ export async function claimNotebookRunPlan(engine, notebookId, planId, runId, options) {
421
+ let claimed = null;
422
+ const updatedAt = new Date().toISOString();
423
+ const result = await mutateNotebook(engine, notebookId, "claim_notebook_run_plan", (document) => {
424
+ const record = notebookRunPlanRecords(document).find((candidate) => candidate.planId === planId);
425
+ if (!record)
426
+ throw new Error("Notebook run plan is not preserved");
427
+ if (record.status !== "planned") {
428
+ throw new Error(`Notebook run plan is already ${record.status}`);
429
+ }
430
+ if (record.runId)
431
+ throw new Error("Notebook run plan is already claimed");
432
+ void options.confirmUnpriced;
433
+ for (const cellId of record.paidCellIds) {
434
+ const cell = document.cells.find((candidate) => candidate.id === cellId);
435
+ if (!cell)
436
+ throw new Error(`Planned cell was deleted: ${cellId}`);
437
+ const actual = notebookCellDefinitionFingerprint(document, cell);
438
+ const expected = record.cellDefinitionFingerprints[cellId];
439
+ if (actual !== expected) {
440
+ throw new Error(`Notebook run plan is stale for ${notebookGridTag(cell.slot)}`);
441
+ }
442
+ }
443
+ const notebookRun = record.plan.notebookRun;
444
+ const noOp = Boolean(notebookRun
445
+ && typeof notebookRun === "object"
446
+ && !Array.isArray(notebookRun)
447
+ && notebookRun.noOp === true);
448
+ const force = Boolean(notebookRun
449
+ && typeof notebookRun === "object"
450
+ && !Array.isArray(notebookRun)
451
+ && notebookRun.force === true);
452
+ const next = {
453
+ ...record,
454
+ status: noOp ? "completed" : "queued",
455
+ ...(!noOp ? { runId } : {}),
456
+ updatedAt,
457
+ };
458
+ claimed = { record: next, noOp, force };
459
+ return {
460
+ ...document,
461
+ notebookRunPlans: notebookRunPlanRecords(document).map((candidate) => candidate.planId === planId ? next : candidate),
462
+ };
463
+ }, { notebookId, planId, runId });
464
+ if (!result.ok)
465
+ throw new Error(result.error.message);
466
+ if (!claimed)
467
+ throw new Error("Notebook run plan claim was not persisted");
468
+ return claimed;
469
+ }
470
+ function notebookRunSubgraphCellIds(plan) {
471
+ const notebookRun = plan.notebookRun;
472
+ if (!notebookRun || typeof notebookRun !== "object" || Array.isArray(notebookRun)) {
473
+ return undefined;
474
+ }
475
+ const raw = notebookRun.subgraphCellIds;
476
+ if (!Array.isArray(raw) || raw.length === 0)
477
+ return undefined;
478
+ const cellIds = raw.filter((id) => typeof id === "string" && id.length > 0);
479
+ return cellIds.length === raw.length ? cellIds : undefined;
480
+ }
481
+ export async function enqueueNotebookRunPlan(engine, notebookId, planId, options) {
482
+ const runId = uuidv7();
483
+ const claimed = await claimNotebookRunPlan(engine, notebookId, planId, runId, { confirmUnpriced: options.confirmUnpriced });
484
+ if (claimed.noOp)
485
+ return { status: "completed", planId };
486
+ const record = claimed.record;
487
+ const jobId = `run-notebook-${notebookId}-${runId}`;
488
+ const cellIds = notebookRunSubgraphCellIds(record.plan);
489
+ try {
490
+ await queue.enqueue(jobId, {
491
+ type: "run_notebook",
492
+ bookId: engine.book.get().bookId,
493
+ notebookId,
494
+ runId,
495
+ runPlanId: planId,
496
+ generationPlan: record.plan,
497
+ actor: options.actor,
498
+ jobId,
499
+ force: claimed.force,
500
+ ...(cellIds ? { cellIds } : {}),
501
+ });
502
+ }
503
+ catch (cause) {
504
+ const message = cause instanceof Error ? cause.message : String(cause);
505
+ await failQueuedNotebookCells(engine, notebookId, {
506
+ cellIds: cellIds ?? [],
507
+ runId,
508
+ runPlanId: planId,
509
+ error: message,
510
+ }).catch(() => undefined);
511
+ throw cause;
512
+ }
513
+ return {
514
+ status: "queued",
515
+ planId,
516
+ runId,
517
+ jobId,
518
+ };
519
+ }
@@ -0,0 +1,162 @@
1
+ export const MAX_SHOT_SECONDS = 15;
2
+ function roundTime(value) {
3
+ return Math.round(value * 1000) / 1000;
4
+ }
5
+ export function normalizeShots(shots, sourceDurationSeconds) {
6
+ if (!(sourceDurationSeconds > 0)) {
7
+ throw new Error("Source duration must be positive");
8
+ }
9
+ const duration = roundTime(sourceDurationSeconds);
10
+ const cleaned = shots
11
+ .map((shot) => ({
12
+ startSeconds: Math.max(0, Math.min(duration, shot.startSeconds)),
13
+ endSeconds: Math.max(0, Math.min(duration, shot.endSeconds)),
14
+ label: shot.label?.trim() || undefined,
15
+ prompt: shot.prompt?.trim() || undefined,
16
+ }))
17
+ .filter((shot) => shot.endSeconds > shot.startSeconds)
18
+ .sort((left, right) => left.startSeconds - right.startSeconds);
19
+ const raw = cleaned.length > 0
20
+ ? cleaned
21
+ : [{ startSeconds: 0, endSeconds: duration }];
22
+ const covered = [];
23
+ let cursor = 0;
24
+ for (const shot of raw) {
25
+ let start = Math.max(cursor, shot.startSeconds);
26
+ let end = Math.max(start, shot.endSeconds);
27
+ if (start > cursor) {
28
+ covered.push({ startSeconds: cursor, endSeconds: start });
29
+ }
30
+ if (covered.length > 0) {
31
+ const previous = covered[covered.length - 1];
32
+ if (start < previous.endSeconds)
33
+ start = previous.endSeconds;
34
+ if (end < start)
35
+ end = start;
36
+ }
37
+ if (end > start) {
38
+ covered.push({
39
+ startSeconds: start,
40
+ endSeconds: end,
41
+ ...(shot.label ? { label: shot.label } : {}),
42
+ ...(shot.prompt ? { prompt: shot.prompt } : {}),
43
+ });
44
+ cursor = end;
45
+ }
46
+ }
47
+ if (cursor < duration) {
48
+ covered.push({ startSeconds: cursor, endSeconds: duration });
49
+ }
50
+ if (covered.length === 0) {
51
+ covered.push({ startSeconds: 0, endSeconds: duration });
52
+ }
53
+ covered[0].startSeconds = 0;
54
+ covered[covered.length - 1].endSeconds = duration;
55
+ for (let index = 1; index < covered.length; index += 1) {
56
+ covered[index].startSeconds = covered[index - 1].endSeconds;
57
+ }
58
+ const finalRanges = [];
59
+ for (const shot of covered) {
60
+ const rangeDuration = roundTime(shot.endSeconds - shot.startSeconds);
61
+ const partCount = Math.max(1, Math.ceil(rangeDuration / MAX_SHOT_SECONDS));
62
+ let start = shot.startSeconds;
63
+ for (let part = 0; part < partCount; part += 1) {
64
+ const end = part === partCount - 1
65
+ ? shot.endSeconds
66
+ : roundTime(shot.startSeconds + rangeDuration * (part + 1) / partCount);
67
+ finalRanges.push({
68
+ startSeconds: start,
69
+ endSeconds: end,
70
+ ...(shot.label ? { label: shot.label } : {}),
71
+ ...(shot.prompt ? { prompt: shot.prompt } : {}),
72
+ });
73
+ start = end;
74
+ }
75
+ }
76
+ return finalRanges.map((shot, index) => {
77
+ const durationSeconds = roundTime(shot.endSeconds - shot.startSeconds);
78
+ return {
79
+ ordinal: index + 1,
80
+ startSeconds: roundTime(shot.startSeconds),
81
+ endSeconds: roundTime(shot.endSeconds),
82
+ durationSeconds,
83
+ label: shot.label ?? `Shot ${index + 1}`,
84
+ ...(shot.prompt ? { prompt: shot.prompt } : {}),
85
+ };
86
+ });
87
+ }
88
+ export function overlapSeconds(left, right) {
89
+ const start = Math.max(left.startSeconds, right.startSeconds);
90
+ const end = Math.min(left.endSeconds, right.endSeconds);
91
+ return Math.max(0, end - start);
92
+ }
93
+ /**
94
+ * Match existing analysis-owned branches to new shots by greatest tick-range
95
+ * overlap. Unmatched owned branches are removed; unmatched shots are created.
96
+ */
97
+ export function reconcileOwnedBranches(existing, shots) {
98
+ const remaining = [...existing];
99
+ const keep = [];
100
+ const create = [];
101
+ for (const shot of shots) {
102
+ let bestIndex = -1;
103
+ let bestOverlap = 0;
104
+ for (let index = 0; index < remaining.length; index += 1) {
105
+ const candidate = remaining[index];
106
+ const overlap = overlapSeconds(candidate.range, shot);
107
+ if (overlap > bestOverlap) {
108
+ bestOverlap = overlap;
109
+ bestIndex = index;
110
+ }
111
+ }
112
+ if (bestIndex >= 0 && bestOverlap > 0) {
113
+ const [matched] = remaining.splice(bestIndex, 1);
114
+ keep.push({ existing: matched, shot });
115
+ }
116
+ else {
117
+ create.push(shot);
118
+ }
119
+ }
120
+ return {
121
+ keep,
122
+ create,
123
+ remove: remaining,
124
+ };
125
+ }
126
+ export function parseAnalysisShots(raw) {
127
+ if (!raw || typeof raw !== "object")
128
+ return [];
129
+ const record = raw;
130
+ const candidates = Array.isArray(record.shots)
131
+ ? record.shots
132
+ : Array.isArray(record.scenes)
133
+ ? record.scenes
134
+ : [];
135
+ const shots = [];
136
+ for (const candidate of candidates) {
137
+ if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
138
+ continue;
139
+ }
140
+ const entry = candidate;
141
+ const start = Number(entry.startSeconds
142
+ ?? entry.start
143
+ ?? entry.start_time
144
+ ?? (Array.isArray(entry.timestamp) ? entry.timestamp[0] : undefined));
145
+ const end = Number(entry.endSeconds
146
+ ?? entry.end
147
+ ?? entry.end_time
148
+ ?? (Array.isArray(entry.timestamp) ? entry.timestamp[1] : undefined));
149
+ if (!Number.isFinite(start) || !Number.isFinite(end) || end <= start)
150
+ continue;
151
+ shots.push({
152
+ startSeconds: start,
153
+ endSeconds: end,
154
+ ...(typeof entry.label === "string" ? { label: entry.label } : {}),
155
+ ...(typeof entry.prompt === "string" ? { prompt: entry.prompt } : {}),
156
+ ...(typeof entry.title === "string" && !entry.label
157
+ ? { label: entry.title }
158
+ : {}),
159
+ });
160
+ }
161
+ return shots;
162
+ }