@masons/agent-network 0.5.21 → 0.5.23

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;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"}

package/dist/channel.js

@@ -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;
@@ -179,7 +212,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/conversation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../src/conversation-manager.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,uBAAuB,CAAC;AAS7E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;IAchC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;CACjC;AAwBD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAGvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;gBAE1D,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM;IAoBpD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoCjE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IASvD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkBxD,iBAAiB,IAAI,mBAAmB,EAAE;IAwB1C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAiBzC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAwBtC,wBAAwB,IAAI,IAAI;IA+BhC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAwBvC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAQtC,OAAO,CAAC,uBAAuB;IA0B/B,gBAAgB,IAAI,IAAI;CAGzB"}
+{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../src/conversation-manager.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,uBAAuB,CAAC;AAS7E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;IAchC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,GAAG,QAAQ,CAAC;CACjC;AA4BD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAGvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAwC;gBAE1D,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM;IAoBpD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAoCjE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IASvD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkBxD,iBAAiB,IAAI,mBAAmB,EAAE;IAwB1C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAiBzC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAwBtC,wBAAwB,IAAI,IAAI;IAgChC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAyBvC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAQtC,OAAO,CAAC,uBAAuB;IA0B/B,gBAAgB,IAAI,IAAI;CAGzB"}

package/dist/conversation-manager.js

@@ -13,6 +13,9 @@ function formatErrorMessage(code, to) {
     const template = ERROR_MESSAGES[code] ?? `Send failed: ${code}`;
     return to ? template.replace(/\{to\}/g, to) : template;
 }
+function normalizeHandleContact(contact) {
+    return contact.startsWith("@") ? contact.slice(1) : contact;
+}
 export class ConversationManager {
     client;
     connectorHost;
@@ -101,14 +104,15 @@ export class ConversationManager {
         if (contact.startsWith("passport:")) {
             return contact;
         }
-        if (this.conversations.has(contact)) {
-            return contact;
+        const normalizedContact = normalizeHandleContact(contact);
+        if (this.conversations.has(normalizedContact)) {
+            return normalizedContact;
         }
         for (const [addr, entry] of this.conversations) {
-            if (entry.contact === contact)
+            if (entry.contact === normalizedContact)
                 return addr;
         }
-        return `mstps://${this.connectorHost}/${contact}`;
+        return `mstps://${this.connectorHost}/${normalizedContact}`;
     }
     extractHandle(address) {
         return extractHandleFromAddress(address);

package/dist/plugin.js

@@ -126,8 +126,8 @@ 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 action — " +
-            "do not generate any text reply after ending. " +
+            "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. " +
             "";
         api.on("before_prompt_build", async (_event, ctx) => {
             const hookCtx = ctx;

package/dist/tools.js

@@ -529,7 +529,7 @@ export function registerTools(api) {
     });
     api.registerTool({
         name: "masons_end_conversation",
-        description: "End the conversation with a connected agent. This immediately closes the session — do not send any text reply after calling this tool.",
+        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.",
         parameters: Type.Object({
             contact: Type.String({
                 description: "Handle (e.g. alice) or address of the agent to end the conversation with",

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "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);
-        }
-    }
-}