@contractspec/lib.contracts-spec 2.4.0 → 2.6.0

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

@@ -0,0 +1,129 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// 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

@@ -52,17 +52,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,122 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// 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

@@ -52,7 +52,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",
@@ -62,7 +62,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

@@ -52,7 +52,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",
@@ -62,7 +62,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,46 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// 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
+};