@morshoto/framekit 0.2.2 → 0.2.4

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 (160) hide show
  1. package/dist-package/adapters/final-cut/typescript/src/analyzers.d.ts +58 -0
  2. package/dist-package/adapters/final-cut/typescript/src/analyzers.js +52 -13
  3. package/dist-package/adapters/final-cut/typescript/src/assets.d.ts +24 -0
  4. package/dist-package/adapters/final-cut/typescript/src/background-export.d.ts +98 -0
  5. package/dist-package/adapters/final-cut/typescript/src/background-materialization.d.ts +47 -0
  6. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.d.ts +32 -0
  7. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery.d.ts +22 -0
  8. package/dist-package/adapters/final-cut/typescript/src/canonical-verification.d.ts +11 -0
  9. package/dist-package/adapters/final-cut/typescript/src/canonical.d.ts +184 -0
  10. package/dist-package/adapters/final-cut/typescript/src/canonical.js +33 -1
  11. package/dist-package/adapters/final-cut/typescript/src/connection.d.ts +103 -0
  12. package/dist-package/adapters/final-cut/typescript/src/disposable-native.d.ts +90 -0
  13. package/dist-package/adapters/final-cut/typescript/src/documents.d.ts +3 -0
  14. package/dist-package/adapters/final-cut/typescript/src/documents.js +3 -0
  15. package/dist-package/adapters/final-cut/typescript/src/experimental.d.ts +8 -0
  16. package/dist-package/adapters/final-cut/typescript/src/export.d.ts +125 -0
  17. package/dist-package/adapters/final-cut/typescript/src/fcpxml-console-experiment.d.ts +54 -0
  18. package/dist-package/adapters/final-cut/typescript/src/fcpxml.d.ts +75 -0
  19. package/dist-package/adapters/final-cut/typescript/src/fcpxml.js +6 -1
  20. package/dist-package/adapters/final-cut/typescript/src/index.d.ts +22 -0
  21. package/dist-package/adapters/final-cut/typescript/src/library-inspection.d.ts +101 -0
  22. package/dist-package/adapters/final-cut/typescript/src/live.d.ts +101 -0
  23. package/dist-package/adapters/final-cut/typescript/src/live.js +8 -0
  24. package/dist-package/adapters/final-cut/typescript/src/media.d.ts +12 -0
  25. package/dist-package/adapters/final-cut/typescript/src/native-operation.d.ts +6 -0
  26. package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.d.ts +77 -0
  27. package/dist-package/adapters/final-cut/typescript/src/native-session.d.ts +130 -0
  28. package/dist-package/adapters/final-cut/typescript/src/native.d.ts +828 -0
  29. package/dist-package/adapters/final-cut/typescript/src/native.js +274 -107
  30. package/dist-package/adapters/final-cut/typescript/src/pasteboard-snapshot.d.ts +114 -0
  31. package/dist-package/adapters/final-cut/typescript/src/publish-readback.d.ts +26 -0
  32. package/dist-package/adapters/final-cut/typescript/src/publish-readback.js +18 -2
  33. package/dist-package/adapters/final-cut/typescript/src/publisher.d.ts +215 -0
  34. package/dist-package/adapters/final-cut/typescript/src/session.d.ts +43 -0
  35. package/dist-package/adapters/final-cut/typescript/src/shadow-mutation.d.ts +51 -0
  36. package/dist-package/adapters/final-cut/typescript/src/sqlite-experiment.d.ts +156 -0
  37. package/dist-package/adapters/final-cut/typescript/src/sqlite-inspection.d.ts +134 -0
  38. package/dist-package/adapters/final-cut/typescript/src/sqlite-materialization.d.ts +110 -0
  39. package/dist-package/adapters/final-cut/typescript/src/sqlite-wal-observation.d.ts +132 -0
  40. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.d.ts +61 -0
  41. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.js +28 -4
  42. package/dist-package/adapters/final-cut/typescript/src/unattended-editing.d.ts +54 -0
  43. package/dist-package/adapters/headless/typescript/src/audio-output.d.ts +3 -0
  44. package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.d.ts +11 -0
  45. package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.js +26 -2
  46. package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.d.ts +27 -0
  47. package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.js +7 -2
  48. package/dist-package/adapters/headless/typescript/src/ffmpeg-storyboard.d.ts +28 -0
  49. package/dist-package/adapters/headless/typescript/src/ffmpeg-storyboard.js +120 -0
  50. package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.d.ts +15 -0
  51. package/dist-package/adapters/headless/typescript/src/index.d.ts +4 -0
  52. package/dist-package/adapters/headless/typescript/src/index.js +1 -0
  53. package/dist-package/apps/cli/src/dev-doctor.d.ts +25 -0
  54. package/dist-package/apps/cli/src/headless-projects.d.ts +3 -0
  55. package/dist-package/apps/cli/src/main.d.ts +10 -0
  56. package/dist-package/apps/mcp-server/runtime/ffmpeg-audio-backend.py +129 -0
  57. package/dist-package/apps/mcp-server/runtime/whisper-speech-backend.py +92 -2
  58. package/dist-package/apps/mcp-server/src/build-alignment.d.ts +10 -0
  59. package/dist-package/apps/mcp-server/src/build-identity.d.ts +7 -0
  60. package/dist-package/apps/mcp-server/src/build-identity.json +2 -2
  61. package/dist-package/apps/mcp-server/src/canonical-native-snapshot.d.ts +8 -0
  62. package/dist-package/apps/mcp-server/src/final-cut-runtime-config.d.ts +5 -0
  63. package/dist-package/apps/mcp-server/src/headless-project-snapshot.d.ts +3 -0
  64. package/dist-package/apps/mcp-server/src/headless-sessions.d.ts +89 -0
  65. package/dist-package/apps/mcp-server/src/main.d.ts +1 -0
  66. package/dist-package/apps/mcp-server/src/main.js +2 -1
  67. package/dist-package/apps/mcp-server/src/materialization-jobs.d.ts +204 -0
  68. package/dist-package/apps/mcp-server/src/readback-policy.d.ts +18 -0
  69. package/dist-package/apps/mcp-server/src/routing.d.ts +90 -0
  70. package/dist-package/apps/mcp-server/src/server.d.ts +75 -0
  71. package/dist-package/apps/mcp-server/src/server.js +93 -9
  72. package/dist-package/apps/mcp-server/src/tools/skills/catalog.d.ts +19 -0
  73. package/dist-package/apps/mcp-server/src/tools/skills/metadata.d.ts +37 -0
  74. package/dist-package/apps/mcp-server/src/tools/skills/register.d.ts +11 -0
  75. package/dist-package/apps/mcp-server/src/version.d.ts +4 -0
  76. package/dist-package/packages/headless-application/src/external-edit.d.ts +30 -0
  77. package/dist-package/packages/headless-application/src/external-edit.js +72 -0
  78. package/dist-package/packages/headless-application/src/headless-projects.d.ts +259 -0
  79. package/dist-package/packages/headless-application/src/headless-projects.js +15 -2
  80. package/dist-package/packages/headless-application/src/index.d.ts +2 -0
  81. package/dist-package/packages/headless-application/src/index.js +1 -0
  82. package/dist-package/packages/runtime/src/application/duration-policy-service.d.ts +4 -0
  83. package/dist-package/packages/runtime/src/application/local-media.d.ts +46 -0
  84. package/dist-package/packages/runtime/src/application/media-analysis-service.d.ts +40 -0
  85. package/dist-package/packages/runtime/src/application/media-analysis-service.js +105 -15
  86. package/dist-package/packages/runtime/src/application/project-service.d.ts +35 -0
  87. package/dist-package/packages/runtime/src/application/project-store.d.ts +56 -0
  88. package/dist-package/packages/runtime/src/application/project-transactions.d.ts +51 -0
  89. package/dist-package/packages/runtime/src/application/runtime-options.d.ts +15 -0
  90. package/dist-package/packages/runtime/src/application/semantic-media-index-store.d.ts +28 -0
  91. package/dist-package/packages/runtime/src/application/transaction-store.d.ts +10 -0
  92. package/dist-package/packages/runtime/src/audio/analysis.d.ts +3 -0
  93. package/dist-package/packages/runtime/src/audio/analysis.js +95 -0
  94. package/dist-package/packages/runtime/src/audio/dialogue-normalization.d.ts +47 -0
  95. package/dist-package/packages/runtime/src/audio/noise-reduction.d.ts +34 -0
  96. package/dist-package/packages/runtime/src/capabilities.d.ts +45 -0
  97. package/dist-package/packages/runtime/src/color-correction.d.ts +33 -0
  98. package/dist-package/packages/runtime/src/context/context-engine.d.ts +28 -0
  99. package/dist-package/packages/runtime/src/context/context-service.d.ts +20 -0
  100. package/dist-package/packages/runtime/src/context/project-catalog.d.ts +12 -0
  101. package/dist-package/packages/runtime/src/context/revision.d.ts +2 -0
  102. package/dist-package/packages/runtime/src/domain/capabilities.d.ts +170 -0
  103. package/dist-package/packages/runtime/src/domain/context.d.ts +179 -0
  104. package/dist-package/packages/runtime/src/domain/diff.d.ts +104 -0
  105. package/dist-package/packages/runtime/src/domain/duration.d.ts +63 -0
  106. package/dist-package/packages/runtime/src/domain/editing.d.ts +227 -0
  107. package/dist-package/packages/runtime/src/domain/incremental-sync.d.ts +67 -0
  108. package/dist-package/packages/runtime/src/domain/index.d.ts +14 -0
  109. package/dist-package/packages/runtime/src/domain/media.d.ts +406 -0
  110. package/dist-package/packages/runtime/src/domain/ports.d.ts +62 -0
  111. package/dist-package/packages/runtime/src/domain/primitives.d.ts +21 -0
  112. package/dist-package/packages/runtime/src/domain/project.d.ts +119 -0
  113. package/dist-package/packages/runtime/src/domain/rough-cut.d.ts +27 -0
  114. package/dist-package/packages/runtime/src/domain/skills.d.ts +145 -0
  115. package/dist-package/packages/runtime/src/domain/timeline-target.d.ts +57 -0
  116. package/dist-package/packages/runtime/src/domain/timeline-target.js +19 -1
  117. package/dist-package/packages/runtime/src/domain/types.d.ts +5 -0
  118. package/dist-package/packages/runtime/src/domain/verification.d.ts +92 -0
  119. package/dist-package/packages/runtime/src/editing/dialogue-normalization-service.d.ts +18 -0
  120. package/dist-package/packages/runtime/src/editing/duration-policy.d.ts +3 -0
  121. package/dist-package/packages/runtime/src/editing/edit-service.d.ts +44 -0
  122. package/dist-package/packages/runtime/src/editing/filler-removal-service.d.ts +23 -0
  123. package/dist-package/packages/runtime/src/editing/intent.d.ts +97 -0
  124. package/dist-package/packages/runtime/src/editing/music-service.d.ts +9 -0
  125. package/dist-package/packages/runtime/src/index.d.ts +32 -0
  126. package/dist-package/packages/runtime/src/index.js +1 -0
  127. package/dist-package/packages/runtime/src/planning/rough-cut.d.ts +3 -0
  128. package/dist-package/packages/runtime/src/render/render-and-verify.d.ts +71 -0
  129. package/dist-package/packages/runtime/src/render/render-contract.d.ts +96 -0
  130. package/dist-package/packages/runtime/src/runtime.d.ts +85 -0
  131. package/dist-package/packages/runtime/src/skills/builtin.d.ts +2 -0
  132. package/dist-package/packages/runtime/src/skills/index.d.ts +3 -0
  133. package/dist-package/packages/runtime/src/skills/registry.d.ts +10 -0
  134. package/dist-package/packages/runtime/src/skills/requirements.d.ts +38 -0
  135. package/dist-package/packages/runtime/src/skills/runtime.d.ts +38 -0
  136. package/dist-package/packages/runtime/src/speech/analysis.d.ts +18 -0
  137. package/dist-package/packages/runtime/src/speech/analysis.js +67 -0
  138. package/dist-package/packages/runtime/src/speech/filler-detector.d.ts +49 -0
  139. package/dist-package/packages/runtime/src/speech/filler-removal.d.ts +37 -0
  140. package/dist-package/packages/runtime/src/speech/mapping.d.ts +56 -0
  141. package/dist-package/packages/runtime/src/speech/mapping.js +27 -4
  142. package/dist-package/packages/runtime/src/speech/safe-cut-resolver.d.ts +52 -0
  143. package/dist-package/packages/runtime/src/timeline/drift-reconciliation.d.ts +42 -0
  144. package/dist-package/packages/runtime/src/timeline/editing-session.d.ts +271 -0
  145. package/dist-package/packages/runtime/src/timeline/editing-session.js +32 -2
  146. package/dist-package/packages/runtime/src/timeline/fast-observation.d.ts +77 -0
  147. package/dist-package/packages/runtime/src/timeline/rational-time.d.ts +11 -0
  148. package/dist-package/packages/runtime/src/timeline/reorder-preview.d.ts +32 -0
  149. package/dist-package/packages/runtime/src/timeline/reorder-preview.js +202 -0
  150. package/dist-package/packages/runtime/src/timeline/snapshot-diff.d.ts +3 -0
  151. package/dist-package/packages/runtime/src/timeline/snapshot-diff.js +1 -0
  152. package/dist-package/packages/runtime/src/timeline/snapshot-digest.d.ts +3 -0
  153. package/dist-package/packages/runtime/src/timeline/snapshot-digest.js +1 -1
  154. package/dist-package/packages/runtime/src/verification/verification.d.ts +6 -0
  155. package/dist-package/packages/testkit/src/fixture-analyzers.d.ts +37 -0
  156. package/dist-package/packages/testkit/src/in-memory-editor.d.ts +55 -0
  157. package/dist-package/packages/testkit/src/index.d.ts +4 -0
  158. package/dist-package/packages/testkit/src/sender-lifecycle-fixture.d.ts +47 -0
  159. package/dist-package/packages/testkit/src/skill-fixtures.d.ts +3 -0
  160. package/package.json +17 -12
@@ -0,0 +1,114 @@
1
+ import { type FastTimelineObservation } from "../../../../packages/runtime/src/index.js";
2
+ import type { ContextRevision } from "../../../../packages/runtime/src/index.js";
3
+ import { type FinalCutKeyedArchiveJsonDecoder, type ParsedFinalCutKeyedArchive } from "./sqlite-experiment.js";
4
+ export declare const FINAL_CUT_PASTEBOARD_UTI: "com.apple.flexo.proFFPasteboardUTI";
5
+ export type FinalCutPasteboardCoverage = "complete" | "partial" | "unavailable";
6
+ export interface FinalCutPasteboardTarget {
7
+ projectId: string;
8
+ sequenceId: string;
9
+ }
10
+ export interface FinalCutPasteboardSideEffects {
11
+ foregroundActivated: boolean | "unknown";
12
+ selectionChanged: boolean | "unknown";
13
+ clipboardChanged: boolean | "unknown";
14
+ clipboardRestored: boolean | "unknown";
15
+ focusRestored: boolean | "unknown";
16
+ }
17
+ export interface FinalCutPasteboardObservationInput {
18
+ uti: string;
19
+ sourceVersion: string;
20
+ /** Decoded, sanitized payload supplied by the explicit acquisition boundary. */
21
+ payload: unknown;
22
+ target: FinalCutPasteboardTarget;
23
+ sideEffects: FinalCutPasteboardSideEffects;
24
+ }
25
+ export interface FinalCutPasteboardItem {
26
+ occurrenceId: string;
27
+ resourceId: string;
28
+ start: number;
29
+ duration: number;
30
+ lane: number;
31
+ role?: string;
32
+ }
33
+ export interface FinalCutPasteboardObservation {
34
+ provider: "final-cut-pasteboard";
35
+ canonical: false;
36
+ target: FinalCutPasteboardTarget;
37
+ sideEffects: FinalCutPasteboardSideEffects;
38
+ provenance: {
39
+ uti: typeof FINAL_CUT_PASTEBOARD_UTI;
40
+ sourceVersion: string;
41
+ };
42
+ payloadDigest: string;
43
+ items: FinalCutPasteboardItem[];
44
+ anchoredItems: FinalCutPasteboardItem[];
45
+ unknownFields: string[];
46
+ coverage: {
47
+ containers: FinalCutPasteboardCoverage;
48
+ occurrences: FinalCutPasteboardCoverage;
49
+ sourceBindings: FinalCutPasteboardCoverage;
50
+ timing: FinalCutPasteboardCoverage;
51
+ anchoredItems: FinalCutPasteboardCoverage;
52
+ };
53
+ }
54
+ export interface FinalCutPasteboardTimelineNormalizationOptions {
55
+ framekitRevision: ContextRevision;
56
+ artifactDigest: string;
57
+ providerRevision: ContextRevision;
58
+ observedAt: string;
59
+ projectName: string;
60
+ sequenceName: string;
61
+ timeUnit: "frames" | "seconds";
62
+ timescale: number;
63
+ sequenceDuration?: number;
64
+ }
65
+ export type FinalCutPasteboardCaptureStatus = "captured" | "user-interaction-required" | "unsupported" | "failed";
66
+ export interface FinalCutPasteboardCaptureRequest {
67
+ target: FinalCutPasteboardTarget;
68
+ /** Must be explicit because Select All -> Copy changes focus, selection, and clipboard state. */
69
+ allowInteraction: boolean;
70
+ restoreClipboard: boolean;
71
+ }
72
+ export interface FinalCutPasteboardCaptureResult {
73
+ status: FinalCutPasteboardCaptureStatus;
74
+ route: "headed-pasteboard-copy";
75
+ target: {
76
+ requested: FinalCutPasteboardTarget;
77
+ observed?: FinalCutPasteboardTarget;
78
+ guarantee: "requested-and-observed" | "requested-unverified" | "unavailable";
79
+ };
80
+ sideEffects: FinalCutPasteboardSideEffects;
81
+ /** A decoded payload is required before the observation can be normalized. */
82
+ payload?: unknown;
83
+ payloadDigest?: string;
84
+ error?: {
85
+ code: string;
86
+ message: string;
87
+ };
88
+ }
89
+ export interface FinalCutPasteboardCapturePort {
90
+ capture(request: FinalCutPasteboardCaptureRequest): Promise<FinalCutPasteboardCaptureResult>;
91
+ }
92
+ export interface FinalCutPasteboardProviderOptions {
93
+ sourceVersion: string;
94
+ capture?: FinalCutPasteboardCapturePort;
95
+ }
96
+ export type FinalCutPasteboardProviderResult = FinalCutPasteboardObservation | FinalCutPasteboardCaptureResult;
97
+ /**
98
+ * Experimental, non-canonical fallback. Without an explicit headed acquisition
99
+ * port this provider is unavailable; it never turns caller-supplied data into
100
+ * evidence of a live Final Cut read by itself.
101
+ */
102
+ export declare class FinalCutPasteboardProvider {
103
+ private readonly sourceVersion;
104
+ private readonly capture?;
105
+ constructor(options: FinalCutPasteboardProviderOptions);
106
+ observe(request: FinalCutPasteboardCaptureRequest): Promise<FinalCutPasteboardProviderResult>;
107
+ }
108
+ export declare function decodeFinalCutPasteboardArchive(payload: Uint8Array, decoder?: FinalCutKeyedArchiveJsonDecoder): Promise<{
109
+ payloadDigest: string;
110
+ archive: ParsedFinalCutKeyedArchive;
111
+ }>;
112
+ export declare function decodeFinalCutPasteboardObservation(input: FinalCutPasteboardObservationInput): FinalCutPasteboardObservation;
113
+ /** Convert only the fields the pasteboard decoder actually proved into the runtime envelope. */
114
+ export declare function normalizeFinalCutPasteboardObservation(input: FinalCutPasteboardObservation, options: FinalCutPasteboardTimelineNormalizationOptions): FastTimelineObservation;
@@ -0,0 +1,26 @@
1
+ import type { ProjectSnapshot } from "../../../../packages/runtime/src/index.js";
2
+ export declare const FINAL_CUT_PUBLISH_READBACK_CHECKS: readonly ["project-and-sequence-names", "timeline-duration-and-frame-rate", "clip-order-and-source-ranges", "editable-title-content-and-timing", "connected-audio-source-role-gain-and-timing", "other-timeline-elements", "markers-and-captions", "source-media-bindings"];
3
+ export interface FinalCutPublishReadbackEvidence {
4
+ verified: true;
5
+ expectedDigest: string;
6
+ observedDigest: string;
7
+ checked: typeof FINAL_CUT_PUBLISH_READBACK_CHECKS[number][];
8
+ }
9
+ export declare class FinalCutPublishSemanticMismatchError extends Error {
10
+ readonly expectedDigest: string;
11
+ readonly observedDigest: string;
12
+ readonly mismatchedChecks: string[];
13
+ readonly code = "FINAL_CUT_PUBLISH_SEMANTIC_MISMATCH";
14
+ constructor(expectedDigest: string, observedDigest: string, mismatchedChecks: string[]);
15
+ }
16
+ type SourceMediaDigest = Readonly<{
17
+ source: string;
18
+ sha256: string;
19
+ }>;
20
+ type PublishReadbackOptions = Readonly<{
21
+ expectedSourceMediaDigests: readonly SourceMediaDigest[];
22
+ actualSourceMediaDigests: readonly SourceMediaDigest[];
23
+ }>;
24
+ /** Compare supported native timeline semantics while ignoring generated native IDs and revisions. */
25
+ export declare function verifyFinalCutPublishReadback(expected: ProjectSnapshot, actual: ProjectSnapshot, options?: PublishReadbackOptions): FinalCutPublishReadbackEvidence;
26
+ export {};
@@ -60,7 +60,10 @@ function publishTimelineSignature(snapshot, sourceMediaDigests) {
60
60
  }
61
61
  return `sha256:${sha256}`;
62
62
  };
63
- const sourceByMediaId = new Map(referencedMedia.map(({ mediaId, source }) => [mediaId, sourceIdentity(source)]));
63
+ const sourceByMediaId = new Map(referencedMedia.map(({ mediaId, source, sourceRange }) => {
64
+ const identity = sourceIdentity(source);
65
+ return [mediaId, sourceRange === undefined ? identity : { source: identity, sourceRange: sourceRangeSignature(sourceRange) }];
66
+ }));
64
67
  const audioMediaIds = new Set(referencedMedia.filter(({ mediaKind }) => mediaKind === "audio").map(({ mediaId }) => mediaId));
65
68
  const mediaSource = (mediaId) => {
66
69
  if (mediaId === undefined)
@@ -71,7 +74,10 @@ function publishTimelineSignature(snapshot, sourceMediaDigests) {
71
74
  const titles = snapshot.timeline.storyElements.filter(({ kind }) => kind === "title");
72
75
  const audioClips = clips.filter((clip) => isAudioClip(clip, audioMediaIds));
73
76
  const mediaBindings = referencedMedia
74
- .map(({ source, mediaKind, duration }) => ({ source: sourceIdentity(source), mediaKind, duration }))
77
+ .map(({ source, mediaKind, duration, sourceRange }) => ({
78
+ source: sourceIdentity(source), mediaKind, duration,
79
+ ...(sourceRange !== undefined ? { sourceRange: sourceRangeSignature(sourceRange) } : {}),
80
+ }))
75
81
  .sort((left, right) => compareText(stableJson(left), stableJson(right)));
76
82
  const representedStoryKinds = new Set(["asset-clip", "audio", "clip", "mc-clip", "ref-clip", "sync-clip", "title", "video"]);
77
83
  return {
@@ -186,6 +192,16 @@ function rationalSignature(value) {
186
192
  const divisor = greatestCommonDivisor(signedNumerator, positiveDenominator);
187
193
  return `${signedNumerator / divisor}/${positiveDenominator / divisor}`;
188
194
  }
195
+ function sourceRangeSignature(range) {
196
+ const validTime = (time) => Boolean(time
197
+ && typeof time.value === "string" && /^-?\d+$/.test(time.value)
198
+ && typeof time.timescale === "string" && /^\d+$/.test(time.timescale)
199
+ && BigInt(time.timescale) > 0n);
200
+ if (!range || !validTime(range.start) || !validTime(range.duration) || BigInt(range.duration.value) <= 0n) {
201
+ throw new Error("FINAL_CUT_PUBLISH_READBACK_INVALID: source range must have valid bounds and positive duration");
202
+ }
203
+ return { start: rationalSignature(range.start), duration: rationalSignature(range.duration) };
204
+ }
189
205
  function zeroRational() {
190
206
  return { value: "0", timescale: "1" };
191
207
  }
@@ -0,0 +1,215 @@
1
+ import type { EditorLiveState, ProjectSnapshot } from "../../../../packages/runtime/src/index.js";
2
+ import { type FinalCutPublishReadbackEvidence } from "./publish-readback.js";
3
+ import type { FinalCutFcpxmlDelivery } from "./live.js";
4
+ export interface FinalCutPublishSourceMediaDigest {
5
+ source: string;
6
+ sha256: string;
7
+ }
8
+ export interface FinalCutProjectPublishDelivery {
9
+ status: "dispatched";
10
+ route: "background-document-open" | "headed-apple-event";
11
+ requestedActivates: boolean;
12
+ activation: FinalCutFcpxmlDelivery["activation"];
13
+ ui: FinalCutFcpxmlDelivery["ui"];
14
+ target: FinalCutFcpxmlDelivery["target"];
15
+ }
16
+ export interface FinalCutProjectPublishResult {
17
+ sourceTransactionId: string;
18
+ sourcePath: string;
19
+ sourceTarget: {
20
+ kind: "artifact";
21
+ artifactPath: string;
22
+ };
23
+ importedPath: string;
24
+ projectName: string;
25
+ createdTarget: {
26
+ kind: "editor.project";
27
+ projectId: string;
28
+ sequenceId: string;
29
+ libraryId?: string;
30
+ eventId?: string;
31
+ libraryPath?: string;
32
+ projectName: string;
33
+ sequenceName?: string;
34
+ };
35
+ activeProject: {
36
+ before?: {
37
+ id: string;
38
+ name: string;
39
+ };
40
+ after?: {
41
+ id: string;
42
+ name: string;
43
+ };
44
+ changed?: boolean;
45
+ };
46
+ verified: boolean;
47
+ importedDigest: string;
48
+ semanticReadback: FinalCutPublishReadbackEvidence;
49
+ sourceMediaIntegrity: {
50
+ unchanged: true;
51
+ digests: FinalCutPublishSourceMediaDigest[];
52
+ };
53
+ targetLibraryPath?: string;
54
+ liveProject?: string;
55
+ liveSequence?: string;
56
+ delivery?: FinalCutProjectPublishDelivery;
57
+ }
58
+ export interface FinalCutProjectPublishRequest {
59
+ sourceTransactionId: string;
60
+ artifactPath: string;
61
+ artifactDigest: string;
62
+ targetLibraryPath?: string;
63
+ confirm: boolean;
64
+ confirmVerification?: boolean;
65
+ }
66
+ export interface FinalCutProjectPublishPreparationRequest {
67
+ sourceTransactionId: string;
68
+ artifactPath: string;
69
+ artifactDigest: string;
70
+ targetLibraryPath?: string;
71
+ }
72
+ export interface FinalCutProjectPublishTargetBinding {
73
+ projectId: string;
74
+ sequenceId: string;
75
+ libraryId?: string;
76
+ eventId?: string;
77
+ libraryPath?: string;
78
+ }
79
+ export interface FinalCutProjectPublishReadiness {
80
+ available: boolean;
81
+ targetBindingAvailable: boolean;
82
+ reasons: Array<{
83
+ code: string;
84
+ message: string;
85
+ }>;
86
+ }
87
+ export interface FinalCutHeadlessPublishSourceProof {
88
+ targetLibraryUid: string;
89
+ sourceMediaDigests: FinalCutPublishSourceMediaDigest[];
90
+ }
91
+ export type FinalCutProjectPublishJobState = "awaiting-confirmation" | "awaiting-final-cut" | "verification-pending" | "verified" | "failed";
92
+ export type FinalCutProjectPublishJobAction = "confirm" | "confirm-verification" | "retry" | "status" | "none";
93
+ export interface FinalCutProjectPublishJob {
94
+ jobId: string;
95
+ state: FinalCutProjectPublishJobState;
96
+ nextAction: FinalCutProjectPublishJobAction;
97
+ retryable: boolean;
98
+ executionMode: "headed-only" | "background-capable";
99
+ sourceTransactionId: string;
100
+ sourcePath: string;
101
+ sourceTarget: {
102
+ kind: "artifact";
103
+ artifactPath: string;
104
+ };
105
+ artifactDigest: string;
106
+ targetLibraryPath?: string;
107
+ projectName: string;
108
+ sequenceName: string;
109
+ confirmationRequired: boolean;
110
+ handoff: {
111
+ mode: "headed-only" | "background-document-open";
112
+ route: FinalCutProjectPublishRoute;
113
+ backgroundSupported: boolean;
114
+ reason: string;
115
+ };
116
+ /** Dispatch acknowledgement alone does not prove a native project exists. */
117
+ delivery?: FinalCutProjectPublishDelivery;
118
+ /** Matching live target observation; this does not prove semantic readback. */
119
+ observedTarget?: FinalCutProjectPublishTargetBinding;
120
+ createdTarget?: FinalCutProjectPublishResult["createdTarget"];
121
+ result?: FinalCutProjectPublishResult;
122
+ error?: {
123
+ code: string;
124
+ message: string;
125
+ };
126
+ /** Retains an unacknowledged import attempt even if later verification fails differently. */
127
+ dispatchError?: {
128
+ code: string;
129
+ message: string;
130
+ };
131
+ }
132
+ export type FinalCutProjectPublishRoute = "background-document-open" | "headed-apple-event";
133
+ export declare function parseFinalCutProjectPublishRoute(value: string | undefined, backgroundDeliveryAvailable: boolean): FinalCutProjectPublishRoute;
134
+ export interface FinalCutProjectPublisherOptions {
135
+ enabled?: boolean;
136
+ /** Managed FCPXML path for legacy publishing; headless artifacts use request paths. */
137
+ sourcePath?: string;
138
+ /** Persists verified publish jobs so native target identity survives MCP restarts. */
139
+ publishJobDirectory?: string;
140
+ executor?: (script: string) => Promise<string>;
141
+ liveState?: () => Promise<EditorLiveState>;
142
+ /** Reads the exact created target from the requested native library after import. */
143
+ targetBinding?: (targetLibraryPath: string | undefined, identity: {
144
+ projectName: string;
145
+ sequenceName: string;
146
+ }) => Promise<FinalCutProjectPublishTargetBinding>;
147
+ /** Exports the active target through Final Cut for semantic verification. */
148
+ readCanonicalSnapshot?: (targetBinding: FinalCutProjectPublishTargetBinding, identity: {
149
+ projectName: string;
150
+ sequenceName: string;
151
+ }) => Promise<ProjectSnapshot>;
152
+ /** Validates an approved headless rough-cut execution for external artifact paths. */
153
+ headlessSourceVerifier?: (request: FinalCutProjectPublishPreparationRequest) => Promise<FinalCutHeadlessPublishSourceProof>;
154
+ /** Opens the staged FCPXML through the native Workflow Extension bridge. */
155
+ documentDelivery?: {
156
+ deliverFcpxml(request: {
157
+ artifactPath: string;
158
+ targetLibraryLocation?: string;
159
+ activates: boolean;
160
+ }): Promise<FinalCutFcpxmlDelivery>;
161
+ };
162
+ /** Selects the native delivery route before preview and user confirmation. */
163
+ publishRoute?: FinalCutProjectPublishRoute;
164
+ /** Stores publish jobs so verification can resume after an MCP restart. */
165
+ publishJobsDirectory?: string;
166
+ verificationTimeoutMs?: number;
167
+ pollIntervalMs?: number;
168
+ /** @deprecated Use pollIntervalMs. */
169
+ waitMs?: number;
170
+ }
171
+ /** Imports a validated FCPXML artifact as a new Final Cut project. */
172
+ export declare class FinalCutProjectPublisher {
173
+ private readonly dispatchContext;
174
+ private readonly enabled;
175
+ private readonly sourcePath?;
176
+ private readonly publishJobDirectory?;
177
+ private readonly executor;
178
+ private readonly liveState?;
179
+ private readonly targetBinding?;
180
+ private readonly readCanonicalSnapshot?;
181
+ private readonly headlessSourceVerifier?;
182
+ private readonly documentDelivery?;
183
+ private readonly publishRoute;
184
+ private readonly publishJobsDirectory?;
185
+ private readonly verificationTimeoutMs;
186
+ private readonly pollIntervalMs;
187
+ private readonly publishJobs;
188
+ private readonly publishJobRuntime;
189
+ constructor(options: FinalCutProjectPublisherOptions);
190
+ trackNativeDispatch<T>(operation: () => Promise<T>, onDispatch: () => void): Promise<T>;
191
+ isAvailable(): boolean;
192
+ /** Describe configured handoff providers without querying or changing Final Cut. */
193
+ inspectReadiness(): FinalCutProjectPublishReadiness;
194
+ executionMode(): "background-capable" | "headed-only";
195
+ preparePublish(request: FinalCutProjectPublishPreparationRequest): Promise<FinalCutProjectPublishJob>;
196
+ getPublishJob(jobId: string): FinalCutProjectPublishJob;
197
+ loadPublishJob(jobId: string): Promise<FinalCutProjectPublishJob>;
198
+ /** Revalidate a persisted native target against the live catalog and active project. */
199
+ verifyCreatedTarget(jobId: string): Promise<FinalCutProjectPublishResult["createdTarget"]>;
200
+ executePublishJob(jobId: string, confirm: boolean, confirmVerification?: boolean): Promise<FinalCutProjectPublishJob>;
201
+ publishNewProject(request: FinalCutProjectPublishRequest): Promise<FinalCutProjectPublishResult>;
202
+ private readValidatedSource;
203
+ private importAndVerify;
204
+ private resumePublishVerification;
205
+ private markVerified;
206
+ private persistVerifiedPublishJob;
207
+ private publishJobPath;
208
+ private readAndVerifyCanonicalTarget;
209
+ private markAwaitingFinalCut;
210
+ private markFailed;
211
+ private loadPersistedPublishJobs;
212
+ private persistRuntimeForJob;
213
+ private persistImportAttemptBeforeDispatch;
214
+ private persistPublishJob;
215
+ }
@@ -0,0 +1,43 @@
1
+ import type { ContextRevision, CapabilityInspectionOptions, EditOperation, EditorAsset, EditorIdentity, EditorPort, EditorLiveState, EditorChange, AssetSearchQuery, MediaContext, MediaSearchQuery, LiveEditorStatePort, ProjectSnapshot, ProjectCatalog, ProjectSelection, ProjectSelectionResult, RuntimeCapabilities, ManagedArtifact, WorkflowOperation } from "../../../../packages/runtime/src/index.js";
2
+ interface FinalCutSessionOptions {
3
+ snapshot?: EditorPort;
4
+ mutation?: EditorPort;
5
+ live?: LiveEditorStatePort & Partial<Pick<EditorPort, "readProject" | "apply" | "restore" | "previewTransaction" | "applyTransaction" | "withCanonicalReadScope">> & {
6
+ getIdentity(): Promise<EditorIdentity>;
7
+ getCapabilities(options?: CapabilityInspectionOptions): Promise<RuntimeCapabilities>;
8
+ listProjects?(): Promise<ProjectCatalog>;
9
+ selectProject?(selection: ProjectSelection): Promise<ProjectSelectionResult>;
10
+ };
11
+ assets?: Pick<EditorPort, "listAssets">;
12
+ media?: Pick<EditorPort, "listMedia">;
13
+ backgroundCatalog?: {
14
+ listProjects(): Promise<ProjectCatalog>;
15
+ backend?: string;
16
+ };
17
+ }
18
+ /** Composes the independent Final Cut live, snapshot, and mutation surfaces. */
19
+ export declare class FinalCutSessionAdapter implements EditorPort, LiveEditorStatePort {
20
+ private readonly options;
21
+ constructor(options: FinalCutSessionOptions);
22
+ withCanonicalReadScope<T>(operation: () => Promise<T>): Promise<T>;
23
+ getIdentity(): Promise<EditorIdentity>;
24
+ getManagedArtifact(): Promise<ManagedArtifact>;
25
+ getManagedArtifactDigest(): Promise<string | undefined>;
26
+ getCapabilities(options?: CapabilityInspectionOptions): Promise<RuntimeCapabilities>;
27
+ previewTransaction(operations: WorkflowOperation[], expectedRevision: ContextRevision): Promise<ProjectSnapshot>;
28
+ applyTransaction(operations: WorkflowOperation[], expectedRevision: ContextRevision): Promise<void>;
29
+ read(): Promise<ProjectSnapshot>;
30
+ readProject(): Promise<ProjectSnapshot>;
31
+ apply(operation: EditOperation, expectedRevision: ContextRevision): Promise<ContextRevision>;
32
+ restore(snapshot: ProjectSnapshot, expectedRevision: ContextRevision): Promise<void>;
33
+ listAssets(query?: AssetSearchQuery): Promise<EditorAsset[]>;
34
+ listMedia(query?: MediaSearchQuery): Promise<MediaContext[]>;
35
+ listProjects(): Promise<ProjectCatalog>;
36
+ private readBackgroundCatalog;
37
+ selectProject(selection: ProjectSelection): Promise<ProjectSelectionResult>;
38
+ readLiveState(): Promise<EditorLiveState>;
39
+ liveChangesSince(revision: ContextRevision, waitMs?: number): Promise<EditorChange[]>;
40
+ private pureLiveProvider;
41
+ private routedTransactionProvider;
42
+ }
43
+ export {};
@@ -0,0 +1,51 @@
1
+ import { type FinalCutSchemaFingerprint, type FinalCutShadowRecipe } from "./sqlite-experiment.js";
2
+ export interface FinalCutShadowBundle {
3
+ sourceBundlePath: string;
4
+ shadowBundlePath: string;
5
+ sourceDigest: string;
6
+ }
7
+ export interface FinalCutShadowBundleMutatorOptions {
8
+ shadowRoot: string;
9
+ sqliteCommand?: string;
10
+ }
11
+ export interface RenameFinalCutShadowCollectionRequest {
12
+ shadow: FinalCutShadowBundle;
13
+ databaseRelativePath: string;
14
+ collectionPrimaryKey: number;
15
+ expectedOptimisticVersion: number;
16
+ name: string;
17
+ }
18
+ export interface FinalCutShadowMutationResult {
19
+ databasePath: string;
20
+ backupPath: string;
21
+ beforeDigest: string;
22
+ afterDigest: string;
23
+ integrity: "ok";
24
+ }
25
+ export interface ExecuteFinalCutShadowRecipeRequest {
26
+ shadow: FinalCutShadowBundle;
27
+ databaseRelativePath: string;
28
+ expectedFingerprint: FinalCutSchemaFingerprint;
29
+ recipe: FinalCutShadowRecipe;
30
+ }
31
+ /**
32
+ * Experimental writer for disposable shadow copies only. It intentionally has
33
+ * no API for timeline payloads, metadata BLOBs, or arbitrary SQL.
34
+ */
35
+ export declare class FinalCutShadowBundleMutator {
36
+ private readonly options;
37
+ private readonly sqliteCommand;
38
+ constructor(options: FinalCutShadowBundleMutatorOptions);
39
+ createShadow(sourceBundlePath: string): Promise<FinalCutShadowBundle>;
40
+ renameCollection(request: RenameFinalCutShadowCollectionRequest): Promise<FinalCutShadowMutationResult>;
41
+ /**
42
+ * Executes the sole compiler-produced recipe after proving the exact Core
43
+ * Data schema/model cache. This is deliberately not an arbitrary-SQL API.
44
+ */
45
+ executeRecipe(request: ExecuteFinalCutShadowRecipeRequest): Promise<FinalCutShadowMutationResult>;
46
+ /** Read-only exact schema/model fingerprint for a recipe/corpus compatibility gate. */
47
+ fingerprintSchema(shadow: FinalCutShadowBundle, databaseRelativePath: string): Promise<FinalCutSchemaFingerprint>;
48
+ private resolveShadowDatabase;
49
+ private assertRenameSchema;
50
+ private run;
51
+ }
@@ -0,0 +1,156 @@
1
+ /**
2
+ * Experimental evidence contracts for Final Cut's undocumented Core Data
3
+ * stores. These contracts intentionally compile only the already-proven
4
+ * shadow control recipe; they never claim a versioned project is writable.
5
+ */
6
+ export interface FinalCutSchemaFingerprintInput {
7
+ schemaVersion: number;
8
+ tables: ReadonlyArray<{
9
+ name: string;
10
+ sql: string;
11
+ }>;
12
+ modelCache: Uint8Array;
13
+ }
14
+ export interface FinalCutSchemaFingerprint {
15
+ schemaVersion: number;
16
+ sqliteMasterDigest: string;
17
+ modelCacheDigest: string;
18
+ }
19
+ export declare function buildFinalCutSchemaFingerprint(input: FinalCutSchemaFingerprintInput): FinalCutSchemaFingerprint;
20
+ export declare function assertFinalCutSchemaFingerprint(expected: FinalCutSchemaFingerprint, actual: FinalCutSchemaFingerprint): void;
21
+ export interface FinalCutArchiveReference {
22
+ fromObject: number;
23
+ path: string;
24
+ toObject: number;
25
+ }
26
+ export interface ParsedFinalCutKeyedArchive {
27
+ archiver: "NSKeyedArchiver";
28
+ version: number;
29
+ top: unknown;
30
+ objects: unknown[];
31
+ references: FinalCutArchiveReference[];
32
+ }
33
+ export type FinalCutKeyedArchiveJsonDecoder = (payload: Uint8Array) => Promise<unknown>;
34
+ /**
35
+ * Decodes a `bplist00` metadata BLOB through macOS `plutil`. The resulting
36
+ * archive remains evidence only: callers must not re-encode it for mutation.
37
+ */
38
+ export declare function decodeFinalCutKeyedArchive(payload: Uint8Array, decoder?: FinalCutKeyedArchiveJsonDecoder): Promise<ParsedFinalCutKeyedArchive>;
39
+ /** Parse JSON emitted by `plutil -convert json` for an NSKeyedArchiver blob. */
40
+ export declare function parseFinalCutKeyedArchive(value: unknown): ParsedFinalCutKeyedArchive;
41
+ /**
42
+ * Candidate archive encoder for the Phase 5 proof gate. It preserves the
43
+ * decoded `$top`/`$objects` UID graph, but callers must still prove exact bytes
44
+ * against a Final Cut-authored archive before using it for mutation.
45
+ */
46
+ export declare function encodeFinalCutKeyedArchiveWithPythonPlistlib(archive: ParsedFinalCutKeyedArchive): Promise<Uint8Array>;
47
+ export interface FinalCutGroundTruthCollection {
48
+ primaryKey: number;
49
+ type: string;
50
+ optimisticVersion: number;
51
+ name?: string;
52
+ identifier?: string;
53
+ metadataId?: number;
54
+ }
55
+ export interface FinalCutGroundTruthMetadata {
56
+ primaryKey: number;
57
+ collectionPrimaryKey?: number;
58
+ optimisticVersion: number;
59
+ archive: unknown;
60
+ /** SHA-256 of the exact ZDICTIONARYDATA bytes collected before decoding. */
61
+ archiveDigest?: string;
62
+ }
63
+ export interface FinalCutGroundTruthRelationship {
64
+ parentPrimaryKey: number;
65
+ childPrimaryKey: number;
66
+ }
67
+ export interface FinalCutGroundTruthSnapshot {
68
+ fingerprint: FinalCutSchemaFingerprint;
69
+ collections: FinalCutGroundTruthCollection[];
70
+ metadata: FinalCutGroundTruthMetadata[];
71
+ relationships: FinalCutGroundTruthRelationship[];
72
+ }
73
+ export type FinalCutGroundTruthOperation = "project-create" | "project-rename" | "clip-rename" | "marker-add" | "trim";
74
+ export interface FinalCutGroundTruthCapture {
75
+ id: string;
76
+ operation: FinalCutGroundTruthOperation;
77
+ before: FinalCutGroundTruthSnapshot;
78
+ after: FinalCutGroundTruthSnapshot;
79
+ nativeEvidence: "unverified" | "reopen-readback";
80
+ }
81
+ export interface FinalCutGroundTruthCorpus {
82
+ schemaVersion: 1;
83
+ fingerprint: FinalCutSchemaFingerprint;
84
+ captures: FinalCutGroundTruthCapture[];
85
+ }
86
+ export interface FinalCutGroundTruthCollectorOptions {
87
+ sqliteCommand?: string;
88
+ executor?: (databasePath: string, query: string) => Promise<string>;
89
+ archiveDecoder?: FinalCutKeyedArchiveJsonDecoder;
90
+ }
91
+ export interface FinalCutGroundTruthPairOptions {
92
+ id: string;
93
+ operation: FinalCutGroundTruthOperation;
94
+ beforeDatabasePath: string;
95
+ afterDatabasePath: string;
96
+ nativeEvidence?: FinalCutGroundTruthCapture["nativeEvidence"];
97
+ }
98
+ /**
99
+ * Reads a UI-produced before/after event database without changing it. The
100
+ * query deliberately assumes the observed Final Cut Core Data tables; a
101
+ * missing column/table is an unsupported schema, not a partial capture.
102
+ */
103
+ export declare class FinalCutGroundTruthCollector {
104
+ private readonly executor;
105
+ private readonly archiveDecoder;
106
+ constructor(options?: FinalCutGroundTruthCollectorOptions);
107
+ collect(databasePath: string): Promise<FinalCutGroundTruthSnapshot>;
108
+ collectPair(options: FinalCutGroundTruthPairOptions): Promise<FinalCutGroundTruthCapture>;
109
+ }
110
+ /** The only collector SQL: it starts query_only and emits no arbitrary BLOB text. */
111
+ export declare function buildFinalCutGroundTruthSnapshotQuery(): string;
112
+ /** Converts the collector's JSON into a fully decoded, evidence-only snapshot. */
113
+ export declare function parseFinalCutGroundTruthSnapshotResponse(input: string | unknown, decoder?: FinalCutKeyedArchiveJsonDecoder): Promise<FinalCutGroundTruthSnapshot>;
114
+ /** Packages one externally performed UI operation for persistence in a corpus. */
115
+ export declare function createFinalCutGroundTruthCapture(id: string, operation: FinalCutGroundTruthOperation, before: FinalCutGroundTruthSnapshot, after: FinalCutGroundTruthSnapshot, nativeEvidence?: FinalCutGroundTruthCapture["nativeEvidence"]): FinalCutGroundTruthCapture;
116
+ /** Persist corpus evidence without overwriting a prior capture set. */
117
+ export declare function writeFinalCutGroundTruthCorpus(path: string, corpus: FinalCutGroundTruthCorpus): Promise<void>;
118
+ /** Load and validate a corpus against the fixed schema fingerprint. */
119
+ export declare function readFinalCutGroundTruthCorpus(path: string, fingerprint: FinalCutSchemaFingerprint): Promise<FinalCutGroundTruthCorpus>;
120
+ export interface FinalCutGroundTruthDiff {
121
+ collectionChanges: Array<{
122
+ primaryKey: number;
123
+ type: string;
124
+ changed: string[];
125
+ }>;
126
+ relationshipChanges: {
127
+ added: FinalCutGroundTruthRelationship[];
128
+ removed: FinalCutGroundTruthRelationship[];
129
+ };
130
+ archiveChanges: Array<{
131
+ metadataPrimaryKey: number;
132
+ changed: string[];
133
+ }>;
134
+ }
135
+ export declare function diffFinalCutGroundTruthSnapshots(before: FinalCutGroundTruthSnapshot, after: FinalCutGroundTruthSnapshot): FinalCutGroundTruthDiff;
136
+ export declare function validateFinalCutGroundTruthCorpus(corpus: FinalCutGroundTruthCorpus, fingerprint: FinalCutSchemaFingerprint): void;
137
+ export type FinalCutShadowRecipeRequest = {
138
+ kind: "collection-rename-control";
139
+ captureId: string;
140
+ collectionPrimaryKey: number;
141
+ expectedOptimisticVersion: number;
142
+ name: string;
143
+ } | {
144
+ kind: "versioned-project-materialization";
145
+ captureId: string;
146
+ projectName: string;
147
+ sequenceName: string;
148
+ };
149
+ export type FinalCutShadowRecipe = Omit<Extract<FinalCutShadowRecipeRequest, {
150
+ kind: "collection-rename-control";
151
+ }>, "captureId">;
152
+ /**
153
+ * Produces only an allowlisted, observed control recipe. A versioned project
154
+ * requires a reopen-proven archive encoder and is deliberately rejected.
155
+ */
156
+ export declare function compileFinalCutShadowRecipe(corpus: FinalCutGroundTruthCorpus, fingerprint: FinalCutSchemaFingerprint, request: FinalCutShadowRecipeRequest): FinalCutShadowRecipe;