@lssm/lib.contracts 0.0.0-canary-20251217054315 → 0.0.0-canary-20251217060433

package/dist/tests/index.d.ts

@@ -0,0 +1,3 @@
+import { Action, Assertion, CoverageRequirement, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, Fixture, OperationTargetRef, TestRegistry, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, WorkflowTargetRef, makeTestKey } from "./spec.js";
+import { AssertionResult, ScenarioRunResult, TestRunResult, TestRunner, TestRunnerConfig } from "./runner.js";
+export { Action, Assertion, AssertionResult, CoverageRequirement, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, Fixture, OperationTargetRef, ScenarioRunResult, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, WorkflowTargetRef, makeTestKey };

package/dist/tests/runner.d.ts

@@ -0,0 +1,43 @@
+import { Assertion, TestScenario, TestSpec } from "./spec.js";
+import { HandlerCtx } from "../types.js";
+import { SpecRegistry } from "../registry.js";
+import "../index.js";
+
+//#region src/tests/runner.d.ts
+interface ScenarioRunResult {
+  scenario: TestScenario;
+  status: 'passed' | 'failed';
+  error?: Error;
+  assertionResults: AssertionResult[];
+}
+interface AssertionResult {
+  assertion: Assertion;
+  status: 'passed' | 'failed';
+  message?: string;
+}
+interface TestRunResult {
+  spec: TestSpec;
+  scenarios: ScenarioRunResult[];
+  passed: number;
+  failed: number;
+}
+interface TestRunnerConfig {
+  registry: SpecRegistry;
+  createContext?: () => HandlerCtx | Promise<HandlerCtx>;
+  beforeEach?: (scenario: TestScenario) => void | Promise<void>;
+  afterEach?: (scenario: TestScenario, result: ScenarioRunResult) => void | Promise<void>;
+}
+declare class TestRunner {
+  private readonly config;
+  constructor(config: TestRunnerConfig);
+  run(spec: TestSpec): Promise<TestRunResult>;
+  private runScenario;
+  private createContext;
+  private executeOperation;
+  private evaluateAssertion;
+  private evaluateOutputAssertion;
+  private evaluateErrorAssertion;
+  private evaluateEventsAssertion;
+}
+//#endregion
+export { AssertionResult, ScenarioRunResult, TestRunResult, TestRunner, TestRunnerConfig };

package/dist/tests/spec.d.ts

@@ -0,0 +1,89 @@
+import { Owner, Stability, Tag } from "../ownership.js";
+
+//#region src/tests/spec.d.ts
+interface OperationTargetRef {
+  name: string;
+  version?: number;
+}
+interface WorkflowTargetRef {
+  name: string;
+  version?: number;
+}
+type TestTarget = {
+  type: 'contract';
+  operation: OperationTargetRef;
+} | {
+  type: 'workflow';
+  workflow: WorkflowTargetRef;
+};
+interface Fixture {
+  description?: string;
+  operation: OperationTargetRef;
+  input?: unknown;
+}
+interface Action {
+  operation: OperationTargetRef;
+  input?: unknown;
+}
+interface ExpectOutputAssertion {
+  type: 'expectOutput';
+  match: unknown;
+}
+interface ExpectErrorAssertion {
+  type: 'expectError';
+  messageIncludes?: string;
+}
+interface ExpectedEvent {
+  name: string;
+  version: number;
+  min?: number;
+  max?: number;
+}
+interface ExpectEventsAssertion {
+  type: 'expectEvents';
+  events: ExpectedEvent[];
+}
+type Assertion = ExpectOutputAssertion | ExpectErrorAssertion | ExpectEventsAssertion;
+interface TestScenario {
+  name: string;
+  description?: string;
+  given?: Fixture[];
+  when: Action;
+  then?: Assertion[];
+}
+interface CoverageRequirement {
+  statements?: number;
+  branches?: number;
+  functions?: number;
+  lines?: number;
+  mutations?: number;
+}
+interface TestSpecMeta {
+  name: string;
+  version: number;
+  title: string;
+  description?: string;
+  owners: Owner[];
+  tags: Tag[];
+  stability: Stability;
+}
+interface TestSpec {
+  meta: TestSpecMeta;
+  target: TestTarget;
+  fixtures?: Fixture[];
+  scenarios: TestScenario[];
+  coverage?: CoverageRequirement;
+}
+interface TestSpecRef {
+  name: string;
+  version?: number;
+}
+declare class TestRegistry {
+  private readonly items;
+  register(spec: TestSpec): this;
+  list(): TestSpec[];
+  get(name: string, version?: number): TestSpec | undefined;
+}
+declare function makeTestKey(meta: TestSpecMeta): string;
+//#endregion
+export { Action, Assertion, CoverageRequirement, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, Fixture, OperationTargetRef, TestRegistry, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, WorkflowTargetRef, makeTestKey };

package/dist/themes.d.ts

@@ -0,0 +1,55 @@
+import { OwnerShipMeta } from "./ownership.js";
+
+//#region src/themes.d.ts
+type ThemeScope = 'global' | 'tenant' | 'user';
+interface ThemeToken<T> {
+  value: T;
+  description?: string;
+}
+interface ThemeTokens {
+  colors?: Record<string, ThemeToken<string>>;
+  radii?: Record<string, ThemeToken<number>>;
+  space?: Record<string, ThemeToken<number>>;
+  typography?: Record<string, ThemeToken<number>>;
+  shadows?: Record<string, ThemeToken<string>>;
+  motion?: Record<string, ThemeToken<string>>;
+}
+interface ComponentVariantDefinition {
+  props?: Record<string, unknown>;
+  tokens?: ThemeTokens;
+}
+interface ComponentVariantSpec {
+  component: string;
+  variants: Record<string, ComponentVariantDefinition>;
+}
+interface ThemeOverride {
+  scope: ThemeScope;
+  target: string;
+  tokens?: ThemeTokens;
+  components?: ComponentVariantSpec[];
+}
+interface ThemeMeta extends OwnerShipMeta {
+  name: string;
+  version: number;
+  extends?: ThemeRef;
+  scopes?: ThemeScope[];
+}
+interface ThemeSpec {
+  meta: ThemeMeta;
+  tokens: ThemeTokens;
+  components?: ComponentVariantSpec[];
+  overrides?: ThemeOverride[];
+}
+interface ThemeRef {
+  name: string;
+  version: number;
+}
+declare class ThemeRegistry {
+  private readonly items;
+  register(spec: ThemeSpec): this;
+  list(): ThemeSpec[];
+  get(name: string, version?: number): ThemeSpec | undefined;
+}
+declare function makeThemeRef(spec: ThemeSpec): ThemeRef;
+//#endregion
+export { ComponentVariantDefinition, ComponentVariantSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, makeThemeRef };

package/dist/translations/catalog.d.ts

@@ -0,0 +1,28 @@
+//#region src/translations/catalog.d.ts
+type Locale = string;
+type MessageKey = string;
+interface TranslationEntry {
+  key: MessageKey;
+  locale: Locale;
+  value: string;
+  context?: string;
+}
+interface TranslationCatalogMeta {
+  name: string;
+  version: number;
+  description?: string;
+}
+interface PlatformTranslationCatalog {
+  meta: TranslationCatalogMeta;
+  defaultLocale: Locale;
+  supportedLocales: Locale[];
+  entries: TranslationEntry[];
+}
+interface BlueprintTranslationCatalog {
+  meta: TranslationCatalogMeta;
+  defaultLocale: Locale;
+  supportedLocales: Locale[];
+  entries: TranslationEntry[];
+}
+//#endregion
+export { BlueprintTranslationCatalog, Locale, MessageKey, PlatformTranslationCatalog, TranslationCatalogMeta, TranslationEntry };

package/dist/translations/tenant.d.ts

@@ -0,0 +1,15 @@
+import { Locale, TranslationEntry } from "./catalog.js";
+
+//#region src/translations/tenant.d.ts
+interface TenantTranslationOverride {
+  tenantId: string;
+  appId: string;
+  blueprintName: string;
+  blueprintVersion: number;
+  entries: TranslationEntry[];
+  defaultLocale?: Locale;
+  enabledLocales?: Locale[];
+  updatedAt?: string;
+}
+//#endregion
+export { TenantTranslationOverride };

package/dist/types/all.d.ts

@@ -0,0 +1,60 @@
+import { Owner, OwnerShipMeta, Owners, OwnersEnum, Stability, StabilityEnum, Tag, Tags, TagsEnum } from "../ownership.js";
+import { ComponentMap, PresentationDescriptorV2, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationTarget, PresentationV2Meta, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "../presentations.v2.js";
+import { DataPresentation, MarkdownPresentation, PresentationContent, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRegistry, PresentationSpec, WebComponentPresentation, jsonSchemaForPresentation } from "../presentations.js";
+import { EventEnvelope, EventKey, EventSpec, defineEvent, eventKey } from "../events.js";
+import { ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, defineResourceTemplate, isResourceRef, resourceRef } from "../resources.js";
+import { AttributeMatcher, ConsentDefinition, FieldPolicyRule, PIIPolicy, PolicyCondition, PolicyEffect, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, RateLimitDefinition, RelationshipDefinition, RelationshipMatcher, ResourceMatcher, SubjectMatcher, makePolicyKey } from "../policy/spec.js";
+import { Action, Assertion, CoverageRequirement, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, Fixture, OperationTargetRef, TestRegistry, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, WorkflowTargetRef, makeTestKey } from "../tests/spec.js";
+import { AnyContractSpec, ContractSpec, EmitDecl, EmitDeclInline, EmitDeclRef, ImplementationRef, ImplementationType, OpKind, TelemetryTrigger, defineCommand, defineQuery, isEmitDeclRef } from "../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 { CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, capabilityKey, defineCapability } from "../capabilities.js";
+import { AllocationStrategy, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, MetricAggregation, SuccessMetric, TargetingRule, makeExperimentKey } from "../experiments/spec.js";
+import { DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, dataViewKey } from "../data-views.js";
+import { CompensationStep, CompensationStrategy, FormRef, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowStatus } from "../workflow/spec.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, 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 { BrandingAssetRef, BrandingDefaults, ResolvedBranding, TenantBrandingAsset, TenantBrandingConfig } from "../app-config/branding.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, makeAppBlueprintKey } from "../app-config/spec.js";
+import { AppComposition, AppCompositionDeps, ComposeOptions, MissingReference, ResolveAppConfigDeps, ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, composeAppConfig, resolveAppConfig } from "../app-config/runtime.js";
+import { Actor, Channel, EventPublisher, FieldLevelDecision, HandlerCtx, PolicyDecider, PolicyDeciderInput, PolicyDecision, RateLimiter, TranslationResolver } from "../types.js";
+import { EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, OpRef, PresentationRef, installFeature, validateFeatureTargetsV2 } from "../features.js";
+import { GetResolvedBrandingQuery, ResolveMessageQuery, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantTranslationOverridesCommand, VerifyCustomDomainCommand, appConfigContracts, registerAppConfigContracts } from "../app-config/contracts.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.js";
+import { defaultGqlField, defaultMcpTool, defaultRestPath, jsonSchemaForSpec } from "../jsonschema.js";
+import { toV2FromV1 } from "../presentations.backcompat.js";
+import { DecisionContext, PolicyEngine, ResourceContext, SubjectContext, SubjectRelationship } from "../policy/engine.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 { 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 { 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 { ValidateWorkflowSpecOptions, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, validateWorkflowSpec } from "../workflow/validation.js";
+import { StateStore, StepExecution, WorkflowState, WorkflowStateFilters } from "../workflow/state.js";
+import { ExpressionContext, evaluateExpression } from "../workflow/expression.js";
+import { ValidationContext, ValidationIssue, ValidationResult, ValidationSeverity, validateBlueprint, validateConfig, validateResolvedConfig, validateTenantConfig } from "../app-config/validation.js";
+import { CreateTenantConfigDraftCommand, GetTenantConfigVersionQuery, ListTenantConfigVersionsQuery, PromoteTenantConfigToPreviewCommand, PublishTenantConfigCommand, RollbackTenantConfigCommand, lifecycleContracts, registerAppConfigLifecycleContracts } from "../app-config/lifecycle-contracts.js";
+import { IntegrationCallContext, IntegrationCallError, IntegrationCallGuard, IntegrationCallGuardOptions, IntegrationCallResult, IntegrationContext, IntegrationInvocationStatus, IntegrationTelemetryEmitter, IntegrationTelemetryEvent, IntegrationTraceMetadata, connectionStatusLabel, ensureConnectionReady } from "../integrations/runtime.js";
+import { DocumentFragment, DocumentProcessor, RawDocument } from "../knowledge/ingestion/document-processor.js";
+import { EmbeddingService } from "../knowledge/ingestion/embedding-service.js";
+import { VectorIndexConfig, VectorIndexer } from "../knowledge/ingestion/vector-indexer.js";
+import { StorageIngestionAdapter } from "../knowledge/ingestion/storage-adapter.js";
+import { KnowledgeAnswer, KnowledgeQueryConfig, KnowledgeQueryService } from "../knowledge/query/service.js";
+import { KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessResult } from "../knowledge/runtime.js";
+export { Action, ActionExecutionResult, Actor, AllocationStrategy, AnyContractSpec, AppBlueprintMeta, AppBlueprintRegistry, AppBlueprintSpec, AppComposition, AppCompositionDeps, AppIntegrationBinding, AppIntegrationSlot, AppKnowledgeBinding, AppRouteConfig, AppThemeBinding, ArrayFieldSpec, Assertion, AssertionResult, AttributeMatcher, BaseFieldSpec, BehaviorSignal, BehaviorSignalEnvelope, BehaviorSignalProvider, BlueprintTranslationCatalog, BlueprintUpdater, BrandingAssetRef, BrandingDefaults, CapabilityKind, CapabilityMeta, CapabilityRef, CapabilityRegistry, CapabilityRequirement, CapabilitySpec, CapabilitySurface, CapabilitySurfaceRef, Channel, CheckboxFieldSpec, CompensationStep, CompensationStrategy, ComponentMap, ComponentVariantDefinition, ComponentVariantSpec, ComposeOptions, ConnectionStatus, ConsentDefinition, ConstraintDecl, ConstraintHandler, ContractSpec, CoverageRequirement, CreateTenantConfigDraftCommand, DataMigrationStep, DataPresentation, DataViewAction, DataViewBaseConfig, DataViewConfig, DataViewDetailConfig, DataViewField, DataViewFieldFormat, DataViewFilter, DataViewGridConfig, DataViewKind, DataViewListConfig, DataViewMeta, DataViewRegistry, DataViewSections, DataViewSource, DataViewSpec, DataViewStates, DataViewTableColumn, DataViewTableConfig, DecisionContext, DocumentFragment, DocumentProcessor, EmbeddingService, EmitDecl, EmitDeclInline, EmitDeclRef, EnhanceFields, ErrorSignal, ErrorSignalEnvelope, ErrorSignalProvider, EventEnvelope, EventKey, EventPublisher, EventRef, EventSpec, ExecutionStatus, ExecutorProposalSink, ExecutorResultPayload, ExecutorSinkLogger, ExecutorSinkOptions, ExpectErrorAssertion, ExpectEventsAssertion, ExpectOutputAssertion, ExpectedEvent, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, ExpressionContext, FeatureFlagState, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, FieldLevelDecision, FieldPolicyRule, FieldSpec, Fixture, FormAction, FormOption, FormRef, FormRegistry, FormSpec, FormValuesFor, GetResolvedBrandingQuery, GetTenantConfigVersionQuery, GroupFieldSpec, GuardCondition, GuardConditionKind, HandlerCtx, ImplementationRef, ImplementationType, IntegrationByokSetup, IntegrationCallContext, IntegrationCallError, IntegrationCallGuard, IntegrationCallGuardOptions, IntegrationCallResult, IntegrationCapabilityMapping, IntegrationCategory, IntegrationConfigSchema, IntegrationConnection, IntegrationConnectionHealth, IntegrationConnectionMeta, IntegrationContext, IntegrationHealthCheck, IntegrationInvocationStatus, IntegrationMeta, IntegrationOwnershipMode, IntegrationSecretSchema, IntegrationSpec, IntegrationSpecRegistry, IntegrationTelemetryEmitter, IntegrationTelemetryEvent, IntegrationTraceMetadata, IntegrationUsageMetrics, KnowledgeAccessContext, KnowledgeAccessGuard, KnowledgeAccessGuardOptions, KnowledgeAccessPolicy, KnowledgeAccessResult, KnowledgeAnswer, KnowledgeCategory, KnowledgeIndexingConfig, KnowledgeQueryConfig, KnowledgeQueryService, KnowledgeRetentionPolicy, KnowledgeSourceConfig, KnowledgeSourceMeta, KnowledgeSourceType, KnowledgeSpaceMeta, KnowledgeSpaceRegistry, KnowledgeSpaceSpec, ListTenantConfigVersionsQuery, Locale, MarkdownPresentation, MessageKey, MetricAggregation, MigrationCheck, MigrationExecutor, MigrationMeta, MigrationPlan, MigrationRegistry, MigrationSpec, MigrationStep, MigrationStepBase, MigrationStepKind, MissingReference, OpKind, OpRef, OperationTargetRef, OptionsSource, Owner, OwnerShipMeta, Owners, OwnersEnum, PIIPolicy, PlatformTranslationCatalog, PolicyCondition, PolicyDecider, PolicyDeciderInput, PolicyDecision, PolicyEffect, PolicyEngine, PolicyMeta, PolicyOPAConfig, PolicyRef, PolicyRegistry, PolicyRule, PolicySpec, Predicate, PredicateOp, PresentationContent, PresentationDescriptorV2, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRef, PresentationRegistry, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationSpec, PresentationTarget, PresentationV2Meta, PresentationValidator, PromoteTenantConfigToPreviewCommand, ProposalAction, ProposalBlocker, ProposalConfidence, ProposalExecutionResult, ProposalExecutor, ProposalExecutorDeps, ProposalExecutorOptions, ProposalSink, ProposalTarget, PublishTenantConfigCommand, RadioFieldSpec, RateLimitDefinition, RateLimiter, RawDocument, ReactRenderDescriptor, RegenerationContext, RegenerationRule, RegenerationTrigger, RegeneratorOptions, RegeneratorService, RegeneratorSignal, RelationshipDefinition, RelationshipMatcher, RenderContext, ResolveAppConfigDeps, ResolveMessageQuery, ResolvedAppConfig, ResolvedBranding, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation, ResourceContext, ResourceMatcher, ResourceMeta, ResourceRefDescriptor, ResourceRegistry, ResourceTemplateSpec, RetryPolicy, RollbackTenantConfigCommand, RunMigrationsAction, RunTestsAction, RuntimeTelemetryProvider, SLA, ScenarioRunResult, SchemaMigrationStep, SelectFieldSpec, SignalAdapters, SpecChangeProposal, SpecPointer, Stability, StabilityEnum, StateStore, Step, StepAction, StepExecution, StepType, StorageIngestionAdapter, 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, TenantBrandingAsset, TenantBrandingConfig, TenantConfigUpdater, TenantRouteOverride, TenantSpecOverride, TestExecutor, TestRegistry, TestRunResult, TestRunner, TestRunnerConfig, TestScenario, TestSpec, TestSpecMeta, TestSpecRef, TestTarget, TextFieldSpec, TextareaFieldSpec, ThemeMeta, ThemeOverride, ThemeRef, ThemeRegistry, ThemeScope, ThemeSpec, ThemeToken, ThemeTokens, TransformEngine, Transition, TranslationCatalogMeta, TranslationCatalogPointer, TranslationEntry, TranslationResolver, TriggerRegenerationAction, TypedOptionsSource, TypedPredicate, TypedWhenClause, UpdateBlueprintAction, UpdateBlueprintTranslationCatalogCommand, UpdateTenantBrandingCommand, UpdateTenantConfigAction, UpdateTenantTranslationOverridesCommand, ValidateWorkflowSpecOptions, ValidationContext, ValidationIssue, ValidationMigrationStep, ValidationResult, ValidationSeverity, VectorIndexConfig, VectorIndexer, VerifyCustomDomainCommand, WebComponentPresentation, WhenClause, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowTargetRef, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, appConfigContracts, assertWorkflowSpecValid, behaviorToEnvelope, buildZodWithRelations, capabilityKey, composeAppConfig, connectionStatusLabel, createDefaultTransformEngine, dataViewKey, defaultGqlField, defaultMcpTool, defaultRestPath, defineCapability, defineCommand, defineEvent, defineFormSpec, defineQuery, defineResourceTemplate, emailThreadsKnowledgeSpace, ensureConnectionReady, errorToEnvelope, evalPredicate, evaluateExpression, eventKey, financialDocsKnowledgeSpace, financialOverviewKnowledgeSpace, installFeature, isEmitDeclRef, isResourceRef, jsonSchemaForPresentation, jsonSchemaForSpec, lifecycleContracts, makeAppBlueprintKey, makeExperimentKey, makeIntegrationSpecKey, makeKnowledgeSpaceKey, makePolicyKey, makeTelemetryKey, makeTestKey, makeThemeRef, productCanonKnowledgeSpace, registerAppConfigContracts, registerAppConfigLifecycleContracts, registerBasicValidation, registerDefaultReactRenderer, registerEmailThreadsKnowledgeSpace, registerFinancialDocsKnowledgeSpace, registerFinancialOverviewKnowledgeSpace, registerProductCanonKnowledgeSpace, registerReactToMarkdownRenderer, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, resolveAppConfig, resourceRef, supportFaqKnowledgeSpace, telemetryToEnvelope, toV2FromV1, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateWorkflowSpec };

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+import { ConsentDefinition, PolicySpec, RateLimitDefinition } from "./policy/spec.js";
+import { TelemetryTracker } from "./telemetry/tracker.js";
+import { ResolvedBranding } from "./app-config/branding.js";
+import { Locale, MessageKey } from "./translations/catalog.js";
+import { ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation } from "./app-config/runtime.js";
+import { SecretProvider } from "./integrations/secrets/provider.js";
+import { SpecVariantResolver } from "./experiments/spec-resolver.js";
+
+//#region src/types.d.ts
+/**
+ * Common runtime types: execution context, policy decision & event emission.
+ */
+type Actor = 'anonymous' | 'user' | 'admin';
+type Channel = 'web' | 'mobile' | 'job' | 'agent';
+interface FieldLevelDecision {
+  field: string;
+  effect: 'allow' | 'deny';
+  reason?: string;
+}
+interface PolicyDecision {
+  effect: 'allow' | 'deny';
+  reason?: string;
+  rateLimit?: Pick<RateLimitDefinition, 'rpm' | 'key' | 'windowSeconds' | 'burst'>;
+  escalate?: 'human_review' | null;
+  fieldDecisions?: FieldLevelDecision[];
+  pii?: PolicySpec['pii'];
+  requiredConsents?: ConsentDefinition[];
+  evaluatedBy?: 'engine' | 'opa';
+}
+interface PolicyDeciderInput {
+  service: string;
+  command: string;
+  version: number;
+  actor: Actor;
+  channel?: Channel;
+  roles?: string[];
+  organizationId?: string | null;
+  userId?: string | null;
+  flags?: string[];
+}
+type PolicyDecider = (input: PolicyDeciderInput) => Promise<PolicyDecision>;
+type RateLimiter = (key: string, cost: number, rpm: number) => Promise<void>;
+type TranslationResolver = (key: MessageKey, locale?: Locale) => Promise<string | null> | string | null;
+/** Outbox/bus event publisher (after validation & guarding) */
+type EventPublisher = (envelope: {
+  name: string;
+  version: number;
+  payload: unknown;
+  traceId?: string;
+}) => Promise<void>;
+interface HandlerCtx {
+  traceId?: string;
+  idemKey?: string;
+  organizationId?: string | null;
+  userId?: string | null;
+  actor?: Actor;
+  channel?: Channel;
+  roles?: string[];
+  /** Policy engine hook (policy.yaml) */
+  decide?: PolicyDecider;
+  /** Rate limiter (e.g., Redis) */
+  rateLimit?: RateLimiter;
+  /** Telemetry tracker */
+  telemetry?: TelemetryTracker;
+  /** Event publisher (outbox+bus) */
+  eventPublisher?: EventPublisher;
+  /** Secret provider for secure credentials */
+  secretProvider?: SecretProvider;
+  /** Internal pipe: filled by executor to enforce declared events */
+  __emitGuard__?: (name: string, version: number, payload: unknown) => Promise<void>;
+  /** Resolved application configuration for the current execution context */
+  appConfig?: ResolvedAppConfig;
+  /** Resolved integration connections available to this execution */
+  integrations?: ResolvedIntegration[];
+  /** Resolved knowledge spaces available to this execution */
+  knowledge?: ResolvedKnowledge[];
+  /** Resolved branding context */
+  branding?: ResolvedBranding;
+  /** Translation context */
+  translation?: {
+    config: ResolvedTranslation;
+    resolve?: TranslationResolver;
+  };
+  /** Optional spec variant resolver for experiments */
+  specVariantResolver?: SpecVariantResolver;
+}
+//#endregion
+export { Actor, Channel, EventPublisher, FieldLevelDecision, HandlerCtx, PolicyDecider, PolicyDeciderInput, PolicyDecision, RateLimiter, TranslationResolver };

package/dist/workflow/adapters/db-adapter.d.ts

@@ -0,0 +1,34 @@
+import { StateStore, WorkflowState, WorkflowStateFilters } from "../state.js";
+
+//#region src/workflow/adapters/db-adapter.d.ts
+interface PrismaClientLike {
+  workflowState: {
+    create: (args: {
+      data: any;
+    }) => Promise<any>;
+    findUnique: (args: {
+      where: {
+        id: string;
+      };
+    }) => Promise<any>;
+    update: (args: {
+      where: {
+        id: string;
+      };
+      data: any;
+    }) => Promise<any>;
+    findMany: (args: {
+      where?: any;
+    }) => Promise<any[]>;
+  };
+}
+declare class PrismaStateStore implements StateStore {
+  private readonly prisma;
+  constructor(prisma: PrismaClientLike);
+  create(state: WorkflowState): Promise<void>;
+  get(workflowId: string): Promise<WorkflowState | undefined>;
+  update(workflowId: string, updater: (current: WorkflowState) => WorkflowState): Promise<WorkflowState>;
+  list(filters?: WorkflowStateFilters): Promise<WorkflowState[]>;
+}
+//#endregion
+export { PrismaStateStore };

package/dist/workflow/adapters/file-adapter.d.ts

@@ -0,0 +1,14 @@
+import { StateStore } from "../state.js";
+
+//#region src/workflow/adapters/file-adapter.d.ts
+interface FileStateStoreOptions {
+  /** Absolute or relative path to the persistence file. */
+  filePath: string;
+}
+/**
+ * Placeholder for a file-backed state store adapter.
+ * Implementations should manage locking/concurrency and JSON serialization.
+ */
+declare function createFileStateStore(_options: FileStateStoreOptions): StateStore;
+//#endregion
+export { FileStateStoreOptions, createFileStateStore };

package/dist/workflow/adapters/index.d.ts

@@ -0,0 +1,4 @@
+import { InMemoryStateStore } from "./memory-store.js";
+import { PrismaStateStore } from "./db-adapter.js";
+import { FileStateStoreOptions, createFileStateStore } from "./file-adapter.js";
+export { FileStateStoreOptions, InMemoryStateStore, PrismaStateStore, createFileStateStore };

package/dist/workflow/adapters/memory-store.d.ts

@@ -0,0 +1,18 @@
+import { StateStore, WorkflowState, WorkflowStateFilters } from "../state.js";
+
+//#region src/workflow/adapters/memory-store.d.ts
+
+/**
+ * Naive in-memory state store. Suitable for tests and single-node development
+ * environments. Swap with a database-backed adapter in production.
+ */
+declare class InMemoryStateStore implements StateStore {
+  private readonly items;
+  create(state: WorkflowState): Promise<void>;
+  get(workflowId: string): Promise<WorkflowState | undefined>;
+  update(workflowId: string, updater: (current: WorkflowState) => WorkflowState): Promise<WorkflowState>;
+  list(filters?: WorkflowStateFilters): Promise<WorkflowState[]>;
+  clear(): void;
+}
+//#endregion
+export { InMemoryStateStore };

package/dist/workflow/expression.d.ts

@@ -0,0 +1,9 @@
+//#region src/workflow/expression.d.ts
+interface ExpressionContext {
+  data: Record<string, unknown>;
+  input?: unknown;
+  output?: unknown;
+}
+declare function evaluateExpression(expression: string | undefined, ctx: ExpressionContext): boolean;
+//#endregion
+export { ExpressionContext, evaluateExpression };

package/dist/workflow/index.d.ts

@@ -0,0 +1,10 @@
+import { CompensationStep, CompensationStrategy, FormRef, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowStatus } from "./spec.js";
+import { ValidateWorkflowSpecOptions, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, validateWorkflowSpec } from "./validation.js";
+import { StateStore, StepExecution, WorkflowState, WorkflowStateFilters } from "./state.js";
+import { GuardContext, GuardEvaluator, OperationExecutor, OperationExecutorContext, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRunner, WorkflowRunnerConfig } from "./runner.js";
+import { ExpressionContext, evaluateExpression } from "./expression.js";
+import { InMemoryStateStore } from "./adapters/memory-store.js";
+import { PrismaStateStore } from "./adapters/db-adapter.js";
+import { FileStateStoreOptions, createFileStateStore } from "./adapters/file-adapter.js";
+import "./adapters/index.js";
+export { CompensationStep, CompensationStrategy, ExpressionContext, FileStateStoreOptions, FormRef, GuardCondition, GuardConditionKind, GuardContext, GuardEvaluator, InMemoryStateStore, OperationExecutor, OperationExecutorContext, PrismaStateStore, RetryPolicy, SLA, StateStore, Step, StepAction, StepExecution, StepType, Transition, ValidateWorkflowSpecOptions, WorkflowDefinition, WorkflowMeta, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRegistry, WorkflowRunner, WorkflowRunnerConfig, WorkflowSpec, WorkflowState, WorkflowStateFilters, WorkflowStatus, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, createFileStateStore, evaluateExpression, validateWorkflowSpec };

package/dist/workflow/runner.d.ts

@@ -0,0 +1,74 @@
+import { GuardCondition, Step, WorkflowRegistry } from "./spec.js";
+import { ResolvedBranding } from "../app-config/branding.js";
+import { ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation } from "../app-config/runtime.js";
+import { SecretProvider } from "../integrations/secrets/provider.js";
+import { TranslationResolver } from "../types.js";
+import { OpRef } from "../features.js";
+import { StateStore, WorkflowState } from "./state.js";
+
+//#region src/workflow/runner.d.ts
+interface OperationExecutorContext {
+  workflow: WorkflowState;
+  step: Step;
+  resolvedAppConfig?: ResolvedAppConfig;
+  integrations?: ResolvedIntegration[];
+  knowledge?: ResolvedKnowledge[];
+  branding?: ResolvedBranding;
+  translation?: ResolvedTranslation;
+  translationResolver?: TranslationResolver;
+  secretProvider?: SecretProvider;
+}
+type OperationExecutor = (op: OpRef, input: unknown, context: OperationExecutorContext) => Promise<unknown>;
+type WorkflowPreFlightIssueType = 'integration' | 'capability';
+type WorkflowPreFlightIssueSeverity = 'error' | 'warning';
+interface WorkflowPreFlightIssue {
+  stepId: string;
+  type: WorkflowPreFlightIssueType;
+  identifier: string;
+  severity: WorkflowPreFlightIssueSeverity;
+  reason: string;
+}
+interface WorkflowPreFlightResult {
+  canStart: boolean;
+  issues: WorkflowPreFlightIssue[];
+}
+interface GuardContext {
+  workflow: WorkflowState;
+  step: Step;
+  input?: unknown;
+}
+type GuardEvaluator = (guard: GuardCondition, context: GuardContext) => Promise<boolean> | boolean;
+interface WorkflowRunnerConfig {
+  registry: WorkflowRegistry;
+  stateStore: StateStore;
+  opExecutor: OperationExecutor;
+  guardEvaluator?: GuardEvaluator;
+  eventEmitter?: (event: string, payload: Record<string, unknown>) => void;
+  appConfigProvider?: (state: WorkflowState) => ResolvedAppConfig | undefined | Promise<ResolvedAppConfig | undefined>;
+  enforceCapabilities?: (operation: OpRef, context: OperationExecutorContext) => void | Promise<void>;
+  secretProvider?: SecretProvider;
+  translationResolver?: TranslationResolver;
+}
+declare class WorkflowRunner {
+  private readonly config;
+  constructor(config: WorkflowRunnerConfig);
+  preFlightCheck(workflowName: string, version?: number, resolvedConfig?: ResolvedAppConfig): Promise<WorkflowPreFlightResult>;
+  start(workflowName: string, version?: number, initialData?: Record<string, unknown>): Promise<string>;
+  executeStep(workflowId: string, input?: unknown): Promise<void>;
+  rollback(workflowId: string): Promise<void>;
+  getState(workflowId: string): Promise<WorkflowState>;
+  cancel(workflowId: string): Promise<void>;
+  private performPreFlight;
+  private evaluateGuard;
+  private runStepAction;
+  private pickNextStepId;
+  private getSpec;
+  private getStateOrThrow;
+  private emit;
+}
+declare class WorkflowPreFlightError extends Error {
+  readonly issues: WorkflowPreFlightIssue[];
+  constructor(issues: WorkflowPreFlightIssue[]);
+}
+//#endregion
+export { GuardContext, GuardEvaluator, OperationExecutor, OperationExecutorContext, WorkflowPreFlightError, WorkflowPreFlightIssue, WorkflowPreFlightIssueSeverity, WorkflowPreFlightIssueType, WorkflowPreFlightResult, WorkflowRunner, WorkflowRunnerConfig };

package/dist/workflow/sla-monitor.d.ts

@@ -0,0 +1,20 @@
+import { WorkflowSpec } from "./spec.js";
+import { WorkflowState } from "./state.js";
+
+//#region src/workflow/sla-monitor.d.ts
+interface SLABreachEvent {
+  workflowId: string;
+  workflowName: string;
+  type: 'workflow_duration' | 'step_duration';
+  stepId?: string;
+  expectedMs: number;
+  actualMs: number;
+  breachedAt: Date;
+}
+declare class SLAMonitor {
+  private readonly eventEmitter;
+  constructor(eventEmitter: (event: string, payload: SLABreachEvent) => void);
+  check(state: WorkflowState, spec: WorkflowSpec): void;
+}
+//#endregion
+export { SLABreachEvent, SLAMonitor };