@contractspec/lib.contracts 0.0.0-canary-20260113162409

package/dist/forms/forms.js

@@ -0,0 +1,143 @@
+import { __toCommonJS } from "../_virtual/rolldown_runtime.js";
+import { init_registry_utils, registry_utils_exports } from "../registry-utils.js";
+import { compareVersions } from "compare-versions";
+
+//#region src/forms/forms.ts
+function formKey(meta) {
+	return `${meta.key}.v${meta.version}`;
+}
+var FormRegistry = class {
+	items = /* @__PURE__ */ new Map();
+	register(spec) {
+		const key = formKey(spec.meta);
+		if (this.items.has(key)) throw new Error(`Duplicate form ${key}`);
+		this.items.set(key, spec);
+		return this;
+	}
+	list() {
+		return [...this.items.values()];
+	}
+	get(key, version) {
+		if (version != null) return this.items.get(`${key}.v${version}`);
+		let candidate;
+		for (const [k, v] of this.items.entries()) {
+			if (v.meta.key !== key) continue;
+			if (!candidate || compareVersions(v.meta.version, candidate.meta.version) > 0) candidate = v;
+		}
+		return candidate;
+	}
+	/** Filter forms by criteria. */
+	filter(criteria) {
+		const { filterBy } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return filterBy(this.list(), criteria);
+	}
+	/** List forms with specific tag. */
+	listByTag(tag) {
+		return this.list().filter((f) => f.meta.tags?.includes(tag));
+	}
+	/** List forms by owner. */
+	listByOwner(owner) {
+		return this.list().filter((f) => f.meta.owners?.includes(owner));
+	}
+	/** Group forms by key function. */
+	groupBy(keyFn) {
+		const { groupBy } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return groupBy(this.list(), keyFn);
+	}
+	/** Get unique tags from all forms. */
+	getUniqueTags() {
+		const { getUniqueTags } = (init_registry_utils(), __toCommonJS(registry_utils_exports));
+		return getUniqueTags(this.list());
+	}
+};
+function getAtPath(values, path) {
+	if (!path) return void 0;
+	const segs = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+	let cur = values;
+	for (const s of segs) {
+		if (cur == null) return void 0;
+		if (cur && typeof cur === "object" && s in cur) cur = cur[s];
+		else return;
+	}
+	return cur;
+}
+function evalPredicate(values, pred) {
+	if (!pred) return true;
+	if (pred.not) return !evalPredicate(values, pred.not);
+	if (pred.all && pred.all.length) return pred.all.every((p) => evalPredicate(values, p));
+	if (pred.anyOf && pred.anyOf.length) return pred.anyOf.some((p) => evalPredicate(values, p));
+	if (pred.when) {
+		const { path, op = "truthy", value } = pred.when;
+		const v = getAtPath(values, path);
+		switch (op) {
+			case "equals": return v === value;
+			case "notEquals": return v !== value;
+			case "in": return Array.isArray(value) && value.includes(v);
+			case "notIn": return Array.isArray(value) && !value.includes(v);
+			case "gt": return Number(v) > Number(value);
+			case "gte": return Number(v) >= Number(value);
+			case "lt": return Number(v) < Number(value);
+			case "lte": return Number(v) <= Number(value);
+			case "empty": return v == null || (Array.isArray(v) ? v.length === 0 : String(v).length === 0);
+			case "lengthGt": return (Array.isArray(v) || typeof v === "string") && v.length > Number(value ?? 0);
+			case "lengthGte": return (Array.isArray(v) || typeof v === "string") && v.length >= Number(value ?? 0);
+			case "lengthLt": return (Array.isArray(v) || typeof v === "string") && v.length < Number(value ?? 0);
+			case "lengthLte": return (Array.isArray(v) || typeof v === "string") && v.length <= Number(value ?? 0);
+			case "truthy":
+			default: return Boolean(v);
+		}
+	}
+	return true;
+}
+/**
+* Wrap the base zod schema with relation-driven refinements (requiredWhen, array min/max)
+* and optional custom constraints. Call this when wiring RHF resolver.
+*/
+function buildZodWithRelations(spec, handlers) {
+	return spec.model.getZod().superRefine((values, ctx) => {
+		const visit = (field, parentPath) => {
+			const path = field.name ? parentPath ? `${parentPath}.${field.name}` : field.name : parentPath ?? "";
+			if (field.requiredWhen) {
+				if (evalPredicate(values, field.requiredWhen)) {
+					const v = getAtPath(values, path);
+					if (v == null || typeof v === "string" && v.trim().length === 0 || Array.isArray(v) && v.length === 0) ctx.addIssue({
+						code: "custom",
+						path: path.split("."),
+						message: "required"
+					});
+				}
+			}
+			if (field.kind === "array") {
+				const arr = getAtPath(values, path);
+				if (field.min != null && Array.isArray(arr) && arr.length < field.min) ctx.addIssue({
+					code: "custom",
+					path: path.split("."),
+					message: `min:${field.min}`
+				});
+				if (field.max != null && Array.isArray(arr) && arr.length > field.max) ctx.addIssue({
+					code: "custom",
+					path: path.split("."),
+					message: `max:${field.max}`
+				});
+				visit(field.of, path);
+			} else if (field.kind === "group") for (const child of field.fields) visit(child, path);
+		};
+		for (const f of spec.fields) visit(f);
+		if (spec.constraints && handlers) for (const c of spec.constraints) {
+			const fn = handlers[c.key];
+			if (!fn) continue;
+			const res = fn(values, c.paths, c.args);
+			if (!res.ok) ctx.addIssue({
+				code: "custom",
+				path: (res.path ?? c.paths[0] ?? "").split(".").filter(Boolean),
+				message: res.message ?? c.messageI18n
+			});
+		}
+	});
+}
+function defineFormSpec(spec) {
+	return spec;
+}
+
+//#endregion
+export { FormRegistry, buildZodWithRelations, defineFormSpec, evalPredicate };

package/dist/forms/index.d.ts

@@ -0,0 +1,2 @@
+import { ArrayFieldSpec, BaseFieldSpec, CheckboxFieldSpec, ConstraintDecl, ConstraintHandler, EnhanceFields, FieldSpec, FormAction, FormOption, FormRegistry, FormSpec, FormValuesFor, GroupFieldSpec, OptionsSource, Predicate, PredicateOp, RadioFieldSpec, SelectFieldSpec, SwitchFieldSpec, TextFieldSpec, TextareaFieldSpec, TypedOptionsSource, TypedPredicate, TypedWhenClause, WhenClause, buildZodWithRelations, defineFormSpec, evalPredicate } from "./forms.js";
+export { ArrayFieldSpec, BaseFieldSpec, CheckboxFieldSpec, ConstraintDecl, ConstraintHandler, EnhanceFields, FieldSpec, FormAction, FormOption, FormRegistry, FormSpec, FormValuesFor, GroupFieldSpec, OptionsSource, Predicate, PredicateOp, RadioFieldSpec, SelectFieldSpec, SwitchFieldSpec, TextFieldSpec, TextareaFieldSpec, TypedOptionsSource, TypedPredicate, TypedWhenClause, WhenClause, buildZodWithRelations, defineFormSpec, evalPredicate };

package/dist/forms/index.js

@@ -0,0 +1,3 @@
+import { FormRegistry, buildZodWithRelations, defineFormSpec, evalPredicate } from "./forms.js";
+
+export { FormRegistry, buildZodWithRelations, defineFormSpec, evalPredicate };

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+import { DocBlock, DocBlockLink, DocKind, DocVisibility } from "./docs/types.js";
+import { PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationSpecMeta, PresentationTarget, definePresentation } from "./presentations/presentations.js";
+import { DocPresentationOptions, DocPresentationRoute, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, mapDocRoutes } from "./docs/presentations.js";
+import { DocId, 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 { Owner, OwnerShipMeta, Owners, OwnersEnum, Stability, StabilityEnum, Tag, Tags, TagsEnum } from "./ownership.js";
+import { FilterableItem, GroupKeyFn, GroupedItems, GroupingStrategies, RegistryFilter, filterBy, getUniqueDomains, getUniqueOwners, getUniqueTags, groupBy, groupByMultiple, groupByToArray } from "./registry-utils.js";
+import { AttributeMatcher, ConsentDefinition, FieldPolicyRule, PIIPolicy, PolicyCondition, PolicyEffect, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRule, PolicySpec, RateLimitDefinition, RelationshipDefinition, RelationshipMatcher, ResourceMatcher, SubjectMatcher } from "./policy/spec.js";
+import { TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyThreshold, TelemetryConfig, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySpec, makeTelemetryKey } from "./telemetry/spec.js";
+import { TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions } from "./telemetry/anomaly.js";
+import { RuntimeTelemetryProvider, TelemetryDispatch, TelemetryEventContext, TelemetryTracker, TelemetryTrackerOptions } from "./telemetry/tracker.js";
+import "./telemetry/index.js";
+import { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey, defineCapability } from "./capabilities/capabilities.js";
+import { openBankingAccountsReadCapability, openBankingBalancesReadCapability, openBankingTransactionsReadCapability, registerOpenBankingCapabilities } from "./capabilities/openbanking.js";
+import "./capabilities/index.js";
+import { AllocationStrategy, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, MetricAggregation, SuccessMetric, TargetingRule, makeExperimentKey } from "./experiments/spec.js";
+import { ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, defineResourceTemplate, isResourceRef, resourceRef } from "./resources.js";
+import { Action, Assertion, CoverageRequirement, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, Fixture, OperationTargetRef, TestRegistry, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, WorkflowTargetRef, defineTestSpec, makeTestKey } from "./tests/spec.js";
+import { AnyOperationSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, OperationSpec, OperationSpecMeta, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef } from "./operations/operation.js";
+import { EventParam, HandlerForOperationSpec, OperationSpecInput, OperationSpecOutput, RuntimeSpecOutput, ZodOperationSpecInput, installOp, makeEmit, op } from "./install.js";
+import { OperationKey, OperationSpecRegistry, opKey } from "./operations/registry.js";
+import "./operations/index.js";
+import { EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, OpRef, PresentationRef } from "./features/types.js";
+import { FeatureRegistry } from "./features/registry.js";
+import { ComponentMap, PresentationRenderer, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "./presentations/transform-engine.js";
+import { PresentationRegistry } from "./presentations/registry.js";
+import "./presentations/index.js";
+import { InstallFeatureDeps, installFeature } from "./features/install.js";
+import { validateFeatureTargetsV2 } from "./features/validation.js";
+import { defineFeature } from "./features/index.js";
+import { DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewSections, DataViewSource, DataViewStates, DataViewTableColumn, DataViewTableConfig } from "./data-views/types.js";
+import { DataViewRef, DataViewSpec, defineDataView } from "./data-views/spec.js";
+import { DataViewRegistry, dataViewKey } from "./data-views/registry.js";
+import "./data-views/index.js";
+import { CompensationStep, CompensationStrategy, FormRef, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowStatus } from "./workflow/spec.js";
+import { PolicyRegistry } from "./policy/registry.js";
+import { ComponentVariantDefinition, ComponentVariantSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, makeThemeRef } from "./themes.js";
+import { IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, defineIntegration, makeIntegrationSpecKey } from "./integrations/spec.js";
+import { ConnectionStatus, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationUsageMetrics } from "./integrations/connection.js";
+import { AppIntegrationBinding } from "./integrations/binding.js";
+import { KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, makeKnowledgeSpaceKey } from "./knowledge/spec.js";
+import { KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType } from "./knowledge/source.js";
+import { AppKnowledgeBinding } from "./knowledge/binding.js";
+import { BlueprintTranslationCatalog, Locale, MessageKey, PlatformTranslationCatalog, TranslationCatalogMeta, TranslationEntry } from "./translations/catalog.js";
+import { AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TenantAppConfig, TenantAppConfigMeta, TenantRouteOverride, TenantSpecOverride, TranslationCatalogPointer, defineAppConfig, makeAppBlueprintKey } from "./app-config/spec.js";
+import { AppComposition, AppCompositionDeps, ComposeOptions, MissingReference, ResolveAppConfigDeps, ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, composeAppConfig, resolveAppConfig } from "./app-config/runtime.js";
+import { RuntimeContract, SpecVariantResolver } from "./experiments/spec-resolver.js";
+import { Actor, Channel, ContractSpecType, EventPublisher, FieldLevelDecision, HandlerCtx, PolicyDecider, PolicyDeciderInput, PolicyDecision, RateLimiter, TranslationResolver } from "./types.js";
+import { AnyEventSpec, EventEnvelope, EventKey, EventRegistry, EventSpec, EventSpecMeta, defineEvent, eventKey } from "./events.js";
+import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./client/react/feature-render.js";
+import { ArrayFieldSpec, BaseFieldSpec, CheckboxFieldSpec, ConstraintDecl, ConstraintHandler, EnhanceFields, FieldSpec, FormAction, FormOption, FormRegistry, FormSpec, FormValuesFor, GroupFieldSpec, OptionsSource, Predicate, PredicateOp, RadioFieldSpec, SelectFieldSpec, SwitchFieldSpec, TextFieldSpec, TextareaFieldSpec, TypedOptionsSource, TypedPredicate, TypedWhenClause, WhenClause, buildZodWithRelations, defineFormSpec, evalPredicate } from "./forms/forms.js";
+import "./forms/index.js";
+import { ComputationMap, CreateRendererOptions, DriverSlots, RenderOptions, ResolverMap, createFormRenderer } from "./client/react/form-render.js";
+import { ShadcnDriver, shadcnDriver } from "./client/react/drivers/shadcn.js";
+import { RnReusablesDriver, rnReusablesDriver } from "./client/react/drivers/rn-reusables.js";
+import "./client/index.js";
+import { registerContractsOnBuilder } from "./server/graphql-pothos.js";
+import { PromptArg, PromptContentPart, PromptMeta, PromptPolicy, PromptSpec, PromptStability, definePrompt } from "./prompt.js";
+import { PromptRegistry } from "./promptRegistry.js";
+import { createMcpServer } from "./server/mcp/createMcpServer.js";
+import { RestOptions, 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 { ContractRegistryFile, ContractRegistryItem, ContractRegistryItemType, ContractRegistryManifest, JsonSchema } from "./contract-registry/types.js";
+import { ContractRegistryFileSchema, ContractRegistryItemParsed, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestParsed, ContractRegistryManifestSchema } from "./contract-registry/schemas.js";
+import "./contract-registry/index.js";
+import { defaultGqlField, defaultMcpPrompt, defaultMcpTool, defaultRestPath, jsonSchemaForSpec, sanitizeMcpName } from "./jsonschema.js";
+import { OpenApiDocument, OpenApiExportOptions, OpenApiServer, openApiForRegistry } from "./openapi.js";
+import { ModelRegistry } from "./model-registry.js";
+import { CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput } from "./onboarding-base.js";
+import { DecisionContext, PolicyEngine, ResourceContext, SubjectContext, SubjectRelationship } from "./policy/engine.js";
+import { OPAAdapterOptions, OPAClient, OPAEvaluationResult, OPAPolicyAdapter, buildOPAInput } from "./policy/opa-adapter.js";
+import "./policy/index.js";
+import { DataMigrationStep, MigrationCheck, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, SchemaMigrationStep, ValidationMigrationStep } from "./migrations.js";
+import { AssertionResult, ScenarioRunResult, TestRunResult, TestRunner, TestRunnerConfig } from "./tests/runner.js";
+import "./tests/index.js";
+import { ExperimentContext, ExperimentEvaluation, ExperimentEvaluator, ExperimentEvaluatorConfig } from "./experiments/evaluator.js";
+import { CapturePaymentInput, CreateCustomerInput, CreatePaymentIntentInput, ListInvoicesQuery, ListTransactionsQuery, Money, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, RefundPaymentInput } from "./integrations/providers/payments.js";
+import { LLMChatOptions, LLMContentPart, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, TokenCountResult } from "./integrations/providers/llm.js";
+import { EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector } from "./integrations/providers/embedding.js";
+import { VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest } from "./integrations/providers/vector-store.js";
+import { EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery } from "./integrations/providers/email.js";
+import { CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder } from "./integrations/providers/calendar.js";
+import { SendSmsInput, SmsDeliveryStatus, SmsMessage, SmsProvider } from "./integrations/providers/sms.js";
+import { Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult } from "./integrations/providers/voice.js";
+import { DeleteObjectInput, GetObjectResult, ListObjectsQuery, ListObjectsResult, ObjectStorageProvider, PutObjectInput, SignedUrlOptions, StorageObjectBody, StorageObjectMetadata } from "./integrations/providers/storage.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 { OpenBankingAccountBalance, OpenBankingAccountDetails, OpenBankingAccountOwnership, OpenBankingAccountSummary, OpenBankingBalanceType, OpenBankingConnectionStatus, OpenBankingGetAccountDetailsParams, OpenBankingGetBalancesParams, OpenBankingGetConnectionStatusParams, OpenBankingListAccountsParams, OpenBankingListAccountsResult, OpenBankingListTransactionsParams, OpenBankingListTransactionsResult, OpenBankingProvider, OpenBankingTransaction } from "./integrations/providers/openbanking.js";
+import { createDefaultIntegrationSpecRegistry } from "./integrations/providers/registry.js";
+import { AccountBalanceRecord, BankAccountRecord, BankTransactionRecord } from "./integrations/openbanking/models.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 { OpenBankingGuardResult, assertPrimaryOpenBankingReady, ensurePrimaryOpenBankingIntegration } from "./integrations/openbanking/guards.js";
+import { OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, OpenBankingTelemetryEvent, redactOpenBankingTelemetryPayload } from "./integrations/openbanking/telemetry.js";
+import "./integrations/index.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 { BehaviorSignal, BehaviorSignalEnvelope, ErrorSignal, ErrorSignalEnvelope, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalSink, ProposalTarget, RegenerationContext, RegenerationRule, RegeneratorSignal, SpecChangeProposal, TelemetrySignal, TelemetrySignalEnvelope } from "./regenerator/types.js";
+import { BehaviorSignalProvider, ErrorSignalProvider, SignalAdapters, TelemetrySignalProvider } from "./regenerator/adapters.js";
+import { RegeneratorOptions, RegeneratorService } from "./regenerator/service.js";
+import { ActionExecutionResult, BlueprintUpdater, ExecutionStatus, MigrationExecutor, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, RegenerationTrigger, RunMigrationsAction, RunTestsAction, TenantConfigUpdater, TestExecutor, TriggerRegenerationAction, UpdateBlueprintAction, UpdateTenantConfigAction } from "./regenerator/executor.js";
+import { behaviorToEnvelope, errorToEnvelope, telemetryToEnvelope } from "./regenerator/utils.js";
+import { ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions } from "./regenerator/sinks.js";
+import "./regenerator/index.js";
+import { TenantTranslationOverride } from "./translations/tenant.js";
+import { BumpStrategy, BumpStrategySchema, ChangelogFormat, ChangelogFormatSchema, ChangelogTier, ChangelogTierSchema, ContractsrcConfig, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventions, FolderConventionsSchema, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, OpenApiConfig, OpenApiConfigSchema, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiSourceConfig, OpenApiSourceConfigSchema, RuleSyncConfig, RuleSyncConfigSchema, RuleSyncTarget, RuleSyncTargetSchema, SchemaFormat, SchemaFormatSchema, VersioningConfig, VersioningConfigSchema } from "./workspace-config/contractsrc-schema.js";
+import "./workspace-config/index.js";
+import { ValidateWorkflowSpecOptions, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, validateWorkflowSpec } from "./workflow/validation.js";
+import { StateStore, StepExecution, WorkflowState, WorkflowStateFilters } from "./workflow/state.js";
+import { GuardContext, GuardEvaluator, OperationExecutor, OperationExecutorContext, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRunner, WorkflowRunnerConfig } from "./workflow/runner.js";
+import { ExpressionContext, evaluateExpression } from "./workflow/expression.js";
+import { InMemoryStateStore } from "./workflow/adapters/memory-store.js";
+import { PrismaStateStore } from "./workflow/adapters/db-adapter.js";
+import { FileStateStoreOptions, createFileStateStore } from "./workflow/adapters/file-adapter.js";
+import { defineWorkflow } from "./workflow/index.js";
+import { SchemaMarkdownOptions, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable } from "./schema-to-markdown.js";
+import { AgentPrompt, AgentType, BatchExportOptions, ExportableItem, FeatureExportOptions, FeatureExportResult, FeatureLookup, ImplementationPlan, LLMExportFormat, SpecExportOptions, SpecExportResult, SpecLookup, VerificationIssue, VerificationReport, VerificationTier } from "./llm/types.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 { ValidationContext, ValidationIssue, ValidationResult, ValidationSeverity, validateBlueprint, validateConfig, validateResolvedConfig, validateTenantConfig } from "./app-config/validation.js";
+import { ExampleDocumentation, ExampleEntrypoints, ExampleKind, ExampleKindEnum, ExampleMcpSupport, ExampleMeta, ExampleSandboxMode, ExampleSandboxModeEnum, ExampleSandboxSupport, ExampleSpec, ExampleStudioSupport, ExampleSurfaces, ExampleVisibility, ExampleVisibilityEnum, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer } from "./examples/types.js";
+import { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindSchema, ExampleMetaSchema, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilitySchema, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec } from "./examples/schema.js";
+import { ExampleRegistry } from "./examples/registry.js";
+import { CrossValidationContext, ExampleValidationError, ExampleValidationWarning, ValidateExampleResult, ValidateExamplesResult, validateExample, validateExampleReferences, validateExamples } from "./examples/validation.js";
+import { defineExample } from "./examples/index.js";
+import { ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogJsonExport, ChangelogResult, SemanticVersion, VersionAnalysis, VersionAnalysisResult, VersionBumpType, isChangeType, isChangelogDocBlock, isVersionBumpType } from "./versioning/types.js";
+import { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion } from "./versioning/utils.js";
+import { defineSchemaModel } from "@contractspec/lib.schema";
+export { AGENT_SYSTEM_PROMPTS, AccountBalanceRecord, Action, ActionExecutionResult, Actor, AgentPrompt, AgentType, AllocationStrategy, AnyEventSpec, AnyOperationSpec, AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppIntegrationBinding, AppIntegrationSlot, AppKnowledgeBinding, AppRouteConfig, AppThemeBinding, ArrayFieldSpec, Assertion, AssertionResult, AttributeMatcher, BankAccountRecord, BankTransactionRecord, BaseFieldSpec, BatchExportOptions, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintTranslationCatalog, BlueprintUpdater, BumpStrategy, BumpStrategySchema, CalendarAttendee, CalendarEvent, CalendarEventInput, CalendarEventUpdateInput, CalendarListEventsQuery, CalendarListEventsResult, CalendarProvider, CalendarReminder, CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, CapturePaymentInput, ChangeEntry, ChangeType, ChangelogDocBlock, ChangelogEntry, ChangelogFormat, ChangelogFormatSchema, ChangelogJsonExport, ChangelogResult, ChangelogTier, ChangelogTierSchema, Channel, CheckboxFieldSpec, CompensationStep, CompensationStrategy, CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, ComponentMap, ComponentVariantDefinition, ComponentVariantSpec, ComposeOptions, ComputationMap, ConnectionStatus, ConsentDefinition, ConstraintDecl, ConstraintHandler, ContractRegistryFile, ContractRegistryFileSchema, ContractRegistryItem, ContractRegistryItemParsed, ContractRegistryItemSchema, ContractRegistryItemType, ContractRegistryItemTypeSchema, ContractRegistryManifest, ContractRegistryManifestParsed, ContractRegistryManifestSchema, ContractSpecType, ContractsrcConfig, ContractsrcSchema, CoverageRequirement, CreateCustomerInput, CreateIntegrationConnection, CreateKnowledgeSource, CreatePaymentIntentInput, CreateRendererOptions, CrossValidationContext, DEFAULT_CONTRACTSRC, DataMigrationStep, DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRef, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, DecisionContext, DeleteIntegrationConnection, DeleteKnowledgeSource, DeleteObjectInput, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, DocBlock, DocBlockLink, DocId, DocKind, DocPresentationOptions, DocPresentationRoute, DocRegistry, DocVisibility, DriverSlots, EmailAddress, EmailAttachment, EmailInboundProvider, EmailMessage, EmailMessagesSinceQuery, EmailOutboundMessage, EmailOutboundProvider, EmailOutboundResult, EmailThread, EmailThreadListQuery, EmbeddingDocument, EmbeddingProvider, EmbeddingResult, EmbeddingVector, EmitDecl, EmitDeclInline, EmitDeclRef, EnhanceFields, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, EventEnvelope, EventKey, EventParam, EventPublisher, EventRef, EventRegistry, EventSpec, EventSpecMeta, ExampleDocumentation, ExampleDocumentationSchema, ExampleEntrypoints, ExampleEntrypointsSchema, ExampleKind, ExampleKindEnum, ExampleKindSchema, ExampleMcpSupport, ExampleMeta, ExampleMetaSchema, ExampleRegistry, ExampleSandboxMode, ExampleSandboxModeEnum, ExampleSandboxModeSchema, ExampleSandboxSupport, ExampleSpec, ExampleSpecSchema, ExampleStudioSupport, ExampleSurfaces, ExampleSurfacesSchema, ExampleValidationError, ExampleValidationWarning, ExampleVisibility, ExampleVisibilityEnum, ExampleVisibilitySchema, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, ExperimentContext, ExperimentEvaluation, ExperimentEvaluator, ExperimentEvaluatorConfig, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, ExportableItem, ExpressionContext, FeatureExportOptions, FeatureExportResult, FeatureFlagState, FeatureLookup, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, FieldLevelDecision, FieldPolicyRule, FieldSpec, FileStateStoreOptions, FilterableItem, Fixture, FolderConventions, FolderConventionsSchema, FormAction, FormOption, FormRef, FormRegistry, FormSpec, FormValuesFor, FormatterConfig, FormatterConfigSchema, FormatterType, FormatterTypeSchema, GetObjectResult, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, GroupFieldSpec, GroupKeyFn, GroupedItems, GroupingStrategies, GuardCondition, GuardConditionKind, GuardContext, GuardEvaluator, HandlerCtx, HandlerForOperationSpec, ImplementationPlan, ImplementationRef, ImplementationType, InMemoryStateStore, InstallFeatureDeps, IntegrationByokSetup, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationHealthCheck, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationUsageMetrics, JsonSchema, KnowledgeAccessPolicy, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, LLMChatOptions, LLMContentPart, LLMExportFormat, LLMMessage, LLMProvider, LLMResponse, LLMRole, LLMStreamChunk, LLMTextPart, LLMTokenUsage, LLMToolCallPart, LLMToolDefinition, LLMToolResultPart, ListIntegrationConnections, ListInvoicesQuery, ListKnowledgeSources, ListObjectsQuery, ListObjectsResult, ListTransactionsQuery, Locale, MessageKey, MetricAggregation, MigrationCheck, MigrationExecutor, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, MissingReference, ModelRegistry, Money, OPAAdapterOptions, OPAClient, OPAEvaluationResult, OPAPolicyAdapter, OPENBANKING_PII_FIELDS, OPENBANKING_TELEMETRY_EVENTS, ObjectStorageProvider, OpKind, OpRef, OpenApiConfig, OpenApiConfigSchema, OpenApiDocument, OpenApiExportConfig, OpenApiExportConfigSchema, OpenApiExportOptions, OpenApiServer, OpenApiSourceConfig, OpenApiSourceConfigSchema, 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, OperationExecutor, OperationExecutorContext, OperationKey, OperationSpec, OperationSpecInput, OperationSpecMeta, OperationSpecOutput, OperationSpecRegistry, OperationTargetRef, OptionsSource, Owner, OwnerShipMeta, Owners, OwnersEnum, PIIPolicy, PaymentCustomer, PaymentIntent, PaymentIntentStatus, PaymentInvoice, PaymentRefund, PaymentTransaction, PaymentsProvider, PlatformTranslationCatalog, PolicyCondition, PolicyDecider, PolicyDeciderInput, PolicyDecision, PolicyEffect, PolicyEngine, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, Predicate, PredicateOp, PresentationRef, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationSpecMeta, PresentationTarget, PresentationValidator, PrismaStateStore, PromptArg, PromptContentPart, PromptMeta, PromptPolicy, PromptRegistry, PromptSpec, PromptStability, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, PutObjectInput, RadioFieldSpec, RateLimitDefinition, RateLimiter, ReactRenderDescriptor, RefundPaymentInput, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RegistryFilter, RelationshipDefinition, RelationshipMatcher, RenderContext, RenderOptions, ResolveAppConfigDeps, ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, ResolverMap, ResourceContext, ResourceMatcher, ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, RestOptions, RetryPolicy, RnReusablesDriver, RuleSyncConfig, RuleSyncConfigSchema, RuleSyncTarget, RuleSyncTargetSchema, RunMigrationsAction, RunTestsAction, RuntimeContract, RuntimeSpecOutput, RuntimeTelemetryProvider, SLA, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput, ScenarioRunResult, SchemaFormat, SchemaFormatSchema, SchemaMarkdownOptions, SchemaMigrationStep, SelectFieldSpec, SemanticVersion, SendSmsInput, ShadcnDriver, SignalAdapters, SignedUrlOptions, SmsDeliveryStatus, SmsMessage, SmsProvider, SpecChangeProposal, SpecExportOptions, SpecExportResult, SpecLookup, SpecPointer, SpecVariantResolver, Stability, StabilityEnum, StateStore, Step, StepAction, StepExecution, StepType, StorageObjectBody, StorageObjectMetadata, SubjectContext, SubjectMatcher, SubjectRelationship, SuccessMetric, SwitchFieldSpec, Tag, Tags, TagsEnum, TargetingRule, TelemetryAnomalyAction, TelemetryAnomalyDetectionConfig, TelemetryAnomalyEvent, TelemetryAnomalyMonitor, TelemetryAnomalyMonitorOptions, TelemetryAnomalyThreshold, TelemetryBinding, TelemetryConfig, TelemetryDispatch, TelemetryEventContext, TelemetryEventDef, TelemetryMeta, TelemetryPrivacyLevel, TelemetryPropertyDef, TelemetryProviderConfig, TelemetryRegistry, TelemetryRetentionConfig, TelemetrySamplingConfig, TelemetrySignal, TelemetrySignalEnvelope, TelemetrySignalProvider, TelemetrySpec, TelemetryTracker, TelemetryTrackerOptions, TelemetryTrigger, TenantAppConfig, TenantAppConfigMeta, TenantConfigUpdater, TenantRouteOverride, TenantSpecOverride, TenantTranslationOverride, TestExecutor, TestIntegrationConnection, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, TextFieldSpec, TextareaFieldSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, TokenCountResult, TransformEngine, Transition, TranslationCatalogMeta, TranslationCatalogPointer, TranslationEntry, TranslationResolver, TriggerKnowledgeSourceSync, TriggerRegenerationAction, TypedOptionsSource, TypedPredicate, TypedWhenClause, UpdateBlueprintAction, UpdateIntegrationConnection, UpdateKnowledgeSource, UpdateTenantConfigAction, ValidateExampleResult, ValidateExamplesResult, ValidateWorkflowSpecOptions, ValidationContext, ValidationIssue, ValidationMigrationStep, ValidationResult, ValidationSeverity, VectorDeleteRequest, VectorDocument, VectorSearchQuery, VectorSearchResult, VectorStoreProvider, VectorUpsertRequest, VerificationIssue, VerificationReport, VerificationTier, VersionAnalysis, VersionAnalysisResult, VersionBumpType, VersioningConfig, VersioningConfigSchema, Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult, WhenClause, WorkflowDefinition, WorkflowMeta, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRegistry, WorkflowRunner, WorkflowRunnerConfig, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowTargetRef, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, ZodOperationSpecInput, assertPrimaryOpenBankingReady, assertWorkflowSpecValid, behaviorToEnvelope, buildOPAInput, buildZodWithRelations, bumpVersion, capabilityKey, compareVersions, composeAppConfig, createDefaultIntegrationSpecRegistry, createDefaultTransformEngine, createEngineWithDefaults, createFeatureModule, createFetchHandler, createFileStateStore, createFormRenderer, createMcpServer, dataViewKey, defaultDocRegistry, defaultGqlField, defaultMcpPrompt, defaultMcpTool, defaultRestPath, defineAppConfig, defineCapability, defineCommand, defineDataView, defineEvent, defineExample, defineFeature, defineFormSpec, defineIntegration, definePresentation, definePrompt, defineQuery, defineResourceTemplate, defineSchemaModel, defineTestSpec, defineWorkflow, determineBumpType, docBlockToMarkdown, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, elevenLabsIntegrationSpec, elysiaPlugin, emailThreadsKnowledgeSpace, ensurePrimaryOpenBankingIntegration, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, eventToMarkdown, exportFeature, exportSpec, expressRouter, featureToMarkdown, filterBy, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, formatPlanForAgent, formatVersion, gcsStorageIntegrationSpec, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt, getBumpTypePriority, getMaxBumpType, getUniqueDomains, getUniqueOwners, getUniqueTags, gmailIntegrationSpec, googleCalendarIntegrationSpec, groupBy, groupByMultiple, groupByToArray, installFeature, installOp, integrationContracts, isChangeType, isChangelogDocBlock, isEmitDeclRef, isExampleKind, isExampleVisibility, isFeatureRef, isResourceRef, isSpecPointer, isValidVersion, isVersionBumpType, isVersionEqual, isVersionGreater, isVersionLess, 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, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, parseVersion, parseVersionStrict, 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, safeParseExampleSpec, sanitizeMcpName, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable, shadcnDriver, stripeIntegrationSpec, supportFaqKnowledgeSpace, techContractsDocs, telemetryToEnvelope, twilioSmsIntegrationSpec, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateExample, validateExampleReferences, validateExamples, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateVersion, validateWorkflowSpec };

package/dist/index.js

@@ -0,0 +1,132 @@
+import { GroupingStrategies, filterBy, getUniqueDomains, getUniqueOwners, getUniqueTags, groupBy, groupByMultiple, groupByToArray, init_registry_utils } from "./registry-utils.js";
+import { EventRegistry, defineEvent, eventKey } from "./events.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 { FeatureRegistry } from "./features/registry.js";
+import { installFeature } from "./features/install.js";
+import { validateFeatureTargetsV2 } from "./features/validation.js";
+import { defineFeature } from "./features/index.js";
+import { createEngineWithDefaults, createFeatureModule, registerFeature, renderFeaturePresentation } from "./client/react/feature-render.js";
+import { FormRegistry, buildZodWithRelations, defineFormSpec, evalPredicate } from "./forms/forms.js";
+import "./forms/index.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, defaultMcpPrompt, defaultMcpTool, defaultRestPath, jsonSchemaForSpec, sanitizeMcpName } 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 { ModelRegistry } from "./model-registry.js";
+import { CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput } from "./onboarding-base.js";
+import { defineDataView } from "./data-views/spec.js";
+import { DataViewRegistry, dataViewKey } from "./data-views/registry.js";
+import "./data-views/index.js";
+import { PolicyRegistry } from "./policy/registry.js";
+import { PolicyEngine } from "./policy/engine.js";
+import { OPAPolicyAdapter, buildOPAInput } from "./policy/opa-adapter.js";
+import "./policy/index.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, defineTestSpec, 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, defineAppConfig, makeAppBlueprintKey } from "./app-config/spec.js";
+import { composeAppConfig, resolveAppConfig } from "./app-config/runtime.js";
+import { IntegrationSpecRegistry, defineIntegration, 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 { BumpStrategySchema, ChangelogFormatSchema, ChangelogTierSchema, ContractsrcSchema, DEFAULT_CONTRACTSRC, FolderConventionsSchema, FormatterConfigSchema, FormatterTypeSchema, OpenApiConfigSchema, OpenApiExportConfigSchema, OpenApiSourceConfigSchema, RuleSyncConfigSchema, RuleSyncTargetSchema, SchemaFormatSchema, VersioningConfigSchema } 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 { defineWorkflow } from "./workflow/index.js";
+import { docBlockToPresentationSpec, 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 { ExampleKindEnum, ExampleSandboxModeEnum, ExampleVisibilityEnum, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer } from "./examples/types.js";
+import { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindSchema, ExampleMetaSchema, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilitySchema, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec } from "./examples/schema.js";
+import { ExampleRegistry } from "./examples/registry.js";
+import { validateExample, validateExampleReferences, validateExamples } from "./examples/validation.js";
+import { defineExample } from "./examples/index.js";
+import { isChangeType, isChangelogDocBlock, isVersionBumpType } from "./versioning/types.js";
+import { bumpVersion, compareVersions, determineBumpType, formatVersion, getBumpTypePriority, getMaxBumpType, isValidVersion, isVersionEqual, isVersionGreater, isVersionLess, parseVersion, parseVersionStrict, validateVersion } from "./versioning/utils.js";
+import { defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/index.ts
+init_registry_utils();
+
+//#endregion
+export { AGENT_SYSTEM_PROMPTS, AccountBalanceRecord, AppBlueprintRegistry, BankAccountRecord, BankTransactionRecord, BumpStrategySchema, CapabilityRegistry, ChangelogFormatSchema, ChangelogTierSchema, CompleteOnboardingBaseInput, CompleteOnboardingBaseOutput, CompleteOnboardingBaseSpec, ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema, ContractRegistryManifestSchema, ContractsrcSchema, CreateIntegrationConnection, CreateKnowledgeSource, DEFAULT_CONTRACTSRC, DataViewRegistry, DeleteIntegrationConnection, DeleteKnowledgeSource, DeleteOnboardingDraftBaseSpec, DeleteOnboardingDraftOutput, DocRegistry, EventRegistry, ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindEnum, ExampleKindSchema, ExampleMetaSchema, ExampleRegistry, ExampleSandboxModeEnum, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilityEnum, ExampleVisibilitySchema, ExecutorProposalSink, ExperimentEvaluator, ExperimentRegistry, FeatureRegistry, FolderConventionsSchema, FormRegistry, FormatterConfigSchema, FormatterTypeSchema, GetOnboardingDraftBaseSpec, GetOnboardingDraftOutput, GroupingStrategies, InMemoryStateStore, IntegrationSpecRegistry, KnowledgeSpaceRegistry, ListIntegrationConnections, ListKnowledgeSources, MigrationRegistry, ModelRegistry, 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, RuleSyncConfigSchema, RuleSyncTargetSchema, SaveOnboardingDraftBaseSpec, SaveOnboardingDraftInput, SaveOnboardingDraftOutput, SchemaFormatSchema, StabilityEnum, Tags, TagsEnum, TelemetryAnomalyMonitor, TelemetryRegistry, TelemetryTracker, TestIntegrationConnection, TestRegistry, TestRunner, ThemeRegistry, TransformEngine, TriggerKnowledgeSourceSync, UpdateIntegrationConnection, UpdateKnowledgeSource, VersioningConfigSchema, WorkflowPreFlightError, WorkflowRegistry, WorkflowRunner, WorkflowValidationError, assertPrimaryOpenBankingReady, assertWorkflowSpecValid, behaviorToEnvelope, buildOPAInput, buildZodWithRelations, bumpVersion, capabilityKey, compareVersions, composeAppConfig, createDefaultIntegrationSpecRegistry, createDefaultTransformEngine, createEngineWithDefaults, createFeatureModule, createFetchHandler, createFileStateStore, createFormRenderer, createMcpServer, dataViewKey, defaultDocRegistry, defaultGqlField, defaultMcpPrompt, defaultMcpTool, defaultRestPath, defineAppConfig, defineCapability, defineCommand, defineDataView, defineEvent, defineExample, defineFeature, defineFormSpec, defineIntegration, definePresentation, definePrompt, defineQuery, defineResourceTemplate, defineSchemaModel, defineTestSpec, defineWorkflow, determineBumpType, docBlockToMarkdown, docBlockToPresentationSpec, docBlocksToPresentationRoutes, docBlocksToPresentationSpecs, docId, elevenLabsIntegrationSpec, elysiaPlugin, emailThreadsKnowledgeSpace, ensurePrimaryOpenBankingIntegration, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, eventToMarkdown, exportFeature, exportSpec, expressRouter, featureToMarkdown, filterBy, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, formatPlanForAgent, formatVersion, gcsStorageIntegrationSpec, generateFixViolationsPrompt, generateImplementationPlan, generateImplementationPrompt, generateReviewPrompt, generateTestPrompt, generateVerificationPrompt, getBumpTypePriority, getMaxBumpType, getUniqueDomains, getUniqueOwners, getUniqueTags, gmailIntegrationSpec, googleCalendarIntegrationSpec, groupBy, groupByMultiple, groupByToArray, installFeature, installOp, integrationContracts, isChangeType, isChangelogDocBlock, isEmitDeclRef, isExampleKind, isExampleVisibility, isFeatureRef, isResourceRef, isSpecPointer, isValidVersion, isVersionBumpType, isVersionEqual, isVersionGreater, isVersionLess, 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, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, parseVersion, parseVersionStrict, 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, safeParseExampleSpec, sanitizeMcpName, schemaToMarkdown, schemaToMarkdownDetail, schemaToMarkdownList, schemaToMarkdownSummary, schemaToMarkdownTable, shadcnDriver, stripeIntegrationSpec, supportFaqKnowledgeSpace, techContractsDocs, telemetryToEnvelope, twilioSmsIntegrationSpec, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateExample, validateExampleReferences, validateExamples, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateVersion, validateWorkflowSpec };

package/dist/install.d.ts

@@ -0,0 +1,77 @@
+import { ResourceRefDescriptor } from "./resources.js";
+import { AnyOperationSpec, EmitDecl, OperationSpec } from "./operations/operation.js";
+import { OperationSpecRegistry } from "./operations/registry.js";
+import "./operations/index.js";
+import { HandlerCtx } from "./types.js";
+import { EventSpec } from "./events.js";
+import { AnySchemaModel, ZodSchemaModel } from "@contractspec/lib.schema";
+import * as z$2 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: string;
+  payload: AnySchemaModel;
+} ? {
+  key: E['key'];
+  version: E['version'];
+  payload: z$2.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$2.infer<ReturnType<P['getZod']>>;
+} : S['sideEffects']['emits'][K] extends {
+  key: infer N extends string;
+  version: infer V extends string;
+  payload: infer Q extends AnySchemaModel;
+} ? {
+  key: N;
+  version: V;
+  payload: z$2.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: string, 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 };