@invect/core 0.0.1

package/dist/services/flow-orchestration.service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-orchestration.service.cjs","names":["NodeExecutionCoordinator","FlowRunCoordinator","DatabaseError","ValidationError","FlowRunStatus","BatchStatus"],"sources":["../../src/services/flow-orchestration.service.ts"],"sourcesContent":["import type { FlowRunsService } from './flow-runs/flow-runs.service';\nimport type { NodeExecutionService } from './node-executions/node-execution.service';\nimport type { FlowsService } from './flows/flows.service';\nimport type { CredentialsService } from './credentials/credentials.service';\nimport type { AgentToolExecutionService } from './agent-tool-executions/agent-tool-execution.service';\nimport type { JsExpressionService } from './templating/js-expression.service';\nimport type { TemplateService } from './templating/template.service';\nimport type { BatchJobsService } from './batch-jobs/batch-jobs.service';\nimport { FlowRunResult } from './flow-runs/flow-runs.service';\nimport { Logger } from 'src/types/schemas';\nimport { DatabaseError, ValidationError } from 'src/types/common/errors.types';\nimport { FlowRunStatus } from 'src/types/base';\nimport { FlowRun } from './flow-runs/flow-runs.model';\nimport { Flow } from './flows/flows.model';\nimport { InvectDefinition } from './flow-versions/schemas-fresh';\nimport { NodeExecutorRegistry } from 'src/nodes/executor-registry';\nimport { NodeDataService } from './node-data.service';\nimport { GraphService } from './graph.service';\nimport { FlowVersion } from 'src/database';\nimport { BaseAIClient, BatchStatus } from './ai/base-client';\nimport { NodeExecutionCoordinator } from './flow-orchestration/node-execution-coordinator';\nimport { FlowRunCoordinator } from './flow-orchestration/flow-run-coordinator';\nimport type { PluginHookRunner } from 'src/types/plugin.types';\n\n/**\n * Core Flow Orchestration Service implementation\n * Manages the complete flow execution lifecycle using service layer abstractions\n */\nexport class FlowOrchestrationService {\n  private initialized: boolean = false;\n  private batchPollingInterval?: NodeJS.Timeout;\n  private staleRunCheckInterval?: NodeJS.Timeout;\n  private isPollingActive: boolean = false;\n  private readonly nodeExecutionCoordinator: NodeExecutionCoordinator;\n  private readonly flowRunCoordinator: FlowRunCoordinator;\n  private readonly flowTimeoutMs: number;\n  private readonly staleRunCheckIntervalMs: number;\n\n  constructor(\n    private readonly logger: Logger,\n    private readonly flowRunsService: FlowRunsService,\n    private readonly nodeExecutionService: NodeExecutionService,\n    private readonly flowsService: FlowsService,\n    private readonly nodeDataService: NodeDataService,\n    private readonly graphService: GraphService,\n    private readonly nodeRegistry: NodeExecutorRegistry,\n    private readonly batchJobsService: BatchJobsService,\n    private readonly credentialsService?: CredentialsService, // Optional for now to avoid breaking changes\n    private readonly baseAIClient?: BaseAIClient,\n    private readonly agentToolExecutionService?: AgentToolExecutionService,\n    executionConfig?: {\n      heartbeatIntervalMs?: number;\n      flowTimeoutMs?: number;\n      staleRunCheckIntervalMs?: number;\n    },\n    private readonly pluginHookRunner?: PluginHookRunner,\n    private readonly jsExpressionService?: JsExpressionService,\n    private readonly templateService?: TemplateService,\n  ) {\n    if (!baseAIClient) {\n      throw new Error('BaseAIClient is required for FlowOrchestrationService');\n    }\n\n    this.flowTimeoutMs = executionConfig?.flowTimeoutMs ?? 600_000; // 10 min default\n    this.staleRunCheckIntervalMs = executionConfig?.staleRunCheckIntervalMs ?? 60_000; // 1 min default\n\n    this.nodeExecutionCoordinator = new NodeExecutionCoordinator({\n      logger,\n      nodeExecutionService,\n      nodeRegistry,\n      nodeDataService,\n      graphService,\n      credentialsService,\n      agentToolExecutionService,\n      templateService,\n      jsExpressionService,\n      baseAIClient,\n      pluginHookRunner,\n    });\n\n    this.flowRunCoordinator = new FlowRunCoordinator({\n      logger,\n      flowRunsService,\n      nodeExecutionCoordinator: this.nodeExecutionCoordinator,\n      graphService,\n      nodeExecutionService,\n      batchJobsService,\n      flowsService,\n      heartbeatIntervalMs: executionConfig?.heartbeatIntervalMs ?? 30_000,\n      pluginHookRunner,\n    });\n  }\n\n  /**\n   * Initialize the service\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      this.logger.debug('Flow orchestration service already initialized');\n      return;\n    }\n\n    this.logger.debug('Initializing flow orchestration service');\n\n    try {\n      // Ensure dependent services are initialized\n      await this.flowsService.initialize();\n      await this.flowRunsService.initialize();\n      await this.nodeExecutionService.initialize();\n      await this.batchJobsService.initialize();\n\n      // Startup recovery: fail any flow runs that were RUNNING/PENDING when\n      // the server previously stopped.  Their heartbeats will be stale.\n      await this.recoverStaleRuns();\n\n      // Start flow resumption polling for completed batches\n      await this.startFlowResumptionPolling();\n\n      // Start periodic stale-run detector\n      this.startStaleRunDetector();\n\n      this.initialized = true;\n      this.logger.info('Flow orchestration service initialized successfully');\n    } catch (error) {\n      this.logger.error('Failed to initialize flow orchestration service', { error });\n      throw new DatabaseError('Failed to initialize flow orchestration service', { error });\n    }\n  }\n\n  // ─── Stale run detection ──────────────────────────────────────────────\n\n  /**\n   * Startup recovery: mark all RUNNING/PENDING runs with stale heartbeats as FAILED.\n   * This handles flows that were mid-execution when the server last stopped.\n   */\n  private async recoverStaleRuns(): Promise<void> {\n    try {\n      const failedCount = await this.flowRunsService.failStaleRuns(this.flowTimeoutMs);\n      if (failedCount > 0) {\n        this.logger.warn(`Startup recovery: marked ${failedCount} stale flow run(s) as FAILED`);\n      }\n    } catch (error) {\n      this.logger.error('Failed to recover stale runs on startup', { error });\n      // Non-fatal — don't block initialization\n    }\n  }\n\n  /**\n   * Start a periodic check for stale flow runs.\n   * Runs at the configured `staleRunCheckIntervalMs`.\n   */\n  private startStaleRunDetector(): void {\n    if (this.staleRunCheckInterval) {\n      return;\n    }\n\n    this.logger.info('Starting stale run detector', {\n      flowTimeoutMs: this.flowTimeoutMs,\n      checkIntervalMs: this.staleRunCheckIntervalMs,\n    });\n\n    this.staleRunCheckInterval = setInterval(async () => {\n      try {\n        const failedCount = await this.flowRunsService.failStaleRuns(this.flowTimeoutMs);\n        if (failedCount > 0) {\n          this.logger.warn(`Stale run detector: marked ${failedCount} run(s) as FAILED`);\n        }\n      } catch (error) {\n        this.logger.error('Error in stale run detector', { error });\n      }\n    }, this.staleRunCheckIntervalMs);\n  }\n\n  /**\n   * Stop the periodic stale run detector.\n   */\n  private stopStaleRunDetector(): void {\n    if (this.staleRunCheckInterval) {\n      clearInterval(this.staleRunCheckInterval);\n      this.staleRunCheckInterval = undefined;\n    }\n  }\n\n  /**\n   * Execute a flow by ID with inputs and options\n   */\n  async executeFlow(\n    flowId: string,\n    inputs: Record<string, unknown> = {},\n    options?: { version?: number | 'latest'; initiatedBy?: string; useBatchProcessing?: boolean },\n  ): Promise<FlowRunResult> {\n    this.logger.info('Starting flow execution', { flowId, inputs });\n\n    try {\n      // Get the flow using the injected FlowsService\n      this.logger.debug('Getting flow', { flowId, options });\n\n      const flow = await this.flowsService.getFlowById(flowId, {\n        flowVersion: { version: options?.version || 'latest' },\n      });\n      if (!flow) {\n        throw new ValidationError(`No flow found with ID: ${flowId}`);\n      }\n\n      this.logger.debug('Flow version found', {\n        flowId,\n        version: flow.flowVersion,\n      });\n\n      // Execute the flow - flow run will be created in initiateFlowRun\n      const flowResult = await this.initiateFlowRun(\n        flow,\n        inputs,\n        options?.initiatedBy,\n        options?.useBatchProcessing,\n      );\n\n      return flowResult;\n    } catch (error) {\n      if (error instanceof ValidationError) {\n        throw error;\n      }\n      this.logger.error('Failed to execute flow', {\n        flowId,\n        error: error instanceof Error ? error.message : String(error),\n        stack: error instanceof Error ? error.stack : undefined,\n      });\n      throw new DatabaseError('Failed to execute flow', { error });\n    }\n  }\n\n  /**\n   * Start a flow execution asynchronously - returns immediately with flow run ID.\n   * The flow executes in the background.\n   */\n  async executeFlowAsync(\n    flowId: string,\n    inputs: Record<string, unknown> = {},\n    options?: {\n      version?: number | 'latest';\n      initiatedBy?: string;\n      useBatchProcessing?: boolean;\n      // Trigger provenance (populated when started via webhook/cron)\n      triggerType?: string;\n      triggerId?: string;\n      triggerNodeId?: string;\n      triggerData?: Record<string, unknown>;\n    },\n  ): Promise<FlowRunResult> {\n    this.logger.info('Starting async flow execution', { flowId, inputs });\n\n    try {\n      // Get the flow using the injected FlowsService\n      const flow = await this.flowsService.getFlowById(flowId, {\n        flowVersion: { version: options?.version || 'latest' },\n      });\n      if (!flow) {\n        throw new ValidationError(`No flow found with ID: ${flowId}`);\n      }\n\n      // Validate flow definition exists\n      if (!flow.flowVersion.invectDefinition) {\n        throw new ValidationError('Flow version does not contain a valid flow definition');\n      }\n\n      // Create execution record immediately\n      const execution = await this.flowRunsService.createFlowRun({\n        flowId: flow.id,\n        flowVersion: flow.flowVersion.version,\n        inputs,\n        createdBy: options?.initiatedBy,\n        triggerType: options?.triggerType,\n        triggerId: options?.triggerId,\n        triggerNodeId: options?.triggerNodeId,\n        triggerData: options?.triggerData,\n      });\n\n      this.logger.info('Created execution record for async execution', {\n        flowRunId: execution.id,\n        flowId: flow.id,\n      });\n\n      // Start execution in background (fire and forget)\n      const typedDefinition = flow.flowVersion.invectDefinition as InvectDefinition;\n\n      // Inject trigger context into flowInputs if present (see D1 in FLOW-TRIGGERS-PLAN.md)\n      // Trigger actions read from context.flowInputs.__triggerData at runtime.\n      const augmentedInputs: Record<string, unknown> = {\n        ...execution.inputs,\n        ...(execution.triggerData\n          ? {\n              __triggerData: execution.triggerData,\n              __triggerNodeId: execution.triggerNodeId,\n            }\n          : {}),\n      };\n\n      this.flowRunCoordinator\n        .executeFlowDefinition(\n          execution,\n          typedDefinition,\n          augmentedInputs,\n          options?.useBatchProcessing,\n        )\n        .then((result) => {\n          this.logger.info('Async flow execution completed', {\n            flowRunId: execution.id,\n            status: result.status,\n          });\n        })\n        .catch(async (error) => {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          this.logger.error('Async flow execution failed', {\n            flowRunId: execution.id,\n            error: errorMessage,\n          });\n          // Mark as failed\n          await this.flowRunsService.updateRunStatus(execution.id, FlowRunStatus.FAILED, {\n            error: errorMessage,\n          });\n        });\n\n      // Return immediately with PENDING status\n      return {\n        flowRunId: execution.id,\n        status: FlowRunStatus.PENDING,\n        inputs: execution.inputs,\n        outputs: {},\n        startedAt:\n          typeof execution.startedAt === 'string'\n            ? new Date(execution.startedAt)\n            : execution.startedAt,\n        traces: [],\n      };\n    } catch (error) {\n      if (error instanceof ValidationError) {\n        throw error;\n      }\n      this.logger.error('Failed to start async flow execution', {\n        flowId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n      throw new DatabaseError('Failed to start flow execution', { error });\n    }\n  }\n\n  /**\n   * Execute a complete flow (synchronous - waits for completion)\n   */\n  async initiateFlowRun(\n    flow: Flow & {\n      flowVersion: FlowVersion;\n    },\n    inputs: Record<string, unknown> = {},\n    initiatedBy?: string,\n    useBatchProcessing?: boolean,\n  ): Promise<FlowRunResult> {\n    this.logger.info('Starting flow orchestration', {\n      flowId: flow.id,\n      flowVersion: flow.flowVersion.version,\n    });\n\n    // Validate flow and version\n    if (!flow.flowVersion.invectDefinition) {\n      const error = 'Flow version does not contain a valid flow definition';\n      this.logger.error(error, {\n        flowId: flow.id,\n        flowVersion: flow.flowVersion.version,\n      });\n      throw new ValidationError(error);\n    }\n\n    let execution: FlowRun | undefined;\n    let finalExecutionResult: FlowRunResult;\n\n    try {\n      // Create execution record using FlowRunsService\n      execution = await this.flowRunsService.createFlowRun({\n        flowId: flow.id,\n        flowVersion: flow.flowVersion.version,\n        inputs,\n        createdBy: initiatedBy,\n      });\n\n      this.logger.info('Created execution record', {\n        flowRunId: execution.id,\n        flowId: flow.id,\n      });\n\n      // Execute the flow definition - cast runtime type to inferred type\n      const typedDefinition = flow.flowVersion.invectDefinition as InvectDefinition;\n      finalExecutionResult = await this.flowRunCoordinator.executeFlowDefinition(\n        execution,\n        typedDefinition,\n        execution.inputs,\n        useBatchProcessing,\n      );\n\n      this.logger.info('Flow execution completed', {\n        flowRunId: execution.id,\n        status: finalExecutionResult.status,\n      });\n\n      return finalExecutionResult;\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      this.logger.error('Flow execution failed', {\n        flowRunId: execution?.id,\n        flowId: flow.id,\n        error: errorMessage,\n      });\n\n      // If we have an execution record, mark it as failed\n      if (execution) {\n        await this.flowRunsService.updateRunStatus(execution.id, FlowRunStatus.FAILED, {\n          error: errorMessage,\n        });\n\n        // Get traces for the failed execution\n        const traces = await this.nodeExecutionService.listNodeExecutionsByFlowRunId(execution.id);\n\n        // Build failed result with available data\n        finalExecutionResult = {\n          flowRunId: execution.id,\n          status: FlowRunStatus.FAILED,\n          inputs: execution.inputs,\n          outputs: {},\n          error: errorMessage,\n          startedAt:\n            typeof execution.startedAt === 'string'\n              ? new Date(execution.startedAt)\n              : execution.startedAt,\n          completedAt: new Date(),\n          duration: execution.duration || 0,\n          traces,\n        };\n\n        return finalExecutionResult;\n      }\n\n      // Re-throw error if we couldn't create execution record\n      throw new DatabaseError('Failed to orchestrate flow execution', { error, flowId: flow.id });\n    }\n  }\n\n  /**\n   * Execute a flow definition\n   */\n\n  /**\n   * Execute a flow up to a specific target node.\n   * Only executes the upstream nodes required to produce output for the target node.\n   */\n  async executeFlowToNode(\n    flowId: string,\n    targetNodeId: string,\n    inputs: Record<string, unknown> = {},\n    options?: { version?: number | 'latest'; initiatedBy?: string; useBatchProcessing?: boolean },\n  ): Promise<FlowRunResult> {\n    this.logger.info('Starting partial flow execution to node', { flowId, targetNodeId, inputs });\n\n    try {\n      // Get the flow using the injected FlowsService\n      const flow = await this.flowsService.getFlowById(flowId, {\n        flowVersion: { version: options?.version || 'latest' },\n      });\n      if (!flow) {\n        throw new ValidationError(`No flow found with ID: ${flowId}`);\n      }\n\n      // Validate flow and version\n      if (!flow.flowVersion.invectDefinition) {\n        throw new ValidationError('Flow version does not contain a valid flow definition');\n      }\n\n      const definition = flow.flowVersion.invectDefinition as InvectDefinition;\n\n      // Verify target node exists in the definition\n      const targetNode = definition.nodes.find((n) => n.id === targetNodeId);\n      if (!targetNode) {\n        throw new ValidationError(`Target node not found in flow: ${targetNodeId}`);\n      }\n\n      // Create execution record\n      const execution = await this.flowRunsService.createFlowRun({\n        flowId: flow.id,\n        flowVersion: flow.flowVersion.version,\n        inputs,\n        createdBy: options?.initiatedBy,\n      });\n\n      this.logger.info('Created execution record for partial flow', {\n        flowRunId: execution.id,\n        flowId: flow.id,\n        targetNodeId,\n      });\n\n      // Execute the flow to the target node\n      const result = await this.flowRunCoordinator.executeFlowToNode(\n        execution,\n        definition,\n        targetNodeId,\n        execution.inputs,\n        options?.useBatchProcessing,\n      );\n\n      this.logger.info('Partial flow execution completed', {\n        flowRunId: execution.id,\n        targetNodeId,\n        status: result.status,\n      });\n\n      return result;\n    } catch (error) {\n      if (error instanceof ValidationError) {\n        throw error;\n      }\n      this.logger.error('Failed to execute partial flow', {\n        flowId,\n        targetNodeId,\n        error: error instanceof Error ? error.message : String(error),\n      });\n      throw new DatabaseError('Failed to execute partial flow', { error });\n    }\n  }\n\n  /**\n   * Resume flow execution after batch completion\n   */\n  async resumeFromBatchCompletion(\n    flowRunId: string,\n    completedBatchNodeId: string,\n    batchResult?: unknown,\n    batchError?: string,\n  ): Promise<FlowRunResult> {\n    return this.flowRunCoordinator.resumeFromBatchCompletion(\n      flowRunId,\n      completedBatchNodeId,\n      batchResult,\n      batchError,\n    );\n  }\n\n  /**\n   * Continue flow execution after batch completion\n   */\n  async continueFlowRunFromBatch(\n    flowRunId: string,\n    definition: InvectDefinition,\n    flowInputs: Record<string, unknown> = {},\n  ): Promise<FlowRunResult> {\n    return this.flowRunCoordinator.continueFlowRunFromBatch(flowRunId, definition, flowInputs);\n  }\n\n  /**\n   * Get execution with traces\n   */\n  async getExecutionWithTraces(flowRunId: string): Promise<FlowRunResult | null> {\n    try {\n      const execution = await this.flowRunsService.getRunById(flowRunId);\n\n      const traces = await this.nodeExecutionService.listNodeExecutionsByFlowRunId(flowRunId);\n\n      return {\n        flowRunId: execution.id,\n        status: execution.status,\n        inputs: execution.inputs,\n        outputs: execution.outputs || {},\n        error: execution.error,\n        startedAt:\n          typeof execution.startedAt === 'string'\n            ? new Date(execution.startedAt)\n            : execution.startedAt,\n        completedAt: execution.completedAt\n          ? typeof execution.completedAt === 'string'\n            ? new Date(execution.completedAt)\n            : execution.completedAt\n          : undefined,\n        duration: execution.duration,\n        traces,\n      };\n    } catch (error) {\n      this.logger.error('Failed to get execution with traces', { flowRunId, error });\n      throw new DatabaseError('Failed to get execution with traces', { error });\n    }\n  }\n\n  /**\n   * Cancel a running execution\n   */\n  async cancelExecution(flowRunId: string): Promise<void> {\n    try {\n      const execution = await this.flowRunsService.getRunById(flowRunId);\n\n      if (execution.status !== 'RUNNING' && execution.status !== 'PENDING') {\n        throw new DatabaseError(`Cannot cancel execution in ${execution.status} state`);\n      }\n\n      await this.flowRunsService.updateRunStatus(flowRunId, 'CANCELLED' as FlowRunStatus);\n\n      this.logger.info('Execution cancelled', { flowRunId });\n    } catch (error) {\n      this.logger.error('Failed to cancel execution', { flowRunId, error });\n      throw error;\n    }\n  }\n\n  /**\n   * Start polling for completed batch jobs to resume flows\n   */\n  async startFlowResumptionPolling(intervalMs: number = 30000): Promise<void> {\n    if (this.isPollingActive) {\n      this.logger.debug('Flow resumption polling is already active');\n      return;\n    }\n\n    this.logger.info('Starting flow resumption polling', { intervalMs });\n    this.isPollingActive = true;\n\n    const pollOnce = async () => {\n      if (!this.isPollingActive) {\n        return;\n      }\n\n      try {\n        await this.pollForCompletedBatches();\n      } catch (error) {\n        this.logger.error('Error during flow resumption polling', { error });\n      }\n    };\n\n    // Run initial poll\n    await pollOnce();\n\n    // Set up recurring polling\n    this.batchPollingInterval = setInterval(pollOnce, intervalMs);\n  }\n\n  /**\n   * Stop polling for completed batch jobs\n   */\n  async stopFlowResumptionPolling(): Promise<void> {\n    if (!this.isPollingActive) {\n      this.logger.debug('Flow resumption polling is not active');\n      return;\n    }\n\n    this.logger.info('Stopping flow resumption polling');\n    this.isPollingActive = false;\n\n    if (this.batchPollingInterval) {\n      clearInterval(this.batchPollingInterval);\n      this.batchPollingInterval = undefined;\n    }\n  }\n\n  /**\n   * Poll for completed batch jobs and resume corresponding flows\n   */\n  private async pollForCompletedBatches(): Promise<void> {\n    try {\n      // Find flows that are paused for batch processing with completed batch jobs\n      const flowsToResume = await this.findFlowsReadyForResumption();\n\n      if (flowsToResume.length === 0) {\n        this.logger.debug('No flows found ready for resumption');\n        return;\n      }\n\n      this.logger.info('Found flows ready for resumption', {\n        count: flowsToResume.length,\n        flowRunIds: flowsToResume.map((f) => f.flowRunId),\n      });\n\n      // Resume each flow\n      for (const flowResumption of flowsToResume) {\n        try {\n          await this.resumeFromBatchCompletion(\n            flowResumption.flowRunId,\n            flowResumption.nodeId,\n            flowResumption.batchResult,\n            flowResumption.batchError,\n          );\n\n          this.logger.info('Flow resumed successfully', {\n            flowRunId: flowResumption.flowRunId,\n            nodeId: flowResumption.nodeId,\n          });\n        } catch (error) {\n          this.logger.error('Failed to resume flow', {\n            flowRunId: flowResumption.flowRunId,\n            nodeId: flowResumption.nodeId,\n            error: error instanceof Error ? error.message : String(error),\n          });\n        }\n      }\n    } catch (error) {\n      this.logger.error('Error polling for completed batches', { error });\n    }\n  }\n\n  /**\n   * Find flows that are paused for batch processing but have completed batch jobs\n   */\n  private async findFlowsReadyForResumption(): Promise<\n    Array<{\n      flowRunId: string;\n      nodeId: string;\n      batchResult?: unknown;\n      batchError?: string;\n    }>\n  > {\n    try {\n      // Get all flows paused for batch processing\n      const pausedFlowsResult = await this.flowRunsService.listRuns({\n        filter: {\n          status: [FlowRunStatus.PAUSED_FOR_BATCH],\n        },\n      });\n\n      const flowsToResume: Array<{\n        flowRunId: string;\n        nodeId: string;\n        batchResult?: unknown;\n        batchError?: string;\n      }> = [];\n\n      // Check each paused flow for completed batch jobs\n      for (const flowRun of pausedFlowsResult.data) {\n        const batchJobs = await this.batchJobsService.getBatchJobsByFlowRunId(flowRun.id);\n\n        // Find completed batch jobs for this execution (completed, failed, or cancelled)\n        const completedBatchJobs = batchJobs.filter(\n          (job) =>\n            job.status === BatchStatus.COMPLETED ||\n            job.status === BatchStatus.FAILED ||\n            job.status === BatchStatus.CANCELLED,\n        );\n\n        // If there are completed batch jobs, this flow is ready for resumption\n        for (const batchJob of completedBatchJobs) {\n          flowsToResume.push({\n            flowRunId: flowRun.id,\n            nodeId: batchJob.nodeId,\n            batchResult:\n              batchJob.status === BatchStatus.COMPLETED ? batchJob.responseData : undefined,\n            batchError:\n              batchJob.status === BatchStatus.FAILED || batchJob.status === BatchStatus.CANCELLED\n                ? batchJob.error\n                : undefined,\n          });\n        }\n      }\n\n      return flowsToResume;\n    } catch (error) {\n      this.logger.error('Failed to find flows ready for resumption', { error });\n      return [];\n    }\n  }\n\n  /**\n   * Close the service\n   */\n  async close(): Promise<void> {\n    this.logger.debug('Closing flow orchestration service');\n\n    // Stop all heartbeat timers for in-progress flows\n    this.flowRunCoordinator.stopAllHeartbeats();\n\n    // Stop batch polling if it's running\n    await this.stopFlowResumptionPolling();\n\n    // Stop stale run detector\n    this.stopStaleRunDetector();\n\n    this.initialized = false;\n    // Service lifecycle is managed externally\n  }\n}\n"],"mappings":"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"}

package/dist/services/flow-orchestration.service.d.cts

@@ -0,0 +1,149 @@
+import { Logger } from "../types/schemas-fresh/invect-config.cjs";
+import { InvectDefinition } from "./flow-versions/schemas-fresh.cjs";
+import { JsExpressionService } from "./templating/js-expression.service.cjs";
+import { TemplateService } from "./templating/template.service.cjs";
+import { NodeDataService } from "./node-data.service.cjs";
+import { CredentialsService } from "./credentials/credentials.service.cjs";
+import { PluginHookRunner } from "../types/plugin.types.cjs";
+import { Flow } from "./flows/flows.model.cjs";
+import { BatchJobsService } from "./batch-jobs/batch-jobs.service.cjs";
+import { BaseAIClient } from "./ai/base-client.cjs";
+import { FlowVersion } from "../database/schema-sqlite.cjs";
+import { FlowsService } from "./flows/flows.service.cjs";
+import { FlowRunResult, FlowRunsService } from "./flow-runs/flow-runs.service.cjs";
+import { NodeExecutionService } from "./node-executions/node-execution.service.cjs";
+import { AgentToolExecutionService } from "./agent-tool-executions/agent-tool-execution.service.cjs";
+import { NodeExecutorRegistry } from "../nodes/executor-registry.cjs";
+import { GraphService } from "./graph.service.cjs";
+
+//#region src/services/flow-orchestration.service.d.ts
+/**
+ * Core Flow Orchestration Service implementation
+ * Manages the complete flow execution lifecycle using service layer abstractions
+ */
+declare class FlowOrchestrationService {
+  private readonly logger;
+  private readonly flowRunsService;
+  private readonly nodeExecutionService;
+  private readonly flowsService;
+  private readonly nodeDataService;
+  private readonly graphService;
+  private readonly nodeRegistry;
+  private readonly batchJobsService;
+  private readonly credentialsService?;
+  private readonly baseAIClient?;
+  private readonly agentToolExecutionService?;
+  private readonly pluginHookRunner?;
+  private readonly jsExpressionService?;
+  private readonly templateService?;
+  private initialized;
+  private batchPollingInterval?;
+  private staleRunCheckInterval?;
+  private isPollingActive;
+  private readonly nodeExecutionCoordinator;
+  private readonly flowRunCoordinator;
+  private readonly flowTimeoutMs;
+  private readonly staleRunCheckIntervalMs;
+  constructor(logger: Logger, flowRunsService: FlowRunsService, nodeExecutionService: NodeExecutionService, flowsService: FlowsService, nodeDataService: NodeDataService, graphService: GraphService, nodeRegistry: NodeExecutorRegistry, batchJobsService: BatchJobsService, credentialsService?: CredentialsService | undefined, // Optional for now to avoid breaking changes
+  baseAIClient?: BaseAIClient | undefined, agentToolExecutionService?: AgentToolExecutionService | undefined, executionConfig?: {
+    heartbeatIntervalMs?: number;
+    flowTimeoutMs?: number;
+    staleRunCheckIntervalMs?: number;
+  }, pluginHookRunner?: PluginHookRunner | undefined, jsExpressionService?: JsExpressionService | undefined, templateService?: TemplateService | undefined);
+  /**
+   * Initialize the service
+   */
+  initialize(): Promise<void>;
+  /**
+   * Startup recovery: mark all RUNNING/PENDING runs with stale heartbeats as FAILED.
+   * This handles flows that were mid-execution when the server last stopped.
+   */
+  private recoverStaleRuns;
+  /**
+   * Start a periodic check for stale flow runs.
+   * Runs at the configured `staleRunCheckIntervalMs`.
+   */
+  private startStaleRunDetector;
+  /**
+   * Stop the periodic stale run detector.
+   */
+  private stopStaleRunDetector;
+  /**
+   * Execute a flow by ID with inputs and options
+   */
+  executeFlow(flowId: string, inputs?: Record<string, unknown>, options?: {
+    version?: number | 'latest';
+    initiatedBy?: string;
+    useBatchProcessing?: boolean;
+  }): Promise<FlowRunResult>;
+  /**
+   * Start a flow execution asynchronously - returns immediately with flow run ID.
+   * The flow executes in the background.
+   */
+  executeFlowAsync(flowId: string, inputs?: Record<string, unknown>, options?: {
+    version?: number | 'latest';
+    initiatedBy?: string;
+    useBatchProcessing?: boolean;
+    triggerType?: string;
+    triggerId?: string;
+    triggerNodeId?: string;
+    triggerData?: Record<string, unknown>;
+  }): Promise<FlowRunResult>;
+  /**
+   * Execute a complete flow (synchronous - waits for completion)
+   */
+  initiateFlowRun(flow: Flow & {
+    flowVersion: FlowVersion;
+  }, inputs?: Record<string, unknown>, initiatedBy?: string, useBatchProcessing?: boolean): Promise<FlowRunResult>;
+  /**
+   * Execute a flow definition
+   */
+  /**
+   * Execute a flow up to a specific target node.
+   * Only executes the upstream nodes required to produce output for the target node.
+   */
+  executeFlowToNode(flowId: string, targetNodeId: string, inputs?: Record<string, unknown>, options?: {
+    version?: number | 'latest';
+    initiatedBy?: string;
+    useBatchProcessing?: boolean;
+  }): Promise<FlowRunResult>;
+  /**
+   * Resume flow execution after batch completion
+   */
+  resumeFromBatchCompletion(flowRunId: string, completedBatchNodeId: string, batchResult?: unknown, batchError?: string): Promise<FlowRunResult>;
+  /**
+   * Continue flow execution after batch completion
+   */
+  continueFlowRunFromBatch(flowRunId: string, definition: InvectDefinition, flowInputs?: Record<string, unknown>): Promise<FlowRunResult>;
+  /**
+   * Get execution with traces
+   */
+  getExecutionWithTraces(flowRunId: string): Promise<FlowRunResult | null>;
+  /**
+   * Cancel a running execution
+   */
+  cancelExecution(flowRunId: string): Promise<void>;
+  /**
+   * Start polling for completed batch jobs to resume flows
+   */
+  startFlowResumptionPolling(intervalMs?: number): Promise<void>;
+  /**
+   * Stop polling for completed batch jobs
+   */
+  stopFlowResumptionPolling(): Promise<void>;
+  /**
+   * Poll for completed batch jobs and resume corresponding flows
+   */
+  private pollForCompletedBatches;
+  /**
+   * Find flows that are paused for batch processing but have completed batch jobs
+   */
+  private findFlowsReadyForResumption;
+  /**
+   * Close the service
+   */
+  close(): Promise<void>;
+}
+//#endregion
+export { FlowOrchestrationService };
+//# sourceMappingURL=flow-orchestration.service.d.cts.map

package/dist/services/flow-orchestration.service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-orchestration.service.d.cts","names":[],"sources":["../../src/services/flow-orchestration.service.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA4BA;;cAAa,wBAAA;EAAA,iBAWQ,MAAA;EAAA,iBACA,eAAA;EAAA,iBACA,oBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,eAAA;EAAA,iBACA,YAAA;EAAA,iBACA,YAAA;EAAA,iBACA,gBAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,yBAAA;EAAA,iBAMA,gBAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,eAAA;EAAA,QA5BX,WAAA;EAAA,QACA,oBAAA;EAAA,QACA,qBAAA;EAAA,QACA,eAAA;EAAA,iBACS,wBAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,aAAA;EAAA,iBACA,uBAAA;cAGE,MAAA,EAAQ,MAAA,EACR,eAAA,EAAiB,eAAA,EACjB,oBAAA,EAAsB,oBAAA,EACtB,YAAA,EAAc,YAAA,EACd,eAAA,EAAiB,eAAA,EACjB,YAAA,EAAc,YAAA,EACd,YAAA,EAAc,oBAAA,EACd,gBAAA,EAAkB,gBAAA,EAClB,kBAAA,GAAqB,kBAAA;EACrB,YAAA,GAAe,YAAA,cACf,yBAAA,GAA4B,yBAAA,cAC7C,eAAA;IACE,mBAAA;IACA,aAAA;IACA,uBAAA;EAAA,GAEe,gBAAA,GAAmB,gBAAA,cACnB,mBAAA,GAAsB,mBAAA,cACtB,eAAA,GAAkB,eAAA;EAiZ1B;;;EA1WL,UAAA,CAAA,GAAc,OAAA;EAocN;;;;EAAA,QA7ZA,gBAAA;EAsamC;;;;EAAA,QAtZzC,qBAAA;EAqmBc;;;EAAA,QA5kBd,oBAAA;EAvIW;;;EAiJb,WAAA,CACJ,MAAA,UACA,MAAA,GAAQ,MAAA,mBACR,OAAA;IAAY,OAAA;IAA6B,WAAA;IAAsB,kBAAA;EAAA,IAC9D,OAAA,CAAQ,aAAA;EA7IQ;;;;EA0Lb,gBAAA,CACJ,MAAA,UACA,MAAA,GAAQ,MAAA,mBACR,OAAA;IACE,OAAA;IACA,WAAA;IACA,kBAAA;IAEA,WAAA;IACA,SAAA;IACA,aAAA;IACA,WAAA,GAAc,MAAA;EAAA,IAEf,OAAA,CAAQ,aAAA;EAjNgB;;;EAsTrB,eAAA,CACJ,IAAA,EAAM,IAAA;IACJ,WAAA,EAAa,WAAA;EAAA,GAEf,MAAA,GAAQ,MAAA,mBACR,WAAA,WACA,kBAAA,aACC,OAAA,CAAQ,aAAA;EA1TsB;;;EACd;;;;EA0Zb,iBAAA,CACJ,MAAA,UACA,YAAA,UACA,MAAA,GAAQ,MAAA,mBACR,OAAA;IAAY,OAAA;IAA6B,WAAA;IAAsB,kBAAA;EAAA,IAC9D,OAAA,CAAQ,aAAA;EA1ZuB;;;EAie5B,yBAAA,CACJ,SAAA,UACA,oBAAA,UACA,WAAA,YACA,UAAA,YACC,OAAA,CAAQ,aAAA;EAneP;;;EA+eE,wBAAA,CACJ,SAAA,UACA,UAAA,EAAY,gBAAA,EACZ,UAAA,GAAY,MAAA,oBACX,OAAA,CAAQ,aAAA;EA/e2B;;;EAsfhC,sBAAA,CAAuB,SAAA,WAAoB,OAAA,CAAQ,aAAA;EApfpB;;;EAqhB/B,eAAA,CAAgB,SAAA,WAAoB,OAAA;EAvc5B;;;EA2dR,0BAAA,CAA2B,UAAA,YAA6B,OAAA;EAva5D;;;EAscI,yBAAA,CAAA,GAA6B,OAAA;EApcQ;;;EAAA,QAsd7B,uBAAA;EArdH;;;EAAA,QAkgBG,2BAAA;EAndZ;;;EA+gBI,KAAA,CAAA,GAAS,OAAA;AAAA"}

package/dist/services/flow-orchestration.service.d.ts

@@ -0,0 +1,149 @@
+import { Logger } from "../types/schemas-fresh/invect-config.js";
+import { InvectDefinition } from "./flow-versions/schemas-fresh.js";
+import { JsExpressionService } from "./templating/js-expression.service.js";
+import { TemplateService } from "./templating/template.service.js";
+import { NodeDataService } from "./node-data.service.js";
+import { CredentialsService } from "./credentials/credentials.service.js";
+import { PluginHookRunner } from "../types/plugin.types.js";
+import { Flow } from "./flows/flows.model.js";
+import { BatchJobsService } from "./batch-jobs/batch-jobs.service.js";
+import { BaseAIClient } from "./ai/base-client.js";
+import { FlowVersion } from "../database/schema-sqlite.js";
+import { FlowsService } from "./flows/flows.service.js";
+import { FlowRunResult, FlowRunsService } from "./flow-runs/flow-runs.service.js";
+import { NodeExecutionService } from "./node-executions/node-execution.service.js";
+import { AgentToolExecutionService } from "./agent-tool-executions/agent-tool-execution.service.js";
+import { NodeExecutorRegistry } from "../nodes/executor-registry.js";
+import { GraphService } from "./graph.service.js";
+
+//#region src/services/flow-orchestration.service.d.ts
+/**
+ * Core Flow Orchestration Service implementation
+ * Manages the complete flow execution lifecycle using service layer abstractions
+ */
+declare class FlowOrchestrationService {
+  private readonly logger;
+  private readonly flowRunsService;
+  private readonly nodeExecutionService;
+  private readonly flowsService;
+  private readonly nodeDataService;
+  private readonly graphService;
+  private readonly nodeRegistry;
+  private readonly batchJobsService;
+  private readonly credentialsService?;
+  private readonly baseAIClient?;
+  private readonly agentToolExecutionService?;
+  private readonly pluginHookRunner?;
+  private readonly jsExpressionService?;
+  private readonly templateService?;
+  private initialized;
+  private batchPollingInterval?;
+  private staleRunCheckInterval?;
+  private isPollingActive;
+  private readonly nodeExecutionCoordinator;
+  private readonly flowRunCoordinator;
+  private readonly flowTimeoutMs;
+  private readonly staleRunCheckIntervalMs;
+  constructor(logger: Logger, flowRunsService: FlowRunsService, nodeExecutionService: NodeExecutionService, flowsService: FlowsService, nodeDataService: NodeDataService, graphService: GraphService, nodeRegistry: NodeExecutorRegistry, batchJobsService: BatchJobsService, credentialsService?: CredentialsService | undefined, // Optional for now to avoid breaking changes
+  baseAIClient?: BaseAIClient | undefined, agentToolExecutionService?: AgentToolExecutionService | undefined, executionConfig?: {
+    heartbeatIntervalMs?: number;
+    flowTimeoutMs?: number;
+    staleRunCheckIntervalMs?: number;
+  }, pluginHookRunner?: PluginHookRunner | undefined, jsExpressionService?: JsExpressionService | undefined, templateService?: TemplateService | undefined);
+  /**
+   * Initialize the service
+   */
+  initialize(): Promise<void>;
+  /**
+   * Startup recovery: mark all RUNNING/PENDING runs with stale heartbeats as FAILED.
+   * This handles flows that were mid-execution when the server last stopped.
+   */
+  private recoverStaleRuns;
+  /**
+   * Start a periodic check for stale flow runs.
+   * Runs at the configured `staleRunCheckIntervalMs`.
+   */
+  private startStaleRunDetector;
+  /**
+   * Stop the periodic stale run detector.
+   */
+  private stopStaleRunDetector;
+  /**
+   * Execute a flow by ID with inputs and options
+   */
+  executeFlow(flowId: string, inputs?: Record<string, unknown>, options?: {
+    version?: number | 'latest';
+    initiatedBy?: string;
+    useBatchProcessing?: boolean;
+  }): Promise<FlowRunResult>;
+  /**
+   * Start a flow execution asynchronously - returns immediately with flow run ID.
+   * The flow executes in the background.
+   */
+  executeFlowAsync(flowId: string, inputs?: Record<string, unknown>, options?: {
+    version?: number | 'latest';
+    initiatedBy?: string;
+    useBatchProcessing?: boolean;
+    triggerType?: string;
+    triggerId?: string;
+    triggerNodeId?: string;
+    triggerData?: Record<string, unknown>;
+  }): Promise<FlowRunResult>;
+  /**
+   * Execute a complete flow (synchronous - waits for completion)
+   */
+  initiateFlowRun(flow: Flow & {
+    flowVersion: FlowVersion;
+  }, inputs?: Record<string, unknown>, initiatedBy?: string, useBatchProcessing?: boolean): Promise<FlowRunResult>;
+  /**
+   * Execute a flow definition
+   */
+  /**
+   * Execute a flow up to a specific target node.
+   * Only executes the upstream nodes required to produce output for the target node.
+   */
+  executeFlowToNode(flowId: string, targetNodeId: string, inputs?: Record<string, unknown>, options?: {
+    version?: number | 'latest';
+    initiatedBy?: string;
+    useBatchProcessing?: boolean;
+  }): Promise<FlowRunResult>;
+  /**
+   * Resume flow execution after batch completion
+   */
+  resumeFromBatchCompletion(flowRunId: string, completedBatchNodeId: string, batchResult?: unknown, batchError?: string): Promise<FlowRunResult>;
+  /**
+   * Continue flow execution after batch completion
+   */
+  continueFlowRunFromBatch(flowRunId: string, definition: InvectDefinition, flowInputs?: Record<string, unknown>): Promise<FlowRunResult>;
+  /**
+   * Get execution with traces
+   */
+  getExecutionWithTraces(flowRunId: string): Promise<FlowRunResult | null>;
+  /**
+   * Cancel a running execution
+   */
+  cancelExecution(flowRunId: string): Promise<void>;
+  /**
+   * Start polling for completed batch jobs to resume flows
+   */
+  startFlowResumptionPolling(intervalMs?: number): Promise<void>;
+  /**
+   * Stop polling for completed batch jobs
+   */
+  stopFlowResumptionPolling(): Promise<void>;
+  /**
+   * Poll for completed batch jobs and resume corresponding flows
+   */
+  private pollForCompletedBatches;
+  /**
+   * Find flows that are paused for batch processing but have completed batch jobs
+   */
+  private findFlowsReadyForResumption;
+  /**
+   * Close the service
+   */
+  close(): Promise<void>;
+}
+//#endregion
+export { FlowOrchestrationService };
+//# sourceMappingURL=flow-orchestration.service.d.ts.map

package/dist/services/flow-orchestration.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-orchestration.service.d.ts","names":[],"sources":["../../src/services/flow-orchestration.service.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AA4BA;cAAa,wBAAA;EAAA,iBAWQ,MAAA;EAAA,iBACA,eAAA;EAAA,iBACA,oBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,eAAA;EAAA,iBACA,YAAA;EAAA,iBACA,YAAA;EAAA,iBACA,gBAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,YAAA;EAAA,iBACA,yBAAA;EAAA,iBAMA,gBAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,eAAA;EAAA,QA5BX,WAAA;EAAA,QACA,oBAAA;EAAA,QACA,qBAAA;EAAA,QACA,eAAA;EAAA,iBACS,wBAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,aAAA;EAAA,iBACA,uBAAA;cAGE,MAAA,EAAQ,MAAA,EACR,eAAA,EAAiB,eAAA,EACjB,oBAAA,EAAsB,oBAAA,EACtB,YAAA,EAAc,YAAA,EACd,eAAA,EAAiB,eAAA,EACjB,YAAA,EAAc,YAAA,EACd,YAAA,EAAc,oBAAA,EACd,gBAAA,EAAkB,gBAAA,EAClB,kBAAA,GAAqB,kBAAA;EACrB,YAAA,GAAe,YAAA,cACf,yBAAA,GAA4B,yBAAA,cAC7C,eAAA;IACE,mBAAA;IACA,aAAA;IACA,uBAAA;EAAA,GAEe,gBAAA,GAAmB,gBAAA,cACnB,mBAAA,GAAsB,mBAAA,cACtB,eAAA,GAAkB,eAAA;EA+Y3B;;;EAxWJ,UAAA,CAAA,GAAc,OAAA;EAsbjB;;;;EAAA,QA/YW,gBAAA;EAsa2C;;;;EAAA,QAtZjD,qBAAA;EAqmBO;;;EAAA,QA5kBP,oBAAA;EAxIW;;;EAkJb,WAAA,CACJ,MAAA,UACA,MAAA,GAAQ,MAAA,mBACR,OAAA;IAAY,OAAA;IAA6B,WAAA;IAAsB,kBAAA;EAAA,IAC9D,OAAA,CAAQ,aAAA;EA9IQ;;;;EA2Lb,gBAAA,CACJ,MAAA,UACA,MAAA,GAAQ,MAAA,mBACR,OAAA;IACE,OAAA;IACA,WAAA;IACA,kBAAA;IAEA,WAAA;IACA,SAAA;IACA,aAAA;IACA,WAAA,GAAc,MAAA;EAAA,IAEf,OAAA,CAAQ,aAAA;;;;EAqGL,eAAA,CACJ,IAAA,EAAM,IAAA;IACJ,WAAA,EAAa,WAAA;EAAA,GAEf,MAAA,GAAQ,MAAA,mBACR,WAAA,WACA,kBAAA,aACC,OAAA,CAAQ,aAAA;EA3TQ;;;EAEiB;;;;EA0Z9B,iBAAA,CACJ,MAAA,UACA,YAAA,UACA,MAAA,GAAQ,MAAA,mBACR,OAAA;IAAY,OAAA;IAA6B,WAAA;IAAsB,kBAAA;EAAA,IAC9D,OAAA,CAAQ,aAAA;EA3ZQ;;;EAkeb,yBAAA,CACJ,SAAA,UACA,oBAAA,UACA,WAAA,YACA,UAAA,YACC,OAAA,CAAQ,aAAA;EAreQ;;;EAifb,wBAAA,CACJ,SAAA,UACA,UAAA,EAAY,gBAAA,EACZ,UAAA,GAAY,MAAA,oBACX,OAAA,CAAQ,aAAA;EApfT;;;EA2fI,sBAAA,CAAuB,SAAA,WAAoB,OAAA,CAAQ,aAAA;EArftC;;;EAshBb,eAAA,CAAgB,SAAA,WAAoB,OAAA;EA9etB;;;EAkgBd,0BAAA,CAA2B,UAAA,YAA6B,OAAA;EAxaxD;;;EAucA,yBAAA,CAAA,GAA6B,OAAA;EApcrB;;;EAAA,QAsdA,uBAAA;EArdX;;;EAAA,QAkgBW,2BAAA;EAndJ;;;EA+gBJ,KAAA,CAAA,GAAS,OAAA;AAAA"}