@lssm/lib.contracts 1.11.0 → 1.41.0

package/dist/workflow/runner.d.ts

@@ -1,75 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"file":"runner.d.ts","names":[],"sources":["../../src/workflow/runner.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/workflow/runner.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,21 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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.map

@@ -1 +0,0 @@
-{"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"}

package/dist/workflow/spec.d.ts

@@ -1,100 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}

package/dist/workflow/spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec.js","names":["candidate: WorkflowSpec | undefined"],"sources":["../../src/workflow/spec.ts"],"sourcesContent":["import type { CapabilityRef } from '../capabilities';\nimport type { OwnerShipMeta } from '../ownership';\nimport type { OpRef } from '../features';\nimport type { ExperimentRef } from '../experiments/spec';\n\n/**\n * Reference to a form spec declared in {@link FormRegistry}.\n */\nexport interface FormRef {\n  key: string;\n  version: number;\n}\n\nexport type StepType = 'human' | 'automation' | 'decision';\n\nexport type WorkflowStatus =\n  | 'running'\n  | 'paused'\n  | 'completed'\n  | 'failed'\n  | 'cancelled';\n\nexport type GuardConditionKind = 'policy' | 'expression';\n\nexport interface GuardCondition {\n  type: GuardConditionKind;\n  /** Policy name or expression string depending on the type. */\n  value: string;\n}\n\nexport interface RetryPolicy {\n  maxAttempts: number;\n  backoff: 'linear' | 'exponential';\n  delayMs: number;\n  /** Optional max delay cap for exponential backoff. */\n  maxDelayMs?: number;\n}\n\nexport interface StepAction {\n  /** Operation executed for automation steps. */\n  operation?: OpRef;\n  /** Form rendered for human input steps. */\n  form?: FormRef;\n}\n\nexport interface Step {\n  id: string;\n  type: StepType;\n  label: string;\n  description?: string;\n  action?: StepAction;\n  guard?: GuardCondition;\n  timeoutMs?: number;\n  retry?: RetryPolicy;\n  /** Integration slot identifiers required before this step can execute. */\n  requiredIntegrations?: string[];\n  /** Capabilities that must be enabled for this step to execute. */\n  requiredCapabilities?: CapabilityRef[];\n}\n\nexport interface Transition {\n  from: string;\n  to: string;\n  label?: string;\n  /** Expression evaluated against workflow data (e.g., `data.approved === true`). */\n  condition?: string;\n}\n\nexport interface SLA {\n  totalDurationMs?: number;\n  stepDurationMs?: Record<string, number>;\n}\n\nexport interface CompensationStep {\n  stepId: string;\n  operation: OpRef;\n  description?: string;\n}\n\nexport interface CompensationStrategy {\n  trigger?: 'on_failure' | 'manual';\n  steps: CompensationStep[];\n}\n\nexport interface WorkflowDefinition {\n  steps: Step[];\n  transitions: Transition[];\n  /** Optional explicit entry step. Defaults to the first step when omitted. */\n  entryStepId?: string;\n  sla?: SLA;\n  compensation?: CompensationStrategy;\n}\n\nexport interface WorkflowMeta extends OwnerShipMeta {\n  /** Fully-qualified workflow name (e.g., `sigil.onboarding.basic`). */\n  name: string;\n  /** Version of the workflow. Increment on breaking changes. */\n  version: number;\n}\n\nexport interface WorkflowSpec {\n  meta: WorkflowMeta;\n  definition: WorkflowDefinition;\n  policy?: { flags?: string[] };\n  experiments?: ExperimentRef[];\n}\n\nfunction workflowKey(meta: WorkflowMeta) {\n  return `${meta.name}.v${meta.version}`;\n}\n\nexport class WorkflowRegistry {\n  private readonly items = new Map<string, WorkflowSpec>();\n\n  register(spec: WorkflowSpec): this {\n    const key = workflowKey(spec.meta);\n    if (this.items.has(key)) throw new Error(`Duplicate workflow ${key}`);\n    this.items.set(key, spec);\n    return this;\n  }\n\n  list(): WorkflowSpec[] {\n    return [...this.items.values()];\n  }\n\n  get(name: string, version?: number): WorkflowSpec | undefined {\n    if (version != null) return this.items.get(`${name}.v${version}`);\n    let candidate: WorkflowSpec | undefined;\n    let max = -Infinity;\n    for (const spec of this.items.values()) {\n      if (spec.meta.name !== name) continue;\n      if (spec.meta.version > max) {\n        max = spec.meta.version;\n        candidate = spec;\n      }\n    }\n    return candidate;\n  }\n}\n"],"mappings":"AA2GA,SAAS,EAAY,EAAoB,CACvC,MAAO,GAAG,EAAK,KAAK,IAAI,EAAK,UAG/B,IAAa,EAAb,KAA8B,CAC5B,MAAyB,IAAI,IAE7B,SAAS,EAA0B,CACjC,IAAM,EAAM,EAAY,EAAK,KAAK,CAClC,GAAI,KAAK,MAAM,IAAI,EAAI,CAAE,MAAU,MAAM,sBAAsB,IAAM,CAErE,OADA,KAAK,MAAM,IAAI,EAAK,EAAK,CAClB,KAGT,MAAuB,CACrB,MAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC,CAGjC,IAAI,EAAc,EAA4C,CAC5D,GAAI,GAAW,KAAM,OAAO,KAAK,MAAM,IAAI,GAAG,EAAK,IAAI,IAAU,CACjE,IAAIA,EACA,EAAM,KACV,IAAK,IAAM,KAAQ,KAAK,MAAM,QAAQ,CAChC,EAAK,KAAK,OAAS,GACnB,EAAK,KAAK,QAAU,IACtB,EAAM,EAAK,KAAK,QAChB,EAAY,GAGhB,OAAO"}

package/dist/workflow/state.d.ts

@@ -1,36 +0,0 @@
-import { WorkflowStatus } from "./spec.js";
-
-//#region src/workflow/state.d.ts
-interface StepExecution {
-  stepId: string;
-  startedAt: Date;
-  completedAt?: Date;
-  status: 'pending' | 'running' | 'completed' | 'failed';
-  input?: unknown;
-  output?: unknown;
-  error?: string;
-}
-interface WorkflowState {
-  workflowId: string;
-  workflowName: string;
-  workflowVersion: number;
-  currentStep: string;
-  data: Record<string, unknown>;
-  retryCounts?: Record<string, number>;
-  history: StepExecution[];
-  status: WorkflowStatus;
-  createdAt: Date;
-  updatedAt: Date;
-}
-interface WorkflowStateFilters {
-  status?: WorkflowStatus;
-}
-interface StateStore {
-  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 { StateStore, StepExecution, WorkflowState, WorkflowStateFilters };
-//# sourceMappingURL=state.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"state.d.ts","names":[],"sources":["../../src/workflow/state.ts"],"sourcesContent":[],"mappings":";;;UAEiB,aAAA;;EAAA,SAAA,EAEJ,IAFI;EAUA,WAAA,CAAA,EAPD,IAOc;EAKtB,MAAA,EAAA,SAAA,GAAA,SAAA,GAAA,WAAA,GAAA,QAAA;EACQ,KAAA,CAAA,EAAA,OAAA;EACL,MAAA,CAAA,EAAA,OAAA;EACD,KAAA,CAAA,EAAA,MAAA;;AAEG,UAVI,aAAA,CAUJ;EAAI,UAAA,EAAA,MAAA;EAGA,YAAA,EAAA,MAAA;EAIA,eAAU,EAAA,MAAA;EACX,WAAA,EAAA,MAAA;EAAgB,IAAA,EAbxB,MAawB,CAAA,MAAA,EAAA,OAAA,CAAA;EACG,WAAA,CAAA,EAbnB,MAamB,CAAA,MAAA,EAAA,MAAA,CAAA;EAAR,OAAA,EAZhB,aAYgB,EAAA;EAGJ,MAAA,EAdb,cAca;EAAkB,SAAA,EAb5B,IAa4B;EAC5B,SAAA,EAbA,IAaA;;AACI,UAXA,oBAAA,CAWA;EAA+B,MAAA,CAAA,EAVrC,cAUqC;;AAAD,UAP9B,UAAA,CAO8B;gBAN/B,gBAAgB;2BACL,QAAQ;gDAGZ,kBAAkB,gBACpC,QAAQ;iBACI,uBAAuB,QAAQ"}

package/dist/workflow/validation.d.ts

@@ -1,29 +0,0 @@
-import { WorkflowSpec } from "./spec.js";
-import { SpecRegistry } from "../registry.js";
-import { FormRegistry } from "../forms.js";
-
-//#region src/workflow/validation.d.ts
-type WorkflowValidationLevel = 'error' | 'warning';
-interface WorkflowValidationIssue {
-  level: WorkflowValidationLevel;
-  message: string;
-  context?: Record<string, unknown>;
-}
-interface ValidateWorkflowSpecOptions {
-  operations?: SpecRegistry;
-  forms?: FormRegistry;
-}
-declare class WorkflowValidationError extends Error {
-  readonly issues: WorkflowValidationIssue[];
-  constructor(message: string, issues: WorkflowValidationIssue[]);
-}
-/**
- * Validate workflow structure, references, and reachability.
- * Returns the collected issues. Consumers may call {@link assertWorkflowSpecValid}
- * to throw on validation errors.
- */
-declare function validateWorkflowSpec(spec: WorkflowSpec, options?: ValidateWorkflowSpecOptions): WorkflowValidationIssue[];
-declare function assertWorkflowSpecValid(spec: WorkflowSpec, options?: ValidateWorkflowSpecOptions): void;
-//#endregion
-export { ValidateWorkflowSpecOptions, WorkflowValidationError, WorkflowValidationIssue, WorkflowValidationLevel, assertWorkflowSpecValid, validateWorkflowSpec };
-//# sourceMappingURL=validation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","names":[],"sources":["../../src/workflow/validation.ts"],"sourcesContent":[],"mappings":";;;;;KASY,uBAAA;UAEK,uBAAA;EAFL,KAAA,EAGH,uBAH0B;EAElB,OAAA,EAAA,MAAA;EAMA,OAAA,CAAA,EAHL,MAGK,CAAA,MAAA,EAAA,OAA2B,CAAA;AAK5C;AAG4B,UARX,2BAAA,CAQW;EAAA,UAAA,CAAA,EAPb,YAOa;EAHiB,KAAA,CAAA,EAHnC,YAGmC;;AAe7B,cAfH,uBAAA,SAAgC,KAAA,CAeT;EAC5B,SAAA,MAAA,EAboB,uBAapB,EAAA;EACG,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,MAAA,EAdiB,uBAcjB,EAAA;;;AAqCX;;;;iBAvCgB,oBAAA,OACR,wBACG,8BACR;iBAoCa,uBAAA,OACR,wBACG"}

package/dist/workflow/validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","names":["issues: WorkflowValidationIssue[]"],"sources":["../../src/workflow/validation.ts"],"sourcesContent":["import type { FormRegistry } from '../forms';\nimport type { SpecRegistry } from '../registry';\nimport type {\n  Step,\n  Transition,\n  WorkflowDefinition,\n  WorkflowSpec,\n} from './spec';\n\nexport type WorkflowValidationLevel = 'error' | 'warning';\n\nexport interface WorkflowValidationIssue {\n  level: WorkflowValidationLevel;\n  message: string;\n  context?: Record<string, unknown>;\n}\n\nexport interface ValidateWorkflowSpecOptions {\n  operations?: SpecRegistry;\n  forms?: FormRegistry;\n}\n\nexport class WorkflowValidationError extends Error {\n  constructor(\n    message: string,\n    public readonly issues: WorkflowValidationIssue[]\n  ) {\n    super(message);\n    this.name = 'WorkflowValidationError';\n  }\n}\n\n/**\n * Validate workflow structure, references, and reachability.\n * Returns the collected issues. Consumers may call {@link assertWorkflowSpecValid}\n * to throw on validation errors.\n */\nexport function validateWorkflowSpec(\n  spec: WorkflowSpec,\n  options: ValidateWorkflowSpecOptions = {}\n): WorkflowValidationIssue[] {\n  const issues: WorkflowValidationIssue[] = [];\n  const { definition } = spec;\n\n  if (!definition.steps.length) {\n    issues.push({\n      level: 'error',\n      message: 'Workflow must declare at least one step.',\n    });\n    return issues;\n  }\n\n  const stepsById = indexSteps(definition, issues);\n  const entryStepId = definition.entryStepId ?? definition.steps[0]?.id ?? null;\n\n  if (!entryStepId) {\n    issues.push({\n      level: 'error',\n      message: 'Workflow requires an entry step (definition.entryStepId).',\n    });\n  } else if (!stepsById.has(entryStepId)) {\n    issues.push({\n      level: 'error',\n      message: `Entry step \"${entryStepId}\" is not defined in steps.`,\n    });\n  }\n\n  const adjacency = buildAdjacency(definition, stepsById, issues);\n\n  validateStepActions(definition.steps, options, issues);\n  validateReachability(entryStepId, stepsById, adjacency, issues);\n  detectCycles(adjacency, issues);\n\n  return issues;\n}\n\nexport function assertWorkflowSpecValid(\n  spec: WorkflowSpec,\n  options: ValidateWorkflowSpecOptions = {}\n): void {\n  const issues = validateWorkflowSpec(spec, options);\n  const errors = issues.filter((issue) => issue.level === 'error');\n  if (errors.length) {\n    throw new WorkflowValidationError(\n      `Workflow ${spec.meta.name}.v${spec.meta.version} is invalid`,\n      issues\n    );\n  }\n}\n\nfunction indexSteps(\n  definition: WorkflowDefinition,\n  issues: WorkflowValidationIssue[]\n) {\n  const stepsById = new Map<string, Step>();\n  for (const step of definition.steps) {\n    if (stepsById.has(step.id)) {\n      issues.push({\n        level: 'error',\n        message: `Duplicate step id \"${step.id}\" detected.`,\n      });\n      continue;\n    }\n    stepsById.set(step.id, step);\n    if (step.type === 'automation' && !step.action?.operation) {\n      issues.push({\n        level: 'warning',\n        message: `Automation step \"${step.id}\" does not declare an operation.`,\n      });\n    }\n    if (step.type === 'human' && !step.action?.form) {\n      issues.push({\n        level: 'warning',\n        message: `Human step \"${step.id}\" does not declare a form.`,\n      });\n    }\n    if (step.guard && !step.guard.value.trim()) {\n      issues.push({\n        level: 'error',\n        message: `Guard for step \"${step.id}\" must have a non-empty value.`,\n      });\n    }\n  }\n  return stepsById;\n}\n\nfunction buildAdjacency(\n  definition: WorkflowDefinition,\n  stepsById: Map<string, Step>,\n  issues: WorkflowValidationIssue[]\n) {\n  const adjacency = new Map<string, Set<string>>();\n  const incoming = new Map<string, number>();\n\n  for (const stepId of stepsById.keys()) {\n    adjacency.set(stepId, new Set());\n    incoming.set(stepId, 0);\n  }\n\n  for (const transition of definition.transitions) {\n    const from = stepsById.get(transition.from);\n    const to = stepsById.get(transition.to);\n\n    if (!from) {\n      issues.push({\n        level: 'error',\n        message: `Transition refers to unknown \"from\" step \"${transition.from}\".`,\n      });\n      continue;\n    }\n    if (!to) {\n      issues.push({\n        level: 'error',\n        message: `Transition refers to unknown \"to\" step \"${transition.to}\".`,\n      });\n      continue;\n    }\n\n    adjacency.get(transition.from)?.add(transition.to);\n    incoming.set(transition.to, (incoming.get(transition.to) ?? 0) + 1);\n\n    validateTransition(transition, issues);\n  }\n\n  const roots = [...incoming.entries()]\n    .filter(([, count]) => count === 0)\n    .map(([id]) => id);\n  if (roots.length > 1) {\n    issues.push({\n      level: 'warning',\n      message: `Workflow has multiple potential entry steps: ${roots.join(', ')}`,\n    });\n  }\n\n  return adjacency;\n}\n\nfunction validateTransition(\n  transition: Transition,\n  issues: WorkflowValidationIssue[]\n) {\n  if (transition.condition && !transition.condition.trim()) {\n    issues.push({\n      level: 'error',\n      message: `Transition ${transition.from} -> ${transition.to} declares an empty condition.`,\n    });\n  }\n}\n\nfunction validateStepActions(\n  steps: Step[],\n  options: ValidateWorkflowSpecOptions,\n  issues: WorkflowValidationIssue[]\n) {\n  for (const step of steps) {\n    const action = step.action;\n    if (!action) continue;\n    if (action.operation && options.operations) {\n      const op = options.operations.getSpec(\n        action.operation.name,\n        action.operation.version\n      );\n      if (!op) {\n        issues.push({\n          level: 'error',\n          message: `Step \"${step.id}\" references unknown operation ${action.operation.name}.v${action.operation.version}.`,\n        });\n      }\n    }\n    if (action.form && options.forms) {\n      const form = options.forms.get(action.form.key, action.form.version);\n      if (!form) {\n        issues.push({\n          level: 'error',\n          message: `Step \"${step.id}\" references unknown form ${action.form.key}.v${action.form.version}.`,\n        });\n      }\n    }\n  }\n}\n\nfunction validateReachability(\n  entryStepId: string | null,\n  stepsById: Map<string, Step>,\n  adjacency: Map<string, Set<string>>,\n  issues: WorkflowValidationIssue[]\n) {\n  if (!entryStepId || !stepsById.has(entryStepId)) return;\n  const visited = new Set<string>();\n  const queue = [entryStepId];\n  visited.add(entryStepId);\n\n  while (queue.length) {\n    const current = queue.shift()!;\n    const neighbours = adjacency.get(current);\n    if (!neighbours) continue;\n    for (const next of neighbours) {\n      if (visited.has(next)) continue;\n      visited.add(next);\n      queue.push(next);\n    }\n  }\n\n  for (const stepId of stepsById.keys()) {\n    if (!visited.has(stepId)) {\n      issues.push({\n        level: 'error',\n        message: `Step \"${stepId}\" is unreachable from entry step \"${entryStepId}\".`,\n      });\n    }\n  }\n}\n\nfunction detectCycles(\n  adjacency: Map<string, Set<string>>,\n  issues: WorkflowValidationIssue[]\n) {\n  const visited = new Set<string>();\n  const stack = new Set<string>();\n  let cycleReported = false;\n\n  const dfs = (node: string) => {\n    if (stack.has(node)) {\n      if (!cycleReported) {\n        issues.push({\n          level: 'error',\n          message: `Workflow contains a cycle involving step \"${node}\".`,\n        });\n        cycleReported = true;\n      }\n      return;\n    }\n    if (visited.has(node)) return;\n\n    stack.add(node);\n    const neighbours = adjacency.get(node);\n    if (neighbours) {\n      for (const next of neighbours) dfs(next);\n    }\n    stack.delete(node);\n    visited.add(node);\n  };\n\n  for (const node of adjacency.keys()) dfs(node);\n}\n"],"mappings":"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"}