veryfront 0.1.623 → 0.1.625

package/esm/src/workflow/worker/{job-manager.d.ts → run-manager.d.ts}

@@ -1,22 +1,22 @@
 import { type WorkflowBackend } from "../backends/types.js";
-import type { JobExecutor, JobStatus } from "./executors/types.js";
-export type { JobExecutor, JobInfo, JobStatus } from "./executors/types.js";
+import type { RunExecutionStatus, RunExecutor } from "./executors/types.js";
+export type { RunExecutionInfo, RunExecutionStatus, RunExecutor } from "./executors/types.js";
 /**
- * Configuration for the workflow run manager backed by job executors.
+ * Configuration for the workflow run manager backed by run executors.
  */
 export interface WorkflowRunManagerConfig {
     /** Backend for workflow persistence */
     backend: WorkflowBackend;
-    /** Job executor (K8s, Docker, Process, etc.) */
-    executor: JobExecutor;
-    /** Environment variables to inject into jobs */
+    /** Run executor (Kubernetes, Docker, Process, etc.) */
+    executor: RunExecutor;
+    /** Environment variables to inject into run executions */
     env?: Record<string, string>;
     /** Poll interval for checking pending workflows (ms) */
     pollInterval?: number;
-    /** Maximum concurrent jobs */
-    maxConcurrentJobs?: number;
-    /** Job timeout (ms) - kills job if it exceeds this */
-    jobTimeout?: number;
+    /** Maximum concurrent run executions */
+    maxConcurrentExecutions?: number;
+    /** Run timeout (ms) - kills execution if it exceeds this */
+    executionTimeout?: number;
     /** Time after which a run is considered stalled (ms) - for crash recovery */
     stalledThreshold?: number;
     /** Enable debug logging */
@@ -34,32 +34,32 @@ export interface ManagerStats {
     managerId: string;
     startedAt?: Date;
     pollCount: number;
-    jobsCreated: number;
-    jobsCompleted: number;
-    jobsFailed: number;
-    activeJobs: number;
+    executionsCreated: number;
+    executionsCompleted: number;
+    executionsFailed: number;
+    activeExecutions: number;
     lastPollAt?: Date;
     lastErrorAt?: Date;
     lastError?: string;
 }
 /**
- * Internal job tracking
+ * Internal run execution tracking
  */
-interface TrackedJob {
-    jobId: string;
+interface TrackedExecution {
+    executionId: string;
     runId: string;
-    status: JobStatus;
+    status: RunExecutionStatus;
     createdAt: Date;
 }
 /**
  * Workflow run manager
  *
- * Orchestrates workflow execution via pluggable job executors.
+ * Orchestrates workflow execution via pluggable run executors.
  * Each workflow runs in complete isolation.
  *
  * @example K8s
  * ```typescript
- * const executor = new K8sJobExecutor({
+ * const executor = new K8sRunExecutor({
  *   image: "my-app:latest",
  *   namespace: "workflows",
  * }, k8sClient);
@@ -74,8 +74,8 @@ interface TrackedJob {
  *
  * @example Local Process
  * ```typescript
- * const executor = new ProcessJobExecutor({
- *   entrypointPath: "./job-entrypoint.ts",
+ * const executor = new ProcessRunExecutor({
+ *   entrypointPath: "./workflow-run.ts",
  * });
  *
  * const manager = new WorkflowRunManager({
@@ -90,7 +90,7 @@ export declare class WorkflowRunManager {
     private config;
     private status;
     private pollTimeout?;
-    private activeJobs;
+    private activeExecutions;
     private stats;
     private managerId;
     constructor(config: WorkflowRunManagerConfig);
@@ -107,9 +107,9 @@ export declare class WorkflowRunManager {
      */
     getStats(): ManagerStats;
     /**
-     * Get active jobs
+     * Get active executions
      */
-    getActiveJobs(): TrackedJob[];
+    getActiveExecutions(): TrackedExecution[];
     /**
      * Get manager ID
      */
@@ -119,24 +119,24 @@ export declare class WorkflowRunManager {
      */
     private scheduleNextPoll;
     /**
-     * Poll for pending workflows and manage jobs
+     * Poll for pending workflows and manage run executions
      */
     private poll;
     /**
-     * Sync job statuses with executor
+     * Sync run execution statuses with executor
      */
-    private syncJobStatuses;
+    private syncRunExecutionStatuses;
     /**
-     * Create a job for a workflow run
+     * Create an isolated execution for a workflow run
      */
-    private createJobForWorkflow;
+    private createExecutionForWorkflow;
     /**
      * Record an error in stats
      */
     private recordError;
 }
 /**
- * Create a workflow run manager backed by job executors.
+ * Create a workflow run manager backed by run executors.
  */
 export declare function createWorkflowRunManager(config: WorkflowRunManagerConfig): WorkflowRunManager;
-//# sourceMappingURL=job-manager.d.ts.map
+//# sourceMappingURL=run-manager.d.ts.map

package/esm/src/workflow/worker/run-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-manager.d.ts","sourceRoot":"","sources":["../../../../src/src/workflow/worker/run-manager.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAoC,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9F,OAAO,KAAK,EAAsB,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAehG,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uCAAuC;IACvC,OAAO,EAAE,eAAe,CAAC;IAEzB,uDAAuD;IACvD,QAAQ,EAAE,WAAW,CAAC;IAEtB,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,wCAAwC;IACxC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,IAAI,CAAC;CACjB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,WAAW,CAAC,CAAwC;IAC5D,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,wBAAwB;IAuB5C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B3B;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,EAAE;IAIzC;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;YACW,IAAI;IAyGlB;;OAEG;YACW,wBAAwB;IAuCtC;;OAEG;YACW,0BAA0B;IAoDxC;;OAEG;IACH,OAAO,CAAC,WAAW;CAIpB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,kBAAkB,CAEpB"}

package/esm/src/workflow/worker/{job-manager.js → run-manager.js}

@@ -1,18 +1,18 @@
 /**
  * Workflow run manager
  *
- * Orchestrates workflow run execution via isolated jobs.
- * Uses pluggable JobExecutor interface for runtime flexibility.
+ * Orchestrates workflow run execution via isolated run executors.
+ * Uses pluggable RunExecutor interface for runtime flexibility.
  *
  * Supported runtimes:
- * - K8sJobExecutor: Kubernetes Jobs (production)
- * - ProcessJobExecutor: Child processes (local dev)
- * - DockerJobExecutor: Docker containers (future)
+ * - K8sRunExecutor: Kubernetes Job adapter (production)
+ * - ProcessRunExecutor: Child processes (local dev)
+ * - DockerRunExecutor: Docker containers (future)
  *
  * Key properties:
  * - Each workflow runs in isolation (no shared state)
- * - Supports crash recovery via stalled job detection
- * - Runtime-agnostic through JobExecutor abstraction
+ * - Supports crash recovery via stalled execution detection
+ * - Runtime-agnostic through RunExecutor abstraction
  */
 import * as dntShim from "../../../_dnt.shims.js";
 import { logger as baseLogger } from "../../utils/index.js";
@@ -22,19 +22,19 @@ import { ORCHESTRATION_ERROR } from "../../errors/index.js";
 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) */
-const DEFAULT_JOB_TIMEOUT_MS = 30 * 60 * 1_000;
+/** Default timeout for a single run execution (30 minutes) */
+const DEFAULT_EXECUTION_TIMEOUT_MS = 30 * 60 * 1_000;
 /** Default threshold after which a run is considered stalled */
 const DEFAULT_STALLED_THRESHOLD_MS = 60_000;
 /**
  * Workflow run manager
  *
- * Orchestrates workflow execution via pluggable job executors.
+ * Orchestrates workflow execution via pluggable run executors.
  * Each workflow runs in complete isolation.
  *
  * @example K8s
  * ```typescript
- * const executor = new K8sJobExecutor({
+ * const executor = new K8sRunExecutor({
  *   image: "my-app:latest",
  *   namespace: "workflows",
  * }, k8sClient);
@@ -49,8 +49,8 @@ const DEFAULT_STALLED_THRESHOLD_MS = 60_000;
  *
  * @example Local Process
  * ```typescript
- * const executor = new ProcessJobExecutor({
- *   entrypointPath: "./job-entrypoint.ts",
+ * const executor = new ProcessRunExecutor({
+ *   entrypointPath: "./workflow-run.ts",
  * });
  *
  * const manager = new WorkflowRunManager({
@@ -65,15 +65,15 @@ export class WorkflowRunManager {
     config;
     status = "idle";
     pollTimeout;
-    activeJobs = new Map();
+    activeExecutions = new Map();
     stats;
     managerId;
     constructor(config) {
         this.managerId = generateId("mgr");
         this.config = {
             pollInterval: DEFAULT_POLL_INTERVAL_MS,
-            maxConcurrentJobs: 10,
-            jobTimeout: DEFAULT_JOB_TIMEOUT_MS,
+            maxConcurrentExecutions: 10,
+            executionTimeout: DEFAULT_EXECUTION_TIMEOUT_MS,
             stalledThreshold: DEFAULT_STALLED_THRESHOLD_MS,
             debug: false,
             ...config,
@@ -82,10 +82,10 @@ export class WorkflowRunManager {
             status: "idle",
             managerId: this.managerId,
             pollCount: 0,
-            jobsCreated: 0,
-            jobsCompleted: 0,
-            jobsFailed: 0,
-            activeJobs: 0,
+            executionsCreated: 0,
+            executionsCompleted: 0,
+            executionsFailed: 0,
+            activeExecutions: 0,
         };
     }
     /**
@@ -139,13 +139,13 @@ export class WorkflowRunManager {
      * Get manager statistics
      */
     getStats() {
-        return { ...this.stats, activeJobs: this.activeJobs.size };
+        return { ...this.stats, activeExecutions: this.activeExecutions.size };
     }
     /**
-     * Get active jobs
+     * Get active executions
      */
-    getActiveJobs() {
-        return Array.from(this.activeJobs.values());
+    getActiveExecutions() {
+        return Array.from(this.activeExecutions.values());
     }
     /**
      * Get manager ID
@@ -166,7 +166,7 @@ export class WorkflowRunManager {
         }, this.config.pollInterval);
     }
     /**
-     * Poll for pending workflows and manage jobs
+     * Poll for pending workflows and manage run executions
      */
     async poll() {
         if (this.status !== "running") {
@@ -175,10 +175,10 @@ export class WorkflowRunManager {
         this.stats.pollCount++;
         this.stats.lastPollAt = new Date();
         try {
-            // 1. Check status of active jobs
-            await this.syncJobStatuses();
+            // 1. Check status of active executions
+            await this.syncRunExecutionStatuses();
             // 2. Find workflows that need execution
-            const availableSlots = this.config.maxConcurrentJobs - this.activeJobs.size;
+            const availableSlots = this.config.maxConcurrentExecutions - this.activeExecutions.size;
             if (availableSlots <= 0) {
                 return;
             }
@@ -187,7 +187,7 @@ export class WorkflowRunManager {
                 status: "pending",
                 limit: availableSlots,
             });
-            // Also check for stalled workflows (crashed jobs)
+            // Also check for stalled workflows (crashed run executions)
             let stalledRuns = [];
             if (hasWorkerSupport(this.config.backend)) {
                 stalledRuns = await this.config.backend.findStalledRuns(this.config.stalledThreshold);
@@ -198,8 +198,8 @@ export class WorkflowRunManager {
             // Combine pending and stalled runs
             const runsToProcess = [...pendingRuns, ...stalledRuns].slice(0, availableSlots);
             for (const run of runsToProcess) {
-                // Skip if already has an active job
-                if (this.activeJobs.has(run.id)) {
+                // Skip if already has an active execution
+                if (this.activeExecutions.has(run.id)) {
                     continue;
                 }
                 let pendingLockAcquired = false;
@@ -213,7 +213,7 @@ export class WorkflowRunManager {
                             continue;
                         }
                     }
-                    // For pending runs, acquire a short lock to avoid duplicate job creation
+                    // For pending runs, acquire a short lock to avoid duplicate execution creation
                     // across managers between listRuns() and updateRun().
                     if (run.status === "pending" && hasLockSupport(this.config.backend)) {
                         pendingLockAcquired = await this.config.backend.acquireLock(run.id, this.config.stalledThreshold);
@@ -230,7 +230,7 @@ export class WorkflowRunManager {
                     if (!runToProcess) {
                         continue;
                     }
-                    await this.createJobForWorkflow(runToProcess);
+                    await this.createExecutionForWorkflow(runToProcess);
                 }
                 finally {
                     if (pendingLockAcquired) {
@@ -250,81 +250,81 @@ export class WorkflowRunManager {
         }
     }
     /**
-     * Sync job statuses with executor
+     * Sync run execution statuses with executor
      */
-    async syncJobStatuses() {
+    async syncRunExecutionStatuses() {
         try {
-            const jobs = await this.config.executor.listJobs(this.managerId);
-            for (const jobInfo of jobs) {
-                const tracked = this.activeJobs.get(jobInfo.runId);
+            const executions = await this.config.executor.listRunExecutions(this.managerId);
+            for (const executionInfo of executions) {
+                const tracked = this.activeExecutions.get(executionInfo.runId);
                 if (!tracked) {
                     continue;
                 }
-                if (jobInfo.status === tracked.status) {
+                if (executionInfo.status === tracked.status) {
                     continue;
                 }
-                tracked.status = jobInfo.status;
+                tracked.status = executionInfo.status;
                 // Handle terminal states
-                if (jobInfo.status === "succeeded" || jobInfo.status === "failed") {
-                    this.activeJobs.delete(jobInfo.runId);
-                    if (jobInfo.status === "succeeded") {
-                        this.stats.jobsCompleted++;
+                if (executionInfo.status === "succeeded" || executionInfo.status === "failed") {
+                    this.activeExecutions.delete(executionInfo.runId);
+                    if (executionInfo.status === "succeeded") {
+                        this.stats.executionsCompleted++;
                         if (this.config.debug) {
-                            logger.info(`Job completed: ${jobInfo.jobId}`);
+                            logger.info(`Run execution completed: ${executionInfo.executionId}`);
                         }
                     }
                     else {
-                        this.stats.jobsFailed++;
-                        logger.error(`[WorkflowRunManager] Job failed: ${jobInfo.jobId}`, jobInfo.error);
+                        this.stats.executionsFailed++;
+                        logger.error(`[WorkflowRunManager] Run execution failed: ${executionInfo.executionId}`, executionInfo.error);
                     }
                 }
             }
         }
         catch (error) {
-            logger.error(`Failed to sync job statuses:`, error);
+            logger.error(`Failed to sync run execution statuses:`, error);
         }
     }
     /**
-     * Create a job for a workflow run
+     * Create an isolated execution for a workflow run
      */
-    async createJobForWorkflow(run) {
-        const jobId = generateId("job");
-        const jobConfig = {
-            jobId,
+    async createExecutionForWorkflow(run) {
+        const executionId = generateId("run_exec");
+        const executionConfig = {
+            executionId,
             run,
             managerId: this.managerId,
-            timeout: this.config.jobTimeout,
+            timeout: this.config.executionTimeout,
             env: this.config.env ?? {},
             debug: this.config.debug,
         };
         try {
-            await this.config.executor.createJob(jobConfig);
+            await this.config.executor.createRunExecution(executionConfig);
             const tracked = {
-                jobId,
+                executionId,
                 runId: run.id,
                 status: "pending",
                 createdAt: new Date(),
             };
-            this.activeJobs.set(run.id, tracked);
-            this.stats.jobsCreated++;
+            this.activeExecutions.set(run.id, tracked);
+            this.stats.executionsCreated++;
             // Mark workflow as running
             await this.config.backend.updateRun(run.id, {
                 status: "running",
                 startedAt: new Date(),
                 heartbeatAt: new Date(),
-                workerId: `job:${jobId}`,
+                workerId: `run-execution:${executionId}`,
             });
             if (this.config.debug) {
-                logger.info(`Created job ${jobId} for workflow ${run.id}`);
+                logger.info(`Created run execution ${executionId} for workflow ${run.id}`);
             }
         }
         catch (error) {
-            logger.error(`Failed to create job for ${run.id}:`, error);
+            logger.error(`Failed to create run execution for ${run.id}:`, error);
             // Mark workflow as failed
             await this.config.backend.updateRun(run.id, {
                 status: "failed",
                 error: {
-                    message: `JOB_CREATION_FAILED: Failed to create execution job: ${error instanceof Error ? error.message : String(error)}`,
+                    message: `RUN_EXECUTION_CREATION_FAILED: Failed to create run execution: ${error instanceof Error ? error.message : String(error)}`,
                 },
                 completedAt: new Date(),
             });
@@ -339,7 +339,7 @@ export class WorkflowRunManager {
     }
 }
 /**
- * Create a workflow run manager backed by job executors.
+ * Create a workflow run manager backed by run executors.
  */
 export function createWorkflowRunManager(config) {
     return new WorkflowRunManager(config);

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

@@ -1,7 +1,7 @@
 import { env as getProcessEnv } from "../../platform/compat/process.js";
 import { runWithRequestContext } from "../../platform/adapters/fs/veryfront/multi-project-adapter.js";
 import { getEnv } from "../../platform/compat/process.js";
-import { mergeInjectedWorkflowEnv } from "../../jobs/runtime-env.js";
+import { mergeInjectedWorkflowEnv } from "../../runs/runtime-env.js";
 export function getTenantFromEnv() {
     const projectSlug = getEnv("TENANT_PROJECT_SLUG");
     const token = getEnv("TENANT_TOKEN");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.623",
+  "version": "0.1.625",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -137,9 +137,9 @@
       "import": "./esm/src/resource/index.js",
       "types": "./esm/src/resource/index.d.ts"
     },
-    "./jobs": {
-      "import": "./esm/src/jobs/index.js",
-      "types": "./esm/src/jobs/index.d.ts"
+    "./runs": {
+      "import": "./esm/src/runs/index.js",
+      "types": "./esm/src/runs/index.d.ts"
     },
     "./mcp": {
       "import": "./esm/src/mcp/index.js",

package/esm/cli/commands/knowledge/parser-source.d.ts

@@ -1,2 +0,0 @@
-export declare const knowledgeIngestPythonSource: string;
-//# sourceMappingURL=parser-source.d.ts.map

package/esm/cli/commands/knowledge/parser-source.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parser-source.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/knowledge/parser-source.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,QAgoBvC,CAAC"}