veryfront 0.1.562 → 0.1.564

package/esm/src/workflow/worker/executors/index.d.ts

@@ -1,7 +1,8 @@
 /**
- * Job Executors
+ * Job executors
  *
- * Abstraction layer for executing workflow jobs in different environments.
+ * Abstraction layer for executing job-backed workflow runs in different
+ * environments.
  */
 export type { JobConfig, JobExecutor, JobInfo, JobStatus } from "./types.js";
 export { isJobExecutor } from "./types.js";

package/esm/src/workflow/worker/executors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGlG,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGlG,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}

package/esm/src/workflow/worker/executors/index.js

@@ -1,7 +1,8 @@
 /**
- * Job Executors
+ * Job executors
  *
- * Abstraction layer for executing workflow jobs in different environments.
+ * Abstraction layer for executing job-backed workflow runs in different
+ * environments.
  */
 export { isJobExecutor } from "./types.js";
 // K8s Executor

package/esm/src/workflow/worker/executors/k8s.d.ts

@@ -1,7 +1,7 @@
 /**
- * Kubernetes Job Executor
+ * Kubernetes Job executor
  *
- * Executes workflow jobs as Kubernetes Jobs.
+ * Executes job-backed workflow runs as Kubernetes Jobs.
  * Each workflow runs in an ephemeral pod with complete isolation.
  */
 import type { JobConfig, JobExecutor, JobInfo } from "./types.js";

package/esm/src/workflow/worker/executors/k8s.js

@@ -1,7 +1,7 @@
 /**
- * Kubernetes Job Executor
+ * Kubernetes Job executor
  *
- * Executes workflow jobs as Kubernetes Jobs.
+ * Executes job-backed workflow runs as Kubernetes Jobs.
  * Each workflow runs in an ephemeral pod with complete isolation.
  */
 import { logger as baseLogger } from "../../../utils/index.js";

package/esm/src/workflow/worker/executors/process.d.ts

@@ -7,7 +7,7 @@ export interface ProcessJobExecutorConfig {
     command?: string;
     /** Arguments for the command */
     args?: string[];
-    /** Path to the job entrypoint script */
+    /** Path to the workflow run entrypoint script */
     entrypointPath: string;
     /** Working directory for spawned processes */
     cwd?: string;
@@ -17,21 +17,21 @@ export interface ProcessJobExecutorConfig {
     debug?: boolean;
 }
 /**
- * Process Job Executor
+ * Process job executor
  *
- * Spawns child processes for each workflow job.
+ * Spawns child processes for each job-backed workflow run.
  * Provides isolation at the process level (separate memory space).
  *
  * @example
  * ```typescript
  * const executor = new ProcessJobExecutor({
- *   entrypointPath: "./src/workflow-job.ts",
+ *   entrypointPath: "./src/workflow-run-entrypoint.ts",
  *   env: {
  *     REDIS_URL: "redis://localhost:6379",
  *   },
  * });
  *
- * const manager = new WorkflowJobManager({
+ * const manager = new WorkflowRunManager({
  *   backend,
  *   executor,
  * });

package/esm/src/workflow/worker/executors/process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/process.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAa,MAAM,YAAY,CAAC;AAI7E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAkBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,MAAM,CAGZ;IACF,OAAO,CAAC,UAAU,CAAiC;gBAEvC,MAAM,EAAE,wBAAwB;IAS5C,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDhD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASpD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAY/C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IA8DtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkCpB;;OAEG;IACH,OAAO,CAAC,SAAS;CAelB"}
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/process.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAa,MAAM,YAAY,CAAC;AAI7E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAkBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,MAAM,CAGZ;IACF,OAAO,CAAC,UAAU,CAAiC;gBAEvC,MAAM,EAAE,wBAAwB;IAS5C,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDhD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASpD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAY/C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IA8DtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkCpB;;OAEG;IACH,OAAO,CAAC,SAAS;CAelB"}

package/esm/src/workflow/worker/executors/process.js

@@ -1,7 +1,7 @@
 /**
- * Process Job Executor
+ * Process job executor
  *
- * Executes workflow jobs as child processes.
+ * Executes job-backed workflow runs as child processes.
  * Useful for local development and testing without containerization.
  *
  * Each workflow runs in a separate Deno subprocess with its own environment.
@@ -11,21 +11,21 @@ import { WORKFLOW_JOB_PERMISSIONS } from "../../../security/deno-permissions.js"
 import { logger as baseLogger } from "../../../utils/index.js";
 const logger = baseLogger.component("process-job-executor");
 /**
- * Process Job Executor
+ * Process job executor
  *
- * Spawns child processes for each workflow job.
+ * Spawns child processes for each job-backed workflow run.
  * Provides isolation at the process level (separate memory space).
  *
  * @example
  * ```typescript
  * const executor = new ProcessJobExecutor({
- *   entrypointPath: "./src/workflow-job.ts",
+ *   entrypointPath: "./src/workflow-run-entrypoint.ts",
  *   env: {
  *     REDIS_URL: "redis://localhost:6379",
  *   },
  * });
  *
- * const manager = new WorkflowJobManager({
+ * const manager = new WorkflowRunManager({
  *   backend,
  *   executor,
  * });

package/esm/src/workflow/worker/executors/types.d.ts

@@ -1,7 +1,8 @@
 /**
- * Job Executor Interface
+ * Job executor interface
  *
- * Abstraction layer for executing workflow jobs in isolated environments.
+ * Abstraction layer for executing job-backed workflow runs in isolated
+ * environments.
  * Implementations can target different runtimes:
  * - K8s Jobs
  * - Docker containers
@@ -54,7 +55,7 @@ export interface JobInfo {
 /**
  * Job Executor Interface
  *
- * Abstracts the runtime environment for executing workflow jobs.
+ * Abstracts the runtime environment for executing job-backed workflow runs.
  * Each implementation handles the specifics of its target platform.
  *
  * @example K8s
@@ -83,7 +84,7 @@ export interface JobInfo {
  */
 export interface JobExecutor {
     /**
-     * Create and start a job for a workflow run
+     * Create and start a job for a workflow run.
      * @returns Job ID
      */
     createJob(config: JobConfig): Promise<string>;

package/esm/src/workflow/worker/executors/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,GAAG,EAAE,WAAW,CAAC;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,qBAAqB;IACrB,MAAM,EAAE,SAAS,CAAC;IAElB,2BAA2B;IAC3B,SAAS,EAAE,IAAI,CAAC;IAEhB,iCAAiC;IACjC,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEhD;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;OAGG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAS9D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/src/workflow/worker/executors/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,GAAG,EAAE,WAAW,CAAC;IAEjB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,qBAAqB;IACrB,MAAM,EAAE,SAAS,CAAC;IAElB,2BAA2B;IAC3B,SAAS,EAAE,IAAI,CAAC;IAEhB,iCAAiC;IACjC,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,IAAI,CAAC;IAEnB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAEhD;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;OAGG;IACH,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAS9D"}

package/esm/src/workflow/worker/executors/types.js

@@ -1,7 +1,8 @@
 /**
- * Job Executor Interface
+ * Job executor interface
  *
- * Abstraction layer for executing workflow jobs in isolated environments.
+ * Abstraction layer for executing job-backed workflow runs in isolated
+ * environments.
  * Implementations can target different runtimes:
  * - K8s Jobs
  * - Docker containers

package/esm/src/workflow/worker/index.d.ts

@@ -1,29 +1,32 @@
 /**
- * Workflow Worker Module
+ * Workflow worker module
  *
  * Provides distributed workflow execution support.
  *
- * Three modes available:
+ * Three execution profiles are available:
  *
  * 1. **WorkflowWorker** - In-process polling worker
  *    - Polls for stalled workflows and resumes them
  *    - Good for trusted code or single-tenant deployments
  *    - Simple setup, lower overhead
  *
- * 2. **WorkflowJobManager + K8sJobExecutor** - Kubernetes Job-based execution
+ * 2. **WorkflowRunManager + K8sJobExecutor** - Kubernetes Job-backed execution
  *    - Each workflow runs in an ephemeral container
  *    - Complete tenant isolation (no shared state)
  *    - Required for multi-tenant untrusted code execution
  *
- * 3. **WorkflowJobManager + ProcessJobExecutor** - Local process execution
+ * 3. **WorkflowRunManager + ProcessJobExecutor** - Local process execution
  *    - Spawns child processes for each workflow
  *    - Good for local development without K8s/Docker
  *    - Mirrors production behavior
+ *
+ * A workflow run can be backed by a job executor without introducing another
+ * user-visible execution type.
  */
 import "../../../_dnt.polyfills.js";
 export { createWorkflowWorker, type WorkerStats, type WorkerStatus, WorkflowWorker, type WorkflowWorkerConfig, } from "./workflow-worker.js";
-export { createWorkflowJobManager, type ManagerStats, type ManagerStatus, WorkflowJobManager, type WorkflowJobManagerConfig, } from "./job-manager.js";
+export { createWorkflowRunManager, type ManagerStats, type ManagerStatus, WorkflowRunManager, type WorkflowRunManagerConfig, } from "./job-manager.js";
 export { isJobExecutor, type JobConfig, type JobExecutor, type JobInfo, type JobStatus, type K8sClient, K8sJobExecutor, type K8sJobExecutorConfig, type K8sJobSpec, type K8sJobStatusResponse, ProcessJobExecutor, type ProcessJobExecutorConfig, } from "./executors/index.js";
-export { createJobEntrypoint, type CreateJobEntrypointOptions, EXIT_CODES, type JobEntrypointConfig, runWorkflowJob, } from "./job-entrypoint.js";
-export { createDynamicJobEntrypoint, type CreateDynamicJobEntrypointOptions, DYNAMIC_EXIT_CODES, type DynamicJobEntrypointConfig, runDynamicWorkflowJob, } from "./dynamic-job-entrypoint.js";
+export { createWorkflowRunEntrypoint, type CreateWorkflowRunEntrypointOptions, EXIT_CODES, runWorkflowRun, type WorkflowRunEntrypointConfig, } from "./job-entrypoint.js";
+export { createDynamicWorkflowRunEntrypoint, type CreateDynamicWorkflowRunEntrypointOptions, DYNAMIC_EXIT_CODES, type DynamicWorkflowRunEntrypointConfig, runDynamicWorkflowRun, } from "./dynamic-job-entrypoint.js";
 //# sourceMappingURL=index.d.ts.map

package/esm/src/workflow/worker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,4BAA4B,CAAC;AAEpC,OAAO,EACL,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,UAAU,EACV,KAAK,mBAAmB,EACxB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,0BAA0B,EAC1B,KAAK,iCAAiC,EACtC,kBAAkB,EAClB,KAAK,0BAA0B,EAC/B,qBAAqB,GACtB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,4BAA4B,CAAC;AAEpC,OAAO,EACL,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,wBAAwB,EACxB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EACL,2BAA2B,EAC3B,KAAK,kCAAkC,EACvC,UAAU,EACV,cAAc,EACd,KAAK,2BAA2B,GACjC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EACL,kCAAkC,EAClC,KAAK,yCAAyC,EAC9C,kBAAkB,EAClB,KAAK,kCAAkC,EACvC,qBAAqB,GACtB,MAAM,6BAA6B,CAAC"}

package/esm/src/workflow/worker/index.js

@@ -1,35 +1,38 @@
 /**
- * Workflow Worker Module
+ * Workflow worker module
  *
  * Provides distributed workflow execution support.
  *
- * Three modes available:
+ * Three execution profiles are available:
  *
  * 1. **WorkflowWorker** - In-process polling worker
  *    - Polls for stalled workflows and resumes them
  *    - Good for trusted code or single-tenant deployments
  *    - Simple setup, lower overhead
  *
- * 2. **WorkflowJobManager + K8sJobExecutor** - Kubernetes Job-based execution
+ * 2. **WorkflowRunManager + K8sJobExecutor** - Kubernetes Job-backed execution
  *    - Each workflow runs in an ephemeral container
  *    - Complete tenant isolation (no shared state)
  *    - Required for multi-tenant untrusted code execution
  *
- * 3. **WorkflowJobManager + ProcessJobExecutor** - Local process execution
+ * 3. **WorkflowRunManager + ProcessJobExecutor** - Local process execution
  *    - Spawns child processes for each workflow
  *    - Good for local development without K8s/Docker
  *    - Mirrors production behavior
+ *
+ * A workflow run can be backed by a job executor without introducing another
+ * user-visible execution type.
  */
 // In-process worker (single-tenant / trusted code)
 import "../../../_dnt.polyfills.js";
 export { createWorkflowWorker, WorkflowWorker, } from "./workflow-worker.js";
-// Job-based execution (multi-tenant / untrusted code)
-export { createWorkflowJobManager, WorkflowJobManager, } from "./job-manager.js";
+// Job-backed workflow run execution (multi-tenant / untrusted code)
+export { createWorkflowRunManager, WorkflowRunManager, } from "./job-manager.js";
 // Job Executors (pluggable runtime backends)
 export { isJobExecutor, K8sJobExecutor, ProcessJobExecutor, } from "./executors/index.js";
-// Job entrypoint (runs inside ephemeral container/process)
+// Workflow run entrypoint (runs inside ephemeral container/process)
 // Use this when workflows are pre-bundled in the container
-export { createJobEntrypoint, EXIT_CODES, runWorkflowJob, } from "./job-entrypoint.js";
-// Dynamic job entrypoint (discovers workflows at runtime)
+export { createWorkflowRunEntrypoint, EXIT_CODES, runWorkflowRun, } from "./job-entrypoint.js";
+// Dynamic workflow run entrypoint (discovers workflows at runtime)
 // Use this when workflows are stored in Veryfront API
-export { createDynamicJobEntrypoint, DYNAMIC_EXIT_CODES, runDynamicWorkflowJob, } from "./dynamic-job-entrypoint.js";
+export { createDynamicWorkflowRunEntrypoint, DYNAMIC_EXIT_CODES, runDynamicWorkflowRun, } from "./dynamic-job-entrypoint.js";

package/esm/src/workflow/worker/job-entrypoint.d.ts

@@ -1,5 +1,5 @@
 /**
- * Workflow Job Entrypoint
+ * Workflow run entrypoint
  *
  * Runs inside an ephemeral K8s Job container.
  * Executes a single workflow run in complete isolation.
@@ -23,9 +23,9 @@ import type { WorkflowBackend } from "../backends/types.js";
 import type { WorkflowExecutor } from "../executor/workflow-executor.js";
 import type { WorkflowDefinition } from "../types.js";
 /**
- * Configuration for the job entrypoint
+ * Configuration for the workflow run entrypoint.
  */
-export interface JobEntrypointConfig {
+export interface WorkflowRunEntrypointConfig {
     /** Backend for workflow persistence */
     backend: WorkflowBackend;
     /** Workflow executor */
@@ -34,7 +34,7 @@ export interface JobEntrypointConfig {
     debug?: boolean;
 }
 /**
- * Exit codes for the job
+ * Exit codes for the workflow run entrypoint.
  */
 export declare const EXIT_CODES: {
     readonly SUCCESS: 0;
@@ -43,17 +43,17 @@ export declare const EXIT_CODES: {
     readonly NOT_FOUND: 3;
 };
 /**
- * Run the workflow job
+ * Run the workflow run entrypoint
  *
  * This function is the main entrypoint for workflow execution in a K8s Job.
  * It should be called from your container's main script.
  *
  * @example
  * ```typescript
- * // job-main.ts - Container entrypoint
+ * // workflow-runner.ts - Container entrypoint
  * import { RedisBackend } from "veryfront/workflow";
  * import { WorkflowExecutor } from "veryfront/workflow";
- * import { runWorkflowJob } from "veryfront/workflow/worker";
+ * import { runWorkflowRun } from "veryfront/workflow/worker";
  * import { workflows } from "./workflows.ts";
  *
  * const backend = new RedisBackend({ url: Deno.env.get("REDIS_URL")! });
@@ -64,25 +64,25 @@ export declare const EXIT_CODES: {
  *   executor.register(wf);
  * }
  *
- * // Run the job
- * const exitCode = await runWorkflowJob({ backend, executor });
+ * // Run the workflow run
+ * const exitCode = await runWorkflowRun({ backend, executor });
  * Deno.exit(exitCode);
  * ```
  */
-export declare function runWorkflowJob(config: JobEntrypointConfig): Promise<number>;
+export declare function runWorkflowRun(config: WorkflowRunEntrypointConfig): Promise<number>;
 /**
- * Create a simple job entrypoint script
+ * Create a simple workflow run entrypoint script.
  *
  * This is a convenience function that creates the entire entrypoint
  * with Redis backend and executor setup.
  *
  * @example
  * ```typescript
- * // job-main.ts
- * import { createJobEntrypoint } from "veryfront/workflow/worker";
+ * // workflow-runner.ts
+ * import { createWorkflowRunEntrypoint } from "veryfront/workflow/worker";
  * import { workflows } from "./workflows.ts";
  *
- * const run = createJobEntrypoint({
+ * const run = createWorkflowRunEntrypoint({
  *   redisUrl: Deno.env.get("REDIS_URL")!,
  *   workflows,
  * });
@@ -91,7 +91,7 @@ export declare function runWorkflowJob(config: JobEntrypointConfig): Promise<num
  * Deno.exit(exitCode);
  * ```
  */
-export interface CreateJobEntrypointOptions {
+export interface CreateWorkflowRunEntrypointOptions {
     /** Redis URL for backend */
     redisUrl: string;
     /** Workflows to register */
@@ -101,6 +101,6 @@ export interface CreateJobEntrypointOptions {
     /** Enable debug logging */
     debug?: boolean;
 }
-/** Create job entrypoint. */
-export declare function createJobEntrypoint(options: CreateJobEntrypointOptions): Promise<() => Promise<number>>;
+/** Create a workflow run entrypoint. */
+export declare function createWorkflowRunEntrypoint(options: CreateWorkflowRunEntrypointOptions): Promise<() => Promise<number>>;
 //# sourceMappingURL=job-entrypoint.d.ts.map

package/esm/src/workflow/worker/job-entrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-entrypoint.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/worker/job-entrypoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAWtD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,OAAO,EAAE,eAAe,CAAC;IAEzB,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAE3B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgEjF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,0BAA0B;IACzC,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,SAAS,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IAErD,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,6BAA6B;AAC7B,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CA0BhC"}
+{"version":3,"file":"job-entrypoint.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/worker/job-entrypoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAWtD;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,uCAAuC;IACvC,OAAO,EAAE,eAAe,CAAC;IAEzB,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAE3B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAgEzF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,kCAAkC;IACjD,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,SAAS,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;IAErD,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wCAAwC;AACxC,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CA0BhC"}

package/esm/src/workflow/worker/job-entrypoint.js

@@ -1,5 +1,5 @@
 /**
- * Workflow Job Entrypoint
+ * Workflow run entrypoint
  *
  * Runs inside an ephemeral K8s Job container.
  * Executes a single workflow run in complete isolation.
@@ -22,9 +22,9 @@
 import { logger as baseLogger } from "../../utils/index.js";
 import { getEnv } from "../../platform/compat/process.js";
 import { failRunExecution, getFinalRunExitCode, getTenantFromEnv, hydrateRunContextEnv, runWithTenantContext, } from "./shared.js";
-const logger = baseLogger.component("workflow-job");
+const logger = baseLogger.component("workflow-run-entrypoint");
 /**
- * Exit codes for the job
+ * Exit codes for the workflow run entrypoint.
  */
 export const EXIT_CODES = {
     SUCCESS: 0,
@@ -33,17 +33,17 @@ export const EXIT_CODES = {
     NOT_FOUND: 3,
 };
 /**
- * Run the workflow job
+ * Run the workflow run entrypoint
  *
  * This function is the main entrypoint for workflow execution in a K8s Job.
  * It should be called from your container's main script.
  *
  * @example
  * ```typescript
- * // job-main.ts - Container entrypoint
+ * // workflow-runner.ts - Container entrypoint
  * import { RedisBackend } from "veryfront/workflow";
  * import { WorkflowExecutor } from "veryfront/workflow";
- * import { runWorkflowJob } from "veryfront/workflow/worker";
+ * import { runWorkflowRun } from "veryfront/workflow/worker";
  * import { workflows } from "./workflows.ts";
  *
  * const backend = new RedisBackend({ url: Deno.env.get("REDIS_URL")! });
@@ -54,12 +54,12 @@ export const EXIT_CODES = {
  *   executor.register(wf);
  * }
  *
- * // Run the job
- * const exitCode = await runWorkflowJob({ backend, executor });
+ * // Run the workflow run
+ * const exitCode = await runWorkflowRun({ backend, executor });
  * Deno.exit(exitCode);
  * ```
  */
-export async function runWorkflowJob(config) {
+export async function runWorkflowRun(config) {
     const { backend, executor, debug = false } = config;
     // Get workflow run ID from environment
     const runId = getEnv("WORKFLOW_RUN_ID");
@@ -109,8 +109,8 @@ export async function runWorkflowJob(config) {
         return EXIT_CODES.WORKFLOW_FAILED;
     }
 }
-/** Create job entrypoint. */
-export async function createJobEntrypoint(options) {
+/** Create a workflow run entrypoint. */
+export async function createWorkflowRunEntrypoint(options) {
     // Dynamic imports to avoid loading Redis if not needed
     const { RedisBackend } = await import("../backends/redis.js");
     const { WorkflowExecutor } = await import("../executor/workflow-executor.js");
@@ -126,7 +126,7 @@ export async function createJobEntrypoint(options) {
     for (const wf of options.workflows) {
         executor.register(wf.definition);
     }
-    return () => runWorkflowJob({
+    return () => runWorkflowRun({
         backend,
         executor,
         debug: options.debug,

package/esm/src/workflow/worker/job-manager.d.ts

@@ -2,9 +2,9 @@ import { type WorkflowBackend } from "../backends/types.js";
 import type { JobExecutor, JobStatus } from "./executors/types.js";
 export type { JobExecutor, JobInfo, JobStatus } from "./executors/types.js";
 /**
- * Configuration for the Workflow Job Manager
+ * Configuration for the workflow run manager backed by job executors.
  */
-export interface WorkflowJobManagerConfig {
+export interface WorkflowRunManagerConfig {
     /** Backend for workflow persistence */
     backend: WorkflowBackend;
     /** Job executor (K8s, Docker, Process, etc.) */
@@ -52,7 +52,7 @@ interface TrackedJob {
     createdAt: Date;
 }
 /**
- * Workflow Job Manager
+ * Workflow run manager
  *
  * Orchestrates workflow execution via pluggable job executors.
  * Each workflow runs in complete isolation.
@@ -64,7 +64,7 @@ interface TrackedJob {
  *   namespace: "workflows",
  * }, k8sClient);
  *
- * const manager = new WorkflowJobManager({
+ * const manager = new WorkflowRunManager({
  *   backend: redisBackend,
  *   executor,
  * });
@@ -78,7 +78,7 @@ interface TrackedJob {
  *   entrypointPath: "./job-entrypoint.ts",
  * });
  *
- * const manager = new WorkflowJobManager({
+ * const manager = new WorkflowRunManager({
  *   backend: redisBackend,
  *   executor,
  * });
@@ -86,20 +86,20 @@ interface TrackedJob {
  * manager.start();
  * ```
  */
-export declare class WorkflowJobManager {
+export declare class WorkflowRunManager {
     private config;
     private status;
     private pollTimeout?;
     private activeJobs;
     private stats;
     private managerId;
-    constructor(config: WorkflowJobManagerConfig);
+    constructor(config: WorkflowRunManagerConfig);
     /**
-     * Start the job manager
+     * Start the workflow run manager.
      */
     start(): Promise<void>;
     /**
-     * Stop the job manager gracefully
+     * Stop the workflow run manager gracefully.
      */
     stop(): Promise<void>;
     /**
@@ -136,7 +136,7 @@ export declare class WorkflowJobManager {
     private recordError;
 }
 /**
- * Create a workflow job manager
+ * Create a workflow run manager backed by job executors.
  */
-export declare function createWorkflowJobManager(config: WorkflowJobManagerConfig): WorkflowJobManager;
+export declare function createWorkflowRunManager(config: WorkflowRunManagerConfig): WorkflowRunManager;
 //# sourceMappingURL=job-manager.d.ts.map

package/esm/src/workflow/worker/job-manager.js

@@ -1,7 +1,7 @@
 /**
- * Workflow Job Manager
+ * Workflow run manager
  *
- * Orchestrates workflow execution via isolated jobs.
+ * Orchestrates workflow run execution via isolated jobs.
  * Uses pluggable JobExecutor interface for runtime flexibility.
  *
  * Supported runtimes:
@@ -19,7 +19,7 @@ import { logger as baseLogger } from "../../utils/index.js";
 import { hasLockSupport, hasWorkerSupport } from "../backends/types.js";
 import { generateId } from "../types.js";
 import { ORCHESTRATION_ERROR } from "../../errors/index.js";
-const logger = baseLogger.component("workflow-job-manager");
+const logger = baseLogger.component("workflow-run-manager");
 /** Default interval between poll cycles */
 const DEFAULT_POLL_INTERVAL_MS = 5_000;
 /** Default timeout for a single job (30 minutes) */
@@ -27,7 +27,7 @@ const DEFAULT_JOB_TIMEOUT_MS = 30 * 60 * 1_000;
 /** Default threshold after which a run is considered stalled */
 const DEFAULT_STALLED_THRESHOLD_MS = 60_000;
 /**
- * Workflow Job Manager
+ * Workflow run manager
  *
  * Orchestrates workflow execution via pluggable job executors.
  * Each workflow runs in complete isolation.
@@ -39,7 +39,7 @@ const DEFAULT_STALLED_THRESHOLD_MS = 60_000;
  *   namespace: "workflows",
  * }, k8sClient);
  *
- * const manager = new WorkflowJobManager({
+ * const manager = new WorkflowRunManager({
  *   backend: redisBackend,
  *   executor,
  * });
@@ -53,7 +53,7 @@ const DEFAULT_STALLED_THRESHOLD_MS = 60_000;
  *   entrypointPath: "./job-entrypoint.ts",
  * });
  *
- * const manager = new WorkflowJobManager({
+ * const manager = new WorkflowRunManager({
  *   backend: redisBackend,
  *   executor,
  * });
@@ -61,7 +61,7 @@ const DEFAULT_STALLED_THRESHOLD_MS = 60_000;
  * manager.start();
  * ```
  */
-export class WorkflowJobManager {
+export class WorkflowRunManager {
     config;
     status = "idle";
     pollTimeout;
@@ -89,11 +89,11 @@ export class WorkflowJobManager {
         };
     }
     /**
-     * Start the job manager
+     * Start the workflow run manager.
      */
     async start() {
         if (this.status === "running") {
-            throw ORCHESTRATION_ERROR.create({ detail: "Job manager is already running" });
+            throw ORCHESTRATION_ERROR.create({ detail: "Workflow run manager is already running" });
         }
         // Initialize executor if needed
         if (this.config.executor.initialize) {
@@ -109,7 +109,7 @@ export class WorkflowJobManager {
         this.scheduleNextPoll();
     }
     /**
-     * Stop the job manager gracefully
+     * Stop the workflow run manager gracefully.
      */
     async stop() {
         if (this.status !== "running") {
@@ -192,7 +192,7 @@ export class WorkflowJobManager {
             if (hasWorkerSupport(this.config.backend)) {
                 stalledRuns = await this.config.backend.findStalledRuns(this.config.stalledThreshold);
                 if (stalledRuns.length > 0 && this.config.debug) {
-                    logger.info(`[WorkflowJobManager] Found ${stalledRuns.length} stalled runs to recover`);
+                    logger.info(`[WorkflowRunManager] Found ${stalledRuns.length} stalled runs to recover`);
                 }
             }
             // Combine pending and stalled runs
@@ -238,7 +238,7 @@ export class WorkflowJobManager {
                             await this.config.backend.releaseLock?.(run.id);
                         }
                         catch (error) {
-                            logger.warn(`[WorkflowJobManager] Failed to release pending lock for ${run.id}:`, error);
+                            logger.warn(`[WorkflowRunManager] Failed to release pending lock for ${run.id}:`, error);
                         }
                     }
                 }
@@ -275,7 +275,7 @@ export class WorkflowJobManager {
                     }
                     else {
                         this.stats.jobsFailed++;
-                        logger.error(`[WorkflowJobManager] Job failed: ${jobInfo.jobId}`, jobInfo.error);
+                        logger.error(`[WorkflowRunManager] Job failed: ${jobInfo.jobId}`, jobInfo.error);
                     }
                 }
             }
@@ -339,8 +339,8 @@ export class WorkflowJobManager {
     }
 }
 /**
- * Create a workflow job manager
+ * Create a workflow run manager backed by job executors.
  */
-export function createWorkflowJobManager(config) {
-    return new WorkflowJobManager(config);
+export function createWorkflowRunManager(config) {
+    return new WorkflowRunManager(config);
 }