@agent-native/core 0.130.2 → 0.131.3

package/dist/jobs/frontmatter.js

@@ -0,0 +1,216 @@
+const MAX_JOB_MCP_TOOLS = 64;
+const JOB_MCP_TOOL_NAME_RE = /^mcp__[^\s]+__[^\s]+$/;
+const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n)?([\s\S]*)$/;
+const DELEGATED_POLICY_ID_RE = /^[a-z0-9][a-z0-9._:-]{0,127}$/i;
+/**
+ * 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 function normalizeJobMcpTools(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    const parsed = typeof value === "string"
+        ? (() => {
+            try {
+                return JSON.parse(value);
+            }
+            catch {
+                throw new Error("mcpTools must be a JSON array of tool names.");
+            }
+        })()
+        : value;
+    if (!Array.isArray(parsed)) {
+        throw new Error("mcpTools must be an array of MCP tool names.");
+    }
+    if (parsed.length > MAX_JOB_MCP_TOOLS) {
+        throw new Error(`mcpTools may contain at most ${MAX_JOB_MCP_TOOLS} tool names.`);
+    }
+    const normalized = [...new Set(parsed)];
+    if (normalized.some((toolName) => typeof toolName !== "string" || !JOB_MCP_TOOL_NAME_RE.test(toolName))) {
+        throw new Error("mcpTools must contain only framework MCP tool names such as mcp__server__tool.");
+    }
+    return normalized;
+}
+function parseScalar(rawValue) {
+    const value = rawValue.trim();
+    if (value.startsWith('"') && value.endsWith('"')) {
+        try {
+            const parsed = JSON.parse(value);
+            return typeof parsed === "string" ? parsed : value.slice(1, -1);
+        }
+        catch {
+            return value
+                .slice(1, -1)
+                .replace(/\\n/g, "\n")
+                .replace(/\\r/g, "\r")
+                .replace(/\\"/g, '"')
+                .replace(/\\\\/g, "\\");
+        }
+    }
+    if (value.startsWith("'") && value.endsWith("'")) {
+        return value.slice(1, -1).replace(/''/g, "'");
+    }
+    return value;
+}
+function parseKnownField(meta, key, rawValue) {
+    const value = parseScalar(rawValue);
+    switch (key) {
+        case "schedule":
+            meta.schedule = value;
+            break;
+        case "enabled":
+            meta.enabled = value !== "false";
+            break;
+        case "createdBy":
+            meta.createdBy = value;
+            break;
+        case "orgId":
+            meta.orgId = value;
+            break;
+        case "runAs":
+            meta.runAs =
+                value === "shared" || value === "creator" ? value : undefined;
+            break;
+        case "lastRun":
+            meta.lastRun = value;
+            break;
+        case "lastStatus":
+            meta.lastStatus = value;
+            break;
+        case "lastError":
+            meta.lastError = value;
+            break;
+        case "nextRun":
+            meta.nextRun = value;
+            break;
+        case "originScopeId":
+            meta.originScopeId = value;
+            break;
+        case "deliveryPlatform":
+            meta.deliveryPlatform = value;
+            break;
+        case "deliveryDestination":
+            meta.deliveryDestination = value;
+            break;
+        case "deliveryThreadRef":
+            meta.deliveryThreadRef = value;
+            break;
+        case "deliveryTenantId":
+            meta.deliveryTenantId = value;
+            break;
+        case "model":
+            meta.model = value;
+            break;
+        case "mcpTools":
+            meta.mcpTools = normalizeJobMcpTools(value);
+            break;
+        case "triggerType":
+            // The field's presence is the durable legacy-job/automation boundary.
+            // Preserve that marker even if an old writer stored an invalid value.
+            meta.triggerType = value === "event" ? "event" : "schedule";
+            break;
+        case "event":
+            meta.event = value;
+            break;
+        case "condition":
+            meta.condition = value;
+            break;
+        case "mode":
+            if (value === "agentic" || value === "deterministic") {
+                meta.mode = value;
+            }
+            break;
+        case "domain":
+            meta.domain = value;
+            break;
+        case "delegatedPolicyId":
+            meta.delegatedPolicyId = value || undefined;
+            break;
+    }
+}
+export function classifyJobFrontmatter(meta) {
+    const hasExplicitTriggerType = meta.triggerType !== undefined;
+    return {
+        kind: hasExplicitTriggerType ? "automation" : "job",
+        hasExplicitTriggerType,
+        triggerType: meta.triggerType ?? "schedule",
+    };
+}
+export function parseJobResource(content) {
+    const match = content.match(FRONTMATTER_RE);
+    if (!match) {
+        const meta = { schedule: "", enabled: false };
+        return {
+            meta,
+            body: content,
+            classification: classifyJobFrontmatter(meta),
+        };
+    }
+    const meta = { schedule: "", enabled: true };
+    for (const line of match[1].split(/\r?\n/)) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        parseKnownField(meta, line.slice(0, colonIdx).trim(), line.slice(colonIdx + 1));
+    }
+    return {
+        meta,
+        body: match[2].trim(),
+        classification: classifyJobFrontmatter(meta),
+    };
+}
+export function classifyJobResource(content) {
+    return parseJobResource(content).classification;
+}
+function pushString(lines, key, value, alwaysQuote = true) {
+    if (!value)
+        return;
+    const serialized = alwaysQuote || value.includes("\n") || value.includes("\r")
+        ? JSON.stringify(value)
+        : value;
+    lines.push(`${key}: ${serialized}`);
+}
+export function buildJobResourceContent(meta, body) {
+    if (meta.delegatedPolicyId &&
+        !DELEGATED_POLICY_ID_RE.test(meta.delegatedPolicyId)) {
+        throw new Error("Delegated automation policy IDs must be 1-128 letters, numbers, dots, underscores, colons, or hyphens.");
+    }
+    const lines = [
+        "---",
+        `schedule: ${JSON.stringify(meta.schedule)}`,
+        `enabled: ${meta.enabled}`,
+    ];
+    if (meta.triggerType)
+        lines.push(`triggerType: ${meta.triggerType}`);
+    pushString(lines, "event", meta.event);
+    pushString(lines, "condition", meta.condition);
+    if (meta.mode)
+        lines.push(`mode: ${meta.mode}`);
+    pushString(lines, "domain", meta.domain);
+    pushString(lines, "delegatedPolicyId", meta.delegatedPolicyId);
+    // Keep the long-standing human-readable owner shape used by existing
+    // resources and diagnostics; values that can contain free-form text use
+    // JSON quoting below.
+    pushString(lines, "createdBy", meta.createdBy, false);
+    pushString(lines, "orgId", meta.orgId);
+    if (meta.runAs)
+        lines.push(`runAs: ${meta.runAs}`);
+    pushString(lines, "lastRun", meta.lastRun);
+    if (meta.lastStatus)
+        lines.push(`lastStatus: ${meta.lastStatus}`);
+    pushString(lines, "lastError", meta.lastError);
+    pushString(lines, "nextRun", meta.nextRun);
+    pushString(lines, "originScopeId", meta.originScopeId);
+    pushString(lines, "deliveryPlatform", meta.deliveryPlatform);
+    pushString(lines, "deliveryDestination", meta.deliveryDestination);
+    pushString(lines, "deliveryThreadRef", meta.deliveryThreadRef);
+    pushString(lines, "deliveryTenantId", meta.deliveryTenantId);
+    pushString(lines, "model", meta.model);
+    if (meta.mcpTools?.length) {
+        lines.push(`mcpTools: ${JSON.stringify(meta.mcpTools)}`);
+    }
+    lines.push("---", "", body);
+    return lines.join("\n");
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/jobs/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/jobs/frontmatter.ts"],"names":[],"mappings":"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","sourcesContent":["export type JobLastStatus = \"success\" | \"error\" | \"running\" | \"skipped\";\nexport type JobTriggerType = \"schedule\" | \"event\";\nexport type JobExecutionMode = \"agentic\" | \"deterministic\";\n\n/**\n * Every persisted field understood by either recurring jobs or automations.\n *\n * Automation-only fields stay optional so legacy recurring jobs can remain\n * distinguishable from explicitly defined schedule automations.\n */\nexport interface JobFrontmatter {\n  schedule: string;\n  enabled: boolean;\n  createdBy?: string;\n  orgId?: string;\n  runAs?: \"creator\" | \"shared\";\n  lastRun?: string;\n  lastStatus?: JobLastStatus;\n  lastError?: string;\n  nextRun?: string;\n  originScopeId?: string;\n  deliveryPlatform?: string;\n  deliveryDestination?: string;\n  deliveryThreadRef?: string;\n  deliveryTenantId?: string;\n  model?: string;\n  /** Explicit MCP tool capabilities available to this background run. */\n  mcpTools?: string[];\n  /** Present only for resources explicitly defined as automations. */\n  triggerType?: JobTriggerType;\n  /** For event automations: the event name to subscribe to. */\n  event?: string;\n  /** Natural-language condition evaluated before dispatch. */\n  condition?: string;\n  mode?: JobExecutionMode;\n  /** Domain tag for filtering in per-template UIs. */\n  domain?: string;\n  /**\n   * Optional application-owned policy id carried into actions by the trusted\n   * trigger dispatcher. It is not model-supplied action input.\n   */\n  delegatedPolicyId?: string;\n}\n\nexport interface JobResourceClassification {\n  kind: \"job\" | \"automation\";\n  hasExplicitTriggerType: boolean;\n  triggerType: JobTriggerType;\n}\n\nexport interface ParsedJobResource {\n  meta: JobFrontmatter;\n  body: string;\n  classification: JobResourceClassification;\n}\n\nconst MAX_JOB_MCP_TOOLS = 64;\nconst JOB_MCP_TOOL_NAME_RE = /^mcp__[^\\s]+__[^\\s]+$/;\nconst FRONTMATTER_RE = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---(?:\\r?\\n)?([\\s\\S]*)$/;\nconst DELEGATED_POLICY_ID_RE = /^[a-z0-9][a-z0-9._:-]{0,127}$/i;\n\n/**\n * Normalize the non-secret MCP capability references persisted with a job.\n * Tool names are opaque framework identifiers; URLs and credentials never\n * belong in job frontmatter.\n */\nexport function normalizeJobMcpTools(value: unknown): string[] | undefined {\n  if (value === undefined || value === null) return undefined;\n  const parsed =\n    typeof value === \"string\"\n      ? (() => {\n          try {\n            return JSON.parse(value);\n          } catch {\n            throw new Error(\"mcpTools must be a JSON array of tool names.\");\n          }\n        })()\n      : value;\n  if (!Array.isArray(parsed)) {\n    throw new Error(\"mcpTools must be an array of MCP tool names.\");\n  }\n  if (parsed.length > MAX_JOB_MCP_TOOLS) {\n    throw new Error(\n      `mcpTools may contain at most ${MAX_JOB_MCP_TOOLS} tool names.`,\n    );\n  }\n  const normalized = [...new Set(parsed)];\n  if (\n    normalized.some(\n      (toolName) =>\n        typeof toolName !== \"string\" || !JOB_MCP_TOOL_NAME_RE.test(toolName),\n    )\n  ) {\n    throw new Error(\n      \"mcpTools must contain only framework MCP tool names such as mcp__server__tool.\",\n    );\n  }\n  return normalized;\n}\n\nfunction parseScalar(rawValue: string): string {\n  const value = rawValue.trim();\n  if (value.startsWith('\"') && value.endsWith('\"')) {\n    try {\n      const parsed = JSON.parse(value);\n      return typeof parsed === \"string\" ? parsed : value.slice(1, -1);\n    } catch {\n      return value\n        .slice(1, -1)\n        .replace(/\\\\n/g, \"\\n\")\n        .replace(/\\\\r/g, \"\\r\")\n        .replace(/\\\\\"/g, '\"')\n        .replace(/\\\\\\\\/g, \"\\\\\");\n    }\n  }\n  if (value.startsWith(\"'\") && value.endsWith(\"'\")) {\n    return value.slice(1, -1).replace(/''/g, \"'\");\n  }\n  return value;\n}\n\nfunction parseKnownField(\n  meta: JobFrontmatter,\n  key: string,\n  rawValue: string,\n): void {\n  const value = parseScalar(rawValue);\n  switch (key) {\n    case \"schedule\":\n      meta.schedule = value;\n      break;\n    case \"enabled\":\n      meta.enabled = value !== \"false\";\n      break;\n    case \"createdBy\":\n      meta.createdBy = value;\n      break;\n    case \"orgId\":\n      meta.orgId = value;\n      break;\n    case \"runAs\":\n      meta.runAs =\n        value === \"shared\" || value === \"creator\" ? value : undefined;\n      break;\n    case \"lastRun\":\n      meta.lastRun = value;\n      break;\n    case \"lastStatus\":\n      meta.lastStatus = value as JobLastStatus;\n      break;\n    case \"lastError\":\n      meta.lastError = value;\n      break;\n    case \"nextRun\":\n      meta.nextRun = value;\n      break;\n    case \"originScopeId\":\n      meta.originScopeId = value;\n      break;\n    case \"deliveryPlatform\":\n      meta.deliveryPlatform = value;\n      break;\n    case \"deliveryDestination\":\n      meta.deliveryDestination = value;\n      break;\n    case \"deliveryThreadRef\":\n      meta.deliveryThreadRef = value;\n      break;\n    case \"deliveryTenantId\":\n      meta.deliveryTenantId = value;\n      break;\n    case \"model\":\n      meta.model = value;\n      break;\n    case \"mcpTools\":\n      meta.mcpTools = normalizeJobMcpTools(value);\n      break;\n    case \"triggerType\":\n      // The field's presence is the durable legacy-job/automation boundary.\n      // Preserve that marker even if an old writer stored an invalid value.\n      meta.triggerType = value === \"event\" ? \"event\" : \"schedule\";\n      break;\n    case \"event\":\n      meta.event = value;\n      break;\n    case \"condition\":\n      meta.condition = value;\n      break;\n    case \"mode\":\n      if (value === \"agentic\" || value === \"deterministic\") {\n        meta.mode = value;\n      }\n      break;\n    case \"domain\":\n      meta.domain = value;\n      break;\n    case \"delegatedPolicyId\":\n      meta.delegatedPolicyId = value || undefined;\n      break;\n  }\n}\n\nexport function classifyJobFrontmatter(\n  meta: JobFrontmatter,\n): JobResourceClassification {\n  const hasExplicitTriggerType = meta.triggerType !== undefined;\n  return {\n    kind: hasExplicitTriggerType ? \"automation\" : \"job\",\n    hasExplicitTriggerType,\n    triggerType: meta.triggerType ?? \"schedule\",\n  };\n}\n\nexport function parseJobResource(content: string): ParsedJobResource {\n  const match = content.match(FRONTMATTER_RE);\n  if (!match) {\n    const meta: JobFrontmatter = { schedule: \"\", enabled: false };\n    return {\n      meta,\n      body: content,\n      classification: classifyJobFrontmatter(meta),\n    };\n  }\n\n  const meta: JobFrontmatter = { schedule: \"\", enabled: true };\n  for (const line of match[1].split(/\\r?\\n/)) {\n    const colonIdx = line.indexOf(\":\");\n    if (colonIdx === -1) continue;\n    parseKnownField(\n      meta,\n      line.slice(0, colonIdx).trim(),\n      line.slice(colonIdx + 1),\n    );\n  }\n\n  return {\n    meta,\n    body: match[2].trim(),\n    classification: classifyJobFrontmatter(meta),\n  };\n}\n\nexport function classifyJobResource(\n  content: string,\n): JobResourceClassification {\n  return parseJobResource(content).classification;\n}\n\nfunction pushString(\n  lines: string[],\n  key: string,\n  value: string | undefined,\n  alwaysQuote = true,\n): void {\n  if (!value) return;\n  const serialized =\n    alwaysQuote || value.includes(\"\\n\") || value.includes(\"\\r\")\n      ? JSON.stringify(value)\n      : value;\n  lines.push(`${key}: ${serialized}`);\n}\n\nexport function buildJobResourceContent(\n  meta: JobFrontmatter,\n  body: string,\n): string {\n  if (\n    meta.delegatedPolicyId &&\n    !DELEGATED_POLICY_ID_RE.test(meta.delegatedPolicyId)\n  ) {\n    throw new Error(\n      \"Delegated automation policy IDs must be 1-128 letters, numbers, dots, underscores, colons, or hyphens.\",\n    );\n  }\n\n  const lines = [\n    \"---\",\n    `schedule: ${JSON.stringify(meta.schedule)}`,\n    `enabled: ${meta.enabled}`,\n  ];\n  if (meta.triggerType) lines.push(`triggerType: ${meta.triggerType}`);\n  pushString(lines, \"event\", meta.event);\n  pushString(lines, \"condition\", meta.condition);\n  if (meta.mode) lines.push(`mode: ${meta.mode}`);\n  pushString(lines, \"domain\", meta.domain);\n  pushString(lines, \"delegatedPolicyId\", meta.delegatedPolicyId);\n  // Keep the long-standing human-readable owner shape used by existing\n  // resources and diagnostics; values that can contain free-form text use\n  // JSON quoting below.\n  pushString(lines, \"createdBy\", meta.createdBy, false);\n  pushString(lines, \"orgId\", meta.orgId);\n  if (meta.runAs) lines.push(`runAs: ${meta.runAs}`);\n  pushString(lines, \"lastRun\", meta.lastRun);\n  if (meta.lastStatus) lines.push(`lastStatus: ${meta.lastStatus}`);\n  pushString(lines, \"lastError\", meta.lastError);\n  pushString(lines, \"nextRun\", meta.nextRun);\n  pushString(lines, \"originScopeId\", meta.originScopeId);\n  pushString(lines, \"deliveryPlatform\", meta.deliveryPlatform);\n  pushString(lines, \"deliveryDestination\", meta.deliveryDestination);\n  pushString(lines, \"deliveryThreadRef\", meta.deliveryThreadRef);\n  pushString(lines, \"deliveryTenantId\", meta.deliveryTenantId);\n  pushString(lines, \"model\", meta.model);\n  if (meta.mcpTools?.length) {\n    lines.push(`mcpTools: ${JSON.stringify(meta.mcpTools)}`);\n  }\n  lines.push(\"---\", \"\", body);\n  return lines.join(\"\\n\");\n}\n"]}

package/dist/jobs/scheduler.d.ts

@@ -1,45 +1,13 @@
-import type { AgentEngine } from "../agent/engine/types.js";
-import { type ActionEntry } from "../agent/production-agent.js";
-import { type Resource } from "../resources/store.js";
-export interface JobFrontmatter {
-    schedule: string;
-    enabled: boolean;
-    createdBy?: string;
-    orgId?: string;
-    runAs?: "creator" | "shared";
-    lastRun?: string;
-    lastStatus?: "success" | "error" | "running" | "skipped";
-    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[];
-}
-/**
- * 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;
+import { backgroundRunCutOffReason, type BackgroundAutomationContext, type BackgroundAutomationDeps } from "./background-automation-runner.js";
+import { type JobFrontmatter } from "./frontmatter.js";
+export { classifyJobFrontmatter, classifyJobResource, normalizeJobMcpTools, parseJobResource, type JobFrontmatter, type JobResourceClassification, } from "./frontmatter.js";
 export declare function parseJobFrontmatter(content: string): {
     meta: JobFrontmatter;
     body: string;
 };
 export declare function buildJobContent(meta: JobFrontmatter, body: string): string;
-export interface RecurringJobContext {
-    name: string;
-    meta: JobFrontmatter;
-    body: string;
-    resource: Resource;
-}
-export interface SchedulerDeps {
-    getActions: (job?: RecurringJobContext) => Record<string, ActionEntry>;
-    getSystemPrompt: (owner: string) => Promise<string>;
+export type RecurringJobContext = BackgroundAutomationContext;
+export interface SchedulerDeps extends BackgroundAutomationDeps {
     /**
      * Tool names to expose on the FIRST engine request for a job run. When
      * provided, every other action returned by `getActions()` is deferred
@@ -52,33 +20,11 @@ export interface SchedulerDeps {
      * be supplied explicitly rather than inferred here.
      */
     getInitialToolNames?: (job?: RecurringJobContext) => string[] | undefined;
-    /** Optional engine override. Defaults to the resolved request engine. */
-    engine?: AgentEngine;
-    apiKey?: string;
-    model?: string;
-    /** App/template id used for org-scoped per-app model defaults. */
-    appId?: string;
 }
 /**
  * Process all due recurring jobs. Called every 60 seconds.
  * Sequential execution with 5-minute timeout per job.
  */
 export declare function processRecurringJobs(deps: SchedulerDeps): Promise<void>;
-/**
- * A soft-timeout / no-progress checkpoint is a continuation boundary, not a
- * finish — but `terminalStatusForEvent` maps `auto_continue` to status
- * "completed". A scheduled job has no client to drive that continuation, so
- * without this check a truncated half-answer is recorded as a success and
- * shipped to the job's delivery target. Only the LAST terminal event decides:
- * an earlier boundary the in-invocation resume already recovered from is
- * followed by `done`, and that job really did finish.
- */
-export declare function jobRunCutOffReason(run: {
-    events?: readonly {
-        event: {
-            type: string;
-            reason?: string;
-        };
-    }[];
-}): string | null;
+export declare const jobRunCutOffReason: typeof backgroundRunCutOffReason;
 //# sourceMappingURL=scheduler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/jobs/scheduler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,uBAAuB,CAAC;AAM/B,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,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACzD,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;CACrB;AAKD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAgCzE;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,CA4FA;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAqC1E;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,mBAAmB,KAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvE,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,mBAAmB,KAAK,MAAM,EAAE,GAAG,SAAS,CAAC;IAC1E,yEAAyE;IACzE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgCD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgG7E;AAmED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IACtC,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"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/jobs/scheduler.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,yBAAyB,EAIzB,KAAK,2BAA2B,EAChC,KAAK,wBAAwB,EAC9B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,yBAAyB,GAC/B,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,IAAI,EAAE,cAAc,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,CAGA;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1E;AAID,MAAM,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE9D,MAAM,WAAW,aAAc,SAAQ,wBAAwB;IAC7D;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,mBAAmB,KAAK,MAAM,EAAE,GAAG,SAAS,CAAC;CAC3E;AAgCD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0F7E;AAED,eAAO,MAAM,kBAAkB,kCAA4B,CAAC"}