@lssm/lib.contracts 1.41.1 → 1.42.1

package/dist/index.js

@@ -1 +1,119 @@
-import{CapabilityRegistry as e,capabilityKey as t,defineCapability as n}from"./capabilities.js";import{DataViewRegistry as r,dataViewKey as i}from"./data-views.js";import{defineEvent as a,eventKey as o}from"./events.js";import{FeatureRegistry as s,installFeature as c,validateFeatureTargetsV2 as l}from"./features.js";import{FormRegistry as u,buildZodWithRelations as d,defineFormSpec as f,evalPredicate as p}from"./forms.js";import{schemaToMarkdown as m,schemaToMarkdownDetail as h,schemaToMarkdownList as g,schemaToMarkdownSummary as _,schemaToMarkdownTable as v}from"./schema-to-markdown.js";import{TransformEngine as y,createDefaultTransformEngine as b,registerBasicValidation as x,registerDefaultReactRenderer as S,registerReactToMarkdownRenderer as C}from"./presentations.v2.js";import{createEngineWithDefaults as w,createFeatureModule as T,registerFeature as E,renderFeaturePresentation as D}from"./client/react/feature-render.js";import{createFormRenderer as O}from"./client/react/form-render.js";import{shadcnDriver as k}from"./client/react/drivers/shadcn.js";import{rnReusablesDriver as A}from"./client/react/drivers/rn-reusables.js";import"./client/index.js";import{defaultGqlField as j,defaultMcpTool as M,defaultRestPath as N,jsonSchemaForSpec as P}from"./jsonschema.js";import{registerContractsOnBuilder as F}from"./server/graphql-pothos.js";import{PresentationRegistry as I,jsonSchemaForPresentation as L}from"./presentations.js";import{createMcpServer as R}from"./server/mcp/createMcpServer.js";import{createFetchHandler as z}from"./server/rest-generic.js";import{elysiaPlugin as B}from"./server/rest-elysia.js";import{expressRouter as V}from"./server/rest-express.js";import{makeNextAppHandler as H}from"./server/rest-next-app.js";import{makeNextPagesHandler as U}from"./server/rest-next-pages.js";import"./server/index.js";import{defineCommand as W,defineQuery as G,isEmitDeclRef as K}from"./spec.js";import{docBlockToPresentationSpec as q,docBlockToPresentationV2 as J,docBlocksToPresentationRoutes as Y,docBlocksToPresentationSpecs as X,mapDocRoutes as Z}from"./docs/presentations.js";import{DocRegistry as Q,defaultDocRegistry as $,docId as ee,listRegisteredDocBlocks as te,registerDocBlocks as ne}from"./docs/registry.js";import{SpecRegistry as re,opKey as ie}from"./registry.js";import{Owners as ae,OwnersEnum as oe,StabilityEnum as se,Tags as ce,TagsEnum as le}from"./ownership.js";import{ContractRegistryFileSchema as ue,ContractRegistryItemSchema as de,ContractRegistryItemTypeSchema as fe,ContractRegistryManifestSchema as pe}from"./contract-registry/schemas.js";import"./contract-registry/index.js";import{installOp as me,makeEmit as he,op as ge}from"./install.js";import{openApiForRegistry as _e}from"./openapi.js";import{definePrompt as ve}from"./prompt.js";import{PromptRegistry as ye}from"./promptRegistry.js";import{ResourceRegistry as be,defineResourceTemplate as xe,isResourceRef as Se,resourceRef as Ce}from"./resources.js";import{toV2FromV1 as we}from"./presentations.backcompat.js";import{CompleteOnboardingBaseInput as Te,CompleteOnboardingBaseOutput as Ee,CompleteOnboardingBaseSpec as De,DeleteOnboardingDraftBaseSpec as Oe,DeleteOnboardingDraftOutput as ke,GetOnboardingDraftBaseSpec as Ae,GetOnboardingDraftOutput as je,SaveOnboardingDraftBaseSpec as Me,SaveOnboardingDraftInput as Ne,SaveOnboardingDraftOutput as Pe}from"./onboarding-base.js";import{openBankingAccountsReadCapability as Fe,openBankingBalancesReadCapability as Ie,openBankingTransactionsReadCapability as Le,registerOpenBankingCapabilities as Re}from"./capabilities/openbanking.js";import{PolicyRegistry as ze,makePolicyKey as Be}from"./policy/spec.js";import{PolicyEngine as Ve}from"./policy/engine.js";import{OPAPolicyAdapter as He,buildOPAInput as Ue}from"./policy/opa-adapter.js";import{ThemeRegistry as We,makeThemeRef as Ge}from"./themes.js";import{MigrationRegistry as Ke}from"./migrations.js";import{TelemetryRegistry as qe,makeTelemetryKey as Je}from"./telemetry/spec.js";import{TelemetryTracker as Ye}from"./telemetry/tracker.js";import{TelemetryAnomalyMonitor as Xe}from"./telemetry/anomaly.js";import"./telemetry/index.js";import{TestRegistry as Ze,makeTestKey as Qe}from"./tests/spec.js";import{TestRunner as $e}from"./tests/runner.js";import"./tests/index.js";import{ExperimentRegistry as et,makeExperimentKey as tt}from"./experiments/spec.js";import{ExperimentEvaluator as nt}from"./experiments/evaluator.js";import{AppBlueprintRegistry as rt,makeAppBlueprintKey as it}from"./app-config/spec.js";import{composeAppConfig as at,resolveAppConfig as ot}from"./app-config/runtime.js";import{IntegrationSpecRegistry as st,makeIntegrationSpecKey as ct}from"./integrations/spec.js";import{registerStripeIntegration as lt,stripeIntegrationSpec as ut}from"./integrations/providers/stripe.js";import{postmarkIntegrationSpec as dt,registerPostmarkIntegration as ft}from"./integrations/providers/postmark.js";import{qdrantIntegrationSpec as pt,registerQdrantIntegration as mt}from"./integrations/providers/qdrant.js";import{mistralIntegrationSpec as ht,registerMistralIntegration as gt}from"./integrations/providers/mistral.js";import{elevenLabsIntegrationSpec as _t,registerElevenLabsIntegration as vt}from"./integrations/providers/elevenlabs.js";import{gmailIntegrationSpec as yt,registerGmailIntegration as bt}from"./integrations/providers/gmail.js";import{googleCalendarIntegrationSpec as xt,registerGoogleCalendarIntegration as St}from"./integrations/providers/google-calendar.js";import{registerTwilioSmsIntegration as Ct,twilioSmsIntegrationSpec as wt}from"./integrations/providers/twilio-sms.js";import{gcsStorageIntegrationSpec as Tt,registerGcsStorageIntegration as Et}from"./integrations/providers/gcs-storage.js";import{powensIntegrationSpec as Dt,registerPowensIntegration as Ot}from"./integrations/providers/powens.js";import{createDefaultIntegrationSpecRegistry as kt}from"./integrations/providers/registry.js";import{AccountBalanceRecord as At,BankAccountRecord as jt,BankTransactionRecord as Mt}from"./integrations/openbanking/models.js";import{OPENBANKING_PII_FIELDS as Nt,OPENBANKING_TELEMETRY_EVENTS as Pt,redactOpenBankingTelemetryPayload as Ft}from"./integrations/openbanking/telemetry.js";import{OpenBankingGetAccount as It,OpenBankingListAccounts as Lt,OpenBankingSyncAccounts as Rt}from"./integrations/openbanking/contracts/accounts.js";import{OpenBankingListTransactions as zt,OpenBankingSyncTransactions as Bt}from"./integrations/openbanking/contracts/transactions.js";import{OpenBankingGetBalances as Vt,OpenBankingRefreshBalances as Ht}from"./integrations/openbanking/contracts/balances.js";import{OpenBankingFeature as Ut}from"./integrations/openbanking/openbanking.feature.js";import{registerOpenBankingContracts as Wt}from"./integrations/openbanking/contracts/index.js";import{assertPrimaryOpenBankingReady as Gt,ensurePrimaryOpenBankingIntegration as Kt}from"./integrations/openbanking/guards.js";import"./integrations/index.js";import{KnowledgeSpaceRegistry as qt,makeKnowledgeSpaceKey as Jt}from"./knowledge/spec.js";import{productCanonKnowledgeSpace as Yt,registerProductCanonKnowledgeSpace as Xt}from"./knowledge/spaces/product-canon.js";import{registerSupportFaqKnowledgeSpace as Zt,supportFaqKnowledgeSpace as Qt}from"./knowledge/spaces/support-faq.js";import{emailThreadsKnowledgeSpace as $t,registerEmailThreadsKnowledgeSpace as en}from"./knowledge/spaces/email-threads.js";import{registerUploadedDocsKnowledgeSpace as tn,uploadedDocsKnowledgeSpace as nn}from"./knowledge/spaces/uploaded-docs.js";import{financialDocsKnowledgeSpace as rn,registerFinancialDocsKnowledgeSpace as an}from"./knowledge/spaces/financial-docs.js";import{financialOverviewKnowledgeSpace as on,registerFinancialOverviewKnowledgeSpace as sn}from"./knowledge/spaces/financial-overview.js";import"./knowledge/index.js";import{CreateIntegrationConnection as cn,DeleteIntegrationConnection as ln,ListIntegrationConnections as un,TestIntegrationConnection as dn,UpdateIntegrationConnection as fn,integrationContracts as pn,registerIntegrationContracts as mn}from"./integrations/contracts.js";import{CreateKnowledgeSource as hn,DeleteKnowledgeSource as gn,ListKnowledgeSources as _n,TriggerKnowledgeSourceSync as vn,UpdateKnowledgeSource as yn,knowledgeContracts as bn,registerKnowledgeContracts as xn}from"./knowledge/contracts.js";import{behaviorToEnvelope as Sn,errorToEnvelope as Cn,telemetryToEnvelope as wn}from"./regenerator/utils.js";import{RegeneratorService as Tn}from"./regenerator/service.js";import{ProposalExecutor as En}from"./regenerator/executor.js";import{ExecutorProposalSink as Dn}from"./regenerator/sinks.js";import"./regenerator/index.js";import{WorkflowRegistry as On}from"./workflow/spec.js";import{WorkflowValidationError as kn,assertWorkflowSpecValid as An,validateWorkflowSpec as jn}from"./workflow/validation.js";import{evaluateExpression as Mn}from"./workflow/expression.js";import{WorkflowPreFlightError as Nn,WorkflowRunner as Pn}from"./workflow/runner.js";import{InMemoryStateStore as Fn}from"./workflow/adapters/memory-store.js";import{PrismaStateStore as In}from"./workflow/adapters/db-adapter.js";import{createFileStateStore as Ln}from"./workflow/adapters/file-adapter.js";import"./workflow/index.js";import{techContractsDocs as Rn}from"./docs/tech-contracts.docs.js";import{metaDocs as zn}from"./docs/meta.docs.js";import"./docs/index.js";import{docBlockToMarkdown as Bn,eventToMarkdown as Vn,exportFeature as Hn,exportSpec as Un,featureToMarkdown as Wn,presentationToMarkdown as Gn,specToAgentPrompt as Kn,specToContextMarkdown as qn,specToFullMarkdown as Jn}from"./llm/exporters.js";import{AGENT_SYSTEM_PROMPTS as Yn,formatPlanForAgent as Xn,generateFixViolationsPrompt as Zn,generateImplementationPlan as Qn,generateImplementationPrompt as $n,generateReviewPrompt as er,generateTestPrompt as tr,generateVerificationPrompt as nr}from"./llm/prompts.js";import"./llm/index.js";import{defineSchemaModel as rr}from"@lssm/lib.schema";export{Yn as AGENT_SYSTEM_PROMPTS,At as AccountBalanceRecord,rt as AppBlueprintRegistry,jt as BankAccountRecord,Mt as BankTransactionRecord,e as CapabilityRegistry,Te as CompleteOnboardingBaseInput,Ee as CompleteOnboardingBaseOutput,De as CompleteOnboardingBaseSpec,ue as ContractRegistryFileSchema,de as ContractRegistryItemSchema,fe as ContractRegistryItemTypeSchema,pe as ContractRegistryManifestSchema,cn as CreateIntegrationConnection,hn as CreateKnowledgeSource,r as DataViewRegistry,ln as DeleteIntegrationConnection,gn as DeleteKnowledgeSource,Oe as DeleteOnboardingDraftBaseSpec,ke as DeleteOnboardingDraftOutput,Q as DocRegistry,Dn as ExecutorProposalSink,nt as ExperimentEvaluator,et as ExperimentRegistry,s as FeatureRegistry,u as FormRegistry,Ae as GetOnboardingDraftBaseSpec,je as GetOnboardingDraftOutput,Fn as InMemoryStateStore,st as IntegrationSpecRegistry,qt as KnowledgeSpaceRegistry,un as ListIntegrationConnections,_n as ListKnowledgeSources,Ke as MigrationRegistry,He as OPAPolicyAdapter,Nt as OPENBANKING_PII_FIELDS,Pt as OPENBANKING_TELEMETRY_EVENTS,Ut as OpenBankingFeature,It as OpenBankingGetAccount,Vt as OpenBankingGetBalances,Lt as OpenBankingListAccounts,zt as OpenBankingListTransactions,Ht as OpenBankingRefreshBalances,Rt as OpenBankingSyncAccounts,Bt as OpenBankingSyncTransactions,ae as Owners,oe as OwnersEnum,Ve as PolicyEngine,ze as PolicyRegistry,I as PresentationRegistry,In as PrismaStateStore,ye as PromptRegistry,En as ProposalExecutor,Tn as RegeneratorService,be as ResourceRegistry,Me as SaveOnboardingDraftBaseSpec,Ne as SaveOnboardingDraftInput,Pe as SaveOnboardingDraftOutput,re as SpecRegistry,se as StabilityEnum,ce as Tags,le as TagsEnum,Xe as TelemetryAnomalyMonitor,qe as TelemetryRegistry,Ye as TelemetryTracker,dn as TestIntegrationConnection,Ze as TestRegistry,$e as TestRunner,We as ThemeRegistry,y as TransformEngine,vn as TriggerKnowledgeSourceSync,fn as UpdateIntegrationConnection,yn as UpdateKnowledgeSource,Nn as WorkflowPreFlightError,On as WorkflowRegistry,Pn as WorkflowRunner,kn as WorkflowValidationError,Gt as assertPrimaryOpenBankingReady,An as assertWorkflowSpecValid,Sn as behaviorToEnvelope,Ue as buildOPAInput,d as buildZodWithRelations,t as capabilityKey,at as composeAppConfig,kt as createDefaultIntegrationSpecRegistry,b as createDefaultTransformEngine,w as createEngineWithDefaults,T as createFeatureModule,z as createFetchHandler,Ln as createFileStateStore,O as createFormRenderer,R as createMcpServer,i as dataViewKey,$ as defaultDocRegistry,j as defaultGqlField,M as defaultMcpTool,N as defaultRestPath,n as defineCapability,W as defineCommand,a as defineEvent,f as defineFormSpec,ve as definePrompt,G as defineQuery,xe as defineResourceTemplate,rr as defineSchemaModel,Bn as docBlockToMarkdown,q as docBlockToPresentationSpec,J as docBlockToPresentationV2,Y as docBlocksToPresentationRoutes,X as docBlocksToPresentationSpecs,ee as docId,_t as elevenLabsIntegrationSpec,B as elysiaPlugin,$t as emailThreadsKnowledgeSpace,Kt as ensurePrimaryOpenBankingIntegration,Cn as errorToEnvelope,p as evalPredicate,Mn as evaluateExpression,o as eventKey,Vn as eventToMarkdown,Hn as exportFeature,Un as exportSpec,V as expressRouter,Wn as featureToMarkdown,rn as financialDocsKnowledgeSpace,on as financialOverviewKnowledgeSpace,Xn as formatPlanForAgent,Tt as gcsStorageIntegrationSpec,Zn as generateFixViolationsPrompt,Qn as generateImplementationPlan,$n as generateImplementationPrompt,er as generateReviewPrompt,tr as generateTestPrompt,nr as generateVerificationPrompt,yt as gmailIntegrationSpec,xt as googleCalendarIntegrationSpec,c as installFeature,me as installOp,pn as integrationContracts,K as isEmitDeclRef,Se as isResourceRef,L as jsonSchemaForPresentation,P as jsonSchemaForSpec,bn as knowledgeContracts,te as listRegisteredDocBlocks,it as makeAppBlueprintKey,he as makeEmit,tt as makeExperimentKey,ct as makeIntegrationSpecKey,Jt as makeKnowledgeSpaceKey,H as makeNextAppHandler,U as makeNextPagesHandler,Be as makePolicyKey,Je as makeTelemetryKey,Qe as makeTestKey,Ge as makeThemeRef,Z as mapDocRoutes,zn as metaDocs,ht as mistralIntegrationSpec,ge as op,ie as opKey,_e as openApiForRegistry,Fe as openBankingAccountsReadCapability,Ie as openBankingBalancesReadCapability,Le as openBankingTransactionsReadCapability,dt as postmarkIntegrationSpec,Dt as powensIntegrationSpec,Gn as presentationToMarkdown,Yt as productCanonKnowledgeSpace,pt as qdrantIntegrationSpec,Ft as redactOpenBankingTelemetryPayload,x as registerBasicValidation,F as registerContractsOnBuilder,S as registerDefaultReactRenderer,ne as registerDocBlocks,vt as registerElevenLabsIntegration,en as registerEmailThreadsKnowledgeSpace,E as registerFeature,an as registerFinancialDocsKnowledgeSpace,sn as registerFinancialOverviewKnowledgeSpace,Et as registerGcsStorageIntegration,bt as registerGmailIntegration,St as registerGoogleCalendarIntegration,mn as registerIntegrationContracts,xn as registerKnowledgeContracts,gt as registerMistralIntegration,Re as registerOpenBankingCapabilities,Wt as registerOpenBankingContracts,ft as registerPostmarkIntegration,Ot as registerPowensIntegration,Xt as registerProductCanonKnowledgeSpace,mt as registerQdrantIntegration,C as registerReactToMarkdownRenderer,lt as registerStripeIntegration,Zt as registerSupportFaqKnowledgeSpace,Ct as registerTwilioSmsIntegration,tn as registerUploadedDocsKnowledgeSpace,D as renderFeaturePresentation,ot as resolveAppConfig,Ce as resourceRef,A as rnReusablesDriver,m as schemaToMarkdown,h as schemaToMarkdownDetail,g as schemaToMarkdownList,_ as schemaToMarkdownSummary,v as schemaToMarkdownTable,k as shadcnDriver,Kn as specToAgentPrompt,qn as specToContextMarkdown,Jn as specToFullMarkdown,ut as stripeIntegrationSpec,Qt as supportFaqKnowledgeSpace,Rn as techContractsDocs,wn as telemetryToEnvelope,we as toV2FromV1,wt as twilioSmsIntegrationSpec,nn as uploadedDocsKnowledgeSpace,l as validateFeatureTargetsV2,jn as validateWorkflowSpec};
+import { GroupingStrategies, filterBy, getUniqueDomains, getUniqueOwners, getUniqueTags, groupBy, groupByMultiple, groupByToArray, init_registry_utils } from "./registry-utils.js";
+import { EventRegistry, defineEvent, eventKey } from "./events.js";
+import { FeatureRegistry, installFeature, validateFeatureTargetsV2 } from "./features.js";
+import { schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable } from "./schema-to-markdown.js";
+import { TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "./presentations/transform-engine.js";
+import { definePresentation } from "./presentations/presentations.js";
+import { PresentationRegistry } from "./presentations/registry.js";
+import "./presentations/index.js";
+import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./client/react/feature-render.js";
+import { FormRegistry, buildZodWithRelations, defineFormSpec, evalPredicate } from "./forms/forms.js";
+import { createFormRenderer } from "./client/react/form-render.js";
+import { shadcnDriver } from "./client/react/drivers/shadcn.js";
+import { rnReusablesDriver } from "./client/react/drivers/rn-reusables.js";
+import "./client/index.js";
+import { defaultGqlField, defaultMcpTool, defaultRestPath, jsonSchemaForSpec } from "./jsonschema.js";
+import { registerContractsOnBuilder } from "./server/graphql-pothos.js";
+import { createMcpServer } from "./server/mcp/createMcpServer.js";
+import { createFetchHandler } from "./server/rest-generic.js";
+import { elysiaPlugin } from "./server/rest-elysia.js";
+import { expressRouter } from "./server/rest-express.js";
+import { makeNextAppHandler } from "./server/rest-next-app.js";
+import { makeNextPagesHandler } from "./server/rest-next-pages.js";
+import "./server/index.js";
+import { CapabilityRegistry, capabilityKey, defineCapability } from "./capabilities/capabilities.js";
+import { Owners, OwnersEnum, StabilityEnum, Tags, TagsEnum } from "./ownership.js";
+import { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities } from "./capabilities/openbanking.js";
+import "./capabilities/index.js";
+import { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema } from "./contract-registry/schemas.js";
+import "./contract-registry/index.js";
+import { defineCommand, defineQuery, isEmitDeclRef } from "./operations/operation.js";
+import { OperationSpecRegistry, opKey } from "./operations/registry.js";
+import { installOp, makeEmit, op } from "./install.js";
+import { openApiForRegistry } from "./openapi.js";
+import { definePrompt } from "./prompt.js";
+import { PromptRegistry } from "./promptRegistry.js";
+import "./operations/index.js";
+import { ResourceRegistry, defineResourceTemplate, isResourceRef, resourceRef } from "./resources.js";
+import { CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput } from "./onboarding-base.js";
+import { DataViewRegistry, dataViewKey } from "./data-views/data-views.js";
+import { DataViewQueryGenerator } from "./data-views/query-generator.js";
+import { DataViewRuntime } from "./data-views/runtime.js";
+import { PolicyRegistry } from "./policy/registry.js";
+import { PolicyEngine } from "./policy/engine.js";
+import { OPAPolicyAdapter, buildOPAInput } from "./policy/opa-adapter.js";
+import { ThemeRegistry, makeThemeRef } from "./themes.js";
+import { MigrationRegistry } from "./migrations.js";
+import { TelemetryRegistry, makeTelemetryKey } from "./telemetry/spec.js";
+import { TelemetryTracker } from "./telemetry/tracker.js";
+import { TelemetryAnomalyMonitor } from "./telemetry/anomaly.js";
+import "./telemetry/index.js";
+import { TestRegistry, makeTestKey } from "./tests/spec.js";
+import { TestRunner } from "./tests/runner.js";
+import "./tests/index.js";
+import { ExperimentRegistry, makeExperimentKey } from "./experiments/spec.js";
+import { ExperimentEvaluator } from "./experiments/evaluator.js";
+import { AppBlueprintRegistry, makeAppBlueprintKey } from "./app-config/spec.js";
+import { composeAppConfig, resolveAppConfig } from "./app-config/runtime.js";
+import { IntegrationSpecRegistry, makeIntegrationSpecKey } from "./integrations/spec.js";
+import { registerStripeIntegration, stripeIntegrationSpec } from "./integrations/providers/stripe.js";
+import { postmarkIntegrationSpec, registerPostmarkIntegration } from "./integrations/providers/postmark.js";
+import { qdrantIntegrationSpec, registerQdrantIntegration } from "./integrations/providers/qdrant.js";
+import { mistralIntegrationSpec, registerMistralIntegration } from "./integrations/providers/mistral.js";
+import { elevenLabsIntegrationSpec, registerElevenLabsIntegration } from "./integrations/providers/elevenlabs.js";
+import { gmailIntegrationSpec, registerGmailIntegration } from "./integrations/providers/gmail.js";
+import { googleCalendarIntegrationSpec, registerGoogleCalendarIntegration } from "./integrations/providers/google-calendar.js";
+import { registerTwilioSmsIntegration, twilioSmsIntegrationSpec } from "./integrations/providers/twilio-sms.js";
+import { gcsStorageIntegrationSpec, registerGcsStorageIntegration } from "./integrations/providers/gcs-storage.js";
+import { powensIntegrationSpec, registerPowensIntegration } from "./integrations/providers/powens.js";
+import { createDefaultIntegrationSpecRegistry } from "./integrations/providers/registry.js";
+import { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord } from "./integrations/openbanking/models.js";
+import { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, redactOpenBankingTelemetryPayload } from "./integrations/openbanking/telemetry.js";
+import { OpenBankingGetAccount, OpenBankingListAccounts, OpenBankingSyncAccounts } from "./integrations/openbanking/contracts/accounts.js";
+import { OpenBankingListTransactions, OpenBankingSyncTransactions } from "./integrations/openbanking/contracts/transactions.js";
+import { OpenBankingGetBalances, OpenBankingRefreshBalances } from "./integrations/openbanking/contracts/balances.js";
+import { OpenBankingFeature } from "./integrations/openbanking/openbanking.feature.js";
+import { registerOpenBankingContracts } from "./integrations/openbanking/contracts/index.js";
+import { assertPrimaryOpenBankingReady, ensurePrimaryOpenBankingIntegration } from "./integrations/openbanking/guards.js";
+import "./integrations/index.js";
+import { KnowledgeSpaceRegistry, makeKnowledgeSpaceKey } from "./knowledge/spec.js";
+import { productCanonKnowledgeSpace, registerProductCanonKnowledgeSpace } from "./knowledge/spaces/product-canon.js";
+import { registerSupportFaqKnowledgeSpace, supportFaqKnowledgeSpace } from "./knowledge/spaces/support-faq.js";
+import { emailThreadsKnowledgeSpace, registerEmailThreadsKnowledgeSpace } from "./knowledge/spaces/email-threads.js";
+import { registerUploadedDocsKnowledgeSpace, uploadedDocsKnowledgeSpace } from "./knowledge/spaces/uploaded-docs.js";
+import { financialDocsKnowledgeSpace, registerFinancialDocsKnowledgeSpace } from "./knowledge/spaces/financial-docs.js";
+import { financialOverviewKnowledgeSpace, registerFinancialOverviewKnowledgeSpace } from "./knowledge/spaces/financial-overview.js";
+import "./knowledge/index.js";
+import { CreateIntegrationConnection, DeleteIntegrationConnection, ListIntegrationConnections, TestIntegrationConnection, UpdateIntegrationConnection, integrationContracts, registerIntegrationContracts } from "./integrations/operations.js";
+import { CreateKnowledgeSource, DeleteKnowledgeSource, ListKnowledgeSources, TriggerKnowledgeSourceSync, UpdateKnowledgeSource, knowledgeContracts, registerKnowledgeContracts } from "./knowledge/operations.js";
+import { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope } from "./regenerator/utils.js";
+import { RegeneratorService } from "./regenerator/service.js";
+import { ProposalExecutor } from "./regenerator/executor.js";
+import { ExecutorProposalSink } from "./regenerator/sinks.js";
+import "./regenerator/index.js";
+import { ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema } from "./workspace-config/contractsrc-schema.js";
+import "./workspace-config/index.js";
+import { WorkflowRegistry } from "./workflow/spec.js";
+import { WorkflowValidationError, assertWorkflowSpecValid, validateWorkflowSpec } from "./workflow/validation.js";
+import { evaluateExpression } from "./workflow/expression.js";
+import { WorkflowPreFlightError, WorkflowRunner } from "./workflow/runner.js";
+import { InMemoryStateStore } from "./workflow/adapters/memory-store.js";
+import { PrismaStateStore } from "./workflow/adapters/db-adapter.js";
+import { createFileStateStore } from "./workflow/adapters/file-adapter.js";
+import "./workflow/index.js";
+import { docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes } from "./docs/presentations.js";
+import { DocRegistry, defaultDocRegistry, docId, listRegisteredDocBlocks, registerDocBlocks } from "./docs/registry.js";
+import { techContractsDocs } from "./docs/tech-contracts.docs.js";
+import { metaDocs } from "./docs/meta.docs.js";
+import "./docs/index.js";
+import { docBlockToMarkdown, eventToMarkdown, exportFeature, exportSpec, featureToMarkdown, operationSpecToAgentPrompt, operationSpecToContextMarkdown, operationSpecToFullMarkdown, presentationToMarkdown } from "./llm/exporters.js";
+import { AGENT_SYSTEM_PROMPTS, formatPlanForAgent, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt } from "./llm/prompts.js";
+import "./llm/index.js";
+import { validateBlueprint, validateConfig, validateResolvedConfig, validateTenantConfig } from "./app-config/validation.js";
+import { defineSchemaModel } from "@lssm/lib.schema";
+
+//#region src/index.ts
+init_registry_utils();
+
+//#endregion
+export { AGENT_SYSTEM_PROMPTS, AccountBalanceRecord, AppBlueprintRegistry, BankAccountRecord, BankTransactionRecord, CapabilityRegistry, CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema, ContractsrcSchema, CreateIntegrationConnection, CreateKnowledgeSource, DEFAULT_CONTRACTSRC, DataViewQueryGenerator, DataViewRegistry, DataViewRuntime, DeleteIntegrationConnection, DeleteKnowledgeSource, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, DocRegistry, EventRegistry, ExecutorProposalSink, ExperimentEvaluator, ExperimentRegistry, FeatureRegistry, FolderConventionsSchema, FormRegistry, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, GroupingStrategies, InMemoryStateStore, IntegrationSpecRegistry, KnowledgeSpaceRegistry, ListIntegrationConnections, ListKnowledgeSources, MigrationRegistry, OPAPolicyAdapter, OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, OpenBankingFeature, OpenBankingGetAccount, OpenBankingGetBalances, OpenBankingListAccounts, OpenBankingListTransactions, OpenBankingRefreshBalances, OpenBankingSyncAccounts, OpenBankingSyncTransactions, OperationSpecRegistry, Owners, OwnersEnum, PolicyEngine, PolicyRegistry, PresentationRegistry, PrismaStateStore, PromptRegistry, ProposalExecutor, RegeneratorService, ResourceRegistry, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput, StabilityEnum, Tags, TagsEnum, TelemetryAnomalyMonitor, TelemetryRegistry, TelemetryTracker, TestIntegrationConnection, TestRegistry, TestRunner, ThemeRegistry, TransformEngine, TriggerKnowledgeSourceSync, UpdateIntegrationConnection, UpdateKnowledgeSource, WorkflowPreFlightError, WorkflowRegistry, WorkflowRunner, WorkflowValidationError, assertPrimaryOpenBankingReady, assertWorkflowSpecValid, behaviorToEnvelope, buildOPAInput, buildZodWithRelations, capabilityKey, composeAppConfig, createDefaultIntegrationSpecRegistry, createDefaultTransformEngine, createEngineWithDefaults, createFeatureModule, createFetchHandler, createFileStateStore, createFormRenderer, createMcpServer, dataViewKey, defaultDocRegistry, defaultGqlField, defaultMcpTool, defaultRestPath, defineCapability, defineCommand, defineEvent, defineFormSpec, definePresentation, definePrompt, defineQuery, defineResourceTemplate, defineSchemaModel, docBlockToMarkdown, docBlockToPresentationSpec, docBlockToPresentationV2, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, elevenLabsIntegrationSpec, elysiaPlugin, emailThreadsKnowledgeSpace, ensurePrimaryOpenBankingIntegration, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, eventToMarkdown, exportFeature, exportSpec, expressRouter, featureToMarkdown, filterBy, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, formatPlanForAgent, gcsStorageIntegrationSpec, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt, getUniqueDomains, getUniqueOwners, getUniqueTags, gmailIntegrationSpec, googleCalendarIntegrationSpec, groupBy, groupByMultiple, groupByToArray, installFeature, installOp, integrationContracts, isEmitDeclRef, isResourceRef, jsonSchemaForSpec, knowledgeContracts, listRegisteredDocBlocks, makeAppBlueprintKey, makeEmit, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makeNextAppHandler, makeNextPagesHandler, makeTelemetryKey, makeTestKey, makeThemeRef, mapDocRoutes, metaDocs, mistralIntegrationSpec, op, opKey, openApiForRegistry, openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, operationSpecToAgentPrompt, operationSpecToContextMarkdown, operationSpecToFullMarkdown, postmarkIntegrationSpec, powensIntegrationSpec, presentationToMarkdown, productCanonKnowledgeSpace, qdrantIntegrationSpec, redactOpenBankingTelemetryPayload, registerBasicValidation, registerContractsOnBuilder, registerDefaultReactRenderer, registerDocBlocks, registerElevenLabsIntegration, registerEmailThreadsKnowledgeSpace, registerFeature, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerIntegrationContracts, registerKnowledgeContracts, registerMistralIntegration, registerOpenBankingCapabilities, registerOpenBankingContracts, registerPostmarkIntegration, registerPowensIntegration, registerProductCanonKnowledgeSpace, registerQdrantIntegration, registerReactToMarkdownRenderer, registerStripeIntegration, registerSupportFaqKnowledgeSpace, registerTwilioSmsIntegration, registerUploadedDocsKnowledgeSpace, renderFeaturePresentation, resolveAppConfig, resourceRef, rnReusablesDriver, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable, shadcnDriver, stripeIntegrationSpec, supportFaqKnowledgeSpace, techContractsDocs, telemetryToEnvelope, twilioSmsIntegrationSpec, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateWorkflowSpec };

package/dist/install.d.ts

@@ -0,0 +1,77 @@
+import "./operations/index.js";
+import { ResourceRefDescriptor } from "./resources.js";
+import { HandlerCtx } from "./types.js";
+import { EventSpec } from "./events.js";
+import { AnyOperationSpec, EmitDecl, OperationSpec } from "./operations/operation.js";
+import { OperationSpecRegistry } from "./operations/registry.js";
+import { AnySchemaModel, ZodSchemaModel } from "@lssm/lib.schema";
+import * as z$1 from "zod";
+
+//#region src/install.d.ts
+/** Infer input/output types from a OperationSpec */
+type OperationSpecInput<Spec extends AnyOperationSpec> = Spec['io']['input'];
+type ZodOperationSpecInput<Spec extends AnyOperationSpec> = ZodSchemaModel<OperationSpecInput<Spec> extends null ? AnySchemaModel : NonNullable<OperationSpecInput<Spec>>>;
+type OperationSpecOutput<Spec extends AnyOperationSpec> = Spec['io']['output'];
+type ResourceItem<O extends ResourceRefDescriptor<boolean>> = Record<O['varName'] extends string ? O['varName'] : 'id', string | number>;
+type ResourceRefOut<O> = O extends ResourceRefDescriptor<boolean> ? O['many'] extends true ? ResourceItem<O>[] : ResourceItem<O> : never;
+type RuntimeSpecOutput<Spec extends AnyOperationSpec> = OperationSpecOutput<Spec> extends AnySchemaModel ? ZodSchemaModel<OperationSpecOutput<Spec>> : ResourceRefOut<OperationSpecOutput<Spec>>;
+/** Handler signature derived from the Spec */
+type HandlerForOperationSpec<Spec extends AnyOperationSpec> = (args: ZodOperationSpecInput<Spec>, ctx: HandlerCtx) => Promise<RuntimeSpecOutput<Spec>>;
+/** Typed event param from Spec.sideEffects.emits */
+type EventParam<S extends OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> = S extends {
+  sideEffects?: {
+    emits?: readonly (infer E)[];
+  };
+} ? E extends {
+  key: string;
+  version: number;
+  payload: AnySchemaModel;
+} ? {
+  key: E['key'];
+  version: E['version'];
+  payload: z$1.infer<ReturnType<E['payload']['getZod']>>;
+} : never : never;
+/** Build a type union of allowed events for a spec */
+type AllowedEventUnion<S extends OperationSpec<AnySchemaModel, AnySchemaModel | ResourceRefDescriptor<boolean>>> = S['sideEffects'] extends {
+  emits: readonly EmitDecl[];
+} ? { [K in keyof S['sideEffects']['emits']]: S['sideEffects']['emits'][K] extends {
+  ref: EventSpec<infer P>;
+} ? {
+  key: S['sideEffects']['emits'][K]['ref']['meta']['key'];
+  version: S['sideEffects']['emits'][K]['ref']['meta']['version'];
+  payload: z$1.infer<ReturnType<P['getZod']>>;
+} : S['sideEffects']['emits'][K] extends {
+  key: infer N extends string;
+  version: infer V extends number;
+  payload: infer Q extends AnySchemaModel;
+} ? {
+  key: N;
+  version: V;
+  payload: z$1.infer<ReturnType<Q['getZod']>>;
+} : never }[number] : never;
+/** Typed emit for a given spec (validates at runtime through ctx.__emitGuard__). */
+declare function makeEmit<S extends AnyOperationSpec>(_spec: S, ctx: HandlerCtx): {
+  /** Le plus sûr : typé via EventSpec (pas besoin de tuple dans le spec) */
+  ref: <T extends AnySchemaModel>(ev: EventSpec<T>, payload: ZodSchemaModel<T>) => Promise<void>;
+  /** Nom/version explicites (runtime-checked par la guard) */
+  key: (key: string, version: number, payload: unknown) => Promise<void>;
+  /** Compat : objet (bénéficie du typing si votre spec a un tuple `as const`) */
+  object: (evt: AllowedEventUnion<S>) => Promise<void>;
+};
+/**
+ * Register the Spec and bind the handler in one call, with full type inference.
+ * Returns the registry for chaining.
+ */
+declare function installOp<S extends AnyOperationSpec>(reg: OperationSpecRegistry, spec: S, handler: HandlerForOperationSpec<S>): OperationSpecRegistry;
+/**
+ * Curried variant if you prefer building a module installer.
+ *   const install = op(BeginSignupSpec, handler);
+ *   install(reg);
+ */
+declare function op<S extends AnyOperationSpec>(spec: S, handler: HandlerForOperationSpec<AnyOperationSpec>): {
+  spec: S;
+  handler: HandlerForOperationSpec<AnyOperationSpec>;
+  install: (reg: OperationSpecRegistry) => OperationSpecRegistry;
+};
+//#endregion
+export { EventParam, HandlerForOperationSpec, OperationSpecInput, OperationSpecOutput, RuntimeSpecOutput, ZodOperationSpecInput, installOp, makeEmit, op };

package/dist/install.js

@@ -1 +1,40 @@
-import"./registry.js";import"zod";function e(e,t){return{ref:async(e,n)=>{await t.__emitGuard__?.(e.name,e.version,n)},named:async(e,n,r)=>{await t.__emitGuard__?.(e,n,r)},object:async e=>{await t.__emitGuard__?.(e.name,e.version,e.payload)}}}function t(e,t,n){return e.register(t).bind(t,n)}function n(e,n){return{spec:e,handler:n,install:r=>t(r,e,n)}}export{t as installOp,e as makeEmit,n as op};
+import "./operations/registry.js";
+import "zod";
+
+//#region src/install.ts
+/** Typed emit for a given spec (validates at runtime through ctx.__emitGuard__). */
+function makeEmit(_spec, ctx) {
+	return {
+		ref: async (ev, payload) => {
+			await ctx.__emitGuard__?.(ev.meta.key, ev.meta.version, payload);
+		},
+		key: async (key, version, payload) => {
+			await ctx.__emitGuard__?.(key, version, payload);
+		},
+		object: async (evt) => {
+			await ctx.__emitGuard__?.(evt.key, evt.version, evt.payload);
+		}
+	};
+}
+/**
+* Register the Spec and bind the handler in one call, with full type inference.
+* Returns the registry for chaining.
+*/
+function installOp(reg, spec, handler) {
+	return reg.register(spec).bind(spec, handler);
+}
+/**
+* Curried variant if you prefer building a module installer.
+*   const install = op(BeginSignupSpec, handler);
+*   install(reg);
+*/
+function op(spec, handler) {
+	return {
+		spec,
+		handler,
+		install: (reg) => installOp(reg, spec, handler)
+	};
+}
+
+//#endregion
+export { installOp, makeEmit, op };

package/dist/integrations/binding.d.ts

@@ -0,0 +1,17 @@
+//#region src/integrations/binding.d.ts
+interface AppIntegrationBinding {
+  /** Which slot this binding satisfies. */
+  slotId: string;
+  /** Which IntegrationConnection to use. */
+  connectionId: string;
+  /** Optional: scope to specific workflows/features. */
+  scope?: {
+    workflows?: string[];
+    features?: string[];
+    operations?: string[];
+  };
+  /** Priority when multiple connections provide same capability. */
+  priority?: number;
+}
+//#endregion
+export { AppIntegrationBinding };

package/dist/integrations/connection.d.ts

@@ -0,0 +1,51 @@
+import { IntegrationOwnershipMode } from "./spec.js";
+
+//#region src/integrations/connection.d.ts
+type ConnectionStatus = 'connected' | 'disconnected' | 'error' | 'unknown';
+interface IntegrationConnectionHealth {
+  status: ConnectionStatus;
+  checkedAt?: Date;
+  latencyMs?: number;
+  errorCode?: string;
+  errorMessage?: string;
+}
+interface IntegrationUsageMetrics {
+  requestCount?: number;
+  successCount?: number;
+  errorCount?: number;
+  lastUsed?: Date;
+  lastSuccessAt?: Date;
+  lastErrorAt?: Date;
+  lastErrorCode?: string;
+}
+interface IntegrationConnectionMeta {
+  id: string;
+  tenantId: string;
+  /** Reference to IntegrationSpec. */
+  integrationKey: string;
+  integrationVersion: number;
+  /** Human-readable label (e.g., "Production Stripe"). */
+  label: string;
+  environment?: string;
+  createdAt: string | Date;
+  updatedAt: string | Date;
+}
+interface IntegrationConnection {
+  meta: IntegrationConnectionMeta;
+  /** Ownership mode indicating who controls credentials. */
+  ownershipMode: IntegrationOwnershipMode;
+  /** External provider account/project identifier (BYOK scenarios). */
+  externalAccountId?: string;
+  /** Encrypted configuration matching IntegrationSpec.configSchema. */
+  config: Record<string, unknown>;
+  /** Reference to external secret store entry containing credentials. */
+  secretProvider: string;
+  secretRef: string;
+  status: ConnectionStatus;
+  /** Last health check result. */
+  health?: IntegrationConnectionHealth;
+  /** Usage tracking. */
+  usage?: IntegrationUsageMetrics;
+}
+//#endregion
+export { ConnectionStatus, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationUsageMetrics };

package/dist/integrations/docs/integrations.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@lssm/lib.contracts/docs";
+
+//#region src/integrations/docs/integrations.docblock.d.ts
+declare const tech_contracts_integrations_DocBlocks: DocBlock[];
+//#endregion
+export { tech_contracts_integrations_DocBlocks };

package/dist/integrations/docs/integrations.docblock.js

@@ -1 +1,94 @@
-import{registerDocBlocks as e}from"../../docs/registry.js";import"../../registry.js";const t=[{id:`docs.tech.contracts.integrations`,title:`ContractSpec Integrations`,summary:`Provider-agnostic integration contracts: specs, connections, secrets, health checks, and runtime guards.`,kind:`reference`,visibility:`public`,route:`/docs/tech/contracts/integrations`,tags:[`tech`,`contracts`,`integrations`],body:"# ContractSpec Integrations\n\nThis document describes the integration architecture that powers ContractSpec-based apps. It focuses on provider-agnostic contracts, secret management, health checks, and runtime guards.\n\n## Core Concepts\n\n- **IntegrationSpec** – declarative description of a provider that lists supported ownership modes, capability mappings, configuration schema, secret schema, health check policy, and documentation metadata.\n- **IntegrationConnection** – tenant/environment binding to a provider (`meta` + ownership mode + config + `secretRef`). Secrets are never embedded in specs or configs.\n- **AppIntegrationSlot** – blueprint-level requirement that declares which integration categories/capabilities must be satisfied at runtime (e.g. `primaryLLM`, `primaryVectorDb`).\n- **AppIntegrationBinding** – tenant-level slot → connection mapping.\n- **ResolvedIntegration** – runtime view containing slot metadata, connection details, and the resolved IntegrationSpec.\n\n## Registered Providers\n\nThe contracts library ships ten priority providers in `packages/libs/contracts/src/integrations/providers`:\n\n| Category      | Provider         | Key                         | Notes                                             |\n| ------------- | ---------------- | --------------------------- | ------------------------------------------------- |\n| payments      | Stripe           | `payments.stripe`          | Card + invoice flows, managed or BYOK credentials |\n| email (out)   | Postmark         | `email.postmark`           | Transactional email delivery                      |\n| email (in)    | Gmail API        | `email.gmail`              | Thread ingestion (OAuth BYOK or service account)  |\n| calendar      | Google Calendar  | `calendar.google`          | Event scheduling via service account              |\n| vector-db     | Qdrant           | `vectordb.qdrant`          | Embedding storage & search                        |\n| storage       | Google Cloud     | `storage.gcs`              | Object storage                                    |\n| ai-llm        | Mistral          | `ai-llm.mistral`           | Primary chat + embedding provider                 |\n| ai-voice      | ElevenLabs       | `ai-voice.elevenlabs`      | Text-to-speech synthesis                          |\n| sms           | Twilio SMS       | `sms.twilio`               | Urgent and fallback reminders                     |\n| open-banking  | Powens           | `openbanking.powens`       | Read-only account, transaction, and balance sync  |\n\nEach provider ships with:\n\n- Strongly typed adapter interfaces (`payments.ts`, `llm.ts`, etc.)\n- A concrete SDK-backed implementation under `providers/impls`\n- Unit tests validating adapter behaviour and health checks\n\n### Canonical registry builder\n\nTo list all shipped specs at runtime, use:\n\n- `createDefaultIntegrationSpecRegistry()` from `@lssm/lib.contracts/integrations/providers/registry`\n\n## Secret Management\n\nAll integrations rely on the `SecretProvider` abstraction defined in `integrations/secrets`. Providers ship with the contracts library and are orchestrated by the `SecretProviderManager` composite:\n\n- **EnvSecretProvider** (`env-secret-provider.ts`) – high-priority, read-only overrides backed by environment variables.\n  - Supports the `env://VARIABLE_NAME` scheme\n  - Supports overrides for other schemes via `?env=ALIAS` or derived uppercase keys\n- **GcpSecretManagerProvider** (`gcp-secret-manager.ts`) – versioned secrets stored in Google Cloud Secret Manager.\n  - Example: `gcp://projects/demo/secrets/stripe-key/versions/latest`\n- **AwsSecretsManagerProvider** (`aws-secret-manager.ts`) – AWS Secrets Manager backend.\n  - Example: `aws://secretsmanager/eu-west-1/my-secret?version=AWSCURRENT`\n  - Region may be in the reference or provided via `AWS_REGION` / `AWS_DEFAULT_REGION`\n- **ScalewaySecretManagerProvider** (`scaleway-secret-manager.ts`) – Scaleway Secret Manager backend.\n  - Example (id): `scw://secret-manager/fr-par/1234...-uuid?version=latest`\n  - Example (name, create+write): `scw://secret-manager/fr-par/my-secret-name`\n  - Requires `SCW_SECRET_KEY` (token) and `SCW_DEFAULT_PROJECT_ID` when creating secrets by name\n\nThe manager attempts providers in priority order (environment first, then cloud providers). Key points:\n\n- `secretRef` is a URI-like reference; raw secrets are never returned.\n- `IntegrationCallGuard` fetches and parses secrets before executing a provider adapter.\n- Local development can rely on `.env` files, while staging/production reference cloud secret stores.\n\n## Health Checks & Telemetry\n\n- Each IntegrationSpec optionally declares `healthCheck.method` and timeouts.\n- `IntegrationCallGuard` enforces connection status, wraps retries with exponential back-off, and emits telemetry events tagged with tenant/app/slot metadata.\n- Validation rules (`app-config/validation.ts`) surface issues at publish time (slot mismatch, unsupported ownership modes, missing capabilities, etc.).\n\n## Studio persistence (ContractSpec Studio)\n\nContractSpec Studio persists tenant `IntegrationConnection` records in Postgres (Prisma model `IntegrationConnection` in `@lssm/lib.database-contractspec-studio`) and exposes a platform-admin management surface (see the Studio platform admin panel).\n"}];e(t);export{t as tech_contracts_integrations_DocBlocks};
+import { registerDocBlocks } from "../../docs/registry.js";
+
+//#region src/integrations/docs/integrations.docblock.ts
+const tech_contracts_integrations_DocBlocks = [{
+	id: "docs.tech.contracts.integrations",
+	title: "ContractSpec Integrations",
+	summary: "Provider-agnostic integration contracts: specs, connections, secrets, health checks, and runtime guards.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/contracts/integrations",
+	tags: [
+		"tech",
+		"contracts",
+		"integrations"
+	],
+	body: `# ContractSpec Integrations
+
+This document describes the integration architecture that powers ContractSpec-based apps. It focuses on provider-agnostic contracts, secret management, health checks, and runtime guards.
+
+## Core Concepts
+
+- **IntegrationSpec** – declarative description of a provider that lists supported ownership modes, capability mappings, configuration schema, secret schema, health check policy, and documentation metadata.
+- **IntegrationConnection** – tenant/environment binding to a provider (\`meta\` + ownership mode + config + \`secretRef\`). Secrets are never embedded in specs or configs.
+- **AppIntegrationSlot** – blueprint-level requirement that declares which integration categories/capabilities must be satisfied at runtime (e.g. \`primaryLLM\`, \`primaryVectorDb\`).
+- **AppIntegrationBinding** – tenant-level slot → connection mapping.
+- **ResolvedIntegration** – runtime view containing slot metadata, connection details, and the resolved IntegrationSpec.
+
+## Registered Providers
+
+The contracts library ships ten priority providers in \`packages/libs/contracts/src/integrations/providers\`:
+
+| Category      | Provider         | Key                         | Notes                                             |
+| ------------- | ---------------- | --------------------------- | ------------------------------------------------- |
+| payments      | Stripe           | \`payments.stripe\`          | Card + invoice flows, managed or BYOK credentials |
+| email (out)   | Postmark         | \`email.postmark\`           | Transactional email delivery                      |
+| email (in)    | Gmail API        | \`email.gmail\`              | Thread ingestion (OAuth BYOK or service account)  |
+| calendar      | Google Calendar  | \`calendar.google\`          | Event scheduling via service account              |
+| vector-db     | Qdrant           | \`vectordb.qdrant\`          | Embedding storage & search                        |
+| storage       | Google Cloud     | \`storage.gcs\`              | Object storage                                    |
+| ai-llm        | Mistral          | \`ai-llm.mistral\`           | Primary chat + embedding provider                 |
+| ai-voice      | ElevenLabs       | \`ai-voice.elevenlabs\`      | Text-to-speech synthesis                          |
+| sms           | Twilio SMS       | \`sms.twilio\`               | Urgent and fallback reminders                     |
+| open-banking  | Powens           | \`openbanking.powens\`       | Read-only account, transaction, and balance sync  |
+
+Each provider ships with:
+
+- Strongly typed adapter interfaces (\`payments.ts\`, \`llm.ts\`, etc.)
+- A concrete SDK-backed implementation under \`providers/impls\`
+- Unit tests validating adapter behaviour and health checks
+
+### Canonical registry builder
+
+To list all shipped specs at runtime, use:
+
+- \`createDefaultIntegrationSpecRegistry()\` from \`@lssm/lib.contracts/integrations/providers/registry\`
+
+## Secret Management
+
+All integrations rely on the \`SecretProvider\` abstraction defined in \`integrations/secrets\`. Providers ship with the contracts library and are orchestrated by the \`SecretProviderManager\` composite:
+
+- **EnvSecretProvider** (\`env-secret-provider.ts\`) – high-priority, read-only overrides backed by environment variables.
+  - Supports the \`env://VARIABLE_NAME\` scheme
+  - Supports overrides for other schemes via \`?env=ALIAS\` or derived uppercase keys
+- **GcpSecretManagerProvider** (\`gcp-secret-manager.ts\`) – versioned secrets stored in Google Cloud Secret Manager.
+  - Example: \`gcp://projects/demo/secrets/stripe-key/versions/latest\`
+- **AwsSecretsManagerProvider** (\`aws-secret-manager.ts\`) – AWS Secrets Manager backend.
+  - Example: \`aws://secretsmanager/eu-west-1/my-secret?version=AWSCURRENT\`
+  - Region may be in the reference or provided via \`AWS_REGION\` / \`AWS_DEFAULT_REGION\`
+- **ScalewaySecretManagerProvider** (\`scaleway-secret-manager.ts\`) – Scaleway Secret Manager backend.
+  - Example (id): \`scw://secret-manager/fr-par/1234...-uuid?version=latest\`
+  - Example (name, create+write): \`scw://secret-manager/fr-par/my-secret-name\`
+  - Requires \`SCW_SECRET_KEY\` (token) and \`SCW_DEFAULT_PROJECT_ID\` when creating secrets by name
+
+The manager attempts providers in priority order (environment first, then cloud providers). Key points:
+
+- \`secretRef\` is a URI-like reference; raw secrets are never returned.
+- \`IntegrationCallGuard\` fetches and parses secrets before executing a provider adapter.
+- Local development can rely on \`.env\` files, while staging/production reference cloud secret stores.
+
+## Health Checks & Telemetry
+
+- Each IntegrationSpec optionally declares \`healthCheck.method\` and timeouts.
+- \`IntegrationCallGuard\` enforces connection status, wraps retries with exponential back-off, and emits telemetry events tagged with tenant/app/slot metadata.
+- Validation rules (\`app-config/validation.ts\`) surface issues at publish time (slot mismatch, unsupported ownership modes, missing capabilities, etc.).
+
+## Studio persistence (ContractSpec Studio)
+
+ContractSpec Studio persists tenant \`IntegrationConnection\` records in Postgres (Prisma model \`IntegrationConnection\` in \`@lssm/lib.database-contractspec-studio\`) and exposes a platform-admin management surface (see the Studio platform admin panel).
+`
+}];
+registerDocBlocks(tech_contracts_integrations_DocBlocks);
+
+//#endregion
+export { tech_contracts_integrations_DocBlocks };

package/dist/integrations/health.d.ts

@@ -0,0 +1,21 @@
+import { IntegrationConnectionHealth } from "./connection.js";
+import { IntegrationContext, IntegrationTelemetryEmitter } from "./runtime.js";
+
+//#region src/integrations/health.d.ts
+interface IntegrationHealthCheckResult extends IntegrationConnectionHealth {
+  metadata?: Record<string, string>;
+}
+type IntegrationHealthCheckExecutor = (context: IntegrationContext) => Promise<void>;
+interface IntegrationHealthServiceOptions {
+  telemetry?: IntegrationTelemetryEmitter;
+  now?: () => Date;
+}
+declare class IntegrationHealthService {
+  private readonly telemetry?;
+  private readonly nowFn;
+  constructor(options?: IntegrationHealthServiceOptions);
+  check(context: IntegrationContext, executor: IntegrationHealthCheckExecutor): Promise<IntegrationHealthCheckResult>;
+  private emitTelemetry;
+}
+//#endregion
+export { IntegrationHealthCheckExecutor, IntegrationHealthCheckResult, IntegrationHealthService, IntegrationHealthServiceOptions };

package/dist/integrations/health.js

@@ -1 +1,69 @@
-var e=class{telemetry;nowFn;constructor(e={}){this.telemetry=e.telemetry,this.nowFn=e.now??(()=>new Date)}async check(e,n){let r=this.nowFn();try{await n(e);let t=this.nowFn(),i={status:`connected`,checkedAt:t,latencyMs:t.getTime()-r.getTime()};return this.emitTelemetry(e,i,`success`),i}catch(n){let i=this.nowFn(),a=n instanceof Error?n.message:`Unknown error`,o=t(n),s={status:`error`,checkedAt:i,latencyMs:i.getTime()-r.getTime(),errorMessage:a,errorCode:o};return this.emitTelemetry(e,s,`error`,o,a),s}}emitTelemetry(e,t,n,r,i){this.telemetry&&this.telemetry.record({tenantId:e.tenantId,appId:e.appId,environment:e.environment,slotId:e.slotId,integrationKey:e.spec.meta.key,integrationVersion:e.spec.meta.version,connectionId:e.connection.meta.id,status:n,durationMs:t.latencyMs,errorCode:r,errorMessage:i,occurredAt:t.checkedAt??this.nowFn(),metadata:{...e.trace?{blueprint:`${e.trace.blueprintName}.v${e.trace.blueprintVersion}`,configVersion:e.trace.configVersion}:{},status:t.status}})}};function t(e){if(!e||typeof e!=`object`)return;let t=e;if(t.code!=null)return String(t.code)}export{e as IntegrationHealthService};
+//#region src/integrations/health.ts
+var IntegrationHealthService = class {
+	telemetry;
+	nowFn;
+	constructor(options = {}) {
+		this.telemetry = options.telemetry;
+		this.nowFn = options.now ?? (() => /* @__PURE__ */ new Date());
+	}
+	async check(context, executor) {
+		const start = this.nowFn();
+		try {
+			await executor(context);
+			const end = this.nowFn();
+			const result = {
+				status: "connected",
+				checkedAt: end,
+				latencyMs: end.getTime() - start.getTime()
+			};
+			this.emitTelemetry(context, result, "success");
+			return result;
+		} catch (error) {
+			const end = this.nowFn();
+			const message = error instanceof Error ? error.message : "Unknown error";
+			const code = extractErrorCode(error);
+			const result = {
+				status: "error",
+				checkedAt: end,
+				latencyMs: end.getTime() - start.getTime(),
+				errorMessage: message,
+				errorCode: code
+			};
+			this.emitTelemetry(context, result, "error", code, message);
+			return result;
+		}
+	}
+	emitTelemetry(context, result, status, errorCode, errorMessage) {
+		if (!this.telemetry) return;
+		this.telemetry.record({
+			tenantId: context.tenantId,
+			appId: context.appId,
+			environment: context.environment,
+			slotId: context.slotId,
+			integrationKey: context.spec.meta.key,
+			integrationVersion: context.spec.meta.version,
+			connectionId: context.connection.meta.id,
+			status,
+			durationMs: result.latencyMs,
+			errorCode,
+			errorMessage,
+			occurredAt: result.checkedAt ?? this.nowFn(),
+			metadata: {
+				...context.trace ? {
+					blueprint: `${context.trace.blueprintName}.v${context.trace.blueprintVersion}`,
+					configVersion: context.trace.configVersion
+				} : {},
+				status: result.status
+			}
+		});
+	}
+};
+function extractErrorCode(error) {
+	if (!error || typeof error !== "object") return void 0;
+	const candidate = error;
+	if (candidate.code == null) return void 0;
+	return String(candidate.code);
+}
+
+//#endregion
+export { IntegrationHealthService };

package/dist/integrations/index.d.ts

@@ -0,0 +1,34 @@
+import { IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, makeIntegrationSpecKey } from "./spec.js";
+import { ConnectionStatus, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationUsageMetrics } from "./connection.js";
+import { AppIntegrationBinding } from "./binding.js";
+import { CapturePaymentInput, CreateCustomerInput, CreatePaymentIntentInput, ListInvoicesQuery, ListTransactionsQuery, Money, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, RefundPaymentInput } from "./providers/payments.js";
+import { LLMChatOptions, LLMContentPart, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, TokenCountResult } from "./providers/llm.js";
+import { EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector } from "./providers/embedding.js";
+import { VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest } from "./providers/vector-store.js";
+import { EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery } from "./providers/email.js";
+import { CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder } from "./providers/calendar.js";
+import { SendSmsInput, SmsDeliveryStatus, SmsMessage, SmsProvider } from "./providers/sms.js";
+import { Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult } from "./providers/voice.js";
+import { DeleteObjectInput, GetObjectResult, ListObjectsQuery, ListObjectsResult, ObjectStorageProvider, PutObjectInput, SignedUrlOptions, StorageObjectBody, StorageObjectMetadata } from "./providers/storage.js";
+import { registerStripeIntegration, stripeIntegrationSpec } from "./providers/stripe.js";
+import { postmarkIntegrationSpec, registerPostmarkIntegration } from "./providers/postmark.js";
+import { qdrantIntegrationSpec, registerQdrantIntegration } from "./providers/qdrant.js";
+import { mistralIntegrationSpec, registerMistralIntegration } from "./providers/mistral.js";
+import { elevenLabsIntegrationSpec, registerElevenLabsIntegration } from "./providers/elevenlabs.js";
+import { gmailIntegrationSpec, registerGmailIntegration } from "./providers/gmail.js";
+import { googleCalendarIntegrationSpec, registerGoogleCalendarIntegration } from "./providers/google-calendar.js";
+import { registerTwilioSmsIntegration, twilioSmsIntegrationSpec } from "./providers/twilio-sms.js";
+import { gcsStorageIntegrationSpec, registerGcsStorageIntegration } from "./providers/gcs-storage.js";
+import { powensIntegrationSpec, registerPowensIntegration } from "./providers/powens.js";
+import { OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingGetAccountDetailsParams, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingTransaction } from "./providers/openbanking.js";
+import { createDefaultIntegrationSpecRegistry } from "./providers/registry.js";
+import "./providers/index.js";
+import { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord } from "./openbanking/models.js";
+import { OpenBankingGetAccount, OpenBankingListAccounts, OpenBankingSyncAccounts } from "./openbanking/contracts/accounts.js";
+import { OpenBankingListTransactions, OpenBankingSyncTransactions } from "./openbanking/contracts/transactions.js";
+import { OpenBankingGetBalances, OpenBankingRefreshBalances } from "./openbanking/contracts/balances.js";
+import { OpenBankingFeature } from "./openbanking/openbanking.feature.js";
+import { registerOpenBankingContracts } from "./openbanking/contracts/index.js";
+import { OpenBankingGuardResult, assertPrimaryOpenBankingReady, ensurePrimaryOpenBankingIntegration } from "./openbanking/guards.js";
+import { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, OpenBankingTelemetryEvent, redactOpenBankingTelemetryPayload } from "./openbanking/telemetry.js";
+export { AccountBalanceRecord, AppIntegrationBinding, BankAccountRecord, BankTransactionRecord, CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder, CapturePaymentInput, ConnectionStatus, CreateCustomerInput, CreatePaymentIntentInput, DeleteObjectInput, EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery, EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector, GetObjectResult, IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationUsageMetrics, LLMChatOptions, LLMContentPart, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, ListInvoicesQuery, ListObjectsQuery, ListObjectsResult, ListTransactionsQuery, Money, OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, ObjectStorageProvider, OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingFeature, OpenBankingGetAccount, OpenBankingGetAccountDetailsParams, OpenBankingGetBalances, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingGuardResult, OpenBankingListAccounts, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactions, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingRefreshBalances, OpenBankingSyncAccounts, OpenBankingSyncTransactions, OpenBankingTelemetryEvent, OpenBankingTransaction, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, PutObjectInput, RefundPaymentInput, SendSmsInput, SignedUrlOptions, SmsDeliveryStatus, SmsMessage, SmsProvider, StorageObjectBody, StorageObjectMetadata, TokenCountResult, VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest, Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult, assertPrimaryOpenBankingReady, createDefaultIntegrationSpecRegistry, elevenLabsIntegrationSpec, ensurePrimaryOpenBankingIntegration, gcsStorageIntegrationSpec, gmailIntegrationSpec, googleCalendarIntegrationSpec, makeIntegrationSpecKey, mistralIntegrationSpec, postmarkIntegrationSpec, powensIntegrationSpec, qdrantIntegrationSpec, redactOpenBankingTelemetryPayload, registerElevenLabsIntegration, registerGcsStorageIntegration, registerGmailIntegration, registerGoogleCalendarIntegration, registerMistralIntegration, registerOpenBankingContracts, registerPostmarkIntegration, registerPowensIntegration, registerQdrantIntegration, registerStripeIntegration, registerTwilioSmsIntegration, stripeIntegrationSpec, twilioSmsIntegrationSpec };