veryfront 0.1.563 → 0.1.565

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);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.563",
+  "version": "0.1.565",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",