@openclaw/gateway-protocol 0.0.0 → 2026.7.2-beta.5

package/dist/startup-unavailable.d.mts

@@ -0,0 +1,23 @@
+//#region src/startup-unavailable.d.ts
+/** Structured error reason used while gateway startup sidecars are still initializing. */
+declare const GATEWAY_STARTUP_UNAVAILABLE_REASON = "startup-sidecars";
+/** Internal close cause that distinguishes startup retry closes from generic disconnects. */
+declare const GATEWAY_STARTUP_PENDING_CLOSE_CAUSE = "startup-sidecars-pending";
+/** WebSocket close code for temporary gateway unavailability. */
+declare const GATEWAY_STARTUP_CLOSE_CODE = 1013;
+/** Human-readable WebSocket close reason for temporary gateway startup unavailability. */
+declare const GATEWAY_STARTUP_CLOSE_REASON = "gateway starting";
+/** Default retry-after hint sent with startup-unavailable handshake errors. */
+declare const GATEWAY_STARTUP_RETRY_AFTER_MS = 500;
+/** Details payload attached to retryable startup-unavailable gateway errors. */
+type GatewayStartupUnavailableDetails = {
+  reason: typeof GATEWAY_STARTUP_UNAVAILABLE_REASON;
+};
+/** Builds the canonical startup-unavailable details payload. */
+declare function gatewayStartupUnavailableDetails(): GatewayStartupUnavailableDetails;
+/** Detects the structured retryable error emitted while startup sidecars are pending. */
+declare function isRetryableGatewayStartupUnavailableError(error: unknown): boolean;
+/** Resolves a bounded retry-after delay from a startup-unavailable error. */
+declare function resolveGatewayStartupRetryAfterMs(error: unknown): number | null;
+//#endregion
+export { GATEWAY_STARTUP_CLOSE_CODE, GATEWAY_STARTUP_CLOSE_REASON, GATEWAY_STARTUP_PENDING_CLOSE_CAUSE, GATEWAY_STARTUP_RETRY_AFTER_MS, GATEWAY_STARTUP_UNAVAILABLE_REASON, gatewayStartupUnavailableDetails, isRetryableGatewayStartupUnavailableError, resolveGatewayStartupRetryAfterMs };

package/dist/startup-unavailable.mjs

@@ -0,0 +1,34 @@
+//#region src/startup-unavailable.ts
+/** Structured error reason used while gateway startup sidecars are still initializing. */
+const GATEWAY_STARTUP_UNAVAILABLE_REASON = "startup-sidecars";
+/** Internal close cause that distinguishes startup retry closes from generic disconnects. */
+const GATEWAY_STARTUP_PENDING_CLOSE_CAUSE = "startup-sidecars-pending";
+/** WebSocket close code for temporary gateway unavailability. */
+const GATEWAY_STARTUP_CLOSE_CODE = 1013;
+/** Human-readable WebSocket close reason for temporary gateway startup unavailability. */
+const GATEWAY_STARTUP_CLOSE_REASON = "gateway starting";
+/** Default retry-after hint sent with startup-unavailable handshake errors. */
+const GATEWAY_STARTUP_RETRY_AFTER_MS = 500;
+const GATEWAY_STARTUP_RETRY_MIN_MS = 100;
+const GATEWAY_STARTUP_RETRY_MAX_MS = 2e3;
+/** Builds the canonical startup-unavailable details payload. */
+function gatewayStartupUnavailableDetails() {
+	return { reason: GATEWAY_STARTUP_UNAVAILABLE_REASON };
+}
+function isGatewayStartupUnavailableDetails(details) {
+	return typeof details === "object" && details !== null && details.reason === "startup-sidecars";
+}
+/** Detects the structured retryable error emitted while startup sidecars are pending. */
+function isRetryableGatewayStartupUnavailableError(error) {
+	if (!error || typeof error !== "object") return false;
+	const shaped = error;
+	return (shaped.gatewayCode ?? shaped.code) === "UNAVAILABLE" && shaped.retryable === true && isGatewayStartupUnavailableDetails(shaped.details);
+}
+/** Resolves a bounded retry-after delay from a startup-unavailable error. */
+function resolveGatewayStartupRetryAfterMs(error) {
+	if (!isRetryableGatewayStartupUnavailableError(error)) return null;
+	const retryAfterMs = error.retryAfterMs;
+	return Math.min(Math.max(Math.floor(typeof retryAfterMs === "number" && Number.isFinite(retryAfterMs) ? retryAfterMs : 500), GATEWAY_STARTUP_RETRY_MIN_MS), GATEWAY_STARTUP_RETRY_MAX_MS);
+}
+//#endregion
+export { GATEWAY_STARTUP_CLOSE_CODE, GATEWAY_STARTUP_CLOSE_REASON, GATEWAY_STARTUP_PENDING_CLOSE_CAUSE, GATEWAY_STARTUP_RETRY_AFTER_MS, GATEWAY_STARTUP_UNAVAILABLE_REASON, gatewayStartupUnavailableDetails, isRetryableGatewayStartupUnavailableError, resolveGatewayStartupRetryAfterMs };

package/dist/version-COV9CEyr.d.mts

@@ -0,0 +1,11 @@
+//#region src/version.d.ts
+/** Current gateway protocol version emitted by modern clients and servers. */
+declare const PROTOCOL_VERSION: 4;
+/** Lowest general client protocol version accepted by the gateway. */
+declare const MIN_CLIENT_PROTOCOL_VERSION: 4;
+/** Lowest authenticated node protocol version accepted by the gateway. */
+declare const MIN_NODE_PROTOCOL_VERSION: 3;
+/** Lowest lightweight probe protocol version accepted by the gateway. */
+declare const MIN_PROBE_PROTOCOL_VERSION: 3;
+//#endregion
+export { PROTOCOL_VERSION as i, MIN_NODE_PROTOCOL_VERSION as n, MIN_PROBE_PROTOCOL_VERSION as r, MIN_CLIENT_PROTOCOL_VERSION as t };

package/dist/version.d.mts

@@ -0,0 +1,2 @@
+import { i as PROTOCOL_VERSION, n as MIN_NODE_PROTOCOL_VERSION, r as MIN_PROBE_PROTOCOL_VERSION, t as MIN_CLIENT_PROTOCOL_VERSION } from "./version-COV9CEyr.mjs";
+export { MIN_CLIENT_PROTOCOL_VERSION, MIN_NODE_PROTOCOL_VERSION, MIN_PROBE_PROTOCOL_VERSION, PROTOCOL_VERSION };

package/dist/version.mjs

@@ -0,0 +1,11 @@
+//#region src/version.ts
+/** Current gateway protocol version emitted by modern clients and servers. */
+const PROTOCOL_VERSION = 4;
+/** Lowest general client protocol version accepted by the gateway. */
+const MIN_CLIENT_PROTOCOL_VERSION = 4;
+/** Lowest authenticated node protocol version accepted by the gateway. */
+const MIN_NODE_PROTOCOL_VERSION = 3;
+/** Lowest lightweight probe protocol version accepted by the gateway. */
+const MIN_PROBE_PROTOCOL_VERSION = 3;
+//#endregion
+export { MIN_CLIENT_PROTOCOL_VERSION, MIN_NODE_PROTOCOL_VERSION, MIN_PROBE_PROTOCOL_VERSION, PROTOCOL_VERSION };