@contractspec/lib.contracts-integrations 2.4.0 → 2.5.0

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

@@ -0,0 +1,95 @@
+// 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/node/integrations/providers/openai-realtime.js

@@ -0,0 +1,96 @@
+// 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/node/integrations/providers/registry.js

@@ -487,17 +487,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: {
@@ -552,7 +555,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",
@@ -562,7 +565,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: {
@@ -641,7 +644,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",
@@ -651,7 +654,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: {
@@ -726,8 +729,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",
@@ -738,7 +895,7 @@ var gmailIntegrationSpec = defineIntegration({
     domain: "communications",
     owners: ["platform.messaging"],
     tags: ["email", "gmail"],
-    stability: StabilityEnum10.Beta
+    stability: StabilityEnum12.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -815,7 +972,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",
@@ -826,7 +983,7 @@ var googleCalendarIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.messaging"],
     tags: ["calendar", "google"],
-    stability: StabilityEnum11.Beta
+    stability: StabilityEnum13.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -886,7 +1043,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",
@@ -897,7 +1054,7 @@ var twilioSmsIntegrationSpec = defineIntegration({
     domain: "communications",
     owners: ["platform.messaging"],
     tags: ["sms", "messaging"],
-    stability: StabilityEnum12.Stable
+    stability: StabilityEnum14.Stable
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -956,7 +1113,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",
@@ -967,7 +1124,7 @@ var gcsStorageIntegrationSpec = defineIntegration({
     domain: "infrastructure",
     owners: ["platform.infrastructure"],
     tags: ["storage", "gcs", "google-cloud"],
-    stability: StabilityEnum13.Beta
+    stability: StabilityEnum15.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1032,7 +1189,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",
@@ -1043,7 +1200,7 @@ var powensIntegrationSpec = defineIntegration({
     domain: "finance",
     owners: ["platform.finance"],
     tags: ["open-banking", "powens", "finance"],
-    stability: StabilityEnum14.Experimental
+    stability: StabilityEnum16.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1135,7 +1292,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",
@@ -1146,7 +1303,7 @@ var posthogIntegrationSpec = defineIntegration({
     domain: "analytics",
     owners: ["@platform.integrations"],
     tags: ["analytics", "posthog", "llm", "ai"],
-    stability: StabilityEnum15.Beta
+    stability: StabilityEnum17.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1220,7 +1377,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",
@@ -1231,7 +1388,7 @@ var linearIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["@platform.integrations"],
     tags: ["project-management", "linear"],
-    stability: StabilityEnum16.Beta
+    stability: StabilityEnum18.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1306,7 +1463,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",
@@ -1317,7 +1474,7 @@ var jiraIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["@platform.integrations"],
     tags: ["project-management", "jira"],
-    stability: StabilityEnum17.Beta
+    stability: StabilityEnum19.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1393,7 +1550,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",
@@ -1404,7 +1561,7 @@ var notionIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["@platform.integrations"],
     tags: ["project-management", "notion"],
-    stability: StabilityEnum18.Beta
+    stability: StabilityEnum20.Beta
   },
   supportedModes: ["managed", "byok"],
   capabilities: {
@@ -1485,7 +1642,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",
@@ -1496,7 +1653,7 @@ var granolaIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.integrations"],
     tags: ["meeting-recorder", "granola", "transcripts"],
-    stability: StabilityEnum19.Experimental
+    stability: StabilityEnum21.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1571,7 +1728,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",
@@ -1582,7 +1739,7 @@ var tldvIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.integrations"],
     tags: ["meeting-recorder", "tldv", "transcripts"],
-    stability: StabilityEnum20.Experimental
+    stability: StabilityEnum22.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1656,7 +1813,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",
@@ -1667,7 +1824,7 @@ var firefliesIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.integrations"],
     tags: ["meeting-recorder", "fireflies", "transcripts"],
-    stability: StabilityEnum21.Experimental
+    stability: StabilityEnum23.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1741,7 +1898,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",
@@ -1752,7 +1909,7 @@ var fathomIntegrationSpec = defineIntegration({
     domain: "productivity",
     owners: ["platform.integrations"],
     tags: ["meeting-recorder", "fathom", "transcripts"],
-    stability: StabilityEnum22.Experimental
+    stability: StabilityEnum24.Experimental
   },
   supportedModes: ["byok"],
   capabilities: {
@@ -1870,6 +2027,8 @@ function createDefaultIntegrationSpecRegistry() {
   registerTldvIntegration(registry);
   registerFirefliesIntegration(registry);
   registerFathomIntegration(registry);
+  registerDeepgramIntegration(registry);
+  registerOpenaiRealtimeIntegration(registry);
   return registry;
 }
 export {