@lssm/example.crm-pipeline 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/libs/contracts/dist/integrations/providers/powens.js

@@ -0,0 +1,116 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region ../../libs/contracts/dist/integrations/providers/powens.js
+const powensIntegrationSpec = {
+	meta: {
+		key: "openbanking.powens",
+		version: 1,
+		category: "open-banking",
+		displayName: "Powens Open Banking",
+		title: "Powens Open Banking (Read)",
+		description: "Read-only Open Banking integration powered by Powens, exposing accounts, transactions, and balances.",
+		domain: "finance",
+		owners: ["platform.finance"],
+		tags: [
+			"open-banking",
+			"powens",
+			"finance"
+		],
+		stability: StabilityEnum.Experimental
+	},
+	supportedModes: ["byok"],
+	capabilities: { provides: [
+		{
+			key: "openbanking.accounts.read",
+			version: 1
+		},
+		{
+			key: "openbanking.transactions.read",
+			version: 1
+		},
+		{
+			key: "openbanking.balances.read",
+			version: 1
+		}
+	] },
+	configSchema: {
+		schema: {
+			type: "object",
+			required: ["environment"],
+			properties: {
+				environment: {
+					type: "string",
+					enum: ["sandbox", "production"],
+					description: "Powens environment to target. Sandbox uses Powens test API base URL, production uses live endpoints."
+				},
+				baseUrl: {
+					type: "string",
+					description: "Optional override for the Powens API base URL. Defaults to Powens environment defaults."
+				},
+				region: {
+					type: "string",
+					description: "Optional Powens region identifier when targeting a specific data residency cluster."
+				},
+				pollingIntervalMs: {
+					type: "number",
+					description: "Optional custom polling interval in milliseconds for background sync jobs (defaults to platform standard)."
+				}
+			}
+		},
+		example: {
+			environment: "sandbox",
+			baseUrl: "https://api-sandbox.powens.com/v2",
+			region: "eu-west-1",
+			pollingIntervalMs: 3e5
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["clientId", "clientSecret"],
+			properties: {
+				clientId: {
+					type: "string",
+					description: "Powens OAuth client identifier obtained from the Powens Console (BYOK project)."
+				},
+				clientSecret: {
+					type: "string",
+					description: "Powens OAuth client secret used to exchange for access tokens."
+				},
+				apiKey: {
+					type: "string",
+					description: "Optional Powens API key (if the tenant project exposes a dedicated API token)."
+				},
+				webhookSecret: {
+					type: "string",
+					description: "Optional webhook signing secret used to verify Powens webhook payloads."
+				}
+			}
+		},
+		example: {
+			clientId: "powens-client-id",
+			clientSecret: "powens-client-secret",
+			apiKey: "powens-api-key",
+			webhookSecret: "powens-webhook-secret"
+		}
+	},
+	healthCheck: {
+		method: "ping",
+		timeoutMs: 8e3
+	},
+	docsUrl: "https://docs.powens.com/",
+	constraints: { rateLimit: {
+		rph: 1e4,
+		rpm: 600
+	} },
+	byokSetup: {
+		setupInstructions: "Create a Powens BYOK project, generate OAuth credentials, and optionally configure webhook delivery for account/transaction updates.",
+		requiredScopes: [
+			"accounts:read",
+			"transactions:read",
+			"balances:read"
+		]
+	}
+};
+
+//#endregion

package/dist/libs/contracts/dist/integrations/providers/qdrant.js

@@ -0,0 +1,73 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region ../../libs/contracts/dist/integrations/providers/qdrant.js
+const qdrantIntegrationSpec = {
+	meta: {
+		key: "vectordb.qdrant",
+		version: 1,
+		category: "vector-db",
+		displayName: "Qdrant",
+		title: "Qdrant Vector Database",
+		description: "Qdrant integration for vector search and embeddings storage.",
+		domain: "ai",
+		owners: ["platform.ai"],
+		tags: ["vector-db", "search"],
+		stability: StabilityEnum.Experimental
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: {
+		provides: [{
+			key: "vector-db.search",
+			version: 1
+		}, {
+			key: "vector-db.storage",
+			version: 1
+		}],
+		requires: [{
+			key: "ai.embeddings",
+			optional: true,
+			reason: "Required if vectors are generated via hosted embedding services"
+		}]
+	},
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: {
+				apiUrl: {
+					type: "string",
+					description: "Base URL for the Qdrant instance (e.g., https://qdrant.example.com)."
+				},
+				collectionPrefix: {
+					type: "string",
+					description: "Prefix applied to all collection names for this tenant."
+				}
+			}
+		},
+		example: {
+			apiUrl: "https://qdrant.example.com",
+			collectionPrefix: "tenant_"
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			properties: { apiKey: {
+				type: "string",
+				description: "API key or token when authentication is enabled."
+			} }
+		},
+		example: { apiKey: "qdrant-api-key" }
+	},
+	healthCheck: {
+		method: "ping",
+		timeoutMs: 4e3
+	},
+	docsUrl: "https://qdrant.tech/documentation/quick-start/",
+	constraints: { quotas: {
+		collections: 100,
+		pointsPerCollection: 1e6
+	} },
+	byokSetup: { setupInstructions: "Provide the HTTPS endpoint of your Qdrant cluster and generate an API key with read/write access to the collections that will be managed." }
+};
+
+//#endregion

package/dist/libs/contracts/dist/integrations/providers/registry.js

@@ -0,0 +1,10 @@
+import "./stripe.js";
+import "./postmark.js";
+import "./qdrant.js";
+import "./mistral.js";
+import "./elevenlabs.js";
+import "./gmail.js";
+import "./google-calendar.js";
+import "./twilio-sms.js";
+import "./gcs-storage.js";
+import "./powens.js";

package/dist/libs/contracts/dist/integrations/providers/stripe.js

@@ -0,0 +1,83 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region ../../libs/contracts/dist/integrations/providers/stripe.js
+const stripeIntegrationSpec = {
+	meta: {
+		key: "payments.stripe",
+		version: 1,
+		category: "payments",
+		displayName: "Stripe",
+		title: "Stripe Payments",
+		description: "Stripe integration for payment processing, charges, and payouts.",
+		domain: "payments",
+		owners: ["platform.payments"],
+		tags: ["payments", "psp"],
+		stability: StabilityEnum.Stable
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: {
+		provides: [{
+			key: "payments.psp",
+			version: 1
+		}],
+		requires: [{
+			key: "platform.webhooks",
+			optional: true,
+			reason: "Recommended for reliable event ingestion"
+		}]
+	},
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: {
+				accountId: {
+					type: "string",
+					description: "Connected account ID when using Stripe Connect (BYOK)."
+				},
+				region: {
+					type: "string",
+					description: "Optional Stripe region or data residency hint."
+				}
+			}
+		},
+		example: {
+			accountId: "acct_123",
+			region: "us-east-1"
+		}
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["apiKey", "webhookSecret"],
+			properties: {
+				apiKey: {
+					type: "string",
+					description: "Stripe secret API key (sk_live_... or sk_test_...)."
+				},
+				webhookSecret: {
+					type: "string",
+					description: "Signing secret for webhook verification."
+				}
+			}
+		},
+		example: {
+			apiKey: "sk_live_***",
+			webhookSecret: "whsec_***"
+		}
+	},
+	healthCheck: {
+		method: "ping",
+		timeoutMs: 5e3
+	},
+	docsUrl: "https://stripe.com/docs/api",
+	constraints: { rateLimit: {
+		rpm: 1e3,
+		rph: 2e4
+	} },
+	byokSetup: {
+		setupInstructions: "Create a restricted Stripe API key with write access to Charges and provide a webhook signing secret.",
+		requiredScopes: ["charges:write", "customers:read"]
+	}
+};
+
+//#endregion

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

@@ -0,0 +1,61 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region ../../libs/contracts/dist/integrations/providers/twilio-sms.js
+const twilioSmsIntegrationSpec = {
+	meta: {
+		key: "sms.twilio",
+		version: 1,
+		category: "sms",
+		displayName: "Twilio SMS",
+		title: "Twilio Messaging",
+		description: "Twilio SMS integration for transactional and notification messaging.",
+		domain: "communications",
+		owners: ["platform.messaging"],
+		tags: ["sms", "messaging"],
+		stability: StabilityEnum.Stable
+	},
+	supportedModes: ["managed", "byok"],
+	capabilities: { provides: [{
+		key: "sms.outbound",
+		version: 1
+	}] },
+	configSchema: {
+		schema: {
+			type: "object",
+			properties: { fromNumber: {
+				type: "string",
+				description: "Default Twilio phone number used as sender."
+			} }
+		},
+		example: { fromNumber: "+15551234567" }
+	},
+	secretSchema: {
+		schema: {
+			type: "object",
+			required: ["accountSid", "authToken"],
+			properties: {
+				accountSid: {
+					type: "string",
+					description: "Twilio Account SID."
+				},
+				authToken: {
+					type: "string",
+					description: "Twilio Auth Token."
+				}
+			}
+		},
+		example: {
+			accountSid: "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+			authToken: "auth-token"
+		}
+	},
+	healthCheck: {
+		method: "custom",
+		timeoutMs: 3e3
+	},
+	docsUrl: "https://www.twilio.com/docs/sms/api",
+	constraints: { rateLimit: { rpm: 200 } },
+	byokSetup: { setupInstructions: "Provide a Twilio account SID, auth token, and verify the outbound sending numbers used by the integration." }
+};
+
+//#endregion

package/dist/libs/contracts/dist/jsonschema.js

@@ -0,0 +1 @@
+import z from "zod";

package/dist/libs/contracts/dist/knowledge/contracts.js

@@ -0,0 +1,306 @@
+import { defineCommand, defineQuery } from "../spec.js";
+import { SchemaModel } from "../schema/dist/SchemaModel.js";
+import { ScalarTypeEnum } from "../schema/dist/ScalarTypeEnum.js";
+import "../schema/dist/index.js";
+
+//#region ../../libs/contracts/dist/knowledge/contracts.js
+const KnowledgeSyncSchedule = new SchemaModel({
+	name: "KnowledgeSyncSchedule",
+	fields: {
+		enabled: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		cron: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		intervalMs: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const KnowledgeSourceRecord = new SchemaModel({
+	name: "KnowledgeSourceRecord",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		spaceKey: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		spaceVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		sourceType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		syncSchedule: {
+			type: KnowledgeSyncSchedule,
+			isOptional: true
+		},
+		lastSyncStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		lastSyncAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		itemsProcessed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const CreateKnowledgeSourceInput = new SchemaModel({
+	name: "CreateKnowledgeSourceInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		spaceKey: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		spaceVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		sourceType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		config: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: false
+		},
+		syncSchedule: {
+			type: KnowledgeSyncSchedule,
+			isOptional: true
+		}
+	}
+});
+const UpdateKnowledgeSourceInput = new SchemaModel({
+	name: "UpdateKnowledgeSourceInput",
+	fields: {
+		sourceId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		config: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		},
+		syncSchedule: {
+			type: KnowledgeSyncSchedule,
+			isOptional: true
+		}
+	}
+});
+const DeleteKnowledgeSourceInput = new SchemaModel({
+	name: "DeleteKnowledgeSourceInput",
+	fields: { sourceId: {
+		type: ScalarTypeEnum.ID(),
+		isOptional: false
+	} }
+});
+const DeleteKnowledgeSourceOutput = new SchemaModel({
+	name: "DeleteKnowledgeSourceOutput",
+	fields: { success: {
+		type: ScalarTypeEnum.Boolean(),
+		isOptional: false
+	} }
+});
+const ListKnowledgeSourcesInput = new SchemaModel({
+	name: "ListKnowledgeSourcesInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		spaceKey: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: true
+		}
+	}
+});
+const ListKnowledgeSourcesOutput = new SchemaModel({
+	name: "ListKnowledgeSourcesOutput",
+	fields: { sources: {
+		type: KnowledgeSourceRecord,
+		isOptional: false,
+		isArray: true
+	} }
+});
+const TriggerKnowledgeSyncInput = new SchemaModel({
+	name: "TriggerKnowledgeSyncInput",
+	fields: { sourceId: {
+		type: ScalarTypeEnum.ID(),
+		isOptional: false
+	} }
+});
+const TriggerKnowledgeSyncOutput = new SchemaModel({
+	name: "TriggerKnowledgeSyncOutput",
+	fields: {
+		success: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		itemsProcessed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		error: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const CreateKnowledgeSource = defineCommand({
+	meta: {
+		name: "knowledge.source.create",
+		version: 1,
+		description: "Create a knowledge source binding for a tenant.",
+		goal: "Onboard a new knowledge ingestion source such as Notion or uploads.",
+		context: "Used by Ops and App Studio to configure knowledge ingestion per tenant and space.",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: CreateKnowledgeSourceInput,
+		output: KnowledgeSourceRecord
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.manage",
+			version: 1
+		}]
+	}
+});
+const UpdateKnowledgeSource = defineCommand({
+	meta: {
+		name: "knowledge.source.update",
+		version: 1,
+		description: "Update metadata or configuration for a knowledge source.",
+		goal: "Allow rotation of credentials, sync schedules, and labels.",
+		context: "Supports editing how a tenant ingests knowledge (e.g., toggling sync cadence).",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: UpdateKnowledgeSourceInput,
+		output: KnowledgeSourceRecord
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.manage",
+			version: 1
+		}]
+	}
+});
+const DeleteKnowledgeSource = defineCommand({
+	meta: {
+		name: "knowledge.source.delete",
+		version: 1,
+		description: "Delete a knowledge source binding for a tenant.",
+		goal: "Remove obsolete or compromised knowledge ingestion paths.",
+		context: "Ensures ephemeral or external sources can be removed cleanly without leaving residual bindings.",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: DeleteKnowledgeSourceInput,
+		output: DeleteKnowledgeSourceOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.manage",
+			version: 1
+		}]
+	}
+});
+const ListKnowledgeSources = defineQuery({
+	meta: {
+		name: "knowledge.source.list",
+		version: 1,
+		description: "List knowledge sources configured for a tenant.",
+		goal: "Provide visibility into knowledge ingest configuration and schedules.",
+		context: "Used by App Studio and Ops flows to surface knowledge sources and their health.",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: ListKnowledgeSourcesInput,
+		output: ListKnowledgeSourcesOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.read",
+			version: 1
+		}]
+	}
+});
+const TriggerKnowledgeSourceSync = defineCommand({
+	meta: {
+		name: "knowledge.source.triggerSync",
+		version: 1,
+		description: "Trigger an immediate sync for a knowledge source.",
+		goal: "Support manual or automated sync retries for knowledge ingestion.",
+		context: "Invoked by Ops tooling or monitors when knowledge content must be refreshed or reprocessed.",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: TriggerKnowledgeSyncInput,
+		output: TriggerKnowledgeSyncOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.manage",
+			version: 1
+		}]
+	}
+});
+
+//#endregion

package/dist/libs/contracts/dist/knowledge/index.js

@@ -0,0 +1,7 @@
+import "./spaces/product-canon.js";
+import "./spaces/support-faq.js";
+import "./spaces/email-threads.js";
+import "./spaces/uploaded-docs.js";
+import "./spaces/financial-docs.js";
+import "./spaces/financial-overview.js";
+import "./spaces/index.js";

package/dist/libs/contracts/dist/knowledge/spaces/email-threads.js

@@ -0,0 +1,34 @@
+import { StabilityEnum } from "../../ownership.js";
+
+//#region ../../libs/contracts/dist/knowledge/spaces/email-threads.js
+const emailThreadsKnowledgeSpace = {
+	meta: {
+		key: "knowledge.email-threads",
+		version: 1,
+		category: "operational",
+		displayName: "Email Threads",
+		title: "Operational Email Threads",
+		description: "Indexed copies of operational email threads used for support, onboarding, and workflows.",
+		domain: "operations",
+		owners: ["platform.operations"],
+		tags: ["email", "operations"],
+		stability: StabilityEnum.Beta
+	},
+	retention: { ttlDays: 365 },
+	access: {
+		policy: {
+			name: "knowledge.access.email-threads",
+			version: 1
+		},
+		trustLevel: "medium",
+		automationWritable: true
+	},
+	indexing: {
+		embeddingModel: "mistral-embed",
+		chunkSize: 600,
+		vectorDbIntegration: "vectordb.qdrant"
+	},
+	description: "Operational email threads synchronized from Gmail to support automations and contextual assistance."
+};
+
+//#endregion