@lssm/lib.contracts 0.0.0-canary-20251219202229 → 0.0.0-canary-20251220002821

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.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,aAAb,MAAwB;CACtB,YACE,AAAiBA,cAIjB;EAJiB;;CAMnB,MAAM,OAAsB,MAA0B;EACpD,MAAM,MAAM,KAAK,WAAW;AAC5B,MAAI,CAAC,IAAK;EAEV,MAAM,uBAAM,IAAI,MAAM,EAAC,SAAS;AAGhC,MAAI,IAAI,iBAAiB;GACvB,MAAM,WAAW,MAAM,MAAM,UAAU,SAAS;AAChD,OAAI,WAAW,IAAI,iBAEjB;QAAI,MAAM,WAAW,aAAa,MAAM,WAAW,SACjD,MAAK,aAAa,uBAAuB;KACvC,YAAY,MAAM;KAClB,cAAc,MAAM;KACpB,MAAM;KACN,YAAY,IAAI;KAChB,UAAU;KACV,4BAAY,IAAI,MAAM;KACvB,CAAC;;;AAMR,MAAI,IAAI,gBAEN;OAAI,MAAM,WAAW,aAAa,MAAM,aAAa;IAUnD,MAAM,mBAAmB,MAAM,QAAQ,MACpC,MAAM,EAAE,WAAW,MAAM,eAAe,EAAE,WAAW,UACvD;AAED,QAAI,kBAAkB;KACpB,MAAM,YAAY,IAAI,eAAe,MAAM;AAC3C,SAAI,WAAW;MACb,MAAM,eAAe,MAAM,iBAAiB,UAAU,SAAS;AAC/D,UAAI,eAAe,UACjB,MAAK,aAAa,uBAAuB;OACvC,YAAY,MAAM;OAClB,cAAc,MAAM;OACpB,MAAM;OACN,QAAQ,MAAM;OACd,YAAY;OACZ,UAAU;OACV,4BAAY,IAAI,MAAM;OACvB,CAAC"}

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,YAAY,MAAoB;AACvC,QAAO,GAAG,KAAK,KAAK,IAAI,KAAK;;AAG/B,IAAa,mBAAb,MAA8B;CAC5B,AAAiB,wBAAQ,IAAI,KAA2B;CAExD,SAAS,MAA0B;EACjC,MAAM,MAAM,YAAY,KAAK,KAAK;AAClC,MAAI,KAAK,MAAM,IAAI,IAAI,CAAE,OAAM,IAAI,MAAM,sBAAsB,MAAM;AACrE,OAAK,MAAM,IAAI,KAAK,KAAK;AACzB,SAAO;;CAGT,OAAuB;AACrB,SAAO,CAAC,GAAG,KAAK,MAAM,QAAQ,CAAC;;CAGjC,IAAI,MAAc,SAA4C;AAC5D,MAAI,WAAW,KAAM,QAAO,KAAK,MAAM,IAAI,GAAG,KAAK,IAAI,UAAU;EACjE,IAAIA;EACJ,IAAI,MAAM;AACV,OAAK,MAAM,QAAQ,KAAK,MAAM,QAAQ,EAAE;AACtC,OAAI,KAAK,KAAK,SAAS,KAAM;AAC7B,OAAI,KAAK,KAAK,UAAU,KAAK;AAC3B,UAAM,KAAK,KAAK;AAChB,gBAAY;;;AAGhB,SAAO"}

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.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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"}