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

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

package/dist/execution/host.js

@@ -1,6 +1,22 @@
 //#region src/execution/host.ts
+function sessionHost(host) {
+	const durableHost = durableBackgroundHost(host);
+	if (durableHost?.sessionStore) return durableHost;
+	const hostExecution = executionHost(host);
+	if (hostExecution) return {
+		capabilities: hostExecution.capabilities,
+		sessionStore: hostExecution.store.sessions
+	};
+	return host;
+}
 function executionHost(host) {
 	if (isExecutionHost(host)) return host;
+	if (isDurableBackgroundHost(host)) return executionHostFromDurableBackgroundHost(host);
+}
+function durableBackgroundHost(host) {
+	if (isDurableBackgroundHost(host)) return host;
+	const hostExecution = executionHost(host);
+	if (hostExecution) return durableBackgroundHostFromExecutionHost(hostExecution);
 }
 function isExecutionHost(host) {
 	return "scheduler" in host && "store" in host && isExecutionStore(host.store);
@@ -8,7 +24,39 @@ function isExecutionHost(host) {
 function isExecutionStore(store) {
 	return typeof store === "object" && store !== null && "checkpoints" in store && "events" in store && "notifications" in store && "runs" in store && "sessions" in store;
 }
+function durableBackgroundHostFromExecutionHost(host) {
+	return {
+		backgroundScheduler: host.scheduler,
+		capabilities: host.capabilities,
+		checkpointStore: host.store.checkpoints,
+		eventStore: host.store.events,
+		notificationInbox: host.store.notifications,
+		runStore: host.store.runs,
+		sessionStore: host.store.sessions,
+		transaction: transactionForStore(host.store)
+	};
+}
+function executionHostFromDurableBackgroundHost(host) {
+	return {
+		capabilities: host.capabilities ?? {},
+		scheduler: host.backgroundScheduler,
+		store: {
+			checkpoints: host.checkpointStore,
+			events: host.eventStore,
+			notifications: host.notificationInbox,
+			runs: host.runStore,
+			sessions: host.sessionStore,
+			transaction: host.transaction
+		}
+	};
+}
+function isDurableBackgroundHost(host) {
+	return "backgroundScheduler" in host && "checkpointStore" in host && "eventStore" in host && "notificationInbox" in host && "runStore" in host && "sessionStore" in host && "transaction" in host;
+}
+function transactionForStore(store) {
+	return (fn) => store.transaction(fn);
+}
 //#endregion
-export { executionHost };
+export { executionHost, sessionHost };
 
 //# sourceMappingURL=host.js.map

package/dist/execution/host.js.map

@@ -1 +1 @@
-{"version":3,"file":"host.js","names":[],"sources":["../../src/execution/host.ts"],"sourcesContent":["import type { AgentHost, ExecutionHost } from \"./types\";\n\nexport function executionHost(host: AgentHost): ExecutionHost | undefined {\n  if (isExecutionHost(host)) {\n    return host;\n  }\n\n  return;\n}\n\nfunction isExecutionHost(host: AgentHost): host is ExecutionHost {\n  return \"scheduler\" in host && \"store\" in host && isExecutionStore(host.store);\n}\n\nfunction isExecutionStore(store: unknown): store is ExecutionHost[\"store\"] {\n  return (\n    typeof store === \"object\" &&\n    store !== null &&\n    \"checkpoints\" in store &&\n    \"events\" in store &&\n    \"notifications\" in store &&\n    \"runs\" in store &&\n    \"sessions\" in store\n  );\n}\n"],"mappings":";AAEA,SAAgB,cAAc,MAA4C;CACxE,IAAI,gBAAgB,IAAI,GACtB,OAAO;AAIX;AAEA,SAAS,gBAAgB,MAAwC;CAC/D,OAAO,eAAe,QAAQ,WAAW,QAAQ,iBAAiB,KAAK,KAAK;AAC9E;AAEA,SAAS,iBAAiB,OAAiD;CACzE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,iBAAiB,SACjB,YAAY,SACZ,mBAAmB,SACnB,UAAU,SACV,cAAc;AAElB"}
+{"version":3,"file":"host.js","names":[],"sources":["../../src/execution/host.ts"],"sourcesContent":["import type {\n  DurableBackgroundHost,\n  DurableNotificationResumeHost,\n  SessionHost,\n} from \"./capabilities\";\nimport type { AgentHost, ExecutionHost } from \"./types\";\n\ntype Transaction = ExecutionHost[\"store\"][\"transaction\"];\n\nexport function sessionHost(host: AgentHost): SessionHost {\n  const durableHost = durableBackgroundHost(host);\n  if (durableHost?.sessionStore) {\n    return durableHost;\n  }\n\n  const hostExecution = executionHost(host);\n  if (hostExecution) {\n    return {\n      capabilities: hostExecution.capabilities,\n      sessionStore: hostExecution.store.sessions,\n    };\n  }\n\n  return host;\n}\n\nexport function executionHost(host: AgentHost): ExecutionHost | undefined {\n  if (isExecutionHost(host)) {\n    return host;\n  }\n\n  if (isDurableBackgroundHost(host)) {\n    return executionHostFromDurableBackgroundHost(host);\n  }\n\n  return;\n}\n\nexport function durableBackgroundHost(\n  host: AgentHost\n): DurableBackgroundHost | undefined {\n  if (isDurableBackgroundHost(host)) {\n    return host;\n  }\n\n  const hostExecution = executionHost(host);\n  if (hostExecution) {\n    return durableBackgroundHostFromExecutionHost(hostExecution);\n  }\n\n  return;\n}\n\nexport function durableNotificationResumeHost(\n  host: AgentHost\n): DurableNotificationResumeHost | undefined {\n  const backgroundHost = durableBackgroundHost(host);\n  if (backgroundHost) {\n    return backgroundHost;\n  }\n\n  return;\n}\n\nfunction isExecutionHost(host: AgentHost): host is ExecutionHost {\n  return \"scheduler\" in host && \"store\" in host && isExecutionStore(host.store);\n}\n\nfunction isExecutionStore(store: unknown): store is ExecutionHost[\"store\"] {\n  return (\n    typeof store === \"object\" &&\n    store !== null &&\n    \"checkpoints\" in store &&\n    \"events\" in store &&\n    \"notifications\" in store &&\n    \"runs\" in store &&\n    \"sessions\" in store\n  );\n}\n\nfunction durableBackgroundHostFromExecutionHost(\n  host: ExecutionHost\n): DurableBackgroundHost {\n  return {\n    backgroundScheduler: host.scheduler,\n    capabilities: host.capabilities,\n    checkpointStore: host.store.checkpoints,\n    eventStore: host.store.events,\n    notificationInbox: host.store.notifications,\n    runStore: host.store.runs,\n    sessionStore: host.store.sessions,\n    transaction: transactionForStore(host.store),\n  };\n}\n\nfunction executionHostFromDurableBackgroundHost(\n  host: DurableBackgroundHost\n): ExecutionHost {\n  return {\n    capabilities: host.capabilities ?? {},\n    scheduler: host.backgroundScheduler,\n    store: {\n      checkpoints: host.checkpointStore,\n      events: host.eventStore,\n      notifications: host.notificationInbox,\n      runs: host.runStore,\n      sessions: host.sessionStore,\n      transaction: host.transaction,\n    },\n  };\n}\n\nfunction isDurableBackgroundHost(\n  host: AgentHost\n): host is DurableBackgroundHost {\n  return (\n    \"backgroundScheduler\" in host &&\n    \"checkpointStore\" in host &&\n    \"eventStore\" in host &&\n    \"notificationInbox\" in host &&\n    \"runStore\" in host &&\n    \"sessionStore\" in host &&\n    \"transaction\" in host\n  );\n}\n\nfunction transactionForStore(store: ExecutionHost[\"store\"]): Transaction {\n  return (fn) => store.transaction(fn);\n}\n"],"mappings":";AASA,SAAgB,YAAY,MAA8B;CACxD,MAAM,cAAc,sBAAsB,IAAI;CAC9C,IAAI,aAAa,cACf,OAAO;CAGT,MAAM,gBAAgB,cAAc,IAAI;CACxC,IAAI,eACF,OAAO;EACL,cAAc,cAAc;EAC5B,cAAc,cAAc,MAAM;CACpC;CAGF,OAAO;AACT;AAEA,SAAgB,cAAc,MAA4C;CACxE,IAAI,gBAAgB,IAAI,GACtB,OAAO;CAGT,IAAI,wBAAwB,IAAI,GAC9B,OAAO,uCAAuC,IAAI;AAItD;AAEA,SAAgB,sBACd,MACmC;CACnC,IAAI,wBAAwB,IAAI,GAC9B,OAAO;CAGT,MAAM,gBAAgB,cAAc,IAAI;CACxC,IAAI,eACF,OAAO,uCAAuC,aAAa;AAI/D;AAaA,SAAS,gBAAgB,MAAwC;CAC/D,OAAO,eAAe,QAAQ,WAAW,QAAQ,iBAAiB,KAAK,KAAK;AAC9E;AAEA,SAAS,iBAAiB,OAAiD;CACzE,OACE,OAAO,UAAU,YACjB,UAAU,QACV,iBAAiB,SACjB,YAAY,SACZ,mBAAmB,SACnB,UAAU,SACV,cAAc;AAElB;AAEA,SAAS,uCACP,MACuB;CACvB,OAAO;EACL,qBAAqB,KAAK;EAC1B,cAAc,KAAK;EACnB,iBAAiB,KAAK,MAAM;EAC5B,YAAY,KAAK,MAAM;EACvB,mBAAmB,KAAK,MAAM;EAC9B,UAAU,KAAK,MAAM;EACrB,cAAc,KAAK,MAAM;EACzB,aAAa,oBAAoB,KAAK,KAAK;CAC7C;AACF;AAEA,SAAS,uCACP,MACe;CACf,OAAO;EACL,cAAc,KAAK,gBAAgB,CAAC;EACpC,WAAW,KAAK;EAChB,OAAO;GACL,aAAa,KAAK;GAClB,QAAQ,KAAK;GACb,eAAe,KAAK;GACpB,MAAM,KAAK;GACX,UAAU,KAAK;GACf,aAAa,KAAK;EACpB;CACF;AACF;AAEA,SAAS,wBACP,MAC+B;CAC/B,OACE,yBAAyB,QACzB,qBAAqB,QACrB,gBAAgB,QAChB,uBAAuB,QACvB,cAAc,QACd,kBAAkB,QAClB,iBAAiB;AAErB;AAEA,SAAS,oBAAoB,OAA4C;CACvE,QAAQ,OAAO,MAAM,YAAY,EAAE;AACrC"}

package/dist/execution/index.d.ts

@@ -1,4 +1,6 @@
 import { RuntimeToolExecutionCheckpoint, RuntimeToolExecutionContext, RuntimeToolExecutionDecision, RuntimeToolRetryPolicy, ToolExecutionNeedsRecoveryError } from "../llm-tool-execution.js";
 import { AgentHostCapabilities, CheckpointPhase, CheckpointStore, CheckpointWriteResult, ClaimRunOptions, ClaimRunResult, EventCursor, EventStore, ExecutionHost, ExecutionScheduler, ExecutionStore, ExecutionStoreTransaction, NotificationClaimResult, NotificationInbox, NotificationRecord, NotificationStatus, NotificationWriteResult, ResumeSessionOptions, RunCheckpoint, RunKind, RunLease, RunRecord, RunStatus, RunStore, StoredAgentEvent } from "./types.js";
+import { BackgroundScheduler, BackgroundSchedulerHost, CheckpointHost, DurableBackgroundHost, DurableNotificationResumeHost, EventHost, ExecutionTransactionHost, NotificationHost, RunHost, SessionHost } from "./capabilities.js";
+import { executionHost, sessionHost } from "./host.js";
 import { createInMemoryExecutionHost } from "./memory.js";
-export { type AgentHostCapabilities, type CheckpointPhase, type CheckpointStore, type CheckpointWriteResult, type ClaimRunOptions, type ClaimRunResult, type EventCursor, type EventStore, type ExecutionHost, type ExecutionScheduler, type ExecutionStore, type ExecutionStoreTransaction, type NotificationClaimResult, type NotificationInbox, type NotificationRecord, type NotificationStatus, type NotificationWriteResult, type ResumeSessionOptions, type RunCheckpoint, type RunKind, type RunLease, type RunRecord, type RunStatus, type RunStore, type RuntimeToolExecutionCheckpoint, type RuntimeToolExecutionContext, type RuntimeToolExecutionDecision, type RuntimeToolRetryPolicy, type StoredAgentEvent, ToolExecutionNeedsRecoveryError, createInMemoryExecutionHost };
+export { type AgentHostCapabilities, type BackgroundScheduler, type BackgroundSchedulerHost, type CheckpointHost, type CheckpointPhase, type CheckpointStore, type CheckpointWriteResult, type ClaimRunOptions, type ClaimRunResult, type DurableBackgroundHost, type DurableNotificationResumeHost, type EventCursor, type EventHost, type EventStore, type ExecutionHost, type ExecutionScheduler, type ExecutionStore, type ExecutionStoreTransaction, type ExecutionTransactionHost, type NotificationClaimResult, type NotificationHost, type NotificationInbox, type NotificationRecord, type NotificationStatus, type NotificationWriteResult, type ResumeSessionOptions, type RunCheckpoint, type RunHost, type RunKind, type RunLease, type RunRecord, type RunStatus, type RunStore, type RuntimeToolExecutionCheckpoint, type RuntimeToolExecutionContext, type RuntimeToolExecutionDecision, type RuntimeToolRetryPolicy, type SessionHost, type StoredAgentEvent, ToolExecutionNeedsRecoveryError, createInMemoryExecutionHost, executionHost, sessionHost };

package/dist/execution/index.js

@@ -1,3 +1,4 @@
+import { executionHost, sessionHost } from "./host.js";
 import { createInMemoryExecutionHost } from "./memory.js";
 import { ToolExecutionNeedsRecoveryError } from "../llm-tool-execution.js";
-export { ToolExecutionNeedsRecoveryError, createInMemoryExecutionHost };
+export { ToolExecutionNeedsRecoveryError, createInMemoryExecutionHost, executionHost, sessionHost };

package/dist/execution/memory.js

@@ -2,7 +2,7 @@ import { InMemoryExecutionStore } from "./memory-store.js";
 //#region src/execution/memory.ts
 function createInMemoryExecutionHost() {
 	return {
-		capabilities: { backgroundSubagents: "in-process" },
+		capabilities: {},
 		store: new InMemoryExecutionStore(),
 		scheduler: new InMemoryExecutionScheduler()
 	};

package/dist/execution/memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory.js","names":["#queuedRunIds","#resumedSessions"],"sources":["../../src/execution/memory.ts"],"sourcesContent":["import { InMemoryExecutionStore } from \"./memory-store\";\nimport type {\n  ExecutionHost,\n  ExecutionScheduler,\n  ResumeSessionOptions,\n} from \"./types\";\n\nexport function createInMemoryExecutionHost(): ExecutionHost {\n  return {\n    capabilities: {\n      backgroundSubagents: \"in-process\",\n    },\n    store: new InMemoryExecutionStore(),\n    scheduler: new InMemoryExecutionScheduler(),\n  };\n}\n\nclass InMemoryExecutionScheduler implements ExecutionScheduler {\n  readonly #queuedRunIds: string[] = [];\n  readonly #resumedSessions: {\n    readonly options: ResumeSessionOptions;\n    readonly sessionKey: string;\n  }[] = [];\n\n  enqueueRun(runId: string): Promise<void> {\n    this.#queuedRunIds.push(runId);\n    return Promise.resolve();\n  }\n\n  resumeSession(\n    sessionKey: string,\n    options: ResumeSessionOptions\n  ): Promise<void> {\n    this.#resumedSessions.push({ options, sessionKey });\n    return Promise.resolve();\n  }\n}\n"],"mappings":";;AAOA,SAAgB,8BAA6C;CAC3D,OAAO;EACL,cAAc,EACZ,qBAAqB,aACvB;EACA,OAAO,IAAI,uBAAuB;EAClC,WAAW,IAAI,2BAA2B;CAC5C;AACF;AAEA,IAAM,6BAAN,MAA+D;CAC7D,gBAAmC,CAAC;CACpC,mBAGM,CAAC;CAEP,WAAW,OAA8B;EACvC,KAAKA,cAAc,KAAK,KAAK;EAC7B,OAAO,QAAQ,QAAQ;CACzB;CAEA,cACE,YACA,SACe;EACf,KAAKC,iBAAiB,KAAK;GAAE;GAAS;EAAW,CAAC;EAClD,OAAO,QAAQ,QAAQ;CACzB;AACF"}
+{"version":3,"file":"memory.js","names":["#queuedRunIds","#resumedSessions"],"sources":["../../src/execution/memory.ts"],"sourcesContent":["import { InMemoryExecutionStore } from \"./memory-store\";\nimport type {\n  ExecutionHost,\n  ExecutionScheduler,\n  ResumeSessionOptions,\n} from \"./types\";\n\nexport function createInMemoryExecutionHost(): ExecutionHost {\n  return {\n    capabilities: {},\n    store: new InMemoryExecutionStore(),\n    scheduler: new InMemoryExecutionScheduler(),\n  };\n}\n\nclass InMemoryExecutionScheduler implements ExecutionScheduler {\n  readonly #queuedRunIds: string[] = [];\n  readonly #resumedSessions: {\n    readonly options: ResumeSessionOptions;\n    readonly sessionKey: string;\n  }[] = [];\n\n  enqueueRun(runId: string): Promise<void> {\n    this.#queuedRunIds.push(runId);\n    return Promise.resolve();\n  }\n\n  resumeSession(\n    sessionKey: string,\n    options: ResumeSessionOptions\n  ): Promise<void> {\n    this.#resumedSessions.push({ options, sessionKey });\n    return Promise.resolve();\n  }\n}\n"],"mappings":";;AAOA,SAAgB,8BAA6C;CAC3D,OAAO;EACL,cAAc,CAAC;EACf,OAAO,IAAI,uBAAuB;EAClC,WAAW,IAAI,2BAA2B;CAC5C;AACF;AAEA,IAAM,6BAAN,MAA+D;CAC7D,gBAAmC,CAAC;CACpC,mBAGM,CAAC;CAEP,WAAW,OAA8B;EACvC,KAAKA,cAAc,KAAK,KAAK;EAC7B,OAAO,QAAQ,QAAQ;CACzB;CAEA,cACE,YACA,SACe;EACf,KAAKC,iBAAiB,KAAK;GAAE;GAAS;EAAW,CAAC;EAClD,OAAO,QAAQ,QAAQ;CACzB;AACF"}

package/dist/execution/types.d.ts

@@ -1,21 +1,16 @@
+import { SessionStore } from "../session/store/types.js";
 import { UserInput } from "../session/input.js";
 import { AgentEvent } from "../session/events.js";
-import { SessionStore } from "../session/store/types.js";
+import { DurableBackgroundHost, SessionHost } from "./capabilities.js";
 
 //#region src/execution/types.d.ts
-type AgentHost = SessionHost | ExecutionHost;
-interface SessionHost {
-  readonly capabilities?: AgentHostCapabilities;
-  readonly sessionStore?: SessionStore;
-}
+type AgentHost = DurableBackgroundHost | ExecutionHost | SessionHost;
 interface ExecutionHost {
   readonly capabilities: AgentHostCapabilities;
   readonly scheduler: ExecutionScheduler;
   readonly store: ExecutionStore;
 }
-interface AgentHostCapabilities {
-  readonly backgroundSubagents?: "durable" | "in-process";
-}
+type AgentHostCapabilities = Record<string, never>;
 interface ExecutionScheduler {
   enqueueRun(runId: string, options?: {
     readonly runAfterMs?: number;
@@ -27,7 +22,7 @@ interface ResumeSessionOptions {
   readonly notificationId?: string;
   readonly runId: string;
 }
-type RunKind = "background-subagent" | "notification" | "subagent" | "tool-recovery" | "user-turn";
+type RunKind = "notification" | "tool-recovery" | "user-turn";
 type RunStatus = "cancelled" | "completed" | "error" | "leased" | "needs-recovery" | "queued" | "running" | "suspended";
 interface RunLease {
   readonly attempt: number;

package/dist/index.d.ts

@@ -1,11 +1,15 @@
 import { AgentToolChoice, RuntimeCreateLlmOptions, RuntimeLlm, RuntimeLlmContext, RuntimeLlmOutput, RuntimeLlmOutputPart, createLlm } from "./llm.js";
-import { AgentInput, SessionInput, UserInput, UserMessage, UserMessageContent, UserMessageContentPart, UserMessageFileData, UserMessageFilePart, UserMessageImagePart, UserMessageTextPart, UserText, UserTextContent } from "./session/input.js";
-import { AgentEvent, AgentEventListener, AssistantReasoning, AssistantText, RuntimeInput, ToolCall, ToolResult } from "./session/events.js";
 import { CommitResult, ExpectedSessionVersion, SessionStore, SessionStoreCommit, StoredSession } from "./session/store/types.js";
+import { InputEventMeta, InputSource } from "./session/input-meta-types.js";
+import { AgentInput, SessionInput, UserInput, UserMessage, UserMessageContent, UserMessageContentPart, UserMessageFileData, UserMessageFilePart, UserMessageImagePart, UserMessageTextPart, UserText, UserTextContent } from "./session/input.js";
+import { AgentEvent, AgentEventListener, AssistantReasoning, AssistantText, ControlAgentEvent, LifecycleAgentEvent, RuntimeInput, TelemetryAgentEvent, ToolAgentEvent, ToolCall, ToolResult, VisibleAgentEvent, isControlAgentEvent, isLifecycleAgentEvent, isTelemetryAgentEvent, isToolAgentEvent, isVisibleAgentEvent } from "./session/events.js";
 import { AgentHost } from "./execution/types.js";
-import { AgentEventContext, AgentPlugin } from "./plugins.js";
+import { executionHost } from "./execution/host.js";
+import { AgentEventContext, AgentPlugin, AgentPluginInterceptResult, AgentPluginResult, InterceptableAgentEvent, PluginPipelineResult, runPluginsForEvent } from "./plugins.js";
 import { AgentOptions } from "./agent-options.js";
 import { AgentRun } from "./session/run.js";
 import { SessionHandle } from "./agent-session-entry.js";
 import { Agent } from "./agent.js";
-export { Agent, type AgentEvent, type AgentEventContext, type AgentEventListener, type AgentHost, type AgentInput, type AgentOptions, type AgentPlugin, type AgentRun, type AgentToolChoice, type AssistantReasoning, type AssistantText, type CommitResult, type ExpectedSessionVersion, type RuntimeCreateLlmOptions, type RuntimeInput, type RuntimeLlm, type RuntimeLlmContext, type RuntimeLlmOutput, type RuntimeLlmOutputPart, type SessionHandle, type SessionInput, type SessionStore, type SessionStoreCommit, type StoredSession, type ToolCall, type ToolResult, type UserInput, type UserMessage, type UserMessageContent, type UserMessageContentPart, type UserMessageFileData, type UserMessageFilePart, type UserMessageImagePart, type UserMessageTextPart, type UserText, type UserTextContent, createLlm };
+import { delegateUserInput } from "./session/delegate-input.js";
+import { attachInputMeta, attachRuntimeInputMeta, stripEventMeta, stripInputMeta, userInputFromEvent } from "./session/input-meta.js";
+export { Agent, type AgentEvent, type AgentEventContext, type AgentEventListener, type AgentHost, type AgentInput, type AgentOptions, type AgentPlugin, type AgentPluginInterceptResult, type AgentPluginResult, type AgentRun, type AgentToolChoice, type AssistantReasoning, type AssistantText, type CommitResult, type ControlAgentEvent, type ExpectedSessionVersion, type InputEventMeta, type InputSource, type InterceptableAgentEvent, type LifecycleAgentEvent, type PluginPipelineResult, type RuntimeCreateLlmOptions, type RuntimeInput, type RuntimeLlm, type RuntimeLlmContext, type RuntimeLlmOutput, type RuntimeLlmOutputPart, type SessionHandle, type SessionInput, type SessionStore, type SessionStoreCommit, type StoredSession, type TelemetryAgentEvent, type ToolAgentEvent, type ToolCall, type ToolResult, type UserInput, type UserMessage, type UserMessageContent, type UserMessageContentPart, type UserMessageFileData, type UserMessageFilePart, type UserMessageImagePart, type UserMessageTextPart, type UserText, type UserTextContent, type VisibleAgentEvent, attachInputMeta, attachRuntimeInputMeta, createLlm, delegateUserInput, executionHost, isControlAgentEvent, isLifecycleAgentEvent, isTelemetryAgentEvent, isToolAgentEvent, isVisibleAgentEvent, runPluginsForEvent, stripEventMeta, stripInputMeta, userInputFromEvent };

package/dist/index.js

@@ -1,3 +1,8 @@
+import { executionHost } from "./execution/host.js";
 import { createLlm } from "./llm.js";
+import { attachInputMeta, attachRuntimeInputMeta, stripEventMeta, stripInputMeta, userInputFromEvent } from "./session/input-meta.js";
+import { runPluginsForEvent } from "./plugins.js";
 import { Agent } from "./agent.js";
-export { Agent, createLlm };
+import { delegateUserInput } from "./session/delegate-input.js";
+import { isControlAgentEvent, isLifecycleAgentEvent, isTelemetryAgentEvent, isToolAgentEvent, isVisibleAgentEvent } from "./session/events.js";
+export { Agent, attachInputMeta, attachRuntimeInputMeta, createLlm, delegateUserInput, executionHost, isControlAgentEvent, isLifecycleAgentEvent, isTelemetryAgentEvent, isToolAgentEvent, isVisibleAgentEvent, runPluginsForEvent, stripEventMeta, stripInputMeta, userInputFromEvent };