@agent-native/core 0.136.3 → 0.136.4

package/dist/jobs/scheduler.js

@@ -2,6 +2,7 @@ import { resourceGetByPath, resourceListAllOwners, resourcePutIfCurrent, } from
 import { backgroundRunCutOffReason, isBackgroundAutomationRunActive, resolveBackgroundAutomationIdentity, runBackgroundAutomation, } from "./background-automation-runner.js";
 import { nextOccurrence, isValidCron, describeCron, effectiveTimezone, } from "./cron.js";
 import { buildJobResourceContent, parseJobResource, } from "./frontmatter.js";
+import { claimAutomationRun, finishAutomationRun, getAutomationRun, } from "./run-history.js";
 // ─── Frontmatter parsing ────────────────────────────────────────────────────
 export { classifyJobFrontmatter, classifyJobResource, normalizeJobMcpTools, parseJobResource, } from "./frontmatter.js";
 export function parseJobFrontmatter(content) {
@@ -128,7 +129,7 @@ export async function processRecurringJobs(deps) {
     }
 }
 export const jobRunCutOffReason = backgroundRunCutOffReason;
-async function executeJob(resource, meta, body, deps, now) {
+async function executeJob(resource, meta, body, deps, now, options = {}) {
     const jobName = resource.path.replace(/^jobs\//, "").replace(/\.md$/, "");
     const jobContext = {
         name: jobName,
@@ -156,17 +157,36 @@ async function executeJob(resource, meta, body, deps, now) {
         meta.lastError = identity.reason;
         if (!alreadyRecorded)
             await updateResource(resource, meta, body);
-        return;
+        if (options.historyId) {
+            await finishAutomationRun(options.historyId, "error", `Automation did not run: ${identity.reason}. No delivery was confirmed.`);
+        }
+        return { status: "skipped", error: identity.reason };
     }
     const jobUserEmail = identity.identity.userEmail;
     const jobOrgId = identity.identity.orgId;
+    // Manual runs use the same resource row as scheduled runs for concurrency
+    // protection. The check is paired with the conditional write below: two
+    // requests that read the same idle snapshot cannot both claim it.
+    if (options.manual && isBackgroundAutomationRunActive(meta, now)) {
+        const error = "The automation is already running.";
+        if (options.historyId) {
+            await finishAutomationRun(options.historyId, "error", `${error} No delivery was confirmed.`);
+        }
+        return { status: "skipped", error };
+    }
     // Mark as running
     meta.lastRun = now.toISOString();
     meta.lastStatus = "running";
     meta.lastError = undefined;
     if (!(await updateResource(resource, meta, body))) {
         console.log(`[recurring-jobs] "${resource.path}" changed before it could start; dropping this tick.`);
-        return;
+        if (options.historyId) {
+            await finishAutomationRun(options.historyId, "error", "The automation changed before the run could start. No delivery was confirmed.");
+        }
+        return {
+            status: "error",
+            error: "The automation changed before the run could start.",
+        };
     }
     const requestContext = meta.originScopeId && meta.deliveryPlatform && meta.deliveryDestination
         ? {
@@ -193,33 +213,74 @@ async function executeJob(resource, meta, body, deps, now) {
         }
         : undefined;
     try {
-        await runBackgroundAutomation({
+        const result = await runBackgroundAutomation({
             automation: jobContext,
             ownerEmail: jobUserEmail,
             orgId: jobOrgId,
-            prompt: `[Recurring Job: ${jobName}]\nSchedule: ${describeCron(meta.schedule, effectiveTimezone(meta.timezone))}\n\nExecute the following job instructions:\n\n${body}`,
-            threadTitle: `Job: ${jobName} — ${now.toLocaleDateString()}`,
-            runIdPrefix: `job-${jobName}`,
-            usageLabel: `recurring-job:${jobName}`,
+            prompt: options.manual
+                ? `[Manual Automation Run: ${jobName}]\nThis run was explicitly started by the automation owner. Execute the following instructions now:\n\n${body}`
+                : `[Recurring Job: ${jobName}]\nSchedule: ${describeCron(meta.schedule, effectiveTimezone(meta.timezone))}\n\nExecute the following job instructions:\n\n${body}`,
+            threadTitle: `${options.manual ? "Automation" : "Job"}: ${jobName} — ${now.toLocaleDateString()}`,
+            runIdPrefix: `${options.manual ? "manual" : "job"}-${jobName}`,
+            usageLabel: `${options.manual ? "manual-automation" : "recurring-job"}:${jobName}`,
             requestContext,
+            ...(options.historyId ? { historyId: options.historyId } : {}),
+            actionCaller: "automation",
         }, deps);
         await recordExecutionOutcome(resource, {
             lastRun: meta.lastRun,
             lastStatus: "success",
             lastError: undefined,
+            advanceSchedule: options.advanceSchedule,
         });
         console.log(`[recurring-jobs] Job "${jobName}" completed.`);
+        return { status: "success", runId: result.runId };
     }
     catch (err) {
         const lastError = err instanceof Error ? err.message.slice(0, 200) : "Unknown error";
+        const reportedError = `${lastError}. No delivery was confirmed.`;
         await recordExecutionOutcome(resource, {
             lastRun: meta.lastRun,
             lastStatus: "error",
-            lastError,
+            lastError: reportedError,
+            advanceSchedule: options.advanceSchedule,
         });
-        console.error(`[recurring-jobs] Job "${jobName}" failed:`, lastError);
+        console.error(`[recurring-jobs] Job "${jobName}" failed:`, reportedError);
+        return { status: "error", error: reportedError };
     }
 }
+/** Execute one stored automation without changing its scheduled next run. */
+export async function runJobNow(owner, name, deps, options = {}) {
+    const path = `jobs/${name}.md`;
+    const resource = await resourceGetByPath(owner, path);
+    if (!resource)
+        throw new Error(`Automation "${name}" not found.`);
+    const { meta, body } = parseJobFrontmatter(resource.content);
+    if (!body.trim())
+        throw new Error(`Automation "${name}" has no instructions.`);
+    return executeJob(resource, meta, body, deps, new Date(), {
+        advanceSchedule: false,
+        historyId: options.historyId,
+        manual: true,
+    });
+}
+/** Process a durable run-now history row exactly once in the background worker. */
+export async function runQueuedAutomation(historyId, deps) {
+    const queued = await getAutomationRun(historyId);
+    if (!queued)
+        throw new Error(`Automation run "${historyId}" not found.`);
+    if (!(await claimAutomationRun(historyId))) {
+        return { skipped: true };
+    }
+    const result = await runJobNow(queued.owner, queued.automation, deps, {
+        historyId,
+    });
+    return {
+        skipped: false,
+        ...(result.runId ? { runId: result.runId } : {}),
+        ...(result.error ? { error: result.error } : {}),
+    };
+}
 async function updateResource(resource, meta, body) {
     const content = buildJobContent(meta, body);
     const written = await resourcePutIfCurrent({
@@ -256,8 +317,11 @@ async function recordExecutionOutcome(resource, outcome) {
         return;
     }
     const current = parseJobResource(latest.content);
-    const meta = { ...current.meta, ...outcome };
-    if (meta.schedule && isValidCron(meta.schedule)) {
+    const { advanceSchedule, ...execution } = outcome;
+    const meta = { ...current.meta, ...execution };
+    if (advanceSchedule !== false &&
+        meta.schedule &&
+        isValidCron(meta.schedule)) {
         // Measured from completion so a long run cannot immediately re-fire.
         meta.nextRun = nextOccurrence(meta.schedule, new Date(), meta.timezone).toISOString();
     }

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

@@ -562,6 +562,9 @@ declare const messages: {
         eventTrigger: string;
         deleteAutomationTitle: string;
         deleteAutomationDescription: string;
+        runNow: string;
+        runNowTitle: string;
+        runNowDescription: string;
         automationDetails: string;
         automationEventDetails: string;
         condition: string;

package/dist/localization/default-messages.js

@@ -567,6 +567,9 @@ const messages = {
         eventTrigger: "Event-triggered",
         deleteAutomationTitle: "Delete automation?",
         deleteAutomationDescription: "This permanently removes the automation and cannot be undone.",
+        runNow: "Run now",
+        runNowTitle: "Run automation now?",
+        runNowDescription: "This runs the automation's real actions immediately. It may send messages or change data, and it will not change the next scheduled run.",
         automationDetails: "Automation details",
         automationEventDetails: "Runs when {{event}}.",
         condition: "Condition",

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

@@ -13,13 +13,13 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated: number;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;
@@ -28,7 +28,7 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
 } | {
     count?: undefined;
     updated?: undefined;
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/observability/routes.d.ts

@@ -41,16 +41,16 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
-    error?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
+    error?: undefined;
     ok?: undefined;
 } | {
-    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
+    error?: undefined;
     ok?: undefined;
 } | {
     summary?: undefined;
@@ -59,10 +59,10 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     error: any;
     ok?: undefined;
 } | {
-    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
+    error?: undefined;
     ok: boolean;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

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

@@ -75,10 +75,8 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         user: "user";
     }>>;
 }, z.core.$strip>>, {
-    message?: undefined;
-    id?: undefined;
-    found?: undefined;
     deleted?: undefined;
+    found?: undefined;
     providers: {
         id: string;
         label: string;
@@ -91,42 +89,44 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     count: number;
     provider?: undefined;
     registered?: undefined;
+    id?: undefined;
     label?: undefined;
-} | {
     message?: undefined;
-    id?: undefined;
+} | {
     deleted?: undefined;
-    providers?: undefined;
     count?: undefined;
+    providers?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
     registered?: undefined;
+    id?: undefined;
     label?: undefined;
-} | {
     message?: undefined;
+} | {
     deleted?: undefined;
-    providers?: undefined;
     count?: undefined;
+    providers?: undefined;
     provider?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
-} | {
     message?: undefined;
+} | {
+    count?: undefined;
     found?: undefined;
     providers?: undefined;
-    count?: undefined;
     provider?: undefined;
     deleted: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
+    message?: undefined;
 } | {
-    found?: undefined;
     deleted?: undefined;
-    providers?: undefined;
     count?: undefined;
+    found?: undefined;
+    providers?: undefined;
     provider?: undefined;
     registered: boolean;
     id: string;

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

@@ -329,9 +329,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         id?: undefined;
         deleted?: undefined;
+        count?: undefined;
         providers?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
@@ -339,9 +339,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         provider?: undefined;
         deleted?: undefined;
+        count?: undefined;
         providers?: undefined;
         found: boolean;
         id: string;
@@ -349,9 +349,9 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         provider?: undefined;
         found?: undefined;
+        count?: undefined;
         providers?: undefined;
         deleted: boolean;
         id: string;
@@ -359,10 +359,10 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         provider?: undefined;
         deleted?: undefined;
         found?: undefined;
+        count?: undefined;
         providers?: undefined;
         registered: boolean;
         id: string;

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

@@ -73,6 +73,7 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     offset?: unknown;
     limit?: unknown;
 }, {
+    deleted?: undefined;
     jobs: {
         id: string;
         name: string;
@@ -83,7 +84,6 @@ 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/resources/handlers.d.ts

@@ -48,8 +48,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/secrets/routes.d.ts

@@ -34,16 +34,16 @@ 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;
-    status?: undefined;
     ok?: undefined;
+    status?: undefined;
 } | {
     error?: undefined;
     ok: boolean;
     status: string;
 } | {
+    ok?: undefined;
     error: string;
     removed?: undefined;
-    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;
@@ -54,9 +54,9 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
  * current stored value without changing anything. Useful for the "Test" button.
  */
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
+    ok?: undefined;
     error: string;
     note?: undefined;
-    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/server/action-discovery.js

@@ -540,6 +540,10 @@ export async function mergeCoreSharingActions(registry) {
             "manage-recurring-job",
             () => import("../jobs/actions/manage-recurring-job.js"),
         ],
+        [
+            "run-automation-now",
+            () => import("../jobs/actions/run-automation-now.js"),
+        ],
         [
             "list-automation-runs",
             () => import("../jobs/actions/list-automation-runs.js"),