@agent-native/core 0.130.2 → 0.131.3

package/dist/jobs/actions/manage-recurring-job.js

@@ -2,15 +2,12 @@ import { z } from "zod";
 import { defineAction } from "../../action.js";
 import { organizationResourceOwner, resourceDelete, resourceGetByPath, resourcePut, } from "../../resources/store.js";
 import { isValidCron, nextOccurrence } from "../cron.js";
+import { classifyJobResource } from "../frontmatter.js";
 import { buildJobContent, parseJobFrontmatter } from "../scheduler.js";
 import { authorizeJobMutation } from "../tools.js";
 const scopeSchema = z.enum(["personal", "organization"]);
-function hasTriggerFrontmatter(content) {
-    const header = content.match(/^---\n([\s\S]*?)\n---/m)?.[1] ?? "";
-    return /^triggerType\s*:/m.test(header);
-}
 export default defineAction({
-    description: "Enable, pause, or delete one recurring cron job from the Agent Jobs page.",
+    description: "Enable, pause, or delete one legacy recurring cron job from the Agent Automations page.",
     agentTool: false,
     schema: z.object({
         operation: z.enum(["update", "delete"]),
@@ -36,7 +33,7 @@ export default defineAction({
             });
         }
         const { meta, body } = parseJobFrontmatter(resource.content);
-        if (hasTriggerFrontmatter(resource.content)) {
+        if (classifyJobResource(resource.content).kind === "automation") {
             throw Object.assign(new Error(`Job "${name}" is an automation.`), {
                 statusCode: 400,
             });

package/dist/jobs/actions/manage-recurring-job.js.map

@@ -1 +1 @@
-{"version":3,"file":"manage-recurring-job.js","sourceRoot":"","sources":["../../../src/jobs/actions/manage-recurring-job.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../action.js\";\nimport {\n  organizationResourceOwner,\n  resourceDelete,\n  resourceGetByPath,\n  resourcePut,\n} from \"../../resources/store.js\";\nimport { isValidCron, nextOccurrence } from \"../cron.js\";\nimport { buildJobContent, parseJobFrontmatter } from \"../scheduler.js\";\nimport { authorizeJobMutation } from \"../tools.js\";\n\nconst scopeSchema = z.enum([\"personal\", \"organization\"]);\n\nfunction hasTriggerFrontmatter(content: string): boolean {\n  const header = content.match(/^---\\n([\\s\\S]*?)\\n---/m)?.[1] ?? \"\";\n  return /^triggerType\\s*:/m.test(header);\n}\n\nexport default defineAction({\n  description:\n    \"Enable, pause, or delete one recurring cron job from the Agent Jobs page.\",\n  agentTool: false,\n  schema: z.object({\n    operation: z.enum([\"update\", \"delete\"]),\n    name: z.string().min(1),\n    scope: scopeSchema.default(\"personal\"),\n    enabled: z.boolean().optional(),\n  }),\n  run: async ({ operation, name, scope, enabled }, ctx) => {\n    const userEmail = ctx?.userEmail;\n    if (!userEmail) throw new Error(\"Not authenticated.\");\n    if (scope === \"organization\" && !ctx?.orgId) {\n      throw new Error(\"An organization is required for organization jobs.\");\n    }\n\n    const owner =\n      scope === \"organization\"\n        ? organizationResourceOwner(ctx.orgId as string)\n        : userEmail;\n    const path = `jobs/${name}.md`;\n    const resource = await resourceGetByPath(owner, path);\n    if (!resource) {\n      throw Object.assign(new Error(`Job \"${name}\" not found.`), {\n        statusCode: 404,\n      });\n    }\n\n    const { meta, body } = parseJobFrontmatter(resource.content);\n    if (hasTriggerFrontmatter(resource.content)) {\n      throw Object.assign(new Error(`Job \"${name}\" is an automation.`), {\n        statusCode: 400,\n      });\n    }\n    const denied = await authorizeJobMutation(resource.owner, meta);\n    if (denied) throw Object.assign(new Error(denied), { statusCode: 403 });\n\n    if (operation === \"delete\") {\n      await resourceDelete(resource.id);\n      return { deleted: true, name };\n    }\n\n    if (enabled === undefined) {\n      throw Object.assign(new Error(\"enabled is required for update.\"), {\n        statusCode: 400,\n      });\n    }\n    meta.enabled = enabled;\n    if (enabled && meta.schedule && isValidCron(meta.schedule)) {\n      meta.nextRun = nextOccurrence(meta.schedule).toISOString();\n    }\n    await resourcePut(\n      resource.owner,\n      resource.path,\n      buildJobContent(meta, body),\n    );\n\n    return {\n      name,\n      enabled: meta.enabled,\n      nextRun: meta.nextRun ?? null,\n    };\n  },\n});\n"]}
+{"version":3,"file":"manage-recurring-job.js","sourceRoot":"","sources":["../../../src/jobs/actions/manage-recurring-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,yBAAyB,EACzB,cAAc,EACd,iBAAiB,EACjB,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;AAEzD,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,yFAAyF;IAC3F,SAAS,EAAE,KAAK;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC;QACtC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAChC,CAAC;IACF,GAAG,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE;QACtD,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,CAAC;QACjC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,cAAc,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,KAAK,GACT,KAAK,KAAK,cAAc;YACtB,CAAC,CAAC,yBAAyB,CAAC,GAAG,CAAC,KAAe,CAAC;YAChD,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,IAAI,GAAG,QAAQ,IAAI,KAAK,CAAC;QAC/B,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,cAAc,CAAC,EAAE;gBACzD,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAChE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,qBAAqB,CAAC,EAAE;gBAChE,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAChE,IAAI,MAAM;YAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAExE,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,EAAE;gBAChE,UAAU,EAAE,GAAG;aAChB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7D,CAAC;QACD,MAAM,WAAW,CACf,QAAQ,CAAC,KAAK,EACd,QAAQ,CAAC,IAAI,EACb,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAC5B,CAAC;QAEF,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { z } from \"zod\";\n\nimport { defineAction } from \"../../action.js\";\nimport {\n  organizationResourceOwner,\n  resourceDelete,\n  resourceGetByPath,\n  resourcePut,\n} from \"../../resources/store.js\";\nimport { isValidCron, nextOccurrence } from \"../cron.js\";\nimport { classifyJobResource } from \"../frontmatter.js\";\nimport { buildJobContent, parseJobFrontmatter } from \"../scheduler.js\";\nimport { authorizeJobMutation } from \"../tools.js\";\n\nconst scopeSchema = z.enum([\"personal\", \"organization\"]);\n\nexport default defineAction({\n  description:\n    \"Enable, pause, or delete one legacy recurring cron job from the Agent Automations page.\",\n  agentTool: false,\n  schema: z.object({\n    operation: z.enum([\"update\", \"delete\"]),\n    name: z.string().min(1),\n    scope: scopeSchema.default(\"personal\"),\n    enabled: z.boolean().optional(),\n  }),\n  run: async ({ operation, name, scope, enabled }, ctx) => {\n    const userEmail = ctx?.userEmail;\n    if (!userEmail) throw new Error(\"Not authenticated.\");\n    if (scope === \"organization\" && !ctx?.orgId) {\n      throw new Error(\"An organization is required for organization jobs.\");\n    }\n\n    const owner =\n      scope === \"organization\"\n        ? organizationResourceOwner(ctx.orgId as string)\n        : userEmail;\n    const path = `jobs/${name}.md`;\n    const resource = await resourceGetByPath(owner, path);\n    if (!resource) {\n      throw Object.assign(new Error(`Job \"${name}\" not found.`), {\n        statusCode: 404,\n      });\n    }\n\n    const { meta, body } = parseJobFrontmatter(resource.content);\n    if (classifyJobResource(resource.content).kind === \"automation\") {\n      throw Object.assign(new Error(`Job \"${name}\" is an automation.`), {\n        statusCode: 400,\n      });\n    }\n    const denied = await authorizeJobMutation(resource.owner, meta);\n    if (denied) throw Object.assign(new Error(denied), { statusCode: 403 });\n\n    if (operation === \"delete\") {\n      await resourceDelete(resource.id);\n      return { deleted: true, name };\n    }\n\n    if (enabled === undefined) {\n      throw Object.assign(new Error(\"enabled is required for update.\"), {\n        statusCode: 400,\n      });\n    }\n    meta.enabled = enabled;\n    if (enabled && meta.schedule && isValidCron(meta.schedule)) {\n      meta.nextRun = nextOccurrence(meta.schedule).toISOString();\n    }\n    await resourcePut(\n      resource.owner,\n      resource.path,\n      buildJobContent(meta, body),\n    );\n\n    return {\n      name,\n      enabled: meta.enabled,\n      nextRun: meta.nextRun ?? null,\n    };\n  },\n});\n"]}

package/dist/jobs/background-automation-runner.d.ts

@@ -0,0 +1,76 @@
+import type { ActionAutomationContext, ActionCaller } from "../action.js";
+import type { AgentEngine } from "../agent/engine/types.js";
+import { type ActionEntry } from "../agent/production-agent.js";
+import { type AutomationExecutionIdentity } from "../automations/service.js";
+import { type Resource } from "../resources/store.js";
+import { type RequestContext } from "../server/request-context.js";
+import type { JobFrontmatter } from "./frontmatter.js";
+export interface BackgroundAutomationContext {
+    name: string;
+    meta: JobFrontmatter;
+    body: string;
+    resource: Resource;
+}
+export interface BackgroundAutomationDeps {
+    getActions: (automation?: BackgroundAutomationContext) => Record<string, ActionEntry>;
+    getSystemPrompt: (owner: string) => Promise<string>;
+    getInitialToolNames?: (automation?: BackgroundAutomationContext) => string[] | undefined;
+    engine?: AgentEngine;
+    apiKey?: string;
+    model?: string;
+    appId?: string;
+}
+export interface BackgroundAutomationRunOptions {
+    automation: BackgroundAutomationContext;
+    ownerEmail: string;
+    orgId?: string;
+    prompt: string;
+    threadTitle: string;
+    runIdPrefix: string;
+    usageLabel: string;
+    usageRefId?: string;
+    requestContext?: Omit<RequestContext, "userEmail" | "orgId">;
+    actionCaller?: ActionCaller;
+    actionAutomation?: ActionAutomationContext;
+}
+export interface BackgroundAutomationRunResult {
+    responseText: string;
+    runId: string;
+}
+export type AutomationIdentityValidation = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export type BackgroundAutomationIdentityResult = {
+    ok: true;
+    identity: AutomationExecutionIdentity;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * A persisted background run must not outlive its execution identity.
+ * Organization runs fail closed when membership state cannot be read. A
+ * brand-new personal install without auth tables remains a distinct
+ * not-applicable case so local/CLI jobs keep working before auth is configured.
+ */
+export declare function validateAutomationRunIdentity(ownerEmail: string, orgId?: string): Promise<AutomationIdentityValidation>;
+export declare function resolveBackgroundAutomationIdentity(automation: BackgroundAutomationContext): Promise<BackgroundAutomationIdentityResult>;
+export declare function isBackgroundAutomationRunActive(meta: Pick<JobFrontmatter, "lastRun" | "lastStatus">, now?: Date): boolean;
+/**
+ * A soft-timeout/no-progress checkpoint is a continuation boundary, not a
+ * successful finish. Only the last terminal event decides whether an
+ * in-invocation resume recovered from the boundary.
+ */
+export declare function backgroundRunCutOffReason(run: {
+    events?: readonly {
+        event: {
+            type: string;
+            reason?: string;
+        };
+    }[];
+}): string | null;
+export declare function runBackgroundAutomation(options: BackgroundAutomationRunOptions, deps: BackgroundAutomationDeps): Promise<BackgroundAutomationRunResult>;
+//# sourceMappingURL=background-automation-runner.d.ts.map

package/dist/jobs/background-automation-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-automation-runner.d.ts","sourceRoot":"","sources":["../../src/jobs/background-automation-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,CACV,UAAU,CAAC,EAAE,2BAA2B,KACrC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,mBAAmB,CAAC,EAAE,CACpB,UAAU,CAAC,EAAE,2BAA2B,KACrC,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,2BAA2B,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,4BAA4B,GACpC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,kCAAkC,GAC1C;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,2BAA2B,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,4BAA4B,CAAC,CA0DvC;AAED,wBAAsB,mCAAmC,CACvD,UAAU,EAAE,2BAA2B,GACtC,OAAO,CAAC,kCAAkC,CAAC,CAgC7C;AAED,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,YAAY,CAAC,EACpD,GAAG,OAAa,GACf,OAAO,CAQT;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE;IAC7C,MAAM,CAAC,EAAE,SAAS;QAAE,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,EAAE,CAAC;CAClE,GAAG,MAAM,GAAG,IAAI,CAYhB;AAwBD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,EACvC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,6BAA6B,CAAC,CA2LxC"}

package/dist/jobs/background-automation-runner.js

@@ -0,0 +1,288 @@
+import { collectFinalResponseTextFromAgentEvents } from "../a2a/response-text.js";
+import { getStoredModelForEngine, normalizeModelForEngine, resolveEngine, } from "../agent/engine/index.js";
+import { actionsToEngineTools, filterInitialEngineTools, getOwnerActiveApiKey, } from "../agent/production-agent.js";
+import { runAgentLoopDirectWithSoftTimeout } from "../agent/run-loop-with-resume.js";
+import { resolveRunSoftTimeoutMs, startRun } from "../agent/run-manager.js";
+import { attachToolSearch } from "../agent/tool-search.js";
+import { resolveAutomationExecutionIdentity, } from "../automations/service.js";
+import { createThread } from "../chat-threads/store.js";
+import { queryOrgMembers } from "../org/context.js";
+import { organizationIdFromResourceOwner, } from "../resources/store.js";
+import { runWithRequestContext, } from "../server/request-context.js";
+const BACKGROUND_RUN_STUCK_MS = 10 * 60_000;
+const BACKGROUND_RUN_HARD_TIMEOUT_MS = 5 * 60_000;
+/**
+ * A persisted background run must not outlive its execution identity.
+ * Organization runs fail closed when membership state cannot be read. A
+ * brand-new personal install without auth tables remains a distinct
+ * not-applicable case so local/CLI jobs keep working before auth is configured.
+ */
+export async function validateAutomationRunIdentity(ownerEmail, orgId) {
+    if (ownerEmail === "__shared__" ||
+        organizationIdFromResourceOwner(ownerEmail)) {
+        return { ok: true };
+    }
+    try {
+        const { getDbExec } = await import("../db/client.js");
+        const userResult = await getDbExec().execute({
+            sql: `SELECT 1 FROM "user" WHERE email = ? LIMIT 1`,
+            args: [ownerEmail],
+        });
+        if (!userResult.rows || userResult.rows.length === 0) {
+            return { ok: false, reason: `user "${ownerEmail}" no longer exists` };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message.toLowerCase() : String(error);
+        const authTablesAreUnconfigured = !orgId &&
+            (message.includes("does not exist") ||
+                message.includes("no such table") ||
+                message.includes("undefined table"));
+        if (authTablesAreUnconfigured)
+            return { ok: true };
+        return {
+            ok: false,
+            reason: `could not verify user "${ownerEmail}" for this run`,
+        };
+    }
+    if (!orgId)
+        return { ok: true };
+    try {
+        const memberRows = await queryOrgMembers({
+            sql: `SELECT 1 FROM org_members WHERE org_id = ? AND LOWER(email) = LOWER(?) LIMIT 1`,
+            args: [orgId, ownerEmail],
+        });
+        if (memberRows === null) {
+            return {
+                ok: false,
+                reason: `could not verify membership in org "${orgId}"`,
+            };
+        }
+        if (memberRows.length === 0) {
+            return {
+                ok: false,
+                reason: `user "${ownerEmail}" is no longer a member of org "${orgId}"`,
+            };
+        }
+        return { ok: true };
+    }
+    catch {
+        return {
+            ok: false,
+            reason: `could not verify membership in org "${orgId}"`,
+        };
+    }
+}
+export async function resolveBackgroundAutomationIdentity(automation) {
+    if (automation.meta.triggerType) {
+        try {
+            return await resolveAutomationExecutionIdentity(automation.resource.owner, automation.meta);
+        }
+        catch {
+            return {
+                ok: false,
+                reason: "Could not verify the automation execution identity.",
+            };
+        }
+    }
+    const effectiveRunAs = automation.meta.runAs ?? "creator";
+    const userEmail = effectiveRunAs === "creator"
+        ? automation.meta.createdBy || automation.resource.owner
+        : automation.resource.owner;
+    const orgId = automation.meta.orgId ?? undefined;
+    const validity = await validateAutomationRunIdentity(userEmail, orgId);
+    return validity.ok
+        ? {
+            ok: true,
+            identity: {
+                userEmail,
+                orgId,
+                eventOwner: userEmail.toLowerCase(),
+            },
+        }
+        : validity;
+}
+export function isBackgroundAutomationRunActive(meta, now = new Date()) {
+    if (meta.lastStatus !== "running")
+        return false;
+    if (!meta.lastRun)
+        return false;
+    const startedAt = new Date(meta.lastRun).getTime();
+    return (Number.isFinite(startedAt) &&
+        now.getTime() - startedAt < BACKGROUND_RUN_STUCK_MS);
+}
+/**
+ * A soft-timeout/no-progress checkpoint is a continuation boundary, not a
+ * successful finish. Only the last terminal event decides whether an
+ * in-invocation resume recovered from the boundary.
+ */
+export function backgroundRunCutOffReason(run) {
+    const events = run.events ?? [];
+    for (let i = events.length - 1; i >= 0; i--) {
+        const event = events[i].event;
+        if (event.type === "auto_continue") {
+            return event.reason === "run_timeout" || event.reason === "no_progress"
+                ? event.reason
+                : null;
+        }
+        if (event.type === "done" || event.type === "error")
+            return null;
+    }
+    return null;
+}
+function uniqueToolNames(names) {
+    return [...new Set(names)];
+}
+function assertRequestedMcpToolsAvailable(automation, actions) {
+    const requested = automation.meta.mcpTools ?? [];
+    const missing = requested.filter((toolName) => !actions[toolName]);
+    if (missing.length > 0) {
+        throw new Error(`Configured MCP tools are unavailable in this run: ${missing.join(", ")}. Reconnect the MCP server or update the automation's capability list.`);
+    }
+}
+function createRunId(prefix) {
+    const safePrefix = prefix.replace(/[^a-zA-Z0-9._-]/g, "-");
+    return `${safePrefix}-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+}
+export async function runBackgroundAutomation(options, deps) {
+    const { automation, ownerEmail, orgId, prompt, threadTitle, usageLabel } = options;
+    return runWithRequestContext({
+        ...options.requestContext,
+        userEmail: ownerEmail,
+        orgId,
+    }, async () => {
+        const baseActions = deps.getActions(automation);
+        assertRequestedMcpToolsAvailable(automation, baseActions);
+        const configuredInitialTools = deps.getInitialToolNames?.(automation);
+        const initialToolNames = configuredInitialTools
+            ? uniqueToolNames([
+                ...configuredInitialTools,
+                ...(automation.meta.mcpTools ?? []),
+            ])
+            : undefined;
+        const actions = initialToolNames
+            ? attachToolSearch({ ...baseActions })
+            : baseActions;
+        const availableTools = actionsToEngineTools(actions);
+        const tools = filterInitialEngineTools(availableTools, initialToolNames);
+        const userApiKey = await getOwnerActiveApiKey(ownerEmail);
+        const engine = deps.engine ??
+            (await resolveEngine({
+                apiKey: userApiKey ?? deps.apiKey,
+                appId: deps.appId,
+            }));
+        const modelCandidate = automation.meta.model ??
+            deps.model ??
+            (await getStoredModelForEngine(engine, { appId: deps.appId })) ??
+            engine.defaultModel;
+        const model = normalizeModelForEngine(engine, modelCandidate);
+        const systemPrompt = await deps.getSystemPrompt(ownerEmail);
+        const thread = await createThread(ownerEmail, { title: threadTitle });
+        const runId = createRunId(options.runIdPrefix);
+        const softTimeoutMs = resolveRunSoftTimeoutMs(undefined, {
+            useHostedDefault: true,
+        });
+        const usageRef = { current: null };
+        let responseText = "";
+        let hardAbortTimer = null;
+        await new Promise((resolve, reject) => {
+            const activeRun = startRun(runId, thread.id, async (send, signal) => {
+                usageRef.current = await runAgentLoopDirectWithSoftTimeout({
+                    engine,
+                    model,
+                    systemPrompt,
+                    tools,
+                    availableTools,
+                    messages: [
+                        {
+                            role: "user",
+                            content: [{ type: "text", text: prompt }],
+                        },
+                    ],
+                    actions,
+                    send,
+                    signal,
+                    threadId: thread.id,
+                    ownerEmail,
+                    orgId,
+                    actionCaller: options.actionCaller,
+                    automation: options.actionAutomation,
+                    runId,
+                }, softTimeoutMs);
+            }, async (run) => {
+                if (hardAbortTimer) {
+                    clearTimeout(hardAbortTimer);
+                    hardAbortTimer = null;
+                }
+                const cutOffReason = backgroundRunCutOffReason(run);
+                if (cutOffReason) {
+                    reject(new Error(`Background automation was cut off before finishing (${cutOffReason})`));
+                    return;
+                }
+                if (run.status !== "completed") {
+                    reject(new Error(`Background automation ended with status: ${run.status}`));
+                    return;
+                }
+                responseText = collectFinalResponseTextFromAgentEvents((run.events ?? []).map((entry) => entry.event));
+                resolve();
+            }, {
+                softTimeoutMs,
+                dispatchMode: "background",
+                model,
+                engineName: engine.name,
+            });
+            hardAbortTimer = setTimeout(() => {
+                hardAbortTimer = null;
+                if (activeRun.status === "running") {
+                    activeRun.abort.abort("background_automation_hard_timeout");
+                    reject(new Error("Background automation timed out after 5 minutes"));
+                }
+            }, BACKGROUND_RUN_HARD_TIMEOUT_MS);
+        }).finally(() => {
+            if (hardAbortTimer) {
+                clearTimeout(hardAbortTimer);
+                hardAbortTimer = null;
+            }
+        });
+        const usage = usageRef.current;
+        if (usage &&
+            (usage.inputTokens > 0 ||
+                usage.outputTokens > 0 ||
+                usage.cacheReadTokens > 0 ||
+                usage.cacheWriteTokens > 0)) {
+            try {
+                const { recordUsage } = await import("../usage/store.js");
+                await recordUsage({
+                    ownerEmail,
+                    inputTokens: usage.inputTokens,
+                    outputTokens: usage.outputTokens,
+                    cacheReadTokens: usage.cacheReadTokens,
+                    cacheWriteTokens: usage.cacheWriteTokens,
+                    model: usage.model,
+                    label: usageLabel,
+                    app: deps.appId,
+                    refId: options.usageRefId ?? runId,
+                });
+            }
+            catch {
+                // Usage attribution must not break an otherwise successful run.
+            }
+        }
+        if (responseText.trim() &&
+            automation.meta.deliveryPlatform &&
+            automation.meta.deliveryDestination) {
+            const { getDefaultAdapter } = await import("../integrations/adapters/index.js");
+            const adapter = getDefaultAdapter(automation.meta.deliveryPlatform);
+            if (!adapter?.sendMessageToTarget) {
+                throw new Error(`Automation delivery is not supported for ${automation.meta.deliveryPlatform}`);
+            }
+            await adapter.sendMessageToTarget(adapter.formatAgentResponse(responseText), {
+                destination: automation.meta.deliveryDestination,
+                threadRef: automation.meta.deliveryThreadRef ?? null,
+                tenantId: automation.meta.deliveryTenantId,
+            });
+        }
+        return { responseText, runId };
+    });
+}
+//# sourceMappingURL=background-automation-runner.js.map

package/dist/jobs/background-automation-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-automation-runner.js","sourceRoot":"","sources":["../../src/jobs/background-automation-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { collectFinalResponseTextFromAgentEvents } from \"../a2a/response-text.js\";\nimport type { ActionAutomationContext, ActionCaller } from \"../action.js\";\nimport {\n  getStoredModelForEngine,\n  normalizeModelForEngine,\n  resolveEngine,\n} from \"../agent/engine/index.js\";\nimport type { AgentEngine } from \"../agent/engine/types.js\";\nimport {\n  actionsToEngineTools,\n  filterInitialEngineTools,\n  getOwnerActiveApiKey,\n  runAgentLoop,\n  type ActionEntry,\n} from \"../agent/production-agent.js\";\nimport { runAgentLoopDirectWithSoftTimeout } from \"../agent/run-loop-with-resume.js\";\nimport { resolveRunSoftTimeoutMs, startRun } from \"../agent/run-manager.js\";\nimport { attachToolSearch } from \"../agent/tool-search.js\";\nimport {\n  resolveAutomationExecutionIdentity,\n  type AutomationExecutionIdentity,\n} from \"../automations/service.js\";\nimport { createThread } from \"../chat-threads/store.js\";\nimport { queryOrgMembers } from \"../org/context.js\";\nimport {\n  organizationIdFromResourceOwner,\n  type Resource,\n} from \"../resources/store.js\";\nimport {\n  runWithRequestContext,\n  type RequestContext,\n} from \"../server/request-context.js\";\nimport type { JobFrontmatter } from \"./frontmatter.js\";\n\nconst BACKGROUND_RUN_STUCK_MS = 10 * 60_000;\nconst BACKGROUND_RUN_HARD_TIMEOUT_MS = 5 * 60_000;\n\nexport interface BackgroundAutomationContext {\n  name: string;\n  meta: JobFrontmatter;\n  body: string;\n  resource: Resource;\n}\n\nexport interface BackgroundAutomationDeps {\n  getActions: (\n    automation?: BackgroundAutomationContext,\n  ) => Record<string, ActionEntry>;\n  getSystemPrompt: (owner: string) => Promise<string>;\n  getInitialToolNames?: (\n    automation?: BackgroundAutomationContext,\n  ) => string[] | undefined;\n  engine?: AgentEngine;\n  apiKey?: string;\n  model?: string;\n  appId?: string;\n}\n\nexport interface BackgroundAutomationRunOptions {\n  automation: BackgroundAutomationContext;\n  ownerEmail: string;\n  orgId?: string;\n  prompt: string;\n  threadTitle: string;\n  runIdPrefix: string;\n  usageLabel: string;\n  usageRefId?: string;\n  requestContext?: Omit<RequestContext, \"userEmail\" | \"orgId\">;\n  actionCaller?: ActionCaller;\n  actionAutomation?: ActionAutomationContext;\n}\n\nexport interface BackgroundAutomationRunResult {\n  responseText: string;\n  runId: string;\n}\n\nexport type AutomationIdentityValidation =\n  | { ok: true }\n  | { ok: false; reason: string };\n\nexport type BackgroundAutomationIdentityResult =\n  | { ok: true; identity: AutomationExecutionIdentity }\n  | { ok: false; reason: string };\n\n/**\n * A persisted background run must not outlive its execution identity.\n * Organization runs fail closed when membership state cannot be read. A\n * brand-new personal install without auth tables remains a distinct\n * not-applicable case so local/CLI jobs keep working before auth is configured.\n */\nexport async function validateAutomationRunIdentity(\n  ownerEmail: string,\n  orgId?: string,\n): Promise<AutomationIdentityValidation> {\n  if (\n    ownerEmail === \"__shared__\" ||\n    organizationIdFromResourceOwner(ownerEmail)\n  ) {\n    return { ok: true };\n  }\n\n  try {\n    const { getDbExec } = await import(\"../db/client.js\");\n    const userResult = await getDbExec().execute({\n      sql: `SELECT 1 FROM \"user\" WHERE email = ? LIMIT 1`,\n      args: [ownerEmail],\n    });\n    if (!userResult.rows || userResult.rows.length === 0) {\n      return { ok: false, reason: `user \"${ownerEmail}\" no longer exists` };\n    }\n  } catch (error) {\n    const message =\n      error instanceof Error ? error.message.toLowerCase() : String(error);\n    const authTablesAreUnconfigured =\n      !orgId &&\n      (message.includes(\"does not exist\") ||\n        message.includes(\"no such table\") ||\n        message.includes(\"undefined table\"));\n    if (authTablesAreUnconfigured) return { ok: true };\n    return {\n      ok: false,\n      reason: `could not verify user \"${ownerEmail}\" for this run`,\n    };\n  }\n\n  if (!orgId) return { ok: true };\n\n  try {\n    const memberRows = await queryOrgMembers({\n      sql: `SELECT 1 FROM org_members WHERE org_id = ? AND LOWER(email) = LOWER(?) LIMIT 1`,\n      args: [orgId, ownerEmail],\n    });\n    if (memberRows === null) {\n      return {\n        ok: false,\n        reason: `could not verify membership in org \"${orgId}\"`,\n      };\n    }\n    if (memberRows.length === 0) {\n      return {\n        ok: false,\n        reason: `user \"${ownerEmail}\" is no longer a member of org \"${orgId}\"`,\n      };\n    }\n    return { ok: true };\n  } catch {\n    return {\n      ok: false,\n      reason: `could not verify membership in org \"${orgId}\"`,\n    };\n  }\n}\n\nexport async function resolveBackgroundAutomationIdentity(\n  automation: BackgroundAutomationContext,\n): Promise<BackgroundAutomationIdentityResult> {\n  if (automation.meta.triggerType) {\n    try {\n      return await resolveAutomationExecutionIdentity(\n        automation.resource.owner,\n        automation.meta,\n      );\n    } catch {\n      return {\n        ok: false,\n        reason: \"Could not verify the automation execution identity.\",\n      };\n    }\n  }\n\n  const effectiveRunAs = automation.meta.runAs ?? \"creator\";\n  const userEmail =\n    effectiveRunAs === \"creator\"\n      ? automation.meta.createdBy || automation.resource.owner\n      : automation.resource.owner;\n  const orgId = automation.meta.orgId ?? undefined;\n  const validity = await validateAutomationRunIdentity(userEmail, orgId);\n  return validity.ok\n    ? {\n        ok: true,\n        identity: {\n          userEmail,\n          orgId,\n          eventOwner: userEmail.toLowerCase(),\n        },\n      }\n    : validity;\n}\n\nexport function isBackgroundAutomationRunActive(\n  meta: Pick<JobFrontmatter, \"lastRun\" | \"lastStatus\">,\n  now = new Date(),\n): boolean {\n  if (meta.lastStatus !== \"running\") return false;\n  if (!meta.lastRun) return false;\n  const startedAt = new Date(meta.lastRun).getTime();\n  return (\n    Number.isFinite(startedAt) &&\n    now.getTime() - startedAt < BACKGROUND_RUN_STUCK_MS\n  );\n}\n\n/**\n * A soft-timeout/no-progress checkpoint is a continuation boundary, not a\n * successful finish. Only the last terminal event decides whether an\n * in-invocation resume recovered from the boundary.\n */\nexport function backgroundRunCutOffReason(run: {\n  events?: readonly { event: { type: string; reason?: string } }[];\n}): string | null {\n  const events = run.events ?? [];\n  for (let i = events.length - 1; i >= 0; i--) {\n    const event = events[i].event;\n    if (event.type === \"auto_continue\") {\n      return event.reason === \"run_timeout\" || event.reason === \"no_progress\"\n        ? event.reason\n        : null;\n    }\n    if (event.type === \"done\" || event.type === \"error\") return null;\n  }\n  return null;\n}\n\nfunction uniqueToolNames(names: readonly string[]): string[] {\n  return [...new Set(names)];\n}\n\nfunction assertRequestedMcpToolsAvailable(\n  automation: BackgroundAutomationContext,\n  actions: Record<string, ActionEntry>,\n): void {\n  const requested = automation.meta.mcpTools ?? [];\n  const missing = requested.filter((toolName) => !actions[toolName]);\n  if (missing.length > 0) {\n    throw new Error(\n      `Configured MCP tools are unavailable in this run: ${missing.join(\", \")}. Reconnect the MCP server or update the automation's capability list.`,\n    );\n  }\n}\n\nfunction createRunId(prefix: string): string {\n  const safePrefix = prefix.replace(/[^a-zA-Z0-9._-]/g, \"-\");\n  return `${safePrefix}-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;\n}\n\nexport async function runBackgroundAutomation(\n  options: BackgroundAutomationRunOptions,\n  deps: BackgroundAutomationDeps,\n): Promise<BackgroundAutomationRunResult> {\n  const { automation, ownerEmail, orgId, prompt, threadTitle, usageLabel } =\n    options;\n\n  return runWithRequestContext(\n    {\n      ...options.requestContext,\n      userEmail: ownerEmail,\n      orgId,\n    },\n    async () => {\n      const baseActions = deps.getActions(automation);\n      assertRequestedMcpToolsAvailable(automation, baseActions);\n\n      const configuredInitialTools = deps.getInitialToolNames?.(automation);\n      const initialToolNames = configuredInitialTools\n        ? uniqueToolNames([\n            ...configuredInitialTools,\n            ...(automation.meta.mcpTools ?? []),\n          ])\n        : undefined;\n      const actions = initialToolNames\n        ? attachToolSearch({ ...baseActions })\n        : baseActions;\n      const availableTools = actionsToEngineTools(actions);\n      const tools = filterInitialEngineTools(availableTools, initialToolNames);\n\n      const userApiKey = await getOwnerActiveApiKey(ownerEmail);\n      const engine =\n        deps.engine ??\n        (await resolveEngine({\n          apiKey: userApiKey ?? deps.apiKey,\n          appId: deps.appId,\n        }));\n      const modelCandidate =\n        automation.meta.model ??\n        deps.model ??\n        (await getStoredModelForEngine(engine, { appId: deps.appId })) ??\n        engine.defaultModel;\n      const model = normalizeModelForEngine(engine, modelCandidate);\n      const systemPrompt = await deps.getSystemPrompt(ownerEmail);\n      const thread = await createThread(ownerEmail, { title: threadTitle });\n      const runId = createRunId(options.runIdPrefix);\n      const softTimeoutMs = resolveRunSoftTimeoutMs(undefined, {\n        useHostedDefault: true,\n      });\n\n      const usageRef: {\n        current: Awaited<ReturnType<typeof runAgentLoop>> | null;\n      } = { current: null };\n      let responseText = \"\";\n      let hardAbortTimer: ReturnType<typeof setTimeout> | null = null;\n\n      await new Promise<void>((resolve, reject) => {\n        const activeRun = startRun(\n          runId,\n          thread.id,\n          async (send, signal) => {\n            usageRef.current = await runAgentLoopDirectWithSoftTimeout(\n              {\n                engine,\n                model,\n                systemPrompt,\n                tools,\n                availableTools,\n                messages: [\n                  {\n                    role: \"user\",\n                    content: [{ type: \"text\", text: prompt }],\n                  },\n                ],\n                actions,\n                send,\n                signal,\n                threadId: thread.id,\n                ownerEmail,\n                orgId,\n                actionCaller: options.actionCaller,\n                automation: options.actionAutomation,\n                runId,\n              },\n              softTimeoutMs,\n            );\n          },\n          async (run) => {\n            if (hardAbortTimer) {\n              clearTimeout(hardAbortTimer);\n              hardAbortTimer = null;\n            }\n            const cutOffReason = backgroundRunCutOffReason(run);\n            if (cutOffReason) {\n              reject(\n                new Error(\n                  `Background automation was cut off before finishing (${cutOffReason})`,\n                ),\n              );\n              return;\n            }\n            if (run.status !== \"completed\") {\n              reject(\n                new Error(\n                  `Background automation ended with status: ${run.status}`,\n                ),\n              );\n              return;\n            }\n            responseText = collectFinalResponseTextFromAgentEvents(\n              (run.events ?? []).map((entry) => entry.event),\n            );\n            resolve();\n          },\n          {\n            softTimeoutMs,\n            dispatchMode: \"background\",\n            model,\n            engineName: engine.name,\n          },\n        );\n\n        hardAbortTimer = setTimeout(() => {\n          hardAbortTimer = null;\n          if (activeRun.status === \"running\") {\n            activeRun.abort.abort(\"background_automation_hard_timeout\");\n            reject(\n              new Error(\"Background automation timed out after 5 minutes\"),\n            );\n          }\n        }, BACKGROUND_RUN_HARD_TIMEOUT_MS);\n      }).finally(() => {\n        if (hardAbortTimer) {\n          clearTimeout(hardAbortTimer);\n          hardAbortTimer = null;\n        }\n      });\n\n      const usage = usageRef.current;\n      if (\n        usage &&\n        (usage.inputTokens > 0 ||\n          usage.outputTokens > 0 ||\n          usage.cacheReadTokens > 0 ||\n          usage.cacheWriteTokens > 0)\n      ) {\n        try {\n          const { recordUsage } = await import(\"../usage/store.js\");\n          await recordUsage({\n            ownerEmail,\n            inputTokens: usage.inputTokens,\n            outputTokens: usage.outputTokens,\n            cacheReadTokens: usage.cacheReadTokens,\n            cacheWriteTokens: usage.cacheWriteTokens,\n            model: usage.model,\n            label: usageLabel,\n            app: deps.appId,\n            refId: options.usageRefId ?? runId,\n          });\n        } catch {\n          // Usage attribution must not break an otherwise successful run.\n        }\n      }\n\n      if (\n        responseText.trim() &&\n        automation.meta.deliveryPlatform &&\n        automation.meta.deliveryDestination\n      ) {\n        const { getDefaultAdapter } =\n          await import(\"../integrations/adapters/index.js\");\n        const adapter = getDefaultAdapter(automation.meta.deliveryPlatform);\n        if (!adapter?.sendMessageToTarget) {\n          throw new Error(\n            `Automation delivery is not supported for ${automation.meta.deliveryPlatform}`,\n          );\n        }\n        await adapter.sendMessageToTarget(\n          adapter.formatAgentResponse(responseText),\n          {\n            destination: automation.meta.deliveryDestination,\n            threadRef: automation.meta.deliveryThreadRef ?? null,\n            tenantId: automation.meta.deliveryTenantId,\n          },\n        );\n      }\n\n      return { responseText, runId };\n    },\n  );\n}\n"]}

package/dist/jobs/frontmatter.d.ts

@@ -0,0 +1,63 @@
+export type JobLastStatus = "success" | "error" | "running" | "skipped";
+export type JobTriggerType = "schedule" | "event";
+export type JobExecutionMode = "agentic" | "deterministic";
+/**
+ * Every persisted field understood by either recurring jobs or automations.
+ *
+ * Automation-only fields stay optional so legacy recurring jobs can remain
+ * distinguishable from explicitly defined schedule automations.
+ */
+export interface JobFrontmatter {
+    schedule: string;
+    enabled: boolean;
+    createdBy?: string;
+    orgId?: string;
+    runAs?: "creator" | "shared";
+    lastRun?: string;
+    lastStatus?: JobLastStatus;
+    lastError?: string;
+    nextRun?: string;
+    originScopeId?: string;
+    deliveryPlatform?: string;
+    deliveryDestination?: string;
+    deliveryThreadRef?: string;
+    deliveryTenantId?: string;
+    model?: string;
+    /** Explicit MCP tool capabilities available to this background run. */
+    mcpTools?: string[];
+    /** Present only for resources explicitly defined as automations. */
+    triggerType?: JobTriggerType;
+    /** For event automations: the event name to subscribe to. */
+    event?: string;
+    /** Natural-language condition evaluated before dispatch. */
+    condition?: string;
+    mode?: JobExecutionMode;
+    /** Domain tag for filtering in per-template UIs. */
+    domain?: string;
+    /**
+     * Optional application-owned policy id carried into actions by the trusted
+     * trigger dispatcher. It is not model-supplied action input.
+     */
+    delegatedPolicyId?: string;
+}
+export interface JobResourceClassification {
+    kind: "job" | "automation";
+    hasExplicitTriggerType: boolean;
+    triggerType: JobTriggerType;
+}
+export interface ParsedJobResource {
+    meta: JobFrontmatter;
+    body: string;
+    classification: JobResourceClassification;
+}
+/**
+ * Normalize the non-secret MCP capability references persisted with a job.
+ * Tool names are opaque framework identifiers; URLs and credentials never
+ * belong in job frontmatter.
+ */
+export declare function normalizeJobMcpTools(value: unknown): string[] | undefined;
+export declare function classifyJobFrontmatter(meta: JobFrontmatter): JobResourceClassification;
+export declare function parseJobResource(content: string): ParsedJobResource;
+export declare function classifyJobResource(content: string): JobResourceClassification;
+export declare function buildJobResourceContent(meta: JobFrontmatter, body: string): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/jobs/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/jobs/frontmatter.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,CAAC;AAClD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,eAAe,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oEAAoE;IACpE,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,WAAW,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,yBAAyB,CAAC;CAC3C;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAgCzE;AAwGD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,GACnB,yBAAyB,CAO3B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA2BnE;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,GACd,yBAAyB,CAE3B;AAgBD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,CA0CR"}