@masons/agent-network 0.5.23 → 0.5.25

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.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;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;AA+WD,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");
@@ -128,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 {
@@ -146,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)

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) {
@@ -126,16 +126,18 @@ const plugin = {
             "After responding on the network, check: " +
             "should you report to your owner via masons_note_for_owner? " +
             "Should you follow up with another agent via masons_send_message? " +
-            "When the interaction is complete, call masons_end_conversation as your FINAL local action; " +
-            "it does not close the Connector transport session, and you must not generate any text reply after ending. " +
+            "When the interaction is complete, call masons_end_conversation as your FINAL action — " +
+            "do not generate any text reply after ending. " +
             "";
         api.on("before_prompt_build", async (_event, ctx) => {
             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/runtime-endpoint-client.d.ts

@@ -0,0 +1,57 @@
+import { PlatformApiError, type PlatformClientConfig } from "./platform-client.js";
+export { PlatformApiError, type PlatformClientConfig };
+export type RuntimeKind = "claude-code" | "openclaw" | "codex" | "passport" | "custom" | (string & {});
+export interface WorkspaceMetadata {
+    root: string;
+    cwd: string;
+    remote?: string;
+    branch?: string;
+}
+export type ShareWithPeerField = "workspace" | "tracking_ref" | "runtime_session_id" | "fingerprint" | (string & {});
+export interface RegisterRuntimeEndpointParams {
+    as: string;
+    runtime_kind: RuntimeKind;
+    runtime_session_id?: string;
+    endpoint_nonce: string;
+    display_label: string;
+    workspace?: WorkspaceMetadata;
+    tracking_ref?: string;
+    share_with_peer?: ShareWithPeerField[];
+}
+export interface RegisterRuntimeEndpointResponse {
+    endpoint_id: string;
+    node_id: string;
+    display_label: string;
+    heartbeat_after_seconds: number;
+    lease_ttl_seconds: number;
+    soft_retention_seconds: number;
+    registered_at: string;
+}
+export interface OwnedRuntimeEndpointView {
+    endpoint_id: string;
+    node_id: string;
+    node_handle?: string;
+    runtime_kind: RuntimeKind;
+    runtime_session_id?: string;
+    display_label: string;
+    workspace?: WorkspaceMetadata;
+    tracking_ref?: string;
+    fingerprint?: {
+        workspace_hash_per_peer?: Record<string, string>;
+    };
+    registered_at: string;
+    retired_at?: string;
+    is_self: boolean;
+}
+export interface ListOwnedRuntimeEndpointsResponse {
+    total: number;
+    items: OwnedRuntimeEndpointView[];
+}
+export type HeartbeatRuntimeEndpointResponse = Record<string, unknown>;
+export type UnregisterRuntimeEndpointResponse = Record<string, unknown>;
+export declare function registerRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, params: RegisterRuntimeEndpointParams): Promise<RegisterRuntimeEndpointResponse>;
+export declare function heartbeatRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string): Promise<HeartbeatRuntimeEndpointResponse>;
+export declare function unregisterRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, asNodeId: string): Promise<UnregisterRuntimeEndpointResponse>;
+export declare function listOwnedRuntimeEndpoints(cfg: PlatformClientConfig, runtimeKey: string, asNodeId: string): Promise<ListOwnedRuntimeEndpointsResponse>;
+export declare function getOwnedRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, asNodeId: string): Promise<OwnedRuntimeEndpointView>;
+//# sourceMappingURL=runtime-endpoint-client.d.ts.map

package/dist/runtime-endpoint-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-endpoint-client.d.ts","sourceRoot":"","sources":["../src/runtime-endpoint-client.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,gBAAgB,EAChB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,CAAC;AAmBvD,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,UAAU,GACV,OAAO,GACP,UAAU,GACV,QAAQ,GACR,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAalB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,cAAc,GACd,oBAAoB,GACpB,aAAa,GACb,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAUlB,MAAM,WAAW,6BAA6B;IAE5C,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,WAAW,CAAC;IAO1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,cAAc,EAAE,MAAM,CAAC;IAEvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAE9B,YAAY,CAAC,EAAE,MAAM,CAAC;IAKtB,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACxC;AAcD,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB;AAeD,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IAKpB,OAAO,EAAE,MAAM,CAAC;IAUhB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,WAAW,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAQ5B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IAYtB,WAAW,CAAC,EAAE;QACZ,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClD,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAOpB,OAAO,EAAE,OAAO,CAAC;CAClB;AASD,MAAM,WAAW,iCAAiC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC;AAUD,MAAM,MAAM,gCAAgC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAQvE,MAAM,MAAM,iCAAiC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA4DxE,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,+BAA+B,CAAC,CAQ1C;AAiBD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAcD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAgBD,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iCAAiC,CAAC,CAO5C;AAWD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,CAAC,CAUnC"}

package/dist/runtime-endpoint-client.js

@@ -0,0 +1,71 @@
+import { PlatformApiError, } from "./platform-client.js";
+export { PlatformApiError };
+function baseUrl(cfg) {
+    const trimmed = cfg.apiHost.replace(/\/+$/, "");
+    const origin = /^https?:\/\//.test(trimmed) ? trimmed : `https://${trimmed}`;
+    return `${origin}/v1`;
+}
+async function handleError(res) {
+    const body = (await res.json().catch(() => ({})));
+    const code = typeof body.error === "string" ? body.error : "unknown";
+    const message = typeof body.message === "string" ? body.message : res.statusText;
+    throw new PlatformApiError(res.status, code, message);
+}
+function authHeaders(runtimeKey) {
+    return { Authorization: `Bearer ${runtimeKey}` };
+}
+function jsonHeaders(runtimeKey) {
+    return {
+        ...authHeaders(runtimeKey),
+        "Content-Type": "application/json",
+    };
+}
+export async function registerRuntimeEndpoint(cfg, runtimeKey, params) {
+    const res = await fetch(`${baseUrl(cfg)}/runtime-endpoints`, {
+        method: "POST",
+        headers: jsonHeaders(runtimeKey),
+        body: JSON.stringify(params),
+    });
+    if (!res.ok)
+        return handleError(res);
+    return (await res.json());
+}
+export async function heartbeatRuntimeEndpoint(cfg, runtimeKey, endpointId) {
+    const res = await fetch(`${baseUrl(cfg)}/runtime-endpoints/${encodeURIComponent(endpointId)}/heartbeat`, {
+        method: "POST",
+        headers: authHeaders(runtimeKey),
+    });
+    if (!res.ok)
+        return handleError(res);
+    return ((await res.json().catch(() => ({}))) ??
+        {});
+}
+export async function unregisterRuntimeEndpoint(cfg, runtimeKey, endpointId, asNodeId) {
+    const query = new URLSearchParams({ as: asNodeId }).toString();
+    const res = await fetch(`${baseUrl(cfg)}/runtime-endpoints/${encodeURIComponent(endpointId)}?${query}`, {
+        method: "DELETE",
+        headers: authHeaders(runtimeKey),
+    });
+    if (!res.ok)
+        return handleError(res);
+    return ((await res.json().catch(() => ({}))) ??
+        {});
+}
+export async function listOwnedRuntimeEndpoints(cfg, runtimeKey, asNodeId) {
+    const query = new URLSearchParams({ as: asNodeId }).toString();
+    const res = await fetch(`${baseUrl(cfg)}/runtime-endpoints?${query}`, {
+        headers: authHeaders(runtimeKey),
+    });
+    if (!res.ok)
+        return handleError(res);
+    return (await res.json());
+}
+export async function getOwnedRuntimeEndpoint(cfg, runtimeKey, endpointId, asNodeId) {
+    const query = new URLSearchParams({ as: asNodeId }).toString();
+    const res = await fetch(`${baseUrl(cfg)}/runtime-endpoints/${encodeURIComponent(endpointId)}?${query}`, {
+        headers: authHeaders(runtimeKey),
+    });
+    if (!res.ok)
+        return handleError(res);
+    return (await res.json());
+}

package/dist/session-lifecycle.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,348 @@
+/**
+ * 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);
+        }
+    }
+}

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" });
@@ -529,7 +561,7 @@ export function registerTools(api) {
     });
     api.registerTool({
         name: "masons_end_conversation",
-        description: "End the local Agent Network interaction with a connected agent. This is a silent terminal action: it does not close the Connector transport session, and no text reply should be sent after calling it.",
+        description: "End the conversation with a connected agent. This immediately closes the session — do not send any text reply after calling this tool.",
         parameters: Type.Object({
             contact: Type.String({
                 description: "Handle (e.g. alice) or address of the agent to end the conversation with",

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.23";
+export declare const PLUGIN_VERSION = "0.5.25";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1 +1 @@
-export const PLUGIN_VERSION = "0.5.23";
+export const PLUGIN_VERSION = "0.5.25";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.5.23",
+  "version": "0.5.25",
   "description": "MASONS plugin for OpenClaw — connect your agent to the agent network",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",
@@ -55,6 +55,10 @@
     "./platform-client": {
       "types": "./dist/platform-client.d.ts",
       "default": "./dist/platform-client.js"
+    },
+    "./runtime-endpoint": {
+      "types": "./dist/runtime-endpoint-client.d.ts",
+      "default": "./dist/runtime-endpoint-client.js"
     }
   },
   "dependencies": {