@contractspec/lib.contracts-integrations 2.3.0 → 2.5.0

package/dist/node/integrations/providers/deepgram.js

@@ -0,0 +1,98 @@
+// 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/deepgram.ts
+import { StabilityEnum } 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: StabilityEnum.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);
+}
+export {
+  registerDeepgramIntegration,
+  deepgramIntegrationSpec
+};

package/dist/node/integrations/providers/elevenlabs.js

@@ -21,17 +21,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: StabilityEnum.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: {

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

@@ -0,0 +1,91 @@
+// 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/fal-image.ts
+import { StabilityEnum } from "@contractspec/lib.contracts-spec/ownership";
+var falImageIntegrationSpec = defineIntegration({
+  meta: {
+    key: "ai-image.fal",
+    version: "1.0.0",
+    category: "ai-image",
+    title: "Fal Image Generation",
+    description: "Fal integration for AI image generation using Flux and Stable Diffusion models.",
+    domain: "ai",
+    owners: ["platform.ai"],
+    tags: ["image", "generation", "flux", "stable-diffusion"],
+    stability: StabilityEnum.Experimental
+  },
+  supportedModes: ["byok"],
+  capabilities: {
+    provides: [{ key: "ai.image.generation", version: "1.0.0" }]
+  },
+  configSchema: {
+    schema: {
+      type: "object",
+      properties: {
+        modelId: {
+          type: "string",
+          description: "Fal model endpoint (e.g. fal-ai/flux/dev)."
+        },
+        defaultFormat: {
+          type: "string",
+          enum: ["png", "jpg", "webp"]
+        },
+        defaultGuidanceScale: {
+          type: "number",
+          minimum: 1,
+          maximum: 20
+        }
+      }
+    },
+    example: {
+      modelId: "fal-ai/flux/dev",
+      defaultFormat: "png",
+      defaultGuidanceScale: 7.5
+    }
+  },
+  secretSchema: {
+    schema: {
+      type: "object",
+      required: ["apiKey"],
+      properties: {
+        apiKey: {
+          type: "string",
+          description: "Fal API key (FAL_KEY)."
+        }
+      }
+    },
+    example: {
+      apiKey: "key-id:key-secret"
+    }
+  },
+  healthCheck: {
+    method: "custom",
+    timeoutMs: 7000
+  },
+  docsUrl: "https://fal.ai/models",
+  byokSetup: {
+    setupInstructions: "Create a Fal API key and ensure image generation model access is enabled."
+  }
+});
+function registerFalImageIntegration(registry) {
+  return registry.register(falImageIntegrationSpec);
+}
+export {
+  registerFalImageIntegration,
+  falImageIntegrationSpec
+};

package/dist/node/integrations/providers/fal.js

@@ -21,7 +21,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",
@@ -31,7 +31,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: {

package/dist/node/integrations/providers/gradium.js

@@ -21,7 +21,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",
@@ -31,7 +31,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: {

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

@@ -0,0 +1,15 @@
+// src/integrations/providers/image.ts
+var IMAGE_PRESETS = {
+  ogImage: { width: 1200, height: 630 },
+  twitterCard: { width: 1200, height: 675 },
+  instagramSquare: { width: 1080, height: 1080 },
+  instagramStory: { width: 1080, height: 1920 },
+  blogHero: { width: 1920, height: 1080 },
+  thumbnail: { width: 640, height: 360 },
+  favicon: { width: 512, height: 512 },
+  emailHeader: { width: 600, height: 200 },
+  illustration: { width: 1024, height: 1024 }
+};
+export {
+  IMAGE_PRESETS
+};