veryfront 0.1.1189 → 0.1.1191

package/esm/cli/commands/analyze-chunks/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/analyze-chunks/command.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA4Ef"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/analyze-chunks/command.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA8Ef"}

package/esm/cli/commands/analyze-chunks/command.js

@@ -46,7 +46,9 @@ export async function analyzeChunksCommand(options) {
             cliLogger.info("Detected heavy UI libraries shared across pages. Break them into dedicated chunks.");
         }
     }
-    catch {
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        cliLogger.error(`Failed to analyze chunks: ${message}`);
         exit(1);
     }
 }

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

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

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

@@ -6,7 +6,7 @@ export const scheduleHelp = {
     options: [
         {
             flag: "--input <file>",
-            description: "JSON input file to override the schedule input (run only)",
+            description: "JSON object file to override the schedule input (run only)",
         },
         {
             flag: "--remote",
@@ -16,6 +16,10 @@ export const scheduleHelp = {
             flag: "--json",
             description: "Output as JSON",
         },
+        {
+            flag: "--debug",
+            description: "Enable debug logging (run only)",
+        },
     ],
     examples: [
         "veryfront schedule list",

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

@@ -5,6 +5,23 @@ interface RemoteSchedulePollOptions {
     now?: () => number;
     sleep?: (delayMs: number) => Promise<void>;
 }
+interface LocalScheduleTimeoutOptions {
+    maxDelaySeconds?: number;
+    setTimer?: (callback: () => void, delayMs: number) => ReturnType<typeof setTimeout>;
+    clearTimer?: (timerId: ReturnType<typeof setTimeout>) => void;
+}
+export interface LocalScheduleTimeout {
+    readonly signal: AbortSignal | undefined;
+    dispose(): void;
+}
+/**
+ * Create a disposable cooperative timeout for one local schedule execution.
+ *
+ * Long durations are armed in bounded chunks so timer coercion cannot shorten
+ * the configured deadline.
+ */
+export declare function createLocalScheduleTimeout(timeoutSeconds: number | undefined, options?: LocalScheduleTimeoutOptions): LocalScheduleTimeout;
+export declare function normalizeLocalScheduleInput(value: unknown): Record<string, unknown>;
 export declare function waitForRemoteScheduleRun(client: Pick<VeryfrontRunsClient, "get">, accepted: CreateScheduleRunFromSourceResult, options?: RemoteSchedulePollOptions): Promise<Run>;
 export declare function formatRemoteScheduleRunOutput(run: Run): Record<string, unknown>;
 export declare function resolveRemoteScheduleTarget(run: Run, fallback: TriggerTarget): TriggerTarget;

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/schedule/handler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAUxD,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,GAAG,EACR,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAqDrF,UAAU,yBAAyB;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,EACxC,QAAQ,EAAE,iCAAiC,EAC3C,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,GAAG,CAAC,CAiDd;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO/E;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,GAAG,aAAa,CAU5F;AA8BD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsG3E"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/schedule/handler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAUxD,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,GAAG,EACR,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,+BAA+B,CAAC;AAyDvC,UAAU,yBAAyB;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,UAAU,2BAA2B;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;IACpF,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CAmDtB;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOnF;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,EACxC,QAAQ,EAAE,iCAAiC,EAC3C,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,GAAG,CAAC,CAwDd;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO/E;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,GAAG,aAAa,CAiB5F;AAiCD,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAgH3E"}

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

@@ -7,13 +7,17 @@ import { defineSchema, lazySchema } from "../../../src/schemas/index.js";
 import { DEPLOYMENT_ERROR, DEPLOYMENT_VERIFICATION_TIMEOUT, INVALID_ARGUMENT, RESOURCE_NOT_FOUND, } from "../../../src/errors/index.js";
 import { createRunsClient, } from "../../../src/runs/index.js";
 import { discoverSchedules } from "../../../src/schedule/index.js";
-import { runTriggerTarget } from "../../../src/trigger/index.js";
+import { isTriggerId, isTriggerTarget, runTriggerTarget, } from "../../../src/trigger/index.js";
 import { outputTriggerList, outputTriggerRun, readJsonFile } from "../trigger-utils.js";
 const REMOTE_SCHEDULE_POLL_INTERVAL_MS = 1_000;
 const REMOTE_SCHEDULE_TIMEOUT_GRACE_MS = 30_000;
 // Bound how long the CLI waits for dispatch without consuming the cloud run's
 // execution budget. The run remains durable in Veryfront if this wait expires.
 const REMOTE_SCHEDULE_QUEUE_WAIT_TIMEOUT_MS = 5 * 60_000;
+// Deno and Node both clamp longer setTimeout delays. Chaining bounded chunks
+// preserves the authored timeout instead of firing early after host coercion.
+const MAX_HOST_TIMER_DELAY_MS = 2 ** 31 - 1;
+const MAX_TIMER_DELAY_SECONDS = Math.floor(MAX_HOST_TIMER_DELAY_MS / 1_000);
 const getScheduleArgsSchema = defineSchema((v) => v.object({
     action: v.enum(["run", "list"]).optional(),
     id: v.string().optional(),
@@ -49,7 +53,70 @@ async function handleScheduleList(_args) {
         });
     });
 }
+/**
+ * Create a disposable cooperative timeout for one local schedule execution.
+ *
+ * Long durations are armed in bounded chunks so timer coercion cannot shorten
+ * the configured deadline.
+ */
+export function createLocalScheduleTimeout(timeoutSeconds, options = {}) {
+    if (timeoutSeconds === undefined) {
+        return { signal: undefined, dispose() { } };
+    }
+    if (!Number.isSafeInteger(timeoutSeconds) || timeoutSeconds <= 0) {
+        throw new TypeError("Local schedule timeout must be a positive safe integer.");
+    }
+    const maxDelaySeconds = options.maxDelaySeconds ?? MAX_TIMER_DELAY_SECONDS;
+    if (!Number.isSafeInteger(maxDelaySeconds) || maxDelaySeconds <= 0) {
+        throw new TypeError("Local schedule timer chunk must be a positive safe integer.");
+    }
+    const setTimer = options.setTimer ?? globalThis.setTimeout;
+    const clearTimer = options.clearTimer ?? globalThis.clearTimeout;
+    const controller = new AbortController();
+    let remainingSeconds = timeoutSeconds;
+    let timerId;
+    let disposed = false;
+    const armNextChunk = () => {
+        if (disposed || controller.signal.aborted)
+            return;
+        const delaySeconds = Math.min(remainingSeconds, maxDelaySeconds);
+        remainingSeconds -= delaySeconds;
+        timerId = setTimer(() => {
+            timerId = undefined;
+            if (disposed)
+                return;
+            if (remainingSeconds > 0) {
+                armNextChunk();
+                return;
+            }
+            controller.abort(new DOMException("Local schedule execution exceeded its configured timeout.", "TimeoutError"));
+        }, delaySeconds * 1_000);
+    };
+    armNextChunk();
+    return {
+        signal: controller.signal,
+        dispose() {
+            disposed = true;
+            if (timerId !== undefined) {
+                clearTimer(timerId);
+                timerId = undefined;
+            }
+        },
+    };
+}
+export function normalizeLocalScheduleInput(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw INVALID_ARGUMENT.create({
+            detail: "--input JSON file must contain a JSON object.",
+        });
+    }
+    return value;
+}
 export async function waitForRemoteScheduleRun(client, accepted, options = {}) {
+    if (!Number.isSafeInteger(accepted.timeoutSeconds) ||
+        accepted.timeoutSeconds <= 0) {
+        throw new Error("Remote schedule returned an invalid execution timeout.");
+    }
     const now = options.now ?? Date.now;
     const sleep = options.sleep ??
         ((delayMs) => new Promise((resolve) => setTimeout(resolve, delayMs)));
@@ -79,7 +146,8 @@ export async function waitForRemoteScheduleRun(client, accepted, options = {}) {
             throw DEPLOYMENT_ERROR.create({ detail: `Scheduled run was cancelled: ${runId}` });
         }
         const recordedTimeoutSeconds = run.timeout_seconds;
-        const executionTimeoutSeconds = recordedTimeoutSeconds !== null &&
+        const executionTimeoutSeconds = Number.isSafeInteger(recordedTimeoutSeconds) &&
+            recordedTimeoutSeconds !== null &&
             recordedTimeoutSeconds > 0
             ? recordedTimeoutSeconds
             : accepted.timeoutSeconds;
@@ -109,17 +177,26 @@ export function formatRemoteScheduleRunOutput(run) {
     };
 }
 export function resolveRemoteScheduleTarget(run, fallback) {
-    if (!run.target)
-        return fallback;
+    const fallbackTarget = isTriggerTarget(fallback) ? { ...fallback } : null;
+    if (!run.target) {
+        if (fallbackTarget !== null)
+            return fallbackTarget;
+        throw new Error("Remote schedule returned an invalid target.");
+    }
     const separator = run.target.indexOf(":");
-    if (separator < 1)
-        return fallback;
+    if (separator < 1) {
+        if (fallbackTarget !== null)
+            return fallbackTarget;
+        throw new Error("Remote schedule returned an invalid target.");
+    }
     const kind = run.target.slice(0, separator);
     const id = run.target.slice(separator + 1).trim();
-    if ((kind !== "agent" && kind !== "task" && kind !== "workflow") || id.length === 0) {
-        return fallback;
-    }
-    return { kind, id };
+    const candidate = { kind, id };
+    if (isTriggerTarget(candidate))
+        return candidate;
+    if (fallbackTarget !== null)
+        return fallbackTarget;
+    throw new Error("Remote schedule returned an invalid target.");
 }
 async function runRemoteSchedule(projectDir, opts) {
     const startedAt = Date.now();
@@ -133,6 +210,9 @@ async function runRemoteSchedule(projectDir, opts) {
         sourceTriggerId: opts.id,
         idempotencyKey: `schedule-cli:${dntShim.crypto.randomUUID()}`,
     });
+    if (!isTriggerTarget(accepted.target)) {
+        throw new Error("Remote schedule returned an invalid target.");
+    }
     const remoteRun = await waitForRemoteScheduleRun(client, accepted);
     await outputTriggerRun({
         command: "schedule",
@@ -154,7 +234,10 @@ export async function handleScheduleCommand(args) {
         throw INVALID_ARGUMENT.create({ detail: "Usage: veryfront schedule run <id>" });
     }
     const projectDir = dntShim.Deno.cwd();
-    if (opts.remote && opts.input) {
+    if (!isTriggerId(opts.id)) {
+        throw INVALID_ARGUMENT.create({ detail: `Invalid schedule id: "${opts.id}".` });
+    }
+    if (opts.remote && opts.input !== undefined) {
         throw INVALID_ARGUMENT.create({
             detail: "Remote schedule runs use the source already pushed to Veryfront and do not accept --input.",
         });
@@ -166,7 +249,9 @@ export async function handleScheduleCommand(args) {
     }
     await withProjectSourceContext(projectDir, async (context) => {
         const { adapter, config, configCacheKey, projectId } = context;
-        const input = opts.input ? await readJsonFile(opts.input, "--input JSON file") : undefined;
+        const input = opts.input !== undefined
+            ? await readJsonFile(opts.input, "--input JSON file")
+            : undefined;
         const result = await discoverSchedules({
             projectDir,
             adapter,
@@ -182,10 +267,8 @@ export async function handleScheduleCommand(args) {
         if (!schedule) {
             throw RESOURCE_NOT_FOUND.create({ detail: `Schedule "${opts.id}" not found.` });
         }
-        const triggerInput = input ?? schedule.input ?? {};
-        const scheduleConfig = triggerInput && typeof triggerInput === "object" && !Array.isArray(triggerInput)
-            ? triggerInput
-            : {};
+        const triggerInput = normalizeLocalScheduleInput(opts.input === undefined ? schedule.input ?? {} : input);
+        const scheduleConfig = triggerInput;
         const scheduleName = schedule.name ?? schedule.id;
         const scheduleTarget = scheduleConfig._schedule_target;
         const conversationMode = scheduleTarget && typeof scheduleTarget === "object" &&
@@ -209,17 +292,26 @@ export async function handleScheduleCommand(args) {
                 },
             }
             : {};
-        const run = await runTriggerTarget({
-            projectDir,
-            adapter,
-            config,
-            cacheKey: configCacheKey,
-            projectId,
-            target: schedule.target,
-            input: triggerInput,
-            ...agentRunOptions,
-            debug: opts.debug,
-        });
+        const timeout = createLocalScheduleTimeout(schedule.timeoutSeconds);
+        const run = await (async () => {
+            try {
+                return await runTriggerTarget({
+                    projectDir,
+                    adapter,
+                    config,
+                    cacheKey: configCacheKey,
+                    projectId,
+                    target: schedule.target,
+                    input: triggerInput,
+                    ...agentRunOptions,
+                    signal: timeout.signal,
+                    debug: opts.debug,
+                });
+            }
+            finally {
+                timeout.dispose();
+            }
+        })();
         await outputTriggerRun({
             command: "schedule",
             triggerId: schedule.id,
@@ -227,8 +319,6 @@ export async function handleScheduleCommand(args) {
             output: run.output,
             durationMs: run.durationMs,
         });
-    }).catch((error) => {
-        throw error;
     });
     exitProcess(0);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/command.ts"],"names":[],"mappings":"AAUA,KAAK,oBAAoB,GAAG;IAC1B,uBAAuB,EAAE,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAC1B,MAAM,GAAG,SAAS,CAAC;IACxB,sBAAsB,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,gBAAgB,CAAC,EAAE,CACjB,SAAS,EAAE,SAAS,GAAG,OAAO,EAC9B,KAAK,EAAE,OAAO,KACX,IAAI,CAAC;CACX,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,uBAAuB,EAAE,oBAAoB,CAAC,yBAAyB,CAAC,CAAC;IACzE,sBAAsB,EAAE,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;IACvE,uBAAuB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAoCD,wBAAsB,sCAAsC,CAAC,CAAC,EAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAE,oBAAoB,EAC9B,sBAAsB,GAAE,MAAM,OAAO,CAAC,IAAI,CAA6B,EACvE,uBAAuB,GAAE,MAAM,OAAO,CAAC,OAAO,CAA2B,GACxE,OAAO,CAAC,CAAC,CAAC,CAMZ;AAwFD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAgFf;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/command.ts"],"names":[],"mappings":"AAWA,KAAK,oBAAoB,GAAG;IAC1B,uBAAuB,EAAE,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAC1B,MAAM,GAAG,SAAS,CAAC;IACxB,sBAAsB,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjE,gBAAgB,CAAC,EAAE,CACjB,SAAS,EAAE,SAAS,GAAG,OAAO,EAC9B,KAAK,EAAE,OAAO,KACX,IAAI,CAAC;CACX,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,4BAA4B,GAAG;IAClC,sBAAsB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,uBAAuB,EAAE,oBAAoB,CAAC,yBAAyB,CAAC,CAAC;IACzE,sBAAsB,EAAE,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;IACvE,uBAAuB,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAoCD,wBAAsB,sCAAsC,CAAC,CAAC,EAC5D,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,QAAQ,EAAE,oBAAoB,EAC9B,sBAAsB,GAAE,MAAM,OAAO,CAAC,IAAI,CAA6B,EACvE,uBAAuB,GAAE,MAAM,OAAO,CAAC,OAAO,CAA2B,GACxE,OAAO,CAAC,CAAC,CAAC,CAMZ;AA2DD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAgFf;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,wBAA6B,GAC1C,OAAO,CAAC,IAAI,CAAC,CAcf"}

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

@@ -5,6 +5,7 @@ import { exitProcess, registerTerminationSignals, showHeader } from "../../utils
 import { generateDefaultProjectId } from "../../utils/project.js";
 import { startCliProductionServer } from "../../shared/server-startup.js";
 import { ensureCliBundlerContracts } from "../../shared/default-contracts.js";
+import { runStandaloneProxyRuntime } from "./proxy-runtime.js";
 const STARTUP_ERROR_FLUSH_TIMEOUT_MS = 2_000;
 export async function runWithStartupErrorReporting(startup, reporter, options = {}) {
     const flushTimeoutMs = options.flushTimeoutMs ?? STARTUP_ERROR_FLUSH_TIMEOUT_MS;
@@ -75,30 +76,10 @@ async function runSplit(options) {
     });
 }
 async function runProxy(options) {
-    showHeader();
-    cliLogger.info(`Starting proxy server on ${options.bindAddress}:${options.port}`);
-    const { setEnv } = await import("../../../src/platform/index.js");
-    setEnv("PORT", String(options.port));
-    setEnv("HOST", options.bindAddress);
-    const { activateStandaloneProxyCacheExtension, registerStandaloneProxyCacheExtensionTeardown, } = await import("./proxy-extension-composition.js");
-    const extensionLoader = await activateStandaloneProxyCacheExtension();
-    const teardownCacheExtension = await registerStandaloneProxyCacheExtensionTeardown(extensionLoader);
-    // DenoHttpServer.serve() blocks until the server stops,
-    // so this import keeps the process alive.
-    try {
-        await import("../../../src/proxy/main.js");
-    }
-    catch (error) {
-        try {
-            await teardownCacheExtension();
-        }
-        catch (cleanupError) {
-            cliLogger.error("Failed to clean up proxy extensions after startup failure", cleanupError);
-        }
-        throw error;
-    }
-    // Keep the process alive (Deno.serve returns immediately in compiled binaries)
-    await new Promise(() => { });
+    await runStandaloneProxyRuntime({
+        bindAddress: options.bindAddress,
+        port: options.port,
+    });
 }
 function createDeferredProductionStartupErrorReporter() {
     let sentryModule;

package/esm/cli/commands/serve/proxy-extension-composition.d.ts

@@ -2,13 +2,14 @@
  * Standalone proxy extension composition.
  *
  * This CLI/deployment boundary activates provider implementations before the
- * provider-neutral proxy runtime is imported. Core consumes only the
- * `TokenCacheStore` contract published by the extension loader.
+ * provider-neutral proxy runtime is imported. Core consumes the
+ * `TokenCacheStore` contract and the Redis runtime provider published by the
+ * extension loader.
  */
 import { ExtensionLoader } from "../../../src/extensions/index.js";
 import { type RegisterProxyShutdownHook } from "../../../src/proxy/shutdown-hooks.js";
-/** Start explicit standalone cache composition with a pinned lifecycle promise. */
-export declare function activateStandaloneProxyCacheExtension(): Promise<ExtensionLoader | null>;
+/** Start explicit standalone proxy extension composition. */
+export declare function activateStandaloneProxyExtensions(): Promise<ExtensionLoader | null>;
 /** Register exactly-once provider teardown with the proxy's shutdown owner. */
-export declare function registerStandaloneProxyCacheExtensionTeardown(loader: ExtensionLoader | null, registerHook?: RegisterProxyShutdownHook): Promise<() => Promise<void>>;
+export declare function registerStandaloneProxyExtensionTeardown(loader: ExtensionLoader | null, registerHook?: RegisterProxyShutdownHook): Promise<() => Promise<void>>;
 //# sourceMappingURL=proxy-extension-composition.d.ts.map

package/esm/cli/commands/serve/proxy-extension-composition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy-extension-composition.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/proxy-extension-composition.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAyB,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAG1F,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,sCAAsC,CAAC;AAsE9C,mFAAmF;AACnF,wBAAgB,qCAAqC,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAEvF;AA2DD,+EAA+E;AAC/E,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,YAAY,GAAE,yBAAqD,GAClE,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAI9B"}
+{"version":3,"file":"proxy-extension-composition.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/proxy-extension-composition.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAyB,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAG1F,OAAO,EAEL,KAAK,yBAAyB,EAE/B,MAAM,sCAAsC,CAAC;AAqG9C,6DAA6D;AAC7D,wBAAgB,iCAAiC,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAEnF;AA2DD,+EAA+E;AAC/E,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,YAAY,GAAE,yBAAqD,GAClE,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAI9B"}

package/esm/cli/commands/serve/proxy-extension-composition.js

@@ -2,13 +2,14 @@
  * Standalone proxy extension composition.
  *
  * This CLI/deployment boundary activates provider implementations before the
- * provider-neutral proxy runtime is imported. Core consumes only the
- * `TokenCacheStore` contract published by the extension loader.
+ * provider-neutral proxy runtime is imported. Core consumes the
+ * `TokenCacheStore` contract and the Redis runtime provider published by the
+ * extension loader.
  */
-import { cliLogger } from "../../utils/index.js";
+import { cliLogger } from "../../../src/utils/logger/index.js";
 import { ExtensionLoader } from "../../../src/extensions/index.js";
 import { importFirstPartyExtensionModule } from "../../../src/extensions/first-party-import.js";
-import { getEnv } from "../../../src/platform/index.js";
+import { getEnv, setEnv } from "../../../src/platform/compat/process/env.js";
 import { createProxyShutdownAggregateError, registerProxyShutdownHook, } from "../../../src/proxy/shutdown-hooks.js";
 // This module is evaluated before extension activation. Pin promises created
 // by the later teardown path so extension code cannot replace Promise species
@@ -29,29 +30,57 @@ function pinCompositionPromise(promise) {
 const resolvedBeforeExtensionActivation = pinCompositionPromise(new NativePromise((resolve) => resolve()));
 const CACHE_EXTENSION_SOURCE_DIRECTORY = "ext-cache-redis";
 const CACHE_EXTENSION_PACKAGE_NAME = "@veryfront/ext-cache-redis";
+const REDIS_EXTENSION_SOURCE_DIRECTORY = "ext-redis";
+const REDIS_EXTENSION_PACKAGE_NAME = "@veryfront/ext-redis";
 /**
- * Activate the standalone proxy's explicitly selected cache extension.
- * Memory mode performs no extension import. The returned loader owns provider
- * teardown; the proxy borrows its registered `TokenCacheStore`.
+ * Activate the standalone proxy's explicitly selected cache and Redis runtime
+ * providers. The returned loader owns provider teardown.
  */
-async function activateStandaloneProxyCacheExtensionInternal() {
+async function activateStandaloneProxyExtensionsInternal() {
     const cacheType = getEnv("CACHE_TYPE") || "memory";
-    if (cacheType !== "memory" && cacheType !== "extension") {
-        throw new NativeTypeError("CACHE_TYPE must be memory or extension");
+    if (cacheType !== "memory" && cacheType !== "extension" && cacheType !== "redis") {
+        throw new NativeTypeError(`CACHE_TYPE must be memory, extension, or redis (received "${cacheType}")`);
     }
-    if (cacheType === "memory")
-        return null;
-    const module = await importFirstPartyExtensionModule(CACHE_EXTENSION_SOURCE_DIRECTORY, CACHE_EXTENSION_PACKAGE_NAME);
-    if (typeof module.default !== "function") {
-        throw new NativeTypeError(`${CACHE_EXTENSION_PACKAGE_NAME} must export an ExtensionFactory`);
+    const selected = [];
+    if (cacheType === "extension" || cacheType === "redis") {
+        selected.push({
+            origin: "standalone proxy cache selection",
+            packageName: CACHE_EXTENSION_PACKAGE_NAME,
+            sourceDirectory: CACHE_EXTENSION_SOURCE_DIRECTORY,
+        });
+    }
+    if (getEnv("REDIS_URL")) {
+        selected.push({
+            origin: "standalone proxy routing invalidation",
+            packageName: REDIS_EXTENSION_PACKAGE_NAME,
+            sourceDirectory: REDIS_EXTENSION_SOURCE_DIRECTORY,
+        });
     }
+    if (selected.length === 0)
+        return null;
+    const extensions = await NativePromise.all(selected.map(async (definition) => {
+        const module = await importFirstPartyExtensionModule(definition.sourceDirectory, definition.packageName);
+        if (typeof module.default !== "function") {
+            throw new NativeTypeError(`${definition.packageName} must export an ExtensionFactory`);
+        }
+        return {
+            extension: module.default(),
+            source: "config",
+            origin: definition.origin,
+        };
+    }));
     const loader = new ExtensionLoader(cliLogger);
     try {
-        await loader.setupAll([{
-                extension: module.default(),
-                source: "config",
-                origin: "standalone proxy cache selection",
-            }], {});
+        await loader.setupAll(extensions, {});
+        // Keep the chart compatible with older universal binaries during rollout.
+        // This shared boundary translates the legacy value only after the
+        // extension-backed store is registered. The downstream cache validators
+        // (src/proxy/cache/index.ts, src/proxy/cache/extension-store.ts) accept
+        // only "memory" and "extension", so this translation must complete before
+        // the proxy runtime is imported. TODO: remove this rollout shim once the
+        // hosted charts stop passing CACHE_TYPE=redis.
+        if (cacheType === "redis")
+            setEnv("CACHE_TYPE", "extension");
         return loader;
     }
     catch (error) {
@@ -59,16 +88,16 @@ async function activateStandaloneProxyCacheExtensionInternal() {
             await loader.teardownAll();
         }
         catch (cleanupError) {
-            cliLogger.error("Failed to clean up standalone proxy cache extension", cleanupError);
+            cliLogger.error("Failed to clean up standalone proxy extensions", cleanupError);
         }
         throw error;
     }
 }
-/** Start explicit standalone cache composition with a pinned lifecycle promise. */
-export function activateStandaloneProxyCacheExtension() {
-    return pinCompositionPromise(activateStandaloneProxyCacheExtensionInternal());
+/** Start explicit standalone proxy extension composition. */
+export function activateStandaloneProxyExtensions() {
+    return pinCompositionPromise(activateStandaloneProxyExtensionsInternal());
 }
-async function registerStandaloneProxyCacheExtensionTeardownInternal(loader, registerHook) {
+async function registerStandaloneProxyExtensionTeardownInternal(loader, registerHook) {
     if (!loader)
         return () => resolvedBeforeExtensionActivation;
     let teardownPromise = null;
@@ -90,7 +119,7 @@ async function registerStandaloneProxyCacheExtensionTeardownInternal(loader, reg
             await teardown();
         }
         catch (cleanupError) {
-            throw createProxyShutdownAggregateError([error, cleanupError], "Failed to register and clean up standalone proxy cache extension teardown");
+            throw createProxyShutdownAggregateError([error, cleanupError], "Failed to register and clean up standalone proxy extension teardown");
         }
         throw error;
     }
@@ -109,7 +138,7 @@ async function registerStandaloneProxyCacheExtensionTeardownInternal(loader, reg
         }
         catch (teardownError) {
             if (disposalFailed) {
-                throw createProxyShutdownAggregateError([disposalError, teardownError], "Failed to unregister and tear down standalone proxy cache extension");
+                throw createProxyShutdownAggregateError([disposalError, teardownError], "Failed to unregister and tear down standalone proxy extensions");
             }
             throw teardownError;
         }
@@ -118,6 +147,6 @@ async function registerStandaloneProxyCacheExtensionTeardownInternal(loader, reg
     })());
 }
 /** Register exactly-once provider teardown with the proxy's shutdown owner. */
-export function registerStandaloneProxyCacheExtensionTeardown(loader, registerHook = registerProxyShutdownHook) {
-    return pinCompositionPromise(registerStandaloneProxyCacheExtensionTeardownInternal(loader, registerHook));
+export function registerStandaloneProxyExtensionTeardown(loader, registerHook = registerProxyShutdownHook) {
+    return pinCompositionPromise(registerStandaloneProxyExtensionTeardownInternal(loader, registerHook));
 }

package/esm/cli/commands/serve/proxy-runtime.d.ts

@@ -0,0 +1,17 @@
+import { activateStandaloneProxyExtensions, registerStandaloneProxyExtensionTeardown } from "./proxy-extension-composition.js";
+export interface StandaloneProxyRuntimeOptions {
+    bindAddress?: string;
+    port?: number;
+}
+interface StandaloneProxyRuntimeDependencies {
+    activateExtensions?: typeof activateStandaloneProxyExtensions;
+    keepAlive?: () => Promise<void>;
+    loadProxy?: () => Promise<unknown>;
+    registerTeardown?: typeof registerStandaloneProxyExtensionTeardown;
+}
+/** Create the never-settling promise that owns the standalone process lifetime. */
+export declare function createStandaloneProxyKeepAlivePromise(): Promise<void>;
+/** Start the standalone proxy with the same lifecycle in CLI and dedicated binaries. */
+export declare function runStandaloneProxyRuntime(options?: StandaloneProxyRuntimeOptions, dependencies?: StandaloneProxyRuntimeDependencies): Promise<void>;
+export {};
+//# sourceMappingURL=proxy-runtime.d.ts.map

package/esm/cli/commands/serve/proxy-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-runtime.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/proxy-runtime.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,iCAAiC,EACjC,wCAAwC,EACzC,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,6BAA6B;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,kCAAkC;IAC1C,kBAAkB,CAAC,EAAE,OAAO,iCAAiC,CAAC;IAC9D,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,OAAO,wCAAwC,CAAC;CACpE;AAMD,mFAAmF;AACnF,wBAAgB,qCAAqC,IAAI,OAAO,CAAC,IAAI,CAAC,CAErE;AAWD,wFAAwF;AACxF,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE,6BAAkC,EAC3C,YAAY,GAAE,kCAAuC,GACpD,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/esm/cli/commands/serve/proxy-runtime.js

@@ -0,0 +1,54 @@
+import { getEnv, setEnv } from "../../../src/platform/compat/process/env.js";
+import { cliLogger } from "../../../src/utils/logger/index.js";
+import denoConfig from "../../../deno.js";
+import { isJsonMode } from "../../shared/json-output.js";
+import { bold, brand, dim } from "../../ui/colors.js";
+import { activateStandaloneProxyExtensions, registerStandaloneProxyExtensionTeardown, } from "./proxy-extension-composition.js";
+// Capture the constructor before extension activation so extension-owned
+// global mutations cannot break the CLI-owned process lifetime promise.
+const NativePromise = Promise;
+/** Create the never-settling promise that owns the standalone process lifetime. */
+export function createStandaloneProxyKeepAlivePromise() {
+    return new NativePromise(() => { });
+}
+function showProxyHeader() {
+    if (isJsonMode())
+        return;
+    const version = typeof denoConfig.version === "string" ? denoConfig.version : "0.0.0";
+    // Preserve the existing `veryfront serve --mode=proxy` output while the
+    // dedicated binary shares this runtime with the universal CLI.
+    console.log(`${bold(brand("Veryfront"))} ${dim(`(v${version})`)}`);
+    console.log();
+}
+/** Start the standalone proxy with the same lifecycle in CLI and dedicated binaries. */
+export async function runStandaloneProxyRuntime(options = {}, dependencies = {}) {
+    if (options.port !== undefined)
+        setEnv("PORT", String(options.port));
+    if (options.bindAddress !== undefined)
+        setEnv("HOST", options.bindAddress);
+    const port = getEnv("PORT") || "8080";
+    const bindAddress = getEnv("HOST") || "0.0.0.0";
+    showProxyHeader();
+    cliLogger.info(`Starting proxy server on ${bindAddress}:${port}`);
+    const activateExtensions = dependencies.activateExtensions ??
+        activateStandaloneProxyExtensions;
+    const registerTeardown = dependencies.registerTeardown ??
+        registerStandaloneProxyExtensionTeardown;
+    const extensionLoader = await activateExtensions();
+    const teardownExtensions = await registerTeardown(extensionLoader);
+    try {
+        await (dependencies.loadProxy ?? (() => import("../../../src/proxy/main.js")))();
+    }
+    catch (error) {
+        try {
+            await teardownExtensions();
+        }
+        catch (cleanupError) {
+            cliLogger.error("Failed to clean up proxy extensions after startup failure", cleanupError);
+        }
+        throw error;
+    }
+    // Deno.serve returns after binding in compiled binaries, while the proxy's
+    // signal handlers own shutdown and extension teardown.
+    await (dependencies.keepAlive ?? createStandaloneProxyKeepAlivePromise)();
+}

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

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

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

@@ -6,12 +6,16 @@ export const webhookHelp = {
     options: [
         {
             flag: "--payload <file>",
-            description: "JSON payload fixture (run only)",
+            description: "JSON payload fixture (run only; 64 KiB maximum; filters and agent templates are applied)",
         },
         {
             flag: "--json",
             description: "Output as JSON",
         },
+        {
+            flag: "--debug",
+            description: "Enable debug logging (run only)",
+        },
     ],
     examples: [
         "veryfront webhook list",

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

@@ -1,3 +1,8 @@
 import type { ParsedArgs } from "../../shared/types.js";
+import { type PreparedWebhookInvocation } from "../../../src/webhook/index.js";
+export declare function toWebhookAgentOptions(invocation: PreparedWebhookInvocation): {
+    agentInput?: string;
+    agentContext?: Record<string, unknown>;
+};
 export declare function handleWebhookCommand(args: ParsedArgs): Promise<void>;
 //# sourceMappingURL=handler.d.ts.map