@morshoto/framekit 0.1.18 → 0.2.3

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 (192) hide show
  1. package/README.md +17 -12
  2. package/dist-package/adapters/final-cut/typescript/src/analyzers.d.ts +58 -0
  3. package/dist-package/adapters/final-cut/typescript/src/analyzers.js +52 -13
  4. package/dist-package/adapters/final-cut/typescript/src/assets.d.ts +24 -0
  5. package/dist-package/adapters/final-cut/typescript/src/background-export.d.ts +98 -0
  6. package/dist-package/adapters/final-cut/typescript/src/background-materialization.d.ts +47 -0
  7. package/dist-package/adapters/final-cut/typescript/src/background-materialization.js +8 -2
  8. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.d.ts +32 -0
  9. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.js +275 -0
  10. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery.d.ts +22 -0
  11. package/dist-package/adapters/final-cut/typescript/src/canonical-verification.d.ts +11 -0
  12. package/dist-package/adapters/final-cut/typescript/src/canonical.d.ts +184 -0
  13. package/dist-package/adapters/final-cut/typescript/src/canonical.js +571 -78
  14. package/dist-package/adapters/final-cut/typescript/src/connection.d.ts +103 -0
  15. package/dist-package/adapters/final-cut/typescript/src/connection.js +6 -1
  16. package/dist-package/adapters/final-cut/typescript/src/disposable-native.d.ts +90 -0
  17. package/dist-package/adapters/final-cut/typescript/src/disposable-native.js +6 -0
  18. package/dist-package/adapters/final-cut/typescript/src/documents.d.ts +3 -0
  19. package/dist-package/adapters/final-cut/typescript/src/documents.js +3 -0
  20. package/dist-package/adapters/final-cut/typescript/src/experimental.d.ts +8 -0
  21. package/dist-package/adapters/final-cut/typescript/src/experimental.js +8 -0
  22. package/dist-package/adapters/final-cut/typescript/src/export.d.ts +125 -0
  23. package/dist-package/adapters/final-cut/typescript/src/fcpxml-console-experiment.d.ts +54 -0
  24. package/dist-package/adapters/final-cut/typescript/src/fcpxml.d.ts +75 -0
  25. package/dist-package/adapters/final-cut/typescript/src/fcpxml.js +28 -9
  26. package/dist-package/adapters/final-cut/typescript/src/index.d.ts +22 -0
  27. package/dist-package/adapters/final-cut/typescript/src/index.js +1 -7
  28. package/dist-package/adapters/final-cut/typescript/src/library-inspection.d.ts +101 -0
  29. package/dist-package/adapters/final-cut/typescript/src/live.d.ts +101 -0
  30. package/dist-package/adapters/final-cut/typescript/src/live.js +35 -2
  31. package/dist-package/adapters/final-cut/typescript/src/media.d.ts +12 -0
  32. package/dist-package/adapters/final-cut/typescript/src/native-operation.d.ts +6 -0
  33. package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.d.ts +77 -0
  34. package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.js +175 -0
  35. package/dist-package/adapters/final-cut/typescript/src/native-session.d.ts +130 -0
  36. package/dist-package/adapters/final-cut/typescript/src/native-session.js +11 -6
  37. package/dist-package/adapters/final-cut/typescript/src/native.d.ts +828 -0
  38. package/dist-package/adapters/final-cut/typescript/src/native.js +475 -189
  39. package/dist-package/adapters/final-cut/typescript/src/pasteboard-snapshot.d.ts +114 -0
  40. package/dist-package/adapters/final-cut/typescript/src/publish-readback.d.ts +26 -0
  41. package/dist-package/adapters/final-cut/typescript/src/publish-readback.js +19 -2
  42. package/dist-package/adapters/final-cut/typescript/src/publisher.d.ts +215 -0
  43. package/dist-package/adapters/final-cut/typescript/src/publisher.js +255 -14
  44. package/dist-package/adapters/final-cut/typescript/src/session.d.ts +43 -0
  45. package/dist-package/adapters/final-cut/typescript/src/session.js +43 -13
  46. package/dist-package/adapters/final-cut/typescript/src/shadow-mutation.d.ts +51 -0
  47. package/dist-package/adapters/final-cut/typescript/src/sqlite-experiment.d.ts +156 -0
  48. package/dist-package/adapters/final-cut/typescript/src/sqlite-inspection.d.ts +134 -0
  49. package/dist-package/adapters/final-cut/typescript/src/sqlite-materialization.d.ts +110 -0
  50. package/dist-package/adapters/final-cut/typescript/src/sqlite-wal-observation.d.ts +132 -0
  51. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.d.ts +61 -0
  52. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.js +31 -5
  53. package/dist-package/adapters/final-cut/typescript/src/unattended-editing.d.ts +54 -0
  54. package/dist-package/adapters/headless/typescript/src/audio-output.d.ts +3 -0
  55. package/dist-package/adapters/headless/typescript/src/audio-output.js +3 -0
  56. package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.d.ts +11 -0
  57. package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.js +26 -2
  58. package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.d.ts +25 -0
  59. package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.js +37 -14
  60. package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.d.ts +15 -0
  61. package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.js +9 -4
  62. package/dist-package/adapters/headless/typescript/src/index.d.ts +3 -0
  63. package/dist-package/apps/cli/src/dev-doctor.d.ts +25 -0
  64. package/dist-package/apps/cli/src/dev-doctor.js +198 -0
  65. package/dist-package/apps/cli/src/headless-projects.d.ts +3 -0
  66. package/dist-package/apps/cli/src/headless-projects.js +5 -0
  67. package/dist-package/apps/cli/src/main.d.ts +10 -0
  68. package/dist-package/apps/cli/src/main.js +42 -0
  69. package/dist-package/apps/mcp-server/runtime/ffmpeg-audio-backend.py +129 -0
  70. package/dist-package/apps/mcp-server/runtime/speech-analyzer-wrapper.mjs +54 -0
  71. package/dist-package/apps/mcp-server/runtime/whisper-speech-backend.py +271 -0
  72. package/dist-package/apps/mcp-server/src/build-alignment.d.ts +10 -0
  73. package/dist-package/apps/mcp-server/src/build-identity.d.ts +7 -0
  74. package/dist-package/apps/mcp-server/src/build-identity.json +2 -2
  75. package/dist-package/apps/mcp-server/src/canonical-native-snapshot.d.ts +8 -0
  76. package/dist-package/apps/mcp-server/src/canonical-native-snapshot.js +18 -0
  77. package/dist-package/apps/mcp-server/src/final-cut-runtime-config.d.ts +5 -0
  78. package/dist-package/apps/mcp-server/src/final-cut-runtime-config.js +3 -0
  79. package/dist-package/apps/mcp-server/src/headless-project-snapshot.d.ts +3 -0
  80. package/dist-package/apps/mcp-server/src/headless-sessions.d.ts +89 -0
  81. package/dist-package/apps/mcp-server/src/main.d.ts +1 -0
  82. package/dist-package/apps/mcp-server/src/main.js +24 -19
  83. package/dist-package/apps/mcp-server/src/materialization-jobs.d.ts +204 -0
  84. package/dist-package/apps/mcp-server/src/materialization-jobs.js +143 -10
  85. package/dist-package/apps/mcp-server/src/readback-policy.d.ts +18 -0
  86. package/dist-package/apps/mcp-server/src/routing.d.ts +90 -0
  87. package/dist-package/apps/mcp-server/src/routing.js +2 -0
  88. package/dist-package/apps/mcp-server/src/server.d.ts +75 -0
  89. package/dist-package/apps/mcp-server/src/server.js +813 -158
  90. package/dist-package/apps/mcp-server/src/tools/skills/catalog.d.ts +19 -0
  91. package/dist-package/apps/mcp-server/src/tools/skills/catalog.js +142 -0
  92. package/dist-package/apps/mcp-server/src/tools/skills/metadata.d.ts +37 -0
  93. package/dist-package/apps/mcp-server/src/tools/skills/metadata.js +71 -0
  94. package/dist-package/apps/mcp-server/src/tools/skills/register.d.ts +11 -0
  95. package/dist-package/apps/mcp-server/src/tools/skills/register.js +101 -0
  96. package/dist-package/apps/mcp-server/src/version.d.ts +4 -0
  97. package/dist-package/packages/headless-application/src/external-edit.d.ts +30 -0
  98. package/dist-package/packages/headless-application/src/external-edit.js +72 -0
  99. package/dist-package/packages/headless-application/src/headless-projects.d.ts +233 -0
  100. package/dist-package/{apps/mcp-server → packages/headless-application}/src/headless-projects.js +392 -59
  101. package/dist-package/packages/headless-application/src/index.d.ts +2 -0
  102. package/dist-package/packages/headless-application/src/index.js +2 -0
  103. package/dist-package/packages/runtime/src/application/duration-policy-service.d.ts +4 -0
  104. package/dist-package/packages/runtime/src/application/local-media.d.ts +46 -0
  105. package/dist-package/packages/runtime/src/application/media-analysis-service.d.ts +40 -0
  106. package/dist-package/packages/runtime/src/application/media-analysis-service.js +105 -15
  107. package/dist-package/packages/runtime/src/application/project-service.d.ts +35 -0
  108. package/dist-package/packages/runtime/src/application/project-service.js +5 -1
  109. package/dist-package/packages/runtime/src/application/project-store.d.ts +56 -0
  110. package/dist-package/packages/runtime/src/application/project-store.js +13 -36
  111. package/dist-package/packages/runtime/src/application/project-transactions.d.ts +51 -0
  112. package/dist-package/packages/runtime/src/application/runtime-options.d.ts +15 -0
  113. package/dist-package/packages/runtime/src/application/semantic-media-index-store.d.ts +28 -0
  114. package/dist-package/packages/runtime/src/application/transaction-store.d.ts +10 -0
  115. package/dist-package/packages/runtime/src/application/transaction-store.js +1 -1
  116. package/dist-package/packages/runtime/src/audio/analysis.d.ts +3 -0
  117. package/dist-package/packages/runtime/src/audio/analysis.js +95 -0
  118. package/dist-package/packages/runtime/src/audio/dialogue-normalization.d.ts +47 -0
  119. package/dist-package/packages/runtime/src/audio/noise-reduction.d.ts +34 -0
  120. package/dist-package/packages/runtime/src/capabilities.d.ts +45 -0
  121. package/dist-package/packages/runtime/src/capabilities.js +1 -1
  122. package/dist-package/packages/runtime/src/color-correction.d.ts +33 -0
  123. package/dist-package/packages/runtime/src/context/context-engine.d.ts +28 -0
  124. package/dist-package/packages/runtime/src/context/context-engine.js +22 -16
  125. package/dist-package/packages/runtime/src/context/context-service.d.ts +20 -0
  126. package/dist-package/packages/runtime/src/context/context-service.js +2 -2
  127. package/dist-package/packages/runtime/src/context/project-catalog.d.ts +12 -0
  128. package/dist-package/packages/runtime/src/context/revision.d.ts +2 -0
  129. package/dist-package/packages/runtime/src/domain/capabilities.d.ts +170 -0
  130. package/dist-package/packages/runtime/src/domain/context.d.ts +179 -0
  131. package/dist-package/packages/runtime/src/domain/diff.d.ts +104 -0
  132. package/dist-package/packages/runtime/src/domain/duration.d.ts +63 -0
  133. package/dist-package/packages/runtime/src/domain/editing.d.ts +227 -0
  134. package/dist-package/packages/runtime/src/domain/incremental-sync.d.ts +67 -0
  135. package/dist-package/packages/runtime/src/domain/index.d.ts +14 -0
  136. package/dist-package/packages/runtime/src/domain/media.d.ts +406 -0
  137. package/dist-package/packages/runtime/src/domain/ports.d.ts +62 -0
  138. package/dist-package/packages/runtime/src/domain/primitives.d.ts +21 -0
  139. package/dist-package/packages/runtime/src/domain/project.d.ts +119 -0
  140. package/dist-package/packages/runtime/src/domain/rough-cut.d.ts +27 -0
  141. package/dist-package/packages/runtime/src/domain/skills.d.ts +145 -0
  142. package/dist-package/packages/runtime/src/domain/timeline-target.d.ts +57 -0
  143. package/dist-package/packages/runtime/src/domain/timeline-target.js +19 -1
  144. package/dist-package/packages/runtime/src/domain/types.d.ts +5 -0
  145. package/dist-package/packages/runtime/src/domain/verification.d.ts +92 -0
  146. package/dist-package/packages/runtime/src/editing/dialogue-normalization-service.d.ts +18 -0
  147. package/dist-package/packages/runtime/src/editing/duration-policy.d.ts +3 -0
  148. package/dist-package/packages/runtime/src/editing/edit-service.d.ts +44 -0
  149. package/dist-package/packages/runtime/src/editing/edit-service.js +76 -10
  150. package/dist-package/packages/runtime/src/editing/filler-removal-service.d.ts +23 -0
  151. package/dist-package/packages/runtime/src/editing/intent.d.ts +97 -0
  152. package/dist-package/packages/runtime/src/editing/music-service.d.ts +9 -0
  153. package/dist-package/packages/runtime/src/index.d.ts +32 -0
  154. package/dist-package/packages/runtime/src/index.js +2 -0
  155. package/dist-package/packages/runtime/src/planning/rough-cut.d.ts +3 -0
  156. package/dist-package/packages/runtime/src/render/render-and-verify.d.ts +71 -0
  157. package/dist-package/packages/runtime/src/render/render-contract.d.ts +96 -0
  158. package/dist-package/packages/runtime/src/runtime.d.ts +85 -0
  159. package/dist-package/packages/runtime/src/runtime.js +16 -7
  160. package/dist-package/packages/runtime/src/skills/builtin.d.ts +2 -0
  161. package/dist-package/packages/runtime/src/skills/index.d.ts +3 -0
  162. package/dist-package/packages/runtime/src/skills/registry.d.ts +10 -0
  163. package/dist-package/packages/runtime/src/skills/requirements.d.ts +38 -0
  164. package/dist-package/packages/runtime/src/skills/runtime.d.ts +38 -0
  165. package/dist-package/packages/runtime/src/speech/analysis.d.ts +18 -0
  166. package/dist-package/packages/runtime/src/speech/analysis.js +67 -0
  167. package/dist-package/packages/runtime/src/speech/filler-detector.d.ts +49 -0
  168. package/dist-package/packages/runtime/src/speech/filler-removal.d.ts +37 -0
  169. package/dist-package/packages/runtime/src/speech/mapping.d.ts +56 -0
  170. package/dist-package/packages/runtime/src/speech/mapping.js +27 -4
  171. package/dist-package/packages/runtime/src/speech/safe-cut-resolver.d.ts +52 -0
  172. package/dist-package/packages/runtime/src/timeline/drift-reconciliation.d.ts +42 -0
  173. package/dist-package/packages/runtime/src/timeline/editing-session.d.ts +271 -0
  174. package/dist-package/packages/runtime/src/timeline/editing-session.js +48 -2
  175. package/dist-package/packages/runtime/src/timeline/fast-observation.d.ts +77 -0
  176. package/dist-package/packages/runtime/src/timeline/rational-time.d.ts +11 -0
  177. package/dist-package/packages/runtime/src/timeline/reorder-preview.d.ts +32 -0
  178. package/dist-package/packages/runtime/src/timeline/reorder-preview.js +202 -0
  179. package/dist-package/packages/runtime/src/timeline/snapshot-diff.d.ts +3 -0
  180. package/dist-package/packages/runtime/src/timeline/snapshot-diff.js +1 -0
  181. package/dist-package/packages/runtime/src/timeline/snapshot-digest.d.ts +3 -0
  182. package/dist-package/packages/runtime/src/timeline/snapshot-digest.js +1 -1
  183. package/dist-package/packages/runtime/src/verification/verification.d.ts +6 -0
  184. package/dist-package/packages/testkit/src/fixture-analyzers.d.ts +37 -0
  185. package/dist-package/packages/testkit/src/in-memory-editor.d.ts +55 -0
  186. package/dist-package/packages/testkit/src/in-memory-editor.js +3 -3
  187. package/dist-package/packages/testkit/src/index.d.ts +4 -0
  188. package/dist-package/packages/testkit/src/index.js +1 -0
  189. package/dist-package/packages/testkit/src/sender-lifecycle-fixture.d.ts +47 -0
  190. package/dist-package/packages/testkit/src/sender-lifecycle-fixture.js +192 -0
  191. package/dist-package/packages/testkit/src/skill-fixtures.d.ts +3 -0
  192. package/package.json +41 -14
@@ -0,0 +1,233 @@
1
+ import { ProjectTransactionService, type ContextRevision, type FramekitProjectDocument, type FramekitRenderArtifactVerifier, type FramekitRenderProvider, type FramekitRenderParameters, type LocalMediaRegistrationResult, type LocalMediaMetadataProbe, type ProjectEditCommand, type ProjectEditPreview, type ProjectEditResult, type RoughCutPlan, type TimelineIrEditOperation, type TimelineIr, type TimelineIrResource } from "../../runtime/src/index.js";
2
+ import { type TimelineIrToFcpxmlResult, type TimelineIrToFcpxmlTarget } from "../../../adapters/final-cut/typescript/src/documents.js";
3
+ export interface HeadlessProjectServiceOptions {
4
+ directory: string;
5
+ protectedStateDirectory?: string;
6
+ mediaProbe?: LocalMediaMetadataProbe;
7
+ renderer?: FramekitRenderProvider;
8
+ verifier?: FramekitRenderArtifactVerifier;
9
+ clock?: () => string;
10
+ }
11
+ export type HeadlessProjectEditCommand = Omit<ProjectEditCommand, "target"> & {
12
+ target?: ProjectEditCommand["target"];
13
+ };
14
+ export interface HeadlessProjectWorkflow {
15
+ create(timeline: TimelineIr): Promise<FramekitProjectDocument>;
16
+ list(): Promise<HeadlessProjectSummary[]>;
17
+ open(projectId: string): Promise<FramekitProjectDocument>;
18
+ inspect(projectId: string): Promise<FramekitProjectDocument>;
19
+ registerMedia(projectId: string, sourcePath: string, expectedRevision?: ContextRevision): Promise<LocalMediaRegistrationResult>;
20
+ searchMedia(projectId: string, query: string): Promise<{
21
+ revision: ContextRevision;
22
+ media: TimelineIrResource[];
23
+ }>;
24
+ previewEdit(projectId: string, command: HeadlessProjectEditCommand, sequenceId: string): ReturnType<ProjectTransactionService["preview"]>;
25
+ executeEdit(projectId: string, command: HeadlessProjectEditCommand, sequenceId: string): Promise<ProjectEditResult & {
26
+ undoId: string;
27
+ }>;
28
+ undoEdit(projectId: string, sequenceId: string, undoId: string, expectedRevision: ContextRevision): Promise<HeadlessUndoResult>;
29
+ exportFcpxml(projectId: string, sequenceId: string, expectedRevision: ContextRevision, outputPath: string, target: TimelineIrToFcpxmlTarget): Promise<{
30
+ artifact: {
31
+ path: string;
32
+ digest: string;
33
+ bytes: number;
34
+ verified: true;
35
+ };
36
+ provenance: TimelineIrToFcpxmlResult["provenance"];
37
+ coverage: TimelineIrToFcpxmlResult["coverage"];
38
+ }>;
39
+ previewRoughCut(request: HeadlessRoughCutRequest): Promise<HeadlessRoughCutPreview>;
40
+ executeRoughCut(request: HeadlessRoughCutExecutionRequest): Promise<HeadlessRoughCutExecution>;
41
+ verifyPublishableRoughCut(executionId: string, artifactPath: string, artifactDigest?: string): Promise<HeadlessRoughCutPublishProof>;
42
+ verifyPublishableRoughCutTransaction(request: HeadlessRoughCutPublishVerificationRequest): Promise<HeadlessRoughCutPublishProof>;
43
+ render(projectId: string, sequenceId: string, parameters: FramekitRenderParameters, expectedRevision?: ContextRevision): Promise<HeadlessRenderRecord>;
44
+ inspectRender(renderId: string): Promise<HeadlessRenderRecord>;
45
+ }
46
+ export interface HeadlessProjectSummary {
47
+ projectId: string;
48
+ projectName: string;
49
+ sequenceId: string;
50
+ sequenceName: string;
51
+ revision: ContextRevision;
52
+ path: string;
53
+ }
54
+ export interface HeadlessUndoResult {
55
+ project: FramekitProjectDocument;
56
+ verification: {
57
+ verified: true;
58
+ expectedDigest: string;
59
+ observedDigest: string;
60
+ };
61
+ }
62
+ export interface HeadlessRenderRecord {
63
+ renderId: string;
64
+ projectId: string;
65
+ sequenceId: string;
66
+ requestedRevision: ContextRevision;
67
+ createdAt: string;
68
+ status: "passed" | "failed" | "unavailable";
69
+ outcome: unknown;
70
+ }
71
+ export interface HeadlessRoughCutRequest {
72
+ projectId: string;
73
+ sequenceId: string;
74
+ plan: RoughCutPlan;
75
+ operations?: TimelineIrEditOperation[];
76
+ sourceAudioPolicy?: "preserve-and-mix";
77
+ render: FramekitRenderParameters;
78
+ fcpxml: {
79
+ path: string;
80
+ target: TimelineIrToFcpxmlTarget;
81
+ overwrite?: boolean;
82
+ };
83
+ }
84
+ export interface HeadlessRoughCutExecutionRequest extends HeadlessRoughCutRequest {
85
+ approved: boolean;
86
+ planDigest: string;
87
+ }
88
+ export interface HeadlessRoughCutShotProvenance {
89
+ order: number;
90
+ occurrenceId: string;
91
+ mediaId: string;
92
+ sourceIdentity: RoughCutPlan["shots"][number]["sourceIdentity"];
93
+ sourceRange: RoughCutPlan["shots"][number]["range"];
94
+ confidence: number;
95
+ matchedProperties: string[];
96
+ rationale: string;
97
+ evidence?: HeadlessRoughCutSpeechEvidence;
98
+ }
99
+ interface HeadlessRoughCutSpeechEvidence {
100
+ kind: "speech";
101
+ transcript: string;
102
+ wordCount: number;
103
+ averageWordConfidence: number;
104
+ vad?: {
105
+ kind: "speech" | "silence" | "breath" | "laughter" | "noise";
106
+ confidence?: number;
107
+ };
108
+ audio?: {
109
+ integratedLufs?: number;
110
+ truePeakDb?: number;
111
+ silenceMs?: number;
112
+ };
113
+ }
114
+ export interface HeadlessRoughCutPreview extends ProjectEditPreview {
115
+ plan: RoughCutPlan;
116
+ planDigest: string;
117
+ provenance: HeadlessRoughCutShotProvenance[];
118
+ outputIntent: {
119
+ sourceAudioPolicy: "preserve-and-mix";
120
+ render: FramekitRenderParameters;
121
+ fcpxml: {
122
+ path: string;
123
+ target: TimelineIrToFcpxmlTarget;
124
+ overwrite: boolean;
125
+ };
126
+ };
127
+ fcpxml: Pick<TimelineIrToFcpxmlResult, "digest" | "target" | "destination" | "coverage" | "provenance">;
128
+ }
129
+ export interface HeadlessRoughCutExecution extends HeadlessRoughCutPreview {
130
+ executionId: string;
131
+ committed: true;
132
+ render: {
133
+ renderId: string;
134
+ status: "passed";
135
+ outcome: unknown;
136
+ };
137
+ fcpxmlArtifact: {
138
+ path: string;
139
+ digest: string;
140
+ bytes: number;
141
+ verified: true;
142
+ };
143
+ transaction: ProjectEditResult;
144
+ }
145
+ export interface HeadlessRoughCutPublishProof {
146
+ executionId: string;
147
+ sourceTransactionId: string;
148
+ projectId: string;
149
+ sequenceId: string;
150
+ sourceRevision: ContextRevision;
151
+ canonicalRevision: ContextRevision;
152
+ planDigest: string;
153
+ renderId: string;
154
+ artifactPath: string;
155
+ artifactDigest: string;
156
+ sourceAudioPolicy: "preserve-and-mix";
157
+ target: TimelineIrToFcpxmlTarget;
158
+ destination: TimelineIrToFcpxmlResult["destination"];
159
+ coverage: TimelineIrToFcpxmlResult["coverage"];
160
+ provenance: HeadlessRoughCutShotProvenance[];
161
+ targetLibraryUid: string;
162
+ sourceMediaDigests: Array<{
163
+ source: string;
164
+ sha256: string;
165
+ }>;
166
+ }
167
+ export interface HeadlessRoughCutPublishVerificationRequest {
168
+ sourceTransactionId: string;
169
+ artifactPath: string;
170
+ artifactDigest: string;
171
+ }
172
+ export declare class HeadlessProjectService implements HeadlessProjectWorkflow {
173
+ private readonly directory;
174
+ private readonly protectedStateDirectory;
175
+ private readonly mediaProbe?;
176
+ private readonly renderer?;
177
+ private readonly verifier?;
178
+ private readonly clock;
179
+ constructor(options: HeadlessProjectServiceOptions);
180
+ create(timeline: TimelineIr): Promise<FramekitProjectDocument>;
181
+ list(): Promise<HeadlessProjectSummary[]>;
182
+ private isInternalRecord;
183
+ open(projectId: string): Promise<FramekitProjectDocument>;
184
+ inspect(projectId: string): Promise<FramekitProjectDocument>;
185
+ registerMedia(projectId: string, sourcePath: string, expectedRevision?: ContextRevision): Promise<LocalMediaRegistrationResult>;
186
+ searchMedia(projectId: string, query: string): Promise<{
187
+ revision: ContextRevision;
188
+ media: TimelineIrResource[];
189
+ }>;
190
+ previewEdit(projectId: string, command: HeadlessProjectEditCommand, sequenceId: string): Promise<ProjectEditPreview>;
191
+ executeEdit(projectId: string, command: HeadlessProjectEditCommand, sequenceId: string): Promise<{
192
+ command: ProjectEditCommand;
193
+ before: FramekitProjectDocument;
194
+ after: FramekitProjectDocument;
195
+ diff: import("../../runtime/src/index.js").ProjectEditDiff;
196
+ changedOccurrenceIds: string[];
197
+ changedMarkerIds: string[];
198
+ changedTitleIds: string[];
199
+ changedTransitionIds: string[];
200
+ committed: true;
201
+ undoId: string;
202
+ }>;
203
+ undoEdit(projectId: string, sequenceId: string, undoId: string, expectedRevision: ContextRevision): Promise<HeadlessUndoResult>;
204
+ exportFcpxml(projectId: string, sequenceId: string, expectedRevision: ContextRevision, outputPath: string, target: TimelineIrToFcpxmlTarget): Promise<{
205
+ artifact: {
206
+ path: string;
207
+ digest: string;
208
+ bytes: number;
209
+ verified: true;
210
+ };
211
+ provenance: import("../../../adapters/final-cut/typescript/src/documents.js").TimelineIrMaterializationProvenance;
212
+ coverage: import("../../../adapters/final-cut/typescript/src/documents.js").TimelineIrMaterializationCoverage;
213
+ }>;
214
+ previewRoughCut(request: HeadlessRoughCutRequest): Promise<HeadlessRoughCutPreview>;
215
+ executeRoughCut(request: HeadlessRoughCutExecutionRequest): Promise<HeadlessRoughCutExecution>;
216
+ verifyPublishableRoughCut(executionId: string, artifactPath: string, artifactDigest?: string): Promise<HeadlessRoughCutPublishProof>;
217
+ verifyPublishableRoughCutTransaction(request: HeadlessRoughCutPublishVerificationRequest): Promise<HeadlessRoughCutPublishProof>;
218
+ render(projectId: string, sequenceId: string, parameters: FramekitRenderParameters, expectedRevision?: ContextRevision): Promise<HeadlessRenderRecord>;
219
+ inspectRender(renderId: string): Promise<HeadlessRenderRecord>;
220
+ private assertOutputSeparation;
221
+ private store;
222
+ private snapshotStore;
223
+ private projectPath;
224
+ private executionPath;
225
+ private approvalPath;
226
+ private saveRender;
227
+ private saveRoughCutExecution;
228
+ private saveRoughCutApproval;
229
+ private readRoughCutApproval;
230
+ private prepareRoughCut;
231
+ private previewPreparedRoughCut;
232
+ }
233
+ export {};