@nice-code/action 0.22.0 → 0.24.0

package/build/index.cjs

@@ -1,11 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_httpAcceptorCarrier = require("./httpAcceptorCarrier-OnJxzsAD.cjs");
+const require_createHibernatableWsServerAdapter = require("./createHibernatableWsServerAdapter-BNi4k9j3.cjs");
 const require_RunningAction_types = require("./RunningAction.types-DjCX1xp5.cjs");
+const require_httpAcceptorCarrier = require("./httpAcceptorCarrier-C3S_bDkL.cjs");
 let nanoid = require("nanoid");
 let _nice_code_error = require("@nice-code/error");
-let msgpackr = require("msgpackr");
 //#region src/ActionDefinition/Action/Context/ActionContext.ts
-var ActionContext = class extends require_httpAcceptorCarrier.ActionBase {
+var ActionContext = class extends require_createHibernatableWsServerAdapter.ActionBase {
 	_domain;
 	form = "context";
 	_routing;
@@ -71,7 +71,7 @@ var ActionContext = class extends require_httpAcceptorCarrier.ActionBase {
 };
 //#endregion
 //#region src/ActionDefinition/Action/Core/ActionCore.ts
-var ActionCore = class extends require_httpAcceptorCarrier.ActionBase {
+var ActionCore = class extends require_createHibernatableWsServerAdapter.ActionBase {
 	_domain;
 	form = "core";
 	constructor(_domain, id) {
@@ -79,7 +79,7 @@ var ActionCore = class extends require_httpAcceptorCarrier.ActionBase {
 		this._domain = _domain;
 	}
 	is(action) {
-		return action instanceof require_httpAcceptorCarrier.ActionPayload && action.domain === this.domain && action.id === this.id;
+		return action instanceof require_createHibernatableWsServerAdapter.ActionPayload && action.domain === this.domain && action.id === this.id;
 	}
 	toJsonObject() {
 		return {
@@ -95,11 +95,11 @@ var ActionCore = class extends require_httpAcceptorCarrier.ActionBase {
 			actionId: this.id,
 			domain: this.domain
 		});
-		return new require_httpAcceptorCarrier.ActionPayload_Request({ context: new ActionContext(this._domain, this.id, {
+		return new require_createHibernatableWsServerAdapter.ActionPayload_Request({ context: new ActionContext(this._domain, this.id, {
 			cuid: (0, nanoid.nanoid)(),
 			timeCreated: Date.now(),
 			routing: [],
-			originClient: require_httpAcceptorCarrier.RuntimeCoordinate.unknown
+			originClient: require_createHibernatableWsServerAdapter.RuntimeCoordinate.unknown
 		}) }, validatedInput, { time: Date.now() });
 	}
 	deserializeInput(serialized) {
@@ -124,27 +124,27 @@ var ActionCore = class extends require_httpAcceptorCarrier.ActionBase {
 //#endregion
 //#region src/utils/isAction_Context_JsonObject.ts
 const isAction_Context_JsonObject = (obj) => {
-	return require_httpAcceptorCarrier.isAction_Base_JsonObject(obj) && obj.form === "context";
+	return require_createHibernatableWsServerAdapter.isAction_Base_JsonObject(obj) && obj.form === "context";
 };
 //#endregion
 //#region src/utils/isAction_Core_JsonObject.ts
 const isAction_Core_JsonObject = (obj) => {
-	return require_httpAcceptorCarrier.isAction_Base_JsonObject(obj) && obj.form === "core";
+	return require_createHibernatableWsServerAdapter.isAction_Base_JsonObject(obj) && obj.form === "core";
 };
 //#endregion
 //#region src/utils/isAction_Any_JsonObject.ts
 function isAction_Any_JsonObject(obj) {
-	return require_httpAcceptorCarrier.isActionPayload_Any_JsonObject(obj) || isAction_Context_JsonObject(obj) || isAction_Core_JsonObject(obj);
+	return require_createHibernatableWsServerAdapter.isActionPayload_Any_JsonObject(obj) || isAction_Context_JsonObject(obj) || isAction_Core_JsonObject(obj);
 }
 //#endregion
 //#region src/utils/assertIsActionJson.ts
 function assertIsActionJson(obj) {
-	if (!isAction_Any_JsonObject(obj)) throw require_httpAcceptorCarrier.err_nice_action.fromId("wire_not_action_data");
+	if (!isAction_Any_JsonObject(obj)) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("wire_not_action_data");
 }
 //#endregion
 //#region src/utils/isAction_Any_Instance.ts
 function isAction_Any_Instance(value) {
-	return value instanceof ActionCore || value instanceof require_httpAcceptorCarrier.ActionPayload || value instanceof ActionContext;
+	return value instanceof ActionCore || value instanceof require_createHibernatableWsServerAdapter.ActionPayload || value instanceof ActionContext;
 }
 //#endregion
 //#region src/ActionDefinition/Domain/ActionDomainBase.ts
@@ -190,7 +190,7 @@ var ActionRuntimeManager = class {
 	}
 	registerRuntime(runtime) {
 		const runtimeId = runtime.coordinate.stringId;
-		if (this._runtimes.has(runtimeId)) throw require_httpAcceptorCarrier.err_nice_action.fromId("client_runtime_already_registered", {
+		if (this._runtimes.has(runtimeId)) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("client_runtime_already_registered", {
 			context: this._context,
 			client: runtime.coordinate
 		});
@@ -209,7 +209,7 @@ var ActionRuntimeManager = class {
 				handler,
 				runtime
 			};
-			if (throwOnIssue) throw require_httpAcceptorCarrier.err_nice_action.fromId("no_action_execution_handler", {
+			if (throwOnIssue) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("no_action_execution_handler", {
 				domain: action.domain,
 				actionId: action.id,
 				specifiedClient: localRuntime.coordinate
@@ -222,7 +222,7 @@ var ActionRuntimeManager = class {
 				runtime
 			};
 		}
-		if (throwOnIssue) throw require_httpAcceptorCarrier.err_nice_action.fromId("no_action_execution_handler", {
+		if (throwOnIssue) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("no_action_execution_handler", {
 			domain: action.domain,
 			actionId: action.id,
 			specifiedClient: options?.targetLocalRuntime?.coordinate
@@ -243,7 +243,7 @@ var ActionRuntimeManager = class {
 		return this._runtimes.values().next().value;
 	}
 	getBestRuntimeForSpecifier(clientSpecifier) {
-		const ids = new require_httpAcceptorCarrier.RuntimeCoordinate(clientSpecifier).toStringIds();
+		const ids = new require_createHibernatableWsServerAdapter.RuntimeCoordinate(clientSpecifier).toStringIds();
 		for (const id of ids) {
 			const runtime = this._runtimes.get(id);
 			if (runtime) return runtime;
@@ -258,10 +258,10 @@ var ActionRuntimeManager = class {
 	getBestRuntimeOrThrow(specifier) {
 		const runtime = this.getBestRuntime(specifier);
 		if (!runtime) {
-			if (specifier == null) throw require_httpAcceptorCarrier.err_nice_action.fromId("no_client_runtimes_registered", { context: this._context });
-			throw require_httpAcceptorCarrier.err_nice_action.fromId("client_runtime_not_registered", {
+			if (specifier == null) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("no_client_runtimes_registered", { context: this._context });
+			throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("client_runtime_not_registered", {
 				context: this._context,
-				clientStringId: require_httpAcceptorCarrier.runtimeCoordinateToStringIds(specifier)[0]
+				clientStringId: require_createHibernatableWsServerAdapter.runtimeCoordinateToStringIds(specifier)[0]
 			});
 		}
 		return runtime;
@@ -283,7 +283,7 @@ var ActionRootDomain = class extends ActionDomainBase {
 		this._actionRuntimeManager = new ActionRuntimeManager({ domain: domainId });
 	}
 	createChildDomain(subDomainDef) {
-		if (this.allDomains.includes(subDomainDef.domain)) throw require_httpAcceptorCarrier.err_nice_action.fromId("domain_already_exists_in_hierarchy", {
+		if (this.allDomains.includes(subDomainDef.domain)) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("domain_already_exists_in_hierarchy", {
 			domain: subDomainDef.domain,
 			allParentDomains: this.allDomains,
 			parentDomain: this.domain
@@ -309,7 +309,7 @@ var ActionRootDomain = class extends ActionDomainBase {
 		try {
 			handlerAndRuntime = this._actionRuntimeManager.getRuntimeAndHandlerForActionOrThrow(actionPayload, options);
 		} catch (err) {
-			const runningAction = new require_httpAcceptorCarrier.RunningAction({
+			const runningAction = new require_createHibernatableWsServerAdapter.RunningAction({
 				context: actionPayload.context,
 				request: actionPayload,
 				callSite: actionPayload._callSite
@@ -352,7 +352,7 @@ var ActionDomain = class ActionDomain extends ActionDomainBase {
 		this._rootDomain._registerRuntime(runtime);
 	}
 	createChildDomain(subDomainDef) {
-		if (this.allDomains.includes(subDomainDef.domain)) throw require_httpAcceptorCarrier.err_nice_action.fromId("domain_already_exists_in_hierarchy", {
+		if (this.allDomains.includes(subDomainDef.domain)) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("domain_already_exists_in_hierarchy", {
 			domain: subDomainDef.domain,
 			allParentDomains: this.allDomains,
 			parentDomain: this.domain
@@ -370,14 +370,14 @@ var ActionDomain = class ActionDomain extends ActionDomainBase {
 		return this._actionMap;
 	}
 	actionForId(id) {
-		if (!this.actionSchema[id]) throw require_httpAcceptorCarrier.err_nice_action.fromId("action_id_not_in_domain", {
+		if (!this.actionSchema[id]) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("action_id_not_in_domain", {
 			domain: this.domain,
 			actionId: id
 		});
 		return new ActionCore(this, id);
 	}
 	wrapAsPartialLocalHandler(wrappedActionExecutor) {
-		const _handler = new require_httpAcceptorCarrier.ActionLocalHandler();
+		const _handler = new require_createHibernatableWsServerAdapter.ActionLocalHandler();
 		const executor = wrappedActionExecutor;
 		for (const actionKey in wrappedActionExecutor) {
 			if (!this.actionSchema[actionKey]) continue;
@@ -386,7 +386,7 @@ var ActionDomain = class ActionDomain extends ActionDomainBase {
 		return _handler;
 	}
 	wrapAsLocalHandler(wrappedActionExecutor) {
-		const _handler = new require_httpAcceptorCarrier.ActionLocalHandler();
+		const _handler = new require_createHibernatableWsServerAdapter.ActionLocalHandler();
 		const executor = wrappedActionExecutor;
 		return _handler.forDomain(this, (request) => executor[request.id](request.input));
 	}
@@ -396,45 +396,45 @@ var ActionDomain = class ActionDomain extends ActionDomainBase {
 			cuid: contextData.cuid,
 			routing: contextData.routing.map((item) => {
 				return {
-					runtime: new require_httpAcceptorCarrier.RuntimeCoordinate(item.runtime),
+					runtime: new require_createHibernatableWsServerAdapter.RuntimeCoordinate(item.runtime),
 					handler: item.handler,
 					time: item.time
 				};
 			}),
-			originClient: contextData.originClient ? new require_httpAcceptorCarrier.RuntimeCoordinate(contextData.originClient) : require_httpAcceptorCarrier.RuntimeCoordinate.unknown
+			originClient: contextData.originClient ? new require_createHibernatableWsServerAdapter.RuntimeCoordinate(contextData.originClient) : require_createHibernatableWsServerAdapter.RuntimeCoordinate.unknown
 		});
 	}
 	isDomainAction(action) {
 		return isAction_Any_Instance(action) && action.domain === this.domain;
 	}
 	hydrateRequestPayload(serialized) {
-		if (serialized.type !== "request") throw require_httpAcceptorCarrier.err_nice_action.fromId("hydration_action_state_mismatch", {
+		if (serialized.type !== "request") throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("hydration_action_state_mismatch", {
 			expected: "request",
 			received: serialized.type
 		});
-		if (serialized.domain !== this.domain) throw require_httpAcceptorCarrier.err_nice_action.fromId("hydration_domain_mismatch", {
+		if (serialized.domain !== this.domain) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("hydration_domain_mismatch", {
 			expected: this.domain,
 			received: serialized.domain
 		});
 		const id = serialized.id;
-		if (!this.actionSchema[id]) throw require_httpAcceptorCarrier.err_nice_action.fromId("hydration_action_id_not_found", {
+		if (!this.actionSchema[id]) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("hydration_action_id_not_found", {
 			domain: this.domain,
 			actionId: serialized.id
 		});
 		const contextAction = this.hydrateContext(id, serialized.context);
-		return new require_httpAcceptorCarrier.ActionPayload_Request({ context: contextAction }, contextAction.deserializeInput(serialized.input), { time: serialized.time });
+		return new require_createHibernatableWsServerAdapter.ActionPayload_Request({ context: contextAction }, contextAction.deserializeInput(serialized.input), { time: serialized.time });
 	}
 	hydrateResultPayload(serialized) {
-		if (serialized.type !== "result") throw require_httpAcceptorCarrier.err_nice_action.fromId("hydration_action_state_mismatch", {
+		if (serialized.type !== "result") throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("hydration_action_state_mismatch", {
 			expected: "result",
 			received: serialized.type
 		});
-		if (serialized.domain !== this.domain) throw require_httpAcceptorCarrier.err_nice_action.fromId("hydration_domain_mismatch", {
+		if (serialized.domain !== this.domain) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("hydration_domain_mismatch", {
 			expected: this.domain,
 			received: serialized.domain
 		});
 		const id = serialized.id;
-		if (!this.actionSchema[id]) throw require_httpAcceptorCarrier.err_nice_action.fromId("hydration_action_id_not_found", {
+		if (!this.actionSchema[id]) throw require_createHibernatableWsServerAdapter.err_nice_action.fromId("hydration_action_id_not_found", {
 			domain: this.domain,
 			actionId: serialized.id
 		});
@@ -443,7 +443,7 @@ var ActionDomain = class ActionDomain extends ActionDomainBase {
 			ok: true,
 			output: contextAction.schema.deserializeOutput(serialized.result.output)
 		} : serialized.result;
-		return new require_httpAcceptorCarrier.ActionPayload_Result({ context: contextAction }, result, { time: serialized.time });
+		return new require_createHibernatableWsServerAdapter.ActionPayload_Result({ context: contextAction }, result, { time: serialized.time });
 	}
 	hydrateAnyAction(actionJson) {
 		assertIsActionJson(actionJson);
@@ -472,275 +472,6 @@ const createActionRootDomain = (definition) => {
 	return new ActionRootDomain(definition);
 };
 //#endregion
-//#region src/ActionRuntime/Transport/codec/actionWireCodec.ts
-/**
-* Tiny integer codes for the payload type, so the verbose `"request"`/`"result"`/`"progress"`
-* strings never hit the wire. The index in {@link ReversePayloadType} must line up with the value.
-*/
-const PayloadTypeToInt = {
-	["request"]: 0,
-	["result"]: 1,
-	["progress"]: 2
-};
-const ReversePayloadType = [
-	"request",
-	"result",
-	"progress"
-];
-/**
-* Build the positional `domain:id` ↔ integer dictionary. Both ends of a channel MUST build it from
-* the same domains in the same order — the mapping is positional, so a mismatch routes to the wrong
-* action. Add new transported domains to the end of the list.
-*/
-function buildActionRouteDictionary(domains) {
-	const routeToInt = /* @__PURE__ */ new Map();
-	const intToRoute = [];
-	for (const dom of domains) for (const actionId of Object.keys(dom.actionSchema)) {
-		const routeKey = `${dom.domain}:${actionId}`;
-		if (routeToInt.has(routeKey)) continue;
-		routeToInt.set(routeKey, intToRoute.length);
-		intToRoute.push({
-			domain: dom.domain,
-			id: actionId,
-			allDomains: dom.allDomains
-		});
-	}
-	return {
-		routeToInt,
-		intToRoute
-	};
-}
-/** Pull the type-specific payload (`input` / `result` / `progress`) out of a wire JSON object. */
-function extractWirePayload(json) {
-	if (json.type === "request") return json.input;
-	if (json.type === "result") return json.result;
-	if (json.type === "progress") return json.progress;
-}
-/**
-* Reassemble a full wire JSON object from its decoded parts. `inputHash`/`outputHash` are emitted
-* empty — the hydration constructors recompute them — and the result still satisfies
-* `isActionPayload_Any_JsonObject` so it flows through validation like a JSON frame.
-*/
-function assembleWireJson(routeMeta, payloadType, time, context, payloadData) {
-	const base = {
-		form: "data",
-		domain: routeMeta.domain,
-		id: routeMeta.id,
-		allDomains: routeMeta.allDomains,
-		time,
-		context
-	};
-	if (payloadType === "request") return {
-		...base,
-		type: "request",
-		input: payloadData,
-		inputHash: ""
-	};
-	if (payloadType === "result") return {
-		...base,
-		type: "result",
-		result: payloadData,
-		outputHash: ""
-	};
-	return {
-		...base,
-		type: "progress",
-		progress: payloadData
-	};
-}
-//#endregion
-//#region src/ActionRuntime/Transport/codec/createBinaryWireSessionFactory.ts
-/**
-* Positional layout of the *session* binary envelope — the leanest frame. Compared to the stateless
-* adapter it replaces the 21-char `cuid` with a small per-connection integer and only carries
-* `originClient` on the very first request of each direction (the peer remembers it afterwards).
-*
-*   [ routeInt, typeInt, corrId, time, originClient?, payloadData ]
-*/
-const ENVELOPE$1 = {
-	route: 0,
-	type: 1,
-	corr: 2,
-	time: 3,
-	originClient: 4,
-	payload: 5
-};
-const ENVELOPE_LENGTH$1 = 6;
-/**
-* How long a pending correlation entry is kept before it's swept. A correlation only matters until its
-* action resolves or times out, so anything older than the longest realistic action timeout can be
-* dropped — this bounds memory when requests time out or a connection dies mid-flight (their replies
-* would never arrive, leaving the entry orphaned). Generous default so live correlations are never
-* pruned (the default transport timeout is 10s).
-*/
-const DEFAULT_CORRELATION_TTL_MS = 5 * 6e4;
-function isKnownIdentity(coordinate) {
-	return coordinate != null && coordinate.envId !== "_unset_";
-}
-/**
-* Drop entries older than `ttlMs`. Maps keep insertion order and entries are inserted in time order,
-* so the oldest are first — stop sweeping at the first live entry.
-*/
-function pruneExpired(map, now, ttlMs) {
-	for (const [key, entry] of map) {
-		if (now - entry.time <= ttlMs) break;
-		map.delete(key);
-	}
-}
-/**
-* Builds a factory of *stateful, per-connection* codecs for {@link LinkTransport} /
-* `AcceptorHandler` — the maximally compact binary wire. Call the returned factory once per live
-* connection (each socket on the client, each accepted connection on the server) so every channel
-* gets its own correlation + identity state.
-*
-* On top of everything {@link createBinaryWireAdapter} drops, a session also drops:
-* - **`cuid`** — replaced by a per-connection integer correlation id. The initiator maps it to its
-*   real cuid; the responder echoes it; each side reconstructs the cuid from its own map. Correlation
-*   only needs to be unique per socket, so a counter suffices.
-* - **`originClient` after the first request** — the first request each side sends carries its
-*   identity; the peer remembers it and injects it into later frames. Replies omit it entirely (a
-*   reply carries the initiator's own origin, which the initiator already knows).
-*
-* Both ends MUST build the factory from the same domains in the same order (positional dictionary).
-* Text frames still return `undefined` from `incoming`, so JSON clients remain interoperable.
-*
-* Hibernation note: after a server connection is evicted its session resets, so a still-connected
-* client (whose session persists) will keep omitting `originClient`. The server must therefore restore
-* the connection→client binding from its own store (see `AcceptorHandler.rehydrateConnection`) and
-* inject `originClient` from there — the session alone can't recover it.
-*/
-function createBinaryWireSessionFactory(domains, options) {
-	const { routeToInt, intToRoute } = buildActionRouteDictionary(domains);
-	const unknownIdentity = require_httpAcceptorCarrier.RuntimeCoordinate.unknown.toJsonObject();
-	const ttlMs = options?.correlationTtlMs ?? DEFAULT_CORRELATION_TTL_MS;
-	return () => {
-		let outCounter = 0;
-		const corrToCuid = /* @__PURE__ */ new Map();
-		const cuidToCorr = /* @__PURE__ */ new Map();
-		let selfIdentity;
-		let peerIdentity;
-		return {
-			outgoing: (input) => {
-				const json = input.action.toJsonObject();
-				const routeKey = `${json.domain}:${json.id}`;
-				const routeInt = routeToInt.get(routeKey);
-				if (routeInt == null) throw new Error(`[binary-wire] Cannot pack unregistered action route: ${routeKey}`);
-				const now = Date.now();
-				pruneExpired(corrToCuid, now, ttlMs);
-				pruneExpired(cuidToCorr, now, ttlMs);
-				let corr;
-				let wireIdentity;
-				if (json.type === "request") {
-					corr = outCounter++;
-					corrToCuid.set(corr, {
-						value: json.context.cuid,
-						time: now
-					});
-					if (selfIdentity == null && isKnownIdentity(json.context.originClient)) {
-						selfIdentity = json.context.originClient;
-						wireIdentity = json.context.originClient;
-					}
-				} else {
-					corr = cuidToCorr.get(json.context.cuid)?.value ?? -1;
-					if (json.type === "result") cuidToCorr.delete(json.context.cuid);
-				}
-				const envelope = new Array(ENVELOPE_LENGTH$1);
-				envelope[ENVELOPE$1.route] = routeInt;
-				envelope[ENVELOPE$1.type] = PayloadTypeToInt[json.type];
-				envelope[ENVELOPE$1.corr] = corr;
-				envelope[ENVELOPE$1.time] = json.time;
-				envelope[ENVELOPE$1.originClient] = wireIdentity;
-				envelope[ENVELOPE$1.payload] = extractWirePayload(json);
-				return (0, msgpackr.pack)(envelope);
-			},
-			incoming: (frame) => {
-				let buffer;
-				if (frame instanceof ArrayBuffer) buffer = new Uint8Array(frame);
-				else if (frame instanceof Uint8Array) buffer = frame;
-				else return;
-				try {
-					const envelope = (0, msgpackr.unpack)(buffer);
-					if (!Array.isArray(envelope) || envelope.length !== ENVELOPE_LENGTH$1) return void 0;
-					const routeMeta = intToRoute[envelope[ENVELOPE$1.route]];
-					const payloadType = ReversePayloadType[envelope[ENVELOPE$1.type]];
-					if (routeMeta == null || payloadType == null) return void 0;
-					const now = Date.now();
-					pruneExpired(corrToCuid, now, ttlMs);
-					pruneExpired(cuidToCorr, now, ttlMs);
-					const corr = envelope[ENVELOPE$1.corr];
-					const time = envelope[ENVELOPE$1.time];
-					const wireIdentity = envelope[ENVELOPE$1.originClient];
-					let cuid;
-					let originClient;
-					if (payloadType === "request") {
-						cuid = (0, nanoid.nanoid)();
-						cuidToCorr.set(cuid, {
-							value: corr,
-							time: now
-						});
-						if (isKnownIdentity(wireIdentity)) peerIdentity = wireIdentity;
-						originClient = peerIdentity ?? unknownIdentity;
-					} else {
-						cuid = corrToCuid.get(corr)?.value ?? (0, nanoid.nanoid)();
-						if (payloadType === "result") corrToCuid.delete(corr);
-						originClient = selfIdentity ?? unknownIdentity;
-					}
-					return assembleWireJson(routeMeta, payloadType, time, {
-						cuid,
-						timeCreated: time,
-						routing: [],
-						originClient
-					}, envelope[ENVELOPE$1.payload]);
-				} catch (e) {
-					console.error("[binary-wire] Failed to unpack binary action session frame", e);
-					return;
-				}
-			}
-		};
-	};
-}
-//#endregion
-//#region src/ActionRuntime/Channel/secureChannel.ts
-/**
-* Derive a stable wire-dictionary version from the ordered route list (FNV-1a over `domain:id,…`), so
-* the version moves automatically whenever the transported domains change — a stale peer is then
-* rejected by the handshake instead of silently misrouting a positionally-packed frame.
-*/
-function deriveDictionaryVersion(domains) {
-	const { intToRoute } = buildActionRouteDictionary(domains);
-	const signature = intToRoute.map((route) => `${route.domain}:${route.id}`).join(",");
-	let hash = 2166136261;
-	for (let i = 0; i < signature.length; i++) {
-		hash ^= signature.charCodeAt(i);
-		hash = Math.imul(hash, 16777619);
-	}
-	return `auto:${(hash >>> 0).toString(16).padStart(8, "0")}`;
-}
-/**
-* Bundle a secure channel's shared identity from its transported domains. Both ends MUST call this
-* with the same domains in the same order (the binary wire dictionary is positional). The
-* `dictionaryVersion` is derived from those domains unless you pin an explicit one.
-*
-* Declare the domains *by role* — `toAcceptor` (connector→acceptor requests) and `toConnector`
-* (acceptor→connector pushes) — so the routing for both ends is derived from the channel (see
-* {@link connectChannel} and `acceptChannelConnections`) instead of being restated at each end. The
-* wire dictionary spans `[...toAcceptor, ...toConnector]` in that order; add new domains to the end of
-* their list to keep older peers compatible. (`domains` is still accepted as a legacy alias for
-* `toAcceptor`.)
-*/
-function defineSecureChannel(options) {
-	const base = require_httpAcceptorCarrier.defineChannel({
-		toAcceptor: options.toAcceptor,
-		toConnector: options.toConnector
-	});
-	const allDomains = [...base.toAcceptorDomains, ...base.toConnectorDomains];
-	return {
-		...base,
-		dictionaryVersion: options.dictionaryVersion ?? deriveDictionaryVersion(allDomains),
-		createCodec: createBinaryWireSessionFactory(allDomains, options.sessionOptions)
-	};
-}
-//#endregion
 //#region src/ActionRuntime/Transport/Carrier/duplex/inMemory/createInMemoryChannel.ts
 /**
 * Two cross-wired in-process byte channels — a loopback carrier with no socket. The client end is a
@@ -798,9 +529,8 @@ function createInMemoryChannelPair() {
 //#region src/ActionRuntime/Transport/Carrier/duplex/inMemory/inMemoryCarrier.ts
 /**
 * A loopback duplex carrier with no socket — two cross-wired in-process ends. The connector end is an
-* {@link IDuplexCarrierSource} for {@link secureTransport}; the acceptor end plugs into an
-* `AcceptorHandler`. Ideal for tests and for running two runtimes in one process, or proving a
-* non-WS carrier end to end.
+* {@link IDuplexCarrierSource} for `connectChannel`; the acceptor end plugs into an `AcceptorHandler`.
+* Ideal for tests and for running two runtimes in one process, or proving a non-WS carrier end to end.
 */
 function inMemoryCarrier() {
 	const { clientChannel, serverEndpoint } = createInMemoryChannelPair();
@@ -886,8 +616,8 @@ async function normalizeFrame$1(data) {
 //#region src/ActionRuntime/Transport/Carrier/duplex/rtc/rtcCarrier.ts
 /**
 * A WebRTC {@link IDuplexCarrierSource} over an already-negotiated `RTCDataChannel` (signaling is the
-* app's concern). Hand it to {@link secureTransport} so two browsers/apps linked peer-to-peer run the
-* identical secure session as a WebSocket.
+* app's concern). Pass it as a `carrier` to `connectChannel` so two browsers/apps linked peer-to-peer run
+* the identical secure session as a WebSocket.
 */
 function rtcCarrier(dataChannel, options = {}) {
 	return {
@@ -905,7 +635,7 @@ let EErrId_NiceTransport_WebSocket = /* @__PURE__ */ function(EErrId_NiceTranspo
 	EErrId_NiceTransport_WebSocket["ws_error"] = "ws_error";
 	return EErrId_NiceTransport_WebSocket;
 }({});
-const err_nice_transport_ws = require_httpAcceptorCarrier.err_nice_transport.createChildDomain({
+const err_nice_transport_ws = require_createHibernatableWsServerAdapter.err_nice_transport.createChildDomain({
 	domain: "ws_transport",
 	schema: {
 		["ws_disconnected"]: (0, _nice_code_error.err)({ message: () => `WebSocket transport disconnected.` }),
@@ -1004,20 +734,26 @@ async function normalizeFrame(data) {
 //#endregion
 //#region src/ActionRuntime/Transport/Carrier/duplex/ws/wsCarrier.ts
 /**
-* A WebSocket {@link IDuplexCarrierSource}: opens an `arraybuffer` socket to `url` (cached per endpoint)
-* and adapts it to a carrier. Hand it to {@link secureTransport} (or `LinkTransport`) — the WebSocket is
-* now "just another carrier" under the shared secure session, with no WS-specific transport class.
+* A WebSocket {@link IDuplexCarrierSource}: opens an `arraybuffer` socket (cached per endpoint) and adapts
+* it to a carrier. Pass it as a `carrier` to `connectChannel` — the WebSocket is now "just another
+* carrier" under the shared secure session, with no WS-specific transport class.
+*
+* `createRequest` derives the socket URL per action (keep it simple with `() => ({ url })`), so dynamic
+* endpoints (e.g. a per-run query param) need no `createWebSocket` escape hatch.
 */
-function wsCarrier(url, options = {}) {
+function wsCarrier(createRequest, options = {}) {
 	return {
 		carrierLabel: "ws",
-		open: (input) => webSocketByteChannel(options.createWebSocket?.(input) ?? defaultWebSocket(url)),
-		getCacheKey: options.getTransportCacheKey ?? (() => [url]),
-		getRouteInfo: options.getRouteInfo ?? (() => ({
-			carrierLabel: "ws",
-			url,
-			summary: `ws ${shortWs(url)}`
-		}))
+		open: (input) => webSocketByteChannel(defaultWebSocket(createRequest(input).url)),
+		getCacheKey: options.getTransportCacheKey ?? ((input) => [createRequest(input).url]),
+		getRouteInfo: options.getRouteInfo ?? ((input) => {
+			const { url } = createRequest(input);
+			return {
+				carrierLabel: "ws",
+				url,
+				summary: `ws ${shortWs(url)}`
+			};
+		})
 	};
 }
 function defaultWebSocket(url) {
@@ -1036,9 +772,10 @@ function shortPath(url) {
 }
 /**
 * An HTTP {@link IExchangeCarrierSource}: each `exchange` POSTs one frame body to the action endpoint and
-* resolves with the response body as the single correlated reply. Hand it to {@link secureTransport} —
-* HTTP then runs the *same* secure session as a duplex carrier (handshake → token → encrypted frames),
-* the request/reply correlation provided for free by the HTTP transaction.
+* resolves with the response body as the single correlated reply. Pass it as a `carrier` to
+* `connectChannel` — a secure HTTP transport then runs the *same* secure session as a duplex carrier
+* (handshake → token → encrypted frames), the request/reply correlation provided for free by the HTTP
+* transaction.
 *
 * `createRequest` derives the URL/headers per action (keep it simple with `() => ({ url })`). The body is
 * the session's responsibility, so it is never built here.
@@ -1078,160 +815,49 @@ function httpCarrier(createRequest, options = {}) {
 	};
 }
 //#endregion
-//#region src/ActionRuntime/Transport/codec/createBinaryWireAdapter.ts
-/**
-* Positional layout of the stateless binary envelope. A flat tuple (rather than an object) strips the
-* repeated `domain`/`id`/`form`/`type` and context key names from every frame, and we carry only the
-* context fields the receiver can't recompute: `cuid` (correlation) and `originClient` (return
-* routing).
-*
-*   [ routeInt, typeInt, time, cuid, originClient, payloadData ]
-*
-* Dropped vs the JSON wire: `form`/`type` strings, `inputHash`/`outputHash` (recomputed on hydrate),
-* `context.timeCreated` (reconstructed from `time`) and `context.routing` (rebuilt empty — the
-* receiver re-stamps its own route items as it handles the action). For the leanest possible frames
-* (integer correlation, identity dropped after a handshake), use `createBinaryWireSessionFactory`.
-*/
-const ENVELOPE = {
-	route: 0,
-	type: 1,
-	time: 2,
-	cuid: 3,
-	originClient: 4,
-	payload: 5
-};
-const ENVELOPE_LENGTH = 6;
-/**
-* Builds a *stateless* `formatMessage` pipeline for {@link LinkTransport}, packing action
-* payloads into a compact msgpackr binary frame instead of JSON. The `domain`/`id` route collapses to
-* a single integer drawn from a shared dictionary; `form`/`type`, the recomputable
-* `inputHash`/`outputHash`, and the per-frame `context.routing`/`context.timeCreated` are all dropped
-* (see {@link ENVELOPE}).
-*
-* No validation runs here: `incoming` blindly reconstructs the wire JSON shape and hands it back to
-* the connection, which flows into `ActionRuntime` → `domain.hydrateAnyAction()` where the Valibot
-* schemas validate it exactly as they would for a JSON frame.
-*
-* Both ends of the socket MUST construct the adapter with the same domains in the same order — the
-* integer dictionary is positional. Mismatched dictionaries will route to the wrong action.
-*
-* Because `incoming` returns `undefined` for text frames, a binary server can still serve plain-JSON
-* clients on the same runtime (the connection falls back to its built-in JSON parser).
-*/
-function createBinaryWireAdapter(domains) {
-	const { routeToInt, intToRoute } = buildActionRouteDictionary(domains);
-	return {
-		outgoing: (input) => {
-			const json = input.action.toJsonObject();
-			const routeKey = `${json.domain}:${json.id}`;
-			const routeInt = routeToInt.get(routeKey);
-			if (routeInt == null) throw new Error(`[binary-wire] Cannot pack unregistered action route: ${routeKey}`);
-			const envelope = new Array(ENVELOPE_LENGTH);
-			envelope[ENVELOPE.route] = routeInt;
-			envelope[ENVELOPE.type] = PayloadTypeToInt[json.type];
-			envelope[ENVELOPE.time] = json.time;
-			envelope[ENVELOPE.cuid] = json.context.cuid;
-			envelope[ENVELOPE.originClient] = json.context.originClient;
-			envelope[ENVELOPE.payload] = extractWirePayload(json);
-			return (0, msgpackr.pack)(envelope);
-		},
-		incoming: (frame) => {
-			let buffer;
-			if (frame instanceof ArrayBuffer) buffer = new Uint8Array(frame);
-			else if (frame instanceof Uint8Array) buffer = frame;
-			else return;
-			try {
-				const envelope = (0, msgpackr.unpack)(buffer);
-				if (!Array.isArray(envelope) || envelope.length !== ENVELOPE_LENGTH) return void 0;
-				const routeMeta = intToRoute[envelope[ENVELOPE.route]];
-				const payloadType = ReversePayloadType[envelope[ENVELOPE.type]];
-				if (routeMeta == null || payloadType == null) return void 0;
-				const time = envelope[ENVELOPE.time];
-				return assembleWireJson(routeMeta, payloadType, time, {
-					cuid: envelope[ENVELOPE.cuid],
-					timeCreated: time,
-					routing: [],
-					originClient: envelope[ENVELOPE.originClient]
-				}, envelope[ENVELOPE.payload]);
-			} catch (e) {
-				console.error("[binary-wire] Failed to unpack binary action frame", e);
-				return;
-			}
-		}
-	};
-}
-//#endregion
-exports.AcceptorHandler = require_httpAcceptorCarrier.AcceptorHandler;
 exports.ActionCore = ActionCore;
 exports.ActionDomain = ActionDomain;
-exports.ActionLocalHandler = require_httpAcceptorCarrier.ActionLocalHandler;
+exports.ActionLocalHandler = require_createHibernatableWsServerAdapter.ActionLocalHandler;
 exports.ActionRootDomain = ActionRootDomain;
-exports.ActionRuntime = require_httpAcceptorCarrier.ActionRuntime;
-exports.ActionSchema = require_httpAcceptorCarrier.ActionSchema;
-exports.ConnectionStateStore = require_httpAcceptorCarrier.ConnectionStateStore;
-exports.ConnectorHandler = require_httpAcceptorCarrier.ConnectorHandler;
-exports.EActionPayloadType = require_httpAcceptorCarrier.EActionPayloadType;
-exports.EActionProgressType = require_httpAcceptorCarrier.EActionProgressType;
-exports.EActionResponseMode = require_httpAcceptorCarrier.EActionResponseMode;
-exports.EErrId_NiceAction = require_httpAcceptorCarrier.EErrId_NiceAction;
-exports.EErrId_NiceTransport = require_httpAcceptorCarrier.EErrId_NiceTransport;
+exports.ActionRuntime = require_createHibernatableWsServerAdapter.ActionRuntime;
+exports.ActionSchema = require_createHibernatableWsServerAdapter.ActionSchema;
+exports.EActionPayloadType = require_createHibernatableWsServerAdapter.EActionPayloadType;
+exports.EActionProgressType = require_createHibernatableWsServerAdapter.EActionProgressType;
+exports.EActionResponseMode = require_createHibernatableWsServerAdapter.EActionResponseMode;
+exports.EErrId_NiceAction = require_createHibernatableWsServerAdapter.EErrId_NiceAction;
+exports.EErrId_NiceTransport = require_createHibernatableWsServerAdapter.EErrId_NiceTransport;
 exports.EErrId_NiceTransport_WebSocket = EErrId_NiceTransport_WebSocket;
-exports.EHandshakeMessageType = require_httpAcceptorCarrier.EHandshakeMessageType;
 exports.ERunningActionFinishedType = require_RunningAction_types.ERunningActionFinishedType;
 exports.ERunningActionState = require_RunningAction_types.ERunningActionState;
 exports.ERunningActionUpdateType = require_RunningAction_types.ERunningActionUpdateType;
-exports.ESecurityLevel = require_httpAcceptorCarrier.ESecurityLevel;
-exports.ETransportShape = require_httpAcceptorCarrier.ETransportShape;
-exports.ETransportStatus = require_httpAcceptorCarrier.ETransportStatus;
-exports.ExchangeAcceptor = require_httpAcceptorCarrier.ExchangeAcceptor;
-exports.ExchangeTransport = require_httpAcceptorCarrier.ExchangeTransport;
-exports.LinkTransport = require_httpAcceptorCarrier.LinkTransport;
-exports.PeerLinkHandler = require_httpAcceptorCarrier.PeerLinkHandler;
-exports.RunningAction = require_httpAcceptorCarrier.RunningAction;
-exports.RuntimeCoordinate = require_httpAcceptorCarrier.RuntimeCoordinate;
-exports.Transport = require_httpAcceptorCarrier.Transport;
+exports.ESecurityLevel = require_createHibernatableWsServerAdapter.ESecurityLevel;
+exports.RunningAction = require_createHibernatableWsServerAdapter.RunningAction;
+exports.RuntimeCoordinate = require_createHibernatableWsServerAdapter.RuntimeCoordinate;
 exports.acceptChannel = require_httpAcceptorCarrier.acceptChannel;
 exports.acceptChannelConnections = require_httpAcceptorCarrier.acceptChannelConnections;
-exports.actionSchema = require_httpAcceptorCarrier.actionSchema;
+exports.actionSchema = require_createHibernatableWsServerAdapter.actionSchema;
 exports.connectChannel = require_httpAcceptorCarrier.connectChannel;
-exports.createAcceptorHandler = require_httpAcceptorCarrier.createAcceptorHandler;
-exports.createActionFetchHandler = require_httpAcceptorCarrier.createActionFetchHandler;
-exports.createActionFrameCrypto = require_httpAcceptorCarrier.createActionFrameCrypto;
 exports.createActionRootDomain = createActionRootDomain;
-exports.createBinaryWireAdapter = createBinaryWireAdapter;
-exports.createBinaryWireSessionFactory = createBinaryWireSessionFactory;
-exports.createClientHandshake = require_httpAcceptorCarrier.createClientHandshake;
-exports.createConnectionStateStore = require_httpAcceptorCarrier.createConnectionStateStore;
-exports.createConnectorHandler = require_httpAcceptorCarrier.createConnectorHandler;
-exports.createHibernatableWsServerAdapter = require_httpAcceptorCarrier.createHibernatableWsServerAdapter;
 exports.createInMemoryChannelPair = createInMemoryChannelPair;
-exports.createInMemoryTofuVerifyKeyResolver = require_httpAcceptorCarrier.createInMemoryTofuVerifyKeyResolver;
-exports.createLocalHandler = require_httpAcceptorCarrier.createLocalHandler;
-exports.createSecureAcceptorHandler = require_httpAcceptorCarrier.createSecureAcceptorHandler;
-exports.createServerHandshake = require_httpAcceptorCarrier.createServerHandshake;
-exports.createStorageTofuVerifyKeyResolver = require_httpAcceptorCarrier.createStorageTofuVerifyKeyResolver;
-exports.decodeActionFrame = require_httpAcceptorCarrier.decodeActionFrame;
-exports.decodeExchangeReply = require_httpAcceptorCarrier.decodeExchangeReply;
-exports.decodeExchangeRequest = require_httpAcceptorCarrier.decodeExchangeRequest;
-exports.decodeHandshakeMessage = require_httpAcceptorCarrier.decodeHandshakeMessage;
+exports.createInMemoryTofuVerifyKeyResolver = require_createHibernatableWsServerAdapter.createInMemoryTofuVerifyKeyResolver;
+exports.createLocalHandler = require_createHibernatableWsServerAdapter.createLocalHandler;
+exports.createStorageTofuVerifyKeyResolver = require_createHibernatableWsServerAdapter.createStorageTofuVerifyKeyResolver;
+exports.decodeActionFrame = require_createHibernatableWsServerAdapter.decodeActionFrame;
 exports.defineChannel = require_httpAcceptorCarrier.defineChannel;
-exports.defineSecureChannel = defineSecureChannel;
-exports.encodeExchange = require_httpAcceptorCarrier.encodeExchange;
-exports.encodeHandshakeMessage = require_httpAcceptorCarrier.encodeHandshakeMessage;
-exports.err_nice_action = require_httpAcceptorCarrier.err_nice_action;
-exports.err_nice_external_client = require_httpAcceptorCarrier.err_nice_external_client;
-exports.err_nice_transport = require_httpAcceptorCarrier.err_nice_transport;
+exports.err_nice_action = require_createHibernatableWsServerAdapter.err_nice_action;
+exports.err_nice_external_client = require_createHibernatableWsServerAdapter.err_nice_external_client;
+exports.err_nice_transport = require_createHibernatableWsServerAdapter.err_nice_transport;
 exports.err_nice_transport_ws = err_nice_transport_ws;
 exports.httpAcceptorCarrier = require_httpAcceptorCarrier.httpAcceptorCarrier;
 exports.httpCarrier = httpCarrier;
 exports.inMemoryCarrier = inMemoryCarrier;
-exports.isActionPayload_Any_JsonObject = require_httpAcceptorCarrier.isActionPayload_Any_JsonObject;
-exports.isActionPayload_Request_JsonObject = require_httpAcceptorCarrier.isActionPayload_Request_JsonObject;
-exports.isActionPayload_Result_JsonObject = require_httpAcceptorCarrier.isActionPayload_Result_JsonObject;
+exports.isActionPayload_Any_JsonObject = require_createHibernatableWsServerAdapter.isActionPayload_Any_JsonObject;
+exports.isActionPayload_Request_JsonObject = require_createHibernatableWsServerAdapter.isActionPayload_Request_JsonObject;
+exports.isActionPayload_Result_JsonObject = require_createHibernatableWsServerAdapter.isActionPayload_Result_JsonObject;
 exports.isExchangeAcceptorCarrier = require_httpAcceptorCarrier.isExchangeAcceptorCarrier;
 exports.rtcCarrier = rtcCarrier;
 exports.rtcDataChannelByteChannel = rtcDataChannelByteChannel;
-exports.runtimeLinkId = require_httpAcceptorCarrier.runtimeLinkId;
+exports.runtimeLinkId = require_createHibernatableWsServerAdapter.runtimeLinkId;
 exports.serveChannel = require_httpAcceptorCarrier.serveChannel;
 exports.serveHost = require_httpAcceptorCarrier.serveHost;
 exports.wsAcceptorCarrier = require_httpAcceptorCarrier.wsAcceptorCarrier;