@lssm/lib.contracts 0.0.0-canary-20251120170226

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,GAAA,KAIlB;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,35 @@
+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 };
+//# 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":";;;UAGU,gBAAA;;IAAA,MAAA,EAAA,CAAA,IAAA,EAAgB;MAEW,IAAA,EAAA,GAAA;IACgB,CAAA,EAAA,GADhB,OACgB,CAAA,GAAA,CAAA;IACO,UAAA,EAAA,CAAA,IAAA,EAAA;MACnB,KAAA,EAAA;QAAO,EAAA,EAAA,MAAA;MAInC,CAAA;IAC0B,CAAA,EAAA,GAPc,OAOd,CAAA,GAAA,CAAA;IAEjB,MAAA,EAAA,CAAA,IAAA,EAAA;MAAgB,KAAA,EAAA;QAiBG,EAAA,EAAA,MAAA;MAAR,CAAA;MAuBV,IAAA,EAAA,GAAA;IAAkB,CAAA,EAAA,GAhDmB,OAgDnB,CAAA,GAAA,CAAA;IAC5B,QAAA,EAAA,CAAA,IAAA,EAAA;MAAR,KAAA,CAAA,EAAA,GAAA;IAkCkB,CAAA,EAAA,GAlFkB,OAkFlB,CAAA,GAAA,EAAA,CAAA;EAA+B,CAAA;;AA9Eb,cAA5B,gBAAA,YAA4B,UAAA,CAAA;EAAU,iBAAA,MAAA;sBACZ;gBAEjB,gBAAgB;2BAiBL,QAAQ;gDAuBlB,kBAAkB,gBACpC,QAAQ;iBAkCU,uBAAuB,QAAQ"}

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

@@ -0,0 +1,2 @@
+var e=class{constructor(e){this.prisma=e}async create(e){await this.prisma.workflowState.create({data:{id:e.workflowId,name:e.workflowName,version:e.workflowVersion,status:e.status,currentStep:e.currentStep,data:e.data,history:e.history,retryCounts:e.retryCounts??{},createdAt:e.createdAt,updatedAt:e.updatedAt}})}async get(e){let t=await this.prisma.workflowState.findUnique({where:{id:e}});if(t)return{workflowId:t.id,workflowName:t.name,workflowVersion:t.version,currentStep:t.currentStep,data:t.data,history:t.history,retryCounts:t.retryCounts,status:t.status,createdAt:t.createdAt,updatedAt:t.updatedAt}}async update(e,t){let n=await this.get(e);if(!n)throw Error(`Workflow ${e} not found`);let r=t(n),i=await this.prisma.workflowState.update({where:{id:e},data:{status:r.status,currentStep:r.currentStep,data:r.data,history:r.history,retryCounts:r.retryCounts,updatedAt:r.updatedAt}});return{workflowId:i.id,workflowName:i.name,workflowVersion:i.version,currentStep:i.currentStep,data:i.data,history:i.history,retryCounts:i.retryCounts,status:i.status,createdAt:i.createdAt,updatedAt:i.updatedAt}}async list(e){let t={};return e?.status&&(t.status=e.status),(await this.prisma.workflowState.findMany({where:t})).map(e=>({workflowId:e.id,workflowName:e.name,workflowVersion:e.version,currentStep:e.currentStep,data:e.data,history:e.history,retryCounts:e.retryCounts,status:e.status,createdAt:e.createdAt,updatedAt:e.updatedAt}))}};export{e as PrismaStateStore};
+//# sourceMappingURL=db-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"db-adapter.js","names":["prisma: PrismaClientLike","where: any"],"sources":["../../../src/workflow/adapters/db-adapter.ts"],"sourcesContent":["import type { StateStore, WorkflowState, WorkflowStateFilters } from '../state';\n\n// Generic interface for Prisma Client to avoid hard dependency on generated client\ninterface PrismaClientLike {\n  workflowState: {\n    create: (args: { data: any }) => Promise<any>;\n    findUnique: (args: { where: { id: string } }) => Promise<any>;\n    update: (args: { where: { id: string }; data: any }) => Promise<any>;\n    findMany: (args: { where?: any }) => Promise<any[]>;\n  };\n}\n\nexport class PrismaStateStore implements StateStore {\n  constructor(private readonly prisma: PrismaClientLike) {}\n\n  async create(state: WorkflowState): Promise<void> {\n    await this.prisma.workflowState.create({\n      data: {\n        id: state.workflowId,\n        name: state.workflowName,\n        version: state.workflowVersion,\n        status: state.status,\n        currentStep: state.currentStep,\n        data: state.data, // Assumes Prisma handles JSON\n        history: state.history, // Assumes Prisma handles JSON\n        retryCounts: state.retryCounts ?? {},\n        createdAt: state.createdAt,\n        updatedAt: state.updatedAt,\n      },\n    });\n  }\n\n  async get(workflowId: string): Promise<WorkflowState | undefined> {\n    const record = await this.prisma.workflowState.findUnique({\n      where: { id: workflowId },\n    });\n\n    if (!record) return undefined;\n\n    return {\n      workflowId: record.id,\n      workflowName: record.name,\n      workflowVersion: record.version,\n      currentStep: record.currentStep,\n      data: record.data as Record<string, unknown>,\n      history: record.history as any[],\n      retryCounts: record.retryCounts as Record<string, number>,\n      status: record.status as any,\n      createdAt: record.createdAt,\n      updatedAt: record.updatedAt,\n    };\n  }\n\n  async update(\n    workflowId: string,\n    updater: (current: WorkflowState) => WorkflowState\n  ): Promise<WorkflowState> {\n    const current = await this.get(workflowId);\n    if (!current) {\n      throw new Error(`Workflow ${workflowId} not found`);\n    }\n\n    const next = updater(current);\n\n    const updated = await this.prisma.workflowState.update({\n      where: { id: workflowId },\n      data: {\n        status: next.status,\n        currentStep: next.currentStep,\n        data: next.data,\n        history: next.history,\n        retryCounts: next.retryCounts,\n        updatedAt: next.updatedAt,\n      },\n    });\n\n    return {\n      workflowId: updated.id,\n      workflowName: updated.name,\n      workflowVersion: updated.version,\n      currentStep: updated.currentStep,\n      data: updated.data as Record<string, unknown>,\n      history: updated.history as any[],\n      retryCounts: updated.retryCounts as Record<string, number>,\n      status: updated.status as any,\n      createdAt: updated.createdAt,\n      updatedAt: updated.updatedAt,\n    };\n  }\n\n  async list(filters?: WorkflowStateFilters): Promise<WorkflowState[]> {\n    const where: any = {};\n    if (filters?.status) {\n      where.status = filters.status;\n    }\n\n    const records = await this.prisma.workflowState.findMany({\n      where,\n    });\n\n    return records.map((record) => ({\n      workflowId: record.id,\n      workflowName: record.name,\n      workflowVersion: record.version,\n      currentStep: record.currentStep,\n      data: record.data as Record<string, unknown>,\n      history: record.history as any[],\n      retryCounts: record.retryCounts as Record<string, number>,\n      status: record.status as any,\n      createdAt: record.createdAt,\n      updatedAt: record.updatedAt,\n    }));\n  }\n}\n"],"mappings":"AAYA,IAAa,EAAb,KAAoD,CAClD,YAAY,EAA2C,CAA1B,KAAA,OAAA,EAE7B,MAAM,OAAO,EAAqC,CAChD,MAAM,KAAK,OAAO,cAAc,OAAO,CACrC,KAAM,CACJ,GAAI,EAAM,WACV,KAAM,EAAM,aACZ,QAAS,EAAM,gBACf,OAAQ,EAAM,OACd,YAAa,EAAM,YACnB,KAAM,EAAM,KACZ,QAAS,EAAM,QACf,YAAa,EAAM,aAAe,EAAE,CACpC,UAAW,EAAM,UACjB,UAAW,EAAM,UAClB,CACF,CAAC,CAGJ,MAAM,IAAI,EAAwD,CAChE,IAAM,EAAS,MAAM,KAAK,OAAO,cAAc,WAAW,CACxD,MAAO,CAAE,GAAI,EAAY,CAC1B,CAAC,CAEG,KAEL,MAAO,CACL,WAAY,EAAO,GACnB,aAAc,EAAO,KACrB,gBAAiB,EAAO,QACxB,YAAa,EAAO,YACpB,KAAM,EAAO,KACb,QAAS,EAAO,QAChB,YAAa,EAAO,YACpB,OAAQ,EAAO,OACf,UAAW,EAAO,UAClB,UAAW,EAAO,UACnB,CAGH,MAAM,OACJ,EACA,EACwB,CACxB,IAAM,EAAU,MAAM,KAAK,IAAI,EAAW,CAC1C,GAAI,CAAC,EACH,MAAU,MAAM,YAAY,EAAW,YAAY,CAGrD,IAAM,EAAO,EAAQ,EAAQ,CAEvB,EAAU,MAAM,KAAK,OAAO,cAAc,OAAO,CACrD,MAAO,CAAE,GAAI,EAAY,CACzB,KAAM,CACJ,OAAQ,EAAK,OACb,YAAa,EAAK,YAClB,KAAM,EAAK,KACX,QAAS,EAAK,QACd,YAAa,EAAK,YAClB,UAAW,EAAK,UACjB,CACF,CAAC,CAEF,MAAO,CACL,WAAY,EAAQ,GACpB,aAAc,EAAQ,KACtB,gBAAiB,EAAQ,QACzB,YAAa,EAAQ,YACrB,KAAM,EAAQ,KACd,QAAS,EAAQ,QACjB,YAAa,EAAQ,YACrB,OAAQ,EAAQ,OAChB,UAAW,EAAQ,UACnB,UAAW,EAAQ,UACpB,CAGH,MAAM,KAAK,EAA0D,CACnE,IAAMC,EAAa,EAAE,CASrB,OARI,GAAS,SACX,EAAM,OAAS,EAAQ,SAGT,MAAM,KAAK,OAAO,cAAc,SAAS,CACvD,QACD,CAAC,EAEa,IAAK,IAAY,CAC9B,WAAY,EAAO,GACnB,aAAc,EAAO,KACrB,gBAAiB,EAAO,QACxB,YAAa,EAAO,YACpB,KAAM,EAAO,KACb,QAAS,EAAO,QAChB,YAAa,EAAO,YACpB,OAAQ,EAAO,OACf,UAAW,EAAO,UAClB,UAAW,EAAO,UACnB,EAAE"}

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 { PrismaStateStore } from "./db-adapter.js";
+import { FileStateStoreOptions, createFileStateStore } from "./file-adapter.js";
+export { FileStateStoreOptions, InMemoryStateStore, PrismaStateStore, createFileStateStore };

package/dist/workflow/adapters/index.js

@@ -0,0 +1 @@
+import{InMemoryStateStore as e}from"./memory-store.js";import{PrismaStateStore as t}from"./db-adapter.js";import{createFileStateStore as n}from"./file-adapter.js";export{e as InMemoryStateStore,t as PrismaStateStore,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 { 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/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{PrismaStateStore as c}from"./adapters/db-adapter.js";import{createFileStateStore as l}from"./adapters/file-adapter.js";export{s as InMemoryStateStore,c as PrismaStateStore,a as WorkflowPreFlightError,e as WorkflowRegistry,o as WorkflowRunner,t as WorkflowValidationError,n as assertWorkflowSpecValid,l as createFileStateStore,i as evaluateExpression,r as validateWorkflowSpec};

package/dist/workflow/runner.d.ts

@@ -0,0 +1,75 @@
+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>;
+  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 };
+//# 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":"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"}

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??{}},retryCounts:{},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(i){if(l.status=`failed`,l.completedAt=new Date,l.error=i instanceof Error?i.message:String(i),u.history.push(l),u.updatedAt=new Date,c.retry){let r=n.retryCounts?.[c.id]??0;if(r<c.retry.maxAttempts){let i=c.retry.backoff??`exponential`,a=c.retry.delayMs??1e3,o=i===`exponential`?a*2**r:a,s=Math.min(o,c.retry.maxDelayMs??1/0);return u.retryCounts={...n.retryCounts??{},[c.id]:r+1},u.status=`running`,await this.config.stateStore.update(e,()=>u),this.emit(`workflow.step_retrying`,{workflowId:e,workflowName:n.workflowName,stepId:c.id,attempt:r+1,delay:s,error:l.error}),await new Promise(e=>setTimeout(e,s)),this.executeStep(e,t)}}throw u.status=`failed`,await this.config.stateStore.update(e,()=>u),this.emit(`workflow.step_failed`,{workflowId:e,workflowName:n.workflowName,stepId:c.id,error:l.error??`unknown`}),r.definition.compensation?.trigger===`on_failure`&&await this.rollback(e),i}}async rollback(e){let t=await this.getStateOrThrow(e),n=this.getSpec(t.workflowName,t.workflowVersion);if(!n.definition.compensation)return;this.emit(`workflow.rollback_started`,{workflowId:e});let r=t.history.filter(e=>e.status===`completed`).reverse();for(let a of r){let r=n.definition.compensation.steps.find(e=>e.stepId===a.stepId);if(r){let o={stepId:a.stepId,originalInput:a.input,originalOutput:a.output,workflowData:t.data};try{let s=i(n,a.stepId),c=this.config.appConfigProvider?await this.config.appConfigProvider(t):void 0,l={workflow:t,step:s,resolvedAppConfig:c,integrations:c?.integrations??[],knowledge:c?.knowledge??[],branding:c?.branding,translation:c?.translation,translationResolver:this.config.translationResolver,secretProvider:this.config.secretProvider};await this.config.opExecutor(r.operation,o,l),this.emit(`workflow.compensation_step_completed`,{workflowId:e,stepId:a.stepId,compensationOp:r.operation.name})}catch(t){let n=t instanceof Error?t.message:String(t);this.emit(`workflow.compensation_step_failed`,{workflowId:e,stepId:a.stepId,compensationOp:r.operation.name,error:n})}}}this.emit(`workflow.rollback_completed`,{workflowId:e})}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","executorContext: OperationExecutorContext","nextState: WorkflowState","issues: WorkflowPreFlightIssue[]"],"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      retryCounts: {},\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 = error instanceof Error ? error.message : String(error);\n      workingState.history.push(execution);\n      workingState.updatedAt = new Date();\n\n      if (step.retry) {\n        const retries = state.retryCounts?.[step.id] ?? 0;\n        if (retries < step.retry.maxAttempts) {\n          const backoff = step.retry.backoff ?? 'exponential';\n          const baseDelay = step.retry.delayMs ?? 1000;\n          const delay =\n            backoff === 'exponential'\n              ? baseDelay * Math.pow(2, retries)\n              : baseDelay;\n          const cappedDelay = Math.min(\n            delay,\n            step.retry.maxDelayMs ?? Infinity\n          );\n\n          workingState.retryCounts = {\n            ...(state.retryCounts ?? {}),\n            [step.id]: retries + 1,\n          };\n          workingState.status = 'running';\n\n          await this.config.stateStore.update(workflowId, () => workingState);\n          this.emit('workflow.step_retrying', {\n            workflowId,\n            workflowName: state.workflowName,\n            stepId: step.id,\n            attempt: retries + 1,\n            delay: cappedDelay,\n            error: execution.error,\n          });\n\n          await new Promise((resolve) => setTimeout(resolve, cappedDelay));\n          return this.executeStep(workflowId, input);\n        }\n      }\n\n      workingState.status = 'failed';\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\n      // Trigger compensation if configured\n      if (spec.definition.compensation?.trigger === 'on_failure') {\n        await this.rollback(workflowId);\n      }\n\n      throw error;\n    }\n  }\n\n  async rollback(workflowId: string): Promise<void> {\n    const state = await this.getStateOrThrow(workflowId);\n    const spec = this.getSpec(state.workflowName, state.workflowVersion);\n\n    if (!spec.definition.compensation) {\n      return;\n    }\n\n    this.emit('workflow.rollback_started', { workflowId });\n\n    // Filter history for completed automation steps in reverse order\n    const completedSteps = state.history\n      .filter((h) => h.status === 'completed')\n      .reverse();\n\n    for (const execution of completedSteps) {\n      const compStep = spec.definition.compensation.steps.find(\n        (s) => s.stepId === execution.stepId\n      );\n      if (compStep) {\n        const input = {\n          stepId: execution.stepId,\n          originalInput: execution.input,\n          originalOutput: execution.output,\n          workflowData: state.data,\n        };\n\n        try {\n          // Create a context for the compensation step\n          // We use the same state as it provides access to data/history\n          const step = getCurrentStep(spec, execution.stepId);\n          const resolvedAppConfig = this.config.appConfigProvider\n            ? await this.config.appConfigProvider(state)\n            : undefined;\n\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\n          await this.config.opExecutor(\n            compStep.operation,\n            input,\n            executorContext\n          );\n\n          this.emit('workflow.compensation_step_completed', {\n            workflowId,\n            stepId: execution.stepId,\n            compensationOp: compStep.operation.name,\n          });\n        } catch (error) {\n          const errorMessage =\n            error instanceof Error ? error.message : String(error);\n          this.emit('workflow.compensation_step_failed', {\n            workflowId,\n            stepId: execution.stepId,\n            compensationOp: compStep.operation.name,\n            error: errorMessage,\n          });\n          // We continue with other compensations even if one fails (best effort)\n        }\n      }\n    }\n\n    // We don't change status from 'failed' or 'cancelled' usually,\n    // but we might want to mark that rollback was attempted/completed.\n    // For now, just emitting events is enough.\n    this.emit('workflow.rollback_completed', { workflowId });\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(\n          (s) => s.id === transition.to\n        );\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 value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction isTerminalStatus(status: WorkflowState['status']) {\n  return (\n    status === 'completed' || status === 'failed' || status === 'cancelled'\n  );\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"],"mappings":"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"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sla-monitor.d.ts","names":[],"sources":["../../src/workflow/sla-monitor.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,cAAA;;EAAA,YAAA,EAAA,MAAc;EAUlB,IAAA,EAAA,mBAAU,GAAA,eAAA;EAIR,MAAA,CAAA,EAAA,MAAA;EAIA,UAAA,EAAA,MAAA;EAAqB,QAAA,EAAA,MAAA;EAAY,UAAA,EAXlC,IAWkC;;cARnC,UAAA;;qDAIE;eAIA,qBAAqB"}

package/dist/workflow/sla-monitor.js

@@ -0,0 +1,2 @@
+var e=class{constructor(e){this.eventEmitter=e}check(e,t){let n=t.definition.sla;if(!n)return;let r=new Date().getTime();if(n.totalDurationMs){let t=r-e.createdAt.getTime();t>n.totalDurationMs&&(e.status===`running`||e.status===`paused`)&&this.eventEmitter(`workflow.sla_breach`,{workflowId:e.workflowId,workflowName:e.workflowName,type:`workflow_duration`,expectedMs:n.totalDurationMs,actualMs:t,breachedAt:new Date})}if(n.stepDurationMs&&e.status===`running`&&e.currentStep){let t=e.history.find(t=>t.stepId===e.currentStep&&t.status===`running`);if(t){let i=n.stepDurationMs[e.currentStep];if(i){let n=r-t.startedAt.getTime();n>i&&this.eventEmitter(`workflow.sla_breach`,{workflowId:e.workflowId,workflowName:e.workflowName,type:`step_duration`,stepId:e.currentStep,expectedMs:i,actualMs:n,breachedAt:new Date})}}}}};export{e as SLAMonitor};
+//# sourceMappingURL=sla-monitor.js.map

package/dist/workflow/sla-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sla-monitor.js","names":["eventEmitter: (\n      event: string,\n      payload: SLABreachEvent\n    ) => void"],"sources":["../../src/workflow/sla-monitor.ts"],"sourcesContent":["import type { WorkflowState } from './state';\nimport type { WorkflowSpec } from './spec';\n\nexport interface SLABreachEvent {\n  workflowId: string;\n  workflowName: string;\n  type: 'workflow_duration' | 'step_duration';\n  stepId?: string;\n  expectedMs: number;\n  actualMs: number;\n  breachedAt: Date;\n}\n\nexport class SLAMonitor {\n  constructor(\n    private readonly eventEmitter: (\n      event: string,\n      payload: SLABreachEvent\n    ) => void\n  ) {}\n\n  check(state: WorkflowState, spec: WorkflowSpec): void {\n    const sla = spec.definition.sla;\n    if (!sla) return;\n\n    const now = new Date().getTime();\n\n    // Check total workflow duration\n    if (sla.totalDurationMs) {\n      const duration = now - state.createdAt.getTime();\n      if (duration > sla.totalDurationMs) {\n        // Only emit if not already completed/failed/cancelled\n        if (state.status === 'running' || state.status === 'paused') {\n          this.eventEmitter('workflow.sla_breach', {\n            workflowId: state.workflowId,\n            workflowName: state.workflowName,\n            type: 'workflow_duration',\n            expectedMs: sla.totalDurationMs,\n            actualMs: duration,\n            breachedAt: new Date(),\n          });\n        }\n      }\n    }\n\n    // Check step durations\n    if (sla.stepDurationMs) {\n      // Check currently running step\n      if (state.status === 'running' && state.currentStep) {\n        // Find when the current step started\n        // It might be the last entry in history if it's running?\n        // But history usually stores *completed* steps or *failed* attempts.\n        // Runner updates history with status='running' at start of execution?\n        // Let's check runner.ts:\n        //   const execution: StepExecution = { ... status: 'running' ... };\n        //   workingState.history.push(execution);\n        // Yes, it pushes running execution.\n\n        const currentExecution = state.history.find(\n          (h) => h.stepId === state.currentStep && h.status === 'running'\n        );\n\n        if (currentExecution) {\n          const stepLimit = sla.stepDurationMs[state.currentStep];\n          if (stepLimit) {\n            const stepDuration = now - currentExecution.startedAt.getTime();\n            if (stepDuration > stepLimit) {\n              this.eventEmitter('workflow.sla_breach', {\n                workflowId: state.workflowId,\n                workflowName: state.workflowName,\n                type: 'step_duration',\n                stepId: state.currentStep,\n                expectedMs: stepLimit,\n                actualMs: stepDuration,\n                breachedAt: new Date(),\n              });\n            }\n          }\n        }\n      }\n    }\n  }\n}\n"],"mappings":"AAaA,IAAa,EAAb,KAAwB,CACtB,YACE,EAIA,CAJiB,KAAA,aAAA,EAMnB,MAAM,EAAsB,EAA0B,CACpD,IAAM,EAAM,EAAK,WAAW,IAC5B,GAAI,CAAC,EAAK,OAEV,IAAM,EAAM,IAAI,MAAM,CAAC,SAAS,CAGhC,GAAI,EAAI,gBAAiB,CACvB,IAAM,EAAW,EAAM,EAAM,UAAU,SAAS,CAC5C,EAAW,EAAI,kBAEb,EAAM,SAAW,WAAa,EAAM,SAAW,WACjD,KAAK,aAAa,sBAAuB,CACvC,WAAY,EAAM,WAClB,aAAc,EAAM,aACpB,KAAM,oBACN,WAAY,EAAI,gBAChB,SAAU,EACV,WAAY,IAAI,KACjB,CAAC,CAMR,GAAI,EAAI,gBAEF,EAAM,SAAW,WAAa,EAAM,YAAa,CAUnD,IAAM,EAAmB,EAAM,QAAQ,KACpC,GAAM,EAAE,SAAW,EAAM,aAAe,EAAE,SAAW,UACvD,CAED,GAAI,EAAkB,CACpB,IAAM,EAAY,EAAI,eAAe,EAAM,aAC3C,GAAI,EAAW,CACb,IAAM,EAAe,EAAM,EAAiB,UAAU,SAAS,CAC3D,EAAe,GACjB,KAAK,aAAa,sBAAuB,CACvC,WAAY,EAAM,WAClB,aAAc,EAAM,aACpB,KAAM,gBACN,OAAQ,EAAM,YACd,WAAY,EACZ,SAAU,EACV,WAAY,IAAI,KACjB,CAAC"}