@minpeter/pss-runtime 0.1.0-next.1 → 0.1.0-next.3

package/dist/cloudflare/cloudflare-host.d.ts

@@ -0,0 +1,61 @@
+import { SessionStore } from "../session/store/types.js";
+import { ExecutionHost, ExecutionScheduler } from "../execution/types.js";
+import { CloudflareDurableObjectStorage as CloudflareDurableObjectStorage$1, InMemoryCloudflareDurableObjectStorage as InMemoryCloudflareDurableObjectStorage$1 } from "./durable-object-storage.js";
+
+//#region src/cloudflare/cloudflare-host.d.ts
+interface CloudflareScheduledSessionPrompt {
+  readonly idempotencyKey?: string;
+  readonly notificationId?: string;
+  readonly runId?: string;
+  readonly sessionKey: string;
+}
+type CloudflareDurableObjectStorage = CloudflareDurableObjectStorage$1;
+type CloudflareDurableObjectId = unknown;
+interface CloudflareDurableObjectStub {
+  fetch(request: Request): Promise<Response>;
+}
+interface CloudflareDurableObjectNamespace<Stub extends CloudflareDurableObjectStub = CloudflareDurableObjectStub> {
+  get(id: CloudflareDurableObjectId): Stub;
+  idFromName(name: string): CloudflareDurableObjectId;
+}
+interface CloudflareDurableObjectState {
+  readonly storage: CloudflareDurableObjectStorage;
+  waitUntil(promise: Promise<unknown>): void;
+}
+declare class InMemoryCloudflareDurableObjectStorage extends InMemoryCloudflareDurableObjectStorage$1 {}
+declare function createCloudflareDurableObjectHost({
+  prefix,
+  sessionStore,
+  storage,
+  scheduler
+}: {
+  readonly prefix?: string;
+  readonly scheduler?: ExecutionScheduler;
+  readonly sessionStore?: SessionStore;
+  readonly storage: CloudflareDurableObjectStorage;
+}): ExecutionHost;
+declare function createCloudflareAlarmScheduler({
+  prefix,
+  storage
+}: {
+  readonly prefix?: string;
+  readonly storage: CloudflareDurableObjectStorage;
+}): ExecutionScheduler;
+declare function listScheduledCloudflareRuns(storage: CloudflareDurableObjectStorage, options?: {
+  readonly prefix?: string;
+}): Promise<readonly string[]>;
+declare function ackScheduledCloudflareRun(storage: CloudflareDurableObjectStorage, runId: string, options?: {
+  readonly prefix?: string;
+}): Promise<void>;
+declare function listScheduledCloudflareSessionPrompts(storage: CloudflareDurableObjectStorage, options?: {
+  readonly prefix?: string;
+}): Promise<readonly CloudflareScheduledSessionPrompt[]>;
+declare function ackScheduledCloudflareSessionPrompt(storage: CloudflareDurableObjectStorage, prompt: CloudflareScheduledSessionPrompt, options?: {
+  readonly prefix?: string;
+}): Promise<void>;
+declare function rescheduleCloudflareAlarm(storage: CloudflareDurableObjectStorage, options?: {
+  readonly runAfterMs?: number;
+}): Promise<void>;
+//#endregion
+export { CloudflareDurableObjectId, CloudflareDurableObjectNamespace, CloudflareDurableObjectState, CloudflareDurableObjectStorage, CloudflareDurableObjectStub, CloudflareScheduledSessionPrompt, InMemoryCloudflareDurableObjectStorage, ackScheduledCloudflareRun, ackScheduledCloudflareSessionPrompt, createCloudflareAlarmScheduler, createCloudflareDurableObjectHost, listScheduledCloudflareRuns, listScheduledCloudflareSessionPrompts, rescheduleCloudflareAlarm };
+//# sourceMappingURL=cloudflare-host.d.ts.map

package/dist/cloudflare/cloudflare-host.js

@@ -0,0 +1,113 @@
+import { DurableObjectExecutionStore } from "./cloudflare-execution-store.js";
+import { InMemoryCloudflareDurableObjectStorage as InMemoryCloudflareDurableObjectStorage$1 } from "./durable-object-storage.js";
+//#region src/cloudflare/cloudflare-host.ts
+const defaultPrefix = "pss-runtime";
+var InMemoryCloudflareDurableObjectStorage = class extends InMemoryCloudflareDurableObjectStorage$1 {};
+function createCloudflareDurableObjectHost({ prefix = defaultPrefix, sessionStore, storage, scheduler = createCloudflareAlarmScheduler({
+	prefix,
+	storage
+}) }) {
+	const store = new DurableObjectExecutionStore({
+		prefix,
+		storage
+	});
+	return {
+		capabilities: {},
+		scheduler,
+		store: sessionStore ? executionStoreWithSessions(store, sessionStore) : store
+	};
+}
+function createCloudflareAlarmScheduler({ prefix = defaultPrefix, storage }) {
+	return {
+		enqueueRun: async (runId, options) => {
+			await appendUnique(storage, scheduledRunsKey(prefix), runId);
+			await setAlarm(storage, options?.runAfterMs ?? 0);
+		},
+		resumeSession: async (sessionKey, options) => {
+			await appendSessionPrompt(storage, scheduledSessionPromptsKey(prefix), {
+				idempotencyKey: options?.idempotencyKey,
+				notificationId: options?.notificationId,
+				runId: options?.runId,
+				sessionKey
+			});
+			await setAlarm(storage, 0);
+		}
+	};
+}
+async function listScheduledCloudflareRuns(storage, options = {}) {
+	return await readList(storage, scheduledRunsKey(options.prefix ?? defaultPrefix));
+}
+async function ackScheduledCloudflareRun(storage, runId, options = {}) {
+	await removeFromList(storage, scheduledRunsKey(options.prefix ?? defaultPrefix), (scheduledRunId) => scheduledRunId === runId);
+}
+async function listScheduledCloudflareSessionPrompts(storage, options = {}) {
+	return await readList(storage, scheduledSessionPromptsKey(options.prefix ?? defaultPrefix));
+}
+async function ackScheduledCloudflareSessionPrompt(storage, prompt, options = {}) {
+	await removeFromList(storage, scheduledSessionPromptsKey(options.prefix ?? defaultPrefix), (scheduledPrompt) => sessionPromptsMatch(scheduledPrompt, prompt));
+}
+async function rescheduleCloudflareAlarm(storage, options = {}) {
+	await setAlarm(storage, options.runAfterMs ?? 0);
+}
+async function appendUnique(storage, key, value) {
+	await withTransaction(storage, async (tx) => {
+		const values = await readList(tx, key);
+		if (!values.includes(value)) {
+			values.push(value);
+			await tx.put(key, values);
+		}
+	});
+}
+async function appendSessionPrompt(storage, key, prompt) {
+	await withTransaction(storage, async (tx) => {
+		const values = await readList(tx, key);
+		if (!values.some((existing) => existing.sessionKey === prompt.sessionKey && existing.idempotencyKey === prompt.idempotencyKey && existing.runId === prompt.runId)) {
+			values.push(prompt);
+			await tx.put(key, values);
+		}
+	});
+}
+async function removeFromList(storage, key, shouldRemove) {
+	await withTransaction(storage, async (tx) => {
+		const remaining = (await readList(tx, key)).filter((value) => !shouldRemove(value));
+		await tx.put(key, remaining);
+	});
+}
+async function readList(storage, key) {
+	return (await storage.get(key) ?? []).map((item) => structuredClone(item));
+}
+async function setAlarm(storage, runAfterMs) {
+	await storage.setAlarm?.(Date.now() + Math.max(0, runAfterMs));
+}
+async function withTransaction(storage, fn) {
+	return storage.transaction ? await storage.transaction(fn) : await fn(storage);
+}
+function scheduledRunsKey(prefix) {
+	return `${prefix}:scheduled-runs`;
+}
+function scheduledSessionPromptsKey(prefix) {
+	return `${prefix}:scheduled-session-prompts`;
+}
+function sessionPromptsMatch(left, right) {
+	return left.idempotencyKey === right.idempotencyKey && left.notificationId === right.notificationId && left.runId === right.runId && left.sessionKey === right.sessionKey;
+}
+function executionStoreWithSessions(store, sessions) {
+	return {
+		checkpoints: store.checkpoints,
+		events: store.events,
+		notifications: store.notifications,
+		runs: store.runs,
+		sessions,
+		transaction: (fn) => store.transaction((tx) => fn({
+			checkpoints: tx.checkpoints,
+			events: tx.events,
+			notifications: tx.notifications,
+			runs: tx.runs,
+			sessions
+		}))
+	};
+}
+//#endregion
+export { InMemoryCloudflareDurableObjectStorage, ackScheduledCloudflareRun, ackScheduledCloudflareSessionPrompt, createCloudflareAlarmScheduler, createCloudflareDurableObjectHost, listScheduledCloudflareRuns, listScheduledCloudflareSessionPrompts, rescheduleCloudflareAlarm };
+
+//# sourceMappingURL=cloudflare-host.js.map

package/dist/cloudflare/cloudflare-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-host.js","names":["BaseInMemoryCloudflareDurableObjectStorage"],"sources":["../../src/cloudflare/cloudflare-host.ts"],"sourcesContent":["import type { ExecutionHost, ExecutionScheduler } from \"../execution\";\nimport type { SessionStore } from \"../index\";\nimport { DurableObjectExecutionStore } from \"./cloudflare-execution-store\";\nimport {\n  InMemoryCloudflareDurableObjectStorage as BaseInMemoryCloudflareDurableObjectStorage,\n  type CloudflareDurableObjectStorage as DurableObjectStoragePort,\n} from \"./durable-object-storage\";\n\nconst defaultPrefix = \"pss-runtime\";\n\nexport interface CloudflareScheduledSessionPrompt {\n  readonly idempotencyKey?: string;\n  readonly notificationId?: string;\n  readonly runId?: string;\n  readonly sessionKey: string;\n}\n\nexport type CloudflareDurableObjectStorage = DurableObjectStoragePort;\n\nexport type CloudflareDurableObjectId = unknown;\n\nexport interface CloudflareDurableObjectStub {\n  fetch(request: Request): Promise<Response>;\n}\n\nexport interface CloudflareDurableObjectNamespace<\n  Stub extends CloudflareDurableObjectStub = CloudflareDurableObjectStub,\n> {\n  get(id: CloudflareDurableObjectId): Stub;\n  idFromName(name: string): CloudflareDurableObjectId;\n}\n\nexport interface CloudflareDurableObjectState {\n  readonly storage: CloudflareDurableObjectStorage;\n  waitUntil(promise: Promise<unknown>): void;\n}\n\nexport class InMemoryCloudflareDurableObjectStorage extends BaseInMemoryCloudflareDurableObjectStorage {}\n\nexport function createCloudflareDurableObjectHost({\n  prefix = defaultPrefix,\n  sessionStore,\n  storage,\n  scheduler = createCloudflareAlarmScheduler({ prefix, storage }),\n}: {\n  readonly prefix?: string;\n  readonly scheduler?: ExecutionScheduler;\n  readonly sessionStore?: SessionStore;\n  readonly storage: CloudflareDurableObjectStorage;\n}): ExecutionHost {\n  const store = new DurableObjectExecutionStore({ prefix, storage });\n  return {\n    capabilities: {},\n    scheduler,\n    store: sessionStore\n      ? executionStoreWithSessions(store, sessionStore)\n      : store,\n  };\n}\n\nexport function createCloudflareAlarmScheduler({\n  prefix = defaultPrefix,\n  storage,\n}: {\n  readonly prefix?: string;\n  readonly storage: CloudflareDurableObjectStorage;\n}): ExecutionScheduler {\n  return {\n    enqueueRun: async (runId, options) => {\n      await appendUnique(storage, scheduledRunsKey(prefix), runId);\n      await setAlarm(storage, options?.runAfterMs ?? 0);\n    },\n    resumeSession: async (sessionKey, options) => {\n      await appendSessionPrompt(storage, scheduledSessionPromptsKey(prefix), {\n        idempotencyKey: options?.idempotencyKey,\n        notificationId: options?.notificationId,\n        runId: options?.runId,\n        sessionKey,\n      });\n      await setAlarm(storage, 0);\n    },\n  };\n}\n\nexport async function listScheduledCloudflareRuns(\n  storage: CloudflareDurableObjectStorage,\n  options: { readonly prefix?: string } = {}\n): Promise<readonly string[]> {\n  return await readList<string>(\n    storage,\n    scheduledRunsKey(options.prefix ?? defaultPrefix)\n  );\n}\n\nexport async function ackScheduledCloudflareRun(\n  storage: CloudflareDurableObjectStorage,\n  runId: string,\n  options: { readonly prefix?: string } = {}\n): Promise<void> {\n  await removeFromList<string>(\n    storage,\n    scheduledRunsKey(options.prefix ?? defaultPrefix),\n    (scheduledRunId) => scheduledRunId === runId\n  );\n}\n\nexport async function listScheduledCloudflareSessionPrompts(\n  storage: CloudflareDurableObjectStorage,\n  options: { readonly prefix?: string } = {}\n): Promise<readonly CloudflareScheduledSessionPrompt[]> {\n  return await readList<CloudflareScheduledSessionPrompt>(\n    storage,\n    scheduledSessionPromptsKey(options.prefix ?? defaultPrefix)\n  );\n}\n\nexport async function ackScheduledCloudflareSessionPrompt(\n  storage: CloudflareDurableObjectStorage,\n  prompt: CloudflareScheduledSessionPrompt,\n  options: { readonly prefix?: string } = {}\n): Promise<void> {\n  await removeFromList<CloudflareScheduledSessionPrompt>(\n    storage,\n    scheduledSessionPromptsKey(options.prefix ?? defaultPrefix),\n    (scheduledPrompt) => sessionPromptsMatch(scheduledPrompt, prompt)\n  );\n}\n\nexport async function rescheduleCloudflareAlarm(\n  storage: CloudflareDurableObjectStorage,\n  options: { readonly runAfterMs?: number } = {}\n): Promise<void> {\n  await setAlarm(storage, options.runAfterMs ?? 0);\n}\n\nasync function appendUnique(\n  storage: CloudflareDurableObjectStorage,\n  key: string,\n  value: string\n): Promise<void> {\n  await withTransaction(storage, async (tx) => {\n    const values = await readList<string>(tx, key);\n    if (!values.includes(value)) {\n      values.push(value);\n      await tx.put(key, values);\n    }\n  });\n}\n\nasync function appendSessionPrompt(\n  storage: CloudflareDurableObjectStorage,\n  key: string,\n  prompt: CloudflareScheduledSessionPrompt\n): Promise<void> {\n  await withTransaction(storage, async (tx) => {\n    const values = await readList<CloudflareScheduledSessionPrompt>(tx, key);\n    const isDuplicate = values.some(\n      (existing) =>\n        existing.sessionKey === prompt.sessionKey &&\n        existing.idempotencyKey === prompt.idempotencyKey &&\n        existing.runId === prompt.runId\n    );\n    if (!isDuplicate) {\n      values.push(prompt);\n      await tx.put(key, values);\n    }\n  });\n}\n\nasync function removeFromList<T>(\n  storage: CloudflareDurableObjectStorage,\n  key: string,\n  shouldRemove: (value: T) => boolean\n): Promise<void> {\n  await withTransaction(storage, async (tx) => {\n    const remaining = (await readList<T>(tx, key)).filter(\n      (value) => !shouldRemove(value)\n    );\n    await tx.put(key, remaining);\n  });\n}\n\nasync function readList<T>(\n  storage: CloudflareDurableObjectStorage,\n  key: string\n): Promise<T[]> {\n  return ((await storage.get<readonly T[]>(key)) ?? []).map((item) =>\n    structuredClone(item)\n  );\n}\n\nasync function setAlarm(\n  storage: CloudflareDurableObjectStorage,\n  runAfterMs: number\n): Promise<void> {\n  await storage.setAlarm?.(Date.now() + Math.max(0, runAfterMs));\n}\n\nasync function withTransaction<T>(\n  storage: CloudflareDurableObjectStorage,\n  fn: (storage: CloudflareDurableObjectStorage) => Promise<T>\n): Promise<T> {\n  return storage.transaction\n    ? await storage.transaction(fn)\n    : await fn(storage);\n}\n\nfunction scheduledRunsKey(prefix: string): string {\n  return `${prefix}:scheduled-runs`;\n}\n\nfunction scheduledSessionPromptsKey(prefix: string): string {\n  return `${prefix}:scheduled-session-prompts`;\n}\n\nfunction sessionPromptsMatch(\n  left: CloudflareScheduledSessionPrompt,\n  right: CloudflareScheduledSessionPrompt\n): boolean {\n  return (\n    left.idempotencyKey === right.idempotencyKey &&\n    left.notificationId === right.notificationId &&\n    left.runId === right.runId &&\n    left.sessionKey === right.sessionKey\n  );\n}\n\nfunction executionStoreWithSessions(\n  store: ExecutionHost[\"store\"],\n  sessions: SessionStore\n): ExecutionHost[\"store\"] {\n  return {\n    checkpoints: store.checkpoints,\n    events: store.events,\n    notifications: store.notifications,\n    runs: store.runs,\n    sessions,\n    transaction: (fn) =>\n      store.transaction((tx) =>\n        fn({\n          checkpoints: tx.checkpoints,\n          events: tx.events,\n          notifications: tx.notifications,\n          runs: tx.runs,\n          sessions,\n        })\n      ),\n  };\n}\n"],"mappings":";;;AAQA,MAAM,gBAAgB;AA6BtB,IAAa,yCAAb,cAA4DA,yCAA2C,CAAC;AAExG,SAAgB,kCAAkC,EAChD,SAAS,eACT,cACA,SACA,YAAY,+BAA+B;CAAE;CAAQ;AAAQ,CAAC,KAM9C;CAChB,MAAM,QAAQ,IAAI,4BAA4B;EAAE;EAAQ;CAAQ,CAAC;CACjE,OAAO;EACL,cAAc,CAAC;EACf;EACA,OAAO,eACH,2BAA2B,OAAO,YAAY,IAC9C;CACN;AACF;AAEA,SAAgB,+BAA+B,EAC7C,SAAS,eACT,WAIqB;CACrB,OAAO;EACL,YAAY,OAAO,OAAO,YAAY;GACpC,MAAM,aAAa,SAAS,iBAAiB,MAAM,GAAG,KAAK;GAC3D,MAAM,SAAS,SAAS,SAAS,cAAc,CAAC;EAClD;EACA,eAAe,OAAO,YAAY,YAAY;GAC5C,MAAM,oBAAoB,SAAS,2BAA2B,MAAM,GAAG;IACrE,gBAAgB,SAAS;IACzB,gBAAgB,SAAS;IACzB,OAAO,SAAS;IAChB;GACF,CAAC;GACD,MAAM,SAAS,SAAS,CAAC;EAC3B;CACF;AACF;AAEA,eAAsB,4BACpB,SACA,UAAwC,CAAC,GACb;CAC5B,OAAO,MAAM,SACX,SACA,iBAAiB,QAAQ,UAAU,aAAa,CAClD;AACF;AAEA,eAAsB,0BACpB,SACA,OACA,UAAwC,CAAC,GAC1B;CACf,MAAM,eACJ,SACA,iBAAiB,QAAQ,UAAU,aAAa,IAC/C,mBAAmB,mBAAmB,KACzC;AACF;AAEA,eAAsB,sCACpB,SACA,UAAwC,CAAC,GACa;CACtD,OAAO,MAAM,SACX,SACA,2BAA2B,QAAQ,UAAU,aAAa,CAC5D;AACF;AAEA,eAAsB,oCACpB,SACA,QACA,UAAwC,CAAC,GAC1B;CACf,MAAM,eACJ,SACA,2BAA2B,QAAQ,UAAU,aAAa,IACzD,oBAAoB,oBAAoB,iBAAiB,MAAM,CAClE;AACF;AAEA,eAAsB,0BACpB,SACA,UAA4C,CAAC,GAC9B;CACf,MAAM,SAAS,SAAS,QAAQ,cAAc,CAAC;AACjD;AAEA,eAAe,aACb,SACA,KACA,OACe;CACf,MAAM,gBAAgB,SAAS,OAAO,OAAO;EAC3C,MAAM,SAAS,MAAM,SAAiB,IAAI,GAAG;EAC7C,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG;GAC3B,OAAO,KAAK,KAAK;GACjB,MAAM,GAAG,IAAI,KAAK,MAAM;EAC1B;CACF,CAAC;AACH;AAEA,eAAe,oBACb,SACA,KACA,QACe;CACf,MAAM,gBAAgB,SAAS,OAAO,OAAO;EAC3C,MAAM,SAAS,MAAM,SAA2C,IAAI,GAAG;EAOvE,IAAI,CANgB,OAAO,MACxB,aACC,SAAS,eAAe,OAAO,cAC/B,SAAS,mBAAmB,OAAO,kBACnC,SAAS,UAAU,OAAO,KAEf,GAAG;GAChB,OAAO,KAAK,MAAM;GAClB,MAAM,GAAG,IAAI,KAAK,MAAM;EAC1B;CACF,CAAC;AACH;AAEA,eAAe,eACb,SACA,KACA,cACe;CACf,MAAM,gBAAgB,SAAS,OAAO,OAAO;EAC3C,MAAM,aAAa,MAAM,SAAY,IAAI,GAAG,GAAG,QAC5C,UAAU,CAAC,aAAa,KAAK,CAChC;EACA,MAAM,GAAG,IAAI,KAAK,SAAS;CAC7B,CAAC;AACH;AAEA,eAAe,SACb,SACA,KACc;CACd,QAAS,MAAM,QAAQ,IAAkB,GAAG,KAAM,CAAC,GAAG,KAAK,SACzD,gBAAgB,IAAI,CACtB;AACF;AAEA,eAAe,SACb,SACA,YACe;CACf,MAAM,QAAQ,WAAW,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,UAAU,CAAC;AAC/D;AAEA,eAAe,gBACb,SACA,IACY;CACZ,OAAO,QAAQ,cACX,MAAM,QAAQ,YAAY,EAAE,IAC5B,MAAM,GAAG,OAAO;AACtB;AAEA,SAAS,iBAAiB,QAAwB;CAChD,OAAO,GAAG,OAAO;AACnB;AAEA,SAAS,2BAA2B,QAAwB;CAC1D,OAAO,GAAG,OAAO;AACnB;AAEA,SAAS,oBACP,MACA,OACS;CACT,OACE,KAAK,mBAAmB,MAAM,kBAC9B,KAAK,mBAAmB,MAAM,kBAC9B,KAAK,UAAU,MAAM,SACrB,KAAK,eAAe,MAAM;AAE9B;AAEA,SAAS,2BACP,OACA,UACwB;CACxB,OAAO;EACL,aAAa,MAAM;EACnB,QAAQ,MAAM;EACd,eAAe,MAAM;EACrB,MAAM,MAAM;EACZ;EACA,cAAc,OACZ,MAAM,aAAa,OACjB,GAAG;GACD,aAAa,GAAG;GAChB,QAAQ,GAAG;GACX,eAAe,GAAG;GAClB,MAAM,GAAG;GACT;EACF,CAAC,CACH;CACJ;AACF"}

package/dist/cloudflare/cloudflare-notification-store.js

@@ -0,0 +1,59 @@
+import { getNotification, putNotification, withTransaction } from "./cloudflare-store-utils.js";
+//#region src/cloudflare/cloudflare-notification-store.ts
+var DurableObjectNotificationInbox = class {
+	#prefix;
+	#storage;
+	constructor(storage, prefix) {
+		this.#prefix = prefix;
+		this.#storage = storage;
+	}
+	async claimByIdempotencyKey(idempotencyKey) {
+		return await withTransaction(this.#storage, async (storage) => {
+			const record = await getNotification(storage, this.#prefix, idempotencyKey);
+			if (!record) return {
+				ok: false,
+				reason: "not-found"
+			};
+			if (record.status !== "pending") return {
+				ok: false,
+				reason: "already-claimed",
+				record
+			};
+			const claimed = {
+				...record,
+				status: "acked"
+			};
+			await putNotification(storage, this.#prefix, claimed);
+			return {
+				ok: true,
+				record: claimed
+			};
+		});
+	}
+	async enqueue(record) {
+		return await withTransaction(this.#storage, async (storage) => {
+			const current = await getNotification(storage, this.#prefix, record.idempotencyKey);
+			if (current) return {
+				existingNotificationId: current.notificationId,
+				ok: false,
+				reason: "duplicate"
+			};
+			await putNotification(storage, this.#prefix, record);
+			return { ok: true };
+		});
+	}
+	async getByIdempotencyKey(idempotencyKey) {
+		return await getNotification(this.#storage, this.#prefix, idempotencyKey);
+	}
+	async releaseByIdempotencyKey(idempotencyKey) {
+		const record = await this.getByIdempotencyKey(idempotencyKey);
+		if (record?.status === "acked") await putNotification(this.#storage, this.#prefix, {
+			...record,
+			status: "pending"
+		});
+	}
+};
+//#endregion
+export { DurableObjectNotificationInbox };
+
+//# sourceMappingURL=cloudflare-notification-store.js.map

package/dist/cloudflare/cloudflare-notification-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-notification-store.js","names":["#prefix","#storage"],"sources":["../../src/cloudflare/cloudflare-notification-store.ts"],"sourcesContent":["import type {\n  NotificationClaimResult,\n  NotificationInbox,\n  NotificationRecord,\n  NotificationWriteResult,\n} from \"../execution\";\nimport {\n  getNotification,\n  putNotification,\n  withTransaction,\n} from \"./cloudflare-store-utils\";\nimport type { CloudflareDurableObjectStorage } from \"./durable-object-storage\";\n\nexport class DurableObjectNotificationInbox implements NotificationInbox {\n  readonly #prefix: string;\n  readonly #storage: CloudflareDurableObjectStorage;\n\n  constructor(storage: CloudflareDurableObjectStorage, prefix: string) {\n    this.#prefix = prefix;\n    this.#storage = storage;\n  }\n\n  async claimByIdempotencyKey(\n    idempotencyKey: string\n  ): Promise<NotificationClaimResult> {\n    return await withTransaction(this.#storage, async (storage) => {\n      const record = await getNotification(\n        storage,\n        this.#prefix,\n        idempotencyKey\n      );\n      if (!record) {\n        return { ok: false, reason: \"not-found\" };\n      }\n      if (record.status !== \"pending\") {\n        return { ok: false, reason: \"already-claimed\", record };\n      }\n      const claimed: NotificationRecord = { ...record, status: \"acked\" };\n      await putNotification(storage, this.#prefix, claimed);\n      return { ok: true, record: claimed };\n    });\n  }\n\n  async enqueue(record: NotificationRecord): Promise<NotificationWriteResult> {\n    return await withTransaction(this.#storage, async (storage) => {\n      const current = await getNotification(\n        storage,\n        this.#prefix,\n        record.idempotencyKey\n      );\n      if (current) {\n        return {\n          existingNotificationId: current.notificationId,\n          ok: false,\n          reason: \"duplicate\",\n        };\n      }\n      await putNotification(storage, this.#prefix, record);\n      return { ok: true };\n    });\n  }\n\n  async getByIdempotencyKey(\n    idempotencyKey: string\n  ): Promise<NotificationRecord | null> {\n    return await getNotification(this.#storage, this.#prefix, idempotencyKey);\n  }\n\n  async releaseByIdempotencyKey(idempotencyKey: string): Promise<void> {\n    const record = await this.getByIdempotencyKey(idempotencyKey);\n    if (record?.status === \"acked\") {\n      await putNotification(this.#storage, this.#prefix, {\n        ...record,\n        status: \"pending\",\n      });\n    }\n  }\n}\n"],"mappings":";;AAaA,IAAa,iCAAb,MAAyE;CACvE;CACA;CAEA,YAAY,SAAyC,QAAgB;EACnE,KAAKA,UAAU;EACf,KAAKC,WAAW;CAClB;CAEA,MAAM,sBACJ,gBACkC;EAClC,OAAO,MAAM,gBAAgB,KAAKA,UAAU,OAAO,YAAY;GAC7D,MAAM,SAAS,MAAM,gBACnB,SACA,KAAKD,SACL,cACF;GACA,IAAI,CAAC,QACH,OAAO;IAAE,IAAI;IAAO,QAAQ;GAAY;GAE1C,IAAI,OAAO,WAAW,WACpB,OAAO;IAAE,IAAI;IAAO,QAAQ;IAAmB;GAAO;GAExD,MAAM,UAA8B;IAAE,GAAG;IAAQ,QAAQ;GAAQ;GACjE,MAAM,gBAAgB,SAAS,KAAKA,SAAS,OAAO;GACpD,OAAO;IAAE,IAAI;IAAM,QAAQ;GAAQ;EACrC,CAAC;CACH;CAEA,MAAM,QAAQ,QAA8D;EAC1E,OAAO,MAAM,gBAAgB,KAAKC,UAAU,OAAO,YAAY;GAC7D,MAAM,UAAU,MAAM,gBACpB,SACA,KAAKD,SACL,OAAO,cACT;GACA,IAAI,SACF,OAAO;IACL,wBAAwB,QAAQ;IAChC,IAAI;IACJ,QAAQ;GACV;GAEF,MAAM,gBAAgB,SAAS,KAAKA,SAAS,MAAM;GACnD,OAAO,EAAE,IAAI,KAAK;EACpB,CAAC;CACH;CAEA,MAAM,oBACJ,gBACoC;EACpC,OAAO,MAAM,gBAAgB,KAAKC,UAAU,KAAKD,SAAS,cAAc;CAC1E;CAEA,MAAM,wBAAwB,gBAAuC;EACnE,MAAM,SAAS,MAAM,KAAK,oBAAoB,cAAc;EAC5D,IAAI,QAAQ,WAAW,SACrB,MAAM,gBAAgB,KAAKC,UAAU,KAAKD,SAAS;GACjD,GAAG;GACH,QAAQ;EACV,CAAC;CAEL;AACF"}

package/dist/cloudflare/cloudflare-run-store.js

@@ -0,0 +1,81 @@
+import { getRun, indexRun, putRun, readList, storeKey, withTransaction } from "./cloudflare-store-utils.js";
+//#region src/cloudflare/cloudflare-run-store.ts
+const claimableStatuses = new Set([
+	"leased",
+	"queued",
+	"running",
+	"suspended"
+]);
+var DurableObjectRunStore = class {
+	#prefix;
+	#storage;
+	constructor(storage, prefix) {
+		this.#prefix = prefix;
+		this.#storage = storage;
+	}
+	async claim(runId, options) {
+		return await withTransaction(this.#storage, async (storage) => {
+			const run = await getRun(storage, this.#prefix, runId);
+			if (!run) return {
+				ok: false,
+				reason: "not-found"
+			};
+			if (!claimableStatuses.has(run.status)) return {
+				ok: false,
+				reason: "not-claimable"
+			};
+			if (run.lease && run.lease.leaseUntilMs > options.nowMs) return {
+				ok: false,
+				reason: "leased"
+			};
+			const lease = {
+				attempt: options.attempt,
+				leaseId: options.leaseId,
+				leaseUntilMs: options.nowMs + options.leaseMs
+			};
+			const claimed = {
+				...run,
+				lease,
+				status: "leased"
+			};
+			await putRun(storage, this.#prefix, claimed);
+			return {
+				lease,
+				ok: true,
+				record: structuredClone(claimed)
+			};
+		});
+	}
+	async create(record) {
+		return await withTransaction(this.#storage, async (storage) => {
+			await putRun(storage, this.#prefix, record);
+			await indexRun(storage, this.#prefix, record);
+			return structuredClone(record);
+		});
+	}
+	async get(runId) {
+		return await getRun(this.#storage, this.#prefix, runId);
+	}
+	async getByDedupeKey(dedupeKey) {
+		const runId = await this.#storage.get(storeKey(this.#prefix, "run-dedupe", dedupeKey));
+		return runId ? await this.get(runId) : null;
+	}
+	async listByParentRunId(parentRunId) {
+		const runIds = await readList(this.#storage, storeKey(this.#prefix, "run-parent", parentRunId));
+		return (await Promise.all(runIds.map((runId) => this.get(runId)))).filter(isRunRecord);
+	}
+	async update(record) {
+		return await withTransaction(this.#storage, async (storage) => {
+			await putRun(storage, this.#prefix, record);
+			await indexRun(storage, this.#prefix, record);
+			return structuredClone(record);
+		});
+	}
+};
+function isRunRecord(record) {
+	return record !== null;
+}
+//#endregion
+export { DurableObjectRunStore };
+
+//# sourceMappingURL=cloudflare-run-store.js.map

package/dist/cloudflare/cloudflare-run-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-run-store.js","names":["#prefix","#storage"],"sources":["../../src/cloudflare/cloudflare-run-store.ts"],"sourcesContent":["import type {\n  ClaimRunOptions,\n  ClaimRunResult,\n  RunRecord,\n  RunStatus,\n  RunStore,\n} from \"../execution\";\nimport {\n  getRun,\n  indexRun,\n  putRun,\n  readList,\n  storeKey,\n  withTransaction,\n} from \"./cloudflare-store-utils\";\nimport type { CloudflareDurableObjectStorage } from \"./durable-object-storage\";\n\nconst claimableStatuses = new Set<RunStatus>([\n  \"leased\",\n  \"queued\",\n  \"running\",\n  \"suspended\",\n]);\n\nexport class DurableObjectRunStore implements RunStore {\n  readonly #prefix: string;\n  readonly #storage: CloudflareDurableObjectStorage;\n\n  constructor(storage: CloudflareDurableObjectStorage, prefix: string) {\n    this.#prefix = prefix;\n    this.#storage = storage;\n  }\n\n  async claim(\n    runId: string,\n    options: ClaimRunOptions\n  ): Promise<ClaimRunResult> {\n    return await withTransaction(this.#storage, async (storage) => {\n      const run = await getRun(storage, this.#prefix, runId);\n      if (!run) {\n        return { ok: false, reason: \"not-found\" };\n      }\n      if (!claimableStatuses.has(run.status)) {\n        return { ok: false, reason: \"not-claimable\" };\n      }\n      if (run.lease && run.lease.leaseUntilMs > options.nowMs) {\n        return { ok: false, reason: \"leased\" };\n      }\n\n      const lease = {\n        attempt: options.attempt,\n        leaseId: options.leaseId,\n        leaseUntilMs: options.nowMs + options.leaseMs,\n      };\n      const claimed: RunRecord = { ...run, lease, status: \"leased\" };\n      await putRun(storage, this.#prefix, claimed);\n      return { lease, ok: true, record: structuredClone(claimed) };\n    });\n  }\n\n  async create(record: RunRecord): Promise<RunRecord> {\n    return await withTransaction(this.#storage, async (storage) => {\n      await putRun(storage, this.#prefix, record);\n      await indexRun(storage, this.#prefix, record);\n      return structuredClone(record);\n    });\n  }\n\n  async get(runId: string): Promise<RunRecord | null> {\n    return await getRun(this.#storage, this.#prefix, runId);\n  }\n\n  async getByDedupeKey(dedupeKey: string): Promise<RunRecord | null> {\n    const runId = await this.#storage.get<string>(\n      storeKey(this.#prefix, \"run-dedupe\", dedupeKey)\n    );\n    return runId ? await this.get(runId) : null;\n  }\n\n  async listByParentRunId(parentRunId: string): Promise<readonly RunRecord[]> {\n    const runIds = await readList<string>(\n      this.#storage,\n      storeKey(this.#prefix, \"run-parent\", parentRunId)\n    );\n    const runs = await Promise.all(runIds.map((runId) => this.get(runId)));\n    return runs.filter(isRunRecord);\n  }\n\n  async update(record: RunRecord): Promise<RunRecord> {\n    return await withTransaction(this.#storage, async (storage) => {\n      await putRun(storage, this.#prefix, record);\n      await indexRun(storage, this.#prefix, record);\n      return structuredClone(record);\n    });\n  }\n}\n\nfunction isRunRecord(record: RunRecord | null): record is RunRecord {\n  return record !== null;\n}\n"],"mappings":";;AAiBA,MAAM,oBAAoB,IAAI,IAAe;CAC3C;CACA;CACA;CACA;AACF,CAAC;AAED,IAAa,wBAAb,MAAuD;CACrD;CACA;CAEA,YAAY,SAAyC,QAAgB;EACnE,KAAKA,UAAU;EACf,KAAKC,WAAW;CAClB;CAEA,MAAM,MACJ,OACA,SACyB;EACzB,OAAO,MAAM,gBAAgB,KAAKA,UAAU,OAAO,YAAY;GAC7D,MAAM,MAAM,MAAM,OAAO,SAAS,KAAKD,SAAS,KAAK;GACrD,IAAI,CAAC,KACH,OAAO;IAAE,IAAI;IAAO,QAAQ;GAAY;GAE1C,IAAI,CAAC,kBAAkB,IAAI,IAAI,MAAM,GACnC,OAAO;IAAE,IAAI;IAAO,QAAQ;GAAgB;GAE9C,IAAI,IAAI,SAAS,IAAI,MAAM,eAAe,QAAQ,OAChD,OAAO;IAAE,IAAI;IAAO,QAAQ;GAAS;GAGvC,MAAM,QAAQ;IACZ,SAAS,QAAQ;IACjB,SAAS,QAAQ;IACjB,cAAc,QAAQ,QAAQ,QAAQ;GACxC;GACA,MAAM,UAAqB;IAAE,GAAG;IAAK;IAAO,QAAQ;GAAS;GAC7D,MAAM,OAAO,SAAS,KAAKA,SAAS,OAAO;GAC3C,OAAO;IAAE;IAAO,IAAI;IAAM,QAAQ,gBAAgB,OAAO;GAAE;EAC7D,CAAC;CACH;CAEA,MAAM,OAAO,QAAuC;EAClD,OAAO,MAAM,gBAAgB,KAAKC,UAAU,OAAO,YAAY;GAC7D,MAAM,OAAO,SAAS,KAAKD,SAAS,MAAM;GAC1C,MAAM,SAAS,SAAS,KAAKA,SAAS,MAAM;GAC5C,OAAO,gBAAgB,MAAM;EAC/B,CAAC;CACH;CAEA,MAAM,IAAI,OAA0C;EAClD,OAAO,MAAM,OAAO,KAAKC,UAAU,KAAKD,SAAS,KAAK;CACxD;CAEA,MAAM,eAAe,WAA8C;EACjE,MAAM,QAAQ,MAAM,KAAKC,SAAS,IAChC,SAAS,KAAKD,SAAS,cAAc,SAAS,CAChD;EACA,OAAO,QAAQ,MAAM,KAAK,IAAI,KAAK,IAAI;CACzC;CAEA,MAAM,kBAAkB,aAAoD;EAC1E,MAAM,SAAS,MAAM,SACnB,KAAKC,UACL,SAAS,KAAKD,SAAS,cAAc,WAAW,CAClD;EAEA,QAAO,MADY,QAAQ,IAAI,OAAO,KAAK,UAAU,KAAK,IAAI,KAAK,CAAC,CAAC,GACzD,OAAO,WAAW;CAChC;CAEA,MAAM,OAAO,QAAuC;EAClD,OAAO,MAAM,gBAAgB,KAAKC,UAAU,OAAO,YAAY;GAC7D,MAAM,OAAO,SAAS,KAAKD,SAAS,MAAM;GAC1C,MAAM,SAAS,SAAS,KAAKA,SAAS,MAAM;GAC5C,OAAO,gBAAgB,MAAM;EAC/B,CAAC;CACH;AACF;AAEA,SAAS,YAAY,QAA+C;CAClE,OAAO,WAAW;AACpB"}

package/dist/cloudflare/cloudflare-store-utils.js

@@ -0,0 +1,43 @@
+//#region src/cloudflare/cloudflare-store-utils.ts
+async function withTransaction(storage, fn) {
+	return storage.transaction ? await storage.transaction(fn) : await fn(storage);
+}
+async function getRun(storage, prefix, runId) {
+	return await storage.get(storeKey(prefix, "run", runId)) ?? null;
+}
+async function putRun(storage, prefix, record) {
+	await storage.put(storeKey(prefix, "run", record.runId), record);
+}
+async function indexRun(storage, prefix, record) {
+	if (record.dedupeKey) await storage.put(storeKey(prefix, "run-dedupe", record.dedupeKey), record.runId);
+	if (record.parentRunId) {
+		const parentKey = storeKey(prefix, "run-parent", record.parentRunId);
+		const runIds = await readList(storage, parentKey);
+		if (!runIds.includes(record.runId)) {
+			runIds.push(record.runId);
+			await storage.put(parentKey, runIds);
+		}
+	}
+}
+async function getNotification(storage, prefix, idempotencyKey) {
+	return await storage.get(storeKey(prefix, "notification", idempotencyKey)) ?? null;
+}
+async function putNotification(storage, prefix, record) {
+	await storage.put(storeKey(prefix, "notification", record.idempotencyKey), record);
+}
+async function getSession(storage, prefix, sessionKey) {
+	return await storage.get(storeKey(prefix, "session", sessionKey)) ?? null;
+}
+async function putSession(storage, prefix, sessionKey, session) {
+	await storage.put(storeKey(prefix, "session", sessionKey), session);
+}
+async function readList(storage, storageKey) {
+	return (await storage.get(storageKey) ?? []).map((item) => structuredClone(item));
+}
+function storeKey(prefix, scope, id) {
+	return `${prefix}:${scope}:${encodeURIComponent(id)}`;
+}
+//#endregion
+export { getNotification, getRun, getSession, indexRun, putNotification, putRun, putSession, readList, storeKey, withTransaction };
+
+//# sourceMappingURL=cloudflare-store-utils.js.map

package/dist/cloudflare/cloudflare-store-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-store-utils.js","names":[],"sources":["../../src/cloudflare/cloudflare-store-utils.ts"],"sourcesContent":["import type { NotificationRecord, RunRecord } from \"../execution\";\nimport type { StoredSession } from \"../index\";\nimport type { CloudflareDurableObjectStorage } from \"./durable-object-storage\";\n\nexport async function withTransaction<T>(\n  storage: CloudflareDurableObjectStorage,\n  fn: (storage: CloudflareDurableObjectStorage) => Promise<T>\n): Promise<T> {\n  return storage.transaction\n    ? await storage.transaction(fn)\n    : await fn(storage);\n}\n\nexport async function getRun(\n  storage: CloudflareDurableObjectStorage,\n  prefix: string,\n  runId: string\n): Promise<RunRecord | null> {\n  return (await storage.get<RunRecord>(storeKey(prefix, \"run\", runId))) ?? null;\n}\n\nexport async function putRun(\n  storage: CloudflareDurableObjectStorage,\n  prefix: string,\n  record: RunRecord\n): Promise<void> {\n  await storage.put(storeKey(prefix, \"run\", record.runId), record);\n}\n\nexport async function indexRun(\n  storage: CloudflareDurableObjectStorage,\n  prefix: string,\n  record: RunRecord\n): Promise<void> {\n  if (record.dedupeKey) {\n    await storage.put(\n      storeKey(prefix, \"run-dedupe\", record.dedupeKey),\n      record.runId\n    );\n  }\n  if (record.parentRunId) {\n    const parentKey = storeKey(prefix, \"run-parent\", record.parentRunId);\n    const runIds = await readList<string>(storage, parentKey);\n    if (!runIds.includes(record.runId)) {\n      runIds.push(record.runId);\n      await storage.put(parentKey, runIds);\n    }\n  }\n}\n\nexport async function getNotification(\n  storage: CloudflareDurableObjectStorage,\n  prefix: string,\n  idempotencyKey: string\n): Promise<NotificationRecord | null> {\n  return (\n    (await storage.get<NotificationRecord>(\n      storeKey(prefix, \"notification\", idempotencyKey)\n    )) ?? null\n  );\n}\n\nexport async function putNotification(\n  storage: CloudflareDurableObjectStorage,\n  prefix: string,\n  record: NotificationRecord\n): Promise<void> {\n  await storage.put(\n    storeKey(prefix, \"notification\", record.idempotencyKey),\n    record\n  );\n}\n\nexport async function getSession(\n  storage: CloudflareDurableObjectStorage,\n  prefix: string,\n  sessionKey: string\n): Promise<StoredSession | null> {\n  return (\n    (await storage.get<StoredSession>(\n      storeKey(prefix, \"session\", sessionKey)\n    )) ?? null\n  );\n}\n\nexport async function putSession(\n  storage: CloudflareDurableObjectStorage,\n  prefix: string,\n  sessionKey: string,\n  session: StoredSession\n): Promise<void> {\n  await storage.put(storeKey(prefix, \"session\", sessionKey), session);\n}\n\nexport async function readList<T>(\n  storage: CloudflareDurableObjectStorage,\n  storageKey: string\n): Promise<T[]> {\n  return ((await storage.get<readonly T[]>(storageKey)) ?? []).map((item) =>\n    structuredClone(item)\n  );\n}\n\nexport function storeKey(prefix: string, scope: string, id: string): string {\n  return `${prefix}:${scope}:${encodeURIComponent(id)}`;\n}\n"],"mappings":";AAIA,eAAsB,gBACpB,SACA,IACY;CACZ,OAAO,QAAQ,cACX,MAAM,QAAQ,YAAY,EAAE,IAC5B,MAAM,GAAG,OAAO;AACtB;AAEA,eAAsB,OACpB,SACA,QACA,OAC2B;CAC3B,OAAQ,MAAM,QAAQ,IAAe,SAAS,QAAQ,OAAO,KAAK,CAAC,KAAM;AAC3E;AAEA,eAAsB,OACpB,SACA,QACA,QACe;CACf,MAAM,QAAQ,IAAI,SAAS,QAAQ,OAAO,OAAO,KAAK,GAAG,MAAM;AACjE;AAEA,eAAsB,SACpB,SACA,QACA,QACe;CACf,IAAI,OAAO,WACT,MAAM,QAAQ,IACZ,SAAS,QAAQ,cAAc,OAAO,SAAS,GAC/C,OAAO,KACT;CAEF,IAAI,OAAO,aAAa;EACtB,MAAM,YAAY,SAAS,QAAQ,cAAc,OAAO,WAAW;EACnE,MAAM,SAAS,MAAM,SAAiB,SAAS,SAAS;EACxD,IAAI,CAAC,OAAO,SAAS,OAAO,KAAK,GAAG;GAClC,OAAO,KAAK,OAAO,KAAK;GACxB,MAAM,QAAQ,IAAI,WAAW,MAAM;EACrC;CACF;AACF;AAEA,eAAsB,gBACpB,SACA,QACA,gBACoC;CACpC,OACG,MAAM,QAAQ,IACb,SAAS,QAAQ,gBAAgB,cAAc,CACjD,KAAM;AAEV;AAEA,eAAsB,gBACpB,SACA,QACA,QACe;CACf,MAAM,QAAQ,IACZ,SAAS,QAAQ,gBAAgB,OAAO,cAAc,GACtD,MACF;AACF;AAEA,eAAsB,WACpB,SACA,QACA,YAC+B;CAC/B,OACG,MAAM,QAAQ,IACb,SAAS,QAAQ,WAAW,UAAU,CACxC,KAAM;AAEV;AAEA,eAAsB,WACpB,SACA,QACA,YACA,SACe;CACf,MAAM,QAAQ,IAAI,SAAS,QAAQ,WAAW,UAAU,GAAG,OAAO;AACpE;AAEA,eAAsB,SACpB,SACA,YACc;CACd,QAAS,MAAM,QAAQ,IAAkB,UAAU,KAAM,CAAC,GAAG,KAAK,SAChE,gBAAgB,IAAI,CACtB;AACF;AAEA,SAAgB,SAAS,QAAgB,OAAe,IAAoB;CAC1E,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,mBAAmB,EAAE;AACpD"}

package/dist/cloudflare/durable-object-storage.d.ts

@@ -0,0 +1,20 @@
+//#region src/cloudflare/durable-object-storage.d.ts
+interface CloudflareDurableObjectStorage {
+  delete(key: string): Promise<unknown>;
+  get<T>(key: string): Promise<T | undefined>;
+  put<T>(key: string, value: T): Promise<void>;
+  setAlarm?(scheduledTime: Date | number): Promise<void>;
+  transaction?<T>(fn: (storage: CloudflareDurableObjectStorage) => Promise<T>): Promise<T>;
+}
+declare class InMemoryCloudflareDurableObjectStorage implements CloudflareDurableObjectStorage {
+  #private;
+  alarmTime(): Date | number | undefined;
+  delete(key: string): Promise<boolean>;
+  get<T>(key: string): Promise<T | undefined>;
+  put<T>(key: string, value: T): Promise<void>;
+  setAlarm(scheduledTime: Date | number): Promise<void>;
+  transaction<T>(fn: (storage: CloudflareDurableObjectStorage) => Promise<T>): Promise<T>;
+}
+//#endregion
+export { CloudflareDurableObjectStorage, InMemoryCloudflareDurableObjectStorage };
+//# sourceMappingURL=durable-object-storage.d.ts.map

package/dist/cloudflare/durable-object-storage.js

@@ -0,0 +1,76 @@
+//#region src/cloudflare/durable-object-storage.ts
+var InMemoryCloudflareDurableObjectStorage = class {
+	#alarmTime;
+	#transactionChain = Promise.resolve();
+	#values = /* @__PURE__ */ new Map();
+	alarmTime() {
+		return this.#alarmTime;
+	}
+	delete(key) {
+		return Promise.resolve(this.#values.delete(key));
+	}
+	get(key) {
+		const value = this.#values.get(key);
+		return Promise.resolve(value === void 0 ? void 0 : structuredClone(value));
+	}
+	put(key, value) {
+		this.#values.set(key, structuredClone(value));
+		return Promise.resolve();
+	}
+	setAlarm(scheduledTime) {
+		this.#alarmTime = scheduledTime;
+		return Promise.resolve();
+	}
+	async transaction(fn) {
+		const previousTransaction = this.#transactionChain;
+		let releaseTransaction = () => void 0;
+		this.#transactionChain = new Promise((resolve) => {
+			releaseTransaction = resolve;
+		});
+		await previousTransaction;
+		const transactionValues = cloneMap(this.#values);
+		const transactionStorage = new TransactionalCloudflareStorage(transactionValues, (scheduledTime) => {
+			this.#alarmTime = scheduledTime;
+		});
+		try {
+			const result = await fn(transactionStorage);
+			this.#values = transactionValues;
+			return result;
+		} finally {
+			releaseTransaction();
+		}
+	}
+};
+var TransactionalCloudflareStorage = class {
+	#setAlarm;
+	#values;
+	constructor(values, setAlarm) {
+		this.#setAlarm = setAlarm;
+		this.#values = values;
+	}
+	delete(key) {
+		return Promise.resolve(this.#values.delete(key));
+	}
+	get(key) {
+		const value = this.#values.get(key);
+		return Promise.resolve(value === void 0 ? void 0 : structuredClone(value));
+	}
+	put(key, value) {
+		this.#values.set(key, structuredClone(value));
+		return Promise.resolve();
+	}
+	setAlarm(scheduledTime) {
+		this.#setAlarm(scheduledTime);
+		return Promise.resolve();
+	}
+	async transaction(fn) {
+		return await fn(this);
+	}
+};
+function cloneMap(values) {
+	return new Map([...values.entries()].map(([key, value]) => [key, structuredClone(value)]));
+}
+//#endregion
+export { InMemoryCloudflareDurableObjectStorage };
+
+//# sourceMappingURL=durable-object-storage.js.map

package/dist/cloudflare/durable-object-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-object-storage.js","names":["#alarmTime","#values","#transactionChain","#setAlarm"],"sources":["../../src/cloudflare/durable-object-storage.ts"],"sourcesContent":["export interface CloudflareDurableObjectStorage {\n  delete(key: string): Promise<unknown>;\n  get<T>(key: string): Promise<T | undefined>;\n  put<T>(key: string, value: T): Promise<void>;\n  setAlarm?(scheduledTime: Date | number): Promise<void>;\n  transaction?<T>(\n    fn: (storage: CloudflareDurableObjectStorage) => Promise<T>\n  ): Promise<T>;\n}\n\nexport class InMemoryCloudflareDurableObjectStorage\n  implements CloudflareDurableObjectStorage\n{\n  #alarmTime: Date | number | undefined;\n  #transactionChain: Promise<void> = Promise.resolve();\n  #values = new Map<string, unknown>();\n\n  alarmTime(): Date | number | undefined {\n    return this.#alarmTime;\n  }\n\n  delete(key: string): Promise<boolean> {\n    return Promise.resolve(this.#values.delete(key));\n  }\n\n  get<T>(key: string): Promise<T | undefined> {\n    const value = this.#values.get(key);\n    return Promise.resolve(\n      value === undefined ? undefined : (structuredClone(value) as T)\n    );\n  }\n\n  put<T>(key: string, value: T): Promise<void> {\n    this.#values.set(key, structuredClone(value));\n    return Promise.resolve();\n  }\n\n  setAlarm(scheduledTime: Date | number): Promise<void> {\n    this.#alarmTime = scheduledTime;\n    return Promise.resolve();\n  }\n\n  async transaction<T>(\n    fn: (storage: CloudflareDurableObjectStorage) => Promise<T>\n  ): Promise<T> {\n    const previousTransaction = this.#transactionChain;\n    let releaseTransaction: () => void = () => undefined;\n    this.#transactionChain = new Promise<void>((resolve) => {\n      releaseTransaction = resolve;\n    });\n    await previousTransaction;\n\n    const transactionValues = cloneMap(this.#values);\n    const transactionStorage = new TransactionalCloudflareStorage(\n      transactionValues,\n      (scheduledTime) => {\n        this.#alarmTime = scheduledTime;\n      }\n    );\n\n    try {\n      const result = await fn(transactionStorage);\n      this.#values = transactionValues;\n      return result;\n    } finally {\n      releaseTransaction();\n    }\n  }\n}\n\nclass TransactionalCloudflareStorage implements CloudflareDurableObjectStorage {\n  readonly #setAlarm: (scheduledTime: Date | number) => void;\n  readonly #values: Map<string, unknown>;\n\n  constructor(\n    values: Map<string, unknown>,\n    setAlarm: (scheduledTime: Date | number) => void\n  ) {\n    this.#setAlarm = setAlarm;\n    this.#values = values;\n  }\n\n  delete(key: string): Promise<boolean> {\n    return Promise.resolve(this.#values.delete(key));\n  }\n\n  get<T>(key: string): Promise<T | undefined> {\n    const value = this.#values.get(key);\n    return Promise.resolve(\n      value === undefined ? undefined : (structuredClone(value) as T)\n    );\n  }\n\n  put<T>(key: string, value: T): Promise<void> {\n    this.#values.set(key, structuredClone(value));\n    return Promise.resolve();\n  }\n\n  setAlarm(scheduledTime: Date | number): Promise<void> {\n    this.#setAlarm(scheduledTime);\n    return Promise.resolve();\n  }\n\n  async transaction<T>(\n    fn: (storage: CloudflareDurableObjectStorage) => Promise<T>\n  ): Promise<T> {\n    return await fn(this);\n  }\n}\n\nfunction cloneMap(values: Map<string, unknown>): Map<string, unknown> {\n  return new Map(\n    [...values.entries()].map(([key, value]) => [key, structuredClone(value)])\n  );\n}\n"],"mappings":";AAUA,IAAa,yCAAb,MAEA;CACE;CACA,oBAAmC,QAAQ,QAAQ;CACnD,0BAAU,IAAI,IAAqB;CAEnC,YAAuC;EACrC,OAAO,KAAKA;CACd;CAEA,OAAO,KAA+B;EACpC,OAAO,QAAQ,QAAQ,KAAKC,QAAQ,OAAO,GAAG,CAAC;CACjD;CAEA,IAAO,KAAqC;EAC1C,MAAM,QAAQ,KAAKA,QAAQ,IAAI,GAAG;EAClC,OAAO,QAAQ,QACb,UAAU,KAAA,IAAY,KAAA,IAAa,gBAAgB,KAAK,CAC1D;CACF;CAEA,IAAO,KAAa,OAAyB;EAC3C,KAAKA,QAAQ,IAAI,KAAK,gBAAgB,KAAK,CAAC;EAC5C,OAAO,QAAQ,QAAQ;CACzB;CAEA,SAAS,eAA6C;EACpD,KAAKD,aAAa;EAClB,OAAO,QAAQ,QAAQ;CACzB;CAEA,MAAM,YACJ,IACY;EACZ,MAAM,sBAAsB,KAAKE;EACjC,IAAI,2BAAuC,KAAA;EAC3C,KAAKA,oBAAoB,IAAI,SAAe,YAAY;GACtD,qBAAqB;EACvB,CAAC;EACD,MAAM;EAEN,MAAM,oBAAoB,SAAS,KAAKD,OAAO;EAC/C,MAAM,qBAAqB,IAAI,+BAC7B,oBACC,kBAAkB;GACjB,KAAKD,aAAa;EACpB,CACF;EAEA,IAAI;GACF,MAAM,SAAS,MAAM,GAAG,kBAAkB;GAC1C,KAAKC,UAAU;GACf,OAAO;EACT,UAAU;GACR,mBAAmB;EACrB;CACF;AACF;AAEA,IAAM,iCAAN,MAA+E;CAC7E;CACA;CAEA,YACE,QACA,UACA;EACA,KAAKE,YAAY;EACjB,KAAKF,UAAU;CACjB;CAEA,OAAO,KAA+B;EACpC,OAAO,QAAQ,QAAQ,KAAKA,QAAQ,OAAO,GAAG,CAAC;CACjD;CAEA,IAAO,KAAqC;EAC1C,MAAM,QAAQ,KAAKA,QAAQ,IAAI,GAAG;EAClC,OAAO,QAAQ,QACb,UAAU,KAAA,IAAY,KAAA,IAAa,gBAAgB,KAAK,CAC1D;CACF;CAEA,IAAO,KAAa,OAAyB;EAC3C,KAAKA,QAAQ,IAAI,KAAK,gBAAgB,KAAK,CAAC;EAC5C,OAAO,QAAQ,QAAQ;CACzB;CAEA,SAAS,eAA6C;EACpD,KAAKE,UAAU,aAAa;EAC5B,OAAO,QAAQ,QAAQ;CACzB;CAEA,MAAM,YACJ,IACY;EACZ,OAAO,MAAM,GAAG,IAAI;CACtB;AACF;AAEA,SAAS,SAAS,QAAoD;CACpE,OAAO,IAAI,IACT,CAAC,GAAG,OAAO,QAAQ,CAAC,EAAE,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,gBAAgB,KAAK,CAAC,CAAC,CAC3E;AACF"}

package/dist/cloudflare/index.d.ts

@@ -0,0 +1,7 @@
+import { CloudflareAlarmContinuationReason, CloudflareAlarmDrainBudget, FailedScheduledWork } from "./cloudflare-alarm-budget.js";
+import { CloudflareDurableObjectId, CloudflareDurableObjectNamespace, CloudflareDurableObjectState, CloudflareDurableObjectStorage, CloudflareDurableObjectStub, CloudflareScheduledSessionPrompt, InMemoryCloudflareDurableObjectStorage, ackScheduledCloudflareRun, ackScheduledCloudflareSessionPrompt, createCloudflareAlarmScheduler, createCloudflareDurableObjectHost, listScheduledCloudflareRuns, listScheduledCloudflareSessionPrompts, rescheduleCloudflareAlarm } from "./cloudflare-host.js";
+import { CloudflareAlarmAgent, CloudflareAlarmDrainFailureError, CloudflareAlarmDrainSummary, drainCloudflareAlarm } from "./cloudflare-alarm-drainer.js";
+import { CloudflareAgentContext, CloudflareAgentContextFactoryOptions, CloudflareAgentContextOptions, CloudflareAgentContextPrefixOptions, createCloudflareAgentContext } from "./cloudflare-agent-context.js";
+import { CloudflareAgentRunDrainOptions, drainAgentRun } from "./cloudflare-alarm-run-drain.js";
+import { CloudflareDurableObjectFetchOptions, CloudflareDurableObjectStubOptions, fetchCloudflareDurableObject, getCloudflareDurableObjectStub } from "./cloudflare-durable-object-fetch.js";
+export { type CloudflareAgentContext, type CloudflareAgentContextFactoryOptions, type CloudflareAgentContextOptions, type CloudflareAgentContextPrefixOptions, type CloudflareAgentRunDrainOptions, type CloudflareAlarmAgent, type CloudflareAlarmContinuationReason, type CloudflareAlarmDrainBudget, CloudflareAlarmDrainFailureError, type CloudflareAlarmDrainSummary, type CloudflareDurableObjectFetchOptions, type CloudflareDurableObjectId, type CloudflareDurableObjectNamespace, type CloudflareDurableObjectState, type CloudflareDurableObjectStorage, type CloudflareDurableObjectStub, type CloudflareDurableObjectStubOptions, type CloudflareScheduledSessionPrompt, type FailedScheduledWork, InMemoryCloudflareDurableObjectStorage, ackScheduledCloudflareRun, ackScheduledCloudflareSessionPrompt, createCloudflareAgentContext, createCloudflareAlarmScheduler, createCloudflareDurableObjectHost, drainAgentRun, drainCloudflareAlarm, fetchCloudflareDurableObject, getCloudflareDurableObjectStub, listScheduledCloudflareRuns, listScheduledCloudflareSessionPrompts, rescheduleCloudflareAlarm };

package/dist/cloudflare/index.js

@@ -0,0 +1,6 @@
+import { drainAgentRun } from "./cloudflare-alarm-run-drain.js";
+import { InMemoryCloudflareDurableObjectStorage, ackScheduledCloudflareRun, ackScheduledCloudflareSessionPrompt, createCloudflareAlarmScheduler, createCloudflareDurableObjectHost, listScheduledCloudflareRuns, listScheduledCloudflareSessionPrompts, rescheduleCloudflareAlarm } from "./cloudflare-host.js";
+import { CloudflareAlarmDrainFailureError, drainCloudflareAlarm } from "./cloudflare-alarm-drainer.js";
+import { createCloudflareAgentContext } from "./cloudflare-agent-context.js";
+import { fetchCloudflareDurableObject, getCloudflareDurableObjectStub } from "./cloudflare-durable-object-fetch.js";
+export { CloudflareAlarmDrainFailureError, InMemoryCloudflareDurableObjectStorage, ackScheduledCloudflareRun, ackScheduledCloudflareSessionPrompt, createCloudflareAgentContext, createCloudflareAlarmScheduler, createCloudflareDurableObjectHost, drainAgentRun, drainCloudflareAlarm, fetchCloudflareDurableObject, getCloudflareDurableObjectStub, listScheduledCloudflareRuns, listScheduledCloudflareSessionPrompts, rescheduleCloudflareAlarm };

package/dist/execution/capabilities.d.ts

@@ -0,0 +1,40 @@
+import { SessionStore } from "../session/store/types.js";
+import { AgentHostCapabilities, CheckpointStore, EventStore, ExecutionScheduler, ExecutionStore, NotificationInbox, RunStore } from "./types.js";
+
+//#region src/execution/capabilities.d.ts
+interface SessionHost {
+  readonly capabilities?: AgentHostCapabilities;
+  readonly sessionStore?: SessionStore;
+}
+interface RunHost {
+  readonly capabilities?: AgentHostCapabilities;
+  readonly runStore: RunStore;
+}
+interface CheckpointHost {
+  readonly capabilities?: AgentHostCapabilities;
+  readonly checkpointStore: CheckpointStore;
+}
+interface EventHost {
+  readonly capabilities?: AgentHostCapabilities;
+  readonly eventStore: EventStore;
+}
+interface NotificationHost {
+  readonly capabilities?: AgentHostCapabilities;
+  readonly notificationInbox: NotificationInbox;
+}
+type BackgroundScheduler = ExecutionScheduler;
+interface BackgroundSchedulerHost {
+  readonly backgroundScheduler: BackgroundScheduler;
+  readonly capabilities?: AgentHostCapabilities;
+}
+interface ExecutionTransactionHost {
+  readonly capabilities?: AgentHostCapabilities;
+  readonly transaction: ExecutionStore["transaction"];
+}
+interface DurableBackgroundHost extends BackgroundSchedulerHost, CheckpointHost, EventHost, ExecutionTransactionHost, NotificationHost, RunHost, SessionHost {
+  readonly sessionStore: SessionStore;
+}
+interface DurableNotificationResumeHost extends BackgroundSchedulerHost, CheckpointHost, ExecutionTransactionHost, NotificationHost, RunHost {}
+//#endregion
+export { BackgroundScheduler, BackgroundSchedulerHost, CheckpointHost, DurableBackgroundHost, DurableNotificationResumeHost, EventHost, ExecutionTransactionHost, NotificationHost, RunHost, SessionHost };
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/execution/host.d.ts

@@ -0,0 +1,9 @@
+import { AgentHost, ExecutionHost } from "./types.js";
+import { SessionHost } from "./capabilities.js";
+
+//#region src/execution/host.d.ts
+declare function sessionHost(host: AgentHost): SessionHost;
+declare function executionHost(host: AgentHost): ExecutionHost | undefined;
+//#endregion
+export { executionHost, sessionHost };
+//# sourceMappingURL=host.d.ts.map