@morshoto/framekit 0.1.0 → 0.1.5

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 (65) hide show
  1. package/README.md +42 -17
  2. package/dist-package/adapters/final-cut/typescript/src/analyzers.js +86 -2
  3. package/dist-package/adapters/final-cut/typescript/src/connection.js +5 -1
  4. package/dist-package/adapters/final-cut/typescript/src/export.js +231 -8
  5. package/dist-package/adapters/final-cut/typescript/src/fcpxml.js +70 -9
  6. package/dist-package/adapters/final-cut/typescript/src/live.js +2 -2
  7. package/dist-package/adapters/final-cut/typescript/src/native.js +1000 -100
  8. package/dist-package/adapters/final-cut/typescript/src/publisher.js +242 -30
  9. package/dist-package/adapters/final-cut/typescript/src/session.js +86 -9
  10. package/dist-package/apps/mcp-server/src/main.js +10 -1
  11. package/dist-package/apps/mcp-server/src/routing.js +172 -0
  12. package/dist-package/apps/mcp-server/src/server.js +867 -52
  13. package/dist-package/apps/mcp-server/src/version.js +34 -0
  14. package/dist-package/packages/runtime/src/application/duration-policy-service.js +6 -0
  15. package/dist-package/packages/runtime/src/application/media-analysis-service.js +473 -0
  16. package/dist-package/packages/runtime/src/application/project-service.js +146 -0
  17. package/dist-package/packages/runtime/src/application/runtime-options.js +1 -0
  18. package/dist-package/packages/runtime/src/application/transaction-store.js +12 -0
  19. package/dist-package/packages/runtime/src/audio/dialogue-normalization.js +64 -0
  20. package/dist-package/packages/runtime/src/audio/noise-reduction.js +46 -0
  21. package/dist-package/packages/runtime/src/capabilities.js +187 -1
  22. package/dist-package/packages/runtime/src/color-correction.js +48 -0
  23. package/dist-package/packages/runtime/src/context/context-engine.js +20 -6
  24. package/dist-package/packages/runtime/src/context/context-service.js +30 -0
  25. package/dist-package/packages/runtime/src/context/revision.js +3 -0
  26. package/dist-package/packages/runtime/src/domain/capabilities.js +1 -0
  27. package/dist-package/packages/runtime/src/domain/context.js +1 -0
  28. package/dist-package/packages/runtime/src/domain/diff.js +1 -0
  29. package/dist-package/packages/runtime/src/domain/duration.js +1 -0
  30. package/dist-package/packages/runtime/src/domain/editing.js +1 -0
  31. package/dist-package/packages/runtime/src/domain/index.js +12 -0
  32. package/dist-package/packages/runtime/src/domain/media.js +8 -0
  33. package/dist-package/packages/runtime/src/domain/ports.js +1 -0
  34. package/dist-package/packages/runtime/src/domain/primitives.js +1 -0
  35. package/dist-package/packages/runtime/src/domain/project.js +1 -0
  36. package/dist-package/packages/runtime/src/domain/rough-cut.js +69 -0
  37. package/dist-package/packages/runtime/src/domain/skills.js +33 -0
  38. package/dist-package/packages/runtime/src/domain/types.js +5 -1
  39. package/dist-package/packages/runtime/src/domain/verification.js +1 -0
  40. package/dist-package/packages/runtime/src/editing/dialogue-normalization-service.js +141 -0
  41. package/dist-package/packages/runtime/src/editing/duration-policy.js +187 -0
  42. package/dist-package/packages/runtime/src/editing/edit-service.js +449 -0
  43. package/dist-package/packages/runtime/src/editing/filler-removal-service.js +361 -0
  44. package/dist-package/packages/runtime/src/editing/music-service.js +85 -0
  45. package/dist-package/packages/runtime/src/index.js +14 -3
  46. package/dist-package/packages/runtime/src/planning/rough-cut.js +71 -0
  47. package/dist-package/packages/runtime/src/runtime.js +131 -826
  48. package/dist-package/packages/runtime/src/skills/builtin.js +339 -0
  49. package/dist-package/packages/runtime/src/skills/index.js +3 -0
  50. package/dist-package/packages/runtime/src/skills/registry.js +74 -0
  51. package/dist-package/packages/runtime/src/skills/requirements.js +170 -0
  52. package/dist-package/packages/runtime/src/skills/runtime.js +239 -0
  53. package/dist-package/packages/runtime/src/speech/analysis.js +301 -0
  54. package/dist-package/packages/runtime/src/speech/filler-detector.js +132 -0
  55. package/dist-package/packages/runtime/src/speech/mapping.js +227 -0
  56. package/dist-package/packages/runtime/src/speech/safe-cut-resolver.js +314 -0
  57. package/dist-package/packages/runtime/src/timeline/rational-time.js +63 -0
  58. package/dist-package/packages/runtime/src/verification/verification.js +712 -1
  59. package/dist-package/packages/testkit/src/fixture-analyzers.js +28 -0
  60. package/dist-package/packages/testkit/src/in-memory-editor.js +287 -3
  61. package/dist-package/packages/testkit/src/index.js +1 -0
  62. package/dist-package/packages/testkit/src/skill-fixtures.js +64 -0
  63. package/package.json +17 -8
  64. /package/dist-package/packages/runtime/src/{diff/diff.js → timeline/snapshot-diff.js} +0 -0
  65. /package/dist-package/packages/runtime/src/{snapshot-digest.js → timeline/snapshot-digest.js} +0 -0
@@ -0,0 +1,172 @@
1
+ export const EDITOR_FIRST_WORKFLOW = [
2
+ "connection.status",
3
+ "editor.inspect",
4
+ "project.inspect",
5
+ "editing.route",
6
+ "editing.intent.resolve",
7
+ "timeline.edit.preview",
8
+ "timeline.edit.execute",
9
+ "context.inspect",
10
+ "edit.diff",
11
+ "edit.verify",
12
+ ];
13
+ export const EDITOR_FIRST_MCP_INSTRUCTIONS = [
14
+ "Framekit uses an editor-first workflow for every editing request.",
15
+ "1. Call connection.status to establish whether the expected editor is connected.",
16
+ "2. Call editor.inspect to read the selected editor identity and capabilities.",
17
+ "3. Inspect the active project with project.inspect before selecting an editing path.",
18
+ "4. Call editing.route and use only a path whose required capabilities are advertised.",
19
+ "5. Resolve intent when needed, then preview before execute; never mutate on an unavailable capability.",
20
+ "6. Observe the result, then use edit.diff and edit.verify to confirm the change.",
21
+ "An external renderer is never an implicit substitute for a connected editor. Select fallback: external-renderer explicitly and report the structured reason returned by editing.route.",
22
+ ].join("\n");
23
+ const operationRequirements = {
24
+ "timeline.edit": [
25
+ editorRequirement("projectRead"),
26
+ editorRequirement("timelineSnapshotRead"),
27
+ {
28
+ label: "editor.timelineWrite|editor.timelineArtifactWrite",
29
+ satisfied: (context) => Boolean(context.editor?.capabilities.editor.timelineWrite
30
+ || context.editor?.capabilities.editor.timelineArtifactWrite),
31
+ },
32
+ editorRequirement("readAfterWrite"),
33
+ editorRequirement("rollback"),
34
+ ],
35
+ "editor.native.edit": [
36
+ nativeRequirement("selectionEdit"),
37
+ nativeRequirement("timelineFocus"),
38
+ nativeRequirement("undo"),
39
+ ],
40
+ "timeline.publish.new-project": [
41
+ {
42
+ label: "editor.artifactPublish",
43
+ satisfied: (context) => Boolean(context.editor?.capabilities.editor.artifactPublish
44
+ || context.editor?.capabilities.editor.timelinePublishNewProject),
45
+ },
46
+ ],
47
+ "timeline.export": [
48
+ editorRequirement("videoExport"),
49
+ ],
50
+ };
51
+ export function resolveEditingRoute(request, context) {
52
+ const requirements = operationRequirements[request.operation];
53
+ const requiredCapabilities = requirements.map((requirement) => requirement.label);
54
+ const missingCapabilities = requirements
55
+ .filter((requirement) => !requirement.satisfied(context))
56
+ .map((requirement) => requirement.label);
57
+ const editor = context.editor?.identity;
58
+ if (request.fallback === "external-renderer") {
59
+ const cause = externalFallbackCause(context, missingCapabilities);
60
+ return {
61
+ operation: request.operation,
62
+ status: "external-fallback-selected",
63
+ selectedPath: "external-renderer",
64
+ requiredCapabilities,
65
+ missingCapabilities,
66
+ ...(editor ? { editor } : {}),
67
+ workflow: [...EDITOR_FIRST_WORKFLOW],
68
+ reason: {
69
+ code: "EXTERNAL_FALLBACK_SELECTED",
70
+ message: "The external renderer was selected explicitly; Framekit will not invoke it or bypass the editor silently.",
71
+ connectionState: context.connection.state,
72
+ cause,
73
+ },
74
+ };
75
+ }
76
+ const offlineArtifactEdit = request.operation === "timeline.edit"
77
+ && context.editor?.capabilities.editor.timelineArtifactWrite === true;
78
+ if (context.connection.state !== "ready" && !offlineArtifactEdit) {
79
+ return {
80
+ operation: request.operation,
81
+ status: "unavailable",
82
+ selectedPath: "none",
83
+ requiredCapabilities,
84
+ missingCapabilities,
85
+ ...(editor ? { editor } : {}),
86
+ workflow: [...EDITOR_FIRST_WORKFLOW],
87
+ reason: editorUnavailableReason(context, missingCapabilities),
88
+ };
89
+ }
90
+ if (missingCapabilities.length > 0 || !context.editor) {
91
+ return {
92
+ operation: request.operation,
93
+ status: "unavailable",
94
+ selectedPath: "none",
95
+ requiredCapabilities,
96
+ missingCapabilities,
97
+ ...(editor ? { editor } : {}),
98
+ workflow: [...EDITOR_FIRST_WORKFLOW],
99
+ reason: {
100
+ code: "CAPABILITY_UNAVAILABLE",
101
+ message: `The connected editor cannot satisfy ${request.operation}; no alternate editor path was selected.`,
102
+ connectionState: context.connection.state,
103
+ },
104
+ };
105
+ }
106
+ return {
107
+ operation: request.operation,
108
+ status: "editor-selected",
109
+ selectedPath: "editor",
110
+ requiredCapabilities,
111
+ missingCapabilities: [],
112
+ editor,
113
+ workflow: [...EDITOR_FIRST_WORKFLOW],
114
+ reason: {
115
+ code: "EDITOR_SELECTED",
116
+ message: "The connected editor satisfies the required capabilities; continue with the preview and execute contract.",
117
+ connectionState: context.connection.state,
118
+ },
119
+ };
120
+ }
121
+ function editorRequirement(capability) {
122
+ return {
123
+ label: `editor.${capability}`,
124
+ satisfied: (context) => Boolean(context.editor?.capabilities.editor[capability]),
125
+ };
126
+ }
127
+ function nativeRequirement(capability) {
128
+ return {
129
+ label: `native.${capability}`,
130
+ satisfied: (context) => context.native?.[capability] === true,
131
+ };
132
+ }
133
+ function externalFallbackCause(context, missingCapabilities) {
134
+ if (context.connection.state !== "ready") {
135
+ return context.connection.lastError ?? {
136
+ code: "EDITOR_UNAVAILABLE",
137
+ message: `The expected editor is unavailable while the connection is ${context.connection.state}.`,
138
+ };
139
+ }
140
+ if (missingCapabilities.length > 0 || !context.editor) {
141
+ return {
142
+ code: "CAPABILITY_UNAVAILABLE",
143
+ message: "The connected editor does not advertise every capability required by this operation.",
144
+ };
145
+ }
146
+ return {
147
+ code: "USER_SELECTED_EXTERNAL_FALLBACK",
148
+ message: "The caller explicitly selected the external renderer even though the editor is available.",
149
+ };
150
+ }
151
+ function editorUnavailableReason(context, missingCapabilities) {
152
+ if (context.connection.state !== "ready") {
153
+ return {
154
+ code: "EDITOR_UNAVAILABLE",
155
+ message: `The expected editor is unavailable while the connection is ${context.connection.state}.`,
156
+ connectionState: context.connection.state,
157
+ ...(context.connection.lastError ? { cause: context.connection.lastError } : {}),
158
+ };
159
+ }
160
+ if (missingCapabilities.length > 0 || !context.editor) {
161
+ return {
162
+ code: "CAPABILITY_UNAVAILABLE",
163
+ message: "The connected editor does not advertise every capability required by this operation.",
164
+ connectionState: context.connection.state,
165
+ };
166
+ }
167
+ return {
168
+ code: "CAPABILITY_UNAVAILABLE",
169
+ message: "The connected editor does not advertise every capability required by this operation.",
170
+ connectionState: context.connection.state,
171
+ };
172
+ }