@masons/agent-network 0.6.20 → 0.6.21

package/dist/sent-message-buffer.js

@@ -3,13 +3,12 @@ export class SentMessageBuffer {
     static MAX_PER_CONTACT = 5;
     static TTL_MS = 2 * 60 * 60 * 1000;
     static MAX_CONTENT_LENGTH = 1000;
-    record(contact, content) {
+    record(peerAddress, content) {
         const now = Date.now();
-        const key = contact.toLowerCase();
-        let list = this.entries.get(key);
+        let list = this.entries.get(peerAddress);
         if (!list) {
             list = [];
-            this.entries.set(key, list);
+            this.entries.set(peerAddress, list);
         }
         const cutoff = now - SentMessageBuffer.TTL_MS;
         const fresh = list.filter((m) => m.timestamp > cutoff);
@@ -20,21 +19,20 @@ export class SentMessageBuffer {
             ? `${content.slice(0, SentMessageBuffer.MAX_CONTENT_LENGTH)}...`
             : content;
         fresh.push({ content: stored, timestamp: now });
-        this.entries.set(key, fresh);
+        this.entries.set(peerAddress, fresh);
     }
-    getRecent(contact) {
-        const key = contact.toLowerCase();
-        const list = this.entries.get(key);
+    getRecent(peerAddress) {
+        const list = this.entries.get(peerAddress);
         if (!list)
             return [];
         const cutoff = Date.now() - SentMessageBuffer.TTL_MS;
         const fresh = list.filter((m) => m.timestamp > cutoff);
         if (fresh.length !== list.length) {
             if (fresh.length === 0) {
-                this.entries.delete(key);
+                this.entries.delete(peerAddress);
             }
             else {
-                this.entries.set(key, fresh);
+                this.entries.set(peerAddress, fresh);
             }
         }
         return fresh;
@@ -43,4 +41,3 @@ export class SentMessageBuffer {
         this.entries.clear();
     }
 }
-export const sentMessageBuffer = new SentMessageBuffer();

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAwEA,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,UAAU,WAAW;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E,UAAU,OAAO;IACf,YAAY,CACV,IAAI,EAAE,cAAc,GAAG,WAAW,EAWlC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7D,IAAI,CAAC;CACT;AAoDD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAwSD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA22BhD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AA2EA,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,UAAU,WAAW;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3E,UAAU,OAAO;IACf,YAAY,CACV,IAAI,EAAE,cAAc,GAAG,WAAW,EAWlC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC7D,IAAI,CAAC;CACT;AAoDD,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAoZD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAm5BhD"}

package/dist/tools.js

@@ -1,12 +1,10 @@
 import { Type } from "@sinclair/typebox";
 import { getOwnerPassportAddress } from "./channel.js";
 import { _resetChannelSetupForTesting, consumeChannelSetupStatus, getDefaultChannelSetupOptions, startOrGetChannelSetup, } from "./channel-setup.js";
-import { clearTargetHandle, extractNetworkConfig, getDmScope, getPendingTarget, isProfileNeeded, markProfileComplete, removeIdentityLinks, requireApiKey, requireConversationManager, requirePlatformConfig, writeIdentityLinks, } from "./config.js";
+import { clearTargetHandle, extractNetworkConfig, getConnectorClient, getDmScope, getPendingTarget, hasApiKey, isProfileNeeded, markProfileComplete, removeIdentityLinks, requireApiKey, requireConversationManager, requirePlatformConfig, writeIdentityLinks, } from "./config.js";
 import { getOwnerHandle } from "./environment-context.js";
-import { extractHandleFromAddress } from "./handle-utils.js";
 import { ownerNotesQueue } from "./owner-notes.js";
-import { acceptRequest, declineRequest, listConnections, listRequests, PlatformApiError, PlatformNetworkError, requestConnection, updateProfile, } from "./platform-client.js";
-import { sentMessageBuffer } from "./sent-message-buffer.js";
+import { acceptRequest, declineRequest, getIdentity, listConnections, listRequests, PlatformApiError, PlatformNetworkError, requestConnection, updateProfile, } from "./platform-client.js";
 import { isServicesRetainedReplyContext } from "./services-retained-reply-context.js";
 import { getCurrentTurnChannelId, getCurrentTurnIsOwnerNonConsuming, getCurrentTurnOwnerSignal, } from "./turn-context.js";
 import { getLatestPublishedVersion, getPluginVersion, getUpdateInfo, } from "./update-check.js";
@@ -63,6 +61,76 @@ function formatConnectionResult(requestIds, status) {
     }
     return `Connection request sent. Status: ${status}. The other agent's owner will be notified.`;
 }
+function formatIdentityNode(node) {
+    const handlePart = node.handle ? `@${node.handle} — ` : "";
+    const canonical = `Identity: ${formatKindLabel(node.kind)}${handlePart}${node.mstpAddress}`;
+    if (!node.displayName)
+        return canonical;
+    return `${canonical}\nDisplay name (presentation supplied by the identity endpoint): ${node.displayName}`;
+}
+const IDENTITY_NO_FALLBACK = "This is not an answer — do not assume any locally-cached handle or name is this Runtime's identity.";
+function formatIdentityError(err) {
+    if (err instanceof PlatformApiError) {
+        if (err.status === 404) {
+            return err.code === "not_found"
+                ? "Identity: the Node's backing entity is missing or deleted."
+                : `Identity: unavailable — the identity endpoint is not available at this host (HTTP 404). ${IDENTITY_NO_FALLBACK}`;
+        }
+        if (err.status === 401) {
+            return "Identity: the runtime key is not valid — the network rejected it. The owner can re-authenticate via masons_setup.";
+        }
+        if (err.status === 403) {
+            return "Identity: refused (HTTP 403) — this runtime key is not permitted to read this Runtime's identity. That is a credential-class refusal, not a transient outage: retrying will not change it.";
+        }
+        return `Identity: unavailable right now (HTTP ${err.status}: ${err.code}). ${IDENTITY_NO_FALLBACK}`;
+    }
+    if (err instanceof PlatformNetworkError) {
+        return `Identity: unavailable right now. ${networkErrorText(err)} ${IDENTITY_NO_FALLBACK}`;
+    }
+    throw err;
+}
+function formatRegistration(outcome) {
+    switch (outcome.state) {
+        case "accepted":
+            return "accepted";
+        case "refused":
+            return `refused: ${outcome.reason}`;
+        case "replaced":
+            return "replaced by another Runtime (will not retry)";
+        case "none":
+            return "none";
+    }
+}
+function formatReadinessSection() {
+    const credentialsLine = hasApiKey()
+        ? "Credentials: configured"
+        : "Credentials: not configured";
+    const client = getConnectorClient();
+    const channel = client ? client.getChannelState() : "not established";
+    const registration = formatRegistration(client ? client.getRegistration() : { state: "none" });
+    return [
+        credentialsLine,
+        `Gateway channel: ${channel}`,
+        `Registration (this connection): ${registration}`,
+    ].join("\n");
+}
+async function resolveIdentitySection() {
+    if (!hasApiKey()) {
+        return "Identity: no runtime key configured — cannot ask the network who this Runtime is. Run masons_setup first.";
+    }
+    const cfg = requirePlatformConfig();
+    const apiKey = requireApiKey();
+    try {
+        const node = await getIdentity(cfg, apiKey);
+        if (node === null) {
+            return "Identity: this Runtime's principal holds no active Node on the network.";
+        }
+        return formatIdentityNode(node);
+    }
+    catch (err) {
+        return formatIdentityError(err);
+    }
+}
 function resolveSetupAuthority() {
     const channelId = getCurrentTurnChannelId();
     if (channelId !== "agent-network") {
@@ -573,6 +641,18 @@ export function registerTools(api) {
             return textResult(`${result.total} connection(s):\n\n${lines.join("\n")}\n\nUse masons_send_message with a handle or address to send a message.`);
         }),
     });
+    api.registerTool({
+        name: "masons_status",
+        description: [
+            "Report this Runtime's canonical identity and participation status on the agent network.",
+            "Use when the owner asks 'who are you on the network', 'what's your identity', 'are you connected', or 'are you ready'.",
+            "",
+            "Identity comes ONLY from the platform's own identity endpoint — never from local config, cached REGISTER_ACK context, a pending connection target, or any peer/connection handle. If the identity endpoint is unavailable, this tool reports that plainly instead of guessing.",
+            "Readiness reports separate facts — credentials configured, live Gateway channel state, and the current connection's registration outcome — without collapsing them into one 'online' verdict.",
+        ].join("\n"),
+        parameters: Type.Object({}),
+        execute: withUpdateNotice(async () => textResult([await resolveIdentitySection(), "", formatReadinessSection()].join("\n"))),
+    });
     api.registerTool({
         name: "masons_send_message",
         description: "Send a message to a remote agent on the agent network. This is agent-to-agent communication — separate from your owner's conversation. Sessions are managed automatically — just provide the contact handle or address.",
@@ -591,11 +671,25 @@ export function registerTools(api) {
             const cm = requireConversationManager();
             const to = params.to;
             const content = params.content;
-            const handle = extractHandleFromAddress(to);
             const result = await cm.send(to, content);
             if (result.status === "sent") {
-                sentMessageBuffer.record(handle, content);
-                return textResult("Message sent.");
+                if (result.addressedTarget?.basis === "resolved") {
+                    cm.recordOutboundContext(result.addressedTarget.address, content);
+                }
+                const reference = result.messageRef
+                    ? ` Message reference: ${JSON.stringify(result.messageRef)}.`
+                    : "";
+                if (result.acknowledgementStatus === "stored") {
+                    return textResult(`Message durably accepted for delivery.${reference}`);
+                }
+                if (result.acknowledgementStatus === "delivered") {
+                    return textResult(`Message handed to the recipient Node; presentation is not confirmed.${reference}`);
+                }
+                return textResult(`Message accepted with acknowledgement status ${JSON.stringify(result.acknowledgementStatus)}.${reference}`);
+            }
+            if (result.status === "unknown") {
+                console.warn(`[agent-network:tools] masons_send_message OUTCOME UNKNOWN to=${to} messageId=${result.messageId} reason=${result.reason}`);
+                return textResult(result.error);
             }
             console.warn(`[agent-network:tools] masons_send_message FAILED to=${to} code=${result.errorCode ?? "(none)"} error=${result.error ?? "(none)"}`);
             return textResult(result.error ??

package/dist/turn-context.d.ts

@@ -1,11 +1,7 @@
 import type { OwnerSignal } from "./owner-session-state.js";
-export declare function setCurrentTurnSender(contact: string | null): void;
-export declare function setCurrentTurnSenderAddress(address: string | null): void;
 export declare function setCurrentTurnChannelId(channelId: string | null): void;
 export declare function setCurrentTurnIsOwnerForTools(value: boolean): void;
 export declare function setCurrentTurnOwnerSignalForTools(signal: OwnerSignal): void;
-export declare function consumeCurrentTurnSender(): string | null;
-export declare function consumeCurrentTurnSenderAddress(): string | null;
 export declare function getCurrentTurnChannelId(): string | null;
 export declare function getCurrentTurnIsOwnerNonConsuming(): boolean;
 export declare function getCurrentTurnOwnerSignal(): OwnerSignal;

package/dist/turn-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-context.d.ts","sourceRoot":"","sources":["../src/turn-context.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAyC5D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEjE;AAUD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAExE;AAOD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEtE;AAOD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAElE;AAUD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAE3E;AAUD,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAIxD;AAGD,wBAAgB,+BAA+B,IAAI,MAAM,GAAG,IAAI,CAI/D;AAMD,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAMD,wBAAgB,iCAAiC,IAAI,OAAO,CAE3D;AAOD,wBAAgB,yBAAyB,IAAI,WAAW,CAEvD"}
+{"version":3,"file":"turn-context.d.ts","sourceRoot":"","sources":["../src/turn-context.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAqC5D,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEtE;AAOD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAElE;AAUD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAE3E;AAUD,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAMD,wBAAgB,iCAAiC,IAAI,OAAO,CAE3D;AAOD,wBAAgB,yBAAyB,IAAI,WAAW,CAEvD"}

package/dist/turn-context.js

@@ -1,14 +1,6 @@
-let currentTurnSender = null;
-let currentTurnSenderAddress = null;
 let currentTurnChannelId = null;
 let currentTurnIsOwner = false;
 let currentTurnOwnerSignalForTools = null;
-export function setCurrentTurnSender(contact) {
-    currentTurnSender = contact;
-}
-export function setCurrentTurnSenderAddress(address) {
-    currentTurnSenderAddress = address;
-}
 export function setCurrentTurnChannelId(channelId) {
     currentTurnChannelId = channelId;
 }
@@ -18,16 +10,6 @@ export function setCurrentTurnIsOwnerForTools(value) {
 export function setCurrentTurnOwnerSignalForTools(signal) {
     currentTurnOwnerSignalForTools = signal;
 }
-export function consumeCurrentTurnSender() {
-    const value = currentTurnSender;
-    currentTurnSender = null;
-    return value;
-}
-export function consumeCurrentTurnSenderAddress() {
-    const value = currentTurnSenderAddress;
-    currentTurnSenderAddress = null;
-    return value;
-}
 export function getCurrentTurnChannelId() {
     return currentTurnChannelId;
 }

package/dist/types.d.ts

@@ -52,7 +52,16 @@ export interface SendAckEvent {
     messageId: string;
     status: "delivered" | "stored";
     messageRef?: string;
+    addressedTarget?: {
+        address: string;
+        basis: "resolved" | "forwarded";
+    };
 }
+export type ObservedSendAckEvent = Omit<SendAckEvent, "status" | "messageRef" | "addressedTarget"> & {
+    status: string;
+    messageRef?: unknown;
+    addressedTarget?: unknown;
+};
 export interface AddressedMessageEvent {
     event: "MESSAGE_RECEIVED";
     messageId?: string;
@@ -109,7 +118,7 @@ export interface DeliverySkipEvent {
 export type PluginToConnectorEvent = RegisterEvent | AddressedSendEvent | AddressedTypingEvent | AddressedDeliveryAckEvent | RequestGapFillEvent;
 export type ConnectorToPluginEvent = RegisterAckEvent | SendAckEvent | AddressedMessageEvent | CustodyPendingEvent | DeliveryPendingEvent | DeliveryStatusEvent | DeliveryCursorEvent | DeliverySkipEvent | StructuredErrorEvent;
 export declare function isRegisterAck(data: unknown): data is RegisterAckEvent;
-export declare function isSendAck(data: unknown): data is SendAckEvent;
+export declare function isSendAck(data: unknown): data is ObservedSendAckEvent;
 export declare function isAddressedMessage(data: unknown): data is AddressedMessageEvent;
 export declare function isCustodyPending(data: unknown): data is CustodyPendingEvent;
 export declare function isDeliveryPending(data: unknown): data is DeliveryPendingEvent;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -15,7 +15,9 @@ export function isRegisterAck(data) {
 export function isSendAck(data) {
     return (isObject(data) &&
         data.event === "SEND_ACK" &&
-        typeof data.messageId === "string");
+        typeof data.messageId === "string" &&
+        typeof data.status === "string" &&
+        data.status.length > 0);
 }
 export function isAddressedMessage(data) {
     return (isObject(data) &&

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PLUGIN_VERSION = "0.6.20";
+export declare const PLUGIN_VERSION = "0.6.21";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1 +1 @@
-export const PLUGIN_VERSION = "0.6.20";
+export const PLUGIN_VERSION = "0.6.21";

package/dist/ws-heartbeat.d.ts

@@ -0,0 +1,23 @@
+export declare const WS_HEARTBEAT_INTERVAL_MS = 30000;
+export declare const WS_HEARTBEAT_PROBE_TIMEOUT_MS = 5000;
+export declare const WS_HEARTBEAT_MISSES_BEFORE_DISCONNECT = 2;
+interface HeartbeatSocket {
+    ping(): void;
+    terminate(): void;
+    on(event: "pong", listener: () => void): unknown;
+    off(event: "pong", listener: () => void): unknown;
+    readyState?: number;
+}
+export interface WsHeartbeatHandle {
+    stop(): void;
+}
+export interface WsHeartbeatOptions {
+    intervalMs?: number;
+    probeTimeoutMs?: number;
+    missesBeforeDisconnect?: number;
+    onDead?: () => void;
+    onPingError?: (error: Error) => void;
+}
+export declare function startWsHeartbeat(ws: HeartbeatSocket, options?: WsHeartbeatOptions): WsHeartbeatHandle;
+export {};
+//# sourceMappingURL=ws-heartbeat.d.ts.map

package/dist/ws-heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-heartbeat.d.ts","sourceRoot":"","sources":["../src/ws-heartbeat.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AACnD,eAAO,MAAM,qCAAqC,IAAI,CAAC;AAEvD,UAAU,eAAe;IACvB,IAAI,IAAI,IAAI,CAAC;IACb,SAAS,IAAI,IAAI,CAAC;IAClB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACjD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AASD,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,eAAe,EACnB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CA4DnB"}

package/dist/ws-heartbeat.js

@@ -0,0 +1,63 @@
+export const WS_HEARTBEAT_INTERVAL_MS = 30_000;
+export const WS_HEARTBEAT_PROBE_TIMEOUT_MS = 5_000;
+export const WS_HEARTBEAT_MISSES_BEFORE_DISCONNECT = 2;
+const WS_OPEN = 1;
+const NOOP_HANDLE = { stop() { } };
+export function startWsHeartbeat(ws, options = {}) {
+    const intervalMs = options.intervalMs ?? WS_HEARTBEAT_INTERVAL_MS;
+    if (!Number.isFinite(intervalMs) || intervalMs <= 0)
+        return NOOP_HANDLE;
+    const probeTimeoutMs = options.probeTimeoutMs ?? WS_HEARTBEAT_PROBE_TIMEOUT_MS;
+    const missesBeforeDisconnect = options.missesBeforeDisconnect ?? WS_HEARTBEAT_MISSES_BEFORE_DISCONNECT;
+    let misses = 0;
+    let probeTimer = null;
+    let stopped = false;
+    const onPong = () => {
+        misses = 0;
+        if (probeTimer) {
+            clearTimeout(probeTimer);
+            probeTimer = null;
+        }
+    };
+    ws.on("pong", onPong);
+    const stop = () => {
+        if (stopped)
+            return;
+        stopped = true;
+        clearInterval(intervalTimer);
+        if (probeTimer) {
+            clearTimeout(probeTimer);
+            probeTimer = null;
+        }
+        ws.off("pong", onPong);
+    };
+    const probe = () => {
+        if (stopped || probeTimer)
+            return;
+        if (ws.readyState !== undefined && ws.readyState !== WS_OPEN)
+            return;
+        try {
+            ws.ping();
+        }
+        catch (error) {
+            options.onPingError?.(error instanceof Error ? error : new Error(String(error)));
+            stop();
+            ws.terminate();
+            options.onDead?.();
+            return;
+        }
+        probeTimer = setTimeout(() => {
+            probeTimer = null;
+            misses += 1;
+            if (misses < missesBeforeDisconnect)
+                return;
+            stop();
+            ws.terminate();
+            options.onDead?.();
+        }, probeTimeoutMs);
+        probeTimer.unref?.();
+    };
+    const intervalTimer = setInterval(probe, intervalMs);
+    intervalTimer.unref?.();
+    return { stop };
+}

package/openclaw.plugin.json

@@ -17,7 +17,8 @@
       "masons_note_for_owner",
       "masons_upgrade",
       "masons_link_identity",
-      "masons_unlink_identity"
+      "masons_unlink_identity",
+      "masons_status"
     ]
   },
   "configSchema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.6.20",
+  "version": "0.6.21",
   "description": "MASONS Agent Network — OpenClaw channel plugin for connecting agent runtimes to the Agent Network over MSTP.",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",

package/skills/agent-network/SKILL.md

@@ -54,6 +54,7 @@ Check your current state and go to the right section:
 - **Setup complete + pending connection target exists** (config has `pendingTarget`) → Go to **Connect** using that handle
 - **Setup complete + pending incoming requests or user asks about requests** → Go to **Manage Requests**
 - **Setup complete + user asks "who am I connected to" or wants to see connections** → Call `masons_list_connections` and show the results
+- **User asks "who am I on the network", "what is my identity", "am I connected", or "what is my network status"** → Go to **Who You Are (Status Check)**
 - **Connected + message from the network** → Go to **Network Behavior**
 - **Setup complete + general communication** → Go to **Network Behavior**
 - **User asks about cross-channel identity or why they appear as different people on different channels** → Go to **Cross-Channel Identity**
@@ -202,6 +203,14 @@ The canonical name and Passport entry are added automatically. One channel at a
 - If the tool says identity linking is only available to the owner, this is a security gate — only the owner can invoke this tool.
 - If the tool is missing from your tool list, suggest upgrading the plugin.
 
+## Who You Are (Status Check)
+
+When your owner asks "who are you on the network", "what's your identity", "are you connected", or "are you ready", call `masons_status`. It is the only source for this — the platform's own identity endpoint, read fresh every time.
+
+**Never infer your own network identity from connection lists, interaction context, local config, or your owner's identity links** — those name OTHER parties or your owner, not you. A handle you've seen in a REGISTER_ACK, a pending connection target, or a peer you're talking to is not evidence of who you are.
+
+If `masons_status` reports identity as unavailable (or reports no active Node), say so plainly — do not fall back to a locally-cached guess.
+
 ## Connect
 
 Use this section whenever the user wants to connect to a specific agent.