@effect-agent/platform-cloudflare 0.1.0-beta.8 → 0.1.0-beta.80

package/dist/CloudflareThreadClient.mjs

@@ -0,0 +1,386 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { ThreadObjectNamespace } from "./CloudflareBindings.mjs";
+import { AdmissionLimitExceeded } from "./CloudflareConfig.mjs";
+import { r as safeCauseMessage, t as cloudflareFailureSignals } from "./boundary-BguazVkh.mjs";
+import { DurableAlarmError } from "./Alarm.mjs";
+import { AgentId } from "@effect-agent/core/Identifiers";
+import { Receipt } from "@effect-agent/thread/DurableAgentRuntime";
+import { AbortCommand, AbortIntent, AdmissionConflict, AdmissionFence, AdmissionGroup, AdmissionPolicyError, ApprovalConflict, ApprovalDecisionCommand, ApprovalDecisionIntent, IdempotencyKey, JoinedToHost, LedgerError, Principal, Settlement, SettlementConflict, UnknownResolutionCommand, UnknownResolutionConflict, UnknownResolutionIntent } from "@effect-agent/thread/SubmissionLedger";
+import { Context, Crypto, Duration, Effect, Layer, Schema } from "effect";
+import { CanonicalRecordEnvelope, CanonicalSequence, DefinitionDigests, PersistedJson, WorkerAdmission } from "@effect-agent/thread/Records";
+import { RpcTracing } from "effect-cf";
+import { BrowserCrypto } from "@effect/platform-browser";
+import { AgentInputError } from "@effect-agent/core/AgentError";
+import { MessageAdmission } from "@effect-agent/core/Messaging";
+import { DigestError } from "@effect-agent/thread/Digest";
+import { DurableRuntimeFailpointError } from "@effect-agent/thread/DurableFailpoint";
+import { OperationDenied } from "@effect-agent/thread/OperationAuthorizer";
+import { SubmissionStatus } from "@effect-agent/thread/SubmissionStatus";
+import { AppendConflict, FenceRejected, ThreadNotMaterialized, ThreadStoreError } from "@effect-agent/thread/ThreadStore";
+//#region src/CloudflareThreadClient.ts
+var CloudflareThreadClient_exports = /* @__PURE__ */ __exportAll({
+	AbortRecorded: () => AbortRecorded,
+	ApprovalRecorded: () => ApprovalRecorded,
+	AwaitProgressRequest: () => AwaitProgressRequest,
+	CancelProgressRequest: () => CancelProgressRequest,
+	CloudflareThreadClient: () => CloudflareThreadClient,
+	HostFailed: () => HostFailed,
+	HostFailure: () => HostFailure,
+	HostProtocolError: () => HostProtocolError,
+	HostResponse: () => HostResponse,
+	ObservePageRequest: () => ObservePageRequest,
+	ObservedPage: () => ObservedPage,
+	ProgressCancelled: () => ProgressCancelled,
+	ProgressObserved: () => ProgressObserved,
+	SettlementReached: () => SettlementReached,
+	SubmissionStatusResponse: () => SubmissionStatusResponse,
+	SubmitRequest: () => SubmitRequest,
+	SubmitSucceeded: () => SubmitSucceeded,
+	ThreadClientError: () => ThreadClientError,
+	UnknownResolutionRecorded: () => UnknownResolutionRecorded,
+	boundHostDiagnostic: () => boundHostDiagnostic,
+	decodeAbortCommand: () => decodeAbortCommand,
+	decodeApprovalDecisionCommand: () => decodeApprovalDecisionCommand,
+	decodeAwaitProgressRequest: () => decodeAwaitProgressRequest,
+	decodeCancelProgressRequest: () => decodeCancelProgressRequest,
+	decodeHostResponse: () => decodeHostResponse,
+	decodeObservePageRequest: () => decodeObservePageRequest,
+	decodeReceipt: () => decodeReceipt,
+	decodeSubmitRequest: () => decodeSubmitRequest,
+	decodeUnknownResolutionCommand: () => decodeUnknownResolutionCommand,
+	encodeAbortCommand: () => encodeAbortCommand,
+	encodeApprovalDecisionCommand: () => encodeApprovalDecisionCommand,
+	encodeAwaitProgressRequest: () => encodeAwaitProgressRequest,
+	encodeCancelProgressRequest: () => encodeCancelProgressRequest,
+	encodeHostResponse: () => encodeHostResponse,
+	encodeObservePageRequest: () => encodeObservePageRequest,
+	encodeReceipt: () => encodeReceipt,
+	encodeSubmitRequest: () => encodeSubmitRequest,
+	encodeUnknownResolutionCommand: () => encodeUnknownResolutionCommand
+});
+/**
+* The Worker↔Thread-Object host protocol (plan §1.4): Schema envelopes for the host
+* entry points (`submitEncoded`, `awaitSettlementEncoded`, `observePage`, `abortEncoded`,
+* `resolveApprovalEncoded`, `resolveUnknownEncoded`) plus the Worker-side client that speaks
+* it. Mirrors the WP2 port protocol: requests and responses are closed Schema unions, typed
+* failures travel as their own tagged classes and RE-DECODE to identical tags on the caller
+* (error-tag fidelity), and protocol anomalies are answered typed instead of thrown.
+*/
+/** Ceiling for host protocol diagnostic strings. */
+const MAX_HOST_DIAGNOSTIC_LENGTH = 4096;
+const PROGRESS_CANCELLATION_TIMEOUT = "1 second";
+const BoundedDiagnostic = Schema.String.check(Schema.isMaxLength(MAX_HOST_DIAGNOSTIC_LENGTH));
+/** Truncate a diagnostic string to the host protocol's bounded length. */
+const boundHostDiagnostic = (value) => value.length > MAX_HOST_DIAGNOSTIC_LENGTH ? `${value.slice(0, 4093)}...` : value;
+/**
+* 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.
+*/
+var HostProtocolError = class extends Schema.TaggedError()("HostProtocolError", { message: BoundedDiagnostic }) {};
+/** The Worker-side stub call itself failed (RPC rejection, overload, eviction mid-call). */
+var ThreadClientError = class extends Schema.TaggedError()("ThreadClientError", {
+	threadId: Schema.String,
+	message: Schema.String,
+	cause: Schema.optionalKey(Schema.Defect()),
+	/** Cloudflare's own classification for a failure safe to retry with a fresh stub. */
+	retryable: Schema.optionalKey(Schema.Boolean),
+	/** Cloudflare overloads are surfaced immediately instead of adding retry pressure. */
+	overloaded: Schema.optionalKey(Schema.Boolean)
+}) {};
+/**
+* One durable submission, input ALREADY encoded by the caller through the Agent Binding's
+* input schema (the Worker bundles the same Agent definitions as the Object, so schema
+* validation happens client-side; the resolved Binding re-validates at claim time). The
+* Thread identity is deliberately absent — the addressed Object IS the lane.
+*/
+var SubmitRequest = class extends Schema.Class("@effect-agent/platform-cloudflare/SubmitRequest")({
+	agentId: AgentId,
+	principal: Principal,
+	idempotencyKey: IdempotencyKey,
+	admissionGroup: Schema.optionalKey(AdmissionGroup),
+	admissionFence: Schema.optionalKey(AdmissionFence),
+	workerAdmission: Schema.optionalKey(WorkerAdmission),
+	messageAdmission: Schema.optionalKey(MessageAdmission),
+	definitions: DefinitionDigests,
+	inputPayload: PersistedJson
+}) {};
+/** One bounded page of canonical records after an optional sequence. */
+var ObservePageRequest = class extends Schema.Class("@effect-agent/platform-cloudflare/ObservePageRequest")({
+	afterSequence: Schema.optionalKey(CanonicalSequence),
+	limit: Schema.Int.check(Schema.isGreaterThan(0), Schema.isLessThanOrEqualTo(1024))
+}) {};
+/** One event-driven wait for canonical progress strictly after this sequence. */
+var AwaitProgressRequest = class extends Schema.Class("@effect-agent/platform-cloudflare/AwaitProgressRequest")({
+	afterSequence: CanonicalSequence,
+	waiterId: Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(256))
+}) {};
+/** Best-effort cancellation of one in-flight progress RPC. */
+var CancelProgressRequest = class extends Schema.Class("@effect-agent/platform-cloudflare/CancelProgressRequest")({ waiterId: Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(256)) }) {};
+/**
+* Every typed failure a host entry point can produce, plus the protocol's own errors. Same
+* closed-union discipline as the WP2 `PortFailure`: members re-decode to the SAME tagged
+* classes on the Worker side; `cause` chains travel as Schema defects without instance
+* fidelity (plan §2.8).
+*/
+const HostFailure = Schema.Union([
+	AgentInputError,
+	DigestError,
+	AdmissionConflict,
+	AdmissionPolicyError,
+	SettlementConflict,
+	ApprovalConflict,
+	UnknownResolutionConflict,
+	JoinedToHost,
+	LedgerError,
+	ThreadStoreError,
+	ThreadNotMaterialized,
+	AppendConflict,
+	FenceRejected,
+	DurableRuntimeFailpointError,
+	AdmissionLimitExceeded,
+	DurableAlarmError,
+	OperationDenied,
+	HostProtocolError
+]);
+var SubmitSucceeded = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/SubmitSucceeded")("SubmitSucceeded", { receipt: Receipt }) {};
+var SubmissionStatusResponse = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/SubmissionStatusResponse")("SubmissionStatusResponse", { status: SubmissionStatus }) {};
+var SettlementReached = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/SettlementReached")("SettlementReached", { settlement: Settlement }) {};
+var ObservedPage = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/ObservedPage")("ObservedPage", { records: Schema.Array(CanonicalRecordEnvelope).check(Schema.isMaxLength(1024)) }) {};
+/** A record was already committed or an incarnation-local hint says the caller should re-read. */
+var ProgressObserved = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/ProgressObserved")("ProgressObserved", {}) {};
+var ProgressCancelled = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/ProgressCancelled")("ProgressCancelled", {}) {};
+var AbortRecorded = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/AbortRecorded")("AbortRecorded", { intent: AbortIntent }) {};
+var ApprovalRecorded = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/ApprovalRecorded")("ApprovalRecorded", { intent: ApprovalDecisionIntent }) {};
+var UnknownResolutionRecorded = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/UnknownResolutionRecorded")("UnknownResolutionRecorded", { intent: UnknownResolutionIntent }) {};
+/** The entry point failed TYPED on the Object; the failure re-decodes verbatim. */
+var HostFailed = class extends Schema.TaggedClass("@effect-agent/platform-cloudflare/HostFailed")("HostFailed", { failure: HostFailure }) {};
+/** The uniform answer of one host entry point. Callers narrow by the tag their call implies. */
+const HostResponse = Schema.Union([
+	SubmitSucceeded,
+	SettlementReached,
+	SubmissionStatusResponse,
+	ObservedPage,
+	ProgressObserved,
+	ProgressCancelled,
+	AbortRecorded,
+	ApprovalRecorded,
+	UnknownResolutionRecorded,
+	HostFailed
+]);
+const decodeSubmitRequest = Schema.decodeUnknownEffect(SubmitRequest);
+const encodeSubmitRequest = Schema.encodeEffect(SubmitRequest);
+const decodeReceipt = Schema.decodeUnknownEffect(Receipt);
+const encodeReceipt = Schema.encodeEffect(Receipt);
+const decodeObservePageRequest = Schema.decodeUnknownEffect(ObservePageRequest);
+const encodeObservePageRequest = Schema.encodeEffect(ObservePageRequest);
+const decodeAwaitProgressRequest = Schema.decodeUnknownEffect(AwaitProgressRequest);
+const encodeAwaitProgressRequest = Schema.encodeEffect(AwaitProgressRequest);
+const decodeCancelProgressRequest = Schema.decodeUnknownEffect(CancelProgressRequest);
+const encodeCancelProgressRequest = Schema.encodeEffect(CancelProgressRequest);
+const decodeAbortCommand = Schema.decodeUnknownEffect(AbortCommand);
+const encodeAbortCommand = Schema.encodeEffect(AbortCommand);
+const decodeApprovalDecisionCommand = Schema.decodeUnknownEffect(ApprovalDecisionCommand);
+const encodeApprovalDecisionCommand = Schema.encodeEffect(ApprovalDecisionCommand);
+const decodeUnknownResolutionCommand = Schema.decodeUnknownEffect(UnknownResolutionCommand);
+const encodeUnknownResolutionCommand = Schema.encodeEffect(UnknownResolutionCommand);
+const encodeHostResponse = Schema.encodeEffect(HostResponse);
+const decodeHostResponse = Schema.decodeUnknownEffect(HostResponse);
+/** Failure surface of `CloudflareThreadClient.submit`. */
+const ClientSubmitHostFailure = Schema.Union([
+	AgentInputError,
+	DigestError,
+	AdmissionConflict,
+	AdmissionPolicyError,
+	LedgerError,
+	ThreadStoreError,
+	ThreadNotMaterialized,
+	AppendConflict,
+	FenceRejected,
+	DurableRuntimeFailpointError,
+	AdmissionLimitExceeded,
+	DurableAlarmError,
+	HostProtocolError
+]);
+const ClientAwaitHostFailure = Schema.Union([
+	LedgerError,
+	SettlementConflict,
+	OperationDenied,
+	HostProtocolError
+]);
+const ClientObserveHostFailure = Schema.Union([
+	ThreadStoreError,
+	ThreadNotMaterialized,
+	OperationDenied,
+	HostProtocolError
+]);
+const ClientAbortHostFailure = Schema.Union([
+	OperationDenied,
+	LedgerError,
+	SettlementConflict,
+	JoinedToHost,
+	DurableRuntimeFailpointError,
+	DurableAlarmError,
+	HostProtocolError
+]);
+const ClientApprovalHostFailure = Schema.Union([
+	LedgerError,
+	SettlementConflict,
+	ApprovalConflict,
+	OperationDenied,
+	DurableAlarmError,
+	HostProtocolError
+]);
+const ClientUnknownHostFailure = Schema.Union([
+	LedgerError,
+	SettlementConflict,
+	UnknownResolutionConflict,
+	JoinedToHost,
+	DurableRuntimeFailpointError,
+	OperationDenied,
+	DurableAlarmError,
+	HostProtocolError
+]);
+const outOfContract = (threadId, operation, observed) => ThreadClientError.make({
+	threadId,
+	message: boundHostDiagnostic(`The Thread Object answered ${operation} with the out-of-contract ${observed}.`)
+});
+const hostRpcMethods = {
+	submit: "submitEncoded",
+	awaitSettlement: "awaitSettlementEncoded",
+	submissionStatus: "submissionStatusEncoded",
+	awaitProgress: "awaitProgressEncoded",
+	cancelProgress: "cancelProgressEncoded",
+	observePage: "observePage",
+	abort: "abortEncoded",
+	resolveApproval: "resolveApprovalEncoded",
+	resolveUnknown: "resolveUnknownEncoded"
+};
+/** Worker-side client over the Thread Object namespace (DEPLOY-010). */
+var CloudflareThreadClient = class CloudflareThreadClient extends Context.Service()("@effect-agent/platform-cloudflare/CloudflareThreadClient") {
+	/**
+	* Assemble the client from a resolved namespace and the platform Crypto implementation.
+	* rpcTracing is the binding name and remains opt-in. Caller authentication, principals,
+	* idempotency keys, and definition digests are still explicit submission inputs.
+	*/
+	static layerFromBinding(options) {
+		return CloudflareThreadClient.layer.pipe(Layer.provide([ThreadObjectNamespace.layer(options.namespace, options), BrowserCrypto.layer]));
+	}
+	static layer = Layer.effect(CloudflareThreadClient)(Effect.gen(function* () {
+		const { get, rpcTracing } = yield* ThreadObjectNamespace;
+		const crypto = yield* Crypto.Crypto;
+		const call = Effect.fn(function* (threadId, operation, encoded) {
+			const traceArgs = rpcTracing === void 0 ? [] : yield* RpcTracing.withRpcTraceContext([]);
+			const raw = yield* Effect.tryPromise({
+				try: () => {
+					return get(threadId)[hostRpcMethods[operation]](encoded, ...traceArgs);
+				},
+				catch: (cause) => ThreadClientError.make({
+					threadId,
+					message: boundHostDiagnostic(`${operation} did not reach the Thread Object: ${safeCauseMessage(cause, "the RPC failed without a diagnostic")}`),
+					cause,
+					...cloudflareFailureSignals(cause)
+				})
+			});
+			return yield* decodeHostResponse(raw).pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`The ${operation} answer could not be decoded: ${error.message}`) })));
+		}, (effect, threadId, operation) => rpcTracing === void 0 ? Effect.withSpan(effect, "CloudflareThreadClient.call", { attributes: {
+			threadId,
+			operation
+		} }) : RpcTracing.withRpcClientSpan(effect, rpcTracing, hostRpcMethods[operation]));
+		const expect = (threadId, operation, resultSchema, failureSchema) => {
+			const isExpectedResult = Schema.is(resultSchema);
+			const isExpectedFailure = Schema.is(failureSchema);
+			return (response) => {
+				if (response._tag === "HostFailed") {
+					const failure = response.failure;
+					return isExpectedFailure(failure) ? Effect.fail(failure) : Effect.fail(outOfContract(threadId, operation, `failure ${failure._tag}`));
+				}
+				if (!isExpectedResult(response)) return Effect.fail(outOfContract(threadId, operation, `result ${response._tag}`));
+				return Effect.succeed(response);
+			};
+		};
+		const readPage = (threadId, options) => Effect.gen(function* () {
+			const request = ObservePageRequest.make({
+				...options?.afterSequence === void 0 ? {} : { afterSequence: options.afterSequence },
+				limit: options?.limit ?? 256
+			});
+			const encoded = yield* encodeObservePageRequest(request).pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`observePage request encode failed: ${error.message}`) })));
+			const response = yield* call(threadId, "observePage", encoded);
+			return (yield* expect(threadId, "observePage", ObservedPage, ClientObserveHostFailure)(response)).records;
+		});
+		const cancelProgress = (threadId, waiterId) => encodeCancelProgressRequest(CancelProgressRequest.make({ waiterId })).pipe(Effect.mapError(() => void 0), Effect.flatMap((encoded) => call(threadId, "cancelProgress", encoded)), Effect.interruptible, Effect.timeout(PROGRESS_CANCELLATION_TIMEOUT), Effect.asVoid, Effect.ignore);
+		return CloudflareThreadClient.of({
+			submit: (agent, input, options) => Effect.gen(function* () {
+				const encodedInput = yield* Schema.encodeEffect(agent.definition.input)(input).pipe(Effect.mapError((cause) => AgentInputError.make({ message: `Unable to encode Agent input: ${cause.message}` })));
+				const inputPayload = yield* Schema.decodeUnknownEffect(PersistedJson)(encodedInput).pipe(Effect.mapError(() => AgentInputError.make({ message: "Agent input does not satisfy the canonical persistence bounds" })));
+				const request = SubmitRequest.make({
+					agentId: agent.definition.id,
+					principal: options.principal,
+					idempotencyKey: options.idempotencyKey,
+					...options.admissionGroup === void 0 ? {} : { admissionGroup: options.admissionGroup },
+					...options.admissionFence === void 0 ? {} : { admissionFence: options.admissionFence },
+					...options.workerAdmission === void 0 ? {} : { workerAdmission: options.workerAdmission },
+					...options.messageAdmission === void 0 ? {} : { messageAdmission: options.messageAdmission },
+					definitions: options.definitions,
+					inputPayload
+				});
+				const encoded = yield* encodeSubmitRequest(request).pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`submit request encode failed: ${error.message}`) })));
+				const response = yield* call(options.threadId, "submit", encoded);
+				return (yield* expect(options.threadId, "submit", SubmitSucceeded, ClientSubmitHostFailure)(response)).receipt;
+			}),
+			submissionStatus: (receipt) => Effect.gen(function* () {
+				const encoded = yield* encodeReceipt(receipt).pipe(Effect.mapError(() => HostProtocolError.make({ message: "Invalid receipt" })));
+				const response = yield* call(receipt.threadId, "submissionStatus", encoded);
+				return (yield* expect(receipt.threadId, "submissionStatus", SubmissionStatusResponse, ClientAwaitHostFailure)(response)).status;
+			}),
+			awaitSettlement: (receipt) => Effect.gen(function* () {
+				const encoded = yield* encodeReceipt(receipt).pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`receipt encode failed: ${error.message}`) })));
+				const response = yield* call(receipt.threadId, "awaitSettlement", encoded);
+				return (yield* expect(receipt.threadId, "awaitSettlement", SettlementReached, ClientAwaitHostFailure)(response)).settlement;
+			}),
+			awaitProgress: (threadId, afterSequence) => Effect.gen(function* () {
+				const waiterId = yield* crypto.randomUUIDv4.pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`awaitProgress cancellation identity generation failed: ${error.message}`) })));
+				const request = AwaitProgressRequest.make({
+					afterSequence,
+					waiterId
+				});
+				const encoded = yield* encodeAwaitProgressRequest(request).pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`awaitProgress request encode failed: ${error.message}`) })));
+				const attempt = (retry) => call(threadId, "awaitProgress", encoded).pipe(Effect.flatMap(expect(threadId, "awaitProgress", ProgressObserved, ClientObserveHostFailure)), Effect.asVoid, Effect.catchTag("ThreadClientError", (error) => error.retryable === true && error.overloaded !== true && retry < 5 ? Effect.sleep(Duration.millis(10 * 2 ** retry)).pipe(Effect.andThen(attempt(retry + 1))) : Effect.fail(error)));
+				yield* attempt(0).pipe(Effect.onInterrupt(() => cancelProgress(threadId, waiterId)));
+			}),
+			readPage,
+			readAll: (threadId) => Effect.gen(function* () {
+				const all = [];
+				let after;
+				for (;;) {
+					const page = yield* readPage(threadId, {
+						afterSequence: after,
+						limit: 1024
+					});
+					all.push(...page);
+					const last = page.at(-1);
+					if (page.length < 1024 || last === void 0) return all;
+					after = last.sequence;
+				}
+			}),
+			abort: (threadId, command) => Effect.gen(function* () {
+				const encoded = yield* encodeAbortCommand(command).pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`abort command encode failed: ${error.message}`) })));
+				const response = yield* call(threadId, "abort", encoded);
+				return (yield* expect(threadId, "abort", AbortRecorded, ClientAbortHostFailure)(response)).intent;
+			}),
+			resolveApproval: (threadId, command) => Effect.gen(function* () {
+				const encoded = yield* encodeApprovalDecisionCommand(command).pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`approval command encode failed: ${error.message}`) })));
+				const response = yield* call(threadId, "resolveApproval", encoded);
+				return (yield* expect(threadId, "resolveApproval", ApprovalRecorded, ClientApprovalHostFailure)(response)).intent;
+			}),
+			resolveUnknown: (threadId, command) => Effect.gen(function* () {
+				const encoded = yield* encodeUnknownResolutionCommand(command).pipe(Effect.mapError((error) => HostProtocolError.make({ message: boundHostDiagnostic(`resolution command encode failed: ${error.message}`) })));
+				const response = yield* call(threadId, "resolveUnknown", encoded);
+				return (yield* expect(threadId, "resolveUnknown", UnknownResolutionRecorded, ClientUnknownHostFailure)(response)).intent;
+			})
+		});
+	}));
+};
+//#endregion
+export { AbortRecorded, ApprovalRecorded, AwaitProgressRequest, CancelProgressRequest, CloudflareThreadClient, HostFailed, HostFailure, HostProtocolError, HostResponse, ObservePageRequest, ObservedPage, ProgressCancelled, ProgressObserved, SettlementReached, SubmissionStatusResponse, SubmitRequest, SubmitSucceeded, ThreadClientError, UnknownResolutionRecorded, boundHostDiagnostic, decodeAbortCommand, decodeApprovalDecisionCommand, decodeAwaitProgressRequest, decodeCancelProgressRequest, decodeHostResponse, decodeObservePageRequest, decodeReceipt, decodeSubmitRequest, decodeUnknownResolutionCommand, encodeAbortCommand, encodeApprovalDecisionCommand, encodeAwaitProgressRequest, encodeCancelProgressRequest, encodeHostResponse, encodeObservePageRequest, encodeReceipt, encodeSubmitRequest, encodeUnknownResolutionCommand, CloudflareThreadClient_exports as t };
+
+//# sourceMappingURL=CloudflareThreadClient.mjs.map

package/dist/CloudflareThreadClient.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudflareThreadClient.mjs","names":[],"sources":["../src/CloudflareThreadClient.ts"],"sourcesContent":["import { AgentInputError } from \"@effect-agent/core/AgentError\";\nimport { AgentId, type ThreadId } from \"@effect-agent/core/Identifiers\";\nimport { MessageAdmission } from \"@effect-agent/core/Messaging\";\nimport { DigestError } from \"@effect-agent/thread/Digest\";\nimport {\n  Receipt,\n  type DurableSubmitAgent,\n  type DurableSubmitOptions,\n} from \"@effect-agent/thread/DurableAgentRuntime\";\nimport { DurableRuntimeFailpointError } from \"@effect-agent/thread/DurableFailpoint\";\nimport { OperationDenied } from \"@effect-agent/thread/OperationAuthorizer\";\nimport {\n  CanonicalRecordEnvelope,\n  CanonicalSequence,\n  DefinitionDigests,\n  PersistedJson,\n  WorkerAdmission,\n} from \"@effect-agent/thread/Records\";\nimport {\n  AdmissionFence,\n  AdmissionGroup,\n  AbortCommand,\n  AbortIntent,\n  AdmissionConflict,\n  AdmissionPolicyError,\n  ApprovalConflict,\n  ApprovalDecisionCommand,\n  ApprovalDecisionIntent,\n  IdempotencyKey,\n  JoinedToHost,\n  LedgerError,\n  Principal,\n  Settlement,\n  SettlementConflict,\n  UnknownResolutionCommand,\n  UnknownResolutionConflict,\n  UnknownResolutionIntent,\n} from \"@effect-agent/thread/SubmissionLedger\";\nimport { SubmissionStatus } from \"@effect-agent/thread/SubmissionStatus\";\nimport {\n  AppendConflict,\n  ThreadNotMaterialized,\n  ThreadStoreError,\n  FenceRejected,\n} from \"@effect-agent/thread/ThreadStore\";\nimport { BrowserCrypto } from \"@effect/platform-browser\";\nimport { Context, Crypto, Duration, Effect, Layer, Schema } from \"effect\";\nimport { RpcTracing } from \"effect-cf\";\n\nimport { DurableAlarmError } from \"./Alarm.ts\";\nimport { ThreadObjectNamespace, type ThreadObjectRpc } from \"./CloudflareBindings.ts\";\nimport { AdmissionLimitExceeded } from \"./CloudflareConfig.ts\";\nimport { cloudflareFailureSignals, safeCauseMessage } from \"./internal/boundary.ts\";\n\n/**\n * The Worker↔Thread-Object host protocol (plan §1.4): Schema envelopes for the host\n * entry points (`submitEncoded`, `awaitSettlementEncoded`, `observePage`, `abortEncoded`,\n * `resolveApprovalEncoded`, `resolveUnknownEncoded`) plus the Worker-side client that speaks\n * it. Mirrors the WP2 port protocol: requests and responses are closed Schema unions, typed\n * failures travel as their own tagged classes and RE-DECODE to identical tags on the caller\n * (error-tag fidelity), and protocol anomalies are answered typed instead of thrown.\n */\n\n/** Ceiling for host protocol diagnostic strings. */\nconst MAX_HOST_DIAGNOSTIC_LENGTH = 4_096;\nconst PROGRESS_CANCELLATION_TIMEOUT = \"1 second\";\n\nconst BoundedDiagnostic = Schema.String.check(Schema.isMaxLength(MAX_HOST_DIAGNOSTIC_LENGTH));\n\n/** Truncate a diagnostic string to the host protocol's bounded length. */\nexport const boundHostDiagnostic = (value: string): string =>\n  value.length > MAX_HOST_DIAGNOSTIC_LENGTH\n    ? `${value.slice(0, MAX_HOST_DIAGNOSTIC_LENGTH - 3)}...`\n    : value;\n\n/**\n * The envelope itself could not be honored: the Object could not decode the request, or a\n * response could not be encoded/decoded. Never carries operation semantics.\n */\nexport class HostProtocolError extends Schema.TaggedError<HostProtocolError>()(\n  \"HostProtocolError\",\n  {\n    message: BoundedDiagnostic,\n  },\n) {}\n\n/** The Worker-side stub call itself failed (RPC rejection, overload, eviction mid-call). */\nexport class ThreadClientError extends Schema.TaggedError<ThreadClientError>()(\n  \"ThreadClientError\",\n  {\n    threadId: Schema.String,\n    message: Schema.String,\n    cause: Schema.optionalKey(Schema.Defect()),\n    /** Cloudflare's own classification for a failure safe to retry with a fresh stub. */\n    retryable: Schema.optionalKey(Schema.Boolean),\n    /** Cloudflare overloads are surfaced immediately instead of adding retry pressure. */\n    overloaded: Schema.optionalKey(Schema.Boolean),\n  },\n) {}\n\n// ---------------------------------------------------------------------------\n// Requests\n// ---------------------------------------------------------------------------\n\n/**\n * One durable submission, input ALREADY encoded by the caller through the Agent Binding's\n * input schema (the Worker bundles the same Agent definitions as the Object, so schema\n * validation happens client-side; the resolved Binding re-validates at claim time). The\n * Thread identity is deliberately absent — the addressed Object IS the lane.\n */\nexport class SubmitRequest extends Schema.Class<SubmitRequest>(\n  \"@effect-agent/platform-cloudflare/SubmitRequest\",\n)({\n  agentId: AgentId,\n  principal: Principal,\n  idempotencyKey: IdempotencyKey,\n  admissionGroup: Schema.optionalKey(AdmissionGroup),\n  admissionFence: Schema.optionalKey(AdmissionFence),\n  workerAdmission: Schema.optionalKey(WorkerAdmission),\n  messageAdmission: Schema.optionalKey(MessageAdmission),\n  definitions: DefinitionDigests,\n  inputPayload: PersistedJson,\n}) {}\n\n/** One bounded page of canonical records after an optional sequence. */\nexport class ObservePageRequest extends Schema.Class<ObservePageRequest>(\n  \"@effect-agent/platform-cloudflare/ObservePageRequest\",\n)({\n  afterSequence: Schema.optionalKey(CanonicalSequence),\n  limit: Schema.Int.check(Schema.isGreaterThan(0), Schema.isLessThanOrEqualTo(1_024)),\n}) {}\n\n/** One event-driven wait for canonical progress strictly after this sequence. */\nexport class AwaitProgressRequest extends Schema.Class<AwaitProgressRequest>(\n  \"@effect-agent/platform-cloudflare/AwaitProgressRequest\",\n)({\n  afterSequence: CanonicalSequence,\n  waiterId: Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(256)),\n}) {}\n\n/** Best-effort cancellation of one in-flight progress RPC. */\nexport class CancelProgressRequest extends Schema.Class<CancelProgressRequest>(\n  \"@effect-agent/platform-cloudflare/CancelProgressRequest\",\n)({\n  waiterId: Schema.String.check(Schema.isMinLength(1), Schema.isMaxLength(256)),\n}) {}\n\n// ---------------------------------------------------------------------------\n// Responses\n// ---------------------------------------------------------------------------\n\n/**\n * Every typed failure a host entry point can produce, plus the protocol's own errors. Same\n * closed-union discipline as the WP2 `PortFailure`: members re-decode to the SAME tagged\n * classes on the Worker side; `cause` chains travel as Schema defects without instance\n * fidelity (plan §2.8).\n */\nexport const HostFailure = Schema.Union([\n  AgentInputError,\n  DigestError,\n  AdmissionConflict,\n  AdmissionPolicyError,\n  SettlementConflict,\n  ApprovalConflict,\n  UnknownResolutionConflict,\n  JoinedToHost,\n  LedgerError,\n  ThreadStoreError,\n  ThreadNotMaterialized,\n  AppendConflict,\n  FenceRejected,\n  DurableRuntimeFailpointError,\n  AdmissionLimitExceeded,\n  DurableAlarmError,\n  OperationDenied,\n  HostProtocolError,\n]);\n\nexport type HostFailure = typeof HostFailure.Type;\n\nexport class SubmitSucceeded extends Schema.TaggedClass<SubmitSucceeded>(\n  \"@effect-agent/platform-cloudflare/SubmitSucceeded\",\n)(\"SubmitSucceeded\", {\n  receipt: Receipt,\n}) {}\n\nexport class SubmissionStatusResponse extends Schema.TaggedClass<SubmissionStatusResponse>(\n  \"@effect-agent/platform-cloudflare/SubmissionStatusResponse\",\n)(\"SubmissionStatusResponse\", { status: SubmissionStatus }) {}\n\nexport class SettlementReached extends Schema.TaggedClass<SettlementReached>(\n  \"@effect-agent/platform-cloudflare/SettlementReached\",\n)(\"SettlementReached\", {\n  settlement: Settlement,\n}) {}\n\nexport class ObservedPage extends Schema.TaggedClass<ObservedPage>(\n  \"@effect-agent/platform-cloudflare/ObservedPage\",\n)(\"ObservedPage\", {\n  records: Schema.Array(CanonicalRecordEnvelope).check(Schema.isMaxLength(1_024)),\n}) {}\n\n/** A record was already committed or an incarnation-local hint says the caller should re-read. */\nexport class ProgressObserved extends Schema.TaggedClass<ProgressObserved>(\n  \"@effect-agent/platform-cloudflare/ProgressObserved\",\n)(\"ProgressObserved\", {}) {}\n\nexport class ProgressCancelled extends Schema.TaggedClass<ProgressCancelled>(\n  \"@effect-agent/platform-cloudflare/ProgressCancelled\",\n)(\"ProgressCancelled\", {}) {}\n\nexport class AbortRecorded extends Schema.TaggedClass<AbortRecorded>(\n  \"@effect-agent/platform-cloudflare/AbortRecorded\",\n)(\"AbortRecorded\", {\n  intent: AbortIntent,\n}) {}\n\nexport class ApprovalRecorded extends Schema.TaggedClass<ApprovalRecorded>(\n  \"@effect-agent/platform-cloudflare/ApprovalRecorded\",\n)(\"ApprovalRecorded\", {\n  intent: ApprovalDecisionIntent,\n}) {}\n\nexport class UnknownResolutionRecorded extends Schema.TaggedClass<UnknownResolutionRecorded>(\n  \"@effect-agent/platform-cloudflare/UnknownResolutionRecorded\",\n)(\"UnknownResolutionRecorded\", {\n  intent: UnknownResolutionIntent,\n}) {}\n\n/** The entry point failed TYPED on the Object; the failure re-decodes verbatim. */\nexport class HostFailed extends Schema.TaggedClass<HostFailed>(\n  \"@effect-agent/platform-cloudflare/HostFailed\",\n)(\"HostFailed\", {\n  failure: HostFailure,\n}) {}\n\n/** The uniform answer of one host entry point. Callers narrow by the tag their call implies. */\nexport const HostResponse = Schema.Union([\n  SubmitSucceeded,\n  SettlementReached,\n  SubmissionStatusResponse,\n  ObservedPage,\n  ProgressObserved,\n  ProgressCancelled,\n  AbortRecorded,\n  ApprovalRecorded,\n  UnknownResolutionRecorded,\n  HostFailed,\n]);\n\nexport type HostResponse = typeof HostResponse.Type;\n\n// ---------------------------------------------------------------------------\n// Codecs (shared by the Object endpoints and the Worker client)\n// ---------------------------------------------------------------------------\n\nexport const decodeSubmitRequest = Schema.decodeUnknownEffect(SubmitRequest);\nexport const encodeSubmitRequest = Schema.encodeEffect(SubmitRequest);\nexport const decodeReceipt = Schema.decodeUnknownEffect(Receipt);\nexport const encodeReceipt = Schema.encodeEffect(Receipt);\nexport const decodeObservePageRequest = Schema.decodeUnknownEffect(ObservePageRequest);\nexport const encodeObservePageRequest = Schema.encodeEffect(ObservePageRequest);\nexport const decodeAwaitProgressRequest = Schema.decodeUnknownEffect(AwaitProgressRequest);\nexport const encodeAwaitProgressRequest = Schema.encodeEffect(AwaitProgressRequest);\nexport const decodeCancelProgressRequest = Schema.decodeUnknownEffect(CancelProgressRequest);\nexport const encodeCancelProgressRequest = Schema.encodeEffect(CancelProgressRequest);\nexport const decodeAbortCommand = Schema.decodeUnknownEffect(AbortCommand);\nexport const encodeAbortCommand = Schema.encodeEffect(AbortCommand);\nexport const decodeApprovalDecisionCommand = Schema.decodeUnknownEffect(ApprovalDecisionCommand);\nexport const encodeApprovalDecisionCommand = Schema.encodeEffect(ApprovalDecisionCommand);\nexport const decodeUnknownResolutionCommand = Schema.decodeUnknownEffect(UnknownResolutionCommand);\nexport const encodeUnknownResolutionCommand = Schema.encodeEffect(UnknownResolutionCommand);\nexport const encodeHostResponse = Schema.encodeEffect(HostResponse);\nexport const decodeHostResponse = Schema.decodeUnknownEffect(HostResponse);\n\n// ---------------------------------------------------------------------------\n// Worker-side client\n// ---------------------------------------------------------------------------\n\n/** Failure surface of `CloudflareThreadClient.submit`. */\nconst ClientSubmitHostFailure = Schema.Union([\n  AgentInputError,\n  DigestError,\n  AdmissionConflict,\n  AdmissionPolicyError,\n  LedgerError,\n  ThreadStoreError,\n  ThreadNotMaterialized,\n  AppendConflict,\n  FenceRejected,\n  DurableRuntimeFailpointError,\n  AdmissionLimitExceeded,\n  DurableAlarmError,\n  HostProtocolError,\n]);\n\nconst ClientAwaitHostFailure = Schema.Union([\n  LedgerError,\n  SettlementConflict,\n  OperationDenied,\n  HostProtocolError,\n]);\n\nconst ClientObserveHostFailure = Schema.Union([\n  ThreadStoreError,\n  ThreadNotMaterialized,\n  OperationDenied,\n  HostProtocolError,\n]);\n\nconst ClientAbortHostFailure = Schema.Union([\n  OperationDenied,\n  LedgerError,\n  SettlementConflict,\n  JoinedToHost,\n  DurableRuntimeFailpointError,\n  DurableAlarmError,\n  HostProtocolError,\n]);\n\nconst ClientApprovalHostFailure = Schema.Union([\n  LedgerError,\n  SettlementConflict,\n  ApprovalConflict,\n  OperationDenied,\n  DurableAlarmError,\n  HostProtocolError,\n]);\n\nconst ClientUnknownHostFailure = Schema.Union([\n  LedgerError,\n  SettlementConflict,\n  UnknownResolutionConflict,\n  JoinedToHost,\n  DurableRuntimeFailpointError,\n  OperationDenied,\n  DurableAlarmError,\n  HostProtocolError,\n]);\n\nexport type ClientSubmitFailure = typeof ClientSubmitHostFailure.Type | ThreadClientError;\nexport type ClientAwaitFailure = typeof ClientAwaitHostFailure.Type | ThreadClientError;\nexport type ClientObserveFailure = typeof ClientObserveHostFailure.Type | ThreadClientError;\nexport type ClientProgressFailure = ClientObserveFailure;\nexport type ClientAbortFailure = typeof ClientAbortHostFailure.Type | ThreadClientError;\nexport type ClientApprovalFailure = typeof ClientApprovalHostFailure.Type | ThreadClientError;\nexport type ClientUnknownFailure = typeof ClientUnknownHostFailure.Type | ThreadClientError;\n\nconst outOfContract = (threadId: string, operation: string, observed: string): ThreadClientError =>\n  ThreadClientError.make({\n    threadId,\n    message: boundHostDiagnostic(\n      `The Thread Object answered ${operation} with the out-of-contract ${observed}.`,\n    ),\n  });\n\nconst hostRpcMethods = {\n  submit: \"submitEncoded\",\n  awaitSettlement: \"awaitSettlementEncoded\",\n  submissionStatus: \"submissionStatusEncoded\",\n  awaitProgress: \"awaitProgressEncoded\",\n  cancelProgress: \"cancelProgressEncoded\",\n  observePage: \"observePage\",\n  abort: \"abortEncoded\",\n  resolveApproval: \"resolveApprovalEncoded\",\n  resolveUnknown: \"resolveUnknownEncoded\",\n} as const satisfies Record<string, keyof ThreadObjectRpc>;\n\n/** Worker-side client over the Thread Object namespace (DEPLOY-010). */\nexport class CloudflareThreadClient extends Context.Service<\n  CloudflareThreadClient,\n  {\n    /** Encode the input client-side, then durably submit to the owning Object. */\n    readonly submit: <InputSchema extends Schema.Top>(\n      agent: DurableSubmitAgent<InputSchema>,\n      input: InputSchema[\"Type\"],\n      options: DurableSubmitOptions,\n    ) => Effect.Effect<Receipt, ClientSubmitFailure, InputSchema[\"EncodingServices\"]>;\n    /** Wake-hinted, poll-guaranteed settlement wait executed inside the owning Object. */\n    readonly submissionStatus: (\n      receipt: Receipt,\n    ) => Effect.Effect<SubmissionStatus, ClientAwaitFailure>;\n    readonly awaitSettlement: (receipt: Receipt) => Effect.Effect<Settlement, ClientAwaitFailure>;\n    /**\n     * Wait without polling until progress after `afterSequence` is already durable or hinted.\n     * The result is deliberately void: canonical records remain authoritative and must be read.\n     * Interruption waits at most one second for best-effort remote cancellation.\n     */\n    readonly awaitProgress: (\n      threadId: ThreadId,\n      afterSequence: CanonicalSequence,\n    ) => Effect.Effect<void, ClientProgressFailure>;\n    /** One bounded page of canonical records. */\n    readonly readPage: (\n      threadId: ThreadId,\n      options?: {\n        readonly afterSequence?: CanonicalSequence | undefined;\n        readonly limit?: number | undefined;\n      },\n    ) => Effect.Effect<ReadonlyArray<CanonicalRecordEnvelope>, ClientObserveFailure>;\n    /**\n     * Every canonical record up to the CURRENT committed tail, via repeated pages. A\n     * snapshot read, not a live observation — callers wanting liveness re-read after\n     * `awaitSettlement`.\n     */\n    readonly readAll: (\n      threadId: ThreadId,\n    ) => Effect.Effect<ReadonlyArray<CanonicalRecordEnvelope>, ClientObserveFailure>;\n    /**\n     * Submission-addressed operations take the owning Thread explicitly (from the\n     * Receipt): minted Submission identities stay OPAQUE outside the storage adapter that\n     * minted them (D-P6-5), so the client never parses one to find the lane.\n     */\n    readonly abort: (\n      threadId: ThreadId,\n      command: AbortCommand,\n    ) => Effect.Effect<AbortIntent, ClientAbortFailure>;\n    readonly resolveApproval: (\n      threadId: ThreadId,\n      command: ApprovalDecisionCommand,\n    ) => Effect.Effect<ApprovalDecisionIntent, ClientApprovalFailure>;\n    readonly resolveUnknown: (\n      threadId: ThreadId,\n      command: UnknownResolutionCommand,\n    ) => Effect.Effect<UnknownResolutionIntent, ClientUnknownFailure>;\n  }\n>()(\"@effect-agent/platform-cloudflare/CloudflareThreadClient\") {\n  /**\n   * Assemble the client from a resolved namespace and the platform Crypto implementation.\n   * rpcTracing is the binding name and remains opt-in. Caller authentication, principals,\n   * idempotency keys, and definition digests are still explicit submission inputs.\n   */\n  static layerFromBinding(options: {\n    readonly namespace: DurableObjectNamespace<ThreadObjectRpc>;\n    readonly rpcTracing?: string;\n  }): Layer.Layer<CloudflareThreadClient> {\n    return CloudflareThreadClient.layer.pipe(\n      Layer.provide([ThreadObjectNamespace.layer(options.namespace, options), BrowserCrypto.layer]),\n    );\n  }\n\n  static readonly layer: Layer.Layer<\n    CloudflareThreadClient,\n    never,\n    ThreadObjectNamespace | Crypto.Crypto\n  > = Layer.effect(CloudflareThreadClient)(\n    Effect.gen(function* () {\n      const { get, rpcTracing } = yield* ThreadObjectNamespace;\n      const crypto = yield* Crypto.Crypto;\n\n      const call = Effect.fn(\n        function* (\n          threadId: ThreadId,\n          operation: keyof typeof hostRpcMethods,\n          encoded: unknown,\n        ): Effect.fn.Return<HostResponse, ThreadClientError | HostProtocolError> {\n          // Empty arguments preserve native arity. Passing `undefined` still adds an argument.\n          const traceArgs =\n            rpcTracing === undefined ? [] : yield* RpcTracing.withRpcTraceContext([]);\n\n          const raw = yield* Effect.tryPromise({\n            try: () => {\n              const stub = get(threadId);\n\n              return stub[hostRpcMethods[operation]](encoded, ...traceArgs);\n            },\n            catch: (cause) =>\n              ThreadClientError.make({\n                threadId,\n                message: boundHostDiagnostic(\n                  `${operation} did not reach the Thread Object: ${safeCauseMessage(\n                    cause,\n                    \"the RPC failed without a diagnostic\",\n                  )}`,\n                ),\n                cause,\n                ...cloudflareFailureSignals(cause),\n              }),\n          });\n\n          return yield* decodeHostResponse(raw).pipe(\n            Effect.mapError((error): HostProtocolError =>\n              HostProtocolError.make({\n                message: boundHostDiagnostic(\n                  `The ${operation} answer could not be decoded: ${error.message}`,\n                ),\n              }),\n            ),\n          );\n        },\n        (effect, threadId, operation) =>\n          rpcTracing === undefined\n            ? Effect.withSpan(effect, \"CloudflareThreadClient.call\", {\n                attributes: { threadId, operation },\n              })\n            : RpcTracing.withRpcClientSpan(effect, rpcTracing, hostRpcMethods[operation]),\n      );\n\n      const expect = <ResultSchema extends Schema.Top, FailureSchema extends Schema.Top>(\n        threadId: string,\n        operation: string,\n        resultSchema: ResultSchema,\n        failureSchema: FailureSchema,\n      ) => {\n        const isExpectedResult = Schema.is(resultSchema);\n        const isExpectedFailure = Schema.is(failureSchema);\n\n        return (\n          response: HostResponse,\n        ): Effect.Effect<ResultSchema[\"Type\"], FailureSchema[\"Type\"] | ThreadClientError> => {\n          if (response._tag === \"HostFailed\") {\n            const failure = response.failure;\n\n            return isExpectedFailure(failure)\n              ? Effect.fail(failure)\n              : Effect.fail(outOfContract(threadId, operation, `failure ${failure._tag}`));\n          }\n          if (!isExpectedResult(response)) {\n            return Effect.fail(outOfContract(threadId, operation, `result ${response._tag}`));\n          }\n\n          return Effect.succeed(response);\n        };\n      };\n\n      const readPage = (\n        threadId: ThreadId,\n        options?: {\n          readonly afterSequence?: CanonicalSequence | undefined;\n          readonly limit?: number | undefined;\n        },\n      ) =>\n        Effect.gen(function* () {\n          const request = ObservePageRequest.make({\n            ...(options?.afterSequence === undefined\n              ? {}\n              : { afterSequence: options.afterSequence }),\n            limit: options?.limit ?? 256,\n          });\n\n          const encoded = yield* encodeObservePageRequest(request).pipe(\n            Effect.mapError((error) =>\n              HostProtocolError.make({\n                message: boundHostDiagnostic(`observePage request encode failed: ${error.message}`),\n              }),\n            ),\n          );\n\n          const response = yield* call(threadId, \"observePage\", encoded);\n\n          const page = yield* expect(\n            threadId,\n            \"observePage\",\n            ObservedPage,\n            ClientObserveHostFailure,\n          )(response);\n\n          return page.records;\n        });\n\n      const cancelProgress = (threadId: ThreadId, waiterId: string): Effect.Effect<void> =>\n        encodeCancelProgressRequest(CancelProgressRequest.make({ waiterId })).pipe(\n          Effect.mapError(() => undefined),\n          Effect.flatMap((encoded) => call(threadId, \"cancelProgress\", encoded)),\n          // Finalizers are uninterruptible; only the foreign RPC branch must remain\n          // interruptible so a lost cancellation reply cannot prevent local shutdown.\n          Effect.interruptible,\n          Effect.timeout(PROGRESS_CANCELLATION_TIMEOUT),\n          Effect.asVoid,\n          Effect.ignore,\n        );\n\n      return CloudflareThreadClient.of({\n        submit: <InputSchema extends Schema.Top>(\n          agent: DurableSubmitAgent<InputSchema>,\n          input: InputSchema[\"Type\"],\n          options: DurableSubmitOptions,\n        ) =>\n          Effect.gen(function* () {\n            // Client-side half of `DurableAgentRuntime.submit`'s input boundary: encode\n            // through the Agent's input schema and prove the canonical persistence bounds.\n            const encodedInput = yield* Schema.encodeEffect(agent.definition.input)(input).pipe(\n              Effect.mapError((cause) =>\n                AgentInputError.make({ message: `Unable to encode Agent input: ${cause.message}` }),\n              ),\n            );\n\n            const inputPayload = yield* Schema.decodeUnknownEffect(PersistedJson)(\n              encodedInput,\n            ).pipe(\n              Effect.mapError(() =>\n                AgentInputError.make({\n                  message: \"Agent input does not satisfy the canonical persistence bounds\",\n                }),\n              ),\n            );\n\n            const request = SubmitRequest.make({\n              agentId: agent.definition.id,\n              principal: options.principal,\n              idempotencyKey: options.idempotencyKey,\n              ...(options.admissionGroup === undefined\n                ? {}\n                : { admissionGroup: options.admissionGroup }),\n              ...(options.admissionFence === undefined\n                ? {}\n                : { admissionFence: options.admissionFence }),\n              ...(options.workerAdmission === undefined\n                ? {}\n                : { workerAdmission: options.workerAdmission }),\n              ...(options.messageAdmission === undefined\n                ? {}\n                : { messageAdmission: options.messageAdmission }),\n              definitions: options.definitions,\n              inputPayload,\n            });\n\n            const encoded = yield* encodeSubmitRequest(request).pipe(\n              Effect.mapError((error) =>\n                HostProtocolError.make({\n                  message: boundHostDiagnostic(`submit request encode failed: ${error.message}`),\n                }),\n              ),\n            );\n\n            const response = yield* call(options.threadId, \"submit\", encoded);\n\n            const succeeded = yield* expect(\n              options.threadId,\n              \"submit\",\n              SubmitSucceeded,\n              ClientSubmitHostFailure,\n            )(response);\n\n            return succeeded.receipt;\n          }),\n\n        submissionStatus: (receipt) =>\n          Effect.gen(function* () {\n            const encoded = yield* encodeReceipt(receipt).pipe(\n              Effect.mapError(() => HostProtocolError.make({ message: \"Invalid receipt\" })),\n            );\n\n            const response = yield* call(receipt.threadId, \"submissionStatus\", encoded);\n\n            const result = yield* expect(\n              receipt.threadId,\n              \"submissionStatus\",\n              SubmissionStatusResponse,\n              ClientAwaitHostFailure,\n            )(response);\n\n            return result.status;\n          }),\n        awaitSettlement: (receipt) =>\n          Effect.gen(function* () {\n            const encoded = yield* encodeReceipt(receipt).pipe(\n              Effect.mapError((error) =>\n                HostProtocolError.make({\n                  message: boundHostDiagnostic(`receipt encode failed: ${error.message}`),\n                }),\n              ),\n            );\n\n            const response = yield* call(receipt.threadId, \"awaitSettlement\", encoded);\n\n            const settled = yield* expect(\n              receipt.threadId,\n              \"awaitSettlement\",\n              SettlementReached,\n              ClientAwaitHostFailure,\n            )(response);\n\n            return settled.settlement;\n          }),\n\n        awaitProgress: (threadId, afterSequence) =>\n          Effect.gen(function* () {\n            const waiterId = yield* crypto.randomUUIDv4.pipe(\n              Effect.mapError((error) =>\n                HostProtocolError.make({\n                  message: boundHostDiagnostic(\n                    `awaitProgress cancellation identity generation failed: ${error.message}`,\n                  ),\n                }),\n              ),\n            );\n\n            const request = AwaitProgressRequest.make({ afterSequence, waiterId });\n\n            const encoded = yield* encodeAwaitProgressRequest(request).pipe(\n              Effect.mapError((error) =>\n                HostProtocolError.make({\n                  message: boundHostDiagnostic(\n                    `awaitProgress request encode failed: ${error.message}`,\n                  ),\n                }),\n              ),\n            );\n\n            const attempt = (retry: number): Effect.Effect<void, ClientProgressFailure> =>\n              call(threadId, \"awaitProgress\", encoded).pipe(\n                Effect.flatMap(\n                  expect(threadId, \"awaitProgress\", ProgressObserved, ClientObserveHostFailure),\n                ),\n                Effect.asVoid,\n                Effect.catchTag(\"ThreadClientError\", (error) =>\n                  error.retryable === true && error.overloaded !== true && retry < 5\n                    ? Effect.sleep(Duration.millis(10 * 2 ** retry)).pipe(\n                        Effect.andThen(attempt(retry + 1)),\n                      )\n                    : Effect.fail(error),\n                ),\n              );\n\n            yield* attempt(0).pipe(Effect.onInterrupt(() => cancelProgress(threadId, waiterId)));\n          }),\n\n        readPage,\n\n        readAll: (threadId) =>\n          Effect.gen(function* () {\n            const all: Array<CanonicalRecordEnvelope> = [];\n            let after: CanonicalSequence | undefined;\n\n            for (;;) {\n              const page = yield* readPage(threadId, { afterSequence: after, limit: 1_024 });\n\n              all.push(...page);\n              const last = page.at(-1);\n\n              if (page.length < 1_024 || last === undefined) return all;\n              after = last.sequence;\n            }\n          }),\n\n        abort: (threadId, command) =>\n          Effect.gen(function* () {\n            const encoded = yield* encodeAbortCommand(command).pipe(\n              Effect.mapError((error) =>\n                HostProtocolError.make({\n                  message: boundHostDiagnostic(`abort command encode failed: ${error.message}`),\n                }),\n              ),\n            );\n\n            const response = yield* call(threadId, \"abort\", encoded);\n\n            const recorded = yield* expect(\n              threadId,\n              \"abort\",\n              AbortRecorded,\n              ClientAbortHostFailure,\n            )(response);\n\n            return recorded.intent;\n          }),\n\n        resolveApproval: (threadId, command) =>\n          Effect.gen(function* () {\n            const encoded = yield* encodeApprovalDecisionCommand(command).pipe(\n              Effect.mapError((error) =>\n                HostProtocolError.make({\n                  message: boundHostDiagnostic(`approval command encode failed: ${error.message}`),\n                }),\n              ),\n            );\n\n            const response = yield* call(threadId, \"resolveApproval\", encoded);\n\n            const recorded = yield* expect(\n              threadId,\n              \"resolveApproval\",\n              ApprovalRecorded,\n              ClientApprovalHostFailure,\n            )(response);\n\n            return recorded.intent;\n          }),\n\n        resolveUnknown: (threadId, command) =>\n          Effect.gen(function* () {\n            const encoded = yield* encodeUnknownResolutionCommand(command).pipe(\n              Effect.mapError((error) =>\n                HostProtocolError.make({\n                  message: boundHostDiagnostic(\n                    `resolution command encode failed: ${error.message}`,\n                  ),\n                }),\n              ),\n            );\n\n            const response = yield* call(threadId, \"resolveUnknown\", encoded);\n\n            const recorded = yield* expect(\n              threadId,\n              \"resolveUnknown\",\n              UnknownResolutionRecorded,\n              ClientUnknownHostFailure,\n            )(response);\n\n            return recorded.intent;\n          }),\n      });\n    }),\n  );\n}\n"],"mappings":"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"}

package/dist/InteractiveBrowser.d.mts

@@ -0,0 +1,144 @@
+import { n as BrowserRunLifecycleOptions, r as BrowserRunSessionLifecycle, t as BrowserRunCleanupError } from "./browser-session-lifecycle-DJpqLXy_.mjs";
+import { Context, Effect, Layer, Redacted, Schema, Scope } from "effect";
+import { SandboxImplementation } from "@effect-agent/sandbox/Sandbox";
+import { BrowserHandle, InteractiveBrowser, InteractiveBrowserError, InteractiveBrowserPolicy, InteractiveBrowserPolicyDeniedError } from "@effect-agent/sandbox/InteractiveBrowser";
+//#region src/InteractiveBrowser.d.ts
+declare const browserRunInteractiveImplementation: SandboxImplementation;
+declare const BrowserRunViewport_base: Schema.Class<BrowserRunViewport, Schema.Struct<{
+  readonly width: Schema.Int;
+  readonly height: Schema.Int;
+  readonly deviceScaleFactor: Schema.optionalKey<Schema.Finite>;
+}>, {}>;
+/**
+ * Host presentation state in CSS pixels. Dimensions are integers in 1..2048,
+ * density is finite in 1..2 (default 1), and neither scaled dimension may exceed
+ * 2048 pixels. Mobile, touch, and orientation emulation are not supported.
+ */
+declare class BrowserRunViewport extends BrowserRunViewport_base {}
+declare const BrowserRunLiveViewRequest_base: Schema.Class<BrowserRunLiveViewRequest, Schema.Struct<{
+  readonly mode: Schema.Literal<"tab">;
+  readonly expiresInMs: Schema.Int;
+}>, {}>;
+/** Host-only request for a redacted Cloudflare Live View URL. */
+declare class BrowserRunLiveViewRequest extends BrowserRunLiveViewRequest_base {}
+declare const BrowserRunLiveViewResult_base: Schema.Class<BrowserRunLiveViewResult, Schema.Struct<{
+  readonly devtoolsFrontendUrl: Schema.Redacted<Schema.String>;
+}>, {}>;
+declare class BrowserRunLiveViewResult extends BrowserRunLiveViewResult_base {}
+declare const BrowserRunHandoffRequest_base: Schema.Class<BrowserRunHandoffRequest, Schema.Struct<{
+  readonly instructions: Schema.String;
+  readonly timeout: Schema.Int;
+}>, {}>;
+/** Start one bounded handoff; controller ownership remains a consumer concern. */
+declare class BrowserRunHandoffRequest extends BrowserRunHandoffRequest_base {}
+declare const BrowserRunHandoffResult_base: Schema.Class<BrowserRunHandoffResult, Schema.Struct<{
+  readonly handoffId: Schema.Redacted<Schema.String>;
+}>, {}>;
+declare class BrowserRunHandoffResult extends BrowserRunHandoffResult_base {}
+declare const BrowserRunHandoffState_base: Schema.Class<BrowserRunHandoffState, Schema.Struct<{
+  readonly active: Schema.Boolean;
+  readonly handoffId: Schema.optionalKey<Schema.Redacted<Schema.String>>;
+  readonly durationMs: Schema.optionalKey<Schema.Natural>;
+}>, {}>;
+declare class BrowserRunHandoffState extends BrowserRunHandoffState_base {}
+/** One intercepted Puppeteer request, narrowed to the policy-relevant surface. */
+interface BrowserRunInteractiveRequest {
+  readonly url: () => string;
+  readonly abort: () => Promise<void>;
+  readonly continue: () => Promise<void>;
+}
+type BrowserRunInteractiveRequestListener = (request: BrowserRunInteractiveRequest) => void;
+type BrowserRunCloudflareCommand = "Cloudflare.getLiveView" | "Cloudflare.handoff" | "Cloudflare.getHandoffState";
+/** Narrow CDP boundary for Cloudflare commands absent from the pinned protocol types. */
+interface BrowserRunInteractiveCdpSession {
+  readonly send: (command: BrowserRunCloudflareCommand, parameters: unknown) => Promise<unknown>;
+  readonly detach: () => Promise<void>;
+}
+/** Narrow page boundary used by deterministic tests; SDK values remain in this package. */
+interface BrowserRunInteractivePage {
+  readonly close: () => Promise<void>;
+  readonly setBypassServiceWorker: (enabled: boolean) => Promise<void>;
+  readonly setRequestInterception: (enabled: boolean) => Promise<void>;
+  readonly onRequest: (listener: BrowserRunInteractiveRequestListener) => void;
+  readonly offRequest: (listener: BrowserRunInteractiveRequestListener) => void;
+  readonly goto: (url: string) => Promise<void>;
+  readonly url: () => unknown;
+  readonly readText: (selector: string | undefined, maximumBytes: number) => Promise<unknown>;
+  readonly fill: (selector: string, value: string, signal: AbortSignal, onDispatch: () => void) => Promise<unknown>;
+  readonly click: (selector: string, signal: AbortSignal, onDispatch: () => void) => Promise<unknown>;
+  readonly screenshot: (fullPage: boolean) => Promise<unknown>;
+  readonly scroll: (deltaX: number, deltaY: number) => Promise<void>;
+  readonly setViewport: (viewport: BrowserRunViewport) => Promise<void>;
+  readonly createCdpSession: () => Promise<BrowserRunInteractiveCdpSession>;
+}
+interface BrowserRunInteractiveContext {
+  readonly newPage: () => Promise<BrowserRunInteractivePage>;
+  readonly close: () => Promise<void>;
+}
+interface BrowserRunInteractiveBrowser {
+  readonly createContext: () => Promise<BrowserRunInteractiveContext>;
+  readonly close: () => Promise<void>;
+  readonly sessionId: () => unknown;
+  readonly isConnected: () => boolean;
+  readonly onDisconnected: (listener: () => void) => void;
+  readonly offDisconnected: (listener: () => void) => void;
+}
+declare const BrowserRunInteractiveBinding_base: Context.ServiceClass<BrowserRunInteractiveBinding, "@effect-agent/platform-cloudflare/BrowserRunInteractiveBinding", {
+  readonly launch: (keepAliveMillis: number) => Promise<BrowserRunInteractiveBrowser>;
+  /** Success proves whole-browser termination or exact-session absence. */
+  readonly closeSession: (sessionId: Redacted.Redacted<string>) => Effect.Effect<void, InteractiveBrowserError>;
+}>;
+/** Host-supplied Browser Run binding projected into one fakeable launch operation. */
+declare class BrowserRunInteractiveBinding extends BrowserRunInteractiveBinding_base {
+  static layer(options: {
+    readonly browser: BrowserRun;
+    readonly viewport?: BrowserRunViewport;
+  }): Layer.Layer<BrowserRunInteractiveBinding, InteractiveBrowserPolicyDeniedError, BrowserRunSessionLifecycle>;
+}
+interface BrowserRunInteractiveSession {
+  readonly handle: BrowserHandle;
+  readonly sessionId: Redacted.Redacted<string>;
+  /**
+   * Resize without charging an agent action or changing emulation modes. Shares
+   * the handle's fail-fast lock, page-policy preflight, and elapsed deadline.
+   * A timeout or interruption leaves the session unusable; no resize is retried.
+   * The host must authorize callers. No viewer ownership or durable state is added.
+   */
+  readonly resizeViewport: (viewport: BrowserRunViewport) => Effect.Effect<void, InteractiveBrowserError>;
+  readonly getLiveView: (request: BrowserRunLiveViewRequest) => Effect.Effect<BrowserRunLiveViewResult, InteractiveBrowserError>;
+  readonly handoff: (request: BrowserRunHandoffRequest) => Effect.Effect<BrowserRunHandoffResult, InteractiveBrowserError>;
+  readonly getHandoffState: Effect.Effect<BrowserRunHandoffState, InteractiveBrowserError>;
+  readonly close: Effect.Effect<void, InteractiveBrowserError>;
+}
+declare const BrowserRunInteractiveHost_base: Context.ServiceClass<BrowserRunInteractiveHost, "@effect-agent/platform-cloudflare/BrowserRunInteractiveHost", {
+  readonly cleanupSemantics?: "confirmed-terminal";
+  readonly open: (policy: InteractiveBrowserPolicy) => Effect.Effect<BrowserRunInteractiveSession, InteractiveBrowserError, Scope.Scope>;
+  readonly closeSession: (sessionId: Redacted.Redacted<string>) => Effect.Effect<void, InteractiveBrowserError>;
+}>;
+/** Cloudflare host authority kept separate from the provider-neutral browser handle. */
+declare class BrowserRunInteractiveHost extends BrowserRunInteractiveHost_base {}
+/** Recognizes a local pre-dispatch refusal without exposing selector or page content. */
+declare const isBrowserRunUndispatchedActionError: (error: unknown) => boolean;
+/** Cloudflare host controls and private session identity for one scoped Browser Run pass. */
+declare const browserRunInteractiveHostLayer: () => Layer.Layer<BrowserRunInteractiveHost, never, BrowserRunInteractiveBinding>;
+/** Worker-only generic adapter; Cloudflare identity and controls remain host-only. */
+declare const browserRunInteractiveLayer: () => Layer.Layer<InteractiveBrowser, never, BrowserRunInteractiveBinding>;
+/** Resolved Worker binding, cleanup credentials, and optional initial viewport. */
+interface CloudflareInteractiveBrowserOptions extends BrowserRunLifecycleOptions {
+  readonly browser: BrowserRun;
+  readonly viewport?: BrowserRunViewport;
+}
+/** Worker-only assembly; importing ordinary capture never loads Puppeteer. */
+declare const CloudflareInteractiveBrowser: {
+  /**
+   * Assemble binding, confirmed-session cleanup, and the generic browser service.
+   * HttpClient and construction errors remain visible. Opening a pass still requires
+   * an explicit policy and Scope; no browser is launched during Layer construction.
+   */
+  layer: (options: CloudflareInteractiveBrowserOptions) => Layer.Layer<InteractiveBrowser, BrowserRunCleanupError | InteractiveBrowserPolicyDeniedError, import("effect/unstable/http/HttpClient").HttpClient>;
+  /** Opt into private host controls instead of exposing them through the generic service. */
+  hostLayer: (options: CloudflareInteractiveBrowserOptions) => Layer.Layer<BrowserRunInteractiveHost, BrowserRunCleanupError | InteractiveBrowserPolicyDeniedError, import("effect/unstable/http/HttpClient").HttpClient>;
+};
+//#endregion
+export { BrowserRunCleanupError, BrowserRunCloudflareCommand, BrowserRunHandoffRequest, BrowserRunHandoffResult, BrowserRunHandoffState, BrowserRunInteractiveBinding, BrowserRunInteractiveBrowser, BrowserRunInteractiveCdpSession, BrowserRunInteractiveContext, BrowserRunInteractiveHost, BrowserRunInteractivePage, BrowserRunInteractiveRequest, BrowserRunInteractiveRequestListener, BrowserRunInteractiveSession, BrowserRunLiveViewRequest, BrowserRunLiveViewResult, BrowserRunSessionLifecycle, BrowserRunViewport, CloudflareInteractiveBrowser, CloudflareInteractiveBrowserOptions, browserRunInteractiveHostLayer, browserRunInteractiveImplementation, browserRunInteractiveLayer, isBrowserRunUndispatchedActionError };
+//# sourceMappingURL=InteractiveBrowser.d.mts.map