@effect-agent/platform-cloudflare 0.0.1-beta.0 → 0.0.1-beta.3

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@effect-agent/platform-cloudflare",
-  "version": "0.0.1-beta.0",
+  "version": "0.0.1-beta.3",
   "description": "Class DC layer assembly for Effect Agent: SQLite-backed Conversation Durable Objects with alarm-driven recovery.",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/danieljvdm/effect-agent.git",
@@ -28,29 +28,24 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@effect-agent/core": "0.0.1-beta.2",
-    "@effect-agent/session": "0.0.1-beta.2",
-    "@effect-agent/storage-cloudflare": "0.0.1-beta.0"
+    "@effect-agent/core": "0.0.1-beta.3",
+    "@effect-agent/session": "0.0.1-beta.3",
+    "@effect-agent/storage-cloudflare": "0.0.1-beta.3",
+    "@effect/platform-browser": "4.0.0-beta.102",
+    "@effect/sql-sqlite-do": "4.0.0-beta.102",
+    "effect": "4.0.0-beta.102"
   },
   "devDependencies": {
     "@cloudflare/vitest-pool-workers": "0.21.3",
     "@cloudflare/workers-types": "5.20260813.1",
-    "@effect-agent/capabilities": "0.0.1-beta.1",
-    "@effect-agent/engine": "0.0.1-beta.1",
-    "@effect-agent/testing": "0.0.1-beta.1",
-    "@effect/platform-browser": "4.0.0-beta.105",
-    "@effect/sql-sqlite-do": "4.0.0-beta.105",
-    "@effect/vitest": "4.0.0-beta.105",
-    "effect": "4.0.0-beta.105",
+    "@effect-agent/capabilities": "0.0.1-beta.3",
+    "@effect-agent/engine": "0.0.1-beta.3",
+    "@effect-agent/testing": "0.0.1-beta.3",
+    "@effect/vitest": "4.0.0-beta.102",
     "esbuild": "0.28.1",
     "miniflare": "4.20260730.0",
     "typescript": "7.0.2",
     "vite-plus": "0.2.6",
     "vitest": "4.1.10"
-  },
-  "peerDependencies": {
-    "@effect/platform-browser": "4.0.0-beta.105",
-    "@effect/sql-sqlite-do": "4.0.0-beta.105",
-    "effect": "4.0.0-beta.105"
   }
 }

package/src/alarm.ts

@@ -25,7 +25,7 @@ import { CloudflareDurableRuntimeConfig } from "./config.ts";
  */
 
 /** The Durable Object alarm API failed; surfaces on host entry points as a typed refusal. */
-export class DurableAlarmError extends Schema.TaggedError<DurableAlarmError>()(
+export class DurableAlarmError extends Schema.TaggedErrorClass<DurableAlarmError>()(
   "DurableAlarmError",
   {
     operation: Schema.String,

package/src/bindings.ts

@@ -10,7 +10,7 @@ import { Context, Effect, Layer, Schema } from "effect";
  */
 
 /** A Cloudflare platform binding was missing or carried the wrong shape (DEPLOY-003/010). */
-export class CloudflareBindingError extends Schema.TaggedError<CloudflareBindingError>()(
+export class CloudflareBindingError extends Schema.TaggedErrorClass<CloudflareBindingError>()(
   "CloudflareBindingError",
   {
     binding: Schema.String,

package/src/client.ts

@@ -59,7 +59,7 @@ export const boundHostDiagnostic = (value: string): string =>
  * The envelope itself could not be honored: the Object could not decode the request, or a
  * response could not be encoded/decoded. Never carries operation semantics.
  */
-export class HostProtocolError extends Schema.TaggedError<HostProtocolError>()(
+export class HostProtocolError extends Schema.TaggedErrorClass<HostProtocolError>()(
   "HostProtocolError",
   {
     message: BoundedDiagnostic,
@@ -67,7 +67,7 @@ export class HostProtocolError extends Schema.TaggedError<HostProtocolError>()(
 ) {}
 
 /** The Worker-side stub call itself failed (RPC rejection, overload, eviction mid-call). */
-export class ConversationClientError extends Schema.TaggedError<ConversationClientError>()(
+export class ConversationClientError extends Schema.TaggedErrorClass<ConversationClientError>()(
   "ConversationClientError",
   {
     conversationId: Schema.String,

package/src/config.ts

@@ -12,7 +12,7 @@ const PositiveMillis = Schema.Int.check(Schema.isGreaterThan(0));
 const NonNegativeMillis = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
 
 /** The supplied Cloudflare durable runtime configuration failed validation (DEPLOY-003). */
-export class CloudflarePlatformConfigError extends Schema.TaggedError<CloudflarePlatformConfigError>()(
+export class CloudflarePlatformConfigError extends Schema.TaggedErrorClass<CloudflarePlatformConfigError>()(
   "CloudflarePlatformConfigError",
   {
     message: Schema.String,
@@ -28,7 +28,7 @@ export class CloudflarePlatformConfigError extends Schema.TaggedError<Cloudflare
  * Conversation Object's submit entry point before `DurableAgentRuntime.submit` runs, and
  * nothing was admitted or written.
  */
-export class AdmissionLimitExceeded extends Schema.TaggedError<AdmissionLimitExceeded>()(
+export class AdmissionLimitExceeded extends Schema.TaggedErrorClass<AdmissionLimitExceeded>()(
   "AdmissionLimitExceeded",
   {
     limit: Schema.Literals(["queue-depth", "input-bytes", "database-bytes"]),

package/src/conversation-object.ts

@@ -38,7 +38,6 @@ import {
   DurableObjectContext,
   conversationNamespaceLayer,
   type CloudflareBindingError,
-  type ConversationObjectRpc,
 } from "./bindings.ts";
 import {
   AbortRecorded,
@@ -96,25 +95,6 @@ export interface ConversationObjectOptions extends CloudflareDurableRuntimeOptio
   readonly namespaceBinding: string;
 }
 
-/**
- * Public instance surface of the class returned by `makeConversationObjectClass`. It includes
- * the Worker/sibling RPC contract, the administrative RPC entry points, the platform alarm
- * handler, and the inherited Object context used by application subclasses.
- */
-export interface ConversationObjectInstance
-  extends DurableObject<Cloudflare.Env>, ConversationObjectRpc {
-  explainEncoded(encoded: unknown): Promise<unknown>;
-  verifyEncoded(encoded: unknown): Promise<unknown>;
-  retryEncoded(encoded: unknown): Promise<unknown>;
-  obligationsEncoded(encoded: unknown): Promise<unknown>;
-  alarm(): Promise<void>;
-}
-
-/** Public constructor returned by `makeConversationObjectClass`. */
-export interface ConversationObjectConstructor {
-  new (ctx: DurableObjectState, env: Cloudflare.Env): ConversationObjectInstance;
-}
-
 type ConversationObjectError = CloudflareDurableRuntimeInitializationError | CloudflareBindingError;
 
 type EndpointServices = CloudflareDurableRuntimeServices | DurableObjectContext;
@@ -628,10 +608,37 @@ const gateEndpoint: Effect.Effect<void, unknown, EndpointServices> = Effect.gen(
   yield* maintenance.ensureAlarm;
 });
 
-/** Build the application's Conversation Object class (export it from the Worker entry). */
+/** The public endpoint surface of one Conversation Object instance. */
+export interface ConversationObjectInstance extends DurableObject {
+  submitEncoded(encoded: unknown): Promise<unknown>;
+  awaitSettlementEncoded(encoded: unknown): Promise<unknown>;
+  observePage(encoded: unknown): Promise<unknown>;
+  abortEncoded(encoded: unknown): Promise<unknown>;
+  resolveApprovalEncoded(encoded: unknown): Promise<unknown>;
+  resolveUnknownEncoded(encoded: unknown): Promise<unknown>;
+  explainEncoded(encoded: unknown): Promise<unknown>;
+  verifyEncoded(encoded: unknown): Promise<unknown>;
+  retryEncoded(encoded: unknown): Promise<unknown>;
+  obligationsEncoded(encoded: unknown): Promise<unknown>;
+  portCall(encoded: unknown): Promise<unknown>;
+  wake(): Promise<void>;
+  alarm(): Promise<void>;
+}
+
+/** The constructor shape workerd instantiates for each Conversation Object. */
+export interface ConversationObjectClass {
+  new (ctx: DurableObjectState, env: Cloudflare.Env): ConversationObjectInstance;
+}
+
+/**
+ * Build the application's Conversation Object class (export it from the
+ * Worker entry). The explicit return type is what makes declaration emit
+ * possible: the class body carries a private runtime field, and TS4094
+ * rejects inferring an exported anonymous class type around it.
+ */
 export const makeConversationObjectClass = (
   options: ConversationObjectOptions,
-): ConversationObjectConstructor => {
+): ConversationObjectClass => {
   class ConversationObject extends DurableObject {
     readonly #runtime: ManagedRuntime.ManagedRuntime<EndpointServices, ConversationObjectError>;
 
@@ -649,7 +656,7 @@ export const makeConversationObjectClass = (
       );
       // The constructor gate: local-only checks; never the recovery pass (deadlock argument,
       // plan §1.4). A failure here fails every delivery with the typed construction error.
-      void ctx.blockConcurrencyWhile(() => this.#runtime.runPromise(gateEndpoint));
+      ctx.blockConcurrencyWhile(() => this.#runtime.runPromise(gateEndpoint));
     }
 
     async submitEncoded(encoded: unknown): Promise<unknown> {

package/src/layers.ts

@@ -97,35 +97,16 @@ export interface CloudflareDurableRuntimeOptions {
   readonly toolReconciler?: Layer.Layer<ToolReconciler> | undefined;
   /**
    * Registered worker Bindings resolved at durable claim time (S2, spec/subagents.md §11):
-   * build each with `DurableWorkerBinding.make(binding, digests)`. An Effect or callback form is
-   * accepted because capture can be effectful. The callback receives the live Object context and
-   * derived identities and is evaluated once per incarnation during Layer construction. Defaults
-   * to the empty registration (every resolved claim fails closed).
+   * build each with `DurableWorkerBinding.make(binding, digests)`. An Effect form is accepted
+   * because the capture is effectful; it runs once per incarnation during Layer construction.
+   * Defaults to the empty registration (every resolved claim fails closed).
    */
-  readonly bindings?: CloudflareBindingSource | undefined;
-}
-
-/** Per-incarnation host values available while registered worker Bindings are captured. */
-export interface CloudflareBindingSourceContext {
-  readonly ctx: DurableObjectState;
-  readonly env: unknown;
-  readonly conversationId: ConversationId;
-  readonly producerId: ProducerId;
+  readonly bindings?:
+    | ReadonlyArray<ResolvedBinding>
+    | Effect.Effect<ReadonlyArray<ResolvedBinding>>
+    | undefined;
 }
 
-/**
- * Registered worker Bindings, or a closed Effect/callback that captures them once for each
- * Durable Object incarnation. Callback Effects cannot require services or fail typed.
- */
-export type CloudflareBindingSource =
-  | ReadonlyArray<ResolvedBinding>
-  | Effect.Effect<ReadonlyArray<ResolvedBinding>, never, never>
-  | ((
-      context: CloudflareBindingSourceContext,
-    ) =>
-      | ReadonlyArray<ResolvedBinding>
-      | Effect.Effect<ReadonlyArray<ResolvedBinding>, never, never>);
-
 /** Every construction failure of the assembled Cloudflare durable runtime stack. */
 export type CloudflareDurableRuntimeInitializationError =
   | CloudflarePlatformConfigError
@@ -227,19 +208,13 @@ const conversationIdFromState = (
       );
 
 const resolveBindings = (
-  source: CloudflareDurableRuntimeOptions["bindings"],
-  context: CloudflareBindingSourceContext,
+  bindings: CloudflareDurableRuntimeOptions["bindings"],
 ): Effect.Effect<ReadonlyArray<ResolvedBinding>> =>
-  source === undefined
+  bindings === undefined
     ? Effect.succeed([])
-    : Effect.isEffect(source)
-      ? source
-      : typeof source === "function"
-        ? Effect.suspend(() => {
-            const bindings = source(context);
-            return Effect.isEffect(bindings) ? bindings : Effect.succeed(bindings);
-          })
-        : Effect.succeed(source);
+    : Effect.isEffect(bindings)
+      ? bindings
+      : Effect.succeed(bindings);
 
 /**
  * The DC Layer assembly (deployment §12: a Layer-assembly library, not an app entrypoint;
@@ -268,7 +243,7 @@ export class CloudflareDurableRuntime {
   > {
     return Layer.unwrap(
       Effect.gen(function* () {
-        const { ctx, env } = yield* DurableObjectContext;
+        const { ctx } = yield* DurableObjectContext;
         const config = yield* configFromOptions(options);
         const conversationId = yield* conversationIdFromState(ctx);
         const producerId = yield* decodeProducerId(
@@ -342,10 +317,7 @@ export class CloudflareDurableRuntime {
             : Layer.succeed(DurableRuntimeFailpoint)({ hit: options.runtimeFailpoint(ctx) });
         const reconcilerLayer = options.toolReconciler ?? ToolReconciler.uncertain;
         const bindingResolverLayer = Layer.effect(AgentBindingResolver)(
-          Effect.map(
-            resolveBindings(options.bindings, { ctx, env, conversationId, producerId }),
-            (bindings) => AgentBindingResolver.fromBindings(bindings),
-          ),
+          Effect.map(resolveBindings(options.bindings), AgentBindingResolver.fromBindings),
         );
 
         const base = Layer.mergeAll(

package/src/wake-scheduler.ts

@@ -14,7 +14,7 @@ import { ConversationObjectIdentity, ConversationObjectNamespace } from "./bindi
 const WAKE_BUFFER_CAPACITY = 1_024;
 
 /** A remote wake stub call failed; always swallowed and logged (hints are droppable). */
-class RemoteWakeDropped extends Schema.TaggedError<RemoteWakeDropped>()("RemoteWakeDropped", {
+class RemoteWakeDropped extends Schema.TaggedErrorClass<RemoteWakeDropped>()("RemoteWakeDropped", {
   conversationId: Schema.String,
   message: Schema.String,
   cause: Schema.optionalKey(Schema.Defect()),