@aigne/afs-scheduler 1.12.0-beta.5

package/dist/task-store.d.mts

@@ -0,0 +1,60 @@
+import { BudgetEstimate, JobEntry, ScheduleEntry, SchedulerSnapshot, TaskEntry } from "./types.mjs";
+
+//#region src/task-store.d.ts
+/** Extra fields for task creation */
+interface CreateExtras {
+  ownerKey?: string;
+  scheduleId?: string;
+  jobId?: string;
+  batchIndex?: number;
+  /** Claim-based (pull model) task — see #1067. */
+  claimable?: boolean;
+  /** Claim constraint: "" = any worker, DID = only that worker. Only meaningful when `claimable`. */
+  assignee?: string;
+}
+declare class TaskStore {
+  private maxHistory;
+  private budgetBlockedTTL;
+  private tasks;
+  private historyList;
+  private schedules;
+  constructor(maxHistory?: number, budgetBlockedTTL?: number);
+  create(taskPath: string, args?: unknown, procId?: string, estimate?: BudgetEstimate, extras?: CreateExtras): TaskEntry;
+  get(id: string): TaskEntry | undefined;
+  getFromHistory(id: string): TaskEntry | undefined;
+  getAny(id: string): TaskEntry | undefined;
+  /** Fields that must never be overwritten via update() */
+  private static readonly IMMUTABLE_FIELDS;
+  update(id: string, patch: Partial<TaskEntry>): void;
+  listActive(): TaskEntry[];
+  listHistory(): TaskEntry[];
+  moveToHistory(id: string): void;
+  restoreFromHistory(id: string): TaskEntry | undefined;
+  addSchedule(opts: {
+    name: string;
+    cron: string;
+    taskPath: string;
+    args?: unknown;
+    enabled?: boolean;
+    ownerKey?: string;
+  }): ScheduleEntry;
+  getSchedule(id: string): ScheduleEntry | undefined;
+  getScheduleByName(name: string): ScheduleEntry | undefined;
+  listSchedules(): ScheduleEntry[];
+  updateSchedule(id: string, patch: Partial<ScheduleEntry>): void;
+  removeSchedule(id: string): boolean;
+  recordScheduleRun(id: string, now: number): void;
+  private jobs;
+  addJob(job: JobEntry): void;
+  getJob(id: string): JobEntry | undefined;
+  listJobs(): JobEntry[];
+  updateJob(id: string, patch: Partial<JobEntry>): void;
+  removeJob(id: string): boolean;
+  /** Get the next pending batch index for a job, or -1 if none */
+  nextPendingBatch(jobId: string): number;
+  snapshot(): SchedulerSnapshot;
+  restore(snapshot: SchedulerSnapshot, now: number): void;
+}
+//#endregion
+export { TaskStore };
+//# sourceMappingURL=task-store.d.mts.map

package/dist/task-store.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-store.d.mts","names":[],"sources":["../src/task-store.ts"],"mappings":";;;;UAaU,YAAA;EACR,QAAA;EACA,UAAA;EACA,KAAA;EACA,UAAA;EAHA;EAKA,SAAA;EAHA;EAKA,QAAA;AAAA;AAAA,cAGW,SAAA;EAAA,QAMD,UAAA;EAAA,QACA,gBAAA;EAAA,QANF,KAAA;EAAA,QACA,WAAA;EAAA,QACA,SAAA;cAGE,UAAA,WACA,gBAAA;EAGV,MAAA,CACE,QAAA,UACA,IAAA,YACA,MAAA,WACA,QAAA,GAAW,cAAA,EACX,MAAA,GAAS,YAAA,GACR,SAAA;EAsBH,GAAA,CAAI,EAAA,WAAa,SAAA;EAIjB,cAAA,CAAe,EAAA,WAAa,SAAA;EAI5B,MAAA,CAAO,EAAA,WAAa,SAAA;EAAA;EAAA,wBAKI,gBAAA;EAExB,MAAA,CAAO,EAAA,UAAY,KAAA,EAAO,OAAA,CAAQ,SAAA;EAUlC,UAAA,CAAA,GAAc,SAAA;EAId,WAAA,CAAA,GAAe,SAAA;EAIf,aAAA,CAAc,EAAA;EAUd,kBAAA,CAAmB,EAAA,WAAa,SAAA;EAahC,WAAA,CAAY,IAAA;IACV,IAAA;IACA,IAAA;IACA,QAAA;IACA,IAAA;IACA,OAAA;IACA,QAAA;EAAA,IACE,aAAA;EA2BJ,WAAA,CAAY,EAAA,WAAa,aAAA;EAIzB,iBAAA,CAAkB,IAAA,WAAe,aAAA;EAOjC,aAAA,CAAA,GAAiB,aAAA;EAIjB,cAAA,CAAe,EAAA,UAAY,KAAA,EAAO,OAAA,CAAQ,aAAA;EAgB1C,cAAA,CAAe,EAAA;EAIf,iBAAA,CAAkB,EAAA,UAAY,GAAA;EAAA,QAWtB,IAAA;EAER,MAAA,CAAO,GAAA,EAAK,QAAA;EAIZ,MAAA,CAAO,EAAA,WAAa,QAAA;EAIpB,QAAA,CAAA,GAAY,QAAA;EAIZ,SAAA,CAAU,EAAA,UAAY,KAAA,EAAO,OAAA,CAAQ,QAAA;EAQrC,SAAA,CAAU,EAAA;EA9LA;EAmMV,gBAAA,CAAiB,KAAA;EAejB,QAAA,CAAA,GAAY,iBAAA;EAgBZ,OAAA,CAAQ,QAAA,EAAU,iBAAA,EAAmB,GAAA;AAAA"}

package/dist/task-store.mjs

@@ -0,0 +1,187 @@
+import { nextRun, parseCron } from "./cron-parser.mjs";
+import { v7 } from "@aigne/uuid";
+
+//#region src/task-store.ts
+const DEFAULT_BUDGET_BLOCKED_TTL = 864e5;
+var TaskStore = class TaskStore {
+	tasks = /* @__PURE__ */ new Map();
+	historyList = [];
+	schedules = /* @__PURE__ */ new Map();
+	constructor(maxHistory = 100, budgetBlockedTTL = DEFAULT_BUDGET_BLOCKED_TTL) {
+		this.maxHistory = maxHistory;
+		this.budgetBlockedTTL = budgetBlockedTTL;
+	}
+	create(taskPath, args, procId, estimate, extras) {
+		const entry = {
+			id: v7(),
+			status: "pending",
+			taskPath,
+			args,
+			estimate,
+			created: Date.now(),
+			attempts: 0,
+			procId,
+			ownerKey: extras?.ownerKey,
+			scheduleId: extras?.scheduleId,
+			jobId: extras?.jobId,
+			batchIndex: extras?.batchIndex,
+			claimable: extras?.claimable,
+			assignee: extras?.assignee,
+			version: v7()
+		};
+		this.tasks.set(entry.id, entry);
+		return entry;
+	}
+	get(id) {
+		return this.tasks.get(id);
+	}
+	getFromHistory(id) {
+		return this.historyList.find((e) => e.id === id);
+	}
+	getAny(id) {
+		return this.tasks.get(id) ?? this.historyList.find((e) => e.id === id);
+	}
+	/** Fields that must never be overwritten via update() */
+	static IMMUTABLE_FIELDS = new Set(["id", "taskPath"]);
+	update(id, patch) {
+		const entry = this.tasks.get(id);
+		if (!entry) throw new Error(`Task ${id} not found in active store`);
+		const safePatch = { ...patch };
+		for (const key of TaskStore.IMMUTABLE_FIELDS) delete safePatch[key];
+		Object.assign(entry, safePatch);
+	}
+	listActive() {
+		return [...this.tasks.values()];
+	}
+	listHistory() {
+		return [...this.historyList];
+	}
+	moveToHistory(id) {
+		const entry = this.tasks.get(id);
+		if (!entry) return;
+		this.tasks.delete(id);
+		this.historyList.push(entry);
+		while (this.historyList.length > this.maxHistory) this.historyList.shift();
+	}
+	restoreFromHistory(id) {
+		const idx = this.historyList.findIndex((e) => e.id === id);
+		if (idx === -1) return void 0;
+		const entry = this.historyList[idx];
+		this.historyList.splice(idx, 1);
+		this.tasks.set(entry.id, entry);
+		return entry;
+	}
+	addSchedule(opts) {
+		parseCron(opts.cron);
+		for (const existing of this.schedules.values()) if (existing.name === opts.name) throw new Error(`Schedule "${opts.name}" already exists`);
+		const now = /* @__PURE__ */ new Date();
+		const entry = {
+			id: v7(),
+			name: opts.name,
+			cron: opts.cron,
+			taskPath: opts.taskPath,
+			args: opts.args,
+			enabled: opts.enabled ?? true,
+			created: Date.now(),
+			ownerKey: opts.ownerKey,
+			nextRun: nextRun(opts.cron, now).getTime()
+		};
+		this.schedules.set(entry.id, entry);
+		return entry;
+	}
+	getSchedule(id) {
+		return this.schedules.get(id);
+	}
+	getScheduleByName(name) {
+		for (const entry of this.schedules.values()) if (entry.name === name) return entry;
+	}
+	listSchedules() {
+		return [...this.schedules.values()];
+	}
+	updateSchedule(id, patch) {
+		const entry = this.schedules.get(id);
+		if (!entry) throw new Error(`Schedule ${id} not found`);
+		const safePatch = { ...patch };
+		delete safePatch.id;
+		Object.assign(entry, safePatch);
+		if (patch.cron) {
+			parseCron(patch.cron);
+			entry.nextRun = nextRun(patch.cron, /* @__PURE__ */ new Date()).getTime();
+		}
+	}
+	removeSchedule(id) {
+		return this.schedules.delete(id);
+	}
+	recordScheduleRun(id, now) {
+		const entry = this.schedules.get(id);
+		if (!entry) return;
+		entry.lastRun = now;
+		entry.nextRun = nextRun(entry.cron, new Date(now)).getTime();
+	}
+	jobs = /* @__PURE__ */ new Map();
+	addJob(job) {
+		this.jobs.set(job.id, job);
+	}
+	getJob(id) {
+		return this.jobs.get(id);
+	}
+	listJobs() {
+		return [...this.jobs.values()];
+	}
+	updateJob(id, patch) {
+		const job = this.jobs.get(id);
+		if (!job) throw new Error(`Job ${id} not found`);
+		const safePatch = { ...patch };
+		delete safePatch.id;
+		Object.assign(job, safePatch);
+	}
+	removeJob(id) {
+		return this.jobs.delete(id);
+	}
+	/** Get the next pending batch index for a job, or -1 if none */
+	nextPendingBatch(jobId) {
+		const job = this.jobs.get(jobId);
+		if (!job) return -1;
+		for (let i = 0; i < job.totalBatches; i++) if (job.mapTaskIds[i] === "") return i;
+		return -1;
+	}
+	snapshot() {
+		const tasks = {};
+		for (const [id, entry] of this.tasks) tasks[id] = { ...entry };
+		const schedules = this.listSchedules().map((s) => ({ ...s }));
+		const jobs = this.listJobs().map((j) => ({ ...j }));
+		return {
+			version: 3,
+			tasks,
+			history: this.historyList.map((e) => ({ ...e })),
+			schedules,
+			jobs
+		};
+	}
+	restore(snapshot, now) {
+		this.tasks.clear();
+		this.historyList = [];
+		this.schedules.clear();
+		this.jobs.clear();
+		for (const [_id, entry] of Object.entries(snapshot.tasks)) if (entry.status === "running" || entry.status === "pending") {
+			entry.status = "failed";
+			entry.error = "Stale: recovered after restart";
+			entry.ended = now;
+			this.historyList.push(entry);
+		} else if (entry.status === "budget-blocked") if (this.budgetBlockedTTL > 0 && now - entry.created > this.budgetBlockedTTL) {
+			entry.status = "failed";
+			entry.error = "Budget-blocked task evicted: exceeded staleness TTL";
+			entry.ended = now;
+			this.historyList.push(entry);
+		} else this.tasks.set(entry.id, entry);
+		else if (entry.status === "done" || entry.status === "failed" || entry.status === "cancelled" || entry.status === "timeout") this.historyList.push(entry);
+		for (const entry of snapshot.history) this.historyList.push(entry);
+		while (this.historyList.length > this.maxHistory) this.historyList.shift();
+		if (snapshot.schedules) for (const schedule of snapshot.schedules) this.schedules.set(schedule.id, { ...schedule });
+		if (snapshot.jobs) for (const job of snapshot.jobs) this.jobs.set(job.id, { ...job });
+	}
+};
+
+//#endregion
+export { TaskStore };
+//# sourceMappingURL=task-store.mjs.map

package/dist/task-store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-store.mjs","names":["cronNextRun"],"sources":["../src/task-store.ts"],"sourcesContent":["import { v7 } from \"@aigne/uuid\";\nimport { nextRun as cronNextRun, parseCron } from \"./cron-parser.js\";\nimport type {\n  BudgetEstimate,\n  JobEntry,\n  ScheduleEntry,\n  SchedulerSnapshot,\n  TaskEntry,\n} from \"./types.js\";\n\nconst DEFAULT_BUDGET_BLOCKED_TTL = 86_400_000; // 24 hours\n\n/** Extra fields for task creation */\ninterface CreateExtras {\n  ownerKey?: string;\n  scheduleId?: string;\n  jobId?: string;\n  batchIndex?: number;\n  /** Claim-based (pull model) task — see #1067. */\n  claimable?: boolean;\n  /** Claim constraint: \"\" = any worker, DID = only that worker. Only meaningful when `claimable`. */\n  assignee?: string;\n}\n\nexport class TaskStore {\n  private tasks = new Map<string, TaskEntry>();\n  private historyList: TaskEntry[] = [];\n  private schedules = new Map<string, ScheduleEntry>();\n\n  constructor(\n    private maxHistory = 100,\n    private budgetBlockedTTL = DEFAULT_BUDGET_BLOCKED_TTL,\n  ) {}\n\n  create(\n    taskPath: string,\n    args?: unknown,\n    procId?: string,\n    estimate?: BudgetEstimate,\n    extras?: CreateExtras,\n  ): TaskEntry {\n    const entry: TaskEntry = {\n      id: v7(),\n      status: \"pending\",\n      taskPath,\n      args,\n      estimate,\n      created: Date.now(),\n      attempts: 0,\n      procId,\n      ownerKey: extras?.ownerKey,\n      scheduleId: extras?.scheduleId,\n      jobId: extras?.jobId,\n      batchIndex: extras?.batchIndex,\n      claimable: extras?.claimable,\n      assignee: extras?.assignee,\n      version: v7(),\n    };\n    this.tasks.set(entry.id, entry);\n    return entry;\n  }\n\n  get(id: string): TaskEntry | undefined {\n    return this.tasks.get(id);\n  }\n\n  getFromHistory(id: string): TaskEntry | undefined {\n    return this.historyList.find((e) => e.id === id);\n  }\n\n  getAny(id: string): TaskEntry | undefined {\n    return this.tasks.get(id) ?? this.historyList.find((e) => e.id === id);\n  }\n\n  /** Fields that must never be overwritten via update() */\n  private static readonly IMMUTABLE_FIELDS = new Set([\"id\", \"taskPath\"]);\n\n  update(id: string, patch: Partial<TaskEntry>): void {\n    const entry = this.tasks.get(id);\n    if (!entry) throw new Error(`Task ${id} not found in active store`);\n    const safePatch = { ...patch };\n    for (const key of TaskStore.IMMUTABLE_FIELDS) {\n      delete (safePatch as Record<string, unknown>)[key];\n    }\n    Object.assign(entry, safePatch);\n  }\n\n  listActive(): TaskEntry[] {\n    return [...this.tasks.values()];\n  }\n\n  listHistory(): TaskEntry[] {\n    return [...this.historyList];\n  }\n\n  moveToHistory(id: string): void {\n    const entry = this.tasks.get(id);\n    if (!entry) return;\n    this.tasks.delete(id);\n    this.historyList.push(entry);\n    while (this.historyList.length > this.maxHistory) {\n      this.historyList.shift();\n    }\n  }\n\n  restoreFromHistory(id: string): TaskEntry | undefined {\n    const idx = this.historyList.findIndex((e) => e.id === id);\n    if (idx === -1) return undefined;\n    const entry = this.historyList[idx]!;\n    this.historyList.splice(idx, 1);\n    this.tasks.set(entry.id, entry);\n    return entry;\n  }\n\n  // ═══════════════════════════════════════════════════════════════\n  // Schedule management\n  // ═══════════════════════════════════════════════════════════════\n\n  addSchedule(opts: {\n    name: string;\n    cron: string;\n    taskPath: string;\n    args?: unknown;\n    enabled?: boolean;\n    ownerKey?: string;\n  }): ScheduleEntry {\n    // Validate cron expression\n    parseCron(opts.cron);\n\n    // Check for duplicate name\n    for (const existing of this.schedules.values()) {\n      if (existing.name === opts.name) {\n        throw new Error(`Schedule \"${opts.name}\" already exists`);\n      }\n    }\n\n    const now = new Date();\n    const entry: ScheduleEntry = {\n      id: v7(),\n      name: opts.name,\n      cron: opts.cron,\n      taskPath: opts.taskPath,\n      args: opts.args,\n      enabled: opts.enabled ?? true,\n      created: Date.now(),\n      ownerKey: opts.ownerKey,\n      nextRun: cronNextRun(opts.cron, now).getTime(),\n    };\n    this.schedules.set(entry.id, entry);\n    return entry;\n  }\n\n  getSchedule(id: string): ScheduleEntry | undefined {\n    return this.schedules.get(id);\n  }\n\n  getScheduleByName(name: string): ScheduleEntry | undefined {\n    for (const entry of this.schedules.values()) {\n      if (entry.name === name) return entry;\n    }\n    return undefined;\n  }\n\n  listSchedules(): ScheduleEntry[] {\n    return [...this.schedules.values()];\n  }\n\n  updateSchedule(id: string, patch: Partial<ScheduleEntry>): void {\n    const entry = this.schedules.get(id);\n    if (!entry) throw new Error(`Schedule ${id} not found`);\n\n    const safePatch = { ...patch };\n    // Never allow changing id\n    delete (safePatch as Record<string, unknown>).id;\n    Object.assign(entry, safePatch);\n\n    // If cron changed, recalculate nextRun\n    if (patch.cron) {\n      parseCron(patch.cron); // validate\n      entry.nextRun = cronNextRun(patch.cron, new Date()).getTime();\n    }\n  }\n\n  removeSchedule(id: string): boolean {\n    return this.schedules.delete(id);\n  }\n\n  recordScheduleRun(id: string, now: number): void {\n    const entry = this.schedules.get(id);\n    if (!entry) return;\n    entry.lastRun = now;\n    entry.nextRun = cronNextRun(entry.cron, new Date(now)).getTime();\n  }\n\n  // ═══════════════════════════════════════════════════════════════\n  // Job management (map-reduce)\n  // ═══════════════════════════════════════════════════════════════\n\n  private jobs = new Map<string, JobEntry>();\n\n  addJob(job: JobEntry): void {\n    this.jobs.set(job.id, job);\n  }\n\n  getJob(id: string): JobEntry | undefined {\n    return this.jobs.get(id);\n  }\n\n  listJobs(): JobEntry[] {\n    return [...this.jobs.values()];\n  }\n\n  updateJob(id: string, patch: Partial<JobEntry>): void {\n    const job = this.jobs.get(id);\n    if (!job) throw new Error(`Job ${id} not found`);\n    const safePatch = { ...patch };\n    delete (safePatch as Record<string, unknown>).id;\n    Object.assign(job, safePatch);\n  }\n\n  removeJob(id: string): boolean {\n    return this.jobs.delete(id);\n  }\n\n  /** Get the next pending batch index for a job, or -1 if none */\n  nextPendingBatch(jobId: string): number {\n    const job = this.jobs.get(jobId);\n    if (!job) return -1;\n    for (let i = 0; i < job.totalBatches; i++) {\n      if (job.mapTaskIds[i] === \"\") {\n        return i;\n      }\n    }\n    return -1;\n  }\n\n  // ═══════════════════════════════════════════════════════════════\n  // Snapshot — v3\n  // ═══════════════════════════════════════════════════════════════\n\n  snapshot(): SchedulerSnapshot {\n    const tasks: Record<string, TaskEntry> = {};\n    for (const [id, entry] of this.tasks) {\n      tasks[id] = { ...entry };\n    }\n    const schedules = this.listSchedules().map((s) => ({ ...s }));\n    const jobs = this.listJobs().map((j) => ({ ...j }));\n    return {\n      version: 3,\n      tasks,\n      history: this.historyList.map((e) => ({ ...e })),\n      schedules,\n      jobs,\n    };\n  }\n\n  restore(snapshot: SchedulerSnapshot, now: number): void {\n    this.tasks.clear();\n    this.historyList = [];\n    this.schedules.clear();\n    this.jobs.clear();\n\n    // Restore task entries with stale detection\n    for (const [_id, entry] of Object.entries(snapshot.tasks)) {\n      if (entry.status === \"running\" || entry.status === \"pending\") {\n        // Stale: mark as failed and move to history\n        entry.status = \"failed\";\n        entry.error = \"Stale: recovered after restart\";\n        entry.ended = now;\n        this.historyList.push(entry);\n      } else if (entry.status === \"budget-blocked\") {\n        // Evict stale budget-blocked tasks that exceeded TTL\n        if (this.budgetBlockedTTL > 0 && now - entry.created > this.budgetBlockedTTL) {\n          entry.status = \"failed\";\n          entry.error = \"Budget-blocked task evicted: exceeded staleness TTL\";\n          entry.ended = now;\n          this.historyList.push(entry);\n        } else {\n          // Budget-blocked tasks stay in active — recoverable via retry\n          this.tasks.set(entry.id, entry);\n        }\n      } else if (\n        entry.status === \"done\" ||\n        entry.status === \"failed\" ||\n        entry.status === \"cancelled\" ||\n        entry.status === \"timeout\"\n      ) {\n        // Terminal entries stuck in active (crash between update and moveToHistory)\n        this.historyList.push(entry);\n      }\n    }\n\n    // Restore history\n    for (const entry of snapshot.history) {\n      this.historyList.push(entry);\n    }\n\n    // Enforce history cap\n    while (this.historyList.length > this.maxHistory) {\n      this.historyList.shift();\n    }\n\n    // Restore schedules (v2+) — missing in v1 snapshots\n    if (snapshot.schedules) {\n      for (const schedule of snapshot.schedules) {\n        this.schedules.set(schedule.id, { ...schedule });\n      }\n    }\n\n    // Restore jobs (v3+) — missing in v1/v2 snapshots\n    if (snapshot.jobs) {\n      for (const job of snapshot.jobs) {\n        this.jobs.set(job.id, { ...job });\n      }\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/types.cjs

@@ -0,0 +1,185 @@
+let zod_v4 = require("zod/v4");
+
+//#region src/types.ts
+const DispatchArgsSchema = zod_v4.z.object({
+	task: zod_v4.z.string().min(1),
+	args: zod_v4.z.unknown().optional(),
+	estimate: zod_v4.z.object({
+		tokens: zod_v4.z.number().int().nonnegative().optional(),
+		duration: zod_v4.z.number().int().nonnegative().optional(),
+		calls: zod_v4.z.number().int().nonnegative().optional()
+	}).optional(),
+	proc: zod_v4.z.object({
+		type: zod_v4.z.enum([
+			"realm",
+			"blocklet",
+			"agent-run",
+			"ash-script",
+			"resource"
+		]),
+		parentId: zod_v4.z.string().optional(),
+		appId: zod_v4.z.string().optional(),
+		budget: zod_v4.z.record(zod_v4.z.string(), zod_v4.z.number().positive()).optional(),
+		timeout: zod_v4.z.number().int().positive().optional()
+	}).optional(),
+	assignee: zod_v4.z.string().optional()
+});
+const CancelArgsSchema = zod_v4.z.object({ taskId: zod_v4.z.string().min(1) });
+const RetryArgsSchema = zod_v4.z.object({ taskId: zod_v4.z.string().min(1) });
+const ScheduleArgsSchema = zod_v4.z.object({
+	name: zod_v4.z.string().min(1),
+	cron: zod_v4.z.string().min(1),
+	task: zod_v4.z.string().min(1),
+	args: zod_v4.z.unknown().optional(),
+	enabled: zod_v4.z.boolean().optional()
+});
+const UnscheduleArgsSchema = zod_v4.z.object({
+	scheduleId: zod_v4.z.string().min(1).optional(),
+	name: zod_v4.z.string().min(1).optional()
+});
+const HeartbeatArgsSchema = zod_v4.z.object({
+	taskId: zod_v4.z.string().min(1),
+	progress: zod_v4.z.unknown().optional()
+});
+const ClaimArgsSchema = zod_v4.z.object({
+	taskId: zod_v4.z.string().min(1),
+	workerId: zod_v4.z.string().min(1),
+	leaseDuration: zod_v4.z.number().int().positive().optional(),
+	ifMatch: zod_v4.z.string().optional()
+});
+const SubmitArgsSchema = zod_v4.z.object({
+	taskId: zod_v4.z.string().min(1),
+	workerId: zod_v4.z.string().min(1),
+	success: zod_v4.z.boolean().optional(),
+	result: zod_v4.z.unknown().optional(),
+	artifacts: zod_v4.z.unknown().optional(),
+	verifyTask: zod_v4.z.string().min(1).optional(),
+	verifyArgs: zod_v4.z.unknown().optional()
+});
+const SubmitJobArgsSchema = zod_v4.z.object({
+	name: zod_v4.z.string().optional(),
+	mapTask: zod_v4.z.string().min(1),
+	reduceTask: zod_v4.z.string().min(1).optional(),
+	totalItems: zod_v4.z.number().int().positive(),
+	batchSize: zod_v4.z.number().int().positive().optional(),
+	concurrency: zod_v4.z.number().int().positive().optional(),
+	args: zod_v4.z.unknown().optional(),
+	timeout: zod_v4.z.number().int().positive().optional()
+});
+const CancelJobArgsSchema = zod_v4.z.object({ jobId: zod_v4.z.string().min(1) });
+/** Zod schema for validating restored snapshots */
+const TaskResultSchema = zod_v4.z.object({
+	success: zod_v4.z.boolean(),
+	data: zod_v4.z.unknown().optional(),
+	error: zod_v4.z.string().optional()
+});
+const BudgetEstimateSchema = zod_v4.z.object({
+	tokens: zod_v4.z.number().nonnegative().optional(),
+	duration: zod_v4.z.number().nonnegative().optional(),
+	calls: zod_v4.z.number().nonnegative().optional()
+});
+const TaskEntrySchema = zod_v4.z.object({
+	id: zod_v4.z.string(),
+	status: zod_v4.z.enum([
+		"pending",
+		"running",
+		"done",
+		"failed",
+		"cancelled",
+		"budget-blocked",
+		"timeout"
+	]),
+	taskPath: zod_v4.z.string(),
+	created: zod_v4.z.number().nonnegative(),
+	attempts: zod_v4.z.number().nonnegative(),
+	args: zod_v4.z.unknown().optional(),
+	estimate: BudgetEstimateSchema.optional(),
+	result: TaskResultSchema.optional(),
+	error: zod_v4.z.string().optional(),
+	started: zod_v4.z.number().nonnegative().optional(),
+	ended: zod_v4.z.number().nonnegative().optional(),
+	procId: zod_v4.z.string().optional(),
+	ownerKey: zod_v4.z.string().optional(),
+	scheduleId: zod_v4.z.string().optional(),
+	deadline: zod_v4.z.number().nonnegative().optional(),
+	lastHeartbeat: zod_v4.z.number().nonnegative().optional(),
+	timeout: zod_v4.z.number().nonnegative().optional(),
+	jobId: zod_v4.z.string().optional(),
+	batchIndex: zod_v4.z.number().int().nonnegative().optional(),
+	claimable: zod_v4.z.boolean().optional(),
+	assignee: zod_v4.z.string().optional(),
+	claimedBy: zod_v4.z.string().optional(),
+	claimedAt: zod_v4.z.number().nonnegative().optional(),
+	version: zod_v4.z.string().optional()
+});
+const ScheduleEntrySchema = zod_v4.z.object({
+	id: zod_v4.z.string(),
+	name: zod_v4.z.string(),
+	cron: zod_v4.z.string(),
+	taskPath: zod_v4.z.string(),
+	args: zod_v4.z.unknown().optional(),
+	enabled: zod_v4.z.boolean(),
+	created: zod_v4.z.number().nonnegative(),
+	ownerKey: zod_v4.z.string().optional(),
+	lastRun: zod_v4.z.number().nonnegative().optional(),
+	nextRun: zod_v4.z.number().nonnegative().optional()
+});
+const JobProgressSchema = zod_v4.z.object({
+	pending: zod_v4.z.number().int().nonnegative(),
+	running: zod_v4.z.number().int().nonnegative(),
+	done: zod_v4.z.number().int().nonnegative(),
+	failed: zod_v4.z.number().int().nonnegative()
+});
+const JobEntrySchema = zod_v4.z.object({
+	id: zod_v4.z.string(),
+	name: zod_v4.z.string().optional(),
+	status: zod_v4.z.enum([
+		"pending",
+		"mapping",
+		"reducing",
+		"done",
+		"failed",
+		"cancelled"
+	]),
+	mapTask: zod_v4.z.string(),
+	reduceTask: zod_v4.z.string().optional(),
+	args: zod_v4.z.unknown().optional(),
+	totalItems: zod_v4.z.number().int().positive(),
+	batchSize: zod_v4.z.number().int().positive(),
+	concurrency: zod_v4.z.number().int().positive(),
+	timeout: zod_v4.z.number().int().positive().optional(),
+	totalBatches: zod_v4.z.number().int().nonnegative(),
+	progress: JobProgressSchema,
+	mapTaskIds: zod_v4.z.array(zod_v4.z.string()),
+	reduceTaskId: zod_v4.z.string().optional(),
+	mapResults: zod_v4.z.array(zod_v4.z.unknown()),
+	result: zod_v4.z.unknown().optional(),
+	error: zod_v4.z.string().optional(),
+	created: zod_v4.z.number().nonnegative(),
+	started: zod_v4.z.number().nonnegative().optional(),
+	ended: zod_v4.z.number().nonnegative().optional()
+});
+const SchedulerSnapshotSchema = zod_v4.z.object({
+	version: zod_v4.z.union([
+		zod_v4.z.literal(1),
+		zod_v4.z.literal(2),
+		zod_v4.z.literal(3)
+	]),
+	tasks: zod_v4.z.record(zod_v4.z.string(), TaskEntrySchema),
+	history: zod_v4.z.array(TaskEntrySchema),
+	schedules: zod_v4.z.array(ScheduleEntrySchema).optional(),
+	jobs: zod_v4.z.array(JobEntrySchema).optional()
+});
+
+//#endregion
+exports.CancelArgsSchema = CancelArgsSchema;
+exports.CancelJobArgsSchema = CancelJobArgsSchema;
+exports.ClaimArgsSchema = ClaimArgsSchema;
+exports.DispatchArgsSchema = DispatchArgsSchema;
+exports.HeartbeatArgsSchema = HeartbeatArgsSchema;
+exports.RetryArgsSchema = RetryArgsSchema;
+exports.ScheduleArgsSchema = ScheduleArgsSchema;
+exports.SchedulerSnapshotSchema = SchedulerSnapshotSchema;
+exports.SubmitArgsSchema = SubmitArgsSchema;
+exports.SubmitJobArgsSchema = SubmitJobArgsSchema;
+exports.UnscheduleArgsSchema = UnscheduleArgsSchema;