@contractspec/lib.contracts 1.44.1 → 1.45.0

package/dist/integrations/providers/gmail.js

@@ -4,7 +4,7 @@ import { StabilityEnum } from "../../ownership.js";
 const gmailIntegrationSpec = {
 	meta: {
 		key: "email.gmail",
-		version: 1,
+		version: "1.0.0",
 		category: "email",
 		title: "Google Gmail API",
 		description: "Gmail integration supporting inbound thread ingestion and outbound transactional email.",
@@ -16,10 +16,10 @@ const gmailIntegrationSpec = {
 	supportedModes: ["managed", "byok"],
 	capabilities: { provides: [{
 		key: "email.inbound",
-		version: 1
+		version: "1.0.0"
 	}, {
 		key: "email.outbound",
-		version: 1
+		version: "1.0.0"
 	}] },
 	configSchema: {
 		schema: {

package/dist/integrations/providers/google-calendar.js

@@ -4,7 +4,7 @@ import { StabilityEnum } from "../../ownership.js";
 const googleCalendarIntegrationSpec = {
 	meta: {
 		key: "calendar.google",
-		version: 1,
+		version: "1.0.0",
 		category: "calendar",
 		title: "Google Calendar API",
 		description: "Google Calendar integration for event creation, updates, and scheduling automations.",
@@ -16,7 +16,7 @@ const googleCalendarIntegrationSpec = {
 	supportedModes: ["managed", "byok"],
 	capabilities: { provides: [{
 		key: "calendar.events",
-		version: 1
+		version: "1.0.0"
 	}] },
 	configSchema: {
 		schema: {

package/dist/integrations/providers/mistral.js

@@ -4,7 +4,7 @@ import { StabilityEnum } from "../../ownership.js";
 const mistralIntegrationSpec = {
 	meta: {
 		key: "ai-llm.mistral",
-		version: 1,
+		version: "1.0.0",
 		category: "ai-llm",
 		title: "Mistral Large Language Model",
 		description: "Mistral integration providing chat completions and embedding generation.",
@@ -20,10 +20,10 @@ const mistralIntegrationSpec = {
 	supportedModes: ["managed", "byok"],
 	capabilities: { provides: [{
 		key: "ai.chat",
-		version: 1
+		version: "1.0.0"
 	}, {
 		key: "ai.embeddings",
-		version: 1
+		version: "1.0.0"
 	}] },
 	configSchema: {
 		schema: {

package/dist/integrations/providers/postmark.js

@@ -4,7 +4,7 @@ import { StabilityEnum } from "../../ownership.js";
 const postmarkIntegrationSpec = {
 	meta: {
 		key: "email.postmark",
-		version: 1,
+		version: "1.0.0",
 		category: "email",
 		title: "Postmark Transactional Email",
 		description: "Postmark integration for transactional email delivery.",
@@ -17,7 +17,7 @@ const postmarkIntegrationSpec = {
 	capabilities: {
 		provides: [{
 			key: "email.transactional",
-			version: 1
+			version: "1.0.0"
 		}],
 		requires: [{
 			key: "platform.webhooks",

package/dist/integrations/providers/powens.js

@@ -4,7 +4,7 @@ import { StabilityEnum } from "../../ownership.js";
 const powensIntegrationSpec = {
 	meta: {
 		key: "openbanking.powens",
-		version: 1,
+		version: "1.0.0",
 		category: "open-banking",
 		title: "Powens Open Banking (Read)",
 		description: "Read-only Open Banking integration powered by Powens, exposing accounts, transactions, and balances.",
@@ -21,15 +21,15 @@ const powensIntegrationSpec = {
 	capabilities: { provides: [
 		{
 			key: "openbanking.accounts.read",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "openbanking.transactions.read",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "openbanking.balances.read",
-			version: 1
+			version: "1.0.0"
 		}
 	] },
 	configSchema: {

package/dist/integrations/providers/qdrant.js

@@ -4,7 +4,7 @@ import { StabilityEnum } from "../../ownership.js";
 const qdrantIntegrationSpec = {
 	meta: {
 		key: "vectordb.qdrant",
-		version: 1,
+		version: "1.0.0",
 		category: "vector-db",
 		title: "Qdrant Vector Database",
 		description: "Qdrant integration for vector search and embeddings storage.",
@@ -17,10 +17,10 @@ const qdrantIntegrationSpec = {
 	capabilities: {
 		provides: [{
 			key: "vector-db.search",
-			version: 1
+			version: "1.0.0"
 		}, {
 			key: "vector-db.storage",
-			version: 1
+			version: "1.0.0"
 		}],
 		requires: [{
 			key: "ai.embeddings",

package/dist/integrations/providers/stripe.js

@@ -4,7 +4,7 @@ import { StabilityEnum } from "../../ownership.js";
 const stripeIntegrationSpec = {
 	meta: {
 		key: "payments.stripe",
-		version: 1,
+		version: "1.0.0",
 		category: "payments",
 		title: "Stripe Payments",
 		description: "Stripe integration for payment processing, charges, and payouts.",
@@ -17,7 +17,7 @@ const stripeIntegrationSpec = {
 	capabilities: {
 		provides: [{
 			key: "payments.psp",
-			version: 1
+			version: "1.0.0"
 		}],
 		requires: [{
 			key: "platform.webhooks",

package/dist/integrations/providers/twilio-sms.js

@@ -4,7 +4,7 @@ import { StabilityEnum } from "../../ownership.js";
 const twilioSmsIntegrationSpec = {
 	meta: {
 		key: "sms.twilio",
-		version: 1,
+		version: "1.0.0",
 		category: "sms",
 		title: "Twilio Messaging",
 		description: "Twilio SMS integration for transactional and notification messaging.",
@@ -16,7 +16,7 @@ const twilioSmsIntegrationSpec = {
 	supportedModes: ["managed", "byok"],
 	capabilities: { provides: [{
 		key: "sms.outbound",
-		version: 1
+		version: "1.0.0"
 	}] },
 	configSchema: {
 		schema: {

package/dist/integrations/runtime.d.ts

@@ -6,8 +6,8 @@ import { SecretProvider } from "./secrets/provider.js";
 //#region src/integrations/runtime.d.ts
 interface IntegrationTraceMetadata {
   blueprintName: string;
-  blueprintVersion: number;
-  configVersion: number;
+  blueprintVersion: string;
+  configVersion: string;
 }
 interface IntegrationTelemetryEvent {
   tenantId: string;
@@ -15,7 +15,7 @@ interface IntegrationTelemetryEvent {
   environment?: string;
   slotId?: string;
   integrationKey: string;
-  integrationVersion: number;
+  integrationVersion: string;
   connectionId: string;
   status: 'success' | 'error';
   durationMs?: number;
@@ -45,8 +45,8 @@ interface IntegrationCallContext {
   appId: string;
   environment?: string;
   blueprintName: string;
-  blueprintVersion: number;
-  configVersion: number;
+  blueprintVersion: string;
+  configVersion: string;
   slotId: string;
   operation: string;
 }

package/dist/integrations/spec.d.ts

@@ -1,6 +1,7 @@
 import { OwnerShipMeta } from "../ownership.js";
 import { CapabilityRef, CapabilityRequirement } from "../capabilities/capabilities.js";
 import "../capabilities/index.js";
+import { SpecContractRegistry } from "../registry.js";
 
 //#region src/integrations/spec.d.ts
 type IntegrationCategory = 'payments' | 'email' | 'calendar' | 'sms' | 'ai-llm' | 'ai-voice' | 'speech-to-text' | 'vector-db' | 'storage' | 'accounting' | 'crm' | 'helpdesk' | 'open-banking' | 'custom';
@@ -63,11 +64,8 @@ interface IntegrationSpec {
   /** Provider-specific metadata for BYOK setup flows. */
   byokSetup?: IntegrationByokSetup;
 }
-declare class IntegrationSpecRegistry {
-  private readonly items;
-  register(spec: IntegrationSpec): this;
-  list(): IntegrationSpec[];
-  get(key: string, version?: number): IntegrationSpec | undefined;
+declare class IntegrationSpecRegistry extends SpecContractRegistry<'integration', IntegrationSpec> {
+  constructor(items?: IntegrationSpec[]);
   getByCategory(category: IntegrationCategory): IntegrationSpec[];
 }
 declare function makeIntegrationSpecKey(meta: IntegrationMeta): string;

package/dist/integrations/spec.js

@@ -1,31 +1,10 @@
+import { SpecContractRegistry } from "../registry.js";
+
 //#region src/integrations/spec.ts
 const integrationKey = (meta) => `${meta.key}.v${meta.version}`;
-var IntegrationSpecRegistry = class {
-	items = /* @__PURE__ */ new Map();
-	register(spec) {
-		const key = integrationKey(spec.meta);
-		if (this.items.has(key)) throw new Error(`Duplicate IntegrationSpec ${key}`);
-		this.items.set(key, spec);
-		return this;
-	}
-	list() {
-		return [...this.items.values()];
-	}
-	get(key, version) {
-		if (version != null) return this.items.get(integrationKey({
-			key,
-			version
-		}));
-		let latest;
-		let maxVersion = -Infinity;
-		for (const spec of this.items.values()) {
-			if (spec.meta.key !== key) continue;
-			if (spec.meta.version > maxVersion) {
-				maxVersion = spec.meta.version;
-				latest = spec;
-			}
-		}
-		return latest;
+var IntegrationSpecRegistry = class extends SpecContractRegistry {
+	constructor(items) {
+		super("integration", items);
 	}
 	getByCategory(category) {
 		return this.list().filter((spec) => spec.meta.category === category);

package/dist/jobs/gcp-cloud-tasks.js

@@ -30,7 +30,7 @@ var GcpCloudTasksQueue = class {
 		return {
 			id: randomUUID(),
 			type: jobType,
-			version: 1,
+			version: "1.0.0",
 			payload,
 			status: "pending",
 			priority: options.priority ?? 0,

package/dist/jobs/gcp-pubsub.js

@@ -16,7 +16,7 @@ var GcpPubSubQueue = class {
 		return {
 			id: randomUUID(),
 			type: jobType,
-			version: 1,
+			version: "1.0.0",
 			payload,
 			status: "pending",
 			priority: options.priority ?? 0,

package/dist/jobs/handlers/ping-handler.d.ts

@@ -1,10 +1,10 @@
 import { DefinedJob } from "../define-job.js";
-import * as z$1 from "zod";
+import * as z$2 from "zod";
 
 //#region src/jobs/handlers/ping-handler.d.ts
 declare const PING_JOB_TYPE: "core.ping";
-declare const PingPayloadSchema: z$1.ZodObject<{}, z$1.core.$strip>;
-type PingPayload = z$1.infer<typeof PingPayloadSchema>;
+declare const PingPayloadSchema: z$2.ZodObject<{}, z$2.core.$strip>;
+type PingPayload = z$2.infer<typeof PingPayloadSchema>;
 declare const pingJob: DefinedJob<PingPayload>;
 //#endregion
 export { PING_JOB_TYPE, PingPayload, PingPayloadSchema, pingJob };

package/dist/jobs/handlers/ping-handler.js

@@ -1,8 +1,8 @@
-import * as z$1 from "zod";
+import * as z$2 from "zod";
 
 //#region src/jobs/handlers/ping-handler.ts
 const PING_JOB_TYPE = "core.ping";
-const PingPayloadSchema = z$1.object({});
+const PingPayloadSchema = z$2.object({});
 const pingJob = {
 	type: PING_JOB_TYPE,
 	schema: PingPayloadSchema,

package/dist/jobs/memory-queue.js

@@ -14,7 +14,7 @@ var MemoryJobQueue = class {
 		const job = {
 			id: randomUUID(),
 			type: jobType,
-			version: 1,
+			version: "1.0.0",
 			payload,
 			status: "pending",
 			priority: options.priority ?? 0,

package/dist/jobs/queue.d.ts

@@ -1,4 +1,4 @@
-import * as z$1 from "zod";
+import * as z$2 from "zod";
 
 //#region src/jobs/queue.d.ts
 
@@ -12,7 +12,7 @@ type JobStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled' |
 interface Job<TPayload = unknown> {
   id: string;
   type: string;
-  version: number;
+  version: string;
   payload: TPayload;
   status: JobStatus;
   priority: number;
@@ -116,8 +116,8 @@ declare function calculateBackoff(attempt: number, policy?: RetryPolicy): number
  */
 interface JobTypeDef<TPayload = unknown> {
   type: string;
-  version: number;
-  payload: z$1.ZodType<TPayload>;
+  version: string;
+  payload: z$2.ZodType<TPayload>;
   options?: Partial<RetryPolicy & {
     timeoutMs: number;
   }>;

package/dist/jobs/scaleway-sqs-queue.js

@@ -44,7 +44,7 @@ var ScalewaySqsJobQueue = class {
 		return {
 			id,
 			type: jobType,
-			version: 1,
+			version: "1.0.0",
 			payload,
 			status: "pending",
 			priority: options.priority ?? 0,
@@ -104,7 +104,7 @@ var ScalewaySqsJobQueue = class {
 				const job = {
 					id: envelope.id,
 					type: envelope.type,
-					version: 1,
+					version: "1.0.0",
 					payload: envelope.payload,
 					status: "pending",
 					priority: 0,

package/dist/jsonschema.d.ts

@@ -10,7 +10,7 @@ declare function jsonSchemaForSpec(spec: OperationSpec<AnySchemaModel, AnySchema
   output: z.core.ZodStandardJSONSchemaPayload<z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>> | null;
   meta: {
     name: string;
-    version: number;
+    version: string;
     kind: OpKind;
     description: string;
     tags: Tag[];
@@ -18,10 +18,10 @@ declare function jsonSchemaForSpec(spec: OperationSpec<AnySchemaModel, AnySchema
   };
 };
 /** Helper to derive default REST path */
-declare function defaultRestPath(name: string, version: number): string;
+declare function defaultRestPath(name: string, version: string): string;
 /** Helper to derive default MCP tool name */
-declare function defaultMcpTool(name: string, version: number): string;
+declare function defaultMcpTool(name: string, version: string): string;
 /** Helper to derive default GraphQL field name */
-declare function defaultGqlField(name: string, version: number): string;
+declare function defaultGqlField(name: string, version: string): string;
 //#endregion
 export { defaultGqlField, defaultMcpTool, defaultRestPath, jsonSchemaForSpec };

package/dist/knowledge/binding.d.ts

@@ -2,7 +2,7 @@
 interface AppKnowledgeBinding {
   /** Which KnowledgeSpace to use. */
   spaceKey: string;
-  spaceVersion?: number;
+  spaceVersion?: string;
   /** Optional: scope to specific workflows/agents. */
   scope?: {
     workflows?: string[];

package/dist/knowledge/knowledge.feature.js

@@ -6,7 +6,7 @@
 const KnowledgeFeature = {
 	meta: {
 		key: "platform.knowledge",
-		version: 1,
+		version: "1.0.0",
 		title: "Knowledge Sources",
 		description: "Manage knowledge source bindings for ingestion (e.g., Notion, uploads)",
 		domain: "platform",
@@ -22,23 +22,23 @@ const KnowledgeFeature = {
 	operations: [
 		{
 			key: "knowledge.source.create",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "knowledge.source.update",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "knowledge.source.delete",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "knowledge.source.list",
-			version: 1
+			version: "1.0.0"
 		},
 		{
 			key: "knowledge.source.triggerSync",
-			version: 1
+			version: "1.0.0"
 		}
 	],
 	events: [],
@@ -48,11 +48,11 @@ const KnowledgeFeature = {
 	capabilities: {
 		provides: [{
 			key: "knowledge",
-			version: 1
+			version: "1.0.0"
 		}],
 		requires: [{
 			key: "identity",
-			version: 1
+			version: "1.0.0"
 		}]
 	}
 };