@effect-agent/platform-cloudflare 0.1.0-beta.13 → 0.1.0-beta.131

package/dist/ThreadObject.d.mts

@@ -0,0 +1,2 @@
+import { A as ThreadPublicationOptions, C as portCall, D as CloudflareDurableRuntimeOptions, E as CloudflareDurableRuntimeInitializationError, M as layerConfig, N as layerHostConfig, O as CloudflareDurableRuntimeServices, P as layerInHost, S as make, T as CloudflareBootstrapServices, _ as decodeAdminVerifyRequest, a as AdminVerifyRequest, b as encodeAdminResponse, c as Instance, d as RetryExecuted, g as decodeAdminResponse, h as decodeAdminExplainRequest, i as AdminResponse, j as layer, k as ThreadObjectPorts, l as ObligationsScanned, m as VerifiedIntegrity, n as AdminFailed, o as Class, p as ThreadRpcOperation, r as AdminFailure, s as ExplainedRecovery, t as AdminExplainRequest, u as Options, v as decodeObligationThresholds, w as submit, x as handleRpc, y as decodeRetryCommand } from "./ThreadObject-D8GzJxJB.mjs";
+export { AdminExplainRequest, AdminFailed, AdminFailure, AdminResponse, AdminVerifyRequest, type CloudflareBootstrapServices as BootstrapServices, Class, ExplainedRecovery, type CloudflareDurableRuntimeInitializationError as InitializationError, Instance, ObligationsScanned, Options, type ThreadPublicationOptions as PublicationOptions, RetryExecuted, type CloudflareDurableRuntimeOptions as RuntimeOptions, type CloudflareDurableRuntimeServices as Services, ThreadObjectPorts, ThreadRpcOperation, VerifiedIntegrity, decodeAdminExplainRequest, decodeAdminResponse, decodeAdminVerifyRequest, decodeObligationThresholds, decodeRetryCommand, encodeAdminResponse, handleRpc, layer, layerConfig, layerHostConfig, layerInHost, make, portCall, submit };

package/dist/ThreadObject.mjs

@@ -0,0 +1,3 @@
+import "./CloudflareThreadClient.mjs";
+import { C as layer, E as layerInHost, S as ThreadObjectPorts, T as layerHostConfig, _ as encodeAdminResponse, a as AdminVerifyRequest, b as portCall, c as RetryExecuted, d as VerifiedIntegrity, f as decodeAdminExplainRequest, g as decodeRetryCommand, h as decodeObligationThresholds, i as AdminResponse, m as decodeAdminVerifyRequest, n as AdminFailed, o as ExplainedRecovery, p as decodeAdminResponse, r as AdminFailure, s as ObligationsScanned, t as AdminExplainRequest, u as ThreadRpcOperation, v as handleRpc, w as layerConfig, x as submit, y as make } from "./ThreadObject-CVhZC-7l.mjs";
+export { AdminExplainRequest, AdminFailed, AdminFailure, AdminResponse, AdminVerifyRequest, ExplainedRecovery, ObligationsScanned, RetryExecuted, ThreadObjectPorts, ThreadRpcOperation, VerifiedIntegrity, decodeAdminExplainRequest, decodeAdminResponse, decodeAdminVerifyRequest, decodeObligationThresholds, decodeRetryCommand, encodeAdminResponse, handleRpc, layer, layerConfig, layerHostConfig, layerInHost, make, portCall, submit };

package/dist/WakeScheduler.d.mts

@@ -0,0 +1,23 @@
+import { ThreadObjectNamespace, ThreadObjectPlacement } from "./CloudflareBindings.mjs";
+import { DurableAlarmService } from "./Alarm.mjs";
+import { Layer } from "effect";
+import { WakeScheduler } from "effect-agent/wake-scheduler";
+declare namespace WakeScheduler_d_exports {
+  export { cloudflareWakeSchedulerLayer };
+}
+/**
+ * The DC `WakeScheduler` (plan §1.4):
+ *
+ * - `notify(local)` → `setAlarm(now)` — durable, cheap, coalescing (the alarm slot keeps the
+ *   earliest deadline) — plus a same-incarnation PubSub hint for `awaitSettlement` waiters.
+ * - `notify(remote)` → fire-and-forget `wake()` on the owning Object's stub with every error
+ *   swallowed and logged: hints are droppable, and the target's own alarm/scan pairing (the
+ *   maintenance pass re-polls unsettled children) guarantees liveness without this call.
+ * - `wakes` → the bounded sliding PubSub only. No important state lives in memory: the
+ *   subscription accelerates waiters within one incarnation and the settlement poll interval
+ *   is the correctness path.
+ */
+export declare const cloudflareWakeSchedulerLayer: Layer.Layer<WakeScheduler, never, DurableAlarmService | ThreadObjectPlacement | ThreadObjectNamespace>;
+//#endregion
+export { WakeScheduler_d_exports as t };
+//# sourceMappingURL=WakeScheduler.d.mts.map

package/dist/WakeScheduler.mjs

@@ -0,0 +1,57 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { ThreadObjectNamespace, ThreadObjectPlacement, callThreadObject } from "./CloudflareBindings.mjs";
+import { r as safeCauseMessage } from "./boundary-BguazVkh.mjs";
+import { DurableAlarmService } from "./Alarm.mjs";
+import { Effect, Layer, PubSub, Schema, Stream } from "effect";
+import "effect-agent/identifiers";
+import { WakeScheduler, makeWakeSubscriptionHub } from "effect-agent/wake-scheduler";
+//#region src/WakeScheduler.ts
+var WakeScheduler_exports = /* @__PURE__ */ __exportAll({ cloudflareWakeSchedulerLayer: () => cloudflareWakeSchedulerLayer });
+/**
+* Bounded in-memory wake buffer for same-incarnation `awaitSettlement` subscribers. Wake
+* hints are droppable by contract (consumers pair every subscription with ledger polls), so
+* a full buffer slides out the oldest hint and an eviction simply loses the buffer — the
+* poll interval and the persisted alarm keep liveness (persistence §14).
+*/
+const WAKE_BUFFER_CAPACITY = 1024;
+/** A remote wake stub call failed; always swallowed and logged (hints are droppable). */
+var RemoteWakeDropped = class extends Schema.TaggedError()("RemoteWakeDropped", {
+	threadId: Schema.String,
+	message: Schema.String,
+	cause: Schema.optionalKey(Schema.Defect())
+}) {};
+/**
+* The DC `WakeScheduler` (plan §1.4):
+*
+* - `notify(local)` → `setAlarm(now)` — durable, cheap, coalescing (the alarm slot keeps the
+*   earliest deadline) — plus a same-incarnation PubSub hint for `awaitSettlement` waiters.
+* - `notify(remote)` → fire-and-forget `wake()` on the owning Object's stub with every error
+*   swallowed and logged: hints are droppable, and the target's own alarm/scan pairing (the
+*   maintenance pass re-polls unsettled children) guarantees liveness without this call.
+* - `wakes` → the bounded sliding PubSub only. No important state lives in memory: the
+*   subscription accelerates waiters within one incarnation and the settlement poll interval
+*   is the correctness path.
+*/
+const cloudflareWakeSchedulerLayer = Layer.effect(WakeScheduler)(Effect.gen(function* () {
+	const alarm = yield* DurableAlarmService;
+	const placement = yield* ThreadObjectPlacement;
+	const namespace = yield* ThreadObjectNamespace;
+	const hints = yield* PubSub.sliding(WAKE_BUFFER_CAPACITY);
+	const progress = yield* makeWakeSubscriptionHub;
+	yield* Effect.addFinalizer(() => PubSub.shutdown(hints));
+	const notifyLocal = (threadId) => progress.notify(threadId).pipe(Effect.andThen(PubSub.publish(hints, threadId)), Effect.andThen(alarm.scheduleNow), Effect.catch((error) => Effect.logWarning("CloudflareWakeScheduler: local alarm wake failed", error)), Effect.asVoid);
+	const notifyRemote = (threadId) => callThreadObject(threadId, (target) => target.wake(), (cause) => RemoteWakeDropped.make({
+		threadId,
+		message: safeCauseMessage(cause, "The remote wake failed without a diagnostic"),
+		cause
+	})).pipe(Effect.provideService(ThreadObjectNamespace, namespace), Effect.catch((error) => Effect.logWarning(`CloudflareWakeScheduler: remote wake of ${threadId} dropped`, error)), Effect.asVoid);
+	return WakeScheduler.of({
+		notify: (threadId) => placement.ownsThread(threadId) ? notifyLocal(threadId) : notifyRemote(threadId),
+		subscribe: progress.subscribe,
+		wakes: Stream.fromPubSub(hints)
+	});
+}));
+//#endregion
+export { cloudflareWakeSchedulerLayer, WakeScheduler_exports as t };
+
+//# sourceMappingURL=WakeScheduler.mjs.map

package/dist/WakeScheduler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"WakeScheduler.mjs","names":[],"sources":["../src/WakeScheduler.ts"],"sourcesContent":["import { Effect, Layer, PubSub, Schema, Stream } from \"effect\";\nimport { type ThreadId } from \"effect-agent/identifiers\";\nimport { makeWakeSubscriptionHub, WakeScheduler } from \"effect-agent/wake-scheduler\";\n\nimport { DurableAlarmService } from \"./Alarm.ts\";\nimport {\n  callThreadObject,\n  ThreadObjectPlacement,\n  ThreadObjectNamespace,\n} from \"./CloudflareBindings.ts\";\nimport { safeCauseMessage } from \"./internal/boundary.ts\";\n\n/**\n * Bounded in-memory wake buffer for same-incarnation `awaitSettlement` subscribers. Wake\n * hints are droppable by contract (consumers pair every subscription with ledger polls), so\n * a full buffer slides out the oldest hint and an eviction simply loses the buffer — the\n * poll interval and the persisted alarm keep liveness (persistence §14).\n */\nconst WAKE_BUFFER_CAPACITY = 1_024;\n\n/** A remote wake stub call failed; always swallowed and logged (hints are droppable). */\nclass RemoteWakeDropped extends Schema.TaggedError<RemoteWakeDropped>()(\"RemoteWakeDropped\", {\n  threadId: Schema.String,\n  message: Schema.String,\n  cause: Schema.optionalKey(Schema.Defect()),\n}) {}\n\n/**\n * The DC `WakeScheduler` (plan §1.4):\n *\n * - `notify(local)` → `setAlarm(now)` — durable, cheap, coalescing (the alarm slot keeps the\n *   earliest deadline) — plus a same-incarnation PubSub hint for `awaitSettlement` waiters.\n * - `notify(remote)` → fire-and-forget `wake()` on the owning Object's stub with every error\n *   swallowed and logged: hints are droppable, and the target's own alarm/scan pairing (the\n *   maintenance pass re-polls unsettled children) guarantees liveness without this call.\n * - `wakes` → the bounded sliding PubSub only. No important state lives in memory: the\n *   subscription accelerates waiters within one incarnation and the settlement poll interval\n *   is the correctness path.\n */\nexport const cloudflareWakeSchedulerLayer: Layer.Layer<\n  WakeScheduler,\n  never,\n  DurableAlarmService | ThreadObjectPlacement | ThreadObjectNamespace\n> = Layer.effect(WakeScheduler)(\n  Effect.gen(function* () {\n    const alarm = yield* DurableAlarmService;\n    const placement = yield* ThreadObjectPlacement;\n    const namespace = yield* ThreadObjectNamespace;\n    const hints = yield* PubSub.sliding<ThreadId>(WAKE_BUFFER_CAPACITY);\n    const progress = yield* makeWakeSubscriptionHub;\n\n    yield* Effect.addFinalizer(() => PubSub.shutdown(hints));\n\n    const notifyLocal = (threadId: ThreadId) =>\n      progress.notify(threadId).pipe(\n        Effect.andThen(PubSub.publish(hints, threadId)),\n        Effect.andThen(alarm.scheduleNow),\n        Effect.catch((error) =>\n          // `notify` never fails by contract; a failed alarm write degrades to \"hint lost\"\n          // and the pass re-arm (or the next entry point's pre-arm) restores the invariant.\n          Effect.logWarning(\"CloudflareWakeScheduler: local alarm wake failed\", error),\n        ),\n        Effect.asVoid,\n      );\n\n    const notifyRemote = (threadId: ThreadId) =>\n      callThreadObject(\n        threadId,\n        (target) => target.wake(),\n        (cause) =>\n          RemoteWakeDropped.make({\n            threadId,\n            message: safeCauseMessage(cause, \"The remote wake failed without a diagnostic\"),\n            cause,\n          }),\n      ).pipe(\n        Effect.provideService(ThreadObjectNamespace, namespace),\n        Effect.catch((error) =>\n          Effect.logWarning(`CloudflareWakeScheduler: remote wake of ${threadId} dropped`, error),\n        ),\n        Effect.asVoid,\n      );\n\n    return WakeScheduler.of({\n      notify: (threadId) =>\n        placement.ownsThread(threadId) ? notifyLocal(threadId) : notifyRemote(threadId),\n      subscribe: progress.subscribe,\n      wakes: Stream.fromPubSub(hints),\n    });\n  }),\n);\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAM,uBAAuB;;AAG7B,IAAM,oBAAN,cAAgC,OAAO,YAA+B,CAAC,CAAC,qBAAqB;CAC3F,UAAU,OAAO;CACjB,SAAS,OAAO;CAChB,OAAO,OAAO,YAAY,OAAO,OAAO,CAAC;AAC3C,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;AAcJ,MAAa,+BAIT,MAAM,OAAO,aAAa,CAAC,CAC7B,OAAO,IAAI,aAAa;CACtB,MAAM,QAAQ,OAAO;CACrB,MAAM,YAAY,OAAO;CACzB,MAAM,YAAY,OAAO;CACzB,MAAM,QAAQ,OAAO,OAAO,QAAkB,oBAAoB;CAClE,MAAM,WAAW,OAAO;CAExB,OAAO,OAAO,mBAAmB,OAAO,SAAS,KAAK,CAAC;CAEvD,MAAM,eAAe,aACnB,SAAS,OAAO,QAAQ,CAAC,CAAC,KACxB,OAAO,QAAQ,OAAO,QAAQ,OAAO,QAAQ,CAAC,GAC9C,OAAO,QAAQ,MAAM,WAAW,GAChC,OAAO,OAAO,UAGZ,OAAO,WAAW,oDAAoD,KAAK,CAC7E,GACA,OAAO,MACT;CAEF,MAAM,gBAAgB,aACpB,iBACE,WACC,WAAW,OAAO,KAAK,IACvB,UACC,kBAAkB,KAAK;EACrB;EACA,SAAS,iBAAiB,OAAO,6CAA6C;EAC9E;CACF,CAAC,CACL,CAAC,CAAC,KACA,OAAO,eAAe,uBAAuB,SAAS,GACtD,OAAO,OAAO,UACZ,OAAO,WAAW,2CAA2C,SAAS,WAAW,KAAK,CACxF,GACA,OAAO,MACT;CAEF,OAAO,cAAc,GAAG;EACtB,SAAS,aACP,UAAU,WAAW,QAAQ,IAAI,YAAY,QAAQ,IAAI,aAAa,QAAQ;EAChF,WAAW,SAAS;EACpB,OAAO,OAAO,WAAW,KAAK;CAChC,CAAC;AACH,CAAC,CACH"}

package/dist/boundary-BguazVkh.mjs

@@ -0,0 +1,42 @@
+import { Predicate } from "effect";
+//#region src/internal/boundary.ts
+const MAX_FOREIGN_DIAGNOSTIC_LENGTH = 8192;
+const boundForeignDiagnostic = (message) => message.slice(0, MAX_FOREIGN_DIAGNOSTIC_LENGTH);
+/** Render a foreign failure without trusting accessors or coercion hooks on the value. */
+const safeCauseMessage = (cause, fallback) => {
+	try {
+		const message = cause instanceof Error ? cause.message : cause;
+		return boundForeignDiagnostic(typeof message === "string" ? message : String(message));
+	} catch {
+		return boundForeignDiagnostic(fallback);
+	}
+};
+/** Include an Error name when worker-failure classification needs it. */
+const safeCauseDiagnostic = (cause, fallback) => {
+	try {
+		return cause instanceof Error ? boundForeignDiagnostic(`${cause.name}: ${cause.message}`) : safeCauseMessage(cause, fallback);
+	} catch {
+		return boundForeignDiagnostic(fallback);
+	}
+};
+/** Read Cloudflare RPC classifications without letting a hostile proxy defect the client. */
+const cloudflareFailureSignals = (cause) => {
+	if (!Predicate.isObjectKeyword(cause)) return {};
+	try {
+		const retryableValue = Reflect.get(cause, "retryable");
+		const overloadedValue = Reflect.get(cause, "overloaded");
+		const resetValue = Reflect.get(cause, "durableObjectReset");
+		const retryable = typeof retryableValue === "boolean" ? retryableValue : resetValue === true ? true : void 0;
+		const overloaded = typeof overloadedValue === "boolean" ? overloadedValue : void 0;
+		return {
+			...retryable === void 0 ? {} : { retryable },
+			...overloaded === void 0 ? {} : { overloaded }
+		};
+	} catch {
+		return {};
+	}
+};
+//#endregion
+export { safeCauseDiagnostic as n, safeCauseMessage as r, cloudflareFailureSignals as t };
+
+//# sourceMappingURL=boundary-BguazVkh.mjs.map

package/dist/boundary-BguazVkh.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-BguazVkh.mjs","names":[],"sources":["../src/internal/boundary.ts"],"sourcesContent":["import { Predicate } from \"effect\";\n\nconst MAX_FOREIGN_DIAGNOSTIC_LENGTH = 8_192;\n\nconst boundForeignDiagnostic = (message: string): string =>\n  message.slice(0, MAX_FOREIGN_DIAGNOSTIC_LENGTH);\n\n/** Render a foreign failure without trusting accessors or coercion hooks on the value. */\nexport const safeCauseMessage = (cause: unknown, fallback: string): string => {\n  try {\n    const message = cause instanceof Error ? cause.message : cause;\n\n    return boundForeignDiagnostic(typeof message === \"string\" ? message : String(message));\n  } catch {\n    return boundForeignDiagnostic(fallback);\n  }\n};\n\n/** Include an Error name when worker-failure classification needs it. */\nexport const safeCauseDiagnostic = (cause: unknown, fallback: string): string => {\n  try {\n    return cause instanceof Error\n      ? boundForeignDiagnostic(`${cause.name}: ${cause.message}`)\n      : safeCauseMessage(cause, fallback);\n  } catch {\n    return boundForeignDiagnostic(fallback);\n  }\n};\n\nexport interface CloudflareFailureSignals {\n  readonly retryable?: boolean | undefined;\n  readonly overloaded?: boolean | undefined;\n}\n\n/** Read Cloudflare RPC classifications without letting a hostile proxy defect the client. */\nexport const cloudflareFailureSignals = (cause: unknown): CloudflareFailureSignals => {\n  if (!Predicate.isObjectKeyword(cause)) return {};\n  try {\n    const retryableValue = Reflect.get(cause, \"retryable\");\n    const overloadedValue = Reflect.get(cause, \"overloaded\");\n    const resetValue = Reflect.get(cause, \"durableObjectReset\");\n\n    const retryable =\n      typeof retryableValue === \"boolean\" ? retryableValue : resetValue === true ? true : undefined;\n\n    const overloaded = typeof overloadedValue === \"boolean\" ? overloadedValue : undefined;\n\n    return {\n      ...(retryable === undefined ? {} : { retryable }),\n      ...(overloaded === undefined ? {} : { overloaded }),\n    };\n  } catch {\n    return {};\n  }\n};\n"],"mappings":";;AAEA,MAAM,gCAAgC;AAEtC,MAAM,0BAA0B,YAC9B,QAAQ,MAAM,GAAG,6BAA6B;;AAGhD,MAAa,oBAAoB,OAAgB,aAA6B;CAC5E,IAAI;EACF,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;EAEzD,OAAO,uBAAuB,OAAO,YAAY,WAAW,UAAU,OAAO,OAAO,CAAC;CACvF,QAAQ;EACN,OAAO,uBAAuB,QAAQ;CACxC;AACF;;AAGA,MAAa,uBAAuB,OAAgB,aAA6B;CAC/E,IAAI;EACF,OAAO,iBAAiB,QACpB,uBAAuB,GAAG,MAAM,KAAK,IAAI,MAAM,SAAS,IACxD,iBAAiB,OAAO,QAAQ;CACtC,QAAQ;EACN,OAAO,uBAAuB,QAAQ;CACxC;AACF;;AAQA,MAAa,4BAA4B,UAA6C;CACpF,IAAI,CAAC,UAAU,gBAAgB,KAAK,GAAG,OAAO,CAAC;CAC/C,IAAI;EACF,MAAM,iBAAiB,QAAQ,IAAI,OAAO,WAAW;EACrD,MAAM,kBAAkB,QAAQ,IAAI,OAAO,YAAY;EACvD,MAAM,aAAa,QAAQ,IAAI,OAAO,oBAAoB;EAE1D,MAAM,YACJ,OAAO,mBAAmB,YAAY,iBAAiB,eAAe,OAAO,OAAO,KAAA;EAEtF,MAAM,aAAa,OAAO,oBAAoB,YAAY,kBAAkB,KAAA;EAE5E,OAAO;GACL,GAAI,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU;GAC/C,GAAI,eAAe,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW;EACnD;CACF,QAAQ;EACN,OAAO,CAAC;CACV;AACF"}