@lssm/lib.contracts 1.2.0

package/dist/types/all.d.ts

@@ -0,0 +1,60 @@
+import { BrandingAssetRef, BrandingDefaults, ResolvedBranding, TenantBrandingAsset, TenantBrandingConfig } from "../app-config/branding.js";
+import { Owner, OwnerShipMeta, Owners, OwnersEnum, Stability, StabilityEnum, Tag, Tags, TagsEnum } from "../ownership.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, 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 } from "../capabilities.js";
+import { DataPresentation, MarkdownPresentation, PresentationContent, PresentationKind, PresentationMeta, PresentationPolicy, PresentationRegistry, PresentationSpec, WebComponentPresentation, jsonSchemaForPresentation } from "../presentations.js";
+import { PresentationDescriptorV2, PresentationRenderer, PresentationSource, PresentationSourceBlocknotejs, PresentationSourceComponentReact, PresentationTarget, PresentationV2Meta, PresentationValidator, ReactRenderDescriptor, RenderContext, TransformEngine, createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer } from "../presentations.v2.js";
+import { AllocationStrategy, ExperimentMeta, ExperimentOverride, ExperimentOverrideType, ExperimentRef, ExperimentRegistry, ExperimentSpec, ExperimentVariant, MetricAggregation, SuccessMetric, TargetingRule, makeExperimentKey } from "../experiments/spec.js";
+import { EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, FeatureRegistry, OpRef, PresentationRef, installFeature, validateFeatureTargetsV2 } from "../features.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 { 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 { 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 { IntegrationCallContext, IntegrationCallError, IntegrationCallGuard, IntegrationCallGuardOptions, IntegrationCallResult, IntegrationContext, IntegrationInvocationStatus, IntegrationTelemetryEmitter, IntegrationTelemetryEvent, IntegrationTraceMetadata, connectionStatusLabel, ensureConnectionReady } from "../integrations/runtime.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 { 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, 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, 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, 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, registerSupportFaqKnowledgeSpace, registerUploadedDocsKnowledgeSpace, resolveAppConfig, resourceRef, supportFaqKnowledgeSpace, telemetryToEnvelope, toV2FromV1, uploadedDocsKnowledgeSpace, validateBlueprint, validateConfig, validateFeatureTargetsV2, validateResolvedConfig, validateTenantConfig, validateWorkflowSpec };

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+import { ResolvedBranding } from "./app-config/branding.js";
+import { ConsentDefinition, PolicySpec, RateLimitDefinition } from "./policy/spec.js";
+import { TelemetryTracker } from "./telemetry/tracker.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";
+
+//#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;
+  };
+}
+//#endregion
+export { Actor, Channel, EventPublisher, FieldLevelDecision, HandlerCtx, PolicyDecider, PolicyDeciderInput, PolicyDecision, RateLimiter, TranslationResolver };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;KAGY,KAAA;KACA,OAAA;AAwBK,UANA,kBAAA,CAMc;EAGZ,KAAA,EAAA,MAAA;EAAL,MAAA,EAAA,OAAA,GAAA,MAAA;EAEK,MAAA,CAAA,EAAA,MAAA;;AAEE,UAPJ,cAAA,CAOI;EAAiB,MAAA,EAAA,OAAA,GAAA,MAAA;EAIrB,MAAA,CAAA,EAAA,MAAA;EAYL,SAAA,CAAA,EApBE,IAoBW,CApBN,mBAoBM,EAAA,KAAA,GAAA,KAAA,GAAA,eAAA,GAAA,OAAA,CAAA;EAChB,QAAA,CAAA,EAAA,cAAA,GAAA,IAAA;EACI,cAAA,CAAA,EApBM,kBAoBN,EAAA;EAAR,GAAA,CAAA,EAnBG,UAmBH,CAAA,KAAA,CAAA;EAAO,gBAAA,CAAA,EAlBS,iBAkBT,EAAA;EAEA,WAAA,CAAA,EAAW,QAAA,GAIlB,KAAA;AAEL;AACO,UAvBU,kBAAA,CAuBV;EACI,OAAA,EAAA,MAAA;EACN,OAAA,EAAA,MAAA;EAAO,OAAA,EAAA,MAAA;EAGA,KAAA,EAxBH,KAwBG;EAOK,OAAA,CAAA,EA9BL,OA8Be;EAKjB,KAAA,CAAA,EAAA,MAAA,EAAA;EACE,cAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAID,MAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAEG,KAAA,CAAA,EAAA,MAAA,EAAA;;AAIK,KAvCP,aAAA,GAuCO,CAAA,KAAA,EAtCV,kBAsCU,EAAA,GArCd,OAqCc,CArCN,cAqCM,CAAA;AAEA,KArCP,WAAA,GAqCO,CAAA,GAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,GAAA,EAAA,MAAA,EAAA,GAjCd,OAiCc,CAAA,IAAA,CAAA;AAOZ,KAtCK,mBAAA,GAsCL,CAAA,GAAA,EArCA,UAqCA,EAAA,MAAA,CAAA,EApCI,MAoCJ,EAAA,GAnCF,OAmCE,CAAA,MAAA,GAAA,IAAA,CAAA,GAAA,MAAA,GAAA,IAAA;;AAIU,KApCL,cAAA,GAoCK,CAAA,QAAA,EAAA;EAEH,IAAA,EAAA,MAAA;EAED,OAAA,EAAA,MAAA;EAGD,OAAA,EAAA,OAAA;EACE,OAAA,CAAA,EAAA,MAAA;CAAmB,EAAA,GAvC3B,OAuC2B,CAAA,IAAA,CAAA;UArChB,UAAA;;;;;UAKP;YACE;;;WAID;;cAEG;;cAEA;;mBAEK;;mBAEA;;uEAOZ;;cAEO;;iBAEG;;cAEH;;aAED;;;YAGD;cACE"}

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

@@ -0,0 +1,15 @@
+import { StateStore } from "../state.js";
+
+//#region src/workflow/adapters/db-adapter.d.ts
+interface DatabaseStateStoreOptions {
+  /** Placeholder for connection string / client injection. */
+  connection?: unknown;
+}
+/**
+ * Placeholder factory to guide future database adapters (PostgreSQL, MongoDB, etc.).
+ * Consumers should provide their own implementation that satisfies {@link StateStore}.
+ */
+declare function createDatabaseStateStore(_options: DatabaseStateStoreOptions): StateStore;
+//#endregion
+export { DatabaseStateStoreOptions, createDatabaseStateStore };
+//# sourceMappingURL=db-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db-adapter.d.ts","names":[],"sources":["../../../src/workflow/adapters/db-adapter.ts"],"sourcesContent":[],"mappings":";;;UAEiB,yBAAA;;EAAA,UAAA,CAAA,EAAA,OAAA;AASjB;;;;;iBAAgB,wBAAA,WACJ,4BACT"}

package/dist/workflow/adapters/db-adapter.js

@@ -0,0 +1,2 @@
+function e(e){throw Error(`Database state store adapter not implemented. Provide a custom adapter that satisfies StateStore.`)}export{e as createDatabaseStateStore};
+//# sourceMappingURL=db-adapter.js.map

package/dist/workflow/adapters/db-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-adapter.js","names":[],"sources":["../../../src/workflow/adapters/db-adapter.ts"],"sourcesContent":["import type { StateStore } from '../state';\n\nexport interface DatabaseStateStoreOptions {\n  /** Placeholder for connection string / client injection. */\n  connection?: unknown;\n}\n\n/**\n * Placeholder factory to guide future database adapters (PostgreSQL, MongoDB, etc.).\n * Consumers should provide their own implementation that satisfies {@link StateStore}.\n */\nexport function createDatabaseStateStore(\n  _options: DatabaseStateStoreOptions\n): StateStore {\n  throw new Error(\n    'Database state store adapter not implemented. Provide a custom adapter that satisfies StateStore.'\n  );\n}\n\n"],"mappings":"AAWA,SAAgB,EACd,EACY,CACZ,MAAU,MACR,oGACD"}

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

@@ -0,0 +1,15 @@
+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 };
+//# sourceMappingURL=file-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-adapter.d.ts","names":[],"sources":["../../../src/workflow/adapters/file-adapter.ts"],"sourcesContent":[],"mappings":";;;UAEiB,qBAAA;;EAAA,QAAA,EAAA,MAAA;AASjB;;;;;iBAAgB,oBAAA,WACJ,wBACT"}

package/dist/workflow/adapters/file-adapter.js

@@ -0,0 +1,2 @@
+function e(e){throw Error(`File-backed state store adapter not implemented. Provide a custom adapter that satisfies StateStore.`)}export{e as createFileStateStore};
+//# sourceMappingURL=file-adapter.js.map

package/dist/workflow/adapters/file-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-adapter.js","names":[],"sources":["../../../src/workflow/adapters/file-adapter.ts"],"sourcesContent":["import type { StateStore } from '../state';\n\nexport interface FileStateStoreOptions {\n  /** Absolute or relative path to the persistence file. */\n  filePath: string;\n}\n\n/**\n * Placeholder for a file-backed state store adapter.\n * Implementations should manage locking/concurrency and JSON serialization.\n */\nexport function createFileStateStore(\n  _options: FileStateStoreOptions\n): StateStore {\n  throw new Error(\n    'File-backed state store adapter not implemented. Provide a custom adapter that satisfies StateStore.'\n  );\n}\n\n"],"mappings":"AAWA,SAAgB,EACd,EACY,CACZ,MAAU,MACR,uGACD"}

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

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

package/dist/workflow/adapters/index.js

@@ -0,0 +1 @@
+import{InMemoryStateStore as e}from"./memory-store.js";import{createDatabaseStateStore as t}from"./db-adapter.js";import{createFileStateStore as n}from"./file-adapter.js";export{e as InMemoryStateStore,t as createDatabaseStateStore,n as createFileStateStore};

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

@@ -0,0 +1,19 @@
+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 };
+//# sourceMappingURL=memory-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","names":[],"sources":["../../../src/workflow/adapters/memory-store.ts"],"sourcesContent":[],"mappings":";;;;;;AA4BA;;AAGsC,cAHzB,kBAAA,YAA8B,UAGL,CAAA;EAMG,iBAAA,KAAA;EAAR,MAAA,CAAA,KAAA,EANX,aAMW,CAAA,EANK,OAML,CAAA,IAAA,CAAA;EAOV,GAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAPU,OAOV,CAPkB,aAOlB,GAAA,SAAA,CAAA;EAAkB,MAAA,CAAA,UAAA,EAAA,MAAA,EAAA,OAAA,EAAA,CAAA,OAAA,EAAlB,aAAkB,EAAA,GAAA,aAAA,CAAA,EACpC,OADoC,CAC5B,aAD4B,CAAA;EAC5B,IAAA,CAAA,OAAA,CAAA,EASU,oBATV,CAAA,EASiC,OATjC,CASyC,aATzC,EAAA,CAAA;EAAR,KAAA,CAAA,CAAA,EAAA,IAAA"}

package/dist/workflow/adapters/memory-store.js

@@ -0,0 +1,2 @@
+function e(e){return{...e,data:n(e.data),history:e.history.map(e=>({...e,input:n(e.input),output:n(e.output),startedAt:new Date(e.startedAt),completedAt:e.completedAt?new Date(e.completedAt):void 0})),createdAt:new Date(e.createdAt),updatedAt:new Date(e.updatedAt)}}var t=class{items=new Map;async create(t){if(this.items.has(t.workflowId))throw Error(`Workflow state already exists: ${t.workflowId}`);this.items.set(t.workflowId,e(t))}async get(t){let n=this.items.get(t);return n?e(n):void 0}async update(t,n){let r=this.items.get(t);if(!r)throw Error(`Workflow state not found for ${t}`);let i=e(n(e(r)));return this.items.set(t,i),e(i)}async list(t){let n=[...this.items.values()];return(t?.status?n.filter(e=>e.status===t.status):n).map(e)}clear(){this.items.clear()}};function n(e){if(e instanceof Date)return new Date(e.getTime());if(Array.isArray(e))return e.map(e=>n(e));if(e&&typeof e==`object`){let t={};for(let[r,i]of Object.entries(e))t[r]=n(i);return t}return e}export{t as InMemoryStateStore};
+//# sourceMappingURL=memory-store.js.map

package/dist/workflow/adapters/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","names":["result: Record<string, unknown>"],"sources":["../../../src/workflow/adapters/memory-store.ts"],"sourcesContent":["import type {\n  StateStore,\n  WorkflowState,\n  WorkflowStateFilters,\n} from '../state';\n\nfunction cloneState(state: WorkflowState): WorkflowState {\n  return {\n    ...state,\n    data: deepCopy(state.data),\n    history: state.history.map((execution) => ({\n      ...execution,\n      input: deepCopy(execution.input),\n      output: deepCopy(execution.output),\n      startedAt: new Date(execution.startedAt),\n      completedAt: execution.completedAt\n        ? new Date(execution.completedAt)\n        : undefined,\n    })),\n    createdAt: new Date(state.createdAt),\n    updatedAt: new Date(state.updatedAt),\n  };\n}\n\n/**\n * Naive in-memory state store. Suitable for tests and single-node development\n * environments. Swap with a database-backed adapter in production.\n */\nexport class InMemoryStateStore implements StateStore {\n  private readonly items = new Map<string, WorkflowState>();\n\n  async create(state: WorkflowState): Promise<void> {\n    if (this.items.has(state.workflowId))\n      throw new Error(`Workflow state already exists: ${state.workflowId}`);\n    this.items.set(state.workflowId, cloneState(state));\n  }\n\n  async get(workflowId: string): Promise<WorkflowState | undefined> {\n    const state = this.items.get(workflowId);\n    return state ? cloneState(state) : undefined;\n  }\n\n  async update(\n    workflowId: string,\n    updater: (current: WorkflowState) => WorkflowState\n  ): Promise<WorkflowState> {\n    const current = this.items.get(workflowId);\n    if (!current)\n      throw new Error(`Workflow state not found for ${workflowId}`);\n    const next = cloneState(updater(cloneState(current)));\n    this.items.set(workflowId, next);\n    return cloneState(next);\n  }\n\n  async list(filters?: WorkflowStateFilters): Promise<WorkflowState[]> {\n    const all = [...this.items.values()];\n    const filtered = filters?.status\n      ? all.filter((state) => state.status === filters.status)\n      : all;\n    return filtered.map(cloneState);\n  }\n\n  clear() {\n    this.items.clear();\n  }\n}\n\nfunction deepCopy<T>(value: T): T {\n  if (value instanceof Date) return new Date(value.getTime()) as T;\n  if (Array.isArray(value)) return value.map((item) => deepCopy(item)) as T;\n  if (value && typeof value === 'object') {\n    const result: Record<string, unknown> = {};\n    for (const [key, val] of Object.entries(value as Record<string, unknown>)) {\n      result[key] = deepCopy(val);\n    }\n    return result as T;\n  }\n  return value;\n}\n\n"],"mappings":"AAMA,SAAS,EAAW,EAAqC,CACvD,MAAO,CACL,GAAG,EACH,KAAM,EAAS,EAAM,KAAK,CAC1B,QAAS,EAAM,QAAQ,IAAK,IAAe,CACzC,GAAG,EACH,MAAO,EAAS,EAAU,MAAM,CAChC,OAAQ,EAAS,EAAU,OAAO,CAClC,UAAW,IAAI,KAAK,EAAU,UAAU,CACxC,YAAa,EAAU,YACnB,IAAI,KAAK,EAAU,YAAY,CAC/B,IAAA,GACL,EAAE,CACH,UAAW,IAAI,KAAK,EAAM,UAAU,CACpC,UAAW,IAAI,KAAK,EAAM,UAAU,CACrC,CAOH,IAAa,EAAb,KAAsD,CACpD,MAAyB,IAAI,IAE7B,MAAM,OAAO,EAAqC,CAChD,GAAI,KAAK,MAAM,IAAI,EAAM,WAAW,CAClC,MAAU,MAAM,kCAAkC,EAAM,aAAa,CACvE,KAAK,MAAM,IAAI,EAAM,WAAY,EAAW,EAAM,CAAC,CAGrD,MAAM,IAAI,EAAwD,CAChE,IAAM,EAAQ,KAAK,MAAM,IAAI,EAAW,CACxC,OAAO,EAAQ,EAAW,EAAM,CAAG,IAAA,GAGrC,MAAM,OACJ,EACA,EACwB,CACxB,IAAM,EAAU,KAAK,MAAM,IAAI,EAAW,CAC1C,GAAI,CAAC,EACH,MAAU,MAAM,gCAAgC,IAAa,CAC/D,IAAM,EAAO,EAAW,EAAQ,EAAW,EAAQ,CAAC,CAAC,CAErD,OADA,KAAK,MAAM,IAAI,EAAY,EAAK,CACzB,EAAW,EAAK,CAGzB,MAAM,KAAK,EAA0D,CACnE,IAAM,EAAM,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAIpC,OAHiB,GAAS,OACtB,EAAI,OAAQ,GAAU,EAAM,SAAW,EAAQ,OAAO,CACtD,GACY,IAAI,EAAW,CAGjC,OAAQ,CACN,KAAK,MAAM,OAAO,GAItB,SAAS,EAAY,EAAa,CAChC,GAAI,aAAiB,KAAM,OAAO,IAAI,KAAK,EAAM,SAAS,CAAC,CAC3D,GAAI,MAAM,QAAQ,EAAM,CAAE,OAAO,EAAM,IAAK,GAAS,EAAS,EAAK,CAAC,CACpE,GAAI,GAAS,OAAO,GAAU,SAAU,CACtC,IAAMA,EAAkC,EAAE,CAC1C,IAAK,GAAM,CAAC,EAAK,KAAQ,OAAO,QAAQ,EAAiC,CACvE,EAAO,GAAO,EAAS,EAAI,CAE7B,OAAO,EAET,OAAO"}

package/dist/workflow/expression.d.ts

@@ -0,0 +1,10 @@
+//#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 };
+//# sourceMappingURL=expression.d.ts.map

package/dist/workflow/expression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.d.ts","names":[],"sources":["../../src/workflow/expression.ts"],"sourcesContent":[],"mappings":";UAAiB,iBAAA;EAAA,IAAA,EACT,MADS,CAAA,MAAA,EAAiB,OAAA,CAAA;EAMlB,KAAA,CAAA,EAAA,OAAA;;;iBAAA,kBAAA,sCAET"}

package/dist/workflow/expression.js

@@ -0,0 +1,2 @@
+function e(n,r){if(!n)return!0;let i=n.trim();if(!i)return!0;let a=o(i,`||`);if(a.length>1)return a.some(t=>e(t,r));let s=o(i,`&&`);return s.length>1?s.every(t=>e(t,r)):t(i,r)}function t(e,a){let o=e.trim();if(!o)return!0;if(o.startsWith(`!`))return!t(o.slice(1),a);let s=o.match(/^(data|input|output)\.([A-Za-z0-9_.\[\]]+)\s*(===|==|!==|!=|>=|<=|>|<)\s*(.+)$/);if(s){let[,e,t,o,c]=s;return n(i(e,a,t),r(c),o)}let c=o.match(/^(data|input|output)\.([A-Za-z0-9_.\[\]]+)$/);if(c){let[,e,t]=c;return!!i(e,a,t)}return!!r(o)}function n(e,t,n){switch(n){case`===`:case`==`:return e===t;case`!==`:case`!=`:return e!==t;case`>`:return Number(e)>Number(t);case`>=`:return Number(e)>=Number(t);case`<`:return Number(e)<Number(t);case`<=`:return Number(e)<=Number(t);default:return!1}}function r(e){let t=(e??``).trim();if(t.startsWith(`"`)&&t.endsWith(`"`)||t.startsWith(`'`)&&t.endsWith(`'`))return t.slice(1,-1);if(/^-?\d+(\.\d+)?$/.test(t))return Number(t);if(/^true$/i.test(t))return!0;if(/^false$/i.test(t))return!1;if(/^null$/i.test(t))return null;if(!/^undefined$/i.test(t))return t}function i(e,t,n){return a(e===`data`?t.data:e===`input`?t.input:t.output,n)}function a(e,t){if(e==null)return;if(!t)return e;let n=t.replace(/\[(\d+)\]/g,`.$1`).split(`.`).filter(Boolean),r=e;for(let e of n){if(r==null)return;r=r[e]}return r}function o(e,t){let n=[],r=``,i=!1,a=!1;for(let o=0;o<e.length;o++){let s=e[o],c=e.slice(o,o+t.length);if(s===`'`&&!a){i=!i,r+=s;continue}if(s===`"`&&!i){a=!a,r+=s;continue}if(!i&&!a&&c===t){n.push(r.trim()),r=``,o+=t.length-1;continue}r+=s}return r.trim().length&&n.push(r.trim()),n}export{e as evaluateExpression};
+//# sourceMappingURL=expression.js.map

package/dist/workflow/expression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression.js","names":["current: any","parts: string[]"],"sources":["../../src/workflow/expression.ts"],"sourcesContent":["export interface ExpressionContext {\n  data: Record<string, unknown>;\n  input?: unknown;\n  output?: unknown;\n}\n\nexport function evaluateExpression(\n  expression: string | undefined,\n  ctx: ExpressionContext\n): boolean {\n  if (!expression) return true;\n  const trimmed = expression.trim();\n  if (!trimmed) return true;\n\n  const orParts = splitByOperator(trimmed, '||');\n  if (orParts.length > 1) return orParts.some((part) => evaluateExpression(part, ctx));\n\n  const andParts = splitByOperator(trimmed, '&&');\n  if (andParts.length > 1) return andParts.every((part) => evaluateExpression(part, ctx));\n\n  return evaluateSingle(trimmed, ctx);\n}\n\nfunction evaluateSingle(expr: string, ctx: ExpressionContext): boolean {\n  const trimmed = expr.trim();\n  if (!trimmed) return true;\n  if (trimmed.startsWith('!')) return !evaluateSingle(trimmed.slice(1), ctx);\n\n  const comparisonMatch = trimmed.match(\n    /^(data|input|output)\\.([A-Za-z0-9_.\\[\\]]+)\\s*(===|==|!==|!=|>=|<=|>|<)\\s*(.+)$/\n  );\n  if (comparisonMatch) {\n    const [, root, path, operator, rawRight] = comparisonMatch as [\n      string,\n      string,\n      string,\n      ComparisonOperator,\n      string\n    ];\n    const left = resolveRoot(root, ctx, path);\n    const right = parseLiteral(rawRight);\n    return compare(left, right, operator);\n  }\n\n  const truthyMatch = trimmed.match(/^(data|input|output)\\.([A-Za-z0-9_.\\[\\]]+)$/);\n  if (truthyMatch) {\n    const [, root, path] = truthyMatch as [string, string, string];\n    const value = resolveRoot(root, ctx, path);\n    return Boolean(value);\n  }\n\n  const literal = parseLiteral(trimmed);\n  return Boolean(literal);\n}\n\ntype ComparisonOperator = '===' | '==' | '!==' | '!=' | '>=' | '<=' | '>' | '<';\n\nfunction compare(\n  left: unknown,\n  right: unknown,\n  operator: ComparisonOperator\n): boolean {\n  switch (operator) {\n    case '===':\n    case '==':\n      return left === right;\n    case '!==':\n    case '!=':\n      return left !== right;\n    case '>':\n      return Number(left) > Number(right);\n    case '>=':\n      return Number(left) >= Number(right);\n    case '<':\n      return Number(left) < Number(right);\n    case '<=':\n      return Number(left) <= Number(right);\n    default:\n      return false;\n  }\n}\n\nfunction parseLiteral(value: string): unknown {\n  const trimmed = (value ?? '').trim();\n  if (\n    (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n    (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n  )\n    return trimmed.slice(1, -1);\n  if (/^-?\\d+(\\.\\d+)?$/.test(trimmed)) return Number(trimmed);\n  if (/^true$/i.test(trimmed)) return true;\n  if (/^false$/i.test(trimmed)) return false;\n  if (/^null$/i.test(trimmed)) return null;\n  if (/^undefined$/i.test(trimmed)) return undefined;\n  return trimmed;\n}\n\nfunction resolveRoot(\n  root: string,\n  ctx: ExpressionContext,\n  path: string\n): unknown {\n  const source =\n    root === 'data'\n      ? ctx.data\n      : root === 'input'\n        ? ctx.input\n        : ctx.output;\n  return resolvePath(source, path);\n}\n\nfunction resolvePath(source: unknown, path: string): unknown {\n  if (source == null) return undefined;\n  if (!path) return source;\n  const segments = path\n    .replace(/\\[(\\d+)\\]/g, '.$1')\n    .split('.')\n    .filter(Boolean);\n\n  let current: any = source;\n  for (const segment of segments) {\n    if (current == null) return undefined;\n    current = current[segment as keyof typeof current];\n  }\n  return current;\n}\n\nfunction splitByOperator(expr: string, operator: '&&' | '||'): string[] {\n  const parts: string[] = [];\n  let buffer = '';\n  let inSingleQuote = false;\n  let inDoubleQuote = false;\n\n  for (let i = 0; i < expr.length; i++) {\n    const char = expr[i]!;\n    const next = expr.slice(i, i + operator.length);\n\n    if (char === \"'\" && !inDoubleQuote) {\n      inSingleQuote = !inSingleQuote;\n      buffer += char;\n      continue;\n    }\n    if (char === '\"' && !inSingleQuote) {\n      inDoubleQuote = !inDoubleQuote;\n      buffer += char;\n      continue;\n    }\n\n    if (!inSingleQuote && !inDoubleQuote && next === operator) {\n      parts.push(buffer.trim());\n      buffer = '';\n      i += operator.length - 1;\n      continue;\n    }\n\n    buffer += char;\n  }\n\n  if (buffer.trim().length) parts.push(buffer.trim());\n  return parts;\n}\n\n"],"mappings":"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"}

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 { DatabaseStateStoreOptions, createDatabaseStateStore } from "./adapters/db-adapter.js";
+import { FileStateStoreOptions, createFileStateStore } from "./adapters/file-adapter.js";
+import "./adapters/index.js";
+export { CompensationStep, CompensationStrategy, DatabaseStateStoreOptions, ExpressionContext, FileStateStoreOptions, FormRef, GuardCondition, GuardConditionKind, GuardContext, GuardEvaluator, InMemoryStateStore, OperationExecutor, OperationExecutorContext, 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, createDatabaseStateStore, createFileStateStore, evaluateExpression, validateWorkflowSpec };

package/dist/workflow/index.js

@@ -0,0 +1 @@
+import{WorkflowRegistry as e}from"./spec.js";import{WorkflowValidationError as t,assertWorkflowSpecValid as n,validateWorkflowSpec as r}from"./validation.js";import{evaluateExpression as i}from"./expression.js";import{WorkflowPreFlightError as a,WorkflowRunner as o}from"./runner.js";import{InMemoryStateStore as s}from"./adapters/memory-store.js";import{createDatabaseStateStore as c}from"./adapters/db-adapter.js";import{createFileStateStore as l}from"./adapters/file-adapter.js";export{s as InMemoryStateStore,a as WorkflowPreFlightError,e as WorkflowRegistry,o as WorkflowRunner,t as WorkflowValidationError,n as assertWorkflowSpecValid,c as createDatabaseStateStore,l as createFileStateStore,i as evaluateExpression,r as validateWorkflowSpec};

package/dist/workflow/runner.d.ts

@@ -0,0 +1,74 @@
+import { ResolvedBranding } from "../app-config/branding.js";
+import { OpRef } from "../features.js";
+import { GuardCondition, Step, WorkflowRegistry } from "./spec.js";
+import { ResolvedAppConfig, ResolvedIntegration, ResolvedKnowledge, ResolvedTranslation } from "../app-config/runtime.js";
+import { SecretProvider } from "../integrations/secrets/provider.js";
+import { TranslationResolver } from "../types.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>;
+  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 };
+//# sourceMappingURL=runner.d.ts.map

package/dist/workflow/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","names":[],"sources":["../../src/workflow/runner.ts"],"sourcesContent":[],"mappings":";;;;;;;;;UAqBiB,wBAAA;YACL;EADK,IAAA,EAET,IAFS;EACL,iBAAA,CAAA,EAEU,iBAFV;EACJ,YAAA,CAAA,EAES,mBAFT,EAAA;EACc,SAAA,CAAA,EAER,iBAFQ,EAAA;EACL,QAAA,CAAA,EAEJ,gBAFI;EACH,WAAA,CAAA,EAEE,mBAFF;EACD,mBAAA,CAAA,EAEW,mBAFX;EACG,cAAA,CAAA,EAEG,cAFH;;AAEG,KAGP,iBAAA,GAHO,CAAA,EAAA,EAIb,KAJa,EAAA,KAAA,EAAA,OAAA,EAAA,OAAA,EAMR,wBANQ,EAAA,GAOd,OAPc,CAAA,OAAA,CAAA;AAAc,KASrB,0BAAA,GATqB,aAAA,GAAA,YAAA;AAGrB,KAQA,8BAAA,GARiB,OAAA,GAAA,SAAA;AACvB,UASW,sBAAA,CATX;EAEK,MAAA,EAAA,MAAA;EACN,IAAA,EAQG,0BARH;EAAO,UAAA,EAAA,MAAA;EAEA,QAAA,EAQA,8BAR0B;EAE1B,MAAA,EAAA,MAAA;AAEZ;AAQiB,UAAA,uBAAA,CAAuB;EAKvB,QAAA,EAAA,OAAY;EAMjB,MAAA,EATF,sBASgB,EAAA;;AAEf,UARM,YAAA,CAQN;EACN,QAAA,EARO,aAQP;EAAO,IAAA,EAPJ,IAOI;EAEK,KAAA,CAAA,EAAA,OAAA;;AAEH,KAPF,cAAA,GAOE,CAAA,KAAA,EANL,cAMK,EAAA,OAAA,EALH,YAKG,EAAA,GAJT,OAIS,CAAA,OAAA,CAAA,GAAA,OAAA;AACA,UAHG,oBAAA,CAGH;EACK,QAAA,EAHP,gBAGO;EACuB,UAAA,EAH5B,UAG4B;EAE/B,UAAA,EAJG,iBAIH;EACJ,cAAA,CAAA,EAJY,cAIZ;EAAwC,YAAA,CAAA,EAAA,CAAA,KAAA,EAAA,MAAA,EAAA,OAAA,EAHL,MAGK,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,IAAA;EAAR,iBAAA,CAAA,EAAA,CAAA,KAAA,EAD5B,aAC4B,EAAA,GAAhC,iBAAgC,GAAA,SAAA,GAAA,OAAA,CAAQ,iBAAR,GAAA,SAAA,CAAA;EAExB,mBAAA,CAAA,EAAA,CAAA,SAAA,EAAA,KAAA,EAAA,OAAA,EACF,wBADE,EAAA,GAAA,IAAA,GAED,OAFC,CAAA,IAAA,CAAA;EACF,cAAA,CAAA,EAEM,cAFN;EACC,mBAAA,CAAA,EAEU,mBAFV;;AAEU,cAGX,cAAA,CAHW;EAAmB,iBAAA,MAAA;EAG9B,WAAA,CAAA,MAAc,EACY,oBADZ;EACY,cAAA,CAAA,YAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,cAAA,CAAA,EAKlB,iBALkB,CAAA,EAMlC,OANkC,CAM1B,uBAN0B,CAAA;EAKlB,KAAA,CAAA,YAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAAA,MAAA,EAAA,WAAA,CAAA,EASH,MATG,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,EAUhB,OAVgB,CAAA,MAAA,CAAA;EACR,WAAA,CAAA,UAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,OAAA,CAAA,EAiD6C,OAjD7C,CAAA,IAAA,CAAA;EAAR,QAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAwIiC,OAxIjC,CAwIyC,aAxIzC,CAAA;EAQa,MAAA,CAAA,UAAA,EAAA,MAAA,CAAA,EAoIkB,OApIlB,CAAA,IAAA,CAAA;EACb,QAAA,gBAAA;EAwCqD,QAAA,aAAA;EAuFZ,QAAA,aAAA;EAAR,QAAA,cAAA;EAIF,QAAA,OAAA;EAAO,QAAA,eAAA;EAmO9B,QAAA,IAAA;;AACyB,cADzB,sBAAA,SAA+B,KAAA,CACN;EADM,SAAA,MAAA,EACN,sBADM,EAAA;EAAK,WAAA,CAAA,MAAA,EACX,sBADW,EAAA"}

package/dist/workflow/runner.js

@@ -0,0 +1,2 @@
+import{evaluateExpression as e}from"./expression.js";import{randomUUID as t}from"node:crypto";var n=class{constructor(e){this.config=e}async preFlightCheck(e,t,n){let r=this.getSpec(e,t);return this.performPreFlight(r,n)}async start(e,n,i){let a=this.getSpec(e,n),o=r(a),s=new Date,l=t(),u={workflowId:l,workflowName:a.meta.name,workflowVersion:a.meta.version,currentStep:o,data:{...i??{}},history:[],status:`running`,createdAt:s,updatedAt:s},d=this.config.appConfigProvider?await this.config.appConfigProvider(u):void 0,f=await this.performPreFlight(a,d);if(!f.canStart)throw new c(f.issues);return await this.config.stateStore.create(u),this.emit(`workflow.started`,{workflowId:l,workflowName:a.meta.name,workflowVersion:a.meta.version,currentStep:o}),l}async executeStep(e,t){let n=await this.getStateOrThrow(e);if(s(n.status))throw Error(`Workflow ${e} is in terminal status "${n.status}".`);let r=this.getSpec(n.workflowName,n.workflowVersion),c=i(r,n.currentStep);if(!await this.evaluateGuard(c,n,t))throw Error(`GuardRejected: ${n.workflowName} -> ${c.id}`);let l={stepId:c.id,startedAt:new Date,status:`running`,input:t},u={...n,data:{...n.data},history:[...n.history]};try{let i=await this.runStepAction(c,u,t);l.output=i,l.status=`completed`,l.completedAt=new Date,u.history.push(l),u.updatedAt=new Date,o(t)&&(u.data={...u.data,...t}),o(i)&&(u.data={...u.data,...i});let s=this.pickNextStepId(r,u,c,t,i);if(s)u.currentStep=s,u.status=`running`;else if(!a(r,c.id))u.status=`completed`;else throw Error(`No transition matched after executing step "${c.id}".`);await this.config.stateStore.update(e,()=>u),this.emit(`workflow.step_completed`,{workflowId:e,workflowName:n.workflowName,stepId:c.id,status:u.status})}catch(t){throw l.status=`failed`,l.completedAt=new Date,l.error=t instanceof Error?t.message:String(t),u.history.push(l),u.status=`failed`,u.updatedAt=new Date,await this.config.stateStore.update(e,()=>u),this.emit(`workflow.step_failed`,{workflowId:e,workflowName:n.workflowName,stepId:c.id,error:l.error??`unknown`}),t}}async getState(e){return this.getStateOrThrow(e)}async cancel(e){let t=await this.getStateOrThrow(e);if(t.status===`cancelled`)return;let n={...t,status:`cancelled`,updatedAt:new Date};await this.config.stateStore.update(e,()=>n),this.emit(`workflow.cancelled`,{workflowId:e,workflowName:t.workflowName})}async performPreFlight(e,t){if(!t)return{canStart:!0,issues:[]};let n=[],r=new Map;for(let e of t.integrations)r.set(e.slot.slotId,e);for(let t of e.definition.steps)for(let e of t.requiredIntegrations??[]){let i=r.get(e);if(!i){n.push({stepId:t.id,type:`integration`,identifier:e,severity:`error`,reason:`Integration slot "${e}" is not bound in the resolved app config.`});continue}let a=i.connection.status;a===`disconnected`||a===`error`?n.push({stepId:t.id,type:`integration`,identifier:e,severity:`error`,reason:`Integration slot "${e}" is in status "${a}".`}):a===`unknown`&&n.push({stepId:t.id,type:`integration`,identifier:e,severity:`warning`,reason:`Integration slot "${e}" reports unknown health status.`})}let i=new Set(t.capabilities.enabled.map(l));for(let t of e.definition.steps)for(let e of t.requiredCapabilities??[])i.has(l(e))||n.push({stepId:t.id,type:`capability`,identifier:l(e),severity:`error`,reason:`Capability "${e.key}@${e.version}" is not enabled.`});return{canStart:n.every(e=>e.severity!==`error`),issues:n}}async evaluateGuard(t,n,r){return t.guard?this.config.guardEvaluator?this.config.guardEvaluator(t.guard,{workflow:n,step:t,input:r}):t.guard.type===`expression`?e(t.guard.value,{data:n.data,input:r}):!0:!0}async runStepAction(e,t,n){if(e.type===`automation`){let r=e.action?.operation;if(!r)throw Error(`Automation step "${e.id}" requires an operation.`);let i=this.config.appConfigProvider?await this.config.appConfigProvider(t):void 0,a={workflow:t,step:e,resolvedAppConfig:i,integrations:i?.integrations??[],knowledge:i?.knowledge??[],branding:i?.branding,translation:i?.translation,translationResolver:this.config.translationResolver,secretProvider:this.config.secretProvider};return this.config.enforceCapabilities&&await this.config.enforceCapabilities(r,a),this.config.opExecutor(r,n,a)}return e.type,n}pickNextStepId(t,n,r,i,a){let o=t.definition.transitions.filter(e=>e.from===r.id);for(let r of o)if(e(r.condition,{data:n.data,input:i,output:a})){let e=t.definition.steps.find(e=>e.id===r.to);if(!e)throw Error(`Transition ${r.from} -> ${r.to} points to missing step.`);return e.id}return null}getSpec(e,t){let n=this.config.registry.get(e,t);if(!n)throw Error(`Workflow spec not found for ${e}${t?`.v${t}`:``}`);return n}async getStateOrThrow(e){let t=await this.config.stateStore.get(e);if(!t)throw Error(`Workflow state not found for ${e}`);return t}emit(e,t){this.config.eventEmitter?.(e,t)}};function r(e){let t=e.definition.entryStepId??e.definition.steps[0]?.id??null;if(!t)throw Error(`Workflow ${e.meta.name}.v${e.meta.version} has no entry step.`);return t}function i(e,t){let n=e.definition.steps.find(e=>e.id===t);if(!n)throw Error(`Step "${t}" not found in workflow ${e.meta.name}.v${e.meta.version}.`);return n}function a(e,t){return e.definition.transitions.some(e=>e.from===t)}function o(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function s(e){return e===`completed`||e===`failed`||e===`cancelled`}var c=class extends Error{constructor(e){super(`Workflow pre-flight failed: ${e.filter(e=>e.severity===`error`).map(e=>`${e.type}:${e.identifier}`).join(`, `)}`),this.issues=e,this.name=`WorkflowPreFlightError`}};function l(e){return`${e.key}@${e.version}`}export{c as WorkflowPreFlightError,n as WorkflowRunner};
+//# sourceMappingURL=runner.js.map

package/dist/workflow/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","names":["config: WorkflowRunnerConfig","state: WorkflowState","execution: StepExecution","workingState: WorkflowState","nextState: WorkflowState","issues: WorkflowPreFlightIssue[]","executorContext: OperationExecutorContext"],"sources":["../../src/workflow/runner.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type {\n  GuardCondition,\n  Step,\n  WorkflowRegistry,\n  WorkflowSpec,\n} from './spec';\nimport type { StateStore, WorkflowState, StepExecution } from './state';\nimport { evaluateExpression } from './expression';\nimport type { OpRef } from '../features';\nimport type { CapabilityRef } from '../capabilities';\nimport type {\n  ResolvedAppConfig,\n  ResolvedIntegration,\n  ResolvedKnowledge,\n  ResolvedTranslation,\n} from '../app-config/runtime';\nimport type { ResolvedBranding } from '../app-config/branding';\nimport type { TranslationResolver } from '../types';\nimport type { SecretProvider } from '../integrations/secrets/provider';\n\nexport interface OperationExecutorContext {\n  workflow: WorkflowState;\n  step: Step;\n  resolvedAppConfig?: ResolvedAppConfig;\n  integrations?: ResolvedIntegration[];\n  knowledge?: ResolvedKnowledge[];\n  branding?: ResolvedBranding;\n  translation?: ResolvedTranslation;\n  translationResolver?: TranslationResolver;\n  secretProvider?: SecretProvider;\n}\n\nexport type OperationExecutor = (\n  op: OpRef,\n  input: unknown,\n  context: OperationExecutorContext\n) => Promise<unknown>;\n\nexport type WorkflowPreFlightIssueType = 'integration' | 'capability';\n\nexport type WorkflowPreFlightIssueSeverity = 'error' | 'warning';\n\nexport interface WorkflowPreFlightIssue {\n  stepId: string;\n  type: WorkflowPreFlightIssueType;\n  identifier: string;\n  severity: WorkflowPreFlightIssueSeverity;\n  reason: string;\n}\n\nexport interface WorkflowPreFlightResult {\n  canStart: boolean;\n  issues: WorkflowPreFlightIssue[];\n}\n\nexport interface GuardContext {\n  workflow: WorkflowState;\n  step: Step;\n  input?: unknown;\n}\n\nexport type GuardEvaluator = (\n  guard: GuardCondition,\n  context: GuardContext\n) => Promise<boolean> | boolean;\n\nexport interface WorkflowRunnerConfig {\n  registry: WorkflowRegistry;\n  stateStore: StateStore;\n  opExecutor: OperationExecutor;\n  guardEvaluator?: GuardEvaluator;\n  eventEmitter?: (event: string, payload: Record<string, unknown>) => void;\n  appConfigProvider?: (\n    state: WorkflowState\n  ) => ResolvedAppConfig | undefined | Promise<ResolvedAppConfig | undefined>;\n  enforceCapabilities?: (\n    operation: OpRef,\n    context: OperationExecutorContext\n  ) => void | Promise<void>;\n  secretProvider?: SecretProvider;\n  translationResolver?: TranslationResolver;\n}\n\nexport class WorkflowRunner {\n  constructor(private readonly config: WorkflowRunnerConfig) {}\n\n  async preFlightCheck(\n    workflowName: string,\n    version?: number,\n    resolvedConfig?: ResolvedAppConfig\n  ): Promise<WorkflowPreFlightResult> {\n    const spec = this.getSpec(workflowName, version);\n    return this.performPreFlight(spec, resolvedConfig);\n  }\n\n  async start(\n    workflowName: string,\n    version?: number,\n    initialData?: Record<string, unknown>\n  ): Promise<string> {\n    const spec = this.getSpec(workflowName, version);\n    const entryStepId = resolveEntryStepId(spec);\n    const now = new Date();\n    const workflowId = randomUUID();\n\n    const state: WorkflowState = {\n      workflowId,\n      workflowName: spec.meta.name,\n      workflowVersion: spec.meta.version,\n      currentStep: entryStepId,\n      data: { ...(initialData ?? {}) },\n      history: [],\n      status: 'running',\n      createdAt: now,\n      updatedAt: now,\n    };\n\n    const resolvedAppConfig = this.config.appConfigProvider\n      ? await this.config.appConfigProvider(state)\n      : undefined;\n\n    const preFlightResult = await this.performPreFlight(\n      spec,\n      resolvedAppConfig\n    );\n    if (!preFlightResult.canStart) {\n      throw new WorkflowPreFlightError(preFlightResult.issues);\n    }\n\n    await this.config.stateStore.create(state);\n    this.emit('workflow.started', {\n      workflowId,\n      workflowName: spec.meta.name,\n      workflowVersion: spec.meta.version,\n      currentStep: entryStepId,\n    });\n    return workflowId;\n  }\n\n  async executeStep(workflowId: string, input?: unknown): Promise<void> {\n    const state = await this.getStateOrThrow(workflowId);\n    if (isTerminalStatus(state.status)) {\n      throw new Error(\n        `Workflow ${workflowId} is in terminal status \"${state.status}\".`\n      );\n    }\n\n    const spec = this.getSpec(state.workflowName, state.workflowVersion);\n    const step = getCurrentStep(spec, state.currentStep);\n    const guardOk = await this.evaluateGuard(step, state, input);\n    if (!guardOk)\n      throw new Error(`GuardRejected: ${state.workflowName} -> ${step.id}`);\n\n    const execution: StepExecution = {\n      stepId: step.id,\n      startedAt: new Date(),\n      status: 'running',\n      input,\n    };\n\n    const workingState: WorkflowState = {\n      ...state,\n      data: { ...state.data },\n      history: [...state.history],\n    };\n\n    try {\n      const output = await this.runStepAction(step, workingState, input);\n      execution.output = output;\n      execution.status = 'completed';\n      execution.completedAt = new Date();\n      workingState.history.push(execution);\n      workingState.updatedAt = new Date();\n\n      if (isRecord(input)) {\n        workingState.data = { ...workingState.data, ...input };\n      }\n      if (isRecord(output)) {\n        workingState.data = { ...workingState.data, ...output };\n      }\n\n      const nextStepId = this.pickNextStepId(\n        spec,\n        workingState,\n        step,\n        input,\n        output\n      );\n\n      if (nextStepId) {\n        workingState.currentStep = nextStepId;\n        workingState.status = 'running';\n      } else if (!hasOutgoing(spec, step.id)) {\n        workingState.status = 'completed';\n      } else {\n        throw new Error(\n          `No transition matched after executing step \"${step.id}\".`\n        );\n      }\n\n      await this.config.stateStore.update(workflowId, () => workingState);\n      this.emit('workflow.step_completed', {\n        workflowId,\n        workflowName: state.workflowName,\n        stepId: step.id,\n        status: workingState.status,\n      });\n    } catch (error) {\n      execution.status = 'failed';\n      execution.completedAt = new Date();\n      execution.error =\n        error instanceof Error ? error.message : String(error);\n      workingState.history.push(execution);\n      workingState.status = 'failed';\n      workingState.updatedAt = new Date();\n      await this.config.stateStore.update(workflowId, () => workingState);\n      this.emit('workflow.step_failed', {\n        workflowId,\n        workflowName: state.workflowName,\n        stepId: step.id,\n        error: execution.error ?? 'unknown',\n      });\n      throw error;\n    }\n  }\n\n  async getState(workflowId: string): Promise<WorkflowState> {\n    return this.getStateOrThrow(workflowId);\n  }\n\n  async cancel(workflowId: string): Promise<void> {\n    const state = await this.getStateOrThrow(workflowId);\n    if (state.status === 'cancelled') return;\n\n    const nextState: WorkflowState = {\n      ...state,\n      status: 'cancelled',\n      updatedAt: new Date(),\n    };\n    await this.config.stateStore.update(workflowId, () => nextState);\n    this.emit('workflow.cancelled', {\n      workflowId,\n      workflowName: state.workflowName,\n    });\n  }\n\n  private async performPreFlight(\n    spec: WorkflowSpec,\n    resolvedConfig?: ResolvedAppConfig\n  ): Promise<WorkflowPreFlightResult> {\n    if (!resolvedConfig) {\n      return { canStart: true, issues: [] };\n    }\n\n    const issues: WorkflowPreFlightIssue[] = [];\n    const integrationBySlot = new Map<string, ResolvedIntegration>();\n    for (const integration of resolvedConfig.integrations) {\n      integrationBySlot.set(integration.slot.slotId, integration);\n    }\n\n    for (const step of spec.definition.steps) {\n      for (const slotId of step.requiredIntegrations ?? []) {\n        const integration = integrationBySlot.get(slotId);\n        if (!integration) {\n          issues.push({\n            stepId: step.id,\n            type: 'integration',\n            identifier: slotId,\n            severity: 'error',\n            reason: `Integration slot \"${slotId}\" is not bound in the resolved app config.`,\n          });\n          continue;\n        }\n        const status = integration.connection.status;\n        if (status === 'disconnected' || status === 'error') {\n          issues.push({\n            stepId: step.id,\n            type: 'integration',\n            identifier: slotId,\n            severity: 'error',\n            reason: `Integration slot \"${slotId}\" is in status \"${status}\".`,\n          });\n        } else if (status === 'unknown') {\n          issues.push({\n            stepId: step.id,\n            type: 'integration',\n            identifier: slotId,\n            severity: 'warning',\n            reason: `Integration slot \"${slotId}\" reports unknown health status.`,\n          });\n        }\n      }\n    }\n\n    const enabledCapabilities = new Set(\n      resolvedConfig.capabilities.enabled.map(capabilityKey)\n    );\n    for (const step of spec.definition.steps) {\n      for (const required of step.requiredCapabilities ?? []) {\n        if (!enabledCapabilities.has(capabilityKey(required))) {\n          issues.push({\n            stepId: step.id,\n            type: 'capability',\n            identifier: capabilityKey(required),\n            severity: 'error',\n            reason: `Capability \"${required.key}@${required.version}\" is not enabled.`,\n          });\n        }\n      }\n    }\n\n    const canStart = issues.every((issue) => issue.severity !== 'error');\n    return { canStart, issues };\n  }\n\n  private async evaluateGuard(\n    step: Step,\n    state: WorkflowState,\n    input: unknown\n  ) {\n    if (!step.guard) return true;\n    if (this.config.guardEvaluator)\n      return this.config.guardEvaluator(step.guard, {\n        workflow: state,\n        step,\n        input,\n      });\n    if (step.guard.type === 'expression') {\n      return evaluateExpression(step.guard.value, {\n        data: state.data,\n        input,\n      });\n    }\n    return true;\n  }\n\n  private async runStepAction(\n    step: Step,\n    state: WorkflowState,\n    input: unknown\n  ): Promise<unknown> {\n    if (step.type === 'automation') {\n      const op = step.action?.operation;\n      if (!op)\n        throw new Error(`Automation step \"${step.id}\" requires an operation.`);\n      const resolvedAppConfig = this.config.appConfigProvider\n        ? await this.config.appConfigProvider(state)\n        : undefined;\n      const executorContext: OperationExecutorContext = {\n        workflow: state,\n        step,\n        resolvedAppConfig,\n        integrations: resolvedAppConfig?.integrations ?? [],\n        knowledge: resolvedAppConfig?.knowledge ?? [],\n        branding: resolvedAppConfig?.branding,\n        translation: resolvedAppConfig?.translation,\n        translationResolver: this.config.translationResolver,\n        secretProvider: this.config.secretProvider,\n      };\n      if (this.config.enforceCapabilities) {\n        await this.config.enforceCapabilities(op, executorContext);\n      }\n      return this.config.opExecutor(op, input, executorContext);\n    }\n\n    if (step.type === 'human') {\n      return input;\n    }\n\n    // decision step\n    return input;\n  }\n\n  private pickNextStepId(\n    spec: WorkflowSpec,\n    state: WorkflowState,\n    step: Step,\n    input: unknown,\n    output: unknown\n  ): string | null {\n    const transitions = spec.definition.transitions.filter(\n      (t) => t.from === step.id\n    );\n    for (const transition of transitions) {\n      if (\n        evaluateExpression(transition.condition, {\n          data: state.data,\n          input,\n          output,\n        })\n      ) {\n        const target = spec.definition.steps.find((s) => s.id === transition.to);\n        if (!target)\n          throw new Error(\n            `Transition ${transition.from} -> ${transition.to} points to missing step.`\n          );\n        return target.id;\n      }\n    }\n    return null;\n  }\n\n  private getSpec(name: string, version?: number): WorkflowSpec {\n    const spec = this.config.registry.get(name, version);\n    if (!spec)\n      throw new Error(\n        `Workflow spec not found for ${name}${version ? `.v${version}` : ''}`\n      );\n    return spec;\n  }\n\n  private async getStateOrThrow(workflowId: string): Promise<WorkflowState> {\n    const state = await this.config.stateStore.get(workflowId);\n    if (!state) throw new Error(`Workflow state not found for ${workflowId}`);\n    return state;\n  }\n\n  private emit(event: string, payload: Record<string, unknown>) {\n    this.config.eventEmitter?.(event, payload);\n  }\n}\n\nfunction resolveEntryStepId(spec: WorkflowSpec): string {\n  const entry =\n    spec.definition.entryStepId ?? spec.definition.steps[0]?.id ?? null;\n  if (!entry)\n    throw new Error(\n      `Workflow ${spec.meta.name}.v${spec.meta.version} has no entry step.`\n    );\n  return entry;\n}\n\nfunction getCurrentStep(spec: WorkflowSpec, stepId: string): Step {\n  const step = spec.definition.steps.find((s) => s.id === stepId);\n  if (!step)\n    throw new Error(\n      `Step \"${stepId}\" not found in workflow ${spec.meta.name}.v${spec.meta.version}.`\n    );\n  return step;\n}\n\nfunction hasOutgoing(spec: WorkflowSpec, stepId: string): boolean {\n  return spec.definition.transitions.some((t) => t.from === stepId);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return (\n    value != null &&\n    typeof value === 'object' &&\n    !Array.isArray(value)\n  );\n}\n\nfunction isTerminalStatus(status: WorkflowState['status']) {\n  return status === 'completed' || status === 'failed' || status === 'cancelled';\n}\n\nexport class WorkflowPreFlightError extends Error {\n  constructor(public readonly issues: WorkflowPreFlightIssue[]) {\n    super(\n      `Workflow pre-flight failed: ${issues\n        .filter((issue) => issue.severity === 'error')\n        .map((issue) => `${issue.type}:${issue.identifier}`)\n        .join(', ')}`\n    );\n    this.name = 'WorkflowPreFlightError';\n  }\n}\n\nfunction capabilityKey(ref: CapabilityRef): string {\n  return `${ref.key}@${ref.version}`;\n}\n\n"],"mappings":"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"}

package/dist/workflow/spec.d.ts

@@ -0,0 +1,100 @@
+import { OwnerShipMeta } from "../ownership.js";
+import { CapabilityRef } from "../capabilities.js";
+import { ExperimentRef } from "../experiments/spec.js";
+import { OpRef } from "../features.js";
+
+//#region src/workflow/spec.d.ts
+
+/**
+ * Reference to a form spec declared in {@link FormRegistry}.
+ */
+interface FormRef {
+  key: string;
+  version: number;
+}
+type StepType = 'human' | 'automation' | 'decision';
+type WorkflowStatus = 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+type GuardConditionKind = 'policy' | 'expression';
+interface GuardCondition {
+  type: GuardConditionKind;
+  /** Policy name or expression string depending on the type. */
+  value: string;
+}
+interface RetryPolicy {
+  maxAttempts: number;
+  backoff: 'linear' | 'exponential';
+  delayMs: number;
+  /** Optional max delay cap for exponential backoff. */
+  maxDelayMs?: number;
+}
+interface StepAction {
+  /** Operation executed for automation steps. */
+  operation?: OpRef;
+  /** Form rendered for human input steps. */
+  form?: FormRef;
+}
+interface Step {
+  id: string;
+  type: StepType;
+  label: string;
+  description?: string;
+  action?: StepAction;
+  guard?: GuardCondition;
+  timeoutMs?: number;
+  retry?: RetryPolicy;
+  /** Integration slot identifiers required before this step can execute. */
+  requiredIntegrations?: string[];
+  /** Capabilities that must be enabled for this step to execute. */
+  requiredCapabilities?: CapabilityRef[];
+}
+interface Transition {
+  from: string;
+  to: string;
+  label?: string;
+  /** Expression evaluated against workflow data (e.g., `data.approved === true`). */
+  condition?: string;
+}
+interface SLA {
+  totalDurationMs?: number;
+  stepDurationMs?: Record<string, number>;
+}
+interface CompensationStep {
+  stepId: string;
+  operation: OpRef;
+  description?: string;
+}
+interface CompensationStrategy {
+  trigger?: 'on_failure' | 'manual';
+  steps: CompensationStep[];
+}
+interface WorkflowDefinition {
+  steps: Step[];
+  transitions: Transition[];
+  /** Optional explicit entry step. Defaults to the first step when omitted. */
+  entryStepId?: string;
+  sla?: SLA;
+  compensation?: CompensationStrategy;
+}
+interface WorkflowMeta extends OwnerShipMeta {
+  /** Fully-qualified workflow name (e.g., `sigil.onboarding.basic`). */
+  name: string;
+  /** Version of the workflow. Increment on breaking changes. */
+  version: number;
+}
+interface WorkflowSpec {
+  meta: WorkflowMeta;
+  definition: WorkflowDefinition;
+  policy?: {
+    flags?: string[];
+  };
+  experiments?: ExperimentRef[];
+}
+declare class WorkflowRegistry {
+  private readonly items;
+  register(spec: WorkflowSpec): this;
+  list(): WorkflowSpec[];
+  get(name: string, version?: number): WorkflowSpec | undefined;
+}
+//#endregion
+export { CompensationStep, CompensationStrategy, FormRef, GuardCondition, GuardConditionKind, RetryPolicy, SLA, Step, StepAction, StepType, Transition, WorkflowDefinition, WorkflowMeta, WorkflowRegistry, WorkflowSpec, WorkflowStatus };
+//# sourceMappingURL=spec.d.ts.map

package/dist/workflow/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../src/workflow/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAQA;AAKY,UALK,OAAA,CAKG;EAER,GAAA,EAAA,MAAA;EAOA,OAAA,EAAA,MAAA;AAEZ;AAMiB,KAjBL,QAAA,GAiBgB,OAAA,GAAA,YAAA,GAAA,UAAA;AAQX,KAvBL,cAAA,GAuBe,SAIlB,GAAA,QAAO,GAAA,WAAA,GAAA,QAAA,GAAA,WAAA;AAGC,KAvBL,kBAAA,GAuBS,QAAA,GAAA,YAAA;AAEb,UAvBS,cAAA,CAuBT;EAGG,IAAA,EAzBH,kBAyBG;EACD;EAEA,KAAA,EAAA,MAAA;;AAI4B,UA3BrB,WAAA,CA2BqB;EAGrB,WAAA,EAAU,MAAA;EAQV,OAAG,EAAA,QAAA,GAED,aAAM;EAGR,OAAA,EAAA,MAAA;EAMA;EAKA,UAAA,CAAA,EAAA,MAAA;;AAEF,UAhDE,UAAA,CAgDF;EAGP;EACS,SAAA,CAAA,EAlDH,KAkDG;EAAoB;EAGpB,IAAA,CAAA,EAnDR,OAmDQ;AAOjB;AACQ,UAxDS,IAAA,CAwDT;EACM,EAAA,EAAA,MAAA;EAEE,IAAA,EAzDR,QAyDQ;EAAa,KAAA,EAAA,MAAA;EAOhB,WAAA,CAAA,EAAA,MAAgB;EAGZ,MAAA,CAAA,EAhEN,UAgEM;EAOP,KAAA,CAAA,EAtEA,cAsEA;EAI6B,SAAA,CAAA,EAAA,MAAA;EAAY,KAAA,CAAA,EAxEzC,WAwEyC;;;;yBApE1B;;UAGR,UAAA;;;;;;;UAQA,GAAA;;mBAEE;;UAGF,gBAAA;;aAEJ;;;UAII,oBAAA;;SAER;;UAGQ,kBAAA;SACR;eACM;;;QAGP;iBACS;;UAGA,YAAA,SAAqB;;;;;;UAOrB,YAAA;QACT;cACM;;;;gBAEE;;cAOH,gBAAA;;iBAGI;UAOP;uCAI6B"}