@contractspec/lib.contracts-integrations 2.4.0 → 2.5.0

package/dist/integrations/providers/openai-image.d.ts

@@ -0,0 +1,3 @@
+import { IntegrationSpecRegistry } from '../spec';
+export declare const openaiImageIntegrationSpec: import("..").IntegrationSpec;
+export declare function registerOpenaiImageIntegration(registry: IntegrationSpecRegistry): IntegrationSpecRegistry;

package/dist/integrations/providers/openai-image.js

@@ -0,0 +1,96 @@
+// @bun
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/openai-image.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var openaiImageIntegrationSpec = defineIntegration({
+  meta: {
+    key: "ai-image.openai",
+    version: "1.0.0",
+    category: "ai-image",
+    title: "OpenAI Image Generation",
+    description: "OpenAI integration for AI image generation using DALL-E and gpt-image models.",
+    domain: "ai",
+    owners: ["platform.ai"],
+    tags: ["image", "generation", "dall-e", "gpt-image"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["managed", "byok"],
+  capabilities: {
+    provides: [{ key: "ai.image.generation", version: "1.0.0" }]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        model: {
+          type: "string",
+          description: "OpenAI image model identifier (e.g. dall-e-3, gpt-image-1)."
+        },
+        defaultSize: {
+          type: "string",
+          enum: ["1024x1024", "1024x1792", "1792x1024"]
+        },
+        defaultQuality: {
+          type: "string",
+          enum: ["standard", "hd"]
+        }
+      }
+    },
+    example: {
+      model: "dall-e-3",
+      defaultSize: "1024x1024",
+      defaultQuality: "standard"
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["apiKey"],
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "OpenAI API key with image generation permissions."
+        }
+      }
+    },
+    example: {
+      apiKey: "sk-***"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 5000
+  },
+  docsUrl: "https://platform.openai.com/docs/guides/images",
+  constraints: {
+    rateLimit: {
+      rpm: 50
+    }
+  },
+  byokSetup: {
+    setupInstructions: "Create an OpenAI API key with image generation access enabled."
+  }
+});
+function registerOpenaiImageIntegration(registry) {
+  return registry.register(openaiImageIntegrationSpec);
+}
+export {
+  registerOpenaiImageIntegration,
+  openaiImageIntegrationSpec
+};

package/dist/integrations/providers/openai-realtime.d.ts

@@ -0,0 +1,3 @@
+import { IntegrationSpecRegistry } from '../spec';
+export declare const openaiRealtimeIntegrationSpec: import("..").IntegrationSpec;
+export declare function registerOpenaiRealtimeIntegration(registry: IntegrationSpecRegistry): IntegrationSpecRegistry;

package/dist/integrations/providers/openai-realtime.js

@@ -0,0 +1,97 @@
+// @bun
+// src/integrations/spec.ts
+import { SpecContractRegistry } from "@contractspec/lib.contracts-spec/registry";
+var integrationKey = (meta) => `${meta.key}.v${meta.version}`;
+
+class IntegrationSpecRegistry extends SpecContractRegistry {
+  constructor(items) {
+    super("integration", items);
+  }
+  getByCategory(category) {
+    return this.list().filter((spec) => spec.meta.category === category);
+  }
+}
+function makeIntegrationSpecKey(meta) {
+  return integrationKey(meta);
+}
+var defineIntegration = (spec) => spec;
+
+// src/integrations/providers/openai-realtime.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var openaiRealtimeIntegrationSpec = defineIntegration({
+  meta: {
+    key: "ai-voice-conv.openai",
+    version: "1.0.0",
+    category: "ai-voice-conversational",
+    title: "OpenAI Realtime Voice",
+    description: "OpenAI Realtime API integration for bidirectional conversational voice with GPT models.",
+    domain: "ai",
+    owners: ["platform.ai"],
+    tags: ["voice", "conversational", "realtime", "openai"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["byok"],
+  capabilities: {
+    provides: [{ key: "ai.voice.conversational", version: "1.0.0" }]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        model: {
+          type: "string",
+          description: "OpenAI model for realtime conversations (e.g. gpt-4o-realtime-preview)."
+        },
+        defaultVoice: {
+          type: "string",
+          description: "Default voice for agent responses (e.g. alloy, echo, shimmer)."
+        },
+        turnDetection: {
+          type: "string",
+          enum: ["server_vad", "push_to_talk"],
+          description: "Turn detection strategy."
+        },
+        maxSessionDurationSeconds: {
+          type: "number",
+          description: "Maximum session duration in seconds."
+        }
+      }
+    },
+    example: {
+      model: "gpt-4o-realtime-preview",
+      defaultVoice: "alloy",
+      turnDetection: "server_vad",
+      maxSessionDurationSeconds: 600
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["apiKey"],
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "OpenAI API key with realtime API access."
+        }
+      }
+    },
+    example: {
+      apiKey: "sk-***"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 5000
+  },
+  docsUrl: "https://platform.openai.com/docs/guides/realtime",
+  byokSetup: {
+    setupInstructions: "Create an OpenAI API key with Realtime API access enabled and store it in your secret provider."
+  }
+});
+function registerOpenaiRealtimeIntegration(registry) {
+  return registry.register(openaiRealtimeIntegrationSpec);
+}
+export {
+  registerOpenaiRealtimeIntegration,
+  openaiRealtimeIntegrationSpec
+};

package/dist/integrations/providers/registry.js

@@ -488,17 +488,20 @@ var elevenLabsIntegrationSpec = defineIntegration({
   meta: {
     key: "ai-voice.elevenlabs",
     version: "1.0.0",
-    category: "ai-voice",
+    category: "ai-voice-tts",
     title: "ElevenLabs Text-to-Speech",
     description: "ElevenLabs integration for neural voice synthesis and voice catalog access.",
     domain: "ai",
     owners: ["platform.ai"],
-    tags: ["voice", "tts"],
+    tags: ["voice", "tts", "stt"],
     stability: StabilityEnum7.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
-    provides: [{ key: "ai.voice.synthesis", version: "1.0.0" }]
+    provides: [
+      { key: "ai.voice.tts", version: "1.0.0" },
+      { key: "ai.voice.stt", version: "1.0.0" }
+    ]
   },
   configSchema: {
     schema: {
@@ -553,7 +556,7 @@ var gradiumIntegrationSpec = defineIntegration({
   meta: {
     key: "ai-voice.gradium",
     version: "1.0.0",
-    category: "ai-voice",
+    category: "ai-voice-tts",
     title: "Gradium Text-to-Speech",
     description: "Gradium integration for low-latency voice synthesis and voice catalog access.",
     domain: "ai",
@@ -563,7 +566,7 @@ var gradiumIntegrationSpec = defineIntegration({
   },
   supportedModes: ["byok"],
   capabilities: {
-    provides: [{ key: "ai.voice.synthesis", version: "1.0.0" }]
+    provides: [{ key: "ai.voice.tts", version: "1.0.0" }]
   },
   configSchema: {
     schema: {
@@ -642,7 +645,7 @@ var falIntegrationSpec = defineIntegration({
   meta: {
     key: "ai-voice.fal",
     version: "1.0.0",
-    category: "ai-voice",
+    category: "ai-voice-tts",
     title: "Fal Chatterbox Text-to-Speech",
     description: "Fal integration for voice synthesis using Chatterbox text-to-speech models.",
     domain: "ai",
@@ -652,7 +655,7 @@ var falIntegrationSpec = defineIntegration({
   },
   supportedModes: ["byok"],
   capabilities: {
-    provides: [{ key: "ai.voice.synthesis", version: "1.0.0" }]
+    provides: [{ key: "ai.voice.tts", version: "1.0.0" }]
   },
   configSchema: {
     schema: {
@@ -727,8 +730,162 @@ function registerFalIntegration(registry) {
   return registry.register(falIntegrationSpec);
 }
 
-// src/integrations/providers/gmail.ts
+// src/integrations/providers/deepgram.ts
 import { StabilityEnum as StabilityEnum10 } from "@contractspec/lib.contracts-spec/ownership";
+var deepgramIntegrationSpec = defineIntegration({
+  meta: {
+    key: "ai-voice-stt.deepgram",
+    version: "1.0.0",
+    category: "ai-voice-stt",
+    title: "Deepgram Speech-to-Text",
+    description: "Deepgram integration for real-time and batch speech-to-text transcription with speaker diarization.",
+    domain: "ai",
+    owners: ["platform.ai"],
+    tags: ["voice", "stt", "transcription", "diarization"],
+    stability: StabilityEnum10.Experimental
+  },
+  supportedModes: ["byok"],
+  capabilities: {
+    provides: [
+      { key: "ai.voice.stt", version: "1.0.0" },
+      { key: "ai.voice.conversational", version: "1.0.0" }
+    ]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        model: {
+          type: "string",
+          description: "Deepgram model to use (e.g. nova-3, nova-2, enhanced)."
+        },
+        language: {
+          type: "string",
+          description: "Default language code for transcription (e.g. en-US)."
+        },
+        enableDiarization: {
+          type: "boolean",
+          description: "Enable speaker diarization by default."
+        },
+        enableSmartFormat: {
+          type: "boolean",
+          description: "Enable smart formatting (punctuation, capitalization)."
+        }
+      }
+    },
+    example: {
+      model: "nova-3",
+      language: "en-US",
+      enableDiarization: true,
+      enableSmartFormat: true
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["apiKey"],
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "Deepgram API key with transcription permissions."
+        }
+      }
+    },
+    example: {
+      apiKey: "dg_***"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 5000
+  },
+  docsUrl: "https://developers.deepgram.com/docs",
+  byokSetup: {
+    setupInstructions: "Create a Deepgram API key with speech-to-text permissions and store it in your secret provider."
+  }
+});
+function registerDeepgramIntegration(registry) {
+  return registry.register(deepgramIntegrationSpec);
+}
+
+// src/integrations/providers/openai-realtime.ts
+import { StabilityEnum as StabilityEnum11 } from "@contractspec/lib.contracts-spec/ownership";
+var openaiRealtimeIntegrationSpec = defineIntegration({
+  meta: {
+    key: "ai-voice-conv.openai",
+    version: "1.0.0",
+    category: "ai-voice-conversational",
+    title: "OpenAI Realtime Voice",
+    description: "OpenAI Realtime API integration for bidirectional conversational voice with GPT models.",
+    domain: "ai",
+    owners: ["platform.ai"],
+    tags: ["voice", "conversational", "realtime", "openai"],
+    stability: StabilityEnum11.Experimental
+  },
+  supportedModes: ["byok"],
+  capabilities: {
+    provides: [{ key: "ai.voice.conversational", version: "1.0.0" }]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        model: {
+          type: "string",
+          description: "OpenAI model for realtime conversations (e.g. gpt-4o-realtime-preview)."
+        },
+        defaultVoice: {
+          type: "string",
+          description: "Default voice for agent responses (e.g. alloy, echo, shimmer)."
+        },
+        turnDetection: {
+          type: "string",
+          enum: ["server_vad", "push_to_talk"],
+          description: "Turn detection strategy."
+        },
+        maxSessionDurationSeconds: {
+          type: "number",
+          description: "Maximum session duration in seconds."
+        }
+      }
+    },
+    example: {
+      model: "gpt-4o-realtime-preview",
+      defaultVoice: "alloy",
+      turnDetection: "server_vad",
+      maxSessionDurationSeconds: 600
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["apiKey"],
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "OpenAI API key with realtime API access."
+        }
+      }
+    },
+    example: {
+      apiKey: "sk-***"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 5000
+  },
+  docsUrl: "https://platform.openai.com/docs/guides/realtime",
+  byokSetup: {
+    setupInstructions: "Create an OpenAI API key with Realtime API access enabled and store it in your secret provider."
+  }
+});
+function registerOpenaiRealtimeIntegration(registry) {
+  return registry.register(openaiRealtimeIntegrationSpec);
+}
+
+// src/integrations/providers/gmail.ts
+import { StabilityEnum as StabilityEnum12 } from "@contractspec/lib.contracts-spec/ownership";
 var gmailIntegrationSpec = defineIntegration({
   meta: {
     key: "email.gmail",
@@ -739,7 +896,7 @@ var gmailIntegrationSpec = defineIntegration({
     domain: "communications",
     owners: ["platform.messaging"],
     tags: ["email", "gmail"],
-    stability: StabilityEnum10.Beta
+    stability: StabilityEnum12.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -816,7 +973,7 @@ function registerGmailIntegration(registry) {
 }
 
 // src/integrations/providers/google-calendar.ts
-import { StabilityEnum as StabilityEnum11 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum13 } from "@contractspec/lib.contracts-spec/ownership";
 var googleCalendarIntegrationSpec = defineIntegration({
   meta: {
     key: "calendar.google",
@@ -827,7 +984,7 @@ var googleCalendarIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.messaging"],
     tags: ["calendar", "google"],
-    stability: StabilityEnum11.Beta
+    stability: StabilityEnum13.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -887,7 +1044,7 @@ function registerGoogleCalendarIntegration(registry) {
 }
 
 // src/integrations/providers/twilio-sms.ts
-import { StabilityEnum as StabilityEnum12 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum14 } from "@contractspec/lib.contracts-spec/ownership";
 var twilioSmsIntegrationSpec = defineIntegration({
   meta: {
     key: "sms.twilio",
@@ -898,7 +1055,7 @@ var twilioSmsIntegrationSpec = defineIntegration({
     domain: "communications",
     owners: ["platform.messaging"],
     tags: ["sms", "messaging"],
-    stability: StabilityEnum12.Stable
+    stability: StabilityEnum14.Stable
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -957,7 +1114,7 @@ function registerTwilioSmsIntegration(registry) {
 }
 
 // src/integrations/providers/gcs-storage.ts
-import { StabilityEnum as StabilityEnum13 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum15 } from "@contractspec/lib.contracts-spec/ownership";
 var gcsStorageIntegrationSpec = defineIntegration({
   meta: {
     key: "storage.gcs",
@@ -968,7 +1125,7 @@ var gcsStorageIntegrationSpec = defineIntegration({
     domain: "infrastructure",
     owners: ["platform.infrastructure"],
     tags: ["storage", "gcs", "google-cloud"],
-    stability: StabilityEnum13.Beta
+    stability: StabilityEnum15.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1033,7 +1190,7 @@ function registerGcsStorageIntegration(registry) {
 }
 
 // src/integrations/providers/powens.ts
-import { StabilityEnum as StabilityEnum14 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum16 } from "@contractspec/lib.contracts-spec/ownership";
 var powensIntegrationSpec = defineIntegration({
   meta: {
     key: "openbanking.powens",
@@ -1044,7 +1201,7 @@ var powensIntegrationSpec = defineIntegration({
     domain: "finance",
     owners: ["platform.finance"],
     tags: ["open-banking", "powens", "finance"],
-    stability: StabilityEnum14.Experimental
+    stability: StabilityEnum16.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1136,7 +1293,7 @@ function registerPowensIntegration(registry) {
 }
 
 // src/integrations/providers/posthog.ts
-import { StabilityEnum as StabilityEnum15 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum17 } from "@contractspec/lib.contracts-spec/ownership";
 var posthogIntegrationSpec = defineIntegration({
   meta: {
     key: "analytics.posthog",
@@ -1147,7 +1304,7 @@ var posthogIntegrationSpec = defineIntegration({
     domain: "analytics",
     owners: ["@platform.integrations"],
     tags: ["analytics", "posthog", "llm", "ai"],
-    stability: StabilityEnum15.Beta
+    stability: StabilityEnum17.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1221,7 +1378,7 @@ function registerPosthogIntegration(registry) {
 }
 
 // src/integrations/providers/linear.ts
-import { StabilityEnum as StabilityEnum16 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum18 } from "@contractspec/lib.contracts-spec/ownership";
 var linearIntegrationSpec = defineIntegration({
   meta: {
     key: "project-management.linear",
@@ -1232,7 +1389,7 @@ var linearIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["@platform.integrations"],
     tags: ["project-management", "linear"],
-    stability: StabilityEnum16.Beta
+    stability: StabilityEnum18.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1307,7 +1464,7 @@ function registerLinearIntegration(registry) {
 }
 
 // src/integrations/providers/jira.ts
-import { StabilityEnum as StabilityEnum17 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum19 } from "@contractspec/lib.contracts-spec/ownership";
 var jiraIntegrationSpec = defineIntegration({
   meta: {
     key: "project-management.jira",
@@ -1318,7 +1475,7 @@ var jiraIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["@platform.integrations"],
     tags: ["project-management", "jira"],
-    stability: StabilityEnum17.Beta
+    stability: StabilityEnum19.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1394,7 +1551,7 @@ function registerJiraIntegration(registry) {
 }
 
 // src/integrations/providers/notion.ts
-import { StabilityEnum as StabilityEnum18 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum20 } from "@contractspec/lib.contracts-spec/ownership";
 var notionIntegrationSpec = defineIntegration({
   meta: {
     key: "project-management.notion",
@@ -1405,7 +1562,7 @@ var notionIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["@platform.integrations"],
     tags: ["project-management", "notion"],
-    stability: StabilityEnum18.Beta
+    stability: StabilityEnum20.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1486,7 +1643,7 @@ function registerNotionIntegration(registry) {
 }
 
 // src/integrations/providers/granola.ts
-import { StabilityEnum as StabilityEnum19 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum21 } from "@contractspec/lib.contracts-spec/ownership";
 var granolaIntegrationSpec = defineIntegration({
   meta: {
     key: "meeting-recorder.granola",
@@ -1497,7 +1654,7 @@ var granolaIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.integrations"],
     tags: ["meeting-recorder", "granola", "transcripts"],
-    stability: StabilityEnum19.Experimental
+    stability: StabilityEnum21.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1572,7 +1729,7 @@ function registerGranolaIntegration(registry) {
 }
 
 // src/integrations/providers/tldv.ts
-import { StabilityEnum as StabilityEnum20 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum22 } from "@contractspec/lib.contracts-spec/ownership";
 var tldvIntegrationSpec = defineIntegration({
   meta: {
     key: "meeting-recorder.tldv",
@@ -1583,7 +1740,7 @@ var tldvIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.integrations"],
     tags: ["meeting-recorder", "tldv", "transcripts"],
-    stability: StabilityEnum20.Experimental
+    stability: StabilityEnum22.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1657,7 +1814,7 @@ function registerTldvIntegration(registry) {
 }
 
 // src/integrations/providers/fireflies.ts
-import { StabilityEnum as StabilityEnum21 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum23 } from "@contractspec/lib.contracts-spec/ownership";
 var firefliesIntegrationSpec = defineIntegration({
   meta: {
     key: "meeting-recorder.fireflies",
@@ -1668,7 +1825,7 @@ var firefliesIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.integrations"],
     tags: ["meeting-recorder", "fireflies", "transcripts"],
-    stability: StabilityEnum21.Experimental
+    stability: StabilityEnum23.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1742,7 +1899,7 @@ function registerFirefliesIntegration(registry) {
 }
 
 // src/integrations/providers/fathom.ts
-import { StabilityEnum as StabilityEnum22 } from "@contractspec/lib.contracts-spec/ownership";
+import { StabilityEnum as StabilityEnum24 } from "@contractspec/lib.contracts-spec/ownership";
 var fathomIntegrationSpec = defineIntegration({
   meta: {
     key: "meeting-recorder.fathom",
@@ -1753,7 +1910,7 @@ var fathomIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.integrations"],
     tags: ["meeting-recorder", "fathom", "transcripts"],
-    stability: StabilityEnum22.Experimental
+    stability: StabilityEnum24.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1871,6 +2028,8 @@ function createDefaultIntegrationSpecRegistry() {
   registerTldvIntegration(registry);
   registerFirefliesIntegration(registry);
   registerFathomIntegration(registry);
+  registerDeepgramIntegration(registry);
+  registerOpenaiRealtimeIntegration(registry);
   return registry;
 }
 export {

package/dist/integrations/providers/video.d.ts

@@ -1,3 +1,4 @@
+import type { VoiceTimingMap } from './voice-video-sync';
 export interface VideoFormatLandscape {
     type: 'landscape';
     width: 1920;
@@ -100,6 +101,15 @@ export interface VideoProject {
     };
     /** Metadata for the rendered file */
     metadata?: VideoProjectMetadata;
+    /** VTT subtitles generated from voice narration */
+    subtitles?: string;
+    /** Voice timing map for per-scene audio sync */
+    voiceTimingMap?: VoiceTimingMap;
+    /** Generated thumbnail image */
+    thumbnail?: {
+        prompt: string;
+        imageUrl?: string;
+    };
 }
 export interface VideoProjectMetadata {
     title?: string;