veryfront 0.1.75 → 0.1.77

package/README.md

@@ -18,6 +18,8 @@ Purpose-built for TypeScript and React, Veryfront gives you everything you need
 
 - [**Workflows**](https://veryfront.com/docs/code/guides/workflows) — Orchestrate multi-step AI pipelines with branching, parallelism, and human-in-the-loop approval gates.
 
+- [**Jobs & Cron Jobs**](https://veryfront.com/docs/code/guides/jobs) — Run durable project-scoped background work now or on a schedule through the Veryfront platform.
+
 - [**Multi-Agent**](https://veryfront.com/docs/code/guides/multi-agent) — Compose agents that delegate to each other as tools for complex, coordinated tasks.
 
 - [**Memory & Streaming**](https://veryfront.com/docs/code/guides/memory-and-streaming) — Give agents conversation history and streaming responses. Built-in chat UI components for React.

package/esm/cli/commands/files/command.d.ts

@@ -31,8 +31,8 @@ declare const FilesGetArgsSchema: z.ZodObject<{
     quiet: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     json: boolean;
-    quiet: boolean;
     remotePath: string;
+    quiet: boolean;
     projectSlug?: string | undefined;
     projectDir?: string | undefined;
     output?: string | undefined;
@@ -54,8 +54,8 @@ declare const FilesPutArgsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     json: boolean;
     from: string;
-    quiet: boolean;
     remotePath: string;
+    quiet: boolean;
     projectSlug?: string | undefined;
     projectDir?: string | undefined;
 }, {
@@ -74,8 +74,8 @@ declare const FilesDeleteArgsSchema: z.ZodObject<{
     quiet: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     json: boolean;
-    quiet: boolean;
     remotePath: string;
+    quiet: boolean;
     projectSlug?: string | undefined;
     projectDir?: string | undefined;
 }, {

package/esm/cli/commands/pull/command.js

@@ -89,7 +89,7 @@ export function buildFilesListUrl(projectSlug, source) {
         case "release":
             return `/projects/${projectSlug}/releases/${encodeURIComponent(source.version)}/files`;
         case "branch":
-            return `/projects/${projectSlug}/branches/${encodeURIComponent(source.name)}/files`;
+            return `/projects/${projectSlug}/files?branch=${encodeURIComponent(source.name)}`;
         case "main":
             return `/projects/${projectSlug}/files`;
     }
@@ -127,7 +127,7 @@ export function buildFileContentUrl(projectSlug, path, source) {
         case "release":
             return `/projects/${projectSlug}/releases/${encodeURIComponent(source.version)}/files/${encodedPath}`;
         case "branch":
-            return `/projects/${projectSlug}/branches/${encodeURIComponent(source.name)}/files/${encodedPath}`;
+            return `/projects/${projectSlug}/files/${encodedPath}?branch=${encodeURIComponent(source.name)}`;
         case "main":
             return `/projects/${projectSlug}/files/${encodedPath}`;
     }

package/esm/cli/commands/task/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/task/command.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,WAAY,SAAQ,QAAQ;CAAG;AAEhD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFrE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/task/command.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,WAAY,SAAQ,QAAQ;CAAG;AAEhD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA0FrE"}

package/esm/cli/commands/task/command.js

@@ -7,8 +7,8 @@
 import * as dntShim from "../../../_dnt.shims.js";
 import { cliLogger } from "../../utils/index.js";
 import { exitProcess } from "../../utils/index.js";
+import { withProjectSourceContext } from "../../shared/project-source-context.js";
 export async function taskCommand(options) {
-    const { getAdapter } = await import("../../../src/platform/adapters/detect.js");
     const { discoverTasks } = await import("../../../src/task/discovery.js");
     const { runTask } = await import("../../../src/task/runner.js");
     const taskName = options.name;
@@ -18,62 +18,68 @@ export async function taskCommand(options) {
         return;
     }
     const projectDir = dntShim.Deno.cwd();
-    const adapter = await getAdapter();
-    cliLogger.info(`Discovering tasks in ${projectDir}/tasks/...`);
-    const { tasks, errors } = await discoverTasks({
-        projectDir,
-        adapter,
-        debug: options.debug,
-    });
-    if (errors.length > 0 && options.debug) {
-        for (const err of errors) {
-            cliLogger.warn(`  Warning: ${err.filePath}: ${err.error}`);
-        }
-    }
-    const task = tasks.find((t) => t.id === taskName);
-    if (!task) {
-        cliLogger.error(`Task "${taskName}" not found.`);
-        if (tasks.length > 0) {
-            cliLogger.info("Available tasks:");
-            for (const t of tasks) {
-                cliLogger.info(`  - ${t.id}${t.name !== t.id ? ` (${t.name})` : ""}`);
+    await withProjectSourceContext(projectDir, async ({ adapter, config, projectId, proxyContext }) => {
+        const sourceLabel = proxyContext?.branchRef
+            ? `branch ${proxyContext.branchRef}`
+            : proxyContext
+                ? "main"
+                : `${projectDir}/tasks/...`;
+        cliLogger.info(`Discovering tasks in ${sourceLabel}`);
+        const { tasks, errors } = await discoverTasks({
+            projectDir,
+            adapter,
+            config,
+            debug: options.debug,
+        });
+        if (errors.length > 0 && options.debug) {
+            for (const err of errors) {
+                cliLogger.warn(`  Warning: ${err.filePath}: ${err.error}`);
             }
         }
-        else {
-            cliLogger.info("No tasks found. Create a task file in tasks/ directory:");
-            cliLogger.info("  tasks/my-task.ts");
-        }
-        exitProcess(1);
-        return;
-    }
-    // Parse config JSON if provided
-    let config = {};
-    if (options.config) {
-        try {
-            config = JSON.parse(options.config);
-        }
-        catch {
-            cliLogger.error("Invalid --config JSON");
+        const task = tasks.find((t) => t.id === taskName);
+        if (!task) {
+            cliLogger.error(`Task "${taskName}" not found.`);
+            if (tasks.length > 0) {
+                cliLogger.info("Available tasks:");
+                for (const t of tasks) {
+                    cliLogger.info(`  - ${t.id}${t.name !== t.id ? ` (${t.name})` : ""}`);
+                }
+            }
+            else {
+                cliLogger.info("No tasks found. Create a task file in tasks/ directory:");
+                cliLogger.info("  tasks/my-task.ts");
+            }
             exitProcess(1);
             return;
         }
-    }
-    cliLogger.info(`Running task: ${task.name} (${task.id})`);
-    cliLogger.info("");
-    const result = await runTask({
-        task,
-        config,
-        debug: options.debug,
-    });
-    cliLogger.info("");
-    if (result.success) {
-        cliLogger.info(`Task completed in ${result.durationMs}ms`);
-        if (result.result !== undefined) {
-            cliLogger.info(`Result: ${JSON.stringify(result.result, null, 2)}`);
+        let taskConfig = {};
+        if (options.config) {
+            try {
+                taskConfig = JSON.parse(options.config);
+            }
+            catch {
+                cliLogger.error("Invalid --config JSON");
+                exitProcess(1);
+                return;
+            }
+        }
+        cliLogger.info(`Running task: ${task.name} (${task.id})`);
+        cliLogger.info("");
+        const result = await runTask({
+            task,
+            config: taskConfig,
+            projectId,
+            debug: options.debug,
+        });
+        cliLogger.info("");
+        if (result.success) {
+            cliLogger.info(`Task completed in ${result.durationMs}ms`);
+            if (result.result !== undefined) {
+                cliLogger.info(`Result: ${JSON.stringify(result.result, null, 2)}`);
+            }
+            return;
         }
-    }
-    else {
         cliLogger.error(`Task failed after ${result.durationMs}ms: ${result.error}`);
         exitProcess(1);
-    }
+    });
 }

package/esm/cli/commands/workflow/command-help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHelp } from "../../help/types.js";
+export declare const workflowHelp: CommandHelp;
+//# sourceMappingURL=command-help.d.ts.map

package/esm/cli/commands/workflow/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/workflow/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,YAAY,EAAE,WAkB1B,CAAC"}

package/esm/cli/commands/workflow/command-help.js

@@ -0,0 +1,19 @@
+export const workflowHelp = {
+    name: "workflow",
+    description: "Run a workflow from the app/workflows directory",
+    usage: "veryfront workflow run <id> [options]",
+    options: [
+        {
+            flag: "--input <json>",
+            description: "JSON input to pass to the workflow",
+        },
+        {
+            flag: "--debug",
+            description: "Enable debug logging",
+        },
+    ],
+    examples: [
+        "veryfront workflow run publish-site",
+        'veryfront workflow run content-pipeline --input \'{"topic":"AI"}\'',
+    ],
+};

package/esm/cli/commands/workflow/command.d.ts

@@ -0,0 +1,5 @@
+import type { WorkflowArgs } from "./handler.js";
+export interface WorkflowOptions extends WorkflowArgs {
+}
+export declare function workflowCommand(options: WorkflowOptions): Promise<void>;
+//# sourceMappingURL=command.d.ts.map

package/esm/cli/commands/workflow/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/workflow/command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,MAAM,WAAW,eAAgB,SAAQ,YAAY;CAAG;AA2DxD,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmF7E"}

package/esm/cli/commands/workflow/command.js

@@ -0,0 +1,119 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { cliLogger } from "../../utils/index.js";
+import { exitProcess } from "../../utils/index.js";
+import { withProjectSourceContext } from "../../shared/project-source-context.js";
+import { getEnv } from "../../../src/platform/index.js";
+const WORKFLOW_STATUS_POLL_INTERVAL_MS = 1_000;
+async function createWorkflowClient(debug) {
+    const { createWorkflowClient } = await import("../../../src/workflow/api/workflow-client.js");
+    const redisUrl = getEnv("REDIS_URL")?.trim();
+    if (!redisUrl) {
+        return createWorkflowClient({ debug });
+    }
+    const { RedisBackend } = await import("../../../src/workflow/backends/redis.js");
+    const backend = new RedisBackend({ url: redisUrl, debug });
+    if (backend.initialize) {
+        await backend.initialize();
+    }
+    return createWorkflowClient({ backend, debug });
+}
+async function waitForWorkflowExit(client, runId) {
+    while (true) {
+        const run = await client.getRun(runId);
+        if (!run) {
+            throw new Error(`Workflow run not found: ${runId}`);
+        }
+        if (run.status === "completed") {
+            cliLogger.info(`Workflow completed: ${runId}`);
+            if (run.output !== undefined) {
+                cliLogger.info(`Result: ${JSON.stringify(run.output, null, 2)}`);
+            }
+            return;
+        }
+        if (run.status === "waiting") {
+            cliLogger.info(`Workflow is waiting: ${runId}`);
+            return;
+        }
+        if (run.status === "failed") {
+            throw new Error(run.error?.message || `Workflow failed: ${runId}`);
+        }
+        if (run.status === "cancelled") {
+            throw new Error(`Workflow was cancelled: ${runId}`);
+        }
+        await new Promise((resolve) => dntShim.setTimeout(resolve, WORKFLOW_STATUS_POLL_INTERVAL_MS));
+    }
+}
+export async function workflowCommand(options) {
+    if (options.action !== "run") {
+        cliLogger.error(`Unknown workflow action: ${options.action}`);
+        exitProcess(1);
+        return;
+    }
+    const workflowId = options.name;
+    if (!workflowId) {
+        cliLogger.error("Workflow ID is required. Usage: veryfront workflow run <id>");
+        exitProcess(1);
+        return;
+    }
+    let input = {};
+    if (options.input) {
+        try {
+            input = JSON.parse(options.input);
+        }
+        catch {
+            cliLogger.error("Invalid --input JSON");
+            exitProcess(1);
+            return;
+        }
+    }
+    const { discoverWorkflows } = await import("../../../src/workflow/discovery/index.js");
+    await withProjectSourceContext(dntShim.Deno.cwd(), async ({ adapter, config, proxyContext }) => {
+        const sourceLabel = proxyContext?.branchRef
+            ? `branch ${proxyContext.branchRef}`
+            : proxyContext
+                ? "main"
+                : `${dntShim.Deno.cwd()}/app/workflows/...`;
+        cliLogger.info(`Discovering workflows in ${sourceLabel}`);
+        const discovery = await discoverWorkflows({
+            projectDir: dntShim.Deno.cwd(),
+            adapter,
+            config,
+            debug: options.debug,
+        });
+        if (discovery.errors.length > 0 && options.debug) {
+            for (const err of discovery.errors) {
+                cliLogger.warn(`  Warning: ${err.filePath}: ${err.error}`);
+            }
+        }
+        const workflow = discovery.workflows.find((candidate) => candidate.id === workflowId);
+        if (!workflow) {
+            cliLogger.error(`Workflow "${workflowId}" not found.`);
+            if (discovery.workflows.length > 0) {
+                cliLogger.info("Available workflows:");
+                for (const candidate of discovery.workflows) {
+                    cliLogger.info(`  - ${candidate.id}`);
+                }
+            }
+            else {
+                cliLogger.info("No workflows found. Create a workflow file in app/workflows/.");
+            }
+            exitProcess(1);
+            return;
+        }
+        const client = await createWorkflowClient(options.debug);
+        try {
+            client.register(workflow.definition);
+            cliLogger.info(`Running workflow: ${workflow.id}`);
+            cliLogger.info("");
+            const handle = await client.start(workflow.id, input);
+            await waitForWorkflowExit(client, handle.runId);
+        }
+        finally {
+            await client.destroy();
+        }
+    }).catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        cliLogger.error(message);
+        exitProcess(1);
+    });
+}

package/esm/cli/commands/workflow/handler.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import type { ParsedArgs } from "../../shared/types.js";
+declare const WorkflowArgsSchema: z.ZodObject<{
+    action: z.ZodEnum<["run"]>;
+    name: z.ZodString;
+    input: z.ZodOptional<z.ZodString>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    debug: boolean;
+    action: "run";
+    input?: string | undefined;
+}, {
+    name: string;
+    action: "run";
+    input?: string | undefined;
+    debug?: boolean | undefined;
+}>;
+export type WorkflowArgs = z.infer<typeof WorkflowArgsSchema>;
+export declare const parseWorkflowArgs: (args: ParsedArgs) => z.SafeParseReturnType<unknown, {
+    name: string;
+    debug: boolean;
+    action: "run";
+    input?: string | undefined;
+}>;
+export declare function handleWorkflowCommand(args: ParsedArgs): Promise<void>;
+export {};
+//# sourceMappingURL=handler.d.ts.map

package/esm/cli/commands/workflow/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/workflow/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;EAKtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;EAK5B,CAAC;AAEH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3E"}

package/esm/cli/commands/workflow/handler.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { createArgParser, parseArgsOrThrow } from "../../shared/args.js";
+const WorkflowArgsSchema = z.object({
+    action: z.enum(["run"]),
+    name: z.string(),
+    input: z.string().optional(),
+    debug: z.boolean().default(false),
+});
+export const parseWorkflowArgs = createArgParser(WorkflowArgsSchema, {
+    action: { keys: ["action"], type: "string", positional: 0 },
+    name: { keys: ["name"], type: "string", positional: 1 },
+    input: { keys: ["input"], type: "string" },
+    debug: { keys: ["debug"], type: "boolean" },
+});
+export async function handleWorkflowCommand(args) {
+    const opts = parseArgsOrThrow(parseWorkflowArgs, "workflow", args);
+    const { workflowCommand } = await import("./command.js");
+    await workflowCommand(opts);
+}

package/esm/cli/help/command-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eA8BtB,CAAC"}
+{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAiClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eA+BtB,CAAC"}

package/esm/cli/help/command-definitions.js

@@ -33,6 +33,7 @@ import { mcpHelp } from "../commands/mcp/command-help.js";
 import { issuesHelp } from "../commands/issues/command-help.js";
 import { startHelp } from "../commands/start/command-help.js";
 import { taskHelp } from "../commands/task/command-help.js";
+import { workflowHelp } from "../commands/workflow/command-help.js";
 /**
  * Central registry of all command help definitions.
  * Each command's help is imported from its respective command-help.ts file.
@@ -67,4 +68,5 @@ export const COMMANDS = {
     issues: issuesHelp,
     start: startHelp,
     task: taskHelp,
+    workflow: workflowHelp,
 };

package/esm/cli/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA0DpD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwClE"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/cli/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA2DpD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwClE"}

package/esm/cli/router.js

@@ -30,6 +30,7 @@ import { handleStartCommand } from "./commands/start/handler.js";
 import { handleStudioCommand } from "./commands/studio/handler.js";
 import { handleUpCommand } from "./commands/up/index.js";
 import { handleTaskCommand } from "./commands/task/handler.js";
+import { handleWorkflowCommand } from "./commands/workflow/handler.js";
 import { handleWorkerCommand } from "./commands/worker/handler.js";
 import { login, logout, whoami } from "./auth/index.js";
 import { parseLoginMethod } from "./auth/utils.js";
@@ -78,6 +79,7 @@ const commands = {
     "issues": handleIssuesCommand,
     "start": handleStartCommand,
     "task": handleTaskCommand,
+    "workflow": handleWorkflowCommand,
     "worker": handleWorkerCommand,
 };
 /**

package/esm/cli/shared/project-source-context.d.ts

@@ -0,0 +1,18 @@
+import { type VeryfrontConfig } from "../../src/config/index.js";
+import { type RuntimeAdapter } from "../../src/platform/index.js";
+interface ProxyProjectSourceContext {
+    projectSlug: string;
+    token: string;
+    projectId?: string;
+    branchRef?: string | null;
+}
+export interface ProjectSourceExecutionContext {
+    adapter: RuntimeAdapter;
+    config: VeryfrontConfig;
+    projectDir: string;
+    projectId?: string;
+    proxyContext?: ProxyProjectSourceContext;
+}
+export declare function withProjectSourceContext<T>(projectDir: string, run: (context: ProjectSourceExecutionContext) => Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=project-source-context.d.ts.map

package/esm/cli/shared/project-source-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-source-context.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/project-source-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAErC,UAAU,yBAAyB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,yBAAyB,CAAC;CAC1C;AA8BD,wBAAsB,wBAAwB,CAAC,CAAC,EAC9C,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1D,OAAO,CAAC,CAAC,CAAC,CAwCZ"}

package/esm/cli/shared/project-source-context.js

@@ -0,0 +1,52 @@
+import { getConfig } from "../../src/config/index.js";
+import { enhanceAdapterWithFS, getEnv, isExtendedFSAdapter, runtime, } from "../../src/platform/index.js";
+function getProxyProjectSourceContext() {
+    const projectSlug = getEnv("VERYFRONT_PROJECT_SLUG")?.trim();
+    const token = getEnv("VERYFRONT_API_TOKEN")?.trim();
+    if (!projectSlug || !token) {
+        return null;
+    }
+    const projectId = getEnv("VERYFRONT_PROJECT_ID")?.trim();
+    const branchRef = getEnv("VERYFRONT_BRANCH_REF")?.trim();
+    return {
+        projectSlug,
+        token,
+        projectId: projectId || undefined,
+        branchRef: branchRef || null,
+    };
+}
+async function loadProjectConfig(projectDir, adapter, proxyContext) {
+    const cacheKey = proxyContext?.projectId ?? proxyContext?.projectSlug;
+    return await getConfig(projectDir, adapter, cacheKey ? { cacheKey } : undefined);
+}
+export async function withProjectSourceContext(projectDir, run) {
+    const baseAdapter = await runtime.get();
+    const initialConfig = await getConfig(projectDir, baseAdapter);
+    const adapter = await enhanceAdapterWithFS(baseAdapter, initialConfig, projectDir);
+    const proxyContext = getProxyProjectSourceContext();
+    if (proxyContext &&
+        isExtendedFSAdapter(adapter.fs) &&
+        adapter.fs.isMultiProjectMode()) {
+        return await adapter.fs.runWithContext(proxyContext.projectSlug, proxyContext.token, async () => {
+            const config = await loadProjectConfig(projectDir, adapter, proxyContext);
+            return await run({
+                adapter,
+                config,
+                projectDir,
+                projectId: proxyContext.projectId,
+                proxyContext,
+            });
+        }, proxyContext.projectId, {
+            productionMode: false,
+            branch: proxyContext.branchRef ?? null,
+        });
+    }
+    const config = await loadProjectConfig(projectDir, adapter);
+    return await run({
+        adapter,
+        config,
+        projectDir,
+        projectId: proxyContext?.projectId,
+        proxyContext: proxyContext ?? undefined,
+    });
+}

package/esm/deno.d.ts

@@ -22,6 +22,7 @@ declare namespace _default {
         "./workflow/discovery": string;
         "./prompt": string;
         "./resource": string;
+        "./jobs": string;
         "./mcp": string;
         "./middleware": string;
         "./utils": string;
@@ -51,6 +52,7 @@ declare namespace _default {
         "veryfront/components/ai": string;
         "veryfront/sandbox": string;
         "veryfront/embedding": string;
+        "veryfront/jobs": string;
         "veryfront/agent/react": string;
         "veryfront/agent/testing": string;
         "veryfront/agent/middleware": string;
@@ -102,6 +104,7 @@ declare namespace _default {
         "#cli/shared/types": string;
         "#cli/shared/constants": string;
         "#cli/shared/config": string;
+        "#cli/shared/project-source-context": string;
         "#cli/shared/slug": string;
         "#cli/shared/reserve-slug": string;
         "#cli/shared/server-startup": string;
@@ -124,6 +127,7 @@ declare namespace _default {
         "#veryfront/react": string;
         "#veryfront/rendering": string;
         "#veryfront/resource": string;
+        "#veryfront/jobs": string;
         "#veryfront/routing": string;
         "#veryfront/security": string;
         "#veryfront/skill": string;
@@ -243,6 +247,7 @@ declare namespace _default {
         "tailwindcss/colors": string;
         redis: string;
         pg: string;
+        jose: string;
         "@opentelemetry/api": string;
         "@opentelemetry/core": string;
         "@opentelemetry/context-async-hooks": string;
@@ -291,6 +296,7 @@ declare namespace _default {
         "test:coverage:integration": string;
         "coverage:report": string;
         "coverage:html": string;
+        bench: string;
         clean: string;
         lint: string;
         fmt: string;