@contractspec/lib.contracts-spec 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,126 @@
+// @bun
+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 = import.meta.require;
+
+// 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,127 @@
+// @bun
+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 = import.meta.require;
+
+// 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
+};