@agent-native/core 0.167.1 → 0.167.4

package/dist/deploy/build.js

@@ -24,6 +24,7 @@ import { INTEGRATION_RECOVERY_RUNTIME_MARKER, INTEGRATION_RETRY_SWEEP_PATH, INTE
 import { isValidCron } from "../jobs/cron.js";
 import { RECURRING_JOBS_SWEEP_PATH, RECURRING_JOBS_SWEEP_TOKEN_SUBJECT, } from "../jobs/scheduler-dispatch.js";
 import { findWorkspaceRoot as findAgentNativeWorkspaceRoot } from "../scripts/utils.js";
+import { RECURRING_JOBS_BUILD_MARKER_ENV_VAR, resolveRecurringJobsBuildMarker, } from "../server/agent-chat/recurring-jobs-runtime.js";
 import { normalizeAppBasePath } from "../server/app-base-path.js";
 import { DEFAULT_SPECULATION_RULES_PATH, resolveSsrCacheHeaders, resolveSsrCacheKeyHeaders, SSR_QUERY_CACHE_KEY_HEADER, } from "../shared/cache-control.js";
 import { mcpEmbedStaticAssetRouteRules } from "../shared/mcp-embed-headers.js";
@@ -2407,8 +2408,13 @@ function isTruthyEnv(name) {
 function isDisabledByEnv(name) {
     return isTruthyEnv(name);
 }
+/**
+ * Routed through the same resolver that produces the runtime marker, so the gate
+ * that emits the scheduled function and the value the deployed app reports
+ * cannot drift: a build that skips the emit always ships `"disabled"`.
+ */
 export function isRecurringJobsDeployEnabled() {
-    return !isDisabledByEnv("AGENT_NATIVE_DISABLE_RECURRING_JOBS");
+    return resolveRecurringJobsBuildMarker(process.env) === "enabled";
 }
 /**
  * Keep-warm is opt-in because a once-a-minute wake prevents autosuspend on
@@ -3887,6 +3893,11 @@ export function resolveNitroBuildReplacements(env = process.env, deploymentEnvir
         // well as in the Vite server bundle.
         "process.env.AGENT_NATIVE_RELEASE_MIGRATIONS": JSON.stringify(env.AGENT_NATIVE_RELEASE_MIGRATIONS?.trim() || ""),
         "process.env.AGENT_NATIVE_BUILD_DEPLOY_CONTEXT": JSON.stringify(env.CONTEXT?.trim() || env.NETLIFY_CONTEXT?.trim() || ""),
+        // Whether the recurring-jobs scheduled function exists is decided HERE, by
+        // the build env. `scheduledTriggerAvailability` cannot re-derive it later —
+        // a pipeline that sets the kill switch only for the build leaves no runtime
+        // trace of it — so hand the decision to the runtime explicitly.
+        [`process.env.${RECURRING_JOBS_BUILD_MARKER_ENV_VAR}`]: JSON.stringify(resolveRecurringJobsBuildMarker(env)),
         ...(configuredDeploymentEnvironment
             ? {
                 "process.env.AGENT_NATIVE_DEPLOYMENT_ENVIRONMENT": JSON.stringify(configuredDeploymentEnvironment),

package/dist/framework-tools.js

@@ -126,6 +126,7 @@ export const CORE_ACTION_GROUPS = {
     "manage-recurring-job": "automation",
     "run-automation-now": "automation",
     "list-automation-runs": "automation",
+    "get-scheduled-trigger-status": "automation",
     "list-automations": "automation",
     "manage-automation": "automation",
     "get-usage-alerts": "automation",

package/dist/jobs/actions/get-scheduled-trigger-status.d.ts

@@ -0,0 +1,13 @@
+import { type ScheduledTriggerAvailability } from "../../server/agent-chat/recurring-jobs-runtime.js";
+export type ScheduledTriggerStatus = ScheduledTriggerAvailability;
+/**
+ * Read surface for "will a schedule-triggered automation actually fire here".
+ *
+ * A separate action rather than a field on `list-automations` / `list-recurring-jobs`:
+ * both of those return bare arrays that several callers map over directly, so
+ * adding a sibling field means an envelope and a breaking change at every call
+ * site. This is deploy-scoped rather than per-automation data anyway — it never
+ * varies by row — so it caches independently and for much longer.
+ */
+declare const _default: import("../../action.js").ActionDefinition<Record<string, never>, ScheduledTriggerAvailability>;
+export default _default;

package/dist/jobs/actions/get-scheduled-trigger-status.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { defineAction } from "../../action.js";
+import { scheduledTriggerAvailability, } from "../../server/agent-chat/recurring-jobs-runtime.js";
+/**
+ * Read surface for "will a schedule-triggered automation actually fire here".
+ *
+ * A separate action rather than a field on `list-automations` / `list-recurring-jobs`:
+ * both of those return bare arrays that several callers map over directly, so
+ * adding a sibling field means an envelope and a breaking change at every call
+ * site. This is deploy-scoped rather than per-automation data anyway — it never
+ * varies by row — so it caches independently and for much longer.
+ */
+export default defineAction({
+    description: "Report whether schedule-triggered automations can actually fire in this deploy, and which driver (or missing driver) decides that. Used by the Agent Automations page to warn that a schedule will never run.",
+    agentTool: false,
+    schema: z.object({}),
+    http: { method: "GET" },
+    readOnly: true,
+    parallelSafe: true,
+    run: async () => scheduledTriggerAvailability(),
+});

package/dist/localization/default-messages.d.ts

@@ -667,6 +667,20 @@ declare const messages: {
         organization: string;
         settingsSummary: string;
         openAutomations: string;
+        nextRunNeverScheduler: string;
+        nextRunSchedulerUnknown: string;
+        nextRunSchedulerUnknownNoDate: string;
+        scheduleUnknownTitle: string;
+        scheduleUnknownDetail: string;
+        scheduleUnavailableTitle: string;
+        scheduleUnavailableLocalTitle: string;
+        scheduleUnavailableDisabled: string;
+        scheduleUnavailableNoScheduler: string;
+        scheduleUnavailableLocal: string;
+        scheduleUnavailableDisabledFix: string;
+        scheduleUnavailableLocalFix: string;
+        scheduleUnavailableFixLabel: string;
+        scheduleUnavailableFixLabelOpen: string;
     };
     share: {
         titleWithResource: string;

package/dist/localization/default-messages.js

@@ -673,6 +673,20 @@ const messages = {
         organization: "Organization",
         settingsSummary: "Manage scheduled and event-triggered agent tasks together from the Automations page.",
         openAutomations: "Open Automations",
+        nextRunNeverScheduler: "Never — no scheduler in this deploy",
+        nextRunSchedulerUnknown: "{{date}} — unconfirmed, the scheduler check failed",
+        nextRunSchedulerUnknownNoDate: "Unknown — the scheduler check failed",
+        scheduleUnknownTitle: "Couldn't check whether schedules run here",
+        scheduleUnknownDetail: "The scheduler status check failed, so the next run times below are unconfirmed. Reload to check again.",
+        scheduleUnavailableTitle: "Schedules won't run in this deploy",
+        scheduleUnavailableLocalTitle: "Schedules don't run in local development",
+        scheduleUnavailableDisabled: "This app was built with recurring jobs turned off, so no scheduled automation will fire. Event-triggered automations and Run now still work.",
+        scheduleUnavailableNoScheduler: "This hosting target has no durable scheduler, so no scheduled automation will fire. Event-triggered automations and Run now still work.",
+        scheduleUnavailableLocal: "Schedules stay off on a dev machine unless you opt in. Event-triggered automations and Run now still work.",
+        scheduleUnavailableDisabledFix: "To enable recurring jobs, set AGENT_NATIVE_DISABLE_RECURRING_JOBS=false in the build environment.",
+        scheduleUnavailableLocalFix: "Set AGENT_NATIVE_ENABLE_LOCAL_RECURRING_JOBS=true to run schedules on this machine.",
+        scheduleUnavailableFixLabel: "Show more",
+        scheduleUnavailableFixLabelOpen: "Show less",
     },
     share: {
         titleWithResource: 'Share "{{title}}"',

package/dist/mcp/screen-memory-stdio.d.ts

@@ -137,13 +137,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
-            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -159,7 +159,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
-            count?: undefined;
             query: {
                 type: string;
                 description: string;
@@ -175,6 +174,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -190,7 +190,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
     inputSchema: {
         type: string;
         properties: {
-            count?: undefined;
             minutes: {
                 type: string;
                 description: string;
@@ -200,6 +199,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -216,7 +216,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
-            count?: undefined;
             query: {
                 type: string;
                 description: string;
@@ -235,6 +234,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
             };
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;
@@ -250,7 +250,6 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
-            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
@@ -264,6 +263,7 @@ export declare function screenMemoryMcpToolDefinitions(): ({
                 description: string;
             };
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             includeMicrophone?: undefined;
@@ -314,13 +314,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
-            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt: {
                 type: string;
                 description: string;
@@ -349,13 +349,13 @@ export declare function screenMemoryMcpToolDefinitions(): ({
         type: string;
         required: string[];
         properties: {
-            count?: undefined;
             query?: undefined;
             minutes?: undefined;
             limit?: undefined;
             clientHint?: undefined;
             timestamp?: undefined;
             chapterId?: undefined;
+            count?: undefined;
             startAt?: undefined;
             endAt?: undefined;
             reason?: undefined;

package/dist/notifications/routes.d.ts

@@ -11,14 +11,14 @@
  *   DELETE /_agent-native/notifications/:id         — delete
  */
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
+    error?: undefined;
     count: number;
     updated?: undefined;
-    error?: undefined;
     ok?: undefined;
 } | {
+    error?: undefined;
     count?: undefined;
     updated: number;
-    error?: undefined;
     ok?: undefined;
 } | {
     count?: undefined;
@@ -26,8 +26,8 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
     error: string;
     ok?: undefined;
 } | {
+    error?: undefined;
     count?: undefined;
     updated?: undefined;
-    error?: undefined;
     ok: boolean;
 }>>;

package/dist/observability/routes.d.ts

@@ -41,23 +41,23 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    ok?: undefined;
     error?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
-    ok?: undefined;
 } | {
+    ok?: undefined;
     error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-    ok?: undefined;
 } | {
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     error: any;
-    ok?: undefined;
 } | {
     error?: undefined;
     summary?: undefined;

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -94,28 +94,28 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     message?: undefined;
 } | {
     id?: undefined;
-    count?: undefined;
     deleted?: undefined;
     providers?: undefined;
+    count?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
-    count?: undefined;
     provider?: undefined;
     deleted?: undefined;
     providers?: undefined;
+    count?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
-    count?: undefined;
     provider?: undefined;
     providers?: undefined;
+    count?: undefined;
     found?: undefined;
     deleted: boolean;
     id: string;
@@ -123,10 +123,10 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
-    count?: undefined;
     provider?: undefined;
     deleted?: undefined;
     providers?: undefined;
+    count?: undefined;
     found?: undefined;
     registered: boolean;
     id: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -311,9 +311,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         notes?: string | undefined;
         scope?: "org" | "user" | undefined;
     }, {
-        message?: undefined;
-        deleted?: undefined;
         id?: undefined;
+        provider?: undefined;
+        deleted?: undefined;
         providers: {
             id: string;
             label: string;
@@ -324,45 +324,45 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
             updatedAt: number;
         }[];
         count: number;
-        provider?: undefined;
         found?: undefined;
         registered?: undefined;
         label?: undefined;
-    } | {
         message?: undefined;
-        deleted?: undefined;
+    } | {
+        count?: undefined;
         id?: undefined;
+        deleted?: undefined;
         providers?: undefined;
-        count?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
         registered?: undefined;
         label?: undefined;
-    } | {
         message?: undefined;
-        deleted?: undefined;
-        providers?: undefined;
+    } | {
         count?: undefined;
         provider?: undefined;
+        deleted?: undefined;
+        providers?: undefined;
         found: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
-    } | {
         message?: undefined;
-        providers?: undefined;
+    } | {
         count?: undefined;
         provider?: undefined;
+        providers?: undefined;
         found?: undefined;
         deleted: boolean;
         id: string;
         registered?: undefined;
         label?: undefined;
+        message?: undefined;
     } | {
-        deleted?: undefined;
-        providers?: undefined;
         count?: undefined;
         provider?: undefined;
+        deleted?: undefined;
+        providers?: undefined;
         found?: undefined;
         registered: boolean;
         id: string;

package/dist/provider-api/corpus-jobs.d.ts

@@ -73,7 +73,6 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     offset?: unknown;
     limit?: unknown;
 }, {
-    deleted?: undefined;
     jobs: {
         id: string;
         name: string;
@@ -84,6 +83,7 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
         updatedAt: string;
     }[];
     total: number;
+    deleted?: undefined;
     jobId?: undefined;
 } | {
     jobs?: undefined;
@@ -91,9 +91,9 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     deleted: boolean;
     jobId: string;
 } | {
-    deleted?: undefined;
     jobs?: undefined;
     total?: undefined;
+    deleted?: undefined;
     jobId?: undefined;
     hits: Record<string, unknown>[];
     offset: number;

package/dist/server/action-discovery.js

@@ -626,6 +626,10 @@ export async function mergeCoreSharingActions(registry) {
             "list-automation-runs",
             () => import("../jobs/actions/list-automation-runs.js"),
         ],
+        [
+            "get-scheduled-trigger-status",
+            () => import("../jobs/actions/get-scheduled-trigger-status.js"),
+        ],
         [
             "list-automations",
             () => import("../triggers/actions/list-automations.js"),

package/dist/server/agent-chat/recurring-jobs-runtime.d.ts

@@ -1,4 +1,4 @@
-type RecurringJobsRuntimeEnvKey = "AGENT_NATIVE_DISABLE_RECURRING_JOBS" | "AGENT_NATIVE_ENABLE_LOCAL_RECURRING_JOBS" | "APP_URL" | "BETTER_AUTH_URL" | "CF_PAGES" | "DEPLOY_URL" | "AWS_EXECUTION_ENV" | "AWS_LAMBDA_FUNCTION_NAME" | "NETLIFY" | "NETLIFY_LOCAL" | "NITRO_PRESET" | "NODE_ENV" | "SITE_ID" | "URL" | "VERCEL" | "VITE_APP_URL" | "VITE_WORKSPACE_GATEWAY_URL" | "WORKSPACE_GATEWAY_URL";
+type RecurringJobsRuntimeEnvKey = "AGENT_NATIVE_BUILD_RECURRING_JOBS" | "AGENT_NATIVE_DISABLE_RECURRING_JOBS" | "AGENT_NATIVE_ENABLE_LOCAL_RECURRING_JOBS" | "APP_URL" | "BETTER_AUTH_URL" | "CF_PAGES" | "DEPLOY_URL" | "AWS_EXECUTION_ENV" | "AWS_LAMBDA_FUNCTION_NAME" | "NETLIFY" | "NETLIFY_LOCAL" | "NITRO_PRESET" | "NODE_ENV" | "SITE_ID" | "URL" | "VERCEL" | "VITE_APP_URL" | "VITE_WORKSPACE_GATEWAY_URL" | "WORKSPACE_GATEWAY_URL";
 type RecurringJobsRuntimeEnv = Partial<Record<RecurringJobsRuntimeEnvKey, string | undefined>>;
 export declare function shouldDisableRecurringJobsRuntime(env?: RecurringJobsRuntimeEnv): boolean;
 /**
@@ -7,4 +7,45 @@ export declare function shouldDisableRecurringJobsRuntime(env?: RecurringJobsRun
  * that timer, which is exactly the failure mode the emitted sweep fixes.
  */
 export declare function isNetlifyRecurringJobsRuntime(env?: RecurringJobsRuntimeEnv): boolean;
+/** What the BUILD decided about recurring jobs, as carried into the runtime. */
+export type RecurringJobsBuildMarker = "enabled" | "disabled";
+/**
+ * Env name the build embeds its recurring-jobs decision under.
+ *
+ * Netlify's scheduled function is emitted — or omitted — while the build runs,
+ * and a deployed serverless runtime never sees the build environment. So the
+ * build has to hand the decision over explicitly; nothing observable at runtime
+ * can reconstruct it. Consumed below as a LITERAL `process.env.<name>` member
+ * expression because that is the only form Vite's `define` and Nitro's
+ * `replace` inline at build time.
+ */
+export declare const RECURRING_JOBS_BUILD_MARKER_ENV_VAR = "AGENT_NATIVE_BUILD_RECURRING_JOBS";
+/**
+ * Build-side resolver: what the build environment decided. Shared with
+ * `isRecurringJobsDeployEnabled` in the deploy build so the gate that emits the
+ * scheduled function and the marker that reports it cannot disagree.
+ */
+export declare function resolveRecurringJobsBuildMarker(env?: RecurringJobsRuntimeEnv): RecurringJobsBuildMarker;
+export type ScheduledTriggerAvailability = {
+    available: true;
+    driver: "netlify-scheduled-function" | "in-process";
+} | {
+    available: false;
+    reason: "disabled-by-env" | "no-platform-scheduler" | "local-development";
+};
+/**
+ * Whether ANY driver will actually fire a schedule-triggered automation in this
+ * deploy. Distinct from `shouldDisableRecurringJobsRuntime`, which answers the
+ * narrower "should THIS process run an in-process timer" and is therefore `true`
+ * on hosted Netlify even though schedules do fire there via the emitted
+ * scheduled function — reporting that value to a user would call the one
+ * working production runtime broken.
+ *
+ * Each branch reads the scope that actually decides its driver. The Netlify
+ * driver is a BUILD artifact, so it is answered by the build marker; every other
+ * driver is an in-process timer started from the RUNTIME env, so it is answered
+ * by the runtime flag. Reading runtime-only platform markers for the Netlify
+ * branch would report `available` off a build that emitted no trigger at all.
+ */
+export declare function scheduledTriggerAvailability(env?: RecurringJobsRuntimeEnv): ScheduledTriggerAvailability;
 export {};

package/dist/server/agent-chat/recurring-jobs-runtime.js

@@ -30,20 +30,27 @@ function isLoopbackAppUrl(value) {
     }
     return false;
 }
-export function shouldDisableRecurringJobsRuntime(env = process.env) {
-    if (isTruthyEnv(env.AGENT_NATIVE_DISABLE_RECURRING_JOBS))
-        return true;
-    // A serverless isolate is not a durable scheduler. Keep this check separate
-    // from the platform-specific scheduler branch below so a new sweep cannot
-    // accidentally start an in-process timer before its platform trigger exists.
-    const isServerlessRuntime = env.NETLIFY_LOCAL !== "true" &&
+/**
+ * A serverless isolate is not a durable scheduler. Shared so
+ * `shouldDisableRecurringJobsRuntime` and `scheduledTriggerAvailability` cannot
+ * drift on what counts as serverless.
+ */
+function isServerlessRecurringJobsRuntime(env) {
+    return (env.NETLIFY_LOCAL !== "true" &&
         (isTruthyEnv(env.NETLIFY) ||
             env.NITRO_PRESET === "netlify" ||
             Boolean(env.AWS_LAMBDA_FUNCTION_NAME) ||
             env.AWS_EXECUTION_ENV?.startsWith("AWS_Lambda") === true ||
             isTruthyEnv(env.CF_PAGES) ||
-            isTruthyEnv(env.VERCEL));
-    if (isServerlessRuntime)
+            isTruthyEnv(env.VERCEL)));
+}
+export function shouldDisableRecurringJobsRuntime(env = process.env) {
+    if (isTruthyEnv(env.AGENT_NATIVE_DISABLE_RECURRING_JOBS))
+        return true;
+    // Keep this check separate from the platform-specific scheduler branch below
+    // so a new sweep cannot accidentally start an in-process timer before its
+    // platform trigger exists.
+    if (isServerlessRecurringJobsRuntime(env))
         return true;
     const isLocalRuntime = env.NODE_ENV === "development" ||
         env.NODE_ENV === "test" ||
@@ -74,3 +81,89 @@ export function isNetlifyRecurringJobsRuntime(env = process.env) {
         return false;
     return Boolean((env.NETLIFY && env.NETLIFY !== "false") || env.SITE_ID);
 }
+/**
+ * Env name the build embeds its recurring-jobs decision under.
+ *
+ * Netlify's scheduled function is emitted — or omitted — while the build runs,
+ * and a deployed serverless runtime never sees the build environment. So the
+ * build has to hand the decision over explicitly; nothing observable at runtime
+ * can reconstruct it. Consumed below as a LITERAL `process.env.<name>` member
+ * expression because that is the only form Vite's `define` and Nitro's
+ * `replace` inline at build time.
+ */
+export const RECURRING_JOBS_BUILD_MARKER_ENV_VAR = "AGENT_NATIVE_BUILD_RECURRING_JOBS";
+/**
+ * Build-side resolver: what the build environment decided. Shared with
+ * `isRecurringJobsDeployEnabled` in the deploy build so the gate that emits the
+ * scheduled function and the marker that reports it cannot disagree.
+ */
+export function resolveRecurringJobsBuildMarker(env = process.env) {
+    return isTruthyEnv(env.AGENT_NATIVE_DISABLE_RECURRING_JOBS)
+        ? "disabled"
+        : "enabled";
+}
+function readRecurringJobsBuildMarker(env) {
+    const raw = env.AGENT_NATIVE_BUILD_RECURRING_JOBS ??
+        // config-ok: this value is INLINED at build time by Vite's `define` /
+        // Nitro's `replace`, which rewrite the literal `process.env.<NAME>` member
+        // expression and nothing else. A declared app-config field is read at
+        // runtime from the deployed environment, which is precisely the scope that
+        // cannot see the build's decision — the bug this marker exists to fix.
+        // Reading through the aliased `env` parameter would also survive the build
+        // unreplaced, so the literal form is load-bearing.
+        process.env.AGENT_NATIVE_BUILD_RECURRING_JOBS;
+    const value = raw?.trim();
+    return value === "enabled" || value === "disabled" ? value : undefined;
+}
+/**
+ * Whether ANY driver will actually fire a schedule-triggered automation in this
+ * deploy. Distinct from `shouldDisableRecurringJobsRuntime`, which answers the
+ * narrower "should THIS process run an in-process timer" and is therefore `true`
+ * on hosted Netlify even though schedules do fire there via the emitted
+ * scheduled function — reporting that value to a user would call the one
+ * working production runtime broken.
+ *
+ * Each branch reads the scope that actually decides its driver. The Netlify
+ * driver is a BUILD artifact, so it is answered by the build marker; every other
+ * driver is an in-process timer started from the RUNTIME env, so it is answered
+ * by the runtime flag. Reading runtime-only platform markers for the Netlify
+ * branch would report `available` off a build that emitted no trigger at all.
+ */
+export function scheduledTriggerAvailability(env = process.env) {
+    const buildMarker = readRecurringJobsBuildMarker(env);
+    // Netlify: the driver IS the emitted scheduled function. It fires on the
+    // platform's clock without consulting the deployed env, and no runtime value
+    // can conjure it back once the build omitted it — so the build marker is the
+    // only honest input here, in both directions.
+    if (isNetlifyRecurringJobsRuntime(env)) {
+        if (buildMarker === "disabled") {
+            return { available: false, reason: "disabled-by-env" };
+        }
+        if (buildMarker === "enabled") {
+            return { available: true, driver: "netlify-scheduled-function" };
+        }
+        // No marker: a build predating it, or a caller passing a synthetic env.
+        // Fall back to the runtime flag, which only agrees with the build when the
+        // pipeline sets the same value in both scopes.
+        return isTruthyEnv(env.AGENT_NATIVE_DISABLE_RECURRING_JOBS)
+            ? { available: false, reason: "disabled-by-env" }
+            : { available: true, driver: "netlify-scheduled-function" };
+    }
+    // Everything below is driven by an in-process timer, and the runtime flag is
+    // what `shouldDisableRecurringJobsRuntime` reads before starting it. A build
+    // marker cannot speak for this branch: a build with recurring jobs turned off
+    // still starts the timer if the deployed env does not repeat the switch.
+    if (isTruthyEnv(env.AGENT_NATIVE_DISABLE_RECURRING_JOBS)) {
+        return { available: false, reason: "disabled-by-env" };
+    }
+    // Every other serverless host: the build emits a scheduled trigger only for
+    // Netlify, and a frozen isolate cannot hold a timer.
+    if (isServerlessRecurringJobsRuntime(env)) {
+        return { available: false, reason: "no-platform-scheduler" };
+    }
+    // Long-lived host. Whatever is left of the runtime gate here is the
+    // local/loopback branch, which needs AGENT_NATIVE_ENABLE_LOCAL_RECURRING_JOBS.
+    return shouldDisableRecurringJobsRuntime(env)
+        ? { available: false, reason: "local-development" }
+        : { available: true, driver: "in-process" };
+}

package/dist/server/agent-chat-plugin.d.ts

@@ -9,7 +9,7 @@ import { _agentChatPromptSectionsForTests } from "./agent-chat/framework-prompts
 import { type AgentChatPluginOptions, type NitroPluginDef } from "./agent-chat/plugin-options.js";
 import { finalizeClaimedAgentChatProcessRunFailure } from "./agent-chat/process-run-failure.js";
 import { loadResourcesForPrompt } from "./agent-chat/prompt-resources.js";
-import { isNetlifyRecurringJobsRuntime, shouldDisableRecurringJobsRuntime } from "./agent-chat/recurring-jobs-runtime.js";
+import { isNetlifyRecurringJobsRuntime, resolveRecurringJobsBuildMarker, scheduledTriggerAvailability, shouldDisableRecurringJobsRuntime } from "./agent-chat/recurring-jobs-runtime.js";
 import { shouldBlockInProductCodeEditingSurface } from "./agent-chat/request-surface.js";
 import { loadRunCodeToolEntries } from "./agent-chat/run-code-tools.js";
 export { loadResourcesForPrompt };
@@ -34,6 +34,8 @@ export { DEFAULT_DELEGATED_MAX_ITERATIONS, DEFAULT_DELEGATED_MAX_RUN_INPUT_TOKEN
 export { shouldBlockInProductCodeEditingSurface };
 export { loadRunCodeToolEntries };
 export { isNetlifyRecurringJobsRuntime };
+export { resolveRecurringJobsBuildMarker };
+export { scheduledTriggerAvailability };
 export { shouldDisableRecurringJobsRuntime };
 export { finalizeClaimedAgentChatProcessRunFailure };
 export declare function resolveInteractiveAgentRunOptions(options?: Pick<AgentChatPluginOptions, "runSoftTimeoutMs" | "runNoProgressTimeoutMs" | "durableBackgroundRuns">): {