@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.
- package/README.md +17 -12
- package/dist-package/adapters/final-cut/typescript/src/analyzers.d.ts +58 -0
- package/dist-package/adapters/final-cut/typescript/src/analyzers.js +52 -13
- package/dist-package/adapters/final-cut/typescript/src/assets.d.ts +24 -0
- package/dist-package/adapters/final-cut/typescript/src/background-export.d.ts +98 -0
- package/dist-package/adapters/final-cut/typescript/src/background-materialization.d.ts +47 -0
- package/dist-package/adapters/final-cut/typescript/src/background-materialization.js +8 -2
- package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.d.ts +32 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.js +275 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical-recovery.d.ts +22 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical-verification.d.ts +11 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical.d.ts +184 -0
- package/dist-package/adapters/final-cut/typescript/src/canonical.js +571 -78
- package/dist-package/adapters/final-cut/typescript/src/connection.d.ts +103 -0
- package/dist-package/adapters/final-cut/typescript/src/connection.js +6 -1
- package/dist-package/adapters/final-cut/typescript/src/disposable-native.d.ts +90 -0
- package/dist-package/adapters/final-cut/typescript/src/disposable-native.js +6 -0
- package/dist-package/adapters/final-cut/typescript/src/documents.d.ts +3 -0
- package/dist-package/adapters/final-cut/typescript/src/documents.js +3 -0
- package/dist-package/adapters/final-cut/typescript/src/experimental.d.ts +8 -0
- package/dist-package/adapters/final-cut/typescript/src/experimental.js +8 -0
- package/dist-package/adapters/final-cut/typescript/src/export.d.ts +125 -0
- package/dist-package/adapters/final-cut/typescript/src/fcpxml-console-experiment.d.ts +54 -0
- package/dist-package/adapters/final-cut/typescript/src/fcpxml.d.ts +75 -0
- package/dist-package/adapters/final-cut/typescript/src/fcpxml.js +28 -9
- package/dist-package/adapters/final-cut/typescript/src/index.d.ts +22 -0
- package/dist-package/adapters/final-cut/typescript/src/index.js +1 -7
- package/dist-package/adapters/final-cut/typescript/src/library-inspection.d.ts +101 -0
- package/dist-package/adapters/final-cut/typescript/src/live.d.ts +101 -0
- package/dist-package/adapters/final-cut/typescript/src/live.js +35 -2
- package/dist-package/adapters/final-cut/typescript/src/media.d.ts +12 -0
- package/dist-package/adapters/final-cut/typescript/src/native-operation.d.ts +6 -0
- package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.d.ts +77 -0
- package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.js +175 -0
- package/dist-package/adapters/final-cut/typescript/src/native-session.d.ts +130 -0
- package/dist-package/adapters/final-cut/typescript/src/native-session.js +11 -6
- package/dist-package/adapters/final-cut/typescript/src/native.d.ts +828 -0
- package/dist-package/adapters/final-cut/typescript/src/native.js +475 -189
- package/dist-package/adapters/final-cut/typescript/src/pasteboard-snapshot.d.ts +114 -0
- package/dist-package/adapters/final-cut/typescript/src/publish-readback.d.ts +26 -0
- package/dist-package/adapters/final-cut/typescript/src/publish-readback.js +19 -2
- package/dist-package/adapters/final-cut/typescript/src/publisher.d.ts +215 -0
- package/dist-package/adapters/final-cut/typescript/src/publisher.js +255 -14
- package/dist-package/adapters/final-cut/typescript/src/session.d.ts +43 -0
- package/dist-package/adapters/final-cut/typescript/src/session.js +43 -13
- package/dist-package/adapters/final-cut/typescript/src/shadow-mutation.d.ts +51 -0
- package/dist-package/adapters/final-cut/typescript/src/sqlite-experiment.d.ts +156 -0
- package/dist-package/adapters/final-cut/typescript/src/sqlite-inspection.d.ts +134 -0
- package/dist-package/adapters/final-cut/typescript/src/sqlite-materialization.d.ts +110 -0
- package/dist-package/adapters/final-cut/typescript/src/sqlite-wal-observation.d.ts +132 -0
- package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.d.ts +61 -0
- package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.js +31 -5
- package/dist-package/adapters/final-cut/typescript/src/unattended-editing.d.ts +54 -0
- package/dist-package/adapters/headless/typescript/src/audio-output.d.ts +3 -0
- package/dist-package/adapters/headless/typescript/src/audio-output.js +3 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.d.ts +11 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.js +26 -2
- package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.d.ts +25 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.js +37 -14
- package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.d.ts +15 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.js +9 -4
- package/dist-package/adapters/headless/typescript/src/index.d.ts +3 -0
- package/dist-package/apps/cli/src/dev-doctor.d.ts +25 -0
- package/dist-package/apps/cli/src/dev-doctor.js +198 -0
- package/dist-package/apps/cli/src/headless-projects.d.ts +3 -0
- package/dist-package/apps/cli/src/headless-projects.js +5 -0
- package/dist-package/apps/cli/src/main.d.ts +10 -0
- package/dist-package/apps/cli/src/main.js +42 -0
- package/dist-package/apps/mcp-server/runtime/ffmpeg-audio-backend.py +129 -0
- package/dist-package/apps/mcp-server/runtime/speech-analyzer-wrapper.mjs +54 -0
- package/dist-package/apps/mcp-server/runtime/whisper-speech-backend.py +271 -0
- package/dist-package/apps/mcp-server/src/build-alignment.d.ts +10 -0
- package/dist-package/apps/mcp-server/src/build-identity.d.ts +7 -0
- package/dist-package/apps/mcp-server/src/build-identity.json +2 -2
- package/dist-package/apps/mcp-server/src/canonical-native-snapshot.d.ts +8 -0
- package/dist-package/apps/mcp-server/src/canonical-native-snapshot.js +18 -0
- package/dist-package/apps/mcp-server/src/final-cut-runtime-config.d.ts +5 -0
- package/dist-package/apps/mcp-server/src/final-cut-runtime-config.js +3 -0
- package/dist-package/apps/mcp-server/src/headless-project-snapshot.d.ts +3 -0
- package/dist-package/apps/mcp-server/src/headless-sessions.d.ts +89 -0
- package/dist-package/apps/mcp-server/src/main.d.ts +1 -0
- package/dist-package/apps/mcp-server/src/main.js +24 -19
- package/dist-package/apps/mcp-server/src/materialization-jobs.d.ts +204 -0
- package/dist-package/apps/mcp-server/src/materialization-jobs.js +143 -10
- package/dist-package/apps/mcp-server/src/readback-policy.d.ts +18 -0
- package/dist-package/apps/mcp-server/src/routing.d.ts +90 -0
- package/dist-package/apps/mcp-server/src/routing.js +2 -0
- package/dist-package/apps/mcp-server/src/server.d.ts +75 -0
- package/dist-package/apps/mcp-server/src/server.js +813 -158
- package/dist-package/apps/mcp-server/src/tools/skills/catalog.d.ts +19 -0
- package/dist-package/apps/mcp-server/src/tools/skills/catalog.js +142 -0
- package/dist-package/apps/mcp-server/src/tools/skills/metadata.d.ts +37 -0
- package/dist-package/apps/mcp-server/src/tools/skills/metadata.js +71 -0
- package/dist-package/apps/mcp-server/src/tools/skills/register.d.ts +11 -0
- package/dist-package/apps/mcp-server/src/tools/skills/register.js +101 -0
- package/dist-package/apps/mcp-server/src/version.d.ts +4 -0
- package/dist-package/packages/headless-application/src/external-edit.d.ts +30 -0
- package/dist-package/packages/headless-application/src/external-edit.js +72 -0
- package/dist-package/packages/headless-application/src/headless-projects.d.ts +233 -0
- package/dist-package/{apps/mcp-server → packages/headless-application}/src/headless-projects.js +392 -59
- package/dist-package/packages/headless-application/src/index.d.ts +2 -0
- package/dist-package/packages/headless-application/src/index.js +2 -0
- package/dist-package/packages/runtime/src/application/duration-policy-service.d.ts +4 -0
- package/dist-package/packages/runtime/src/application/local-media.d.ts +46 -0
- package/dist-package/packages/runtime/src/application/media-analysis-service.d.ts +40 -0
- package/dist-package/packages/runtime/src/application/media-analysis-service.js +105 -15
- package/dist-package/packages/runtime/src/application/project-service.d.ts +35 -0
- package/dist-package/packages/runtime/src/application/project-service.js +5 -1
- package/dist-package/packages/runtime/src/application/project-store.d.ts +56 -0
- package/dist-package/packages/runtime/src/application/project-store.js +13 -36
- package/dist-package/packages/runtime/src/application/project-transactions.d.ts +51 -0
- package/dist-package/packages/runtime/src/application/runtime-options.d.ts +15 -0
- package/dist-package/packages/runtime/src/application/semantic-media-index-store.d.ts +28 -0
- package/dist-package/packages/runtime/src/application/transaction-store.d.ts +10 -0
- package/dist-package/packages/runtime/src/application/transaction-store.js +1 -1
- package/dist-package/packages/runtime/src/audio/analysis.d.ts +3 -0
- package/dist-package/packages/runtime/src/audio/analysis.js +95 -0
- package/dist-package/packages/runtime/src/audio/dialogue-normalization.d.ts +47 -0
- package/dist-package/packages/runtime/src/audio/noise-reduction.d.ts +34 -0
- package/dist-package/packages/runtime/src/capabilities.d.ts +45 -0
- package/dist-package/packages/runtime/src/capabilities.js +1 -1
- package/dist-package/packages/runtime/src/color-correction.d.ts +33 -0
- package/dist-package/packages/runtime/src/context/context-engine.d.ts +28 -0
- package/dist-package/packages/runtime/src/context/context-engine.js +22 -16
- package/dist-package/packages/runtime/src/context/context-service.d.ts +20 -0
- package/dist-package/packages/runtime/src/context/context-service.js +2 -2
- package/dist-package/packages/runtime/src/context/project-catalog.d.ts +12 -0
- package/dist-package/packages/runtime/src/context/revision.d.ts +2 -0
- package/dist-package/packages/runtime/src/domain/capabilities.d.ts +170 -0
- package/dist-package/packages/runtime/src/domain/context.d.ts +179 -0
- package/dist-package/packages/runtime/src/domain/diff.d.ts +104 -0
- package/dist-package/packages/runtime/src/domain/duration.d.ts +63 -0
- package/dist-package/packages/runtime/src/domain/editing.d.ts +227 -0
- package/dist-package/packages/runtime/src/domain/incremental-sync.d.ts +67 -0
- package/dist-package/packages/runtime/src/domain/index.d.ts +14 -0
- package/dist-package/packages/runtime/src/domain/media.d.ts +406 -0
- package/dist-package/packages/runtime/src/domain/ports.d.ts +62 -0
- package/dist-package/packages/runtime/src/domain/primitives.d.ts +21 -0
- package/dist-package/packages/runtime/src/domain/project.d.ts +119 -0
- package/dist-package/packages/runtime/src/domain/rough-cut.d.ts +27 -0
- package/dist-package/packages/runtime/src/domain/skills.d.ts +145 -0
- package/dist-package/packages/runtime/src/domain/timeline-target.d.ts +57 -0
- package/dist-package/packages/runtime/src/domain/timeline-target.js +19 -1
- package/dist-package/packages/runtime/src/domain/types.d.ts +5 -0
- package/dist-package/packages/runtime/src/domain/verification.d.ts +92 -0
- package/dist-package/packages/runtime/src/editing/dialogue-normalization-service.d.ts +18 -0
- package/dist-package/packages/runtime/src/editing/duration-policy.d.ts +3 -0
- package/dist-package/packages/runtime/src/editing/edit-service.d.ts +44 -0
- package/dist-package/packages/runtime/src/editing/edit-service.js +76 -10
- package/dist-package/packages/runtime/src/editing/filler-removal-service.d.ts +23 -0
- package/dist-package/packages/runtime/src/editing/intent.d.ts +97 -0
- package/dist-package/packages/runtime/src/editing/music-service.d.ts +9 -0
- package/dist-package/packages/runtime/src/index.d.ts +32 -0
- package/dist-package/packages/runtime/src/index.js +2 -0
- package/dist-package/packages/runtime/src/planning/rough-cut.d.ts +3 -0
- package/dist-package/packages/runtime/src/render/render-and-verify.d.ts +71 -0
- package/dist-package/packages/runtime/src/render/render-contract.d.ts +96 -0
- package/dist-package/packages/runtime/src/runtime.d.ts +85 -0
- package/dist-package/packages/runtime/src/runtime.js +16 -7
- package/dist-package/packages/runtime/src/skills/builtin.d.ts +2 -0
- package/dist-package/packages/runtime/src/skills/index.d.ts +3 -0
- package/dist-package/packages/runtime/src/skills/registry.d.ts +10 -0
- package/dist-package/packages/runtime/src/skills/requirements.d.ts +38 -0
- package/dist-package/packages/runtime/src/skills/runtime.d.ts +38 -0
- package/dist-package/packages/runtime/src/speech/analysis.d.ts +18 -0
- package/dist-package/packages/runtime/src/speech/analysis.js +67 -0
- package/dist-package/packages/runtime/src/speech/filler-detector.d.ts +49 -0
- package/dist-package/packages/runtime/src/speech/filler-removal.d.ts +37 -0
- package/dist-package/packages/runtime/src/speech/mapping.d.ts +56 -0
- package/dist-package/packages/runtime/src/speech/mapping.js +27 -4
- package/dist-package/packages/runtime/src/speech/safe-cut-resolver.d.ts +52 -0
- package/dist-package/packages/runtime/src/timeline/drift-reconciliation.d.ts +42 -0
- package/dist-package/packages/runtime/src/timeline/editing-session.d.ts +271 -0
- package/dist-package/packages/runtime/src/timeline/editing-session.js +48 -2
- package/dist-package/packages/runtime/src/timeline/fast-observation.d.ts +77 -0
- package/dist-package/packages/runtime/src/timeline/rational-time.d.ts +11 -0
- package/dist-package/packages/runtime/src/timeline/reorder-preview.d.ts +32 -0
- package/dist-package/packages/runtime/src/timeline/reorder-preview.js +202 -0
- package/dist-package/packages/runtime/src/timeline/snapshot-diff.d.ts +3 -0
- package/dist-package/packages/runtime/src/timeline/snapshot-diff.js +1 -0
- package/dist-package/packages/runtime/src/timeline/snapshot-digest.d.ts +3 -0
- package/dist-package/packages/runtime/src/timeline/snapshot-digest.js +1 -1
- package/dist-package/packages/runtime/src/verification/verification.d.ts +6 -0
- package/dist-package/packages/testkit/src/fixture-analyzers.d.ts +37 -0
- package/dist-package/packages/testkit/src/in-memory-editor.d.ts +55 -0
- package/dist-package/packages/testkit/src/in-memory-editor.js +3 -3
- package/dist-package/packages/testkit/src/index.d.ts +4 -0
- package/dist-package/packages/testkit/src/index.js +1 -0
- package/dist-package/packages/testkit/src/sender-lifecycle-fixture.d.ts +47 -0
- package/dist-package/packages/testkit/src/sender-lifecycle-fixture.js +192 -0
- package/dist-package/packages/testkit/src/skill-fixtures.d.ts +3 -0
- package/package.json +41 -14
|
@@ -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 }) =>
|
|
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 }) => ({
|
|
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 {
|
|
@@ -123,6 +129,7 @@ function clipSignature(clip, mediaSource, audioMediaIds) {
|
|
|
123
129
|
noiseReductionDb: clip.noiseReductionDb,
|
|
124
130
|
colorCorrection: clip.colorCorrection,
|
|
125
131
|
role: clip.role,
|
|
132
|
+
nativeAudioRole: clip.nativeAudioRole,
|
|
126
133
|
enabled: clip.enabled,
|
|
127
134
|
position: clip.position,
|
|
128
135
|
scale: clip.scale,
|
|
@@ -185,6 +192,16 @@ function rationalSignature(value) {
|
|
|
185
192
|
const divisor = greatestCommonDivisor(signedNumerator, positiveDenominator);
|
|
186
193
|
return `${signedNumerator / divisor}/${positiveDenominator / divisor}`;
|
|
187
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
|
+
}
|
|
188
205
|
function zeroRational() {
|
|
189
206
|
return { value: "0", timescale: "1" };
|
|
190
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
|
+
}
|