clawconnect-agent 0.1.40 → 0.1.42

package/dist/openclaw/relay/chat-run-identity.js

@@ -1,11 +1,21 @@
+export const OPENCLAW_CHAT_RUN_IDENTITY_MAX_ENTRIES = 2_048;
 /**
  * OpenClaw 的 provider runId 只负责关联 Gateway 事件；移动端幂等键才是跨 Relay
- * 重连仍然有效的对外身份。该注册表位于连接实例之外，并按显式运行身份保留到进程结束，
- * 避免长运行或迟到事件因时间窗口、容量淘汰而退化为 provider 身份。
+ * 重连仍然有效的对外身份。累计正文与身份共用同一进程级、LRU 有界生命周期；新的
+ * provider command response 是运行代际边界，即使 provider 重用了 runId，也不会继承
+ * 上一轮 terminal 状态。
  */
 export class OpenClawChatRunIdentityRegistry {
+    maxEntries;
     identitiesByProvider = new Map();
     providerRunsByCanonical = new Map();
+    constructor(maxEntries = OPENCLAW_CHAT_RUN_IDENTITY_MAX_ENTRIES) {
+        this.maxEntries = maxEntries;
+        if (!Number.isInteger(maxEntries) || maxEntries <= 0) {
+            throw new Error("openclaw_chat_run_identity_limit_invalid");
+        }
+    }
+    /** Starts a new authoritative provider run generation. */
     register(identity) {
         const gatewayId = identity.gatewayId.trim();
         const providerRunId = identity.providerRunId.trim();
@@ -13,20 +23,65 @@ export class OpenClawChatRunIdentityRegistry {
         if (!gatewayId || !providerRunId || !canonicalRunId) {
             return;
         }
-        this.identitiesByProvider.set(this.key(gatewayId, providerRunId), {
+        const identityKey = this.key(gatewayId, providerRunId);
+        this.removeCanonicalMapping(this.identitiesByProvider.get(identityKey));
+        this.identitiesByProvider.delete(identityKey);
+        this.identitiesByProvider.set(identityKey, {
             ...identity,
             gatewayId,
             providerRunId,
             canonicalRunId,
+            accumulatedText: "",
         });
         this.providerRunsByCanonical.set(this.key(gatewayId, canonicalRunId), providerRunId);
+        this.prune();
+    }
+    /** Registers event-only runs without resetting a generation already in flight. */
+    ensure(identity) {
+        const existing = this.resolve(identity.gatewayId, identity.providerRunId);
+        if (existing)
+            return existing;
+        this.register(identity);
+        return this.resolve(identity.gatewayId, identity.providerRunId);
     }
     resolve(gatewayId, providerRunId) {
-        return this.identitiesByProvider.get(this.key(gatewayId.trim(), providerRunId.trim()));
+        const key = this.key(gatewayId.trim(), providerRunId.trim());
+        const stored = this.touch(key);
+        return stored ? this.publicIdentity(stored) : undefined;
     }
     resolveProviderRunId(gatewayId, canonicalRunId) {
         return this.providerRunsByCanonical.get(this.key(gatewayId.trim(), canonicalRunId.trim()));
     }
+    markTerminal(gatewayId, providerRunId) {
+        const key = this.key(gatewayId.trim(), providerRunId.trim());
+        const identity = this.touch(key);
+        if (identity)
+            identity.terminal = true;
+    }
+    isTerminal(gatewayId, providerRunId) {
+        return this.touch(this.key(gatewayId.trim(), providerRunId.trim()))?.terminal === true;
+    }
+    accumulatedText(gatewayId, providerRunId) {
+        return this.touch(this.key(gatewayId.trim(), providerRunId.trim()))?.accumulatedText ?? "";
+    }
+    setAccumulatedText(gatewayId, providerRunId, text) {
+        const identity = this.touch(this.key(gatewayId.trim(), providerRunId.trim()));
+        if (identity)
+            identity.accumulatedText = text;
+    }
+    clearTransient(gatewayId, providerRunId) {
+        const identity = this.touch(this.key(gatewayId.trim(), providerRunId.trim()));
+        if (!identity)
+            return;
+        identity.accumulatedText = "";
+        identity.promptText = undefined;
+    }
+    remove(gatewayId, providerRunId) {
+        const key = this.key(gatewayId.trim(), providerRunId.trim());
+        const identity = this.identitiesByProvider.get(key);
+        this.removeCanonicalMapping(identity);
+        this.identitiesByProvider.delete(key);
+    }
     clear() {
         this.identitiesByProvider.clear();
         this.providerRunsByCanonical.clear();
@@ -34,6 +89,36 @@ export class OpenClawChatRunIdentityRegistry {
     key(gatewayId, providerRunId) {
         return `${gatewayId}\u0000${providerRunId}`;
     }
+    touch(key) {
+        const identity = this.identitiesByProvider.get(key);
+        if (!identity)
+            return undefined;
+        this.identitiesByProvider.delete(key);
+        this.identitiesByProvider.set(key, identity);
+        return identity;
+    }
+    prune() {
+        while (this.identitiesByProvider.size > this.maxEntries) {
+            const oldestKey = this.identitiesByProvider.keys().next().value;
+            if (!oldestKey)
+                return;
+            const identity = this.identitiesByProvider.get(oldestKey);
+            this.removeCanonicalMapping(identity);
+            this.identitiesByProvider.delete(oldestKey);
+        }
+    }
+    removeCanonicalMapping(identity) {
+        if (!identity)
+            return;
+        const canonicalKey = this.key(identity.gatewayId, identity.canonicalRunId);
+        if (this.providerRunsByCanonical.get(canonicalKey) === identity.providerRunId) {
+            this.providerRunsByCanonical.delete(canonicalKey);
+        }
+    }
+    publicIdentity(identity) {
+        const { terminal: _terminal, accumulatedText: _accumulatedText, ...publicIdentity } = identity;
+        return publicIdentity;
+    }
 }
 export function normalizeOpenClawMobileRunId(value) {
     if (typeof value !== "string" || !value.trim()) {

package/dist/openclaw/relay/chat-run-identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-run-identity.js","sourceRoot":"","sources":["../../../src/openclaw/relay/chat-run-identity.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-run-identity.js","sourceRoot":"","sources":["../../../src/openclaw/relay/chat-run-identity.ts"],"names":[],"mappings":"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"}

package/dist/openclaw/relay/relay-manager-protocol.d.ts

@@ -18,22 +18,39 @@ export type OpenClawRelayToServer = RelayHelloMessage | {
     type: "event";
     event: string;
     payload: unknown;
+    deliveryId?: string;
 } | {
     type: "res";
     id: string;
     ok: boolean;
+    responsePhase?: "accepted" | "terminal";
     payload?: unknown;
     error?: {
         message?: string;
     };
 };
 /** Messages the relay server sends to the OpenClaw relay client. */
-export interface OpenClawRelayFromServer {
-    type: "cmd" | "hello" | "heartbeat";
+export type OpenClawRelayFromServer = {
+    type: "cmd";
     id?: string;
     method: string;
     params: unknown;
-}
+} | {
+    type: "hello";
+    role: "relay";
+    gatewayId: string;
+    ok: true;
+    protocolCapabilities?: string[];
+} | {
+    type: "heartbeat";
+} | {
+    type: "event_ack";
+    id: string;
+} | {
+    type: "response_ack";
+    id: string;
+    responsePhase?: string;
+};
 export interface RelayManagerOptions {
     relayServerUrl: string;
     gatewayId: string;
@@ -43,6 +60,10 @@ export interface RelayManagerOptions {
     gatewayPassword?: string;
     onConnected?: () => void;
     onDisconnected?: () => void;
+    /** @internal Allows deterministic protocol-negotiation timeout tests. */
+    relayHelloTimeoutMs?: number;
+    /** @internal Isolates durable outbox files in tests. */
+    reliableOutboxStorageDirectory?: string;
     /** Optional abort signal.  When aborted the relay WebSocket is closed
      *  cleanly (code 1001) and the retry loop stops. */
     signal?: AbortSignal;