@agent-native/core 0.167.0 → 0.167.4

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/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/secrets/routes.d.ts

@@ -34,37 +34,37 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
 /** POST /_agent-native/secrets/:key — write a secret. */
 export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
-    ok?: undefined;
     status?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     status: string;
+    error?: undefined;
 } | {
-    ok?: undefined;
     error: string;
     removed?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 /**
  * POST /_agent-native/secrets/:key/test — validate an optional candidate value
  * or the current stored value without changing anything.
  */
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
     note?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     note?: undefined;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     note: string;
+    error?: undefined;
 } | {
     note?: undefined;
     ok: boolean;
@@ -95,11 +95,11 @@ export interface AdHocSecretPayload {
 export declare function createAdHocSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<AdHocSecretPayload[] | {
     error: string;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;

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">): {