@aigne/afs-scheduler 1.12.0-beta.5

package/dist/do-executor.d.cts

@@ -0,0 +1,30 @@
+import { DONamespace } from "./do-types.cjs";
+import { TaskContext, TaskExecutor, TaskResult } from "./types.cjs";
+
+//#region src/do-executor.d.ts
+/**
+ * TaskExecutor that delegates execution to a Cloudflare Durable Object.
+ *
+ * Each task gets its own DO instance (idFromName(taskId)), bypassing
+ * the Workers 30-second CPU time limit.
+ *
+ * Error behavior matches LocalExecutor:
+ * - Infrastructure failures (DO crash, network error, non-200) → throws
+ *   → Scheduler marks task as "failed"
+ * - Application results (exec returns { success: false }) → returns TaskResult
+ *   → Scheduler marks task as "done" with the result
+ *
+ * Usage:
+ * ```typescript
+ * new AFSScheduler({ executor: new DOExecutor(env.TASK_DO) })
+ * ```
+ */
+declare class DOExecutor implements TaskExecutor {
+  private doNamespace;
+  constructor(doNamespace: DONamespace);
+  run(taskId: string, taskPath: string, args: unknown, context?: TaskContext): Promise<TaskResult>;
+  cancel(taskId: string): Promise<void>;
+}
+//#endregion
+export { DOExecutor };
+//# sourceMappingURL=do-executor.d.cts.map

package/dist/do-executor.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-executor.d.cts","names":[],"sources":["../src/do-executor.ts"],"mappings":";;;;;;AAoBA;;;;;;;;;;;;;;;cAAa,UAAA,YAAsB,YAAA;EAAA,QACb,WAAA;cAAA,WAAA,EAAa,WAAA;EAE3B,GAAA,CACJ,MAAA,UACA,QAAA,UACA,IAAA,WACA,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,UAAA;EA2BL,MAAA,CAAO,MAAA,WAAiB,OAAA;AAAA"}

package/dist/do-executor.d.mts

@@ -0,0 +1,30 @@
+import { DONamespace } from "./do-types.mjs";
+import { TaskContext, TaskExecutor, TaskResult } from "./types.mjs";
+
+//#region src/do-executor.d.ts
+/**
+ * TaskExecutor that delegates execution to a Cloudflare Durable Object.
+ *
+ * Each task gets its own DO instance (idFromName(taskId)), bypassing
+ * the Workers 30-second CPU time limit.
+ *
+ * Error behavior matches LocalExecutor:
+ * - Infrastructure failures (DO crash, network error, non-200) → throws
+ *   → Scheduler marks task as "failed"
+ * - Application results (exec returns { success: false }) → returns TaskResult
+ *   → Scheduler marks task as "done" with the result
+ *
+ * Usage:
+ * ```typescript
+ * new AFSScheduler({ executor: new DOExecutor(env.TASK_DO) })
+ * ```
+ */
+declare class DOExecutor implements TaskExecutor {
+  private doNamespace;
+  constructor(doNamespace: DONamespace);
+  run(taskId: string, taskPath: string, args: unknown, context?: TaskContext): Promise<TaskResult>;
+  cancel(taskId: string): Promise<void>;
+}
+//#endregion
+export { DOExecutor };
+//# sourceMappingURL=do-executor.d.mts.map

package/dist/do-executor.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-executor.d.mts","names":[],"sources":["../src/do-executor.ts"],"mappings":";;;;;;AAoBA;;;;;;;;;;;;;;;cAAa,UAAA,YAAsB,YAAA;EAAA,QACb,WAAA;cAAA,WAAA,EAAa,WAAA;EAE3B,GAAA,CACJ,MAAA,UACA,QAAA,UACA,IAAA,WACA,OAAA,GAAU,WAAA,GACT,OAAA,CAAQ,UAAA;EA2BL,MAAA,CAAO,MAAA,WAAiB,OAAA;AAAA"}

package/dist/do-executor.mjs

@@ -0,0 +1,59 @@
+//#region src/do-executor.ts
+/**
+* TaskExecutor that delegates execution to a Cloudflare Durable Object.
+*
+* Each task gets its own DO instance (idFromName(taskId)), bypassing
+* the Workers 30-second CPU time limit.
+*
+* Error behavior matches LocalExecutor:
+* - Infrastructure failures (DO crash, network error, non-200) → throws
+*   → Scheduler marks task as "failed"
+* - Application results (exec returns { success: false }) → returns TaskResult
+*   → Scheduler marks task as "done" with the result
+*
+* Usage:
+* ```typescript
+* new AFSScheduler({ executor: new DOExecutor(env.TASK_DO) })
+* ```
+*/
+var DOExecutor = class {
+	constructor(doNamespace) {
+		this.doNamespace = doNamespace;
+	}
+	async run(taskId, taskPath, args, context) {
+		const doId = this.doNamespace.idFromName(taskId);
+		const stub = this.doNamespace.get(doId);
+		const body = {
+			taskId,
+			taskPath,
+			args
+		};
+		if (context) body.context = context;
+		const response = await stub.fetch(new Request("https://task/run", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(body)
+		}));
+		if (!response.ok) {
+			const text = await response.text().catch(() => "");
+			throw new Error(`DO returned ${response.status}: ${text}`);
+		}
+		const result = await response.json();
+		return {
+			success: result.success,
+			data: result.data,
+			error: result.error
+		};
+	}
+	async cancel(taskId) {
+		const doId = this.doNamespace.idFromName(taskId);
+		const stub = this.doNamespace.get(doId);
+		try {
+			await stub.fetch(new Request("https://task/cancel", { method: "POST" }));
+		} catch {}
+	}
+};
+
+//#endregion
+export { DOExecutor };
+//# sourceMappingURL=do-executor.mjs.map

package/dist/do-executor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-executor.mjs","names":[],"sources":["../src/do-executor.ts"],"sourcesContent":["import type { DONamespace, TaskRunRequest, TaskRunResponse } from \"./do-types.js\";\nimport type { TaskContext, TaskExecutor, TaskResult } from \"./types.js\";\n\n/**\n * TaskExecutor that delegates execution to a Cloudflare Durable Object.\n *\n * Each task gets its own DO instance (idFromName(taskId)), bypassing\n * the Workers 30-second CPU time limit.\n *\n * Error behavior matches LocalExecutor:\n * - Infrastructure failures (DO crash, network error, non-200) → throws\n *   → Scheduler marks task as \"failed\"\n * - Application results (exec returns { success: false }) → returns TaskResult\n *   → Scheduler marks task as \"done\" with the result\n *\n * Usage:\n * ```typescript\n * new AFSScheduler({ executor: new DOExecutor(env.TASK_DO) })\n * ```\n */\nexport class DOExecutor implements TaskExecutor {\n  constructor(private doNamespace: DONamespace) {}\n\n  async run(\n    taskId: string,\n    taskPath: string,\n    args: unknown,\n    context?: TaskContext,\n  ): Promise<TaskResult> {\n    const doId = this.doNamespace.idFromName(taskId);\n    const stub = this.doNamespace.get(doId);\n\n    const body: TaskRunRequest = { taskId, taskPath, args };\n    if (context) {\n      body.context = context;\n    }\n\n    // Infrastructure failure → throw → scheduler marks \"failed\"\n    const response = await stub.fetch(\n      new Request(\"https://task/run\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(body),\n      }),\n    );\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new Error(`DO returned ${response.status}: ${text}`);\n    }\n\n    const result: TaskRunResponse = await response.json();\n    return { success: result.success, data: result.data, error: result.error };\n  }\n\n  async cancel(taskId: string): Promise<void> {\n    const doId = this.doNamespace.idFromName(taskId);\n    const stub = this.doNamespace.get(doId);\n    try {\n      await stub.fetch(new Request(\"https://task/cancel\", { method: \"POST\" }));\n    } catch {\n      // Best-effort cancel — DO might already be gone\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,IAAa,aAAb,MAAgD;CAC9C,YAAY,AAAQ,aAA0B;EAA1B;;CAEpB,MAAM,IACJ,QACA,UACA,MACA,SACqB;EACrB,MAAM,OAAO,KAAK,YAAY,WAAW,OAAO;EAChD,MAAM,OAAO,KAAK,YAAY,IAAI,KAAK;EAEvC,MAAM,OAAuB;GAAE;GAAQ;GAAU;GAAM;AACvD,MAAI,QACF,MAAK,UAAU;EAIjB,MAAM,WAAW,MAAM,KAAK,MAC1B,IAAI,QAAQ,oBAAoB;GAC9B,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAC/C,MAAM,KAAK,UAAU,KAAK;GAC3B,CAAC,CACH;AAED,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,OAAO,MAAM,SAAS,MAAM,CAAC,YAAY,GAAG;AAClD,SAAM,IAAI,MAAM,eAAe,SAAS,OAAO,IAAI,OAAO;;EAG5D,MAAM,SAA0B,MAAM,SAAS,MAAM;AACrD,SAAO;GAAE,SAAS,OAAO;GAAS,MAAM,OAAO;GAAM,OAAO,OAAO;GAAO;;CAG5E,MAAM,OAAO,QAA+B;EAC1C,MAAM,OAAO,KAAK,YAAY,WAAW,OAAO;EAChD,MAAM,OAAO,KAAK,YAAY,IAAI,KAAK;AACvC,MAAI;AACF,SAAM,KAAK,MAAM,IAAI,QAAQ,uBAAuB,EAAE,QAAQ,QAAQ,CAAC,CAAC;UAClE"}

package/dist/do-job-executor.cjs

@@ -0,0 +1,53 @@
+
+//#region src/do-job-executor.ts
+/**
+* Client for communicating with Coordinator DOs.
+*
+* Each job maps to one Coordinator DO instance (idFromName(jobId)).
+* The Coordinator DO manages the full map-reduce lifecycle:
+* wave dispatch, alarm chaining, reduce phase.
+*
+* Usage in a CF Worker:
+* ```typescript
+* const jobExecutor = new DOJobExecutor(env.COORDINATOR_DO);
+* ```
+*/
+var DOJobExecutor = class {
+	constructor(coordinatorNamespace) {
+		this.coordinatorNamespace = coordinatorNamespace;
+	}
+	async submitJob(request) {
+		const doId = this.coordinatorNamespace.idFromName(request.jobId);
+		const response = await this.coordinatorNamespace.get(doId).fetch(new Request("https://coordinator/start", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(request)
+		}));
+		if (!response.ok) {
+			const text = await response.text().catch(() => "");
+			throw new Error(`Coordinator returned ${response.status}: ${text}`);
+		}
+		return { jobId: (await response.json()).jobId };
+	}
+	async cancelJob(jobId) {
+		const doId = this.coordinatorNamespace.idFromName(jobId);
+		const response = await this.coordinatorNamespace.get(doId).fetch(new Request("https://coordinator/cancel", { method: "POST" }));
+		if (!response.ok) {
+			const text = await response.text().catch(() => "");
+			throw new Error(`Coordinator cancel returned ${response.status}: ${text}`);
+		}
+	}
+	async getStatus(jobId) {
+		const doId = this.coordinatorNamespace.idFromName(jobId);
+		const response = await this.coordinatorNamespace.get(doId).fetch(new Request("https://coordinator/status", { method: "GET" }));
+		if (response.status === 404) return;
+		if (!response.ok) {
+			const text = await response.text().catch(() => "");
+			throw new Error(`Coordinator status returned ${response.status}: ${text}`);
+		}
+		return await response.json();
+	}
+};
+
+//#endregion
+exports.DOJobExecutor = DOJobExecutor;

package/dist/do-job-executor.d.cts

@@ -0,0 +1,28 @@
+import { DONamespace, JobStartRequest } from "./do-types.cjs";
+import { JobEntry } from "./types.cjs";
+
+//#region src/do-job-executor.d.ts
+/**
+ * Client for communicating with Coordinator DOs.
+ *
+ * Each job maps to one Coordinator DO instance (idFromName(jobId)).
+ * The Coordinator DO manages the full map-reduce lifecycle:
+ * wave dispatch, alarm chaining, reduce phase.
+ *
+ * Usage in a CF Worker:
+ * ```typescript
+ * const jobExecutor = new DOJobExecutor(env.COORDINATOR_DO);
+ * ```
+ */
+declare class DOJobExecutor {
+  private coordinatorNamespace;
+  constructor(coordinatorNamespace: DONamespace);
+  submitJob(request: JobStartRequest): Promise<{
+    jobId: string;
+  }>;
+  cancelJob(jobId: string): Promise<void>;
+  getStatus(jobId: string): Promise<JobEntry | undefined>;
+}
+//#endregion
+export { DOJobExecutor };
+//# sourceMappingURL=do-job-executor.d.cts.map

package/dist/do-job-executor.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-job-executor.d.cts","names":[],"sources":["../src/do-job-executor.ts"],"mappings":";;;;;;AAeA;;;;;;;;;;cAAa,aAAA;EAAA,QACS,oBAAA;cAAA,oBAAA,EAAsB,WAAA;EAEpC,SAAA,CAAU,OAAA,EAAS,eAAA,GAAkB,OAAA;IAAU,KAAA;EAAA;EAqB/C,SAAA,CAAU,KAAA,WAAgB,OAAA;EAc1B,SAAA,CAAU,KAAA,WAAgB,OAAA,CAAQ,QAAA;AAAA"}

package/dist/do-job-executor.d.mts

@@ -0,0 +1,28 @@
+import { DONamespace, JobStartRequest } from "./do-types.mjs";
+import { JobEntry } from "./types.mjs";
+
+//#region src/do-job-executor.d.ts
+/**
+ * Client for communicating with Coordinator DOs.
+ *
+ * Each job maps to one Coordinator DO instance (idFromName(jobId)).
+ * The Coordinator DO manages the full map-reduce lifecycle:
+ * wave dispatch, alarm chaining, reduce phase.
+ *
+ * Usage in a CF Worker:
+ * ```typescript
+ * const jobExecutor = new DOJobExecutor(env.COORDINATOR_DO);
+ * ```
+ */
+declare class DOJobExecutor {
+  private coordinatorNamespace;
+  constructor(coordinatorNamespace: DONamespace);
+  submitJob(request: JobStartRequest): Promise<{
+    jobId: string;
+  }>;
+  cancelJob(jobId: string): Promise<void>;
+  getStatus(jobId: string): Promise<JobEntry | undefined>;
+}
+//#endregion
+export { DOJobExecutor };
+//# sourceMappingURL=do-job-executor.d.mts.map

package/dist/do-job-executor.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-job-executor.d.mts","names":[],"sources":["../src/do-job-executor.ts"],"mappings":";;;;;;AAeA;;;;;;;;;;cAAa,aAAA;EAAA,QACS,oBAAA;cAAA,oBAAA,EAAsB,WAAA;EAEpC,SAAA,CAAU,OAAA,EAAS,eAAA,GAAkB,OAAA;IAAU,KAAA;EAAA;EAqB/C,SAAA,CAAU,KAAA,WAAgB,OAAA;EAc1B,SAAA,CAAU,KAAA,WAAgB,OAAA,CAAQ,QAAA;AAAA"}

package/dist/do-job-executor.mjs

@@ -0,0 +1,53 @@
+//#region src/do-job-executor.ts
+/**
+* Client for communicating with Coordinator DOs.
+*
+* Each job maps to one Coordinator DO instance (idFromName(jobId)).
+* The Coordinator DO manages the full map-reduce lifecycle:
+* wave dispatch, alarm chaining, reduce phase.
+*
+* Usage in a CF Worker:
+* ```typescript
+* const jobExecutor = new DOJobExecutor(env.COORDINATOR_DO);
+* ```
+*/
+var DOJobExecutor = class {
+	constructor(coordinatorNamespace) {
+		this.coordinatorNamespace = coordinatorNamespace;
+	}
+	async submitJob(request) {
+		const doId = this.coordinatorNamespace.idFromName(request.jobId);
+		const response = await this.coordinatorNamespace.get(doId).fetch(new Request("https://coordinator/start", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(request)
+		}));
+		if (!response.ok) {
+			const text = await response.text().catch(() => "");
+			throw new Error(`Coordinator returned ${response.status}: ${text}`);
+		}
+		return { jobId: (await response.json()).jobId };
+	}
+	async cancelJob(jobId) {
+		const doId = this.coordinatorNamespace.idFromName(jobId);
+		const response = await this.coordinatorNamespace.get(doId).fetch(new Request("https://coordinator/cancel", { method: "POST" }));
+		if (!response.ok) {
+			const text = await response.text().catch(() => "");
+			throw new Error(`Coordinator cancel returned ${response.status}: ${text}`);
+		}
+	}
+	async getStatus(jobId) {
+		const doId = this.coordinatorNamespace.idFromName(jobId);
+		const response = await this.coordinatorNamespace.get(doId).fetch(new Request("https://coordinator/status", { method: "GET" }));
+		if (response.status === 404) return;
+		if (!response.ok) {
+			const text = await response.text().catch(() => "");
+			throw new Error(`Coordinator status returned ${response.status}: ${text}`);
+		}
+		return await response.json();
+	}
+};
+
+//#endregion
+export { DOJobExecutor };
+//# sourceMappingURL=do-job-executor.mjs.map

package/dist/do-job-executor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-job-executor.mjs","names":[],"sources":["../src/do-job-executor.ts"],"sourcesContent":["import type { DONamespace, JobStartRequest } from \"./do-types.js\";\nimport type { JobEntry } from \"./types.js\";\n\n/**\n * Client for communicating with Coordinator DOs.\n *\n * Each job maps to one Coordinator DO instance (idFromName(jobId)).\n * The Coordinator DO manages the full map-reduce lifecycle:\n * wave dispatch, alarm chaining, reduce phase.\n *\n * Usage in a CF Worker:\n * ```typescript\n * const jobExecutor = new DOJobExecutor(env.COORDINATOR_DO);\n * ```\n */\nexport class DOJobExecutor {\n  constructor(private coordinatorNamespace: DONamespace) {}\n\n  async submitJob(request: JobStartRequest): Promise<{ jobId: string }> {\n    const doId = this.coordinatorNamespace.idFromName(request.jobId);\n    const stub = this.coordinatorNamespace.get(doId);\n\n    const response = await stub.fetch(\n      new Request(\"https://coordinator/start\", {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify(request),\n      }),\n    );\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new Error(`Coordinator returned ${response.status}: ${text}`);\n    }\n\n    const result = (await response.json()) as { success: boolean; jobId: string };\n    return { jobId: result.jobId };\n  }\n\n  async cancelJob(jobId: string): Promise<void> {\n    const doId = this.coordinatorNamespace.idFromName(jobId);\n    const stub = this.coordinatorNamespace.get(doId);\n\n    const response = await stub.fetch(\n      new Request(\"https://coordinator/cancel\", { method: \"POST\" }),\n    );\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new Error(`Coordinator cancel returned ${response.status}: ${text}`);\n    }\n  }\n\n  async getStatus(jobId: string): Promise<JobEntry | undefined> {\n    const doId = this.coordinatorNamespace.idFromName(jobId);\n    const stub = this.coordinatorNamespace.get(doId);\n\n    const response = await stub.fetch(new Request(\"https://coordinator/status\", { method: \"GET\" }));\n\n    if (response.status === 404) {\n      return undefined;\n    }\n\n    if (!response.ok) {\n      const text = await response.text().catch(() => \"\");\n      throw new Error(`Coordinator status returned ${response.status}: ${text}`);\n    }\n\n    return (await response.json()) as JobEntry;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,IAAa,gBAAb,MAA2B;CACzB,YAAY,AAAQ,sBAAmC;EAAnC;;CAEpB,MAAM,UAAU,SAAsD;EACpE,MAAM,OAAO,KAAK,qBAAqB,WAAW,QAAQ,MAAM;EAGhE,MAAM,WAAW,MAFJ,KAAK,qBAAqB,IAAI,KAAK,CAEpB,MAC1B,IAAI,QAAQ,6BAA6B;GACvC,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAC/C,MAAM,KAAK,UAAU,QAAQ;GAC9B,CAAC,CACH;AAED,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,OAAO,MAAM,SAAS,MAAM,CAAC,YAAY,GAAG;AAClD,SAAM,IAAI,MAAM,wBAAwB,SAAS,OAAO,IAAI,OAAO;;AAIrE,SAAO,EAAE,QADO,MAAM,SAAS,MAAM,EACd,OAAO;;CAGhC,MAAM,UAAU,OAA8B;EAC5C,MAAM,OAAO,KAAK,qBAAqB,WAAW,MAAM;EAGxD,MAAM,WAAW,MAFJ,KAAK,qBAAqB,IAAI,KAAK,CAEpB,MAC1B,IAAI,QAAQ,8BAA8B,EAAE,QAAQ,QAAQ,CAAC,CAC9D;AAED,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,OAAO,MAAM,SAAS,MAAM,CAAC,YAAY,GAAG;AAClD,SAAM,IAAI,MAAM,+BAA+B,SAAS,OAAO,IAAI,OAAO;;;CAI9E,MAAM,UAAU,OAA8C;EAC5D,MAAM,OAAO,KAAK,qBAAqB,WAAW,MAAM;EAGxD,MAAM,WAAW,MAFJ,KAAK,qBAAqB,IAAI,KAAK,CAEpB,MAAM,IAAI,QAAQ,8BAA8B,EAAE,QAAQ,OAAO,CAAC,CAAC;AAE/F,MAAI,SAAS,WAAW,IACtB;AAGF,MAAI,CAAC,SAAS,IAAI;GAChB,MAAM,OAAO,MAAM,SAAS,MAAM,CAAC,YAAY,GAAG;AAClD,SAAM,IAAI,MAAM,+BAA+B,SAAS,OAAO,IAAI,OAAO;;AAG5E,SAAQ,MAAM,SAAS,MAAM"}

package/dist/do-types.d.cts

@@ -0,0 +1,66 @@
+//#region src/do-types.d.ts
+/**
+ * Minimal interfaces matching Cloudflare Durable Object APIs.
+ * Any implementation satisfying these can be used with DOExecutor —
+ * no @cloudflare/workers-types dependency needed.
+ */
+/** Matches CF DurableObjectNamespace */
+interface DONamespace {
+  idFromName(name: string): DOId;
+  get(id: DOId): DOStub;
+}
+/** Opaque identifier for a Durable Object instance */
+interface DOId {
+  toString(): string;
+}
+/** Stub for communicating with a Durable Object */
+interface DOStub {
+  fetch(request: Request): Promise<Response>;
+}
+/** Request body sent to TaskRunner DO /run endpoint */
+interface TaskRunRequest {
+  taskId: string;
+  taskPath: string;
+  args: unknown;
+  context?: {
+    procId?: string;
+  };
+}
+/** Response body from TaskRunner DO /run endpoint */
+interface TaskRunResponse {
+  success: boolean;
+  data?: unknown;
+  error?: string;
+}
+/** Minimal subset of Cloudflare DurableObjectStorage */
+interface DOStorage {
+  get<T>(key: string): Promise<T | undefined>;
+  put(key: string, value: unknown): Promise<void>;
+  delete(key: string): Promise<boolean>;
+  setAlarm(scheduledTime: number | Date): Promise<void>;
+  deleteAlarm(): Promise<void>;
+}
+/** Minimal subset of Cloudflare DurableObjectState */
+interface DOState {
+  storage: DOStorage;
+  id: DOId;
+}
+/** Request body for Coordinator DO POST /start */
+interface JobStartRequest {
+  jobId: string;
+  name?: string;
+  mapTask: string;
+  reduceTask?: string;
+  totalItems: number;
+  batchSize: number;
+  concurrency: number;
+  args?: unknown;
+  timeout?: number;
+}
+/** Environment bindings the Coordinator DO expects */
+interface JobCoordinatorEnv {
+  TASK_DO: DONamespace;
+}
+//#endregion
+export { DOId, DONamespace, DOState, DOStorage, DOStub, JobCoordinatorEnv, JobStartRequest, TaskRunRequest, TaskRunResponse };
+//# sourceMappingURL=do-types.d.cts.map

package/dist/do-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-types.d.cts","names":[],"sources":["../src/do-types.ts"],"mappings":";;AASA;;;;;UAAiB,WAAA;EACf,UAAA,CAAW,IAAA,WAAe,IAAA;EAC1B,GAAA,CAAI,EAAA,EAAI,IAAA,GAAO,MAAA;AAAA;;UAIA,IAAA;EACf,QAAA;AAAA;;UAIe,MAAA;EACf,KAAA,CAAM,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,QAAA;AAAA;AANnC;AAAA,UAYiB,cAAA;EACf,MAAA;EACA,QAAA;EACA,IAAA;EACA,OAAA;IAAY,MAAA;EAAA;AAAA;;UAIG,eAAA;EACf,OAAA;EACA,IAAA;EACA,KAAA;AAAA;;UAMe,SAAA;EACf,GAAA,IAAO,GAAA,WAAc,OAAA,CAAQ,CAAA;EAC7B,GAAA,CAAI,GAAA,UAAa,KAAA,YAAiB,OAAA;EAClC,MAAA,CAAO,GAAA,WAAc,OAAA;EACrB,QAAA,CAAS,aAAA,WAAwB,IAAA,GAAO,OAAA;EACxC,WAAA,IAAe,OAAA;AAAA;;UAIA,OAAA;EACf,OAAA,EAAS,SAAA;EACT,EAAA,EAAI,IAAA;AAAA;;UAMW,eAAA;EACf,KAAA;EACA,IAAA;EACA,OAAA;EACA,UAAA;EACA,UAAA;EACA,SAAA;EACA,WAAA;EACA,IAAA;EACA,OAAA;AAAA;AA1BF;AAAA,UA8BiB,iBAAA;EACf,OAAA,EAAS,WAAA;AAAA"}

package/dist/do-types.d.mts

@@ -0,0 +1,66 @@
+//#region src/do-types.d.ts
+/**
+ * Minimal interfaces matching Cloudflare Durable Object APIs.
+ * Any implementation satisfying these can be used with DOExecutor —
+ * no @cloudflare/workers-types dependency needed.
+ */
+/** Matches CF DurableObjectNamespace */
+interface DONamespace {
+  idFromName(name: string): DOId;
+  get(id: DOId): DOStub;
+}
+/** Opaque identifier for a Durable Object instance */
+interface DOId {
+  toString(): string;
+}
+/** Stub for communicating with a Durable Object */
+interface DOStub {
+  fetch(request: Request): Promise<Response>;
+}
+/** Request body sent to TaskRunner DO /run endpoint */
+interface TaskRunRequest {
+  taskId: string;
+  taskPath: string;
+  args: unknown;
+  context?: {
+    procId?: string;
+  };
+}
+/** Response body from TaskRunner DO /run endpoint */
+interface TaskRunResponse {
+  success: boolean;
+  data?: unknown;
+  error?: string;
+}
+/** Minimal subset of Cloudflare DurableObjectStorage */
+interface DOStorage {
+  get<T>(key: string): Promise<T | undefined>;
+  put(key: string, value: unknown): Promise<void>;
+  delete(key: string): Promise<boolean>;
+  setAlarm(scheduledTime: number | Date): Promise<void>;
+  deleteAlarm(): Promise<void>;
+}
+/** Minimal subset of Cloudflare DurableObjectState */
+interface DOState {
+  storage: DOStorage;
+  id: DOId;
+}
+/** Request body for Coordinator DO POST /start */
+interface JobStartRequest {
+  jobId: string;
+  name?: string;
+  mapTask: string;
+  reduceTask?: string;
+  totalItems: number;
+  batchSize: number;
+  concurrency: number;
+  args?: unknown;
+  timeout?: number;
+}
+/** Environment bindings the Coordinator DO expects */
+interface JobCoordinatorEnv {
+  TASK_DO: DONamespace;
+}
+//#endregion
+export { DOId, DONamespace, DOState, DOStorage, DOStub, JobCoordinatorEnv, JobStartRequest, TaskRunRequest, TaskRunResponse };
+//# sourceMappingURL=do-types.d.mts.map

package/dist/do-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do-types.d.mts","names":[],"sources":["../src/do-types.ts"],"mappings":";;AASA;;;;;UAAiB,WAAA;EACf,UAAA,CAAW,IAAA,WAAe,IAAA;EAC1B,GAAA,CAAI,EAAA,EAAI,IAAA,GAAO,MAAA;AAAA;;UAIA,IAAA;EACf,QAAA;AAAA;;UAIe,MAAA;EACf,KAAA,CAAM,OAAA,EAAS,OAAA,GAAU,OAAA,CAAQ,QAAA;AAAA;AANnC;AAAA,UAYiB,cAAA;EACf,MAAA;EACA,QAAA;EACA,IAAA;EACA,OAAA;IAAY,MAAA;EAAA;AAAA;;UAIG,eAAA;EACf,OAAA;EACA,IAAA;EACA,KAAA;AAAA;;UAMe,SAAA;EACf,GAAA,IAAO,GAAA,WAAc,OAAA,CAAQ,CAAA;EAC7B,GAAA,CAAI,GAAA,UAAa,KAAA,YAAiB,OAAA;EAClC,MAAA,CAAO,GAAA,WAAc,OAAA;EACrB,QAAA,CAAS,aAAA,WAAwB,IAAA,GAAO,OAAA;EACxC,WAAA,IAAe,OAAA;AAAA;;UAIA,OAAA;EACf,OAAA,EAAS,SAAA;EACT,EAAA,EAAI,IAAA;AAAA;;UAMW,eAAA;EACf,KAAA;EACA,IAAA;EACA,OAAA;EACA,UAAA;EACA,UAAA;EACA,SAAA;EACA,WAAA;EACA,IAAA;EACA,OAAA;AAAA;AA1BF;AAAA,UA8BiB,iBAAA;EACf,OAAA,EAAS,WAAA;AAAA"}

package/dist/index.cjs

@@ -0,0 +1,34 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_cron_parser = require('./cron-parser.cjs');
+const require_do_executor = require('./do-executor.cjs');
+const require_do_job_executor = require('./do-job-executor.cjs');
+const require_job_coordinator = require('./job-coordinator.cjs');
+const require_local_executor = require('./local-executor.cjs');
+const require_task_store = require('./task-store.cjs');
+const require_types = require('./types.cjs');
+const require_scheduler_provider = require('./scheduler-provider.cjs');
+const require_task_runner = require('./task-runner.cjs');
+
+exports.AFSScheduler = require_scheduler_provider.AFSScheduler;
+exports.CancelArgsSchema = require_types.CancelArgsSchema;
+exports.CancelJobArgsSchema = require_types.CancelJobArgsSchema;
+exports.ClaimArgsSchema = require_types.ClaimArgsSchema;
+exports.DOExecutor = require_do_executor.DOExecutor;
+exports.DOJobExecutor = require_do_job_executor.DOJobExecutor;
+exports.DispatchArgsSchema = require_types.DispatchArgsSchema;
+exports.HeartbeatArgsSchema = require_types.HeartbeatArgsSchema;
+exports.LocalExecutor = require_local_executor.LocalExecutor;
+exports.RetryArgsSchema = require_types.RetryArgsSchema;
+exports.ScheduleArgsSchema = require_types.ScheduleArgsSchema;
+exports.SchedulerSnapshotSchema = require_types.SchedulerSnapshotSchema;
+exports.SubmitArgsSchema = require_types.SubmitArgsSchema;
+exports.SubmitJobArgsSchema = require_types.SubmitJobArgsSchema;
+exports.TaskStore = require_task_store.TaskStore;
+exports.UnscheduleArgsSchema = require_types.UnscheduleArgsSchema;
+exports.default = require_scheduler_provider.AFSScheduler;
+exports.handleJobCoordinatorAlarm = require_job_coordinator.handleJobCoordinatorAlarm;
+exports.handleJobCoordinatorRequest = require_job_coordinator.handleJobCoordinatorRequest;
+exports.handleTaskRequest = require_task_runner.handleTaskRequest;
+exports.isDue = require_cron_parser.isDue;
+exports.nextRun = require_cron_parser.nextRun;
+exports.parseCron = require_cron_parser.parseCron;

package/dist/index.d.cts

@@ -0,0 +1,11 @@
+import { CronExpression, CronPart, isDue, nextRun, parseCron } from "./cron-parser.cjs";
+import { DOId, DONamespace, DOState, DOStorage, DOStub, JobCoordinatorEnv, JobStartRequest, TaskRunRequest, TaskRunResponse } from "./do-types.cjs";
+import { BudgetEstimate, CancelArgs, CancelArgsSchema, CancelJobArgs, CancelJobArgsSchema, ClaimArgs, ClaimArgsSchema, DispatchArgs, DispatchArgsSchema, HeartbeatArgs, HeartbeatArgsSchema, JobEntry, JobProgress, JobStatus, RetryArgs, RetryArgsSchema, ScheduleArgs, ScheduleArgsSchema, ScheduleEntry, SchedulerProviderOptions, SchedulerSnapshot, SchedulerSnapshotSchema, SubmitArgs, SubmitArgsSchema, SubmitJobArgs, SubmitJobArgsSchema, TaskContext, TaskEntry, TaskExecutor, TaskResult, TaskStatus, TickResult, UnscheduleArgs, UnscheduleArgsSchema } from "./types.cjs";
+import { DOExecutor } from "./do-executor.cjs";
+import { DOJobExecutor } from "./do-job-executor.cjs";
+import { handleJobCoordinatorAlarm, handleJobCoordinatorRequest } from "./job-coordinator.cjs";
+import { LocalExecutor } from "./local-executor.cjs";
+import { TaskStore } from "./task-store.cjs";
+import { AFSScheduler } from "./scheduler-provider.cjs";
+import { handleTaskRequest } from "./task-runner.cjs";
+export { AFSScheduler, type BudgetEstimate, type CancelArgs, CancelArgsSchema, type CancelJobArgs, CancelJobArgsSchema, type ClaimArgs, ClaimArgsSchema, type CronExpression, type CronPart, DOExecutor, type DOId, DOJobExecutor, type DONamespace, type DOState, type DOStorage, type DOStub, type DispatchArgs, DispatchArgsSchema, type HeartbeatArgs, HeartbeatArgsSchema, type JobCoordinatorEnv, type JobEntry, type JobProgress, type JobStartRequest, type JobStatus, LocalExecutor, type RetryArgs, RetryArgsSchema, type ScheduleArgs, ScheduleArgsSchema, type ScheduleEntry, type SchedulerProviderOptions, type SchedulerSnapshot, SchedulerSnapshotSchema, type SubmitArgs, SubmitArgsSchema, type SubmitJobArgs, SubmitJobArgsSchema, type TaskContext, type TaskEntry, type TaskExecutor, type TaskResult, type TaskRunRequest, type TaskRunResponse, type TaskStatus, TaskStore, type TickResult, type UnscheduleArgs, UnscheduleArgsSchema, AFSScheduler as default, handleJobCoordinatorAlarm, handleJobCoordinatorRequest, handleTaskRequest, isDue, nextRun, parseCron };

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import { CronExpression, CronPart, isDue, nextRun, parseCron } from "./cron-parser.mjs";
+import { DOId, DONamespace, DOState, DOStorage, DOStub, JobCoordinatorEnv, JobStartRequest, TaskRunRequest, TaskRunResponse } from "./do-types.mjs";
+import { BudgetEstimate, CancelArgs, CancelArgsSchema, CancelJobArgs, CancelJobArgsSchema, ClaimArgs, ClaimArgsSchema, DispatchArgs, DispatchArgsSchema, HeartbeatArgs, HeartbeatArgsSchema, JobEntry, JobProgress, JobStatus, RetryArgs, RetryArgsSchema, ScheduleArgs, ScheduleArgsSchema, ScheduleEntry, SchedulerProviderOptions, SchedulerSnapshot, SchedulerSnapshotSchema, SubmitArgs, SubmitArgsSchema, SubmitJobArgs, SubmitJobArgsSchema, TaskContext, TaskEntry, TaskExecutor, TaskResult, TaskStatus, TickResult, UnscheduleArgs, UnscheduleArgsSchema } from "./types.mjs";
+import { DOExecutor } from "./do-executor.mjs";
+import { DOJobExecutor } from "./do-job-executor.mjs";
+import { handleJobCoordinatorAlarm, handleJobCoordinatorRequest } from "./job-coordinator.mjs";
+import { LocalExecutor } from "./local-executor.mjs";
+import { TaskStore } from "./task-store.mjs";
+import { AFSScheduler } from "./scheduler-provider.mjs";
+import { handleTaskRequest } from "./task-runner.mjs";
+export { AFSScheduler, type BudgetEstimate, type CancelArgs, CancelArgsSchema, type CancelJobArgs, CancelJobArgsSchema, type ClaimArgs, ClaimArgsSchema, type CronExpression, type CronPart, DOExecutor, type DOId, DOJobExecutor, type DONamespace, type DOState, type DOStorage, type DOStub, type DispatchArgs, DispatchArgsSchema, type HeartbeatArgs, HeartbeatArgsSchema, type JobCoordinatorEnv, type JobEntry, type JobProgress, type JobStartRequest, type JobStatus, LocalExecutor, type RetryArgs, RetryArgsSchema, type ScheduleArgs, ScheduleArgsSchema, type ScheduleEntry, type SchedulerProviderOptions, type SchedulerSnapshot, SchedulerSnapshotSchema, type SubmitArgs, SubmitArgsSchema, type SubmitJobArgs, SubmitJobArgsSchema, type TaskContext, type TaskEntry, type TaskExecutor, type TaskResult, type TaskRunRequest, type TaskRunResponse, type TaskStatus, TaskStore, type TickResult, type UnscheduleArgs, UnscheduleArgsSchema, AFSScheduler as default, handleJobCoordinatorAlarm, handleJobCoordinatorRequest, handleTaskRequest, isDue, nextRun, parseCron };

package/dist/index.mjs

@@ -0,0 +1,11 @@
+import { isDue, nextRun, parseCron } from "./cron-parser.mjs";
+import { DOExecutor } from "./do-executor.mjs";
+import { DOJobExecutor } from "./do-job-executor.mjs";
+import { handleJobCoordinatorAlarm, handleJobCoordinatorRequest } from "./job-coordinator.mjs";
+import { LocalExecutor } from "./local-executor.mjs";
+import { TaskStore } from "./task-store.mjs";
+import { CancelArgsSchema, CancelJobArgsSchema, ClaimArgsSchema, DispatchArgsSchema, HeartbeatArgsSchema, RetryArgsSchema, ScheduleArgsSchema, SchedulerSnapshotSchema, SubmitArgsSchema, SubmitJobArgsSchema, UnscheduleArgsSchema } from "./types.mjs";
+import { AFSScheduler } from "./scheduler-provider.mjs";
+import { handleTaskRequest } from "./task-runner.mjs";
+
+export { AFSScheduler, CancelArgsSchema, CancelJobArgsSchema, ClaimArgsSchema, DOExecutor, DOJobExecutor, DispatchArgsSchema, HeartbeatArgsSchema, LocalExecutor, RetryArgsSchema, ScheduleArgsSchema, SchedulerSnapshotSchema, SubmitArgsSchema, SubmitJobArgsSchema, TaskStore, UnscheduleArgsSchema, AFSScheduler as default, handleJobCoordinatorAlarm, handleJobCoordinatorRequest, handleTaskRequest, isDue, nextRun, parseCron };