effect-durable-agent-cloudflare 0.1.0-alpha.6 → 0.1.0-alpha.7

package/README.md

@@ -30,6 +30,12 @@ Idle sockets use `ctx.acceptWebSocket`, Effect Schema attachments, and
 automatic ping responses. They own no timer or resident subscriber fiber.
 Register only the concrete application subclass in `wrangler.jsonc`.
 
+Apps with an existing client wire contract may register one
+`EDAWebSocketProjection`. An authenticated Worker selects it on the internal
+request with `EDA_WEB_SOCKET_PROJECTION_HEADER`; the Durable Object still owns
+the accepted socket and persists the app projection state through hibernation.
+Do not build a Worker-side WebSocket bridge for protocol translation.
+
 Durable Object RPC uses structured clone. Encode Schema class instances before
 passing commands or batches across the Worker-to-object boundary with
 `encodeEdaRpcCommand` or `encodeEdaRpcSubmittables`.

package/dist/durable-object.d.ts

@@ -1,4 +1,4 @@
-import { r as EDASessionControllerOptions } from "./session-controller-BSMHhS_l.js";
+import { i as EDASessionControllerOptions, l as EDAWebSocketProjection } from "./session-controller-BCsOxE22.js";
 import { DurableObject } from "cloudflare:workers";
 import { CommittedCommandTerminalEvent, EDARuntimeConfig } from "effect-durable-agent/services/runtime";
 import { CommittedDurableEvent } from "effect-durable-agent/services/session-store";
@@ -6,6 +6,8 @@ import { DurableTranscriptMessage } from "effect-durable-agent/domain/message-tr
 import { EDASessionSnapshot } from "effect-durable-agent/services/session-query";
 
 //#region src/durable-object.d.ts
+/** Internal Worker-to-object header selecting an app-owned WebSocket projection. */
+declare const EDA_WEB_SOCKET_PROJECTION_HEADER = "x-eda-websocket-projection";
 /** Raw RPC shape decoded before admitting one session command. */
 interface EDASessionCommandRpcInput {
   readonly command: unknown;
@@ -36,10 +38,20 @@ interface EDASessionBlockOnCommandRpcInput {
   readonly sessionId: string;
   readonly trace: unknown;
 }
+/** EDA RPC methods required by the session namespace helper. */
+interface EDASessionRpcSurface {
+  readonly submit: (input: EDASessionCommandRpcInput) => Promise<CommittedDurableEvent>;
+  readonly submitBatch: (input: EDASessionSubmitBatchRpcInput) => Promise<ReadonlyArray<CommittedDurableEvent>>;
+  readonly submitAndBlock: (input: EDASessionCommandRpcInput) => Promise<CommittedCommandTerminalEvent>;
+  readonly blockOnCommand: (input: EDASessionBlockOnCommandRpcInput) => Promise<CommittedCommandTerminalEvent>;
+  readonly snapshot: (input: EDASessionScopedRpcInput) => Promise<EDASessionSnapshot>;
+  readonly messages: (input: EDASessionScopedRpcInput) => Promise<ReadonlyArray<DurableTranscriptMessage>>;
+  readonly destroySession: (input: EDASessionScopedRpcInput) => Promise<void>;
+}
 /** Constructor options for concrete app subclasses of the EDA Durable Object base. */
-type EDASessionDurableObjectOptions = Omit<EDASessionControllerOptions, "background" | "getWebSockets" | "storage">;
+type EDASessionDurableObjectOptions<ProjectionState extends object = never> = Omit<EDASessionControllerOptions<ProjectionState>, "background" | "getWebSockets" | "storage">;
 /** Resolve a concrete EDA session Durable Object binding by domain session id. */
-declare const getEDASessionDurableObjectByName: <T extends EDASessionDurableObject<object>>(namespace: DurableObjectNamespace<T>, sessionId: string) => DurableObjectStub<T>;
+declare const getEDASessionDurableObjectByName: <T extends Rpc.DurableObjectBranded & EDASessionRpcSurface>(namespace: DurableObjectNamespace<T>, sessionId: string) => DurableObjectStub<T>;
 /**
  * Base class for raw Cloudflare Durable Object hosts of one EDA session.
  *
@@ -48,9 +60,9 @@ declare const getEDASessionDurableObjectByName: <T extends EDASessionDurableObje
  * class is deliberately not exported from `workers/app.ts` and owns no binding
  * name or routing convention.
  */
-declare abstract class EDASessionDurableObject<EnvType extends object = object> extends DurableObject<EnvType> {
+declare abstract class EDASessionDurableObject<EnvType extends object = object, ProjectionState extends object = never> extends DurableObject<EnvType> {
   #private;
-  protected constructor(ctx: DurableObjectState, env: EnvType, options: EDASessionDurableObjectOptions);
+  protected constructor(ctx: DurableObjectState, env: EnvType, options: EDASessionDurableObjectOptions<ProjectionState>);
   fetch(request: Request): Promise<Response>;
   submit(input: EDASessionCommandRpcInput): Promise<CommittedDurableEvent>;
   submitBatch(input: EDASessionSubmitBatchRpcInput): Promise<ReadonlyArray<CommittedDurableEvent>>;
@@ -78,5 +90,5 @@ declare const encodeEdaRpcCommittedDurableEvent: (event: CommittedDurableEvent)
 /** Encode runtime snapshots into structured-clone-safe Durable Object RPC payloads. */
 declare const encodeEdaRpcSessionSnapshot: (snapshot: EDASessionSnapshot) => EDASessionSnapshot;
 //#endregion
-export { EDASessionBlockOnCommandRpcInput, EDASessionCommandRpcInput, EDASessionDurableObject, EDASessionDurableObjectOptions, EDASessionEventsRpcInput, EDASessionScopedRpcInput, EDASessionSubmitBatchRpcInput, edaRuntimeConfig, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcSessionSnapshot, getEDASessionDurableObjectByName };
+export { EDASessionBlockOnCommandRpcInput, EDASessionCommandRpcInput, EDASessionDurableObject, EDASessionDurableObjectOptions, EDASessionEventsRpcInput, EDASessionRpcSurface, EDASessionScopedRpcInput, EDASessionSubmitBatchRpcInput, type EDAWebSocketProjection, EDA_WEB_SOCKET_PROJECTION_HEADER, edaRuntimeConfig, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcSessionSnapshot, getEDASessionDurableObjectByName };
 //# sourceMappingURL=durable-object.d.ts.map

package/dist/durable-object.js

@@ -1,5 +1,5 @@
 import { decodeEdaRpcCommand, decodeEdaRpcSubmittables, encodeEdaRpcDurableEvent } from "./rpc.js";
-import { t as EDASessionController } from "./session-controller-Bo7DyydT.js";
+import { t as EDASessionController } from "./session-controller-CMbW7vgf.js";
 import { DurableObject } from "cloudflare:workers";
 import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
@@ -8,6 +8,8 @@ import { CommandId, SequenceNumber, SessionId } from "effect-durable-agent/types
 import { EDATraceMetadata, makeEDATraceMetadataFromParent, makeRootEDATraceMetadata, parseEDATraceparent } from "effect-durable-agent/types/tracing";
 import { EDA_WEB_SOCKET_PING_MESSAGE, EDA_WEB_SOCKET_PONG_MESSAGE } from "effect-durable-agent/websocket";
 //#region src/durable-object.ts
+/** Internal Worker-to-object header selecting an app-owned WebSocket projection. */
+const EDA_WEB_SOCKET_PROJECTION_HEADER = "x-eda-websocket-projection";
 /** Resolve a concrete EDA session Durable Object binding by domain session id. */
 const getEDASessionDurableObjectByName = (namespace, sessionId) => namespace.getByName(sessionId);
 /**
@@ -20,8 +22,10 @@ const getEDASessionDurableObjectByName = (namespace, sessionId) => namespace.get
 */
 var EDASessionDurableObject = class extends DurableObject {
 	#controller;
+	#webSocketProjectionId;
 	constructor(ctx, env, options) {
 		super(ctx, env);
+		this.#webSocketProjectionId = options.webSocketProjection?.id;
 		const storage = toEDASessionStorage(this.ctx.storage);
 		this.#controller = new EDASessionController({
 			...options,
@@ -39,16 +43,25 @@ var EDASessionDurableObject = class extends DurableObject {
 		const url = new URL(request.url);
 		const sessionIdRaw = url.searchParams.get("sessionId");
 		if (sessionIdRaw === null) return new Response("Missing sessionId.", { status: 400 });
-		const afterSeq = Number(url.searchParams.get("afterSeq") ?? "0");
-		if (!Number.isInteger(afterSeq) || afterSeq < 0) return new Response("Invalid afterSeq.", { status: 400 });
+		const afterSeqRaw = url.searchParams.get("afterSeq");
+		const afterSeq = afterSeqRaw === null ? void 0 : Number(afterSeqRaw);
+		if (afterSeq !== void 0 && (!Number.isInteger(afterSeq) || afterSeq < 0)) return new Response("Invalid afterSeq.", { status: 400 });
+		const projectionId = request.headers.get("x-eda-websocket-projection") ?? void 0;
+		if (projectionId !== void 0 && projectionId !== this.#webSocketProjectionId) return new Response("Unsupported WebSocket projection.", { status: 400 });
+		const sessionId = this.parseSessionId(sessionIdRaw);
+		const trace = traceMetadataFromRequest(request);
+		const prepared = await this.#controller.prepareEventWebSocket({
+			...afterSeq === void 0 ? {} : { afterSeq: SequenceNumber.make(afterSeq) },
+			sessionId,
+			trace,
+			...projectionId === void 0 ? {} : { projectionId }
+		});
 		const pair = new WebSocketPair();
 		const client = pair[0];
 		const server = pair[1];
 		this.ctx.acceptWebSocket(server);
-		await this.#controller.acceptEventWebSocket({
-			afterSeq: SequenceNumber.make(afterSeq),
-			sessionId: this.parseSessionId(sessionIdRaw),
-			trace: traceMetadataFromRequest(request),
+		await this.#controller.acceptPreparedEventWebSocket({
+			...prepared,
 			webSocket: server
 		});
 		return new Response(null, {
@@ -175,6 +188,6 @@ const encodeCommandCarrierForRpc = (value) => value.command === void 0 ? value :
 const decodeCommand = (input) => Effect.runPromise(decodeEdaRpcCommand(input));
 const decodeSubmittables = (input) => Effect.runPromise(decodeEdaRpcSubmittables(input));
 //#endregion
-export { EDASessionDurableObject, edaRuntimeConfig, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcSessionSnapshot, getEDASessionDurableObjectByName };
+export { EDASessionDurableObject, EDA_WEB_SOCKET_PROJECTION_HEADER, edaRuntimeConfig, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcSessionSnapshot, getEDASessionDurableObjectByName };
 
 //# sourceMappingURL=durable-object.js.map

package/dist/durable-object.js.map

@@ -1 +1 @@
-{"version":3,"file":"durable-object.js","names":["#controller"],"sources":["../src/durable-object.ts"],"sourcesContent":["import { DurableObject } from \"cloudflare:workers\";\nimport * as Effect from \"effect/Effect\";\nimport * as Schema from \"effect/Schema\";\n\nimport type { DurableTranscriptMessage } from \"effect-durable-agent/domain/message-transcript\";\nimport {\n  decodeEdaRpcCommand,\n  decodeEdaRpcSubmittables,\n  encodeEdaRpcDurableEvent,\n} from \"./rpc-codec\";\nimport type { EDASessionSnapshot } from \"effect-durable-agent/services/session-query\";\nimport type { CommittedDurableEvent as CommittedDurableEventValue } from \"effect-durable-agent/services/session-store\";\nimport type {\n  CommittedCommandTerminalEvent,\n  EDARuntimeConfig,\n} from \"effect-durable-agent/services/runtime\";\nimport {\n  EDACommand,\n  type EDACommand as EDACommandValue,\n} from \"effect-durable-agent/types/commands\";\nimport type { EDASubmittable } from \"effect-durable-agent/services/session-state\";\nimport { CommandId, SequenceNumber, SessionId } from \"effect-durable-agent/types/core\";\nimport {\n  EDATraceMetadata,\n  makeEDATraceMetadataFromParent,\n  makeRootEDATraceMetadata,\n  parseEDATraceparent,\n} from \"effect-durable-agent/types/tracing\";\nimport {\n  EDASessionController,\n  type EDASessionControllerOptions,\n  type EDASessionDurableObjectStorage,\n} from \"./session-controller\";\nimport {\n  EDA_WEB_SOCKET_PING_MESSAGE,\n  EDA_WEB_SOCKET_PONG_MESSAGE,\n} from \"effect-durable-agent/websocket\";\n\n/** Raw RPC shape decoded before admitting one session command. */\nexport interface EDASessionCommandRpcInput {\n  readonly command: unknown;\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Raw RPC shape decoded before admitting a durable command/app-event batch. */\nexport interface EDASessionSubmitBatchRpcInput {\n  readonly items: ReadonlyArray<unknown>;\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Raw RPC shape for read/destroy operations that only need a session id. */\nexport interface EDASessionScopedRpcInput {\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Raw RPC shape for WebSocket event-stream upgrades with a resume cursor. */\nexport interface EDASessionEventsRpcInput {\n  readonly afterSeq?: number;\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Raw RPC shape decoded before blocking on one command terminal event. */\nexport interface EDASessionBlockOnCommandRpcInput {\n  readonly afterSeq?: number;\n  readonly commandId: string;\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Constructor options for concrete app subclasses of the EDA Durable Object base. */\nexport type EDASessionDurableObjectOptions = Omit<\n  EDASessionControllerOptions,\n  \"background\" | \"getWebSockets\" | \"storage\"\n>;\n\n/** Resolve a concrete EDA session Durable Object binding by domain session id. */\nexport const getEDASessionDurableObjectByName = <T extends EDASessionDurableObject<object>>(\n  namespace: DurableObjectNamespace<T>,\n  sessionId: string,\n): DurableObjectStub<T> => namespace.getByName(sessionId);\n\n/**\n * Base class for raw Cloudflare Durable Object hosts of one EDA session.\n *\n * Concrete products should extend this class, pass provider/tool layers from\n * their own constructor, and register only that subclass in Wrangler. The base\n * class is deliberately not exported from `workers/app.ts` and owns no binding\n * name or routing convention.\n */\nexport abstract class EDASessionDurableObject<\n  EnvType extends object = object,\n> extends DurableObject<EnvType> {\n  readonly #controller: EDASessionController;\n\n  protected constructor(\n    ctx: DurableObjectState,\n    env: EnvType,\n    options: EDASessionDurableObjectOptions,\n  ) {\n    super(ctx, env);\n    const storage = toEDASessionStorage(this.ctx.storage);\n    this.#controller = new EDASessionController({\n      ...options,\n      background: this.ctx,\n      getWebSockets: () => this.ctx.getWebSockets(),\n      storage,\n    });\n\n    // Answer client liveness pings at the runtime layer so idle sockets never\n    // wake a hibernated object.\n    this.ctx.setWebSocketAutoResponse(\n      new WebSocketRequestResponsePair(EDA_WEB_SOCKET_PING_MESSAGE, EDA_WEB_SOCKET_PONG_MESSAGE),\n    );\n\n    this.ctx.blockConcurrencyWhile(async () => {\n      await Effect.runPromise(EDASessionController.migrate(storage));\n    });\n  }\n\n  async fetch(request: Request): Promise<Response> {\n    const upgrade = request.headers.get(\"Upgrade\");\n    if (upgrade?.toLowerCase() !== \"websocket\") {\n      return new Response(\"Expected WebSocket upgrade.\", { status: 426 });\n    }\n\n    const url = new URL(request.url);\n    const sessionIdRaw = url.searchParams.get(\"sessionId\");\n    if (sessionIdRaw === null) {\n      return new Response(\"Missing sessionId.\", { status: 400 });\n    }\n    const afterSeq = Number(url.searchParams.get(\"afterSeq\") ?? \"0\");\n    if (!Number.isInteger(afterSeq) || afterSeq < 0) {\n      return new Response(\"Invalid afterSeq.\", { status: 400 });\n    }\n\n    const pair = new WebSocketPair();\n    const client = pair[0];\n    const server = pair[1];\n    this.ctx.acceptWebSocket(server);\n    await this.#controller.acceptEventWebSocket({\n      afterSeq: SequenceNumber.make(afterSeq),\n      sessionId: this.parseSessionId(sessionIdRaw),\n      trace: traceMetadataFromRequest(request),\n      webSocket: server,\n    });\n    return new Response(null, { status: 101, webSocket: client });\n  }\n\n  async submit(input: EDASessionCommandRpcInput): Promise<CommittedDurableEventValue> {\n    const committed = await this.#controller.submit({\n      command: await decodeCommand(input.command),\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return encodeEdaRpcCommittedDurableEvent(committed);\n  }\n\n  async submitBatch(\n    input: EDASessionSubmitBatchRpcInput,\n  ): Promise<ReadonlyArray<CommittedDurableEventValue>> {\n    const committed = await this.#controller.submitBatch({\n      items: await decodeSubmittables(input.items),\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return committed.map(encodeEdaRpcCommittedDurableEvent);\n  }\n\n  async submitAndBlock(input: EDASessionCommandRpcInput): Promise<CommittedCommandTerminalEvent> {\n    const committed = await this.#controller.submitAndBlock({\n      command: await decodeCommand(input.command),\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return encodeEdaRpcCommittedDurableEvent(committed) as CommittedCommandTerminalEvent;\n  }\n\n  async blockOnCommand(\n    input: EDASessionBlockOnCommandRpcInput,\n  ): Promise<CommittedCommandTerminalEvent> {\n    const committed = await this.#controller.blockOnCommand({\n      ...(input.afterSeq === undefined ? {} : { afterSeq: SequenceNumber.make(input.afterSeq) }),\n      commandId: CommandId.make(input.commandId),\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return encodeEdaRpcCommittedDurableEvent(committed) as CommittedCommandTerminalEvent;\n  }\n\n  async snapshot(input: EDASessionScopedRpcInput): Promise<EDASessionSnapshot> {\n    const snapshot = await this.#controller.snapshot({\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return encodeEdaRpcSessionSnapshot(snapshot);\n  }\n\n  async messages(\n    input: EDASessionScopedRpcInput,\n  ): Promise<ReadonlyArray<DurableTranscriptMessage>> {\n    return await this.#controller.messages({\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n  }\n\n  async webSocketMessage(webSocket: WebSocket, message: string | ArrayBuffer): Promise<void> {\n    await this.#controller.webSocketMessage(webSocket, message);\n  }\n\n  async webSocketClose(\n    webSocket: WebSocket,\n    _code: number,\n    _reason: string,\n    _wasClean: boolean,\n  ): Promise<void> {\n    this.#controller.webSocketClose(webSocket);\n  }\n\n  async webSocketError(webSocket: WebSocket, _error: unknown): Promise<void> {\n    this.#controller.webSocketError(webSocket);\n  }\n\n  async destroySession(input: EDASessionScopedRpcInput): Promise<void> {\n    await this.#controller.destroy({\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    await this.ctx.storage.deleteAlarm();\n    await this.ctx.storage.deleteAll();\n  }\n\n  async alarm(): Promise<void> {\n    const sessionId = this.sessionIdFromObjectName();\n    await this.#controller.alarm(\n      sessionId === undefined ? undefined : { sessionId, trace: makeRootEDATraceMetadata() },\n    );\n  }\n\n  private parseSessionId(input: string): SessionId {\n    const sessionId = SessionId.make(input);\n    const objectName = this.ctx.id.name;\n    if (objectName !== undefined && objectName !== sessionId) {\n      throw new Error(`EDA Durable Object name ${objectName} cannot serve session ${sessionId}`);\n    }\n    return sessionId;\n  }\n\n  private sessionIdFromObjectName(): SessionId | undefined {\n    return this.ctx.id.name === undefined ? undefined : SessionId.make(this.ctx.id.name);\n  }\n}\n\nconst toEDASessionStorage = (storage: DurableObjectStorage): EDASessionDurableObjectStorage => {\n  // SAFETY: the adapter interface is the exact SQL, transaction, and alarm subset\n  // of DurableObjectStorage; its looser row generic also supports test implementations.\n  return storage as EDASessionDurableObjectStorage;\n};\n\nconst decodeTraceMetadata = (input: unknown): EDATraceMetadata =>\n  Schema.decodeUnknownSync(EDATraceMetadata)(input);\n\nconst traceMetadataFromRequest = (request: Request): EDATraceMetadata => {\n  const parent = parseEDATraceparent(\n    request.headers.get(\"traceparent\"),\n    request.headers.get(\"tracestate\"),\n  );\n  return parent === null ? makeRootEDATraceMetadata() : makeEDATraceMetadataFromParent(parent);\n};\n\n/** Convenience config constructor for subclasses that need only provider/model ids. */\nexport const edaRuntimeConfig = (input: {\n  readonly maxToolCallsPerRun?: number;\n  readonly modelId: string;\n  readonly provider: string;\n  readonly systemPrompt?: string;\n}): EDARuntimeConfig => ({\n  modelSelection: { modelId: input.modelId, provider: input.provider },\n  ...(input.maxToolCallsPerRun === undefined\n    ? {}\n    : { maxToolCallsPerRun: input.maxToolCallsPerRun }),\n  ...(input.systemPrompt === undefined ? {} : { systemPrompt: input.systemPrompt }),\n});\n\n/** Encode committed events into structured-clone-safe Durable Object RPC payloads. */\nexport const encodeEdaRpcCommittedDurableEvent = (\n  event: CommittedDurableEventValue,\n): CommittedDurableEventValue => ({\n  position: event.position,\n  event: encodeEdaRpcDurableEvent(event.event),\n});\n\n/** Encode runtime snapshots into structured-clone-safe Durable Object RPC payloads. */\nexport const encodeEdaRpcSessionSnapshot = (snapshot: EDASessionSnapshot): EDASessionSnapshot => ({\n  ...snapshot,\n  reducerStates: new Map(snapshot.reducerStates),\n  state: {\n    ...snapshot.state,\n    commands: new Map(\n      Array.from(snapshot.state.commands, ([commandId, record]) => [\n        commandId,\n        encodeCommandCarrierForRpc(record),\n      ]),\n    ),\n    commandQueues: {\n      ...snapshot.state.commandQueues,\n      activeControlCommands: snapshot.state.commandQueues.activeControlCommands.map(\n        encodeCommandCarrierForRpc,\n      ),\n      pendingCommands: snapshot.state.commandQueues.pendingCommands.map(encodeCommandCarrierForRpc),\n      queuedCommands: snapshot.state.commandQueues.queuedCommands.map(encodeCommandCarrierForRpc),\n    },\n  },\n});\n\nconst encodeCommandCarrierForRpc = <A extends { readonly command?: EDACommandValue }>(\n  value: A,\n): A =>\n  value.command === undefined\n    ? value\n    : {\n        ...value,\n        command: Schema.encodeSync(EDACommand)(value.command) as EDACommandValue,\n      };\n\nconst decodeCommand = (input: unknown): Promise<EDACommandValue> =>\n  Effect.runPromise(decodeEdaRpcCommand(input));\n\nconst decodeSubmittables = (\n  input: ReadonlyArray<unknown>,\n): Promise<ReadonlyArray<EDASubmittable>> => Effect.runPromise(decodeEdaRpcSubmittables(input));\n"],"mappings":"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"}
+{"version":3,"file":"durable-object.js","names":["#controller","#webSocketProjectionId"],"sources":["../src/durable-object.ts"],"sourcesContent":["import { DurableObject } from \"cloudflare:workers\";\nimport * as Effect from \"effect/Effect\";\nimport * as Schema from \"effect/Schema\";\n\nimport type { DurableTranscriptMessage } from \"effect-durable-agent/domain/message-transcript\";\nimport {\n  decodeEdaRpcCommand,\n  decodeEdaRpcSubmittables,\n  encodeEdaRpcDurableEvent,\n} from \"./rpc-codec\";\nimport type { EDASessionSnapshot } from \"effect-durable-agent/services/session-query\";\nimport type { CommittedDurableEvent as CommittedDurableEventValue } from \"effect-durable-agent/services/session-store\";\nimport type {\n  CommittedCommandTerminalEvent,\n  EDARuntimeConfig,\n} from \"effect-durable-agent/services/runtime\";\nimport {\n  EDACommand,\n  type EDACommand as EDACommandValue,\n} from \"effect-durable-agent/types/commands\";\nimport type { EDASubmittable } from \"effect-durable-agent/services/session-state\";\nimport { CommandId, SequenceNumber, SessionId } from \"effect-durable-agent/types/core\";\nimport {\n  EDATraceMetadata,\n  makeEDATraceMetadataFromParent,\n  makeRootEDATraceMetadata,\n  parseEDATraceparent,\n} from \"effect-durable-agent/types/tracing\";\nimport {\n  EDASessionController,\n  type EDASessionControllerOptions,\n  type EDASessionDurableObjectStorage,\n} from \"./session-controller\";\nimport {\n  EDA_WEB_SOCKET_PING_MESSAGE,\n  EDA_WEB_SOCKET_PONG_MESSAGE,\n} from \"effect-durable-agent/websocket\";\nexport type { EDAWebSocketProjection } from \"./websocket/projection\";\n/** Internal Worker-to-object header selecting an app-owned WebSocket projection. */\nexport const EDA_WEB_SOCKET_PROJECTION_HEADER = \"x-eda-websocket-projection\";\n\n/** Raw RPC shape decoded before admitting one session command. */\nexport interface EDASessionCommandRpcInput {\n  readonly command: unknown;\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Raw RPC shape decoded before admitting a durable command/app-event batch. */\nexport interface EDASessionSubmitBatchRpcInput {\n  readonly items: ReadonlyArray<unknown>;\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Raw RPC shape for read/destroy operations that only need a session id. */\nexport interface EDASessionScopedRpcInput {\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Raw RPC shape for WebSocket event-stream upgrades with a resume cursor. */\nexport interface EDASessionEventsRpcInput {\n  readonly afterSeq?: number;\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** Raw RPC shape decoded before blocking on one command terminal event. */\nexport interface EDASessionBlockOnCommandRpcInput {\n  readonly afterSeq?: number;\n  readonly commandId: string;\n  readonly sessionId: string;\n  readonly trace: unknown;\n}\n\n/** EDA RPC methods required by the session namespace helper. */\nexport interface EDASessionRpcSurface {\n  readonly submit: (input: EDASessionCommandRpcInput) => Promise<CommittedDurableEventValue>;\n  readonly submitBatch: (\n    input: EDASessionSubmitBatchRpcInput,\n  ) => Promise<ReadonlyArray<CommittedDurableEventValue>>;\n  readonly submitAndBlock: (\n    input: EDASessionCommandRpcInput,\n  ) => Promise<CommittedCommandTerminalEvent>;\n  readonly blockOnCommand: (\n    input: EDASessionBlockOnCommandRpcInput,\n  ) => Promise<CommittedCommandTerminalEvent>;\n  readonly snapshot: (input: EDASessionScopedRpcInput) => Promise<EDASessionSnapshot>;\n  readonly messages: (\n    input: EDASessionScopedRpcInput,\n  ) => Promise<ReadonlyArray<DurableTranscriptMessage>>;\n  readonly destroySession: (input: EDASessionScopedRpcInput) => Promise<void>;\n}\n\n/** Constructor options for concrete app subclasses of the EDA Durable Object base. */\nexport type EDASessionDurableObjectOptions<ProjectionState extends object = never> = Omit<\n  EDASessionControllerOptions<ProjectionState>,\n  \"background\" | \"getWebSockets\" | \"storage\"\n>;\n\n/** Resolve a concrete EDA session Durable Object binding by domain session id. */\nexport const getEDASessionDurableObjectByName = <\n  T extends Rpc.DurableObjectBranded & EDASessionRpcSurface,\n>(\n  namespace: DurableObjectNamespace<T>,\n  sessionId: string,\n): DurableObjectStub<T> => namespace.getByName(sessionId);\n\n/**\n * Base class for raw Cloudflare Durable Object hosts of one EDA session.\n *\n * Concrete products should extend this class, pass provider/tool layers from\n * their own constructor, and register only that subclass in Wrangler. The base\n * class is deliberately not exported from `workers/app.ts` and owns no binding\n * name or routing convention.\n */\nexport abstract class EDASessionDurableObject<\n  EnvType extends object = object,\n  ProjectionState extends object = never,\n> extends DurableObject<EnvType> {\n  readonly #controller: EDASessionController<ProjectionState>;\n  readonly #webSocketProjectionId: string | undefined;\n\n  protected constructor(\n    ctx: DurableObjectState,\n    env: EnvType,\n    options: EDASessionDurableObjectOptions<ProjectionState>,\n  ) {\n    super(ctx, env);\n    this.#webSocketProjectionId = options.webSocketProjection?.id;\n    const storage = toEDASessionStorage(this.ctx.storage);\n    this.#controller = new EDASessionController({\n      ...options,\n      background: this.ctx,\n      getWebSockets: () => this.ctx.getWebSockets(),\n      storage,\n    });\n\n    // Answer client liveness pings at the runtime layer so idle sockets never\n    // wake a hibernated object.\n    this.ctx.setWebSocketAutoResponse(\n      new WebSocketRequestResponsePair(EDA_WEB_SOCKET_PING_MESSAGE, EDA_WEB_SOCKET_PONG_MESSAGE),\n    );\n\n    this.ctx.blockConcurrencyWhile(async () => {\n      await Effect.runPromise(EDASessionController.migrate(storage));\n    });\n  }\n\n  async fetch(request: Request): Promise<Response> {\n    const upgrade = request.headers.get(\"Upgrade\");\n    if (upgrade?.toLowerCase() !== \"websocket\") {\n      return new Response(\"Expected WebSocket upgrade.\", { status: 426 });\n    }\n\n    const url = new URL(request.url);\n    const sessionIdRaw = url.searchParams.get(\"sessionId\");\n    if (sessionIdRaw === null) {\n      return new Response(\"Missing sessionId.\", { status: 400 });\n    }\n    const afterSeqRaw = url.searchParams.get(\"afterSeq\");\n    const afterSeq = afterSeqRaw === null ? undefined : Number(afterSeqRaw);\n    if (afterSeq !== undefined && (!Number.isInteger(afterSeq) || afterSeq < 0)) {\n      return new Response(\"Invalid afterSeq.\", { status: 400 });\n    }\n    const projectionId = request.headers.get(EDA_WEB_SOCKET_PROJECTION_HEADER) ?? undefined;\n    if (projectionId !== undefined && projectionId !== this.#webSocketProjectionId) {\n      return new Response(\"Unsupported WebSocket projection.\", { status: 400 });\n    }\n\n    const sessionId = this.parseSessionId(sessionIdRaw);\n    const trace = traceMetadataFromRequest(request);\n    const prepared = await this.#controller.prepareEventWebSocket({\n      ...(afterSeq === undefined ? {} : { afterSeq: SequenceNumber.make(afterSeq) }),\n      sessionId,\n      trace,\n      ...(projectionId === undefined ? {} : { projectionId }),\n    });\n\n    const pair = new WebSocketPair();\n    const client = pair[0];\n    const server = pair[1];\n    this.ctx.acceptWebSocket(server);\n    await this.#controller.acceptPreparedEventWebSocket({\n      ...prepared,\n      webSocket: server,\n    });\n    return new Response(null, { status: 101, webSocket: client });\n  }\n\n  async submit(input: EDASessionCommandRpcInput): Promise<CommittedDurableEventValue> {\n    const committed = await this.#controller.submit({\n      command: await decodeCommand(input.command),\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return encodeEdaRpcCommittedDurableEvent(committed);\n  }\n\n  async submitBatch(\n    input: EDASessionSubmitBatchRpcInput,\n  ): Promise<ReadonlyArray<CommittedDurableEventValue>> {\n    const committed = await this.#controller.submitBatch({\n      items: await decodeSubmittables(input.items),\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return committed.map(encodeEdaRpcCommittedDurableEvent);\n  }\n\n  async submitAndBlock(input: EDASessionCommandRpcInput): Promise<CommittedCommandTerminalEvent> {\n    const committed = await this.#controller.submitAndBlock({\n      command: await decodeCommand(input.command),\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return encodeEdaRpcCommittedDurableEvent(committed) as CommittedCommandTerminalEvent;\n  }\n\n  async blockOnCommand(\n    input: EDASessionBlockOnCommandRpcInput,\n  ): Promise<CommittedCommandTerminalEvent> {\n    const committed = await this.#controller.blockOnCommand({\n      ...(input.afterSeq === undefined ? {} : { afterSeq: SequenceNumber.make(input.afterSeq) }),\n      commandId: CommandId.make(input.commandId),\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return encodeEdaRpcCommittedDurableEvent(committed) as CommittedCommandTerminalEvent;\n  }\n\n  async snapshot(input: EDASessionScopedRpcInput): Promise<EDASessionSnapshot> {\n    const snapshot = await this.#controller.snapshot({\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    return encodeEdaRpcSessionSnapshot(snapshot);\n  }\n\n  async messages(\n    input: EDASessionScopedRpcInput,\n  ): Promise<ReadonlyArray<DurableTranscriptMessage>> {\n    return await this.#controller.messages({\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n  }\n\n  async webSocketMessage(webSocket: WebSocket, message: string | ArrayBuffer): Promise<void> {\n    await this.#controller.webSocketMessage(webSocket, message);\n  }\n\n  async webSocketClose(\n    webSocket: WebSocket,\n    _code: number,\n    _reason: string,\n    _wasClean: boolean,\n  ): Promise<void> {\n    this.#controller.webSocketClose(webSocket);\n  }\n\n  async webSocketError(webSocket: WebSocket, _error: unknown): Promise<void> {\n    this.#controller.webSocketError(webSocket);\n  }\n\n  async destroySession(input: EDASessionScopedRpcInput): Promise<void> {\n    await this.#controller.destroy({\n      sessionId: this.parseSessionId(input.sessionId),\n      trace: decodeTraceMetadata(input.trace),\n    });\n    await this.ctx.storage.deleteAlarm();\n    await this.ctx.storage.deleteAll();\n  }\n\n  async alarm(): Promise<void> {\n    const sessionId = this.sessionIdFromObjectName();\n    await this.#controller.alarm(\n      sessionId === undefined ? undefined : { sessionId, trace: makeRootEDATraceMetadata() },\n    );\n  }\n\n  private parseSessionId(input: string): SessionId {\n    const sessionId = SessionId.make(input);\n    const objectName = this.ctx.id.name;\n    if (objectName !== undefined && objectName !== sessionId) {\n      throw new Error(`EDA Durable Object name ${objectName} cannot serve session ${sessionId}`);\n    }\n    return sessionId;\n  }\n\n  private sessionIdFromObjectName(): SessionId | undefined {\n    return this.ctx.id.name === undefined ? undefined : SessionId.make(this.ctx.id.name);\n  }\n}\n\nconst toEDASessionStorage = (storage: DurableObjectStorage): EDASessionDurableObjectStorage => {\n  // SAFETY: the adapter interface is the exact SQL, transaction, and alarm subset\n  // of DurableObjectStorage; its looser row generic also supports test implementations.\n  return storage as EDASessionDurableObjectStorage;\n};\n\nconst decodeTraceMetadata = (input: unknown): EDATraceMetadata =>\n  Schema.decodeUnknownSync(EDATraceMetadata)(input);\n\nconst traceMetadataFromRequest = (request: Request): EDATraceMetadata => {\n  const parent = parseEDATraceparent(\n    request.headers.get(\"traceparent\"),\n    request.headers.get(\"tracestate\"),\n  );\n  return parent === null ? makeRootEDATraceMetadata() : makeEDATraceMetadataFromParent(parent);\n};\n\n/** Convenience config constructor for subclasses that need only provider/model ids. */\nexport const edaRuntimeConfig = (input: {\n  readonly maxToolCallsPerRun?: number;\n  readonly modelId: string;\n  readonly provider: string;\n  readonly systemPrompt?: string;\n}): EDARuntimeConfig => ({\n  modelSelection: { modelId: input.modelId, provider: input.provider },\n  ...(input.maxToolCallsPerRun === undefined\n    ? {}\n    : { maxToolCallsPerRun: input.maxToolCallsPerRun }),\n  ...(input.systemPrompt === undefined ? {} : { systemPrompt: input.systemPrompt }),\n});\n\n/** Encode committed events into structured-clone-safe Durable Object RPC payloads. */\nexport const encodeEdaRpcCommittedDurableEvent = (\n  event: CommittedDurableEventValue,\n): CommittedDurableEventValue => ({\n  position: event.position,\n  event: encodeEdaRpcDurableEvent(event.event),\n});\n\n/** Encode runtime snapshots into structured-clone-safe Durable Object RPC payloads. */\nexport const encodeEdaRpcSessionSnapshot = (snapshot: EDASessionSnapshot): EDASessionSnapshot => ({\n  ...snapshot,\n  reducerStates: new Map(snapshot.reducerStates),\n  state: {\n    ...snapshot.state,\n    commands: new Map(\n      Array.from(snapshot.state.commands, ([commandId, record]) => [\n        commandId,\n        encodeCommandCarrierForRpc(record),\n      ]),\n    ),\n    commandQueues: {\n      ...snapshot.state.commandQueues,\n      activeControlCommands: snapshot.state.commandQueues.activeControlCommands.map(\n        encodeCommandCarrierForRpc,\n      ),\n      pendingCommands: snapshot.state.commandQueues.pendingCommands.map(encodeCommandCarrierForRpc),\n      queuedCommands: snapshot.state.commandQueues.queuedCommands.map(encodeCommandCarrierForRpc),\n    },\n  },\n});\n\nconst encodeCommandCarrierForRpc = <A extends { readonly command?: EDACommandValue }>(\n  value: A,\n): A =>\n  value.command === undefined\n    ? value\n    : {\n        ...value,\n        command: Schema.encodeSync(EDACommand)(value.command) as EDACommandValue,\n      };\n\nconst decodeCommand = (input: unknown): Promise<EDACommandValue> =>\n  Effect.runPromise(decodeEdaRpcCommand(input));\n\nconst decodeSubmittables = (\n  input: ReadonlyArray<unknown>,\n): Promise<ReadonlyArray<EDASubmittable>> => Effect.runPromise(decodeEdaRpcSubmittables(input));\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { i as DurableObjectSqlStorage, n as DurableObjectSessionStoreOptions, r as DurableObjectSqlCursor, t as DurableObjectSessionStorage } from "./durable-object-storage-DCL2IyUe.js";
-import { a as EDASessionScopedInput, c as EDADurableObjectRuntimeLayerOptions, i as EDASessionEventsInput, l as EDASessionDurableObjectStorage, n as EDASessionController, o as EDASessionSubmitBatchInput, r as EDASessionControllerOptions, s as EDASessionSubmitInput, t as EDASessionBlockOnCommandInput, u as makeEDADurableObjectRuntimeLayer } from "./session-controller-BSMHhS_l.js";
-import { EDASessionBlockOnCommandRpcInput, EDASessionCommandRpcInput, EDASessionDurableObject, EDASessionDurableObjectOptions, EDASessionEventsRpcInput, EDASessionScopedRpcInput, EDASessionSubmitBatchRpcInput, edaRuntimeConfig, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcSessionSnapshot, getEDASessionDurableObjectByName } from "./durable-object.js";
+import { a as EDASessionEventsInput, c as EDASessionSubmitInput, d as EDAWebSocketProjectionInitial, f as EDAWebSocketProjectionResult, h as makeEDADurableObjectRuntimeLayer, i as EDASessionControllerOptions, l as EDAWebSocketProjection, m as EDASessionDurableObjectStorage, n as EDASessionBlockOnCommandInput, o as EDASessionScopedInput, p as EDADurableObjectRuntimeLayerOptions, r as EDASessionController, s as EDASessionSubmitBatchInput, t as EDAPreparedEventWebSocket, u as EDAWebSocketProjectionId } from "./session-controller-BCsOxE22.js";
+import { EDASessionBlockOnCommandRpcInput, EDASessionCommandRpcInput, EDASessionDurableObject, EDASessionDurableObjectOptions, EDASessionEventsRpcInput, EDASessionRpcSurface, EDASessionScopedRpcInput, EDASessionSubmitBatchRpcInput, EDA_WEB_SOCKET_PROJECTION_HEADER, edaRuntimeConfig, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcSessionSnapshot, getEDASessionDurableObjectByName } from "./durable-object.js";
 import { EDAOpenAiModelConfig, makeEDADurableObjectOpenAiModelLayer } from "./openai.js";
 import { decodeEdaRpcCommand, decodeEdaRpcSubmittables, encodeEdaRpcCommand, encodeEdaRpcDurableEvent, encodeEdaRpcSubmittables } from "./rpc.js";
-export { DurableObjectSessionStorage, DurableObjectSessionStoreOptions, DurableObjectSqlCursor, DurableObjectSqlStorage, EDADurableObjectRuntimeLayerOptions, EDAOpenAiModelConfig, EDASessionBlockOnCommandInput, EDASessionBlockOnCommandRpcInput, EDASessionCommandRpcInput, EDASessionController, EDASessionControllerOptions, EDASessionDurableObject, EDASessionDurableObjectOptions, EDASessionDurableObjectStorage, EDASessionEventsInput, EDASessionEventsRpcInput, EDASessionScopedInput, EDASessionScopedRpcInput, EDASessionSubmitBatchInput, EDASessionSubmitBatchRpcInput, EDASessionSubmitInput, decodeEdaRpcCommand, decodeEdaRpcSubmittables, edaRuntimeConfig, encodeEdaRpcCommand, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcDurableEvent, encodeEdaRpcSessionSnapshot, encodeEdaRpcSubmittables, getEDASessionDurableObjectByName, makeEDADurableObjectOpenAiModelLayer, makeEDADurableObjectRuntimeLayer };
+export { DurableObjectSessionStorage, DurableObjectSessionStoreOptions, DurableObjectSqlCursor, DurableObjectSqlStorage, EDADurableObjectRuntimeLayerOptions, EDAOpenAiModelConfig, EDAPreparedEventWebSocket, EDASessionBlockOnCommandInput, EDASessionBlockOnCommandRpcInput, EDASessionCommandRpcInput, EDASessionController, EDASessionControllerOptions, EDASessionDurableObject, EDASessionDurableObjectOptions, EDASessionDurableObjectStorage, EDASessionEventsInput, EDASessionEventsRpcInput, EDASessionRpcSurface, EDASessionScopedInput, EDASessionScopedRpcInput, EDASessionSubmitBatchInput, EDASessionSubmitBatchRpcInput, EDASessionSubmitInput, EDAWebSocketProjection, EDAWebSocketProjectionId, EDAWebSocketProjectionInitial, EDAWebSocketProjectionResult, EDA_WEB_SOCKET_PROJECTION_HEADER, decodeEdaRpcCommand, decodeEdaRpcSubmittables, edaRuntimeConfig, encodeEdaRpcCommand, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcDurableEvent, encodeEdaRpcSessionSnapshot, encodeEdaRpcSubmittables, getEDASessionDurableObjectByName, makeEDADurableObjectOpenAiModelLayer, makeEDADurableObjectRuntimeLayer };

package/dist/index.js

@@ -1,6 +1,6 @@
 import { decodeEdaRpcCommand, decodeEdaRpcSubmittables, encodeEdaRpcCommand, encodeEdaRpcDurableEvent, encodeEdaRpcSubmittables } from "./rpc.js";
-import { n as makeEDADurableObjectRuntimeLayer, t as EDASessionController } from "./session-controller-Bo7DyydT.js";
-import { EDASessionDurableObject, edaRuntimeConfig, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcSessionSnapshot, getEDASessionDurableObjectByName } from "./durable-object.js";
+import { n as EDAWebSocketProjectionId, r as makeEDADurableObjectRuntimeLayer, t as EDASessionController } from "./session-controller-CMbW7vgf.js";
+import { EDASessionDurableObject, EDA_WEB_SOCKET_PROJECTION_HEADER, edaRuntimeConfig, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcSessionSnapshot, getEDASessionDurableObjectByName } from "./durable-object.js";
 import "./storage.js";
 import { makeEDADurableObjectOpenAiModelLayer } from "./openai.js";
-export { EDASessionController, EDASessionDurableObject, decodeEdaRpcCommand, decodeEdaRpcSubmittables, edaRuntimeConfig, encodeEdaRpcCommand, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcDurableEvent, encodeEdaRpcSessionSnapshot, encodeEdaRpcSubmittables, getEDASessionDurableObjectByName, makeEDADurableObjectOpenAiModelLayer, makeEDADurableObjectRuntimeLayer };
+export { EDASessionController, EDASessionDurableObject, EDAWebSocketProjectionId, EDA_WEB_SOCKET_PROJECTION_HEADER, decodeEdaRpcCommand, decodeEdaRpcSubmittables, edaRuntimeConfig, encodeEdaRpcCommand, encodeEdaRpcCommittedDurableEvent, encodeEdaRpcDurableEvent, encodeEdaRpcSessionSnapshot, encodeEdaRpcSubmittables, getEDASessionDurableObjectByName, makeEDADurableObjectOpenAiModelLayer, makeEDADurableObjectRuntimeLayer };

package/dist/{session-controller-BSMHhS_l.d.ts → session-controller-BCsOxE22.d.ts}

@@ -1,5 +1,6 @@
 import { t as DurableObjectSessionStorage } from "./durable-object-storage-DCL2IyUe.js";
 import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
 import { EDACommand } from "effect-durable-agent/types/commands";
 import { CommandId, SequenceNumber, SessionId } from "effect-durable-agent/types/core";
 import { EDATraceMetadata } from "effect-durable-agent/types/tracing";
@@ -10,7 +11,7 @@ import { CompactionExecutor, CompactionPolicy } from "effect-durable-agent/servi
 import { EDAPromptProjector } from "effect-durable-agent/services/prompt-projector";
 import { EDAReducer } from "effect-durable-agent/services/reducer-registry";
 import { SessionEventObserver } from "effect-durable-agent/services/session-event-observer";
-import { EDAWebSocketServerFrameEncoder } from "effect-durable-agent/websocket";
+import { EDAWebSocketClientFrame, EDAWebSocketServerFrameEncoder, EDAWebSocketServerFrameInput } from "effect-durable-agent/websocket";
 import { DurableTranscriptMessage } from "effect-durable-agent/domain/message-transcript";
 import { EDASessionSnapshot } from "effect-durable-agent/services/session-query";
 import { EDASubmittable, SessionCommandAdmissionError } from "effect-durable-agent/services/session-state";
@@ -165,10 +166,54 @@ interface EDASessionRuntimeOptions {
   readonly tracer?: Tracer.Tracer | EDATracerFactory;
 }
 //#endregion
+//#region src/websocket/projection.d.ts
+/** Stable non-empty identity persisted with an app WebSocket projection. */
+declare const EDAWebSocketProjectionId: Schema.brand<Schema.NonEmptyString, "EDAWebSocketProjectionId">;
+type EDAWebSocketProjectionId = typeof EDAWebSocketProjectionId.Type;
+/** Initial state and cursor selected when an app-projected WebSocket is accepted. */
+interface EDAWebSocketProjectionInitial<State extends object> {
+  readonly afterSeq: SequenceNumber;
+  readonly state: State;
+}
+/** App projection decision for one EDA delivery frame. */
+type EDAWebSocketProjectionResult<State extends object> = {
+  readonly _tag: "Send";
+  readonly frame: string;
+  readonly state: State;
+} | {
+  /** Suppress an internal-only events frame and advance its ACK in the host. */readonly _tag: "SuppressAndAck";
+  readonly state: State;
+};
+/**
+ * App-owned wire projection hosted directly by the EDA Durable Object.
+ *
+ * The host persists `State` beside EDA delivery state, so an app can retain a
+ * stable public protocol without placing a resident WebSocket bridge in front
+ * of the hibernating object.
+ */
+interface EDAWebSocketProjection<State extends object> {
+  /** Stable identifier persisted in WebSocket attachments. */
+  readonly id: EDAWebSocketProjectionId;
+  /** Decode one app-protocol client message into EDA's delivery ACK protocol. */
+  readonly decodeClientMessage: (message: string) => Effect.Effect<EDAWebSocketClientFrame, unknown>;
+  /** Restore app-owned connection state after isolate eviction. */
+  readonly decodeState: (encoded: unknown) => Effect.Effect<State, unknown>;
+  /** Encode app-owned connection state for Cloudflare's attachment boundary. */
+  readonly encodeState: (state: State) => unknown;
+  /** Project one EDA server frame while updating app-owned connection state. */
+  readonly encodeServerFrame: (frame: EDAWebSocketServerFrameInput, state: State) => EDAWebSocketProjectionResult<State>;
+  /** Seed the projection and select its default replay cursor from a durable snapshot. */
+  readonly initialize: (input: {
+    readonly requestedAfterSeq?: SequenceNumber;
+    readonly snapshot: EDASessionSnapshot;
+  }) => EDAWebSocketProjectionInitial<State>;
+}
+//#endregion
 //#region src/session-controller.d.ts
 /** Composition options for the session use cases and Cloudflare adapters. */
-interface EDASessionControllerOptions extends Omit<EDASessionRuntimeOptions, "sessionEventObserverLayer"> {
+interface EDASessionControllerOptions<ProjectionState extends object = never> extends Omit<EDASessionRuntimeOptions, "sessionEventObserverLayer"> {
   readonly getWebSockets?: () => ReadonlyArray<WebSocket>;
+  readonly webSocketProjection?: EDAWebSocketProjection<ProjectionState>;
   readonly webSocketProtocol?: EDAWebSocketServerFrameEncoder;
 }
 interface EDASessionSubmitInput {
@@ -196,16 +241,23 @@ interface EDASessionEventsInput {
   readonly sessionId: SessionId;
   readonly trace?: EDATraceMetadata;
 }
+/** Prepared acceptance state created before a Cloudflare socket is registered. */
+interface EDAPreparedEventWebSocket<ProjectionState extends object = never> {
+  readonly afterSeq: SequenceNumber;
+  readonly sessionId: SessionId;
+  readonly trace: EDATraceMetadata;
+  readonly projectionState?: ProjectionState;
+}
 /**
  * Public application-facing use cases for one EDA session.
  *
  * Runtime lifecycle belongs to EDASessionRuntime; WebSocket transport belongs
  * to EDAWebSocketConnectionManager. This class only coordinates them.
  */
-declare class EDASessionController {
+declare class EDASessionController<ProjectionState extends object = never> {
   private readonly runtime;
   private readonly webSockets;
-  constructor(options: EDASessionControllerOptions);
+  constructor(options: EDASessionControllerOptions<ProjectionState>);
   static readonly migrate: (storage: EDASessionDurableObjectStorage) => Effect.Effect<void, import("effect-durable-agent/services/session-store").EDASessionStoreError>;
   submit(input: EDASessionSubmitInput): Promise<CommittedDurableEvent>;
   submitBatch(input: EDASessionSubmitBatchInput): Promise<ReadonlyArray<CommittedDurableEvent>>;
@@ -214,6 +266,14 @@ declare class EDASessionController {
   snapshot(input: EDASessionScopedInput): Promise<EDASessionSnapshot>;
   messages(input: EDASessionScopedInput): Promise<ReadonlyArray<DurableTranscriptMessage>>;
   acceptEventWebSocket(input: EDASessionEventsInput & {
+    readonly projectionId?: string;
+    readonly webSocket: WebSocket;
+  }): Promise<void>;
+  private acceptEventWebSocketUnhosted;
+  prepareEventWebSocket(input: EDASessionEventsInput & {
+    readonly projectionId?: string;
+  }): Promise<EDAPreparedEventWebSocket<ProjectionState>>;
+  acceptPreparedEventWebSocket(input: EDAPreparedEventWebSocket<ProjectionState> & {
     readonly webSocket: WebSocket;
   }): Promise<void>;
   webSocketMessage(webSocket: WebSocket, message: string | ArrayBuffer): Promise<void>;
@@ -227,5 +287,5 @@ declare class EDASessionController {
   private run;
 }
 //#endregion
-export { EDASessionScopedInput as a, EDADurableObjectRuntimeLayerOptions as c, EDASessionEventsInput as i, EDASessionDurableObjectStorage as l, EDASessionController as n, EDASessionSubmitBatchInput as o, EDASessionControllerOptions as r, EDASessionSubmitInput as s, EDASessionBlockOnCommandInput as t, makeEDADurableObjectRuntimeLayer as u };
-//# sourceMappingURL=session-controller-BSMHhS_l.d.ts.map
+export { EDASessionEventsInput as a, EDASessionSubmitInput as c, EDAWebSocketProjectionInitial as d, EDAWebSocketProjectionResult as f, makeEDADurableObjectRuntimeLayer as h, EDASessionControllerOptions as i, EDAWebSocketProjection as l, EDASessionDurableObjectStorage as m, EDASessionBlockOnCommandInput as n, EDASessionScopedInput as o, EDADurableObjectRuntimeLayerOptions as p, EDASessionController as r, EDASessionSubmitBatchInput as s, EDAPreparedEventWebSocket as t, EDAWebSocketProjectionId as u };
+//# sourceMappingURL=session-controller-BCsOxE22.d.ts.map