@contractspec/lib.contracts-integrations 2.3.0 → 2.5.0

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

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

package/dist/integrations/providers/deepgram.js

@@ -0,0 +1,99 @@
+// @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/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/integrations/providers/elevenlabs.js

@@ -22,17 +22,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/integrations/providers/fal-image.d.ts

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

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

@@ -0,0 +1,92 @@
+// @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/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/integrations/providers/fal.js

@@ -22,7 +22,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",
@@ -32,7 +32,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/integrations/providers/gradium.js

@@ -22,7 +22,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",
@@ -32,7 +32,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/integrations/providers/image.d.ts

@@ -0,0 +1,85 @@
+export type ImageFormat = 'png' | 'jpg' | 'webp' | 'svg';
+export interface ImageDimensions {
+    width: number;
+    height: number;
+}
+export declare const IMAGE_PRESETS: {
+    readonly ogImage: {
+        readonly width: 1200;
+        readonly height: 630;
+    };
+    readonly twitterCard: {
+        readonly width: 1200;
+        readonly height: 675;
+    };
+    readonly instagramSquare: {
+        readonly width: 1080;
+        readonly height: 1080;
+    };
+    readonly instagramStory: {
+        readonly width: 1080;
+        readonly height: 1920;
+    };
+    readonly blogHero: {
+        readonly width: 1920;
+        readonly height: 1080;
+    };
+    readonly thumbnail: {
+        readonly width: 640;
+        readonly height: 360;
+    };
+    readonly favicon: {
+        readonly width: 512;
+        readonly height: 512;
+    };
+    readonly emailHeader: {
+        readonly width: 600;
+        readonly height: 200;
+    };
+    readonly illustration: {
+        readonly width: 1024;
+        readonly height: 1024;
+    };
+};
+export interface ImageGenerationInput {
+    prompt: string;
+    negativePrompt?: string;
+    dimensions: ImageDimensions;
+    format?: ImageFormat;
+    style?: 'photorealistic' | 'illustration' | '3d-render' | 'flat-design' | 'abstract';
+    numVariants?: number;
+    guidanceScale?: number;
+    seed?: number;
+    /** Reference image for img2img / style transfer */
+    referenceImage?: Uint8Array;
+    referenceStrength?: number;
+    metadata?: Record<string, string>;
+}
+export interface ImageGenerationResult {
+    images: GeneratedImageData[];
+    seed: number;
+    model: string;
+    generationTimeMs?: number;
+}
+export interface GeneratedImageData {
+    data: Uint8Array;
+    format: ImageFormat;
+    dimensions: ImageDimensions;
+    url?: string;
+    /** Provider may revise the prompt */
+    revisedPrompt?: string;
+}
+export interface ImageProvider {
+    generate(input: ImageGenerationInput): Promise<ImageGenerationResult>;
+    listModels?(): Promise<ImageModelInfo[]>;
+    upscale?(image: Uint8Array, scale: number): Promise<GeneratedImageData>;
+    edit?(image: Uint8Array, mask: Uint8Array, prompt: string): Promise<GeneratedImageData>;
+}
+export interface ImageModelInfo {
+    id: string;
+    name: string;
+    maxDimensions: ImageDimensions;
+    supportedFormats: ImageFormat[];
+    supportsNegativePrompt: boolean;
+    supportsImg2Img: boolean;
+}

package/dist/integrations/providers/image.js

@@ -0,0 +1,16 @@
+// @bun
+// 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
+};

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

@@ -8,6 +8,10 @@ export * from './email';
 export * from './calendar';
 export * from './sms';
 export * from './voice';
+export * from './voice-video-sync';
+export * from './image';
+export * from './fal-image';
+export * from './openai-image';
 export * from './storage';
 export * from './project-management';
 export * from './meeting-recorder';
@@ -20,6 +24,8 @@ export * from './mistral';
 export * from './elevenlabs';
 export * from './gradium';
 export * from './fal';
+export * from './deepgram';
+export * from './openai-realtime';
 export * from './gmail';
 export * from './google-calendar';
 export * from './twilio-sms';