@morshoto/framekit 0.1.18 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (192) hide show
  1. package/README.md +17 -12
  2. package/dist-package/adapters/final-cut/typescript/src/analyzers.d.ts +58 -0
  3. package/dist-package/adapters/final-cut/typescript/src/analyzers.js +52 -13
  4. package/dist-package/adapters/final-cut/typescript/src/assets.d.ts +24 -0
  5. package/dist-package/adapters/final-cut/typescript/src/background-export.d.ts +98 -0
  6. package/dist-package/adapters/final-cut/typescript/src/background-materialization.d.ts +47 -0
  7. package/dist-package/adapters/final-cut/typescript/src/background-materialization.js +8 -2
  8. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.d.ts +32 -0
  9. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery-guard.js +275 -0
  10. package/dist-package/adapters/final-cut/typescript/src/canonical-recovery.d.ts +22 -0
  11. package/dist-package/adapters/final-cut/typescript/src/canonical-verification.d.ts +11 -0
  12. package/dist-package/adapters/final-cut/typescript/src/canonical.d.ts +184 -0
  13. package/dist-package/adapters/final-cut/typescript/src/canonical.js +571 -78
  14. package/dist-package/adapters/final-cut/typescript/src/connection.d.ts +103 -0
  15. package/dist-package/adapters/final-cut/typescript/src/connection.js +6 -1
  16. package/dist-package/adapters/final-cut/typescript/src/disposable-native.d.ts +90 -0
  17. package/dist-package/adapters/final-cut/typescript/src/disposable-native.js +6 -0
  18. package/dist-package/adapters/final-cut/typescript/src/documents.d.ts +3 -0
  19. package/dist-package/adapters/final-cut/typescript/src/documents.js +3 -0
  20. package/dist-package/adapters/final-cut/typescript/src/experimental.d.ts +8 -0
  21. package/dist-package/adapters/final-cut/typescript/src/experimental.js +8 -0
  22. package/dist-package/adapters/final-cut/typescript/src/export.d.ts +125 -0
  23. package/dist-package/adapters/final-cut/typescript/src/fcpxml-console-experiment.d.ts +54 -0
  24. package/dist-package/adapters/final-cut/typescript/src/fcpxml.d.ts +75 -0
  25. package/dist-package/adapters/final-cut/typescript/src/fcpxml.js +28 -9
  26. package/dist-package/adapters/final-cut/typescript/src/index.d.ts +22 -0
  27. package/dist-package/adapters/final-cut/typescript/src/index.js +1 -7
  28. package/dist-package/adapters/final-cut/typescript/src/library-inspection.d.ts +101 -0
  29. package/dist-package/adapters/final-cut/typescript/src/live.d.ts +101 -0
  30. package/dist-package/adapters/final-cut/typescript/src/live.js +35 -2
  31. package/dist-package/adapters/final-cut/typescript/src/media.d.ts +12 -0
  32. package/dist-package/adapters/final-cut/typescript/src/native-operation.d.ts +6 -0
  33. package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.d.ts +77 -0
  34. package/dist-package/adapters/final-cut/typescript/src/native-recovery-inspection.js +175 -0
  35. package/dist-package/adapters/final-cut/typescript/src/native-session.d.ts +130 -0
  36. package/dist-package/adapters/final-cut/typescript/src/native-session.js +11 -6
  37. package/dist-package/adapters/final-cut/typescript/src/native.d.ts +828 -0
  38. package/dist-package/adapters/final-cut/typescript/src/native.js +475 -189
  39. package/dist-package/adapters/final-cut/typescript/src/pasteboard-snapshot.d.ts +114 -0
  40. package/dist-package/adapters/final-cut/typescript/src/publish-readback.d.ts +26 -0
  41. package/dist-package/adapters/final-cut/typescript/src/publish-readback.js +19 -2
  42. package/dist-package/adapters/final-cut/typescript/src/publisher.d.ts +215 -0
  43. package/dist-package/adapters/final-cut/typescript/src/publisher.js +255 -14
  44. package/dist-package/adapters/final-cut/typescript/src/session.d.ts +43 -0
  45. package/dist-package/adapters/final-cut/typescript/src/session.js +43 -13
  46. package/dist-package/adapters/final-cut/typescript/src/shadow-mutation.d.ts +51 -0
  47. package/dist-package/adapters/final-cut/typescript/src/sqlite-experiment.d.ts +156 -0
  48. package/dist-package/adapters/final-cut/typescript/src/sqlite-inspection.d.ts +134 -0
  49. package/dist-package/adapters/final-cut/typescript/src/sqlite-materialization.d.ts +110 -0
  50. package/dist-package/adapters/final-cut/typescript/src/sqlite-wal-observation.d.ts +132 -0
  51. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.d.ts +61 -0
  52. package/dist-package/adapters/final-cut/typescript/src/timeline-ir-fcpxml.js +31 -5
  53. package/dist-package/adapters/final-cut/typescript/src/unattended-editing.d.ts +54 -0
  54. package/dist-package/adapters/headless/typescript/src/audio-output.d.ts +3 -0
  55. package/dist-package/adapters/headless/typescript/src/audio-output.js +3 -0
  56. package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.d.ts +11 -0
  57. package/dist-package/adapters/headless/typescript/src/ffmpeg-media-probe.js +26 -2
  58. package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.d.ts +25 -0
  59. package/dist-package/adapters/headless/typescript/src/ffmpeg-renderer.js +37 -14
  60. package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.d.ts +15 -0
  61. package/dist-package/adapters/headless/typescript/src/ffmpeg-verifier.js +9 -4
  62. package/dist-package/adapters/headless/typescript/src/index.d.ts +3 -0
  63. package/dist-package/apps/cli/src/dev-doctor.d.ts +25 -0
  64. package/dist-package/apps/cli/src/dev-doctor.js +198 -0
  65. package/dist-package/apps/cli/src/headless-projects.d.ts +3 -0
  66. package/dist-package/apps/cli/src/headless-projects.js +5 -0
  67. package/dist-package/apps/cli/src/main.d.ts +10 -0
  68. package/dist-package/apps/cli/src/main.js +42 -0
  69. package/dist-package/apps/mcp-server/runtime/ffmpeg-audio-backend.py +129 -0
  70. package/dist-package/apps/mcp-server/runtime/speech-analyzer-wrapper.mjs +54 -0
  71. package/dist-package/apps/mcp-server/runtime/whisper-speech-backend.py +271 -0
  72. package/dist-package/apps/mcp-server/src/build-alignment.d.ts +10 -0
  73. package/dist-package/apps/mcp-server/src/build-identity.d.ts +7 -0
  74. package/dist-package/apps/mcp-server/src/build-identity.json +2 -2
  75. package/dist-package/apps/mcp-server/src/canonical-native-snapshot.d.ts +8 -0
  76. package/dist-package/apps/mcp-server/src/canonical-native-snapshot.js +18 -0
  77. package/dist-package/apps/mcp-server/src/final-cut-runtime-config.d.ts +5 -0
  78. package/dist-package/apps/mcp-server/src/final-cut-runtime-config.js +3 -0
  79. package/dist-package/apps/mcp-server/src/headless-project-snapshot.d.ts +3 -0
  80. package/dist-package/apps/mcp-server/src/headless-sessions.d.ts +89 -0
  81. package/dist-package/apps/mcp-server/src/main.d.ts +1 -0
  82. package/dist-package/apps/mcp-server/src/main.js +24 -19
  83. package/dist-package/apps/mcp-server/src/materialization-jobs.d.ts +204 -0
  84. package/dist-package/apps/mcp-server/src/materialization-jobs.js +143 -10
  85. package/dist-package/apps/mcp-server/src/readback-policy.d.ts +18 -0
  86. package/dist-package/apps/mcp-server/src/routing.d.ts +90 -0
  87. package/dist-package/apps/mcp-server/src/routing.js +2 -0
  88. package/dist-package/apps/mcp-server/src/server.d.ts +75 -0
  89. package/dist-package/apps/mcp-server/src/server.js +813 -158
  90. package/dist-package/apps/mcp-server/src/tools/skills/catalog.d.ts +19 -0
  91. package/dist-package/apps/mcp-server/src/tools/skills/catalog.js +142 -0
  92. package/dist-package/apps/mcp-server/src/tools/skills/metadata.d.ts +37 -0
  93. package/dist-package/apps/mcp-server/src/tools/skills/metadata.js +71 -0
  94. package/dist-package/apps/mcp-server/src/tools/skills/register.d.ts +11 -0
  95. package/dist-package/apps/mcp-server/src/tools/skills/register.js +101 -0
  96. package/dist-package/apps/mcp-server/src/version.d.ts +4 -0
  97. package/dist-package/packages/headless-application/src/external-edit.d.ts +30 -0
  98. package/dist-package/packages/headless-application/src/external-edit.js +72 -0
  99. package/dist-package/packages/headless-application/src/headless-projects.d.ts +233 -0
  100. package/dist-package/{apps/mcp-server → packages/headless-application}/src/headless-projects.js +392 -59
  101. package/dist-package/packages/headless-application/src/index.d.ts +2 -0
  102. package/dist-package/packages/headless-application/src/index.js +2 -0
  103. package/dist-package/packages/runtime/src/application/duration-policy-service.d.ts +4 -0
  104. package/dist-package/packages/runtime/src/application/local-media.d.ts +46 -0
  105. package/dist-package/packages/runtime/src/application/media-analysis-service.d.ts +40 -0
  106. package/dist-package/packages/runtime/src/application/media-analysis-service.js +105 -15
  107. package/dist-package/packages/runtime/src/application/project-service.d.ts +35 -0
  108. package/dist-package/packages/runtime/src/application/project-service.js +5 -1
  109. package/dist-package/packages/runtime/src/application/project-store.d.ts +56 -0
  110. package/dist-package/packages/runtime/src/application/project-store.js +13 -36
  111. package/dist-package/packages/runtime/src/application/project-transactions.d.ts +51 -0
  112. package/dist-package/packages/runtime/src/application/runtime-options.d.ts +15 -0
  113. package/dist-package/packages/runtime/src/application/semantic-media-index-store.d.ts +28 -0
  114. package/dist-package/packages/runtime/src/application/transaction-store.d.ts +10 -0
  115. package/dist-package/packages/runtime/src/application/transaction-store.js +1 -1
  116. package/dist-package/packages/runtime/src/audio/analysis.d.ts +3 -0
  117. package/dist-package/packages/runtime/src/audio/analysis.js +95 -0
  118. package/dist-package/packages/runtime/src/audio/dialogue-normalization.d.ts +47 -0
  119. package/dist-package/packages/runtime/src/audio/noise-reduction.d.ts +34 -0
  120. package/dist-package/packages/runtime/src/capabilities.d.ts +45 -0
  121. package/dist-package/packages/runtime/src/capabilities.js +1 -1
  122. package/dist-package/packages/runtime/src/color-correction.d.ts +33 -0
  123. package/dist-package/packages/runtime/src/context/context-engine.d.ts +28 -0
  124. package/dist-package/packages/runtime/src/context/context-engine.js +22 -16
  125. package/dist-package/packages/runtime/src/context/context-service.d.ts +20 -0
  126. package/dist-package/packages/runtime/src/context/context-service.js +2 -2
  127. package/dist-package/packages/runtime/src/context/project-catalog.d.ts +12 -0
  128. package/dist-package/packages/runtime/src/context/revision.d.ts +2 -0
  129. package/dist-package/packages/runtime/src/domain/capabilities.d.ts +170 -0
  130. package/dist-package/packages/runtime/src/domain/context.d.ts +179 -0
  131. package/dist-package/packages/runtime/src/domain/diff.d.ts +104 -0
  132. package/dist-package/packages/runtime/src/domain/duration.d.ts +63 -0
  133. package/dist-package/packages/runtime/src/domain/editing.d.ts +227 -0
  134. package/dist-package/packages/runtime/src/domain/incremental-sync.d.ts +67 -0
  135. package/dist-package/packages/runtime/src/domain/index.d.ts +14 -0
  136. package/dist-package/packages/runtime/src/domain/media.d.ts +406 -0
  137. package/dist-package/packages/runtime/src/domain/ports.d.ts +62 -0
  138. package/dist-package/packages/runtime/src/domain/primitives.d.ts +21 -0
  139. package/dist-package/packages/runtime/src/domain/project.d.ts +119 -0
  140. package/dist-package/packages/runtime/src/domain/rough-cut.d.ts +27 -0
  141. package/dist-package/packages/runtime/src/domain/skills.d.ts +145 -0
  142. package/dist-package/packages/runtime/src/domain/timeline-target.d.ts +57 -0
  143. package/dist-package/packages/runtime/src/domain/timeline-target.js +19 -1
  144. package/dist-package/packages/runtime/src/domain/types.d.ts +5 -0
  145. package/dist-package/packages/runtime/src/domain/verification.d.ts +92 -0
  146. package/dist-package/packages/runtime/src/editing/dialogue-normalization-service.d.ts +18 -0
  147. package/dist-package/packages/runtime/src/editing/duration-policy.d.ts +3 -0
  148. package/dist-package/packages/runtime/src/editing/edit-service.d.ts +44 -0
  149. package/dist-package/packages/runtime/src/editing/edit-service.js +76 -10
  150. package/dist-package/packages/runtime/src/editing/filler-removal-service.d.ts +23 -0
  151. package/dist-package/packages/runtime/src/editing/intent.d.ts +97 -0
  152. package/dist-package/packages/runtime/src/editing/music-service.d.ts +9 -0
  153. package/dist-package/packages/runtime/src/index.d.ts +32 -0
  154. package/dist-package/packages/runtime/src/index.js +2 -0
  155. package/dist-package/packages/runtime/src/planning/rough-cut.d.ts +3 -0
  156. package/dist-package/packages/runtime/src/render/render-and-verify.d.ts +71 -0
  157. package/dist-package/packages/runtime/src/render/render-contract.d.ts +96 -0
  158. package/dist-package/packages/runtime/src/runtime.d.ts +85 -0
  159. package/dist-package/packages/runtime/src/runtime.js +16 -7
  160. package/dist-package/packages/runtime/src/skills/builtin.d.ts +2 -0
  161. package/dist-package/packages/runtime/src/skills/index.d.ts +3 -0
  162. package/dist-package/packages/runtime/src/skills/registry.d.ts +10 -0
  163. package/dist-package/packages/runtime/src/skills/requirements.d.ts +38 -0
  164. package/dist-package/packages/runtime/src/skills/runtime.d.ts +38 -0
  165. package/dist-package/packages/runtime/src/speech/analysis.d.ts +18 -0
  166. package/dist-package/packages/runtime/src/speech/analysis.js +67 -0
  167. package/dist-package/packages/runtime/src/speech/filler-detector.d.ts +49 -0
  168. package/dist-package/packages/runtime/src/speech/filler-removal.d.ts +37 -0
  169. package/dist-package/packages/runtime/src/speech/mapping.d.ts +56 -0
  170. package/dist-package/packages/runtime/src/speech/mapping.js +27 -4
  171. package/dist-package/packages/runtime/src/speech/safe-cut-resolver.d.ts +52 -0
  172. package/dist-package/packages/runtime/src/timeline/drift-reconciliation.d.ts +42 -0
  173. package/dist-package/packages/runtime/src/timeline/editing-session.d.ts +271 -0
  174. package/dist-package/packages/runtime/src/timeline/editing-session.js +48 -2
  175. package/dist-package/packages/runtime/src/timeline/fast-observation.d.ts +77 -0
  176. package/dist-package/packages/runtime/src/timeline/rational-time.d.ts +11 -0
  177. package/dist-package/packages/runtime/src/timeline/reorder-preview.d.ts +32 -0
  178. package/dist-package/packages/runtime/src/timeline/reorder-preview.js +202 -0
  179. package/dist-package/packages/runtime/src/timeline/snapshot-diff.d.ts +3 -0
  180. package/dist-package/packages/runtime/src/timeline/snapshot-diff.js +1 -0
  181. package/dist-package/packages/runtime/src/timeline/snapshot-digest.d.ts +3 -0
  182. package/dist-package/packages/runtime/src/timeline/snapshot-digest.js +1 -1
  183. package/dist-package/packages/runtime/src/verification/verification.d.ts +6 -0
  184. package/dist-package/packages/testkit/src/fixture-analyzers.d.ts +37 -0
  185. package/dist-package/packages/testkit/src/in-memory-editor.d.ts +55 -0
  186. package/dist-package/packages/testkit/src/in-memory-editor.js +3 -3
  187. package/dist-package/packages/testkit/src/index.d.ts +4 -0
  188. package/dist-package/packages/testkit/src/index.js +1 -0
  189. package/dist-package/packages/testkit/src/sender-lifecycle-fixture.d.ts +47 -0
  190. package/dist-package/packages/testkit/src/sender-lifecycle-fixture.js +192 -0
  191. package/dist-package/packages/testkit/src/skill-fixtures.d.ts +3 -0
  192. package/package.json +41 -14
@@ -0,0 +1,95 @@
1
+ import { parseRational } from "../timeline/rational-time.js";
2
+ /** Validate the measurement payload before binding provenance or serializing it. */
3
+ export function validateAudioAnalysisPayload(value) {
4
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
5
+ throw new Error("ANALYSIS_INVALID: audio analysis must be an object");
6
+ }
7
+ const analysis = value;
8
+ if (analysis.signalScope !== undefined && analysis.signalScope !== "source" && analysis.signalScope !== "occurrence") {
9
+ throw new Error("ANALYSIS_INVALID: unsupported audio signal scope");
10
+ }
11
+ if (analysis.signalScope === "occurrence"
12
+ && (typeof analysis.occurrenceId !== "string" || !analysis.occurrenceId.trim())) {
13
+ throw new Error("ANALYSIS_INVALID: occurrence audio requires an occurrence identity");
14
+ }
15
+ for (const field of ["integratedLufs", "truePeakDb", "silenceMs"]) {
16
+ const measured = analysis[field];
17
+ if (typeof measured !== "number" || !Number.isFinite(measured)) {
18
+ throw new Error(`ANALYSIS_INVALID: audio ${field} must be finite`);
19
+ }
20
+ }
21
+ if (analysis.silenceMs < 0) {
22
+ throw new Error("ANALYSIS_INVALID: audio silenceMs must be nonnegative");
23
+ }
24
+ if (analysis.analyzedDurationSeconds !== undefined
25
+ && (typeof analysis.analyzedDurationSeconds !== "number"
26
+ || !Number.isFinite(analysis.analyzedDurationSeconds) || analysis.analyzedDurationSeconds <= 0)) {
27
+ throw new Error("ANALYSIS_INVALID: audio analyzedDurationSeconds must be finite and positive");
28
+ }
29
+ if (analysis.audibleSamples !== undefined
30
+ && (typeof analysis.audibleSamples !== "number" || !Number.isSafeInteger(analysis.audibleSamples)
31
+ || analysis.audibleSamples < 0)) {
32
+ throw new Error("ANALYSIS_INVALID: audio audibleSamples must be a nonnegative safe integer");
33
+ }
34
+ for (const field of ["dialoguePresent", "valid"]) {
35
+ if (analysis[field] !== undefined && typeof analysis[field] !== "boolean") {
36
+ throw new Error(`ANALYSIS_INVALID: audio ${field} must be boolean`);
37
+ }
38
+ }
39
+ if (analysis.invalidReason !== undefined && typeof analysis.invalidReason !== "string") {
40
+ throw new Error("ANALYSIS_INVALID: audio invalidReason must be text");
41
+ }
42
+ if (analysis.sourceTimebase !== undefined)
43
+ rationalSeconds(analysis.sourceTimebase, "sourceTimebase");
44
+ for (const field of ["requestedRange", "measuredRange"]) {
45
+ if (analysis[field] !== undefined)
46
+ validateAudioAnalysisRange(analysis[field], field);
47
+ }
48
+ if (analysis.signalFormat !== undefined) {
49
+ const format = analysis.signalFormat;
50
+ if (!format || typeof format !== "object" || Array.isArray(format)) {
51
+ throw new Error("ANALYSIS_INVALID: audio signalFormat must be an object");
52
+ }
53
+ for (const field of ["sampleRate", "channels"]) {
54
+ const count = format[field];
55
+ if (typeof count !== "number" || !Number.isSafeInteger(count) || count <= 0) {
56
+ throw new Error(`ANALYSIS_INVALID: audio signalFormat ${field} must be a positive safe integer`);
57
+ }
58
+ }
59
+ const layout = format.channelLayout;
60
+ if (layout !== undefined && (typeof layout !== "string" || !layout.trim())) {
61
+ throw new Error("ANALYSIS_INVALID: audio channelLayout must be nonempty text");
62
+ }
63
+ }
64
+ }
65
+ function rationalSeconds(value, label, allowZero = false) {
66
+ if (!value || typeof value !== "object" || Array.isArray(value)
67
+ || typeof value.value !== "string"
68
+ || typeof value.timescale !== "string") {
69
+ throw new Error(`ANALYSIS_INVALID: audio ${label} must be a rational time`);
70
+ }
71
+ const parsed = parseRational(value, "ANALYSIS_INVALID");
72
+ const seconds = Number(parsed.value) / Number(parsed.timescale);
73
+ if (!Number.isFinite(seconds) || (allowZero ? seconds < 0 : seconds <= 0)) {
74
+ throw new Error(`ANALYSIS_INVALID: audio ${label} must be ${allowZero ? "nonnegative" : "positive"}`);
75
+ }
76
+ return seconds;
77
+ }
78
+ export function validateAudioAnalysisRange(value, label) {
79
+ if (!value || typeof value !== "object" || Array.isArray(value)) {
80
+ throw new Error(`ANALYSIS_INVALID: audio ${label} must be a range`);
81
+ }
82
+ const range = value;
83
+ if (typeof range.start !== "number" || typeof range.end !== "number"
84
+ || !Number.isFinite(range.start) || !Number.isFinite(range.end) || range.start < 0 || range.end <= range.start) {
85
+ throw new Error(`ANALYSIS_INVALID: audio ${label} must be finite and positive`);
86
+ }
87
+ if (range.startTime !== undefined
88
+ && Math.abs(rationalSeconds(range.startTime, label + " start", true) - range.start) > 0.000000001) {
89
+ throw new Error(`ANALYSIS_INVALID: audio ${label} numeric and rational start differ`);
90
+ }
91
+ if (range.durationTime !== undefined
92
+ && Math.abs(rationalSeconds(range.durationTime, label + " duration") - (range.end - range.start)) > 0.000000001) {
93
+ throw new Error(`ANALYSIS_INVALID: audio ${label} numeric and rational duration differ`);
94
+ }
95
+ }
@@ -0,0 +1,47 @@
1
+ import type { AudioMeasurement } from "../domain/media.js";
2
+ import type { ContextRevision } from "../domain/primitives.js";
3
+ import type { EditOperation } from "../domain/editing.js";
4
+ import type { TimelineDiff } from "../domain/diff.js";
5
+ export type DialogueGainDecision = "APPLY" | "NO_OP" | "SKIP";
6
+ export type DialogueGainReasonCode = "APPLY_GAIN" | "ALREADY_IN_TOLERANCE" | "MEASUREMENT_INVALID" | "NO_DIALOGUE" | "SILENCE" | "DIALOGUE_TOO_SHORT" | "GAIN_OUT_OF_BOUNDS" | "PEAK_RISK";
7
+ export interface DialogueGainPlanningOptions {
8
+ targetLufs: number;
9
+ toleranceDb: number;
10
+ maxTruePeakDb: number;
11
+ minGainDb: number;
12
+ maxGainDb: number;
13
+ minDialogueDurationSeconds: number;
14
+ }
15
+ export interface DialogueGainPlan extends DialogueGainPlanningOptions {
16
+ decision: DialogueGainDecision;
17
+ currentLufs: number;
18
+ desiredGainDb: number;
19
+ clampedGainDb: number;
20
+ estimatedPeakDb: number;
21
+ reasonCodes: DialogueGainReasonCode[];
22
+ }
23
+ export interface DialogueNormalizationRequest extends DialogueGainPlanningOptions {
24
+ mediaId: string;
25
+ occurrenceId: string;
26
+ baseRevision: ContextRevision;
27
+ }
28
+ export interface DialogueNormalizationPreview {
29
+ measurement: AudioMeasurement;
30
+ plan: DialogueGainPlan;
31
+ operations: EditOperation[];
32
+ expectedDiff?: TimelineDiff;
33
+ previewToken?: string;
34
+ warnings: string[];
35
+ expiresAt?: string;
36
+ }
37
+ /** Defaults for the version 1.0.0 dialogue-normalization Skill. */
38
+ export declare const DIALOGUE_NORMALIZATION_DEFAULTS: {
39
+ readonly targetLufs: -16;
40
+ readonly toleranceDb: 0.5;
41
+ readonly maxTruePeakDb: -1;
42
+ readonly minGainDb: -6;
43
+ readonly maxGainDb: 6;
44
+ readonly minDialogueDurationSeconds: 1;
45
+ };
46
+ /** Plan a bounded clip-level gain change without mutating an editor. */
47
+ export declare function planDialogueGain(measurement: AudioMeasurement, options: DialogueGainPlanningOptions): DialogueGainPlan;
@@ -0,0 +1,34 @@
1
+ import type { ContextRevision } from "../domain/primitives.js";
2
+ import type { EditOperation } from "../domain/editing.js";
3
+ import type { NoiseMeasurement } from "../domain/media.js";
4
+ import type { TimelineDiff } from "../domain/diff.js";
5
+ export type NoiseReductionDecision = "APPLY" | "NO_OP" | "SKIP";
6
+ export type NoiseReductionReasonCode = "APPLY_NOISE_REDUCTION" | "ALREADY_BELOW_THRESHOLD" | "MEASUREMENT_INVALID" | "NO_AFFECTED_RANGE" | "CONFIDENCE_TOO_LOW" | "REDUCTION_INVALID";
7
+ export interface NoiseReductionPlanningOptions {
8
+ noiseThresholdDb: number;
9
+ maxReductionDb: number;
10
+ minConfidence: number;
11
+ }
12
+ export interface NoiseReductionRequest extends NoiseReductionPlanningOptions {
13
+ mediaId: string;
14
+ occurrenceId: string;
15
+ baseRevision: ContextRevision;
16
+ }
17
+ export interface NoiseReductionPlan extends NoiseReductionPlanningOptions {
18
+ decision: NoiseReductionDecision;
19
+ noiseFloorDb: number;
20
+ recommendedReductionDb: number;
21
+ reductionDb: number;
22
+ affectedRanges: NoiseMeasurement["affectedRanges"];
23
+ reasonCodes: NoiseReductionReasonCode[];
24
+ }
25
+ export interface NoiseReductionPreview {
26
+ measurement: NoiseMeasurement;
27
+ plan: NoiseReductionPlan;
28
+ operations: EditOperation[];
29
+ expectedDiff?: TimelineDiff;
30
+ previewToken?: string;
31
+ warnings: string[];
32
+ expiresAt?: string;
33
+ }
34
+ export declare function planNoiseReduction(measurement: NoiseMeasurement, options: NoiseReductionPlanningOptions): NoiseReductionPlan;
@@ -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;
@@ -156,7 +156,7 @@ export function withCapabilityFamilies(capabilities, options = {}) {
156
156
  editing: editingFamily(editor, editing, options.editingBackend ?? previous?.editing?.compositeTransactions.backend ?? backend),
157
157
  native: nativeFamily(native, options.nativeBackend ?? previous?.native.selectionWrite.backend ?? backend),
158
158
  publishing: {
159
- projectCreation: descriptorFrom(options.publishing ?? previous?.publishing.projectCreation ?? false, options.publishingBackend ?? backend, "verified", "new project publishing is unavailable"),
159
+ projectCreation: descriptorFrom(options.publishing ?? previous?.publishing.projectCreation ?? false, options.publishingBackend ?? backend, options.publishingGuarantee ?? "verified", "new project publishing is unavailable"),
160
160
  },
161
161
  export: {
162
162
  timeline: exportDescriptor(options.export ?? previous?.export.timeline ?? false, options.exportBackend ?? backend, "verified", "timeline export is unavailable", "headed-native"),
@@ -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
+ }
@@ -16,7 +16,9 @@ export class ContextEngine {
16
16
  return enriched;
17
17
  }
18
18
  async changesSince(revision) {
19
- const capabilities = await this.editor.getCapabilities();
19
+ const capabilities = await this.editor.getCapabilities({ probeCanonicalSnapshot: false });
20
+ if (requiresHeadedCanonicalRead(capabilities))
21
+ throw new Error("CAPABILITY_UNAVAILABLE: canonical timeline changes require an explicitly authorized headed read");
20
22
  if (capabilities.editor.incrementalChanges) {
21
23
  const incremental = await this.editor.readChanges?.(revision);
22
24
  if (incremental?.timeline)
@@ -32,8 +34,9 @@ export class ContextEngine {
32
34
  }
33
35
  async timelineChangesSince(request) {
34
36
  const identity = await this.editor.getIdentity();
35
- const capabilities = await this.editor.getCapabilities();
36
- const canonical = capabilities.editor.canonicalTimelineMode !== "metadata-only"
37
+ const capabilities = await this.editor.getCapabilities({ probeCanonicalSnapshot: false });
38
+ const canonical = !requiresHeadedCanonicalRead(capabilities)
39
+ && capabilities.editor.canonicalTimelineMode !== "metadata-only"
37
40
  && (capabilities.editor.timelineSnapshotRead || capabilities.editor.incrementalChanges);
38
41
  const source = {
39
42
  source: identity.name,
@@ -143,20 +146,20 @@ export class ContextEngine {
143
146
  if (cursor?.target)
144
147
  await this.validateCursorTarget(revision, cursor.target);
145
148
  const identity = await this.editor.getIdentity();
146
- const capabilities = withCanonicalTimelineMode(withCapabilityFamilies(await this.editor.getCapabilities(), {
149
+ const capabilities = withCanonicalTimelineMode(withCapabilityFamilies(await this.editor.getCapabilities({ probeCanonicalSnapshot: false }), {
147
150
  backend: identity.backend,
148
151
  }));
149
- const incremental = capabilities.editor.incrementalChanges
152
+ const incremental = capabilities.editor.incrementalChanges && !requiresHeadedCanonicalRead(capabilities)
150
153
  ? await this.editor.readChanges?.(revision)
151
154
  : undefined;
152
- const timeline = canonicalTimelineAvailable(capabilities)
155
+ const timeline = canonicalTimelineAvailable(capabilities) && !requiresHeadedCanonicalRead(capabilities)
153
156
  ? incremental?.timeline ?? await this.optionalTimelineChanges(revision)
154
157
  : undefined;
155
158
  const stateChanges = [
156
159
  ...(incremental?.stateChanges ?? []),
157
160
  ...(await this.liveChangesSince(revision, waitMs)),
158
161
  ];
159
- const assetChanges = canonicalTimelineAvailable(capabilities)
162
+ const assetChanges = canonicalTimelineAvailable(capabilities) && !requiresHeadedCanonicalRead(capabilities)
160
163
  ? incremental?.assetChanges ?? []
161
164
  : [];
162
165
  // Canonical timeline revisions and live metadata revisions may come from
@@ -204,9 +207,9 @@ export class ContextEngine {
204
207
  throw new Error(`TARGET_MISMATCH: cursor target ${formatContextTarget(target)} does not match the active target`);
205
208
  }
206
209
  }
207
- async inspectContext(capabilities) {
210
+ async inspectContext(capabilities, options = {}) {
208
211
  const identity = await this.editor.getIdentity();
209
- const project = canonicalTimelineAvailable(capabilities)
212
+ const project = options.includeCanonicalSnapshot !== false && canonicalTimelineAvailable(capabilities)
210
213
  ? await this.inspectProject()
211
214
  : undefined;
212
215
  const editorState = await this.optionalLiveState();
@@ -216,7 +219,7 @@ export class ContextEngine {
216
219
  const target = contextTarget(project, editorState ? [
217
220
  { kind: "active-sequence-changed", revision: editorState.revision, state: editorState },
218
221
  ] : []);
219
- const provenance = primaryContextProvenance(identity.backend, capabilities, target);
222
+ const provenance = primaryContextProvenance(identity.backend, capabilities, target, Boolean(project));
220
223
  const cursor = { revision, ...(target ? { target } : {}) };
221
224
  return {
222
225
  revision,
@@ -287,8 +290,8 @@ export class ContextEngine {
287
290
  return this.editor.listAssets(query);
288
291
  }
289
292
  async optionalTimelineChanges(revision) {
290
- const capabilities = await this.editor.getCapabilities();
291
- if (!capabilities.editor.timelineSnapshotRead)
293
+ const capabilities = await this.editor.getCapabilities({ probeCanonicalSnapshot: false });
294
+ if (!capabilities.editor.timelineSnapshotRead || requiresHeadedCanonicalRead(capabilities))
292
295
  return undefined;
293
296
  return this.changesSince(revision);
294
297
  }
@@ -343,15 +346,18 @@ export class ContextEngine {
343
346
  return next;
344
347
  }
345
348
  }
349
+ function requiresHeadedCanonicalRead(capabilities) {
350
+ return capabilities.families?.canonicalDocument.read.evidenceTier === "headed-native";
351
+ }
346
352
  function canonicalTimelineAvailable(capabilities) {
347
353
  return Boolean(capabilities.editor.projectRead
348
354
  && capabilities.editor.timelineSnapshotRead
349
355
  && capabilities.editor.canonicalTimelineMode !== "metadata-only");
350
356
  }
351
- function primaryContextProvenance(provider, capabilities, target) {
357
+ function primaryContextProvenance(provider, capabilities, target, canonicalObserved = true) {
352
358
  const artifact = capabilities.editor.timelineArtifactWrite && !capabilities.editor.timelineWrite;
353
- const canonical = capabilities.editor.canonicalTimelineMode === "canonical-read"
354
- || capabilities.editor.canonicalTimelineMode === "canonical-write";
359
+ const canonical = canonicalObserved && (capabilities.editor.canonicalTimelineMode === "canonical-read"
360
+ || capabilities.editor.canonicalTimelineMode === "canonical-write");
355
361
  const headedNative = canonical && provider.includes("native");
356
362
  const source = provider === "fixture"
357
363
  ? "deterministic-fixture"
@@ -377,7 +383,7 @@ function primaryContextProvenance(provider, capabilities, target) {
377
383
  };
378
384
  }
379
385
  function contextProvenanceSet(provider, capabilities, target, changes) {
380
- const base = primaryContextProvenance(provider, capabilities, target);
386
+ const base = primaryContextProvenance(provider, capabilities, target, !requiresHeadedCanonicalRead(capabilities));
381
387
  const result = [];
382
388
  if (changes.timeline || changes.assetChanges.length > 0)
383
389
  result.push(base);
@@ -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
+ }
@@ -5,8 +5,8 @@ export class ContextService {
5
5
  this.adapter = adapter;
6
6
  this.context = context;
7
7
  }
8
- async inspectContext(capabilities) {
9
- return this.context.inspectContext(capabilities);
8
+ async inspectContext(capabilities, options = {}) {
9
+ return this.context.inspectContext(capabilities, options);
10
10
  }
11
11
  async inspectLiveEditor() {
12
12
  return this.liveAdapter().readLiveState();
@@ -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,2 @@
1
+ import type { ContextRevision } from "../domain/primitives.js";
2
+ export declare function sameRevision(left: ContextRevision, right: ContextRevision): boolean;
@@ -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
+ }