@contractspec/lib.contracts 1.56.1 → 1.57.0

package/dist/integrations/providers/supabase-postgres.js

@@ -0,0 +1,73 @@
+import { StabilityEnum } from "../../ownership.js";
+import { defineIntegration } from "../spec.js";
+
+//#region src/integrations/providers/supabase-postgres.ts
+const supabasePostgresIntegrationSpec = defineIntegration({
+	meta: {
+		key: "database.supabase",
+		version: "1.0.0",
+		category: "database",
+		title: "Supabase Postgres",
+		description: "Supabase Postgres integration for SQL query execution and transactional workloads.",
+		domain: "infrastructure",
+		owners: ["platform.infrastructure"],
+		tags: [
+			"database",
+			"postgres",
+			"supabase"
+		],
+		stability: StabilityEnum.Beta
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: { provides: [{
+		key: "database.sql",
+		version: "1.0.0"
+	}] },
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: {
+				maxConnections: {
+					type: "number",
+					description: "Optional connection pool size when opening a Postgres client to Supabase."
+				},
+				sslMode: {
+					type: "string",
+					enum: [
+						"require",
+						"allow",
+						"prefer"
+					],
+					description: "TLS mode used by the Postgres client."
+				}
+			}
+		},
+		example: {
+			maxConnections: 10,
+			sslMode: "require"
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["databaseUrl"],
+			properties: { databaseUrl: {
+				type: "string",
+				description: "Supabase Postgres connection string (transaction or session pooler endpoint)."
+			} }
+		},
+		example: { databaseUrl: "postgresql://postgres.[project-ref]:password@aws-0-region.pooler.supabase.com:6543/postgres" }
+	},
+	healthCheck: {
+		method: "ping",
+		timeoutMs: 5e3
+	},
+	docsUrl: "https://supabase.com/docs/guides/database/connecting-to-postgres",
+	byokSetup: { setupInstructions: "Create or reuse a Supabase project and provide a Postgres connection string with permissions aligned to your workload." }
+});
+function registerSupabasePostgresIntegration(registry) {
+	return registry.register(supabasePostgresIntegrationSpec);
+}
+
+//#endregion
+export { registerSupabasePostgresIntegration, supabasePostgresIntegrationSpec };

package/dist/integrations/providers/supabase-vector.d.ts

@@ -0,0 +1,8 @@
+import { IntegrationSpec, IntegrationSpecRegistry } from "../spec.js";
+import "../index.js";
+
+//#region src/integrations/providers/supabase-vector.d.ts
+declare const supabaseVectorIntegrationSpec: IntegrationSpec;
+declare function registerSupabaseVectorIntegration(registry: IntegrationSpecRegistry): IntegrationSpecRegistry;
+//#endregion
+export { registerSupabaseVectorIntegration, supabaseVectorIntegrationSpec };

package/dist/integrations/providers/supabase-vector.js

@@ -0,0 +1,93 @@
+import { StabilityEnum } from "../../ownership.js";
+import { defineIntegration } from "../spec.js";
+
+//#region src/integrations/providers/supabase-vector.ts
+const supabaseVectorIntegrationSpec = defineIntegration({
+	meta: {
+		key: "vectordb.supabase",
+		version: "1.0.0",
+		category: "vector-db",
+		title: "Supabase Vector Database (pgvector)",
+		description: "Supabase integration for embedding storage and vector similarity search using pgvector.",
+		domain: "ai",
+		owners: ["platform.ai"],
+		tags: [
+			"vector-db",
+			"supabase",
+			"pgvector"
+		],
+		stability: StabilityEnum.Beta
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: {
+		provides: [{
+			key: "vector-db.search",
+			version: "1.0.0"
+		}, {
+			key: "vector-db.storage",
+			version: "1.0.0"
+		}],
+		requires: [{
+			key: "ai.embeddings",
+			optional: true,
+			reason: "Required when vectors are generated by a hosted embedding provider."
+		}]
+	},
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: {
+				schema: {
+					type: "string",
+					description: "Schema name containing the pgvector table (default: public)."
+				},
+				table: {
+					type: "string",
+					description: "Table used to store vectors and metadata (default: contractspec_vectors)."
+				},
+				createTableIfMissing: {
+					type: "boolean",
+					description: "Automatically create pgvector extension and table when first writing vectors."
+				},
+				distanceMetric: {
+					type: "string",
+					enum: [
+						"cosine",
+						"l2",
+						"inner_product"
+					],
+					description: "Distance metric used for nearest-neighbor search."
+				}
+			}
+		},
+		example: {
+			schema: "public",
+			table: "contractspec_vectors",
+			createTableIfMissing: true,
+			distanceMetric: "cosine"
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["databaseUrl"],
+			properties: { databaseUrl: {
+				type: "string",
+				description: "Supabase Postgres connection string with privileges to read/write vector rows."
+			} }
+		},
+		example: { databaseUrl: "postgresql://postgres.[project-ref]:password@aws-0-region.pooler.supabase.com:6543/postgres" }
+	},
+	healthCheck: {
+		method: "ping",
+		timeoutMs: 5e3
+	},
+	docsUrl: "https://supabase.com/docs/guides/ai/vector-columns",
+	byokSetup: { setupInstructions: "Create or reuse a Supabase project, enable pgvector, and provide a Postgres connection string with read/write access to the target vector table." }
+});
+function registerSupabaseVectorIntegration(registry) {
+	return registry.register(supabaseVectorIntegrationSpec);
+}
+
+//#endregion
+export { registerSupabaseVectorIntegration, supabaseVectorIntegrationSpec };

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

@@ -0,0 +1,8 @@
+import { IntegrationSpec, IntegrationSpecRegistry } from "../spec.js";
+import "../index.js";
+
+//#region src/integrations/providers/tldv.d.ts
+declare const tldvIntegrationSpec: IntegrationSpec;
+declare function registerTldvIntegration(registry: IntegrationSpecRegistry): IntegrationSpecRegistry;
+//#endregion
+export { registerTldvIntegration, tldvIntegrationSpec };

package/dist/integrations/providers/tldv.js

@@ -0,0 +1,98 @@
+import { StabilityEnum } from "../../ownership.js";
+import { defineIntegration } from "../spec.js";
+
+//#region src/integrations/providers/tldv.ts
+const tldvIntegrationSpec = defineIntegration({
+	meta: {
+		key: "meeting-recorder.tldv",
+		version: "1.0.0",
+		category: "meeting-recorder",
+		title: "tl;dv Meeting Recorder",
+		description: "tl;dv Public API for meeting recordings, transcripts, and webhook events.",
+		domain: "productivity",
+		owners: ["platform.integrations"],
+		tags: [
+			"meeting-recorder",
+			"tldv",
+			"transcripts"
+		],
+		stability: StabilityEnum.Experimental
+	},
+	supportedModes: ["byok"],
+	capabilities: { provides: [
+		{
+			key: "meeting-recorder.meetings.read",
+			version: "1.0.0"
+		},
+		{
+			key: "meeting-recorder.transcripts.read",
+			version: "1.0.0"
+		},
+		{
+			key: "meeting-recorder.webhooks",
+			version: "1.0.0"
+		}
+	] },
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: {
+				baseUrl: {
+					type: "string",
+					description: "Optional override for the tl;dv API base URL. Defaults to https://pasta.tldv.io/v1alpha1."
+				},
+				webhookUrl: {
+					type: "string",
+					description: "Webhook destination URL configured in tl;dv settings (MeetingReady/TranscriptReady)."
+				},
+				webhookEvents: {
+					type: "array",
+					items: { type: "string" },
+					description: "Webhook triggers to enable (MeetingReady, TranscriptReady)."
+				},
+				webhookScope: {
+					type: "string",
+					description: "Webhook scope to configure (user, team, or organization)."
+				}
+			}
+		},
+		example: {
+			baseUrl: "https://pasta.tldv.io/v1alpha1",
+			webhookUrl: "https://example.com/webhooks/tldv",
+			webhookEvents: ["MeetingReady", "TranscriptReady"],
+			webhookScope: "team"
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["apiKey"],
+			properties: {
+				apiKey: {
+					type: "string",
+					description: "tl;dv API key used in the x-api-key header for API requests."
+				},
+				webhookSecret: {
+					type: "string",
+					description: "Optional shared secret for webhook verification if configured in your environment."
+				}
+			}
+		},
+		example: {
+			apiKey: "tldv-***",
+			webhookSecret: "tldv-webhook-secret"
+		}
+	},
+	healthCheck: {
+		method: "ping",
+		timeoutMs: 6e3
+	},
+	docsUrl: "https://doc.tldv.io/index.html",
+	byokSetup: { setupInstructions: "Generate a tl;dv API key and optionally configure MeetingReady/TranscriptReady webhooks." }
+});
+function registerTldvIntegration(registry) {
+	return registry.register(tldvIntegrationSpec);
+}
+
+//#endregion
+export { registerTldvIntegration, tldvIntegrationSpec };

package/dist/integrations/runtime.js

@@ -177,7 +177,6 @@ function connectionStatusLabel(status) {
 		case "connected": return "connected";
 		case "disconnected": return "disconnected";
 		case "error": return "error";
-		case "unknown":
 		default: return "unknown";
 	}
 }

package/dist/integrations/spec.d.ts

@@ -4,7 +4,7 @@ import "../capabilities/index.js";
 import { OwnerShipMeta } from "../ownership.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';
+type IntegrationCategory = 'payments' | 'email' | 'calendar' | 'sms' | 'ai-llm' | 'ai-voice' | 'analytics' | 'speech-to-text' | 'vector-db' | 'storage' | 'accounting' | 'crm' | 'helpdesk' | 'project-management' | 'open-banking' | 'meeting-recorder' | 'database' | 'custom';
 type IntegrationOwnershipMode = 'managed' | 'byok';
 interface IntegrationMeta extends OwnerShipMeta {
   category: IntegrationCategory;

package/dist/jobs/queue.d.ts

@@ -1,7 +1,6 @@
 import * as z$2 from "zod";
 
 //#region src/jobs/queue.d.ts
-
 /**
  * Job status values.
  */

package/dist/knowledge/binding.d.ts

@@ -11,9 +11,7 @@ interface AppKnowledgeBinding {
   };
   /** Usage constraints. */
   constraints?: {
-    /** Max tokens per query. */
-    maxTokensPerQuery?: number;
-    /** Max queries per minute. */
+    /** Max tokens per query. */maxTokensPerQuery?: number; /** Max queries per minute. */
     maxQueriesPerMinute?: number;
   };
   /** Priority when multiple spaces overlap. */