@openclaw/gateway-client 2026.9.3 → 2026.9.4

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { A as readAssistantStreamSegmentIdentity, C as isSessionProjectionErrorMessage, D as SessionMessageEnvelope, E as reduceSessionProjectionRunEvent, F as buildDeviceAuthPayload, I as buildDeviceAuthPayloadV3, L as normalizeDeviceMetadataForAuth, M as readSessionMessageSequence, N as gatewayCredentialScope, O as SessionMessageIdentity, P as gatewayOriginScope, S as reduceSessionProjection, T as SessionProjectionRunTransition, _ as hasSessionProjectionAcceptedFinal, a as GatewaySessionMessageSubscriptionOptions, b as readSessionProjectionFinalMessageIdentity, c as resetGatewaySessionMessageSubscriptionCoordinator, d as SessionProjectionRun, f as SessionProjectionRunStatus, g as createSessionProjection, h as SessionProjectionState, i as GatewaySessionMessageSubscriptionCoordinatorOptions, j as readSessionMessageIdentity, k as normalizeSessionProjectionRunId, l as SessionProjectionEntry, m as SessionProjectionSnapshotOptions, n as GatewaySessionMessageSubscription, o as getGatewaySessionMessageSubscriptionCoordinator, p as SessionProjectionScope, r as GatewaySessionMessageSubscriptionCoordinator, s as releaseGatewaySessionMessageSubscription, t as GatewaySessionMessageRequestClient, u as SessionProjectionEvent, v as isLocallyOptimisticSessionMessage, w as SessionProjectionGatewayRunEvent, x as reconcileSessionProjectionSnapshot, y as projectLiveSessionMessage } from "./session-subscriptions-C3M4jnCd.mjs";
+import { A as readAssistantStreamSegmentIdentity, C as SessionProjectionRunTransition, D as SessionMessageEnvelope, E as readSessionProjectionFinalMessageIdentity, F as buildDeviceAuthPayload, I as buildDeviceAuthPayloadV3, L as normalizeDeviceMetadataForAuth, M as readSessionMessageSequence, N as gatewayCredentialScope, O as SessionMessageIdentity, P as gatewayOriginScope, S as SessionProjectionGatewayRunEvent, T as hasSessionProjectionAcceptedFinal, _ as isLocallyOptimisticSessionMessage, a as GatewaySessionMessageSubscriptionOptions, b as reduceSessionProjection, c as resetGatewaySessionMessageSubscriptionCoordinator, d as SessionProjectionRun, f as SessionProjectionRunStatus, g as createSessionProjection, h as SessionProjectionState, i as GatewaySessionMessageSubscriptionCoordinatorOptions, j as readSessionMessageIdentity, k as normalizeSessionProjectionRunId, l as SessionProjectionEntry, m as SessionProjectionSnapshotOptions, n as GatewaySessionMessageSubscription, o as getGatewaySessionMessageSubscriptionCoordinator, p as SessionProjectionScope, r as GatewaySessionMessageSubscriptionCoordinator, s as releaseGatewaySessionMessageSubscription, t as GatewaySessionMessageRequestClient, u as SessionProjectionEvent, v as projectLiveSessionMessage, w as reduceSessionProjectionRunEvent, x as isSessionProjectionErrorMessage, y as reconcileSessionProjectionSnapshot } from "./session-subscriptions-BSQIANvX.mjs";
 import { a as GatewayBrowserDeviceTokenStore, c as resolveGatewayConnectScopes, i as GatewayBrowserDeviceTokenRecord, l as selectGatewayConnectAuth, n as GatewayBrowserDeviceAuthPlan, o as GatewayConnectAuthSelection, r as GatewayBrowserDeviceIdentity, s as buildGatewayConnectAuth, t as GatewayBrowserDeviceAuthLifecycle, u as shouldRetryGatewayWithDeviceToken } from "./browser-device-auth-DoPo-sPB.mjs";
 import { n as GatewayProtocolRequestOptions, r as GatewayProtocolRequestTimeoutError, t as GatewayProtocolRequestError } from "./protocol-request-B5gBmLgq.mjs";
 import { a as GatewayProtocolTiming, i as GatewayProtocolSocketHandlers, n as GatewayProtocolCloseContext, o as GatewayProtocolRequestTiming, r as GatewayProtocolSocket, t as GatewayProtocolClient } from "./protocol-client-DbX7wQED.mjs";

package/dist/browser.mjs

@@ -1,4 +1,4 @@
-import { A as shouldRetryGatewayWithDeviceToken, D as buildGatewayConnectAuth, E as GatewayBrowserDeviceAuthLifecycle, M as buildDeviceAuthPayloadV3, N as normalizeDeviceMetadataForAuth, O as resolveGatewayConnectScopes, S as GatewayProtocolRequestTimeoutError, T as gatewayOriginScope, _ as readSessionMessageSequence, a as createSessionProjection, b as GatewayProtocolClient, c as projectLiveSessionMessage, d as reduceSessionProjection, f as reduceSessionProjectionRunEvent, g as readSessionMessageIdentity, h as readAssistantStreamSegmentIdentity, i as resetGatewaySessionMessageSubscriptionCoordinator, j as buildDeviceAuthPayload, k as selectGatewayConnectAuth, l as readSessionProjectionFinalMessageIdentity, m as normalizeSessionProjectionRunId, n as getGatewaySessionMessageSubscriptionCoordinator, o as hasSessionProjectionAcceptedFinal, p as isSessionProjectionErrorMessage, r as releaseGatewaySessionMessageSubscription, s as isLocallyOptimisticSessionMessage, t as GatewaySessionMessageSubscriptionCoordinator, u as reconcileSessionProjectionSnapshot, w as gatewayCredentialScope, x as GatewayProtocolRequestError, y as shouldPauseGatewayReconnect } from "./session-subscriptions-DwU8T0CH.mjs";
+import { A as shouldRetryGatewayWithDeviceToken, D as buildGatewayConnectAuth, E as GatewayBrowserDeviceAuthLifecycle, M as buildDeviceAuthPayloadV3, N as normalizeDeviceMetadataForAuth, O as resolveGatewayConnectScopes, S as GatewayProtocolRequestTimeoutError, T as gatewayOriginScope, _ as readSessionMessageSequence, a as createSessionProjection, b as GatewayProtocolClient, c as reconcileSessionProjectionSnapshot, d as hasSessionProjectionAcceptedFinal, f as readSessionProjectionFinalMessageIdentity, g as readSessionMessageIdentity, h as readAssistantStreamSegmentIdentity, i as resetGatewaySessionMessageSubscriptionCoordinator, j as buildDeviceAuthPayload, k as selectGatewayConnectAuth, l as reduceSessionProjection, m as normalizeSessionProjectionRunId, n as getGatewaySessionMessageSubscriptionCoordinator, o as isLocallyOptimisticSessionMessage, p as isSessionProjectionErrorMessage, r as releaseGatewaySessionMessageSubscription, s as projectLiveSessionMessage, t as GatewaySessionMessageSubscriptionCoordinator, u as reduceSessionProjectionRunEvent, w as gatewayCredentialScope, x as GatewayProtocolRequestError, y as shouldPauseGatewayReconnect } from "./session-subscriptions-DIcpqS8A.mjs";
 import { DEFAULT_GATEWAY_REQUEST_TIMEOUT_MS, DEFAULT_PREAUTH_HANDSHAKE_TIMEOUT_MS, resolveSafeTimeoutDelayMs } from "./timeouts.mjs";
 export * from "@openclaw/gateway-protocol/connect-error-details";
 export * from "@openclaw/gateway-protocol/gateway-error-details";

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { A as readAssistantStreamSegmentIdentity, C as isSessionProjectionErrorMessage, D as SessionMessageEnvelope, E as reduceSessionProjectionRunEvent, F as buildDeviceAuthPayload, I as buildDeviceAuthPayloadV3, L as normalizeDeviceMetadataForAuth, M as readSessionMessageSequence, N as gatewayCredentialScope, O as SessionMessageIdentity, P as gatewayOriginScope, S as reduceSessionProjection, T as SessionProjectionRunTransition, _ as hasSessionProjectionAcceptedFinal, a as GatewaySessionMessageSubscriptionOptions, b as readSessionProjectionFinalMessageIdentity, c as resetGatewaySessionMessageSubscriptionCoordinator, d as SessionProjectionRun, f as SessionProjectionRunStatus, g as createSessionProjection, h as SessionProjectionState, i as GatewaySessionMessageSubscriptionCoordinatorOptions, j as readSessionMessageIdentity, k as normalizeSessionProjectionRunId, l as SessionProjectionEntry, m as SessionProjectionSnapshotOptions, n as GatewaySessionMessageSubscription, o as getGatewaySessionMessageSubscriptionCoordinator, p as SessionProjectionScope, r as GatewaySessionMessageSubscriptionCoordinator, s as releaseGatewaySessionMessageSubscription, t as GatewaySessionMessageRequestClient, u as SessionProjectionEvent, v as isLocallyOptimisticSessionMessage, w as SessionProjectionGatewayRunEvent, x as reconcileSessionProjectionSnapshot, y as projectLiveSessionMessage } from "./session-subscriptions-C3M4jnCd.mjs";
+import { A as readAssistantStreamSegmentIdentity, C as SessionProjectionRunTransition, D as SessionMessageEnvelope, E as readSessionProjectionFinalMessageIdentity, F as buildDeviceAuthPayload, I as buildDeviceAuthPayloadV3, L as normalizeDeviceMetadataForAuth, M as readSessionMessageSequence, N as gatewayCredentialScope, O as SessionMessageIdentity, P as gatewayOriginScope, S as SessionProjectionGatewayRunEvent, T as hasSessionProjectionAcceptedFinal, _ as isLocallyOptimisticSessionMessage, a as GatewaySessionMessageSubscriptionOptions, b as reduceSessionProjection, c as resetGatewaySessionMessageSubscriptionCoordinator, d as SessionProjectionRun, f as SessionProjectionRunStatus, g as createSessionProjection, h as SessionProjectionState, i as GatewaySessionMessageSubscriptionCoordinatorOptions, j as readSessionMessageIdentity, k as normalizeSessionProjectionRunId, l as SessionProjectionEntry, m as SessionProjectionSnapshotOptions, n as GatewaySessionMessageSubscription, o as getGatewaySessionMessageSubscriptionCoordinator, p as SessionProjectionScope, r as GatewaySessionMessageSubscriptionCoordinator, s as releaseGatewaySessionMessageSubscription, t as GatewaySessionMessageRequestClient, u as SessionProjectionEvent, v as projectLiveSessionMessage, w as reduceSessionProjectionRunEvent, x as isSessionProjectionErrorMessage, y as reconcileSessionProjectionSnapshot } from "./session-subscriptions-BSQIANvX.mjs";
 import { a as GatewayBrowserDeviceTokenStore, c as resolveGatewayConnectScopes, i as GatewayBrowserDeviceTokenRecord, l as selectGatewayConnectAuth, n as GatewayBrowserDeviceAuthPlan, o as GatewayConnectAuthSelection, r as GatewayBrowserDeviceIdentity, s as buildGatewayConnectAuth, t as GatewayBrowserDeviceAuthLifecycle, u as shouldRetryGatewayWithDeviceToken } from "./browser-device-auth-DoPo-sPB.mjs";
 import { i as isGatewayProtocolResponseError } from "./protocol-request-B5gBmLgq.mjs";
 import { DEFAULT_GATEWAY_REQUEST_TIMEOUT_MS, DEFAULT_PREAUTH_HANDSHAKE_TIMEOUT_MS, MAX_CONNECT_CHALLENGE_TIMEOUT_MS, MAX_SAFE_TIMEOUT_DELAY_MS, MIN_CONNECT_CHALLENGE_TIMEOUT_MS, addSafeTimeoutDelayGraceMs, clampConnectChallengeTimeoutMs, clearGatewayConnectTimeout, getConnectChallengeTimeoutMsFromEnv, resolveConnectChallengeTimeoutMs, resolveFiniteTimeoutDelayMs, resolvePreauthHandshakeTimeoutMs, resolveSafeTimeoutDelayMs, startGatewayConnectTimeout } from "./timeouts.mjs";
-import { _ as GatewayClientRequestTimeoutError, a as startGatewayClientWithReadinessWait, b as GatewayClientRequestError, c as waitForEventLoopReady, d as GatewayClient, f as GatewayClientCloseInfo, g as GatewayClientRequestOptions, h as GatewayClientOptions, i as startGatewayClientWhenEventLoopReady, l as DeviceAuthTokenRecord, m as GatewayClientHostDeps, n as GatewayClientStartReadinessOptions, o as EventLoopReadyOptions, p as GatewayClientConnectionMetadata, r as GatewayClientStartable, s as EventLoopReadyResult, t as EventLoopReadyWaiter, u as DeviceIdentity, v as GatewayReconnectPausedInfo, y as isGatewayConnectAssemblyError } from "./readiness-uQKoJkl5.mjs";
+import { _ as GatewayClientRequestTimeoutError, a as startGatewayClientWithReadinessWait, b as GatewayClientRequestError, c as waitForEventLoopReady, d as GatewayClient, f as GatewayClientCloseInfo, g as GatewayClientRequestOptions, h as GatewayClientOptions, i as startGatewayClientWhenEventLoopReady, l as DeviceAuthTokenRecord, m as GatewayClientHostDeps, n as GatewayClientStartReadinessOptions, o as EventLoopReadyOptions, p as GatewayClientConnectionMetadata, r as GatewayClientStartable, s as EventLoopReadyResult, t as EventLoopReadyWaiter, u as DeviceIdentity, v as GatewayReconnectPausedInfo, y as isGatewayConnectAssemblyError } from "./readiness-DabX0O0A.mjs";
 import { GatewayScopeUpgrade, ScopeUpgradeBinding, ScopeUpgradeOptions, ScopeUpgradeOutcome } from "./scope-upgrade.mjs";
 //#region packages/gateway-client/src/cloudflare-access.d.ts
 export declare const CF_ACCESS_CLIENT_ID_HEADER = "CF-Access-Client-Id";

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as shouldRetryGatewayWithDeviceToken, C as isGatewayProtocolResponseError, D as buildGatewayConnectAuth, E as GatewayBrowserDeviceAuthLifecycle, M as buildDeviceAuthPayloadV3, N as normalizeDeviceMetadataForAuth, O as resolveGatewayConnectScopes, S as GatewayProtocolRequestTimeoutError, T as gatewayOriginScope, _ as readSessionMessageSequence, a as createSessionProjection, b as GatewayProtocolClient, c as projectLiveSessionMessage, d as reduceSessionProjection, f as reduceSessionProjectionRunEvent, g as readSessionMessageIdentity, h as readAssistantStreamSegmentIdentity, i as resetGatewaySessionMessageSubscriptionCoordinator, j as buildDeviceAuthPayload, k as selectGatewayConnectAuth, l as readSessionProjectionFinalMessageIdentity, m as normalizeSessionProjectionRunId, n as getGatewaySessionMessageSubscriptionCoordinator, o as hasSessionProjectionAcceptedFinal, p as isSessionProjectionErrorMessage, r as releaseGatewaySessionMessageSubscription, s as isLocallyOptimisticSessionMessage, t as GatewaySessionMessageSubscriptionCoordinator, u as reconcileSessionProjectionSnapshot, v as isRecord, w as gatewayCredentialScope, x as GatewayProtocolRequestError, y as shouldPauseGatewayReconnect } from "./session-subscriptions-DwU8T0CH.mjs";
+import { A as shouldRetryGatewayWithDeviceToken, C as isGatewayProtocolResponseError, D as buildGatewayConnectAuth, E as GatewayBrowserDeviceAuthLifecycle, M as buildDeviceAuthPayloadV3, N as normalizeDeviceMetadataForAuth, O as resolveGatewayConnectScopes, S as GatewayProtocolRequestTimeoutError, T as gatewayOriginScope, _ as readSessionMessageSequence, a as createSessionProjection, b as GatewayProtocolClient, c as reconcileSessionProjectionSnapshot, d as hasSessionProjectionAcceptedFinal, f as readSessionProjectionFinalMessageIdentity, g as readSessionMessageIdentity, h as readAssistantStreamSegmentIdentity, i as resetGatewaySessionMessageSubscriptionCoordinator, j as buildDeviceAuthPayload, k as selectGatewayConnectAuth, l as reduceSessionProjection, m as normalizeSessionProjectionRunId, n as getGatewaySessionMessageSubscriptionCoordinator, o as isLocallyOptimisticSessionMessage, p as isSessionProjectionErrorMessage, r as releaseGatewaySessionMessageSubscription, s as projectLiveSessionMessage, t as GatewaySessionMessageSubscriptionCoordinator, u as reduceSessionProjectionRunEvent, v as isRecord, w as gatewayCredentialScope, x as GatewayProtocolRequestError, y as shouldPauseGatewayReconnect } from "./session-subscriptions-DIcpqS8A.mjs";
 import { DEFAULT_GATEWAY_REQUEST_TIMEOUT_MS, DEFAULT_PREAUTH_HANDSHAKE_TIMEOUT_MS, MAX_CONNECT_CHALLENGE_TIMEOUT_MS, MAX_SAFE_TIMEOUT_DELAY_MS, MIN_CONNECT_CHALLENGE_TIMEOUT_MS, addSafeTimeoutDelayGraceMs, clampConnectChallengeTimeoutMs, clearGatewayConnectTimeout, getConnectChallengeTimeoutMsFromEnv, resolveConnectChallengeTimeoutMs, resolveFiniteTimeoutDelayMs, resolvePreauthHandshakeTimeoutMs, resolveSafeTimeoutDelayMs, startGatewayConnectTimeout } from "./timeouts.mjs";
 import { rawDataToString } from "./websocket-data.mjs";
 import { n as startGatewayClientWithReadinessWait, r as waitForEventLoopReady, t as startGatewayClientWhenEventLoopReady } from "./readiness-CrWxd4TI.mjs";
@@ -744,6 +744,11 @@ var GatewayClient = class {
 			rethrowSocketFactoryError: (error) => error instanceof GatewayClientTransportPolicyError
 		});
 	}
+	/** Current transport state, including CLOSING before the close callback fires.
+	* This is not authentication or readiness evidence on its own. */
+	get connected() {
+		return !this.stopped && this.protocol.connected;
+	}
 	getConnectionMetadata() {
 		return {
 			clientName: this.opts.clientName,

package/dist/{readiness-uQKoJkl5.d.mts → readiness-DabX0O0A.d.mts}

@@ -152,6 +152,9 @@ declare class GatewayClient {
   private transportValidated;
   private suppressedTransientPreHelloCleanCloses;
   constructor(opts: GatewayClientOptions);
+  /** Current transport state, including CLOSING before the close callback fires.
+   * This is not authentication or readiness evidence on its own. */
+  get connected(): boolean;
   getConnectionMetadata(): GatewayClientConnectionMetadata;
   updateNodeManifest(manifest: {
     caps: string[];

package/dist/readiness.d.mts

@@ -1,2 +1,2 @@
-import { a as startGatewayClientWithReadinessWait, i as startGatewayClientWhenEventLoopReady, n as GatewayClientStartReadinessOptions, r as GatewayClientStartable, t as EventLoopReadyWaiter } from "./readiness-uQKoJkl5.mjs";
+import { a as startGatewayClientWithReadinessWait, i as startGatewayClientWhenEventLoopReady, n as GatewayClientStartReadinessOptions, r as GatewayClientStartable, t as EventLoopReadyWaiter } from "./readiness-DabX0O0A.mjs";
 export { EventLoopReadyWaiter, GatewayClientStartReadinessOptions, GatewayClientStartable, startGatewayClientWhenEventLoopReady, startGatewayClientWithReadinessWait };

package/dist/{session-subscriptions-C3M4jnCd.d.mts → session-subscriptions-BSQIANvX.d.mts}

@@ -57,6 +57,17 @@ declare function readAssistantStreamSegmentIdentity(message: unknown): {
   runId?: string;
 } | undefined;
 //#endregion
+//#region packages/gateway-client/src/session-projection-final-identity.d.ts
+type TerminalProjectionRun = {
+  message?: unknown;
+  status: string;
+  acceptedFinalMessageIdentities?: readonly string[];
+};
+/** Read stable persisted identity first, falling back to canonical display content. */
+declare function readSessionProjectionFinalMessageIdentity(message: unknown): string | null;
+/** Check whether a run has already accepted the same terminal reply. */
+declare function hasSessionProjectionAcceptedFinal(run: TerminalProjectionRun | undefined, message: unknown): boolean;
+//#endregion
 //#region packages/gateway-client/src/session-projection-run-event.d.ts
 type SessionProjectionGatewayRunEvent = {
   state?: unknown;
@@ -93,6 +104,10 @@ type SessionProjectionRun = {
   status: SessionProjectionRunStatus;
   message?: unknown;
   acceptedFinalMessageIdentities?: readonly string[];
+  inferredSnapshotTerminal?: {
+    entry: SessionProjectionEntry;
+    matchedIdentity: SessionMessageIdentity;
+  };
   stopReason?: string;
   errorKind?: string;
   errorMessage?: string;
@@ -157,9 +172,6 @@ declare function createSessionProjection(scope?: SessionProjectionScope, message
 declare function projectLiveSessionMessage(state: SessionProjectionState, message: unknown, envelope?: SessionMessageEnvelope, scope?: SessionProjectionScope): SessionProjectionState;
 /** Only observed live events and this client's pending turns may survive an older snapshot. */
 declare function reconcileSessionProjectionSnapshot(state: SessionProjectionState, messages: readonly unknown[], scope?: SessionProjectionScope, options?: SessionProjectionSnapshotOptions): SessionProjectionState;
-declare function readSessionProjectionFinalMessageIdentity(message: unknown): string | null;
-/** Replayed finals are recognized against this run's bounded canonical terminal history. */
-declare function hasSessionProjectionAcceptedFinal(run: SessionProjectionRun | undefined, message: unknown): boolean;
 /** Reduces durable events, snapshots, and transport lifecycle without client-specific policy. */
 declare function reduceSessionProjection(state: SessionProjectionState, event: SessionProjectionEvent): SessionProjectionState;
 //#endregion
@@ -197,4 +209,4 @@ declare function getGatewaySessionMessageSubscriptionCoordinator(client: Gateway
 declare function resetGatewaySessionMessageSubscriptionCoordinator(client: GatewaySessionMessageRequestClient): void;
 declare function releaseGatewaySessionMessageSubscription(subscription: GatewaySessionMessageSubscription): Promise<void>;
 //#endregion
-export { readAssistantStreamSegmentIdentity as A, isSessionProjectionErrorMessage as C, SessionMessageEnvelope as D, reduceSessionProjectionRunEvent as E, buildDeviceAuthPayload as F, buildDeviceAuthPayloadV3 as I, normalizeDeviceMetadataForAuth as L, readSessionMessageSequence as M, gatewayCredentialScope as N, SessionMessageIdentity as O, gatewayOriginScope as P, reduceSessionProjection as S, SessionProjectionRunTransition as T, hasSessionProjectionAcceptedFinal as _, GatewaySessionMessageSubscriptionOptions as a, readSessionProjectionFinalMessageIdentity as b, resetGatewaySessionMessageSubscriptionCoordinator as c, SessionProjectionRun as d, SessionProjectionRunStatus as f, createSessionProjection as g, SessionProjectionState as h, GatewaySessionMessageSubscriptionCoordinatorOptions as i, readSessionMessageIdentity as j, normalizeSessionProjectionRunId as k, SessionProjectionEntry as l, SessionProjectionSnapshotOptions as m, GatewaySessionMessageSubscription as n, getGatewaySessionMessageSubscriptionCoordinator as o, SessionProjectionScope as p, GatewaySessionMessageSubscriptionCoordinator as r, releaseGatewaySessionMessageSubscription as s, GatewaySessionMessageRequestClient as t, SessionProjectionEvent as u, isLocallyOptimisticSessionMessage as v, SessionProjectionGatewayRunEvent as w, reconcileSessionProjectionSnapshot as x, projectLiveSessionMessage as y };
+export { readAssistantStreamSegmentIdentity as A, SessionProjectionRunTransition as C, SessionMessageEnvelope as D, readSessionProjectionFinalMessageIdentity as E, buildDeviceAuthPayload as F, buildDeviceAuthPayloadV3 as I, normalizeDeviceMetadataForAuth as L, readSessionMessageSequence as M, gatewayCredentialScope as N, SessionMessageIdentity as O, gatewayOriginScope as P, SessionProjectionGatewayRunEvent as S, hasSessionProjectionAcceptedFinal as T, isLocallyOptimisticSessionMessage as _, GatewaySessionMessageSubscriptionOptions as a, reduceSessionProjection as b, resetGatewaySessionMessageSubscriptionCoordinator as c, SessionProjectionRun as d, SessionProjectionRunStatus as f, createSessionProjection as g, SessionProjectionState as h, GatewaySessionMessageSubscriptionCoordinatorOptions as i, readSessionMessageIdentity as j, normalizeSessionProjectionRunId as k, SessionProjectionEntry as l, SessionProjectionSnapshotOptions as m, GatewaySessionMessageSubscription as n, getGatewaySessionMessageSubscriptionCoordinator as o, SessionProjectionScope as p, GatewaySessionMessageSubscriptionCoordinator as r, releaseGatewaySessionMessageSubscription as s, GatewaySessionMessageRequestClient as t, SessionProjectionEvent as u, projectLiveSessionMessage as v, reduceSessionProjectionRunEvent as w, isSessionProjectionErrorMessage as x, reconcileSessionProjectionSnapshot as y };

package/dist/{session-subscriptions-DwU8T0CH.mjs → session-subscriptions-DIcpqS8A.mjs}

@@ -1032,6 +1032,66 @@ function asNullableRecord(value) {
 	return isRecord(value) ? value : null;
 }
 //#endregion
+//#region packages/normalization-core/src/stable-stringify.ts
+const preserveString = (value) => value;
+/** Deterministically stringifies values, optionally normalizing strings before key ordering. */
+function stableStringify(value, normalizeString = preserveString) {
+	return stringifyStableValue(value, /* @__PURE__ */ new WeakSet(), normalizeString);
+}
+function stringifyStableValue(value, stack, normalizeString) {
+	if (value === null || value === void 0) return String(value);
+	if (typeof value === "number" && !Number.isFinite(value)) return JSON.stringify(String(value));
+	if (typeof value === "bigint") return JSON.stringify(value.toString());
+	if (typeof value === "string") return JSON.stringify(normalizeString(value));
+	if (typeof value !== "object") return JSON.stringify(value) ?? "null";
+	if (stack.has(value)) return JSON.stringify("[Circular]");
+	stack.add(value);
+	try {
+		return stringifyObjectValue(value, stack, normalizeString);
+	} finally {
+		stack.delete(value);
+	}
+}
+function stringifyObjectValue(value, stack, normalizeString) {
+	if (value instanceof Error) return stringifyStableValue({
+		name: value.name,
+		message: value.message,
+		stack: value.stack
+	}, stack, normalizeString);
+	if (value instanceof Uint8Array) return stringifyStableValue({
+		type: "Uint8Array",
+		data: encodeBase64(value)
+	}, stack, normalizeString);
+	if (Array.isArray(value)) {
+		const serializedEntries = [];
+		for (const entry of value) serializedEntries.push(stringifyStableValue(entry, stack, normalizeString));
+		return `[${serializedEntries.join(",")}]`;
+	}
+	const record = value;
+	if (normalizeString === preserveString) {
+		const fields = [];
+		for (const key of Object.keys(record).toSorted()) fields.push(`${JSON.stringify(key)}:${stringifyStableValue(record[key], stack, normalizeString)}`);
+		return `{${fields.join(",")}}`;
+	}
+	const entries = Object.keys(record).map((key) => ({
+		key,
+		normalizedKey: normalizeString(key)
+	})).toSorted((left, right) => {
+		return compareStableStrings(left.normalizedKey, right.normalizedKey) || compareStableStrings(left.key, right.key);
+	});
+	const serializedFields = [];
+	for (const { key, normalizedKey } of entries) serializedFields.push(`${JSON.stringify(normalizedKey)}:${stringifyStableValue(record[key], stack, normalizeString)}`);
+	return `{${serializedFields.join(",")}}`;
+}
+function encodeBase64(value) {
+	let binary = "";
+	for (const byte of value) binary += String.fromCharCode(byte);
+	return btoa(binary);
+}
+function compareStableStrings(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+//#endregion
 //#region packages/gateway-client/src/session-projection-message-identity.ts
 function readSessionProjectionString(value) {
 	return typeof value === "string" ? value.trim() || null : null;
@@ -1057,6 +1117,9 @@ function readSessionMessageIdentity(message, envelope) {
 	const importedFrom = readSessionProjectionString(metadata?.importedFrom);
 	const cliSessionId = readSessionProjectionString(metadata?.cliSessionId);
 	const externalId = readSessionProjectionString(metadata?.externalId);
+	const position = asNullableRecord(metadata?.transcriptPosition);
+	const positionSource = readSessionProjectionString(position?.source);
+	const isImported = !(positionSource !== null && positionSource.length <= 128 && typeof position?.rawSeq === "number" && Number.isSafeInteger(position.rawSeq) && position.rawSeq >= 0) && Boolean(importedFrom || cliSessionId || externalId);
 	const idempotencyKey = readSessionProjectionString(metadata?.idempotencyKey) ?? readSessionProjectionString(record.idempotencyKey) ?? readSessionProjectionString(envelope?.idempotencyKey) ?? readSessionProjectionString(envelope?.clientRunId);
 	const persistedRunId = normalizeSessionProjectionRunId(idempotencyKey);
 	const envelopeRunId = normalizeSessionProjectionRunId(envelope?.runId);
@@ -1073,8 +1136,8 @@ function readSessionMessageIdentity(message, envelope) {
 		idempotencyKey,
 		sendId: role === "user" ? persistedRunId ?? runId : null,
 		runId,
-		isImported: Boolean(importedFrom || cliSessionId || externalId),
-		externalSource: importedFrom && cliSessionId && externalId ? JSON.stringify([
+		isImported,
+		externalSource: isImported && importedFrom && cliSessionId && externalId ? JSON.stringify([
 			importedFrom,
 			cliSessionId,
 			externalId
@@ -1117,6 +1180,11 @@ function readSessionMessageDisplayContent(message) {
 		usesFallbackText: fallback !== null
 	};
 }
+/** Check whether a projected message has text or another displayable block. */
+function hasDisplayableSessionMessage(message) {
+	const { text, hasNonText } = readSessionMessageDisplayContent(message);
+	return Boolean(text) || hasNonText;
+}
 function normalizeChatErrorComparisonText(text) {
 	return text.trim().replace(/^⚠️\s*/u, "").replace(/^Error:\s*/iu, "").replace(/\s+/gu, " ").trim();
 }
@@ -1129,6 +1197,111 @@ function isSessionProjectionErrorMessage(message, errorMessage) {
 	return !hasNonText && (!normalizedText || normalizedText === "[assistant turn failed before producing content]" || normalizedText === GATEWAY_ASSISTANT_ERROR_FALLBACK_TEXT || normalizedText === normalizeChatErrorComparisonText(errorMessage ?? ""));
 }
 //#endregion
+//#region packages/gateway-client/src/session-projection-final-identity.ts
+/** Terminal identity rules used to reconcile live and durable assistant projections. */
+function readPersistedFinalIdentity(message) {
+	const identity = readSessionMessageIdentity(message);
+	if (identity?.externalSource) return `import:${identity.role}:${identity.externalSource}`;
+	if (identity?.id && !identity.isImported) return `id:${identity.role}:${identity.id}`;
+	if (identity?.sequence !== null && identity?.sequence !== void 0) return `seq:${identity.role}:${identity.sequence}`;
+	return null;
+}
+function hasCompatiblePersistedFinalIdentity(currentMessage, incomingMessage) {
+	const current = readSessionMessageIdentity(currentMessage);
+	const incoming = readSessionMessageIdentity(incomingMessage);
+	if (!current || !incoming || current.role !== incoming.role) return false;
+	if (current.isImported || incoming.isImported) {
+		if (!current.isImported || !incoming.isImported) return false;
+		if (current.externalSource && incoming.externalSource) return current.externalSource === incoming.externalSource;
+		return current.sequence !== null && incoming.sequence !== null && current.sequence === incoming.sequence;
+	}
+	if (current.id && incoming.id) return current.id === incoming.id;
+	return current.sequence !== null && incoming.sequence !== null && current.sequence === incoming.sequence;
+}
+function readFinalContentIdentity(message) {
+	const display = readSessionMessageDisplayContent(message);
+	if (!display.text && !display.hasNonText) return null;
+	const identity = readSessionMessageIdentity(message);
+	const record = asNullableRecord(message);
+	const metadata = asNullableRecord(record?.["__openclaw"]);
+	try {
+		return `content:${stableStringify([
+			identity?.role ?? "assistant",
+			display.text,
+			display.hasNonText ? record?.content ?? null : null,
+			metadata?.media ?? null,
+			identity?.isImported ? [
+				metadata?.importedFrom ?? null,
+				metadata?.cliSessionId ?? null,
+				metadata?.externalId ?? null
+			] : null
+		])}`;
+	} catch {
+		return null;
+	}
+}
+function hasTerminalStopReason(message) {
+	const stopReason = asNullableRecord(message)?.stopReason;
+	return stopReason === "stop" || stopReason === "length" || stopReason === "error" || stopReason === "aborted" || stopReason === "end_turn";
+}
+function hasCompletedRunSnapshotContext(entry, snapshot, runId) {
+	if (!runId || entry.identity?.runId !== runId) return false;
+	const entryIndex = snapshot.indexOf(entry);
+	if (entryIndex < 0) return false;
+	const hasEarlierUser = snapshot.slice(0, entryIndex).some((candidate) => candidate.identity?.role === "user" && candidate.identity.runId === runId);
+	const hasLaterAssistant = snapshot.slice(entryIndex + 1).some((candidate) => candidate.identity?.role === "assistant" && candidate.identity.runId === runId);
+	return hasEarlierUser && !hasLaterAssistant;
+}
+/** Read stable persisted identity first, falling back to canonical display content. */
+function readSessionProjectionFinalMessageIdentity(message) {
+	if (!hasDisplayableSessionMessage(message)) return null;
+	return readPersistedFinalIdentity(message) ?? readFinalContentIdentity(message);
+}
+/** Check whether a displayable terminal may recover a prior empty terminal. */
+function canRecoverSessionProjectionFinal(currentMessage, incomingMessage) {
+	if (hasDisplayableSessionMessage(currentMessage)) return false;
+	return readPersistedFinalIdentity(currentMessage) === null || hasCompatiblePersistedFinalIdentity(currentMessage, incomingMessage);
+}
+/** Check whether a run has already accepted the same terminal reply. */
+function hasSessionProjectionAcceptedFinal(run, message) {
+	const identity = readSessionProjectionFinalMessageIdentity(message);
+	return Boolean(identity && run && (run.acceptedFinalMessageIdentities?.includes(identity) || readSessionProjectionFinalMessageIdentity(run.message) === identity));
+}
+/** Match an unsequenced live terminal to exactly one durable same-run terminal row. */
+function findUniqueSnapshotTerminalMatch(current, matches, run, snapshot) {
+	if (!current.live || current.identity?.role !== "assistant" || current.identity.id || current.identity.sequence !== null || !run || run.status === "streaming") return null;
+	const terminalContent = readFinalContentIdentity(current.message);
+	if (!terminalContent || readFinalContentIdentity(run.message) !== terminalContent) return null;
+	const durableTerminalMatches = matches.filter((entry) => {
+		return (asNullableRecord(asNullableRecord(entry.message)?.["__openclaw"])?.runTerminal === true || entry.identity?.runId === current.identity?.runId && hasTerminalStopReason(entry.message) || hasCompletedRunSnapshotContext(entry, snapshot, current.identity?.runId ?? null)) && readFinalContentIdentity(entry.message) === terminalContent;
+	});
+	const entry = durableTerminalMatches.length === 1 ? durableTerminalMatches[0] : void 0;
+	if (!entry) return null;
+	return {
+		entry,
+		inferred: asNullableRecord(asNullableRecord(entry.message)?.["__openclaw"])?.runTerminal !== true && !hasTerminalStopReason(entry.message)
+	};
+}
+/** Check whether ordinary single-match promotion needs terminal-content verification. */
+function isUnsequencedLiveTerminal(current, run) {
+	return Boolean(current.live && current.identity?.role === "assistant" && !current.identity.id && current.identity.sequence === null && run && run.status !== "streaming" && readFinalContentIdentity(current.message) === readFinalContentIdentity(run.message));
+}
+//#endregion
+//#region packages/gateway-client/src/session-projection-run-retention.ts
+/** Bounded retention for completed and active session projection runs. */
+const MAX_TRACKED_SESSION_RUNS = 200;
+const RETAINED_SESSION_RUNS = 150;
+/** Retain every active run and the newest completed runs within the projection bound. */
+function retainSessionProjectionRuns(runs) {
+	const entries = Object.entries(runs);
+	if (entries.length <= MAX_TRACKED_SESSION_RUNS) return runs;
+	const active = entries.filter(([, run]) => run.status === "streaming");
+	const terminal = entries.filter(([, run]) => run.status !== "streaming");
+	const terminalLimit = Math.max(0, RETAINED_SESSION_RUNS - active.length);
+	const retainedTerminal = terminalLimit > 0 ? terminal.slice(-terminalLimit) : [];
+	return Object.fromEntries([...active, ...retainedTerminal]);
+}
+//#endregion
 //#region packages/gateway-client/src/session-projection-run-event.ts
 function readNonemptyString(value) {
 	return typeof value === "string" ? value.trim() || null : null;
@@ -1172,8 +1345,6 @@ function reduceSessionProjectionRunEvent(projection, event, scope = {}) {
 //#endregion
 //#region packages/gateway-client/src/session-projection.ts
 /** Browser-safe identity and replay rules shared by Gateway conversation clients. */
-const MAX_TRACKED_SESSION_RUNS = 200;
-const RETAINED_SESSION_RUNS = 150;
 const SESSION_PROJECTION_SCOPE_KEYS = [
 	"sessionKey",
 	"sessionId",
@@ -1327,12 +1498,39 @@ function reconcileSessionProjectionSnapshot(state, messages, scope = {}, options
 	const visibleMessages = options.shouldIncludeMessage ? messages.filter(options.shouldIncludeMessage) : messages;
 	if (!scopesMatch(state.scope, scope)) return createSessionProjection(scope, visibleMessages);
 	let entries = createProjectionEntries(visibleMessages);
+	const runs = { ...state.runs };
 	for (const current of state.entries) {
-		if (!current.live && !current.pending || options.shouldIncludeMessage?.(current.message) === false || entries.filter((entry) => entryMatches(entry, current, true)).length === 1) continue;
-		entries = insertEntry(entries, current, state.runs);
+		if (!current.live && !current.pending || options.shouldIncludeMessage?.(current.message) === false) continue;
+		const matches = entries.filter((entry) => entryMatches(entry, current, true));
+		const run = current.identity?.runId ? runs[current.identity.runId] : void 0;
+		const terminalMatch = findUniqueSnapshotTerminalMatch(current, matches, run, entries);
+		if (matches.length === 1 && !isUnsequencedLiveTerminal(current, run) || terminalMatch) {
+			if (terminalMatch?.inferred && terminalMatch.entry.identity && current.identity?.runId && run) runs[current.identity.runId] = {
+				...run,
+				inferredSnapshotTerminal: {
+					entry: current,
+					matchedIdentity: terminalMatch.entry.identity
+				}
+			};
+			continue;
+		}
+		entries = insertEntry(entries, current, runs);
+	}
+	for (const [runId, run] of Object.entries(runs)) {
+		const inferred = run.inferredSnapshotTerminal;
+		if (!inferred) continue;
+		const candidateRemains = entries.some((entry) => sameTranscriptIdentity(entry.identity, inferred.matchedIdentity));
+		const visible = options.shouldIncludeMessage?.(inferred.entry.message) !== false;
+		const matches = entries.filter((entry) => entryMatches(entry, inferred.entry, true));
+		const terminalMatch = findUniqueSnapshotTerminalMatch(inferred.entry, matches, run, entries);
+		if (candidateRemains && visible && terminalMatch?.inferred) continue;
+		if (candidateRemains && visible && !terminalMatch) entries = insertEntry(entries, inferred.entry, runs);
+		const { inferredSnapshotTerminal: _inferred, ...settledRun } = run;
+		runs[runId] = settledRun;
 	}
 	return {
 		...withEntries(state, entries),
+		runs,
 		scope: {
 			...state.scope,
 			...scope
@@ -1340,49 +1538,6 @@ function reconcileSessionProjectionSnapshot(state, messages, scope = {}, options
 		hasTransportGap: false
 	};
 }
-function hasDisplayableSessionMessage(message) {
-	const { text, hasNonText } = readSessionMessageDisplayContent(message);
-	return Boolean(text) || hasNonText;
-}
-function readSessionProjectionFinalMessageIdentity(message) {
-	const display = readSessionMessageDisplayContent(message);
-	if (!display.text && !display.hasNonText) return null;
-	const identity = readSessionMessageIdentity(message);
-	if (identity?.externalSource) return `import:${identity.role}:${identity.externalSource}`;
-	if (identity?.id && !identity.isImported) return `id:${identity.role}:${identity.id}`;
-	if (identity?.sequence !== null && identity?.sequence !== void 0) return `seq:${identity.role}:${identity.sequence}`;
-	const record = asNullableRecord(message);
-	const metadata = asNullableRecord(record?.["__openclaw"]);
-	try {
-		return `content:${JSON.stringify([
-			identity?.role ?? "assistant",
-			typeof message === "string" ? message : record?.content ?? null,
-			metadata?.media ?? null,
-			identity?.isImported ? [
-				metadata?.importedFrom ?? null,
-				metadata?.cliSessionId ?? null,
-				metadata?.externalId ?? null
-			] : null,
-			...display.usesFallbackText ? [record?.text] : []
-		])}`;
-	} catch {
-		return null;
-	}
-}
-/** Replayed finals are recognized against this run's bounded canonical terminal history. */
-function hasSessionProjectionAcceptedFinal(run, message) {
-	const identity = readSessionProjectionFinalMessageIdentity(message);
-	return Boolean(identity && run && (run.acceptedFinalMessageIdentities?.includes(identity) || readSessionProjectionFinalMessageIdentity(run.message) === identity));
-}
-function retainSessionProjectionRuns(runs) {
-	const entries = Object.entries(runs);
-	if (entries.length <= MAX_TRACKED_SESSION_RUNS) return runs;
-	const active = entries.filter(([, run]) => run.status === "streaming");
-	const terminal = entries.filter(([, run]) => run.status !== "streaming");
-	const terminalLimit = Math.max(0, RETAINED_SESSION_RUNS - active.length);
-	const retainedTerminal = terminalLimit > 0 ? terminal.slice(-terminalLimit) : [];
-	return Object.fromEntries([...active, ...retainedTerminal]);
-}
 function updateRun(state, incoming) {
 	const incomingErrorMessage = readSessionProjectionString(incoming.errorMessage);
 	const incomingSeq = typeof incoming.seq === "number" && Number.isSafeInteger(incoming.seq) && incoming.seq >= 0 ? incoming.seq : void 0;
@@ -1397,9 +1552,10 @@ function updateRun(state, incoming) {
 	if (current && current.status !== "streaming" && !resumesErrorProjection) {
 		const incomingFinalIdentity = readSessionProjectionFinalMessageIdentity(incoming.message);
 		const incomingIsFinal = incoming.status === "completed" || incoming.status === "yielded";
-		const canRecoverFinal = !hasDisplayableSessionMessage(current.message) || (current.acceptedFinalMessageIdentities?.length ?? 0) > 0;
-		const acceptFinal = incomingIsFinal && (current.status === incoming.status || canRecoverFinal) && incomingFinalIdentity !== null && !hasSessionProjectionAcceptedFinal(current, incoming.message);
-		const recoverMessage = acceptFinal && !hasDisplayableSessionMessage(current.message);
+		const currentHasDisplayableMessage = hasDisplayableSessionMessage(current.message);
+		const canAcceptFinal = currentHasDisplayableMessage ? current.status === incoming.status || (current.acceptedFinalMessageIdentities?.length ?? 0) > 0 : canRecoverSessionProjectionFinal(current.message, incoming.message);
+		const acceptFinal = incomingIsFinal && canAcceptFinal && incomingFinalIdentity !== null && !hasSessionProjectionAcceptedFinal(current, incoming.message);
+		const recoverMessage = acceptFinal && !currentHasDisplayableMessage;
 		const recoverError = readSessionProjectionString(current.errorMessage) === null && incomingErrorMessage !== null;
 		const updateTerminalSequence = incoming.status !== "streaming" && (incomingSeq === void 0 ? current.seq !== void 0 : current.seq === void 0 || incomingSeq > current.seq);
 		if (!acceptFinal && !recoverError && !updateTerminalSequence) return state;
@@ -1727,4 +1883,4 @@ function releaseGatewaySessionMessageSubscription(subscription) {
 	return sessionMessageSubscriptionOwners.get(subscription)?.coordinator.release(subscription) ?? Promise.resolve();
 }
 //#endregion
-export { shouldRetryGatewayWithDeviceToken as A, isGatewayProtocolResponseError as C, buildGatewayConnectAuth as D, GatewayBrowserDeviceAuthLifecycle as E, buildDeviceAuthPayloadV3 as M, normalizeDeviceMetadataForAuth as N, resolveGatewayConnectScopes as O, GatewayProtocolRequestTimeoutError as S, gatewayOriginScope as T, readSessionMessageSequence as _, createSessionProjection as a, GatewayProtocolClient as b, projectLiveSessionMessage as c, reduceSessionProjection as d, reduceSessionProjectionRunEvent as f, readSessionMessageIdentity as g, readAssistantStreamSegmentIdentity as h, resetGatewaySessionMessageSubscriptionCoordinator as i, buildDeviceAuthPayload as j, selectGatewayConnectAuth as k, readSessionProjectionFinalMessageIdentity as l, normalizeSessionProjectionRunId as m, getGatewaySessionMessageSubscriptionCoordinator as n, hasSessionProjectionAcceptedFinal as o, isSessionProjectionErrorMessage as p, releaseGatewaySessionMessageSubscription as r, isLocallyOptimisticSessionMessage as s, GatewaySessionMessageSubscriptionCoordinator as t, reconcileSessionProjectionSnapshot as u, isRecord as v, gatewayCredentialScope as w, GatewayProtocolRequestError as x, shouldPauseGatewayReconnect as y };
+export { shouldRetryGatewayWithDeviceToken as A, isGatewayProtocolResponseError as C, buildGatewayConnectAuth as D, GatewayBrowserDeviceAuthLifecycle as E, buildDeviceAuthPayloadV3 as M, normalizeDeviceMetadataForAuth as N, resolveGatewayConnectScopes as O, GatewayProtocolRequestTimeoutError as S, gatewayOriginScope as T, readSessionMessageSequence as _, createSessionProjection as a, GatewayProtocolClient as b, reconcileSessionProjectionSnapshot as c, hasSessionProjectionAcceptedFinal as d, readSessionProjectionFinalMessageIdentity as f, readSessionMessageIdentity as g, readAssistantStreamSegmentIdentity as h, resetGatewaySessionMessageSubscriptionCoordinator as i, buildDeviceAuthPayload as j, selectGatewayConnectAuth as k, reduceSessionProjection as l, normalizeSessionProjectionRunId as m, getGatewaySessionMessageSubscriptionCoordinator as n, isLocallyOptimisticSessionMessage as o, isSessionProjectionErrorMessage as p, releaseGatewaySessionMessageSubscription as r, projectLiveSessionMessage as s, GatewaySessionMessageSubscriptionCoordinator as t, reduceSessionProjectionRunEvent as u, isRecord as v, gatewayCredentialScope as w, GatewayProtocolRequestError as x, shouldPauseGatewayReconnect as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/gateway-client",
-  "version": "2026.9.3",
+  "version": "2026.9.4",
   "description": "Reference WebSocket client for the OpenClaw Gateway protocol",
   "keywords": [
     "client",
@@ -62,7 +62,7 @@
     }
   },
   "dependencies": {
-    "@openclaw/gateway-protocol": "2026.9.3",
+    "@openclaw/gateway-protocol": "2026.9.4",
     "ipaddr.js": "2.5.0",
     "ws": "8.21.3"
   },