@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.
- 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/canonical-recovery-guard.d.ts +32 -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 +33 -1
- package/dist-package/adapters/final-cut/typescript/src/connection.d.ts +103 -0
- package/dist-package/adapters/final-cut/typescript/src/disposable-native.d.ts +90 -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/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 +6 -1
- package/dist-package/adapters/final-cut/typescript/src/index.d.ts +22 -0
- 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 +8 -0
- 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-session.d.ts +130 -0
- package/dist-package/adapters/final-cut/typescript/src/native.d.ts +828 -0
- package/dist-package/adapters/final-cut/typescript/src/native.js +274 -107
- 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 +18 -2
- package/dist-package/adapters/final-cut/typescript/src/publisher.d.ts +215 -0
- package/dist-package/adapters/final-cut/typescript/src/session.d.ts +43 -0
- 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 +28 -4
- 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/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 +27 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.js +7 -2
- package/dist-package/adapters/headless/typescript/src/ffmpeg-storyboard.d.ts +28 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-storyboard.js +120 -0
- package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.d.ts +15 -0
- package/dist-package/adapters/headless/typescript/src/index.d.ts +4 -0
- package/dist-package/adapters/headless/typescript/src/index.js +1 -0
- package/dist-package/apps/cli/src/dev-doctor.d.ts +25 -0
- package/dist-package/apps/cli/src/headless-projects.d.ts +3 -0
- package/dist-package/apps/cli/src/main.d.ts +10 -0
- package/dist-package/apps/mcp-server/runtime/ffmpeg-audio-backend.py +129 -0
- package/dist-package/apps/mcp-server/runtime/whisper-speech-backend.py +92 -2
- 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/final-cut-runtime-config.d.ts +5 -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 +2 -1
- package/dist-package/apps/mcp-server/src/materialization-jobs.d.ts +204 -0
- 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/server.d.ts +75 -0
- package/dist-package/apps/mcp-server/src/server.js +93 -9
- package/dist-package/apps/mcp-server/src/tools/skills/catalog.d.ts +19 -0
- package/dist-package/apps/mcp-server/src/tools/skills/metadata.d.ts +37 -0
- package/dist-package/apps/mcp-server/src/tools/skills/register.d.ts +11 -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 +259 -0
- package/dist-package/packages/headless-application/src/headless-projects.js +15 -2
- package/dist-package/packages/headless-application/src/index.d.ts +2 -0
- package/dist-package/packages/headless-application/src/index.js +1 -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-store.d.ts +56 -0
- 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/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/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-service.d.ts +20 -0
- 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/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 +1 -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/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 +32 -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/index.d.ts +4 -0
- package/dist-package/packages/testkit/src/sender-lifecycle-fixture.d.ts +47 -0
- package/dist-package/packages/testkit/src/skill-fixtures.d.ts +3 -0
- package/package.json +17 -12
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import type { CapabilityDescriptor, CapabilityFamilies, EditingCapabilityOperation, EditorIdentity, NativeCapabilityOperation, ProjectSelectionMode, RuntimeCapabilities, VersionedRuntimeCapabilities } from "./domain/capabilities.js";
|
|
2
|
+
export type CanonicalTimelineMode = "metadata-only" | "canonical-read" | "canonical-write";
|
|
3
|
+
export type CapabilityProcessMode = "headless" | "headed";
|
|
4
|
+
export type CapabilityPreflightMode = "fixture" | "fcpxml-artifact" | "metadata-only" | "canonical-live" | "native-write";
|
|
5
|
+
export interface CapabilityPreflight {
|
|
6
|
+
mode: CapabilityPreflightMode;
|
|
7
|
+
documentMode: Exclude<CapabilityPreflightMode, "native-write">;
|
|
8
|
+
processMode: CapabilityProcessMode;
|
|
9
|
+
backend: string;
|
|
10
|
+
capabilities: CapabilityFamilies;
|
|
11
|
+
}
|
|
12
|
+
export declare function canonicalTimelineMode(capabilities: RuntimeCapabilities): CanonicalTimelineMode;
|
|
13
|
+
export declare function projectSelectionMode(editor: RuntimeCapabilities["editor"]): ProjectSelectionMode;
|
|
14
|
+
export declare function withCanonicalTimelineMode(capabilities: RuntimeCapabilities): RuntimeCapabilities;
|
|
15
|
+
export interface CapabilityFamilyOptions {
|
|
16
|
+
backend?: string;
|
|
17
|
+
connectionBackend?: string;
|
|
18
|
+
nativeBackend?: string;
|
|
19
|
+
publishingBackend?: string;
|
|
20
|
+
exportBackend?: string;
|
|
21
|
+
backgroundExportBackend?: string;
|
|
22
|
+
externalExportBackend?: string;
|
|
23
|
+
analyzerBackend?: string;
|
|
24
|
+
analyzerBackends?: Partial<Record<keyof CapabilityFamilies["analyzers"], string | undefined>>;
|
|
25
|
+
observation?: Partial<Record<keyof CapabilityFamilies["observation"], boolean | CapabilityDescriptor>>;
|
|
26
|
+
canonicalDocument?: Partial<Record<"read" | "write" | "artifactWrite", boolean | CapabilityDescriptor>>;
|
|
27
|
+
editing?: Partial<Record<EditingCapabilityOperation, boolean | CapabilityDescriptor>>;
|
|
28
|
+
editingBackend?: string;
|
|
29
|
+
connection?: boolean | CapabilityDescriptor;
|
|
30
|
+
native?: Partial<Record<NativeCapabilityOperation, boolean>>;
|
|
31
|
+
publishing?: boolean | CapabilityDescriptor;
|
|
32
|
+
publishingGuarantee?: Exclude<CapabilityDescriptor["guarantee"], "none">;
|
|
33
|
+
export?: boolean | CapabilityDescriptor;
|
|
34
|
+
backgroundExport?: boolean | CapabilityDescriptor;
|
|
35
|
+
externalExport?: boolean | CapabilityDescriptor;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Adds the versioned operation-level contract while retaining the legacy
|
|
39
|
+
* boolean fields used by existing runtime consumers.
|
|
40
|
+
*/
|
|
41
|
+
export declare function withCapabilityFamilies(capabilities: RuntimeCapabilities, options?: CapabilityFamilyOptions): VersionedRuntimeCapabilities;
|
|
42
|
+
export declare function createCapabilityPreflight(identity: EditorIdentity, capabilities: RuntimeCapabilities, options?: {
|
|
43
|
+
processMode?: CapabilityProcessMode;
|
|
44
|
+
nativeWrite?: boolean;
|
|
45
|
+
}): CapabilityPreflight;
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { ContextRevision } from "./domain/primitives.js";
|
|
2
|
+
import type { EditOperation } from "./domain/editing.js";
|
|
3
|
+
import type { Clip, ColorCorrection, ColorCorrectionPreset } from "./domain/project.js";
|
|
4
|
+
import type { TimelineDiff } from "./domain/diff.js";
|
|
5
|
+
export interface ColorCorrectionRequest {
|
|
6
|
+
clipId: string;
|
|
7
|
+
baseRevision: ContextRevision;
|
|
8
|
+
preset?: ColorCorrectionPreset;
|
|
9
|
+
exposure?: number;
|
|
10
|
+
contrast?: number;
|
|
11
|
+
saturation?: number;
|
|
12
|
+
temperature?: number;
|
|
13
|
+
tint?: number;
|
|
14
|
+
}
|
|
15
|
+
export interface ColorCorrectionPlan {
|
|
16
|
+
decision: "APPLY" | "NO_OP";
|
|
17
|
+
clipId: string;
|
|
18
|
+
before: ColorCorrection;
|
|
19
|
+
after: ColorCorrection;
|
|
20
|
+
changedFields: Array<keyof ColorCorrection>;
|
|
21
|
+
reasonCodes: Array<"APPLY_COLOR_CORRECTION" | "ALREADY_MATCHES">;
|
|
22
|
+
}
|
|
23
|
+
export interface ColorCorrectionPreview {
|
|
24
|
+
plan: ColorCorrectionPlan;
|
|
25
|
+
operation?: EditOperation;
|
|
26
|
+
expectedDiff?: TimelineDiff;
|
|
27
|
+
previewToken?: string;
|
|
28
|
+
warnings: string[];
|
|
29
|
+
expiresAt?: string;
|
|
30
|
+
}
|
|
31
|
+
export declare const COLOR_CORRECTION_PRESETS: Record<ColorCorrectionPreset, ColorCorrection>;
|
|
32
|
+
export declare function planColorCorrection(clip: Clip, request: ColorCorrectionRequest): ColorCorrectionPlan;
|
|
33
|
+
export declare function normalizeCorrection(correction?: ColorCorrection): ColorCorrection;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { AgentContext, ContextCursor, ContextDiff, TimelineChangesRequest, TimelineChangesResult } from "../domain/context.js";
|
|
2
|
+
import type { AssetSearchQuery, EditorPort } from "../domain/ports.js";
|
|
3
|
+
import type { ContextRevision } from "../domain/primitives.js";
|
|
4
|
+
import { type MediaUnderstanding } from "../domain/media.js";
|
|
5
|
+
import type { ProjectSnapshot } from "../domain/project.js";
|
|
6
|
+
import type { RuntimeCapabilities } from "../domain/capabilities.js";
|
|
7
|
+
import type { TimelineDiff } from "../domain/diff.js";
|
|
8
|
+
export declare class ContextEngine {
|
|
9
|
+
private readonly editor;
|
|
10
|
+
private readonly snapshots;
|
|
11
|
+
private readonly mediaUnderstanding;
|
|
12
|
+
constructor(editor: EditorPort);
|
|
13
|
+
inspectProject(): Promise<ProjectSnapshot>;
|
|
14
|
+
changesSince(revision: ContextRevision): Promise<TimelineDiff>;
|
|
15
|
+
timelineChangesSince(request: TimelineChangesRequest): Promise<TimelineChangesResult>;
|
|
16
|
+
contextChangesSince(cursorOrRevision: ContextCursor | ContextRevision, waitMs?: number): Promise<ContextDiff>;
|
|
17
|
+
private validateCursorTarget;
|
|
18
|
+
inspectContext(capabilities: RuntimeCapabilities, options?: {
|
|
19
|
+
includeCanonicalSnapshot?: boolean;
|
|
20
|
+
}): Promise<AgentContext>;
|
|
21
|
+
attachMediaUnderstanding(understanding: MediaUnderstanding): void;
|
|
22
|
+
private resolveTimelineChangesTarget;
|
|
23
|
+
listAssets(query?: AssetSearchQuery): Promise<import("../domain/ports.js").EditorAsset[]>;
|
|
24
|
+
private optionalTimelineChanges;
|
|
25
|
+
private liveChangesSince;
|
|
26
|
+
private optionalLiveState;
|
|
27
|
+
private withAttachedUnderstanding;
|
|
28
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { AgentContext, ContextCursor, ContextDiff, EditorChange, EditorLiveState, TimelineChangesRequest, TimelineChangesResult } from "../domain/context.js";
|
|
2
|
+
import type { ContextRevision } from "../domain/primitives.js";
|
|
3
|
+
import type { EditorPort } from "../domain/ports.js";
|
|
4
|
+
import type { RuntimeCapabilities } from "../domain/capabilities.js";
|
|
5
|
+
import type { TimelineDiff } from "../domain/diff.js";
|
|
6
|
+
import { ContextEngine } from "./context-engine.js";
|
|
7
|
+
export declare class ContextService {
|
|
8
|
+
private readonly adapter;
|
|
9
|
+
private readonly context;
|
|
10
|
+
constructor(adapter: EditorPort, context: ContextEngine);
|
|
11
|
+
inspectContext(capabilities: RuntimeCapabilities, options?: {
|
|
12
|
+
includeCanonicalSnapshot?: boolean;
|
|
13
|
+
}): Promise<AgentContext>;
|
|
14
|
+
inspectLiveEditor(): Promise<EditorLiveState>;
|
|
15
|
+
liveChangesSince(revision: ContextRevision, waitMs?: number): Promise<EditorChange[]>;
|
|
16
|
+
changesSince(revision: ContextRevision): Promise<TimelineDiff>;
|
|
17
|
+
timelineChangesSince(request: TimelineChangesRequest): Promise<TimelineChangesResult>;
|
|
18
|
+
contextChangesSince(cursorOrRevision: ContextCursor | ContextRevision, waitMs?: number): Promise<ContextDiff>;
|
|
19
|
+
private liveAdapter;
|
|
20
|
+
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { EditorLiveState, ProjectCatalog, ProjectCatalogLiveSource, ProjectCatalogProvenance } from "../domain/context.js";
|
|
2
|
+
export interface ProjectCatalogReconciliationOptions {
|
|
3
|
+
before?: EditorLiveState;
|
|
4
|
+
after?: EditorLiveState;
|
|
5
|
+
provenance: {
|
|
6
|
+
catalog: ProjectCatalogProvenance["catalog"];
|
|
7
|
+
live?: ProjectCatalogLiveSource;
|
|
8
|
+
selection: ProjectCatalogProvenance["selection"];
|
|
9
|
+
};
|
|
10
|
+
}
|
|
11
|
+
export declare function reconcileProjectCatalog(catalog: ProjectCatalog, options: ProjectCatalogReconciliationOptions): ProjectCatalog;
|
|
12
|
+
export declare function validateProjectCatalog(catalog: ProjectCatalog): void;
|
|
@@ -0,0 +1,170 @@
|
|
|
1
|
+
import type { SkillOperation } from "./skills.js";
|
|
2
|
+
export interface BuildFingerprint {
|
|
3
|
+
version: string;
|
|
4
|
+
commit: string;
|
|
5
|
+
}
|
|
6
|
+
export interface EditorIdentity {
|
|
7
|
+
name: string;
|
|
8
|
+
version: string;
|
|
9
|
+
backend: string;
|
|
10
|
+
buildFingerprint?: BuildFingerprint;
|
|
11
|
+
}
|
|
12
|
+
export type ProjectSelectionMode = "background-capable" | "active-target-only" | "headed-only" | "unavailable";
|
|
13
|
+
export type ArtifactPublishMode = "background-capable" | "headed-only" | "unavailable";
|
|
14
|
+
export interface CapabilityInspectionOptions {
|
|
15
|
+
/** Skip provider probes that require an editor-specific canonical read. */
|
|
16
|
+
probeCanonicalSnapshot?: boolean;
|
|
17
|
+
}
|
|
18
|
+
export interface EditorCapabilities {
|
|
19
|
+
/** Derived canonical guarantee exposed to agents; omitted only by legacy adapters. */
|
|
20
|
+
canonicalTimelineMode?: "metadata-only" | "canonical-read" | "canonical-write";
|
|
21
|
+
projectRead: boolean;
|
|
22
|
+
timelineSnapshotRead: boolean;
|
|
23
|
+
timelineWrite: boolean;
|
|
24
|
+
timelineArtifactWrite: boolean;
|
|
25
|
+
readAfterWrite: boolean;
|
|
26
|
+
incrementalChanges: boolean;
|
|
27
|
+
rollback: boolean;
|
|
28
|
+
assetDiscovery: boolean;
|
|
29
|
+
liveStateRead: boolean;
|
|
30
|
+
playheadWrite: boolean;
|
|
31
|
+
/** The backend can return image data for an exact timeline position. */
|
|
32
|
+
frameCapture: boolean;
|
|
33
|
+
playbackControl?: boolean;
|
|
34
|
+
/** The managed artifact can be imported as a new editor project. */
|
|
35
|
+
artifactPublish?: boolean;
|
|
36
|
+
/** How a managed artifact can be handed back to the editor. */
|
|
37
|
+
artifactPublishMode?: ArtifactPublishMode;
|
|
38
|
+
/** The immediate artifact handoff response is dispatch-only and unverified. */
|
|
39
|
+
artifactPublishDispatchGuarantee?: "requested-unverified";
|
|
40
|
+
/** Legacy alias for artifactPublish used by editor-first routing. */
|
|
41
|
+
timelinePublishNewProject?: boolean;
|
|
42
|
+
/** The backend can enumerate stable project and sequence identities. */
|
|
43
|
+
projectCatalogRead?: boolean;
|
|
44
|
+
/** The backend can select a project and, when needed, one of its sequences. */
|
|
45
|
+
projectSelection?: boolean;
|
|
46
|
+
/** How project selection is performed, independent of canonical mutation guarantees. */
|
|
47
|
+
projectSelectionMode?: ProjectSelectionMode;
|
|
48
|
+
/** Marker IDs may be assigned by the editor after insertion. */
|
|
49
|
+
markerIdentityMode?: "requested" | "editor-assigned";
|
|
50
|
+
/** The backend can atomically preview and apply ordered workflow operations. */
|
|
51
|
+
compositeTransactions?: boolean;
|
|
52
|
+
/** The backend can export the active timeline to a verified local video file. */
|
|
53
|
+
videoExport?: boolean;
|
|
54
|
+
/** A background renderer can produce a verified local video file without editor UI. */
|
|
55
|
+
backgroundRender?: boolean;
|
|
56
|
+
/** An external renderer is available as an explicitly separate evidence path. */
|
|
57
|
+
externalRender?: boolean;
|
|
58
|
+
mediaImport?: boolean;
|
|
59
|
+
mediaPlacement?: boolean;
|
|
60
|
+
pictureInPicture?: boolean;
|
|
61
|
+
titlePlacement?: boolean;
|
|
62
|
+
clipMove?: boolean;
|
|
63
|
+
clipReplace?: boolean;
|
|
64
|
+
clipRemoval?: boolean;
|
|
65
|
+
transitionPlacement?: boolean;
|
|
66
|
+
audioAttachment?: boolean;
|
|
67
|
+
audioMixing?: boolean;
|
|
68
|
+
noiseReduction?: boolean;
|
|
69
|
+
colorCorrection?: boolean;
|
|
70
|
+
/** The backend can add and verify a bounded or supplied-alpha mask. */
|
|
71
|
+
masking?: boolean;
|
|
72
|
+
/** The backend can add and verify a person cutout. */
|
|
73
|
+
personCutout?: boolean;
|
|
74
|
+
/** Explicit semantic operation guarantees; timelineWrite alone is insufficient. */
|
|
75
|
+
semanticOperations?: Partial<Record<SkillOperation, boolean>>;
|
|
76
|
+
/** The backend can discover local media without Final Cut UI access. */
|
|
77
|
+
backgroundMediaDiscovery?: boolean;
|
|
78
|
+
/** The backend can discover installed templates without Final Cut UI access. */
|
|
79
|
+
backgroundTemplateDiscovery?: boolean;
|
|
80
|
+
/** The backend can inspect the Final Cut library without Final Cut UI access. */
|
|
81
|
+
backgroundLibraryInspection?: boolean;
|
|
82
|
+
}
|
|
83
|
+
export interface AnalyzerCapabilities {
|
|
84
|
+
speechTranscribe: boolean;
|
|
85
|
+
speechVad: boolean;
|
|
86
|
+
speechCapability?: "unavailable" | "transcription-only" | "transcription-plus-vad";
|
|
87
|
+
audioLoudness: boolean;
|
|
88
|
+
audioNoise?: boolean;
|
|
89
|
+
visualTrack: boolean;
|
|
90
|
+
metadataDescribe?: boolean;
|
|
91
|
+
}
|
|
92
|
+
export declare const CAPABILITY_SCHEMA_VERSION: 1;
|
|
93
|
+
export type CapabilityGuarantee = "none" | "observed" | "artifact-write" | "canonical-read" | "canonical-write" | "native-verified" | "verified";
|
|
94
|
+
export type ExportEvidenceTier = "headed-native" | "background-native" | "artifact-rendered" | "external-rendered";
|
|
95
|
+
export interface CapabilityDescriptor {
|
|
96
|
+
available: boolean;
|
|
97
|
+
backend: string;
|
|
98
|
+
guarantee: CapabilityGuarantee;
|
|
99
|
+
evidenceTier?: ExportEvidenceTier;
|
|
100
|
+
unavailableReason?: string;
|
|
101
|
+
}
|
|
102
|
+
export interface CapabilityUnavailableErrorPayload {
|
|
103
|
+
code: "CAPABILITY_UNAVAILABLE";
|
|
104
|
+
message: string;
|
|
105
|
+
operation: string;
|
|
106
|
+
capability: string;
|
|
107
|
+
available: false;
|
|
108
|
+
backend: string;
|
|
109
|
+
guarantee: "none";
|
|
110
|
+
unavailableReason: string;
|
|
111
|
+
}
|
|
112
|
+
export declare class CapabilityUnavailableError extends Error {
|
|
113
|
+
readonly operation: string;
|
|
114
|
+
readonly capability: string;
|
|
115
|
+
readonly code: "CAPABILITY_UNAVAILABLE";
|
|
116
|
+
readonly available: false;
|
|
117
|
+
readonly backend: string;
|
|
118
|
+
readonly guarantee: "none";
|
|
119
|
+
readonly unavailableReason: string;
|
|
120
|
+
constructor(operation: string, capability: string, descriptor: CapabilityDescriptor);
|
|
121
|
+
toJSON(): CapabilityUnavailableErrorPayload;
|
|
122
|
+
}
|
|
123
|
+
export declare function serializeCapabilityUnavailableError(error: unknown): CapabilityUnavailableErrorPayload | undefined;
|
|
124
|
+
export type EditingCapabilityOperation = "compositeTransactions" | "titlePlacement" | "pictureInPicture" | "masking" | "personCutout";
|
|
125
|
+
export type NativeCapabilityOperation = "selectionWrite" | "undo" | "mediaLibrarySearch" | "mediaImport" | "mediaSelection" | "mediaAppendSelected" | "timelineOccurrenceLocate" | "bladeAtPlayhead" | "deleteRange" | "trimToDuration" | "mediaAppend" | "mediaInsert" | "titlePlacement" | "titleDiscovery" | "timelineFocus" | "projectCreation" | "clipInsertion" | "clipMovement" | "transitionDiscovery" | "transitionPlacement" | "pictureInPicture" | "masking";
|
|
126
|
+
export interface CapabilityFamilies {
|
|
127
|
+
connection: {
|
|
128
|
+
status: CapabilityDescriptor;
|
|
129
|
+
};
|
|
130
|
+
observation: {
|
|
131
|
+
timeline: CapabilityDescriptor;
|
|
132
|
+
media: CapabilityDescriptor;
|
|
133
|
+
assets: CapabilityDescriptor;
|
|
134
|
+
library: CapabilityDescriptor;
|
|
135
|
+
};
|
|
136
|
+
canonicalDocument: {
|
|
137
|
+
read: CapabilityDescriptor;
|
|
138
|
+
write: CapabilityDescriptor;
|
|
139
|
+
artifactWrite: CapabilityDescriptor;
|
|
140
|
+
};
|
|
141
|
+
editing: Record<EditingCapabilityOperation, CapabilityDescriptor>;
|
|
142
|
+
native: Record<NativeCapabilityOperation, CapabilityDescriptor>;
|
|
143
|
+
publishing: {
|
|
144
|
+
projectCreation: CapabilityDescriptor;
|
|
145
|
+
};
|
|
146
|
+
export: {
|
|
147
|
+
timeline: CapabilityDescriptor;
|
|
148
|
+
background: CapabilityDescriptor;
|
|
149
|
+
external: CapabilityDescriptor;
|
|
150
|
+
};
|
|
151
|
+
analyzers: {
|
|
152
|
+
speechTranscribe: CapabilityDescriptor;
|
|
153
|
+
speechVad: CapabilityDescriptor;
|
|
154
|
+
audioLoudness: CapabilityDescriptor;
|
|
155
|
+
audioNoise?: CapabilityDescriptor;
|
|
156
|
+
visualTrack: CapabilityDescriptor;
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
export interface RuntimeCapabilities {
|
|
160
|
+
editor: EditorCapabilities;
|
|
161
|
+
analyzers: AnalyzerCapabilities;
|
|
162
|
+
/** Present in the versioned operation-level capability contract. */
|
|
163
|
+
schemaVersion?: typeof CAPABILITY_SCHEMA_VERSION;
|
|
164
|
+
/** Present in the versioned operation-level capability contract. */
|
|
165
|
+
families?: CapabilityFamilies;
|
|
166
|
+
}
|
|
167
|
+
export interface VersionedRuntimeCapabilities extends RuntimeCapabilities {
|
|
168
|
+
schemaVersion: typeof CAPABILITY_SCHEMA_VERSION;
|
|
169
|
+
families: CapabilityFamilies;
|
|
170
|
+
}
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
import type { ContextRevision, RationalTime, RationalTimeRange } from "./primitives.js";
|
|
2
|
+
import type { ProjectSnapshot } from "./project.js";
|
|
3
|
+
import type { MediaContext } from "./media.js";
|
|
4
|
+
import type { TimelineDiff, TimelineChange, AssetChange } from "./diff.js";
|
|
5
|
+
import type { ProjectSelectionMode, RuntimeCapabilities } from "./capabilities.js";
|
|
6
|
+
/**
|
|
7
|
+
* State that Final Cut can expose live through its Workflow Extension host.
|
|
8
|
+
* This deliberately does not pretend to be a complete timeline snapshot.
|
|
9
|
+
*/
|
|
10
|
+
export interface EditorLiveState {
|
|
11
|
+
project?: {
|
|
12
|
+
id: string;
|
|
13
|
+
name: string;
|
|
14
|
+
};
|
|
15
|
+
sequence?: {
|
|
16
|
+
id: string;
|
|
17
|
+
name: string;
|
|
18
|
+
startTime: RationalTime;
|
|
19
|
+
duration: RationalTime;
|
|
20
|
+
frameDuration: RationalTime;
|
|
21
|
+
};
|
|
22
|
+
playheadTime?: RationalTime;
|
|
23
|
+
sequenceTimeRange?: RationalTimeRange;
|
|
24
|
+
revision: ContextRevision;
|
|
25
|
+
}
|
|
26
|
+
export interface ProjectCatalogSource {
|
|
27
|
+
source: string;
|
|
28
|
+
backend: string;
|
|
29
|
+
guarantee: "observed" | "canonical-read";
|
|
30
|
+
}
|
|
31
|
+
export interface ProjectCatalogLiveSource {
|
|
32
|
+
source: string;
|
|
33
|
+
backend: string;
|
|
34
|
+
guarantee: "observed";
|
|
35
|
+
}
|
|
36
|
+
export type ProjectCatalogIdentityMatchMethod = "stable-id" | "name-only" | "ambiguous-name" | "unresolved";
|
|
37
|
+
export type ProjectCatalogIdentityDiagnosticCode = "stable-id-mismatch" | "ambiguous-name" | "identity-unresolved";
|
|
38
|
+
export interface ProjectCatalogIdentityDiagnostic {
|
|
39
|
+
scope: "project" | "sequence";
|
|
40
|
+
code: ProjectCatalogIdentityDiagnosticCode;
|
|
41
|
+
liveId?: string;
|
|
42
|
+
liveName?: string;
|
|
43
|
+
catalogId?: string;
|
|
44
|
+
candidateCatalogIds?: string[];
|
|
45
|
+
}
|
|
46
|
+
export interface ProjectCatalogIdentityMatch {
|
|
47
|
+
method: ProjectCatalogIdentityMatchMethod;
|
|
48
|
+
catalogId?: string;
|
|
49
|
+
liveId?: string;
|
|
50
|
+
candidateCatalogIds?: string[];
|
|
51
|
+
}
|
|
52
|
+
export type ProjectCatalogReconciliationBlockerCode = "target-selection-required";
|
|
53
|
+
export interface ProjectCatalogReconciliationBlocker {
|
|
54
|
+
code: ProjectCatalogReconciliationBlockerCode;
|
|
55
|
+
message: string;
|
|
56
|
+
}
|
|
57
|
+
export interface ProjectCatalogReconciliation {
|
|
58
|
+
status: "matched" | "unresolved" | "stale";
|
|
59
|
+
project: ProjectCatalogIdentityMatch;
|
|
60
|
+
sequence: ProjectCatalogIdentityMatch;
|
|
61
|
+
beforeRevision?: ContextRevision;
|
|
62
|
+
afterRevision?: ContextRevision;
|
|
63
|
+
diagnostics?: ProjectCatalogIdentityDiagnostic[];
|
|
64
|
+
blocker?: ProjectCatalogReconciliationBlocker;
|
|
65
|
+
reason?: string;
|
|
66
|
+
}
|
|
67
|
+
export interface ProjectCatalogSelectionCapability {
|
|
68
|
+
available: boolean;
|
|
69
|
+
mode: ProjectSelectionMode;
|
|
70
|
+
unavailableReason?: string;
|
|
71
|
+
}
|
|
72
|
+
export interface ProjectCatalogProvenance {
|
|
73
|
+
catalog: ProjectCatalogSource;
|
|
74
|
+
live?: ProjectCatalogLiveSource & {
|
|
75
|
+
state: EditorLiveState;
|
|
76
|
+
};
|
|
77
|
+
reconciliation: ProjectCatalogReconciliation;
|
|
78
|
+
selection: ProjectCatalogSelectionCapability;
|
|
79
|
+
}
|
|
80
|
+
/** Stable project and sequence identities exposed by an editor backend. */
|
|
81
|
+
export interface ProjectSequence {
|
|
82
|
+
id: string;
|
|
83
|
+
name: string;
|
|
84
|
+
}
|
|
85
|
+
export interface ProjectDescriptor {
|
|
86
|
+
id: string;
|
|
87
|
+
name: string;
|
|
88
|
+
sequences: ProjectSequence[];
|
|
89
|
+
}
|
|
90
|
+
export interface ProjectCatalog {
|
|
91
|
+
projects: ProjectDescriptor[];
|
|
92
|
+
activeProjectId?: string;
|
|
93
|
+
activeSequenceId?: string;
|
|
94
|
+
provenance?: ProjectCatalogProvenance;
|
|
95
|
+
}
|
|
96
|
+
export interface ProjectSelection {
|
|
97
|
+
projectId: string;
|
|
98
|
+
sequenceId?: string;
|
|
99
|
+
}
|
|
100
|
+
export interface TimelineChangesRequest {
|
|
101
|
+
target: ProjectSelection;
|
|
102
|
+
from: ContextRevision;
|
|
103
|
+
}
|
|
104
|
+
export type TimelineChangesStatus = "ready" | "stale" | "ambiguous" | "unavailable";
|
|
105
|
+
export interface TimelineChangesSource {
|
|
106
|
+
source: string;
|
|
107
|
+
backend: string;
|
|
108
|
+
guarantee: "canonical-read" | "metadata-only";
|
|
109
|
+
}
|
|
110
|
+
export interface TimelineChangesResult {
|
|
111
|
+
status: TimelineChangesStatus;
|
|
112
|
+
target: ProjectSelection;
|
|
113
|
+
source: TimelineChangesSource;
|
|
114
|
+
from: ContextRevision;
|
|
115
|
+
to?: ContextRevision;
|
|
116
|
+
changes: TimelineChange[];
|
|
117
|
+
timeline?: TimelineDiff;
|
|
118
|
+
reason?: string;
|
|
119
|
+
}
|
|
120
|
+
export interface ProjectSelectionResult extends ProjectCatalog {
|
|
121
|
+
requestedTarget: ProjectSelection;
|
|
122
|
+
observedActiveTarget: {
|
|
123
|
+
projectId: string;
|
|
124
|
+
sequenceId: string;
|
|
125
|
+
};
|
|
126
|
+
observedRevision: ContextRevision;
|
|
127
|
+
}
|
|
128
|
+
export declare function createProjectSelectionResult(catalog: ProjectCatalog, requestedTarget: ProjectSelection, observedRevision: ContextRevision): ProjectSelectionResult;
|
|
129
|
+
export type EditorChangeKind = "active-sequence-changed" | "playhead-changed" | "sequence-time-range-changed";
|
|
130
|
+
export interface EditorChange {
|
|
131
|
+
kind: EditorChangeKind;
|
|
132
|
+
revision: ContextRevision;
|
|
133
|
+
state: EditorLiveState;
|
|
134
|
+
}
|
|
135
|
+
export interface ContextChangeSet {
|
|
136
|
+
from: ContextRevision;
|
|
137
|
+
to: ContextRevision;
|
|
138
|
+
timeline?: TimelineDiff;
|
|
139
|
+
stateChanges: EditorChange[];
|
|
140
|
+
assetChanges: AssetChange[];
|
|
141
|
+
}
|
|
142
|
+
export type ContextSource = "canonical-timeline" | "live-metadata" | "fcpxml-artifact" | "deterministic-fixture";
|
|
143
|
+
export type ContextEvidenceTier = "deterministic" | "metadata-only" | "fcpxml-artifact" | "canonical-live" | "headed-native";
|
|
144
|
+
export interface ContextTarget {
|
|
145
|
+
projectId: string;
|
|
146
|
+
sequenceId: string;
|
|
147
|
+
}
|
|
148
|
+
export interface ContextCursor {
|
|
149
|
+
revision: ContextRevision;
|
|
150
|
+
target?: ContextTarget;
|
|
151
|
+
}
|
|
152
|
+
export interface ContextProvenance {
|
|
153
|
+
source: ContextSource;
|
|
154
|
+
provider: string;
|
|
155
|
+
evidenceTier: ContextEvidenceTier;
|
|
156
|
+
target?: ContextTarget;
|
|
157
|
+
}
|
|
158
|
+
export type ContextChangedScope = "project" | "sequence" | "timeline" | "playhead" | "assets" | "media";
|
|
159
|
+
export interface ContextDiff {
|
|
160
|
+
from: ContextRevision;
|
|
161
|
+
to: ContextRevision;
|
|
162
|
+
cursor: ContextCursor;
|
|
163
|
+
provenance: ContextProvenance[];
|
|
164
|
+
changedScopes: ContextChangedScope[];
|
|
165
|
+
timeline?: TimelineDiff;
|
|
166
|
+
stateChanges: EditorChange[];
|
|
167
|
+
assetChanges: AssetChange[];
|
|
168
|
+
}
|
|
169
|
+
export interface AgentContext {
|
|
170
|
+
revision: ContextRevision;
|
|
171
|
+
cursor: ContextCursor;
|
|
172
|
+
provenance: ContextProvenance;
|
|
173
|
+
changedScopes: ContextChangedScope[];
|
|
174
|
+
project?: ProjectSnapshot;
|
|
175
|
+
editorState?: EditorLiveState;
|
|
176
|
+
media: MediaContext[];
|
|
177
|
+
recentChanges: ContextDiff;
|
|
178
|
+
capabilities: RuntimeCapabilities;
|
|
179
|
+
}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import type { ContextRevision, RationalTime, TimeRange } from "./primitives.js";
|
|
2
|
+
import type { Clip, Marker, Caption, StoryElement } from "./project.js";
|
|
3
|
+
import type { MediaContext } from "./media.js";
|
|
4
|
+
import type { EditorAsset } from "./ports.js";
|
|
5
|
+
export interface TimelineDiffProvenance {
|
|
6
|
+
source: "project-snapshot";
|
|
7
|
+
projectId: string;
|
|
8
|
+
sequenceId: string;
|
|
9
|
+
fromRevision: ContextRevision;
|
|
10
|
+
toRevision: ContextRevision;
|
|
11
|
+
}
|
|
12
|
+
export interface ClipChange {
|
|
13
|
+
type: "ITEM_ADDED" | "ITEM_REMOVED" | "ITEM_MODIFIED";
|
|
14
|
+
itemId: string;
|
|
15
|
+
before?: Clip;
|
|
16
|
+
after?: Clip;
|
|
17
|
+
}
|
|
18
|
+
export type TimelineChange = {
|
|
19
|
+
scope: "clip";
|
|
20
|
+
type: ClipChange["type"];
|
|
21
|
+
itemId: string;
|
|
22
|
+
before?: Clip;
|
|
23
|
+
after?: Clip;
|
|
24
|
+
} | {
|
|
25
|
+
scope: "marker";
|
|
26
|
+
type: "MARKER_ADDED" | "MARKER_REMOVED" | "MARKER_MODIFIED";
|
|
27
|
+
itemId: string;
|
|
28
|
+
before?: Marker;
|
|
29
|
+
after?: Marker;
|
|
30
|
+
} | {
|
|
31
|
+
scope: "caption";
|
|
32
|
+
type: "CAPTION_ADDED" | "CAPTION_REMOVED" | "CAPTION_MODIFIED";
|
|
33
|
+
itemId: string;
|
|
34
|
+
before?: Caption;
|
|
35
|
+
after?: Caption;
|
|
36
|
+
} | {
|
|
37
|
+
scope: "story-element";
|
|
38
|
+
type: "STORY_ELEMENT_ADDED" | "STORY_ELEMENT_REMOVED" | "STORY_ELEMENT_MODIFIED";
|
|
39
|
+
itemId: string;
|
|
40
|
+
before?: StoryElement;
|
|
41
|
+
after?: StoryElement;
|
|
42
|
+
} | {
|
|
43
|
+
scope: "media";
|
|
44
|
+
type: "MEDIA_ADDED" | "MEDIA_REMOVED" | "MEDIA_MODIFIED";
|
|
45
|
+
itemId: string;
|
|
46
|
+
before?: MediaContext;
|
|
47
|
+
after?: MediaContext;
|
|
48
|
+
};
|
|
49
|
+
export interface MarkerChange {
|
|
50
|
+
type: "MARKER_ADDED" | "MARKER_REMOVED" | "MARKER_MODIFIED";
|
|
51
|
+
itemId: string;
|
|
52
|
+
marker: Marker;
|
|
53
|
+
before?: Marker;
|
|
54
|
+
after?: Marker;
|
|
55
|
+
}
|
|
56
|
+
export interface CaptionChange {
|
|
57
|
+
type: "CAPTION_ADDED" | "CAPTION_REMOVED" | "CAPTION_MODIFIED";
|
|
58
|
+
itemId: string;
|
|
59
|
+
caption: Caption;
|
|
60
|
+
before?: Caption;
|
|
61
|
+
after?: Caption;
|
|
62
|
+
}
|
|
63
|
+
export interface StoryElementChange {
|
|
64
|
+
type: "STORY_ELEMENT_ADDED" | "STORY_ELEMENT_REMOVED" | "STORY_ELEMENT_MODIFIED";
|
|
65
|
+
itemId: string;
|
|
66
|
+
element: StoryElement;
|
|
67
|
+
before?: StoryElement;
|
|
68
|
+
after?: StoryElement;
|
|
69
|
+
}
|
|
70
|
+
export interface MediaChange {
|
|
71
|
+
type: "MEDIA_ADDED" | "MEDIA_REMOVED" | "MEDIA_MODIFIED";
|
|
72
|
+
itemId: string;
|
|
73
|
+
media: MediaContext;
|
|
74
|
+
before?: MediaContext;
|
|
75
|
+
after?: MediaContext;
|
|
76
|
+
}
|
|
77
|
+
export interface PlayheadChange {
|
|
78
|
+
before?: RationalTime;
|
|
79
|
+
after?: RationalTime;
|
|
80
|
+
}
|
|
81
|
+
export interface TimelineDiff {
|
|
82
|
+
from: ContextRevision;
|
|
83
|
+
to: ContextRevision;
|
|
84
|
+
provenance: TimelineDiffProvenance;
|
|
85
|
+
added: ClipChange[];
|
|
86
|
+
removed: ClipChange[];
|
|
87
|
+
modified: ClipChange[];
|
|
88
|
+
durationDelta: number;
|
|
89
|
+
durationDeltaTime: RationalTime;
|
|
90
|
+
playheadChange?: PlayheadChange;
|
|
91
|
+
markerChanges: MarkerChange[];
|
|
92
|
+
captionChanges: CaptionChange[];
|
|
93
|
+
storyElementChanges: StoryElementChange[];
|
|
94
|
+
mediaChanges: MediaChange[];
|
|
95
|
+
/** All canonical changes in deterministic timeline order. */
|
|
96
|
+
changes: TimelineChange[];
|
|
97
|
+
affectedRanges: TimeRange[];
|
|
98
|
+
}
|
|
99
|
+
export interface AssetChange {
|
|
100
|
+
type: "ASSET_ADDED" | "ASSET_REMOVED" | "ASSET_MODIFIED";
|
|
101
|
+
assetId: string;
|
|
102
|
+
before?: EditorAsset;
|
|
103
|
+
after?: EditorAsset;
|
|
104
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
export type DurationConstraint = "hard" | "soft";
|
|
2
|
+
export type DurationPolicyAction = "deliver-exact-duration" | "deliver-shorter-strong-edit" | "reuse-selected-b-roll" | "request-additional-footage";
|
|
3
|
+
export type DurationAlternativeKind = "deliver-shorter-strong-edit" | "reuse-selected-b-roll" | "slow-motion" | "request-additional-footage" | "generated-interstitial";
|
|
4
|
+
export type DurationAlternativeStatus = "recommended" | "available" | "requires-confirmation" | "not-permitted";
|
|
5
|
+
export interface DurationRange {
|
|
6
|
+
startSeconds: number;
|
|
7
|
+
endSeconds: number;
|
|
8
|
+
}
|
|
9
|
+
export interface DurationPolicyFootage {
|
|
10
|
+
id: string;
|
|
11
|
+
durationSeconds: number;
|
|
12
|
+
usableDurationSeconds?: number;
|
|
13
|
+
usableRanges?: DurationRange[];
|
|
14
|
+
reusable?: boolean;
|
|
15
|
+
}
|
|
16
|
+
export interface DurationPolicyPermissions {
|
|
17
|
+
allowReuse?: boolean;
|
|
18
|
+
allowSlowMotion?: boolean;
|
|
19
|
+
allowGeneratedAssets?: boolean;
|
|
20
|
+
}
|
|
21
|
+
export interface DurationPolicyRequest {
|
|
22
|
+
requestedDurationSeconds: number;
|
|
23
|
+
footage: DurationPolicyFootage[];
|
|
24
|
+
constraint?: DurationConstraint;
|
|
25
|
+
permissions?: DurationPolicyPermissions;
|
|
26
|
+
actualDurationSeconds?: number;
|
|
27
|
+
}
|
|
28
|
+
export interface DurationRangeUse {
|
|
29
|
+
footageId: string;
|
|
30
|
+
sourceRange: DurationRange;
|
|
31
|
+
occurrence: number;
|
|
32
|
+
}
|
|
33
|
+
export interface DurationPolicyAlternative {
|
|
34
|
+
kind: DurationAlternativeKind;
|
|
35
|
+
status: DurationAlternativeStatus;
|
|
36
|
+
resultingDurationSeconds: number | null;
|
|
37
|
+
tradeoffs: string[];
|
|
38
|
+
confirmationRequired?: string;
|
|
39
|
+
reusedRanges?: DurationRangeUse[];
|
|
40
|
+
}
|
|
41
|
+
export interface DurationPolicyPlan {
|
|
42
|
+
policy: {
|
|
43
|
+
constraint: DurationConstraint;
|
|
44
|
+
constraintWasExplicit: boolean;
|
|
45
|
+
};
|
|
46
|
+
requestedDurationSeconds: number;
|
|
47
|
+
availableFootage: {
|
|
48
|
+
uniqueDurationSeconds: number;
|
|
49
|
+
reusableDurationSeconds: number;
|
|
50
|
+
};
|
|
51
|
+
achievableDurationSeconds: number;
|
|
52
|
+
actualDurationSeconds: number | null;
|
|
53
|
+
durationReport: {
|
|
54
|
+
requestedDurationSeconds: number;
|
|
55
|
+
achievableDurationSeconds: number;
|
|
56
|
+
actualDurationSeconds: number | null;
|
|
57
|
+
};
|
|
58
|
+
selectedAction: DurationPolicyAction;
|
|
59
|
+
reusedRanges: DurationRangeUse[];
|
|
60
|
+
unmetConstraints: string[];
|
|
61
|
+
confirmationRequired: string[];
|
|
62
|
+
alternatives: DurationPolicyAlternative[];
|
|
63
|
+
}
|