@masons/agent-network 0.5.22 → 0.5.24

package/dist/channel-setup.d.ts

@@ -2,6 +2,7 @@ interface StartChannelSetupOptions {
     apiHost: string;
     connectorUrl: string;
     idpBaseUrl: string;
+    invitedBy?: string;
 }
 export interface ChannelSetupResult {
     status: "pending" | "completed" | "expired" | "failed";

package/dist/channel-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-setup.d.ts","sourceRoot":"","sources":["../src/channel-setup.ts"],"names":[],"mappings":"AAeA,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAgBD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,wBAAgB,6BAA6B,IAAI,wBAAwB,CAMxE;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA8B7B;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAejE;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,GAAG,IAAI,CAMrE;AA8DD,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAED,eAAO,MAAM,oBAAoB,QAAqB,CAAC"}
+{"version":3,"file":"channel-setup.d.ts","sourceRoot":"","sources":["../src/channel-setup.ts"],"names":[],"mappings":"AAeA,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAMnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuBD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,wBAAgB,6BAA6B,IAAI,wBAAwB,CAMxE;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA+B7B;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAejE;AAED,wBAAgB,yBAAyB,IAAI,kBAAkB,GAAG,IAAI,CAMrE;AAmED,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD;AAED,eAAO,MAAM,oBAAoB,QAAqB,CAAC"}

package/dist/channel-setup.js

@@ -29,6 +29,7 @@ export async function startOrGetChannelSetup(options) {
         apiHost: options.apiHost,
         connectorUrl: options.connectorUrl,
         idpBaseUrl: options.idpBaseUrl,
+        invitedBy: options.invitedBy,
     };
     pendingSetup = record;
     void completePendingSetup(record);
@@ -85,7 +86,7 @@ async function completePendingSetup(record) {
             connectorUrl: existingConnectorUrl ?? record.connectorUrl,
             token: handoff.token,
         };
-        await writeCredentials(creds, record.apiHost, record.idpBaseUrl);
+        await writeCredentials(creds, record.apiHost, record.idpBaseUrl, record.invitedBy);
         lastSetupStatus = {
             status: "completed",
             agentHandle: handoff.agent.handle,

package/dist/channel.d.ts

@@ -39,6 +39,8 @@ interface ChannelGatewayContext<T = unknown> {
     runtime: unknown;
     abortSignal: AbortSignal;
 }
+declare function withAgentNetworkSilentReplyPolicy(cfg: Record<string, unknown>): Record<string, unknown>;
+export declare const _withAgentNetworkSilentReplyPolicyForTesting: typeof withAgentNetworkSilentReplyPolicy;
 interface ChannelGatewayAdapter<T = unknown> {
     startAccount?(ctx: ChannelGatewayContext<T>): Promise<unknown>;
     stopAccount?(ctx: ChannelGatewayContext<T>): Promise<void>;

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAmC9D,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAOD,wBAAgB,2BAA2B,IAAI,OAAO,CAIrD;AAGD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/D;AAUD,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,oBAAoB,CAAC,CAAC;IAC9B,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;IACvD,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACpE,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACjE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACzE;AAED,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAuDD,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,YAAY,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,WAAW,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,UAAU,yBAAyB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAClD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;CACrD;AA4WD,eAAO,MAAM,mBAAmB,EAAE,yBAyNjC,CAAC"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAoC9D,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAOD,wBAAgB,2BAA2B,IAAI,OAAO,CAIrD;AAGD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/D;AAUD,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,oBAAoB,CAAC,CAAC;IAC9B,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC;IACvD,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IACpE,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACjE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CAC/D;AAED,UAAU,sBAAsB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,sBAAsB;IAC9B,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9C,QAAQ,CAAC,CAAC,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACzE;AAED,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CAC1B;AA2DD,iBAAS,iCAAiC,CACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB;AAED,eAAO,MAAM,4CAA4C,0CACtB,CAAC;AAEpC,UAAU,qBAAqB,CAAC,CAAC,GAAG,OAAO;IACzC,YAAY,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,WAAW,CAAC,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5D;AAED,UAAU,yBAAyB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,mBAAmB,CAAC;IAClC,MAAM,EAAE,oBAAoB,CAAC,mBAAmB,CAAC,CAAC;IAClD,QAAQ,EAAE,sBAAsB,CAAC;IACjC,OAAO,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;CACrD;AAyYD,eAAO,MAAM,mBAAmB,EAAE,yBAyNjC,CAAC"}

package/dist/channel.js

@@ -5,7 +5,7 @@ import { ConnectorClient } from "./connector-client.js";
 import { ConversationManager } from "./conversation-manager.js";
 import { clearEnvironmentContext } from "./environment-context.js";
 import { extractHandleFromAddress } from "./handle-utils.js";
-import { clearOwnerState, isOwnerAddress, markOwnerAddress, setCurrentTurnIsOwner, } from "./owner-session-state.js";
+import { clearOwnerState, isOwnerAddress, markOwnerAddress, setCurrentTurnIsOwner, setCurrentTurnOwnerSignal, } from "./owner-session-state.js";
 import { setCurrentTurnSender } from "./turn-context.js";
 import { checkForUpdate } from "./update-check.js";
 const dbg = createDebug("agent-network:channel");
@@ -24,6 +24,39 @@ export function consumeIdentityLinkingNudge() {
 export function _setNudgePendingForTesting(value) {
     identityLinkingNudgePending = value;
 }
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function withAgentNetworkSilentReplyPolicy(cfg) {
+    const surfaces = isRecord(cfg.surfaces) ? cfg.surfaces : {};
+    const existingSurface = isRecord(surfaces["agent-network"])
+        ? surfaces["agent-network"]
+        : {};
+    const silentReply = isRecord(existingSurface.silentReply)
+        ? existingSurface.silentReply
+        : {};
+    const silentReplyRewrite = isRecord(existingSurface.silentReplyRewrite)
+        ? existingSurface.silentReplyRewrite
+        : {};
+    return {
+        ...cfg,
+        surfaces: {
+            ...surfaces,
+            "agent-network": {
+                ...existingSurface,
+                silentReply: {
+                    ...silentReply,
+                    direct: "allow",
+                },
+                silentReplyRewrite: {
+                    ...silentReplyRewrite,
+                    direct: false,
+                },
+            },
+        },
+    };
+}
+export const _withAgentNetworkSilentReplyPolicyForTesting = withAgentNetworkSilentReplyPolicy;
 function tryProjectNodeRef(metadata) {
     if (!metadata)
         return null;
@@ -95,6 +128,7 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
     const nodeRef = tryProjectNodeRef(event.metadata);
     if (nodeRef) {
         setCurrentTurnIsOwner(false);
+        setCurrentTurnOwnerSignal(null);
         dbg("Full Node sender: kind=%s mstpAddress=%s handle=%s", nodeRef.kind, nodeRef.mstpAddress, nodeRef.handle ?? "(absent)");
     }
     else {
@@ -113,6 +147,15 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
             }
         }
         setCurrentTurnIsOwner(isOwnerAddress(fromAddress));
+        if (event.metadata?.is_owner === true) {
+            setCurrentTurnOwnerSignal("owner");
+        }
+        else if (event.metadata?.is_owner === false) {
+            setCurrentTurnOwnerSignal("non-owner");
+        }
+        else {
+            setCurrentTurnOwnerSignal(null);
+        }
     }
     const contact = nodeRef
         ? deriveNodeName(nodeRef, fromAddress)
@@ -179,7 +222,7 @@ async function handleAddressedMessage(event, conversationManager, client, ctx) {
         try {
             await runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher({
                 ctx: msgCtx,
-                cfg: ctx.cfg,
+                cfg: withAgentNetworkSilentReplyPolicy(ctx.cfg),
                 dispatcherOptions: {
                     deliver: async (payload) => {
                         const text = payload.text;

package/dist/config-schema.d.ts

@@ -1,7 +1,7 @@
 import { type Static } from "@sinclair/typebox";
 export declare const AgentNetworkAccountSchema: import("@sinclair/typebox").TObject<{
-    connectorUrl: import("@sinclair/typebox").TString;
-    token: import("@sinclair/typebox").TString;
+    connectorUrl: import("@sinclair/typebox").TString<string>;
+    token: import("@sinclair/typebox").TString<string>;
 }>;
 export type AgentNetworkAccount = Static<typeof AgentNetworkAccountSchema>;
 //# sourceMappingURL=config-schema.d.ts.map

package/dist/config.d.ts

@@ -26,7 +26,7 @@ export interface NetworkCredentials {
     token: string;
 }
 export declare function readExistingConnectorUrl(): Promise<string | undefined>;
-export declare function writeCredentials(creds: NetworkCredentials, apiHost?: string, idpBaseUrl?: string): Promise<void>;
+export declare function writeCredentials(creds: NetworkCredentials, apiHost?: string, idpBaseUrl?: string, pendingTarget?: string): Promise<void>;
 export declare function writeTargetHandle(handle: string): Promise<void>;
 export declare function clearTargetHandle(): Promise<void>;
 export declare function markProfileNeeded(): Promise<void>;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAoCjD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAsBD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMhC;AAYD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAyCjE;AAuCD,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAWD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAeD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAOjE;AAQD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAYD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAE1E;AASD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAKD,wBAAgB,0BAA0B,IAAI,mBAAmB,CAOhE;AASD,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,CAEnE;AAgBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAKD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAQD,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C;AAcD,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AAKD,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAKD,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AASD,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AASD,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD;AAyBD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW5E;AAYD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAUD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE;AASD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CASvD;AAYD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvD;AAUD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD;AAwCD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAQD,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B1E;AAOD,MAAM,WAAW,YAAY;IAE3B,cAAc,EAAE,OAAO,CAAC;IAExB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,YAAY,EAAE,OAAO,CAAC;CACvB;AASD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CA2BhE;AAOD,wBAAgB,gBAAgB,IAAI,IAAI,CAWvC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAoCjD,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAsBD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMhC;AAYD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAyCjE;AAuCD,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAWD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAeD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAOjE;AAQD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAYD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAE1E;AASD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAKD,wBAAgB,0BAA0B,IAAI,mBAAmB,CAOhE;AASD,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,CAEnE;AAgBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExD;AAKD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAQD,wBAAgB,oBAAoB,IAAI,OAAO,CAO9C;AAcD,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AAKD,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAKD,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AASD,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AASD,wBAAgB,sBAAsB,IAAI,eAAe,CAOxD;AAyBD,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAQD,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW5E;AAmBD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CA0Cf;AAUD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE;AASD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CASvD;AAYD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOvD;AAUD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD;AAwCD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAQD,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B1E;AAOD,MAAM,WAAW,YAAY;IAE3B,cAAc,EAAE,OAAO,CAAC;IAExB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,YAAY,EAAE,OAAO,CAAC;CACvB;AASD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,YAAY,CAAC,CA2BhE;AAOD,wBAAgB,gBAAgB,IAAI,IAAI,CAWvC"}

package/dist/config.js

@@ -141,7 +141,7 @@ export async function readExistingConnectorUrl() {
         ? connectorUrl
         : undefined;
 }
-export async function writeCredentials(creds, apiHost, idpBaseUrl) {
+export async function writeCredentials(creds, apiHost, idpBaseUrl, pendingTarget) {
     const config = await readConfig();
     const section = ensureNetworkSection(config);
     section.enabled = true;
@@ -160,8 +160,14 @@ export async function writeCredentials(creds, apiHost, idpBaseUrl) {
     if (idpBaseUrl) {
         section.idpBaseUrl = idpBaseUrl;
     }
+    if (pendingTarget) {
+        section.pendingTarget = pendingTarget;
+    }
     await persistConfig(config);
     storedApiKey = creds.token;
+    if (pendingTarget) {
+        storedPendingTarget = pendingTarget;
+    }
     stateCacheGeneration++;
 }
 export async function writeTargetHandle(handle) {

package/dist/owner-session-state.d.ts

@@ -1,6 +1,9 @@
+export type OwnerSignal = "owner" | "non-owner" | null;
 export declare function markOwnerAddress(address: string): void;
 export declare function isOwnerAddress(address: string): boolean;
 export declare function clearOwnerState(): void;
 export declare function setCurrentTurnIsOwner(value: boolean): void;
+export declare function setCurrentTurnOwnerSignal(signal: OwnerSignal): void;
 export declare function consumeCurrentTurnIsOwner(): boolean;
+export declare function consumeCurrentTurnOwnerSignal(): OwnerSignal;
 //# sourceMappingURL=owner-session-state.d.ts.map

package/dist/owner-session-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"owner-session-state.d.ts","sourceRoot":"","sources":["../src/owner-session-state.ts"],"names":[],"mappings":"AA+BA,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtD;AAGD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAGD,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAMD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE1D;AAUD,wBAAgB,yBAAyB,IAAI,OAAO,CAInD"}
+{"version":3,"file":"owner-session-state.d.ts","sourceRoot":"","sources":["../src/owner-session-state.ts"],"names":[],"mappings":"AAmDA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,IAAI,CAAC;AAQvD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtD;AAGD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAGD,wBAAgB,eAAe,IAAI,IAAI,CAItC;AAMD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE1D;AAYD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAEnE;AAUD,wBAAgB,yBAAyB,IAAI,OAAO,CAInD;AASD,wBAAgB,6BAA6B,IAAI,WAAW,CAI3D"}

package/dist/owner-session-state.js

@@ -1,5 +1,6 @@
 const ownerAddresses = new Set();
 let currentTurnIsOwner = false;
+let currentTurnOwnerSignal = null;
 export function markOwnerAddress(address) {
     ownerAddresses.add(address);
 }
@@ -9,12 +10,21 @@ export function isOwnerAddress(address) {
 export function clearOwnerState() {
     ownerAddresses.clear();
     currentTurnIsOwner = false;
+    currentTurnOwnerSignal = null;
 }
 export function setCurrentTurnIsOwner(value) {
     currentTurnIsOwner = value;
 }
+export function setCurrentTurnOwnerSignal(signal) {
+    currentTurnOwnerSignal = signal;
+}
 export function consumeCurrentTurnIsOwner() {
     const value = currentTurnIsOwner;
     currentTurnIsOwner = false;
     return value;
 }
+export function consumeCurrentTurnOwnerSignal() {
+    const value = currentTurnOwnerSignal;
+    currentTurnOwnerSignal = null;
+    return value;
+}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAiJA,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CACV,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;IACR,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaI,iBAAiB;CA4XhC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAqJA,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CACV,IAAI,EAAE,OAAO,EACb,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;IACR,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaI,iBAAiB;CA+XhC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/plugin.js

@@ -4,10 +4,10 @@ import { login } from "./cli-setup.js";
 import { detectPendingState, getConversationManager, getDmScope, getStateCacheGeneration, initPluginRuntime, } from "./config.js";
 import { getAgentIdentity } from "./environment-context.js";
 import { ownerNotesQueue } from "./owner-notes.js";
-import { consumeCurrentTurnIsOwner } from "./owner-session-state.js";
+import { consumeCurrentTurnIsOwner, consumeCurrentTurnOwnerSignal, } from "./owner-session-state.js";
 import { sentMessageBuffer } from "./sent-message-buffer.js";
 import { registerTools } from "./tools.js";
-import { consumeCurrentTurnSender, setCurrentTurnChannelId, setCurrentTurnIsOwnerForTools, } from "./turn-context.js";
+import { consumeCurrentTurnSender, setCurrentTurnChannelId, setCurrentTurnIsOwnerForTools, setCurrentTurnOwnerSignalForTools, } from "./turn-context.js";
 import { getUpdateInfo } from "./update-check.js";
 import { PLUGIN_VERSION } from "./version.js";
 function formatTimeAgo(timestamp) {
@@ -133,9 +133,11 @@ const plugin = {
             const hookCtx = ctx;
             const channelId = hookCtx?.channelId;
             const turnIsOwner = consumeCurrentTurnIsOwner();
+            const turnOwnerSignal = consumeCurrentTurnOwnerSignal();
             const turnSender = consumeCurrentTurnSender();
             setCurrentTurnChannelId(channelId ?? null);
             setCurrentTurnIsOwnerForTools(turnIsOwner);
+            setCurrentTurnOwnerSignalForTools(turnOwnerSignal);
             const currentGeneration = getStateCacheGeneration();
             if (!cachedState || cachedGeneration !== currentGeneration) {
                 try {

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAoEA,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,EAClC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;CACT;AAmCD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AA2ND,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAoyBhD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAqEA,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,EAClC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,IAAI,CAAC;CACT;AAmCD,wBAAgB,qBAAqB,IAAI,IAAI,CAI5C;AAqRD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CA80BhD"}

package/dist/tools.js

@@ -6,7 +6,7 @@ import { getOwnerHandle } from "./environment-context.js";
 import { ownerNotesQueue } from "./owner-notes.js";
 import { acceptRequest, declineRequest, listConnections, listRequests, PlatformApiError, requestConnection, updateProfile, } from "./platform-client.js";
 import { sentMessageBuffer } from "./sent-message-buffer.js";
-import { getCurrentTurnChannelId, getCurrentTurnIsOwnerNonConsuming, } from "./turn-context.js";
+import { getCurrentTurnChannelId, getCurrentTurnIsOwnerNonConsuming, getCurrentTurnOwnerSignal, } from "./turn-context.js";
 import { getLatestPublishedVersion, getPluginVersion, getUpdateInfo, } from "./update-check.js";
 const PROFILE_FIELDS = new Set(["name", "scope", "about", "audience"]);
 const UPGRADE_CMD = "openclaw plugins update agent-network";
@@ -56,12 +56,17 @@ function formatConnectionResult(requestIds, status) {
     }
     return `Connection request sent. Status: ${status}. The other agent's owner will be notified.`;
 }
-function resolveSetupAuthority(ctx) {
-    if (ctx.senderIsOwner === false) {
-        return { allowed: false, reason: "known-non-owner" };
+function resolveSetupAuthority() {
+    const channelId = getCurrentTurnChannelId();
+    if (channelId !== "agent-network") {
+        return { allowed: true };
     }
-    if (ctx.senderIsOwner === true)
+    const signal = getCurrentTurnOwnerSignal();
+    if (signal === "owner")
         return { allowed: true };
+    if (signal === "non-owner") {
+        return { allowed: false, reason: "known-non-owner" };
+    }
     return { allowed: false, reason: "ambiguous" };
 }
 function getSetupOptionsFromToolContext(ctx) {
@@ -116,20 +121,25 @@ function terminalSetupInstructions() {
         "its own runtime key. Re-running login here updates this OpenClaw install's credentials.",
     ].join("\n");
 }
-function ownerFallbackText(reason) {
+function ownerRefusalText(reason) {
     if (reason === "known-non-owner") {
         return [
-            "Agent Network setup is owner-only. I cannot generate a MASONS handoff URL for this sender.",
-            "",
-            terminalSetupInstructions(),
+            "Setup is owner-only. You are reaching this agent through the MASONS",
+            "network as a visitor or as a peer agent. Setup re-binds the OpenClaw",
+            "runtime to a specific agent identity, so it must be initiated by the",
+            "agent's runtime owner from a channel their OpenClaw is configured for.",
         ].join("\n");
     }
     return [
-        "I cannot verify this channel sender as the OpenClaw owner, so I will not generate a MASONS setup link here.",
+        "Setup is owner-only on the MASONS network channel. I could not verify",
+        "that you are this agent's owner from the message received.",
         "",
-        "Use the terminal fallback, or configure OpenClaw owner authority for this channel and ask again:",
+        "If you are the agent's runtime owner, please initiate setup from a",
+        "channel your OpenClaw runtime is configured for (e.g., Lark, Telegram,",
+        "desktop). The terminal command works as a last resort if no other channel",
+        "is reachable:",
         "",
-        terminalSetupInstructions(),
+        "  openclaw channels login --channel agent-network",
     ].join("\n");
 }
 function formatChannelSetupResult(result) {
@@ -175,24 +185,46 @@ export function registerTools(api) {
         description: [
             "Start or inspect Agent Network setup.",
             "Use when the user asks to set up Agent Network, when other Agent",
-            "Network tools fail with a 'no credentials' / 'no runtime key' error, or",
-            "when the owner wants to switch which MASONS agent OpenClaw is driving.",
+            "Network tools fail with a 'no credentials' error, or when the runtime",
+            "owner wants to switch which MASONS agent OpenClaw is driving.",
             "",
-            "If the current channel sender is verified as the OpenClaw owner, this",
-            "tool starts an encrypted MASONS browser handoff and returns the URL.",
-            "If owner authority is missing or false, it returns terminal fallback",
-            "instructions and never generates a setup URL.",
+            "Pass `invitedBy` if the user came from another agent's profile page",
+            "(handle extracted from the URL); the plugin will record it and propose",
+            "a connection request after setup completes.",
+            "",
+            "This tool returns a browser handoff URL on the channel where you are",
+            "running. The user opens it, signs in, picks an agent, and the encrypted",
+            "handoff completes in the background. After completion, restart the",
+            "gateway to activate realtime messaging.",
+            "",
+            "If the user is reaching this agent through the MASONS network as a",
+            "visitor (not the agent's owner), this tool refuses with an explanation",
+            "— setup is owner-only because it re-binds the OpenClaw runtime to a",
+            "specific agent identity.",
         ].join("\n"),
-        parameters: Type.Object({}),
-        execute: async () => {
-            const authority = resolveSetupAuthority(ctx);
+        parameters: Type.Object({
+            invitedBy: Type.Optional(Type.String({
+                description: "Handle of the agent whose profile page the user came from " +
+                    "(e.g., 'alice' from 'masons.ai/alice'). When setup completes, " +
+                    "the plugin records this as a pending connection target so the " +
+                    "agent can propose a connection request automatically.",
+            })),
+        }),
+        execute: async (_id, params) => {
+            const authority = resolveSetupAuthority();
             if (!authority.allowed) {
-                return textResult(ownerFallbackText(authority.reason ?? "ambiguous"));
+                return textResult(ownerRefusalText(authority.reason ?? "ambiguous"));
             }
+            const invitedBy = typeof params.invitedBy === "string" && params.invitedBy.length > 0
+                ? params.invitedBy
+                : undefined;
             const existing = consumeChannelSetupStatus();
             const result = existing
                 ? existing
-                : await startOrGetChannelSetup(getSetupOptionsFromToolContext(ctx));
+                : await startOrGetChannelSetup({
+                    ...getSetupOptionsFromToolContext(ctx),
+                    invitedBy,
+                });
             return textResult(formatChannelSetupResult(result));
         },
     }), { name: "masons_setup" });

package/dist/turn-context.d.ts

@@ -1,7 +1,10 @@
+import type { OwnerSignal } from "./owner-session-state.js";
 export declare function setCurrentTurnSender(contact: 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 getCurrentTurnChannelId(): string | null;
 export declare function getCurrentTurnIsOwnerNonConsuming(): boolean;
+export declare function getCurrentTurnOwnerSignal(): OwnerSignal;
 //# sourceMappingURL=turn-context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"turn-context.d.ts","sourceRoot":"","sources":["../src/turn-context.ts"],"names":[],"mappings":"AAyCA,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEjE;AAOD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEtE;AAOD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAElE;AAUD,wBAAgB,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAIxD;AAMD,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAMD,wBAAgB,iCAAiC,IAAI,OAAO,CAE3D"}
+{"version":3,"file":"turn-context.d.ts","sourceRoot":"","sources":["../src/turn-context.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAwC5D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEjE;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;AAMD,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,6 +1,7 @@
 let currentTurnSender = null;
 let currentTurnChannelId = null;
 let currentTurnIsOwner = false;
+let currentTurnOwnerSignalForTools = null;
 export function setCurrentTurnSender(contact) {
     currentTurnSender = contact;
 }
@@ -10,6 +11,9 @@ export function setCurrentTurnChannelId(channelId) {
 export function setCurrentTurnIsOwnerForTools(value) {
     currentTurnIsOwner = value;
 }
+export function setCurrentTurnOwnerSignalForTools(signal) {
+    currentTurnOwnerSignalForTools = signal;
+}
 export function consumeCurrentTurnSender() {
     const value = currentTurnSender;
     currentTurnSender = null;
@@ -21,3 +25,6 @@ export function getCurrentTurnChannelId() {
 export function getCurrentTurnIsOwnerNonConsuming() {
     return currentTurnIsOwner;
 }
+export function getCurrentTurnOwnerSignal() {
+    return currentTurnOwnerSignalForTools;
+}

package/dist/version.d.ts

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

package/dist/version.js

@@ -1 +1 @@
-export const PLUGIN_VERSION = "0.5.22";
+export const PLUGIN_VERSION = "0.5.24";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.5.22",
+  "version": "0.5.24",
   "description": "MASONS plugin for OpenClaw — connect your agent to the agent network",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",
@@ -19,15 +19,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "tsc -p test/tsconfig.json && node --test --loader ts-node/esm test/**/*.test.ts",
-    "lint": "biome check",
-    "format": "biome format --write",
-    "prepublishOnly": "bash scripts/check-version.sh && npm run build && npm run test",
-    "release": "pnpm publish --access public"
-  },
   "files": [
     "dist/",
     "openclaw.plugin.json",
@@ -78,5 +69,13 @@
     "@types/ws": "^8",
     "ts-node": "^10",
     "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "tsc -p test/tsconfig.json && node --test --loader ts-node/esm test/**/*.test.ts",
+    "lint": "biome check",
+    "format": "biome format --write",
+    "release": "pnpm publish --access public"
   }
-}
+}

package/dist/session-lifecycle.d.ts

@@ -1,89 +0,0 @@
-/**
- * Session Lifecycle — manages MSTP session state per contact.
- *
- * State machine: idle -> creating -> active -> recreating -> failed.
- * Internal key: MSTP address (not handle) — supports same handle on different Connectors.
- *
- * Responsibilities:
- * - Maps MSTP address to session state (sessionId, status, pending promise)
- * - Auto-creates sessions on demand via ensureSession()
- * - Deduplicates concurrent creates (second caller awaits first's promise)
- * - Registers inbound sessions from remote agents
- * - Invalidates all sessions on transport disconnect
- * - Subscribes to ConnectorClient events: session_created, session_error, session_ended, disconnected
- *
- * @see docs/openclaw/session-abstraction-system-design.md §6.1
- */
-import type { ConnectorClient } from "./connector-client.js";
-export type SessionStatus = "idle" | "creating" | "active" | "recreating" | "failed";
-export interface SessionState {
-    status: SessionStatus;
-    sessionId: string | null;
-    pendingRequestId: string | null;
-    retryCount: number;
-    /** Promise that resolves when session creation completes. Used for dedup. */
-    createPromise: Promise<string> | null;
-    /** Resolve function for the create promise. */
-    createResolve: ((sessionId: string) => void) | null;
-    /** Reject function for the create promise. */
-    createReject: ((err: Error) => void) | null;
-}
-export declare class SessionLifecycle {
-    private readonly client;
-    /** Primary map: MSTP address -> session state */
-    private readonly sessions;
-    /** Reverse index: sessionId -> MSTP address */
-    private readonly sessionToAddress;
-    /** Configurable timeout for tests */
-    private timeoutMs;
-    constructor(client: ConnectorClient);
-    /**
-     * Ensure an active session exists for the given address.
-     * Returns the sessionId. Creates a new session if none exists.
-     * Concurrent callers get the same promise (dedup).
-     */
-    ensureSession(address: string): Promise<string>;
-    /**
-     * Get the active sessionId for an address, or null.
-     */
-    getSession(address: string): string | null;
-    /**
-     * Close the session for an address.
-     */
-    closeSession(address: string, reason?: string): void;
-    /**
-     * Register an inbound session (remote initiated).
-     */
-    registerInbound(sessionId: string, address: string): void;
-    /**
-     * Invalidate all sessions. Called on transport disconnect.
-     * Conversations are preserved but sessions are cleared.
-     */
-    invalidateAll(): void;
-    /**
-     * Reverse lookup: sessionId -> MSTP address.
-     */
-    getAddressBySessionId(sessionId: string): string | undefined;
-    /**
-     * Get all session entries (for listing conversations).
-     */
-    listSessions(): Array<{
-        address: string;
-        status: SessionStatus;
-        sessionId: string | null;
-    }>;
-    /**
-     * Remove a session entry entirely (for endConversation).
-     */
-    removeSession(address: string): void;
-    /** @internal Override timeout for tests. */
-    _setTimeoutForTesting(ms: number): void;
-    /** @internal Reset for test isolation. */
-    _resetForTesting(): void;
-    private subscribe;
-    private createNewSession;
-    private handleSessionCreated;
-    private handleSessionEnded;
-    private handleSessionError;
-}
-//# sourceMappingURL=session-lifecycle.d.ts.map

package/dist/session-lifecycle.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session-lifecycle.d.ts","sourceRoot":"","sources":["../src/session-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQ7D,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACtC,+CAA+C;IAC/C,aAAa,EAAE,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IACpD,8CAA8C;IAC9C,YAAY,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC7C;AAaD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,iDAAiD;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAE9D,qCAAqC;IACrC,OAAO,CAAC,SAAS,CAA6B;gBAElC,MAAM,EAAE,eAAe;IASnC;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB/C;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQ1C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAqBpD;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBzD;;;OAGG;IACH,aAAa,IAAI,IAAI;IAqBrB;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5D;;OAEG;IACH,YAAY,IAAI,KAAK,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,aAAa,CAAC;QACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC;IAgBF;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAcpC,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIvC,0CAA0C;IAC1C,gBAAgB,IAAI,IAAI;IAmBxB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,gBAAgB;IA+GxB,OAAO,CAAC,oBAAoB;IAuC5B,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,kBAAkB;CA0B3B"}

package/dist/session-lifecycle.js

@@ -1,348 +0,0 @@
-/**
- * Session Lifecycle — manages MSTP session state per contact.
- *
- * State machine: idle -> creating -> active -> recreating -> failed.
- * Internal key: MSTP address (not handle) — supports same handle on different Connectors.
- *
- * Responsibilities:
- * - Maps MSTP address to session state (sessionId, status, pending promise)
- * - Auto-creates sessions on demand via ensureSession()
- * - Deduplicates concurrent creates (second caller awaits first's promise)
- * - Registers inbound sessions from remote agents
- * - Invalidates all sessions on transport disconnect
- * - Subscribes to ConnectorClient events: session_created, session_error, session_ended, disconnected
- *
- * @see docs/openclaw/session-abstraction-system-design.md §6.1
- */
-import createDebug from "debug";
-const dbg = createDebug("agent-network:session-lifecycle");
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-const SESSION_CREATE_TIMEOUT_MS = 15_000;
-const MAX_RETRY_COUNT = 1;
-// ---------------------------------------------------------------------------
-// SessionLifecycle
-// ---------------------------------------------------------------------------
-export class SessionLifecycle {
-    client;
-    /** Primary map: MSTP address -> session state */
-    sessions = new Map();
-    /** Reverse index: sessionId -> MSTP address */
-    sessionToAddress = new Map();
-    /** Configurable timeout for tests */
-    timeoutMs = SESSION_CREATE_TIMEOUT_MS;
-    constructor(client) {
-        this.client = client;
-        this.subscribe();
-    }
-    // -------------------------------------------------------------------------
-    // Public API
-    // -------------------------------------------------------------------------
-    /**
-     * Ensure an active session exists for the given address.
-     * Returns the sessionId. Creates a new session if none exists.
-     * Concurrent callers get the same promise (dedup).
-     */
-    ensureSession(address) {
-        const state = this.sessions.get(address);
-        // Active session — return immediately
-        if (state?.status === "active" && state.sessionId) {
-            return Promise.resolve(state.sessionId);
-        }
-        // Creating/recreating — dedup: return existing promise
-        if ((state?.status === "creating" || state?.status === "recreating") &&
-            state.createPromise) {
-            return state.createPromise;
-        }
-        // Idle, failed, or no state — create new session
-        return this.createNewSession(address, state?.retryCount ?? 0);
-    }
-    /**
-     * Get the active sessionId for an address, or null.
-     */
-    getSession(address) {
-        const state = this.sessions.get(address);
-        if (state?.status === "active" && state.sessionId) {
-            return state.sessionId;
-        }
-        return null;
-    }
-    /**
-     * Close the session for an address.
-     */
-    closeSession(address, reason) {
-        const state = this.sessions.get(address);
-        if (!state)
-            return;
-        if (state.sessionId) {
-            this.client.endSession(state.sessionId, reason);
-            this.sessionToAddress.delete(state.sessionId);
-        }
-        // Reject any pending create promise
-        if (state.createReject) {
-            state.createReject(new Error("Session closed by caller"));
-            state.createResolve = null;
-            state.createReject = null;
-            state.createPromise = null;
-        }
-        this.sessions.delete(address);
-        dbg("closeSession address=%s", address);
-    }
-    /**
-     * Register an inbound session (remote initiated).
-     */
-    registerInbound(sessionId, address) {
-        // If there's an existing session for this address, clean up
-        const existing = this.sessions.get(address);
-        if (existing?.sessionId && existing.sessionId !== sessionId) {
-            this.sessionToAddress.delete(existing.sessionId);
-        }
-        const state = {
-            status: "active",
-            sessionId,
-            pendingRequestId: null,
-            retryCount: 0,
-            createPromise: null,
-            createResolve: null,
-            createReject: null,
-        };
-        this.sessions.set(address, state);
-        this.sessionToAddress.set(sessionId, address);
-        dbg("registerInbound sessionId=%s address=%s", sessionId, address);
-    }
-    /**
-     * Invalidate all sessions. Called on transport disconnect.
-     * Conversations are preserved but sessions are cleared.
-     */
-    invalidateAll() {
-        const count = this.sessions.size;
-        for (const [address, state] of this.sessions) {
-            // Reject pending creates
-            if (state.createReject) {
-                state.createReject(new Error("Transport disconnected"));
-                state.createResolve = null;
-                state.createReject = null;
-                state.createPromise = null;
-            }
-            // Reset to idle — next send() will auto-create
-            state.status = "idle";
-            state.sessionId = null;
-            state.pendingRequestId = null;
-            state.retryCount = 0;
-            this.sessions.set(address, state);
-        }
-        this.sessionToAddress.clear();
-        dbg("invalidateAll cleared %d sessions", count);
-    }
-    /**
-     * Reverse lookup: sessionId -> MSTP address.
-     */
-    getAddressBySessionId(sessionId) {
-        return this.sessionToAddress.get(sessionId);
-    }
-    /**
-     * Get all session entries (for listing conversations).
-     */
-    listSessions() {
-        const entries = [];
-        for (const [address, state] of this.sessions) {
-            entries.push({
-                address,
-                status: state.status,
-                sessionId: state.sessionId,
-            });
-        }
-        return entries;
-    }
-    /**
-     * Remove a session entry entirely (for endConversation).
-     */
-    removeSession(address) {
-        const state = this.sessions.get(address);
-        if (state?.sessionId) {
-            this.sessionToAddress.delete(state.sessionId);
-        }
-        if (state?.createReject) {
-            state.createReject(new Error("Session removed"));
-            state.createResolve = null;
-            state.createReject = null;
-            state.createPromise = null;
-        }
-        this.sessions.delete(address);
-    }
-    /** @internal Override timeout for tests. */
-    _setTimeoutForTesting(ms) {
-        this.timeoutMs = ms;
-    }
-    /** @internal Reset for test isolation. */
-    _resetForTesting() {
-        // Reject pending creates silently
-        for (const state of this.sessions.values()) {
-            if (state.createReject) {
-                state.createReject(new Error("Reset for testing"));
-                state.createResolve = null;
-                state.createReject = null;
-                state.createPromise = null;
-            }
-        }
-        this.sessions.clear();
-        this.sessionToAddress.clear();
-        this.timeoutMs = SESSION_CREATE_TIMEOUT_MS;
-    }
-    // -------------------------------------------------------------------------
-    // Private
-    // -------------------------------------------------------------------------
-    subscribe() {
-        this.client.on("session_created", (event) => {
-            this.handleSessionCreated(event.sessionId, event.requestId, event.direction);
-        });
-        this.client.on("session_error", (sessionId, message) => {
-            this.handleSessionError(sessionId, message);
-        });
-        this.client.on("session_ended", (event) => {
-            this.handleSessionEnded(event.sessionId);
-        });
-        this.client.on("disconnected", () => {
-            this.invalidateAll();
-        });
-    }
-    createNewSession(address, previousRetryCount) {
-        const status = previousRetryCount > 0 ? "recreating" : "creating";
-        let createResolve = null;
-        let createReject = null;
-        const createPromise = new Promise((resolve, reject) => {
-            createResolve = resolve;
-            createReject = reject;
-        });
-        const { requestId, sent } = this.client.createSession(address);
-        if (!sent) {
-            const state = {
-                status: "failed",
-                sessionId: null,
-                pendingRequestId: null,
-                retryCount: previousRetryCount,
-                createPromise: null,
-                createResolve: null,
-                createReject: null,
-            };
-            this.sessions.set(address, state);
-            return Promise.reject(new Error("Failed to create session: transport unavailable"));
-        }
-        const state = {
-            status,
-            sessionId: null,
-            pendingRequestId: requestId,
-            retryCount: previousRetryCount,
-            createPromise,
-            createResolve,
-            createReject,
-        };
-        this.sessions.set(address, state);
-        // Timeout
-        const timer = setTimeout(() => {
-            const current = this.sessions.get(address);
-            if (current &&
-                current.pendingRequestId === requestId &&
-                (current.status === "creating" || current.status === "recreating")) {
-                dbg("session create timeout address=%s requestId=%s", address, requestId);
-                // Can we retry?
-                if (current.retryCount < MAX_RETRY_COUNT) {
-                    // Move to failed, then retry
-                    current.status = "failed";
-                    current.retryCount++;
-                    current.pendingRequestId = null;
-                    const retryResolve = current.createResolve;
-                    const retryReject = current.createReject;
-                    current.createPromise = null;
-                    current.createResolve = null;
-                    current.createReject = null;
-                    this.sessions.set(address, current);
-                    // Retry: create a new session, pipe result to original promise
-                    this.createNewSession(address, current.retryCount)
-                        .then((sessionId) => retryResolve?.(sessionId))
-                        .catch((err) => retryReject?.(err));
-                }
-                else {
-                    // Max retries exhausted
-                    current.status = "idle";
-                    current.pendingRequestId = null;
-                    current.retryCount = 0;
-                    if (current.createReject) {
-                        current.createReject(new Error("Session creation timed out. The remote agent may be unavailable."));
-                    }
-                    current.createPromise = null;
-                    current.createResolve = null;
-                    current.createReject = null;
-                    this.sessions.set(address, current);
-                }
-            }
-        }, this.timeoutMs);
-        // Attach cleanup to the promise to clear the timer if resolved early
-        createPromise
-            .then(() => clearTimeout(timer))
-            .catch(() => clearTimeout(timer));
-        dbg("createNewSession address=%s requestId=%s status=%s retry=%d", address, requestId, status, previousRetryCount);
-        return createPromise;
-    }
-    handleSessionCreated(sessionId, requestId, direction) {
-        // Outbound: match by requestId
-        if (direction === "outbound" && requestId) {
-            for (const [address, state] of this.sessions) {
-                if (state.pendingRequestId === requestId &&
-                    (state.status === "creating" || state.status === "recreating")) {
-                    state.status = "active";
-                    state.sessionId = sessionId;
-                    state.pendingRequestId = null;
-                    this.sessionToAddress.set(sessionId, address);
-                    if (state.createResolve) {
-                        state.createResolve(sessionId);
-                    }
-                    state.createPromise = null;
-                    state.createResolve = null;
-                    state.createReject = null;
-                    dbg("session created (outbound) address=%s sessionId=%s", address, sessionId);
-                    return;
-                }
-            }
-        }
-        // Inbound sessions are registered externally via registerInbound()
-        // from the channel adapter (which has the metadata to derive the address).
-        // We don't handle inbound SESSION_CREATED here.
-    }
-    handleSessionEnded(sessionId) {
-        const address = this.sessionToAddress.get(sessionId);
-        if (!address)
-            return;
-        const state = this.sessions.get(address);
-        if (!state)
-            return;
-        // Only clear if this session is the current one
-        if (state.sessionId === sessionId) {
-            state.status = "idle";
-            state.sessionId = null;
-            dbg("session ended address=%s sessionId=%s", address, sessionId);
-        }
-        this.sessionToAddress.delete(sessionId);
-    }
-    handleSessionError(sessionId, message) {
-        const address = this.sessionToAddress.get(sessionId);
-        if (!address)
-            return;
-        const state = this.sessions.get(address);
-        if (!state)
-            return;
-        dbg("session error address=%s sessionId=%s message=%s", address, sessionId, message);
-        // Session error on active session — mark for auto-recreate on next send().
-        // Reset retryCount to 0: this is a new failure context (transport error),
-        // not a continuation of a creation timeout. The next ensureSession() gets
-        // a fresh retry budget.
-        if (state.status === "active") {
-            this.sessionToAddress.delete(sessionId);
-            state.status = "idle";
-            state.sessionId = null;
-            state.retryCount = 0;
-            dbg("auto-recreate queued address=%s", address);
-        }
-    }
-}